Liu-Bot24/dsh-trace-insight

README 摘要

DSH Trace Insight｜DSH 轨迹解读器 面向 DeepSeek Harness（DSH）的只读执行复盘插件。它把密集的轨迹事件整理成持续更新的分析时间线，帮助你看清 Agent 做了什么、哪里出错、为什么出错，以及结论对应哪些原始证据。 English 它解决什么问题 DSH 原生轨迹记录了消息、工具调用和事件，但长任务往往包含成百上千个步骤，单靠逐条翻阅很难回答这些问题： - Agent 实际采用了什么策略？ - 哪些步骤真正推进了任务，哪些是重复试探？ - 失败来自模型判断、工具使用、环境条件还是输入缺失？ - 一段“已经完成”的回答是否有足够证据支撑？ - 长时间运行的一轮中，目前已经发生了什么？ Trace Insight 直接读取 DSH 的结构化 Session Event Log，用本地规则分析建立事实底座，再按需使用独立模型解释决策、风险和改进方向。 主要功能 - 持续复盘 ：按 Turn 和 Seq 整理规则分析与模型分析，长任务不必等到整轮结束才看到阶段进展。 - 规则分析 ：在本机识别工具失败、重复失败、无进展循环、路径猜测、工具误用、完成信号和证据缺口，不调用模型。 - 模型解读 ：使用独立配置的 DSH 模型分析策略、根因、风险、下一步和可复用经验，不改变开发 Agent 的主模型。 - 证据定位 ：从结论回到对应的 Seq、Turn、Step、Tool、摘录和原始前后文。 - 任务概览 ：按开发阶段、工具使用和问题线索汇总整个任务，并可回到成员记录。 - 结果对比 ：比较同一段轨迹的两次模型分析，观察不同模型或配置给出的差异。 - 受控重分析 ：可以为指定区间临时切换模型重新分析，不改变以后自动分析使用的默认模型。 - 历史与导出 ：分析记录保存在本机，可分别导出分析历史、原始 Session 历史或完整分析包。 界面 DSH 的对话或轨迹保留在左侧，Trace Insight 显示在可调整宽度的右侧栏中，原始执行过程和解读结果可以同时查看。 右侧栏包含四个页面： - 复盘 ：查看按时间排列的规则分析和模型分析。 - 概览 ：查看整个任务的阶段、工具和问题汇总。 - 对比 ：比较同一轨迹区间的两次成功分析。 - 设置 ：配置分析模型、自动分析策略、资源限制和导出。 证据定位 模型结论和规则发现可以打开独立证据抽屉。每条引用都会标出 Seq、Turn 和摘要，需要时再读取对应的原始前后文。 任务概览 概览按开发阶段、工具使用和问题线索汇总整个 Session。汇总只整理已有分析，不会产生新的模型调用。 两次运行对比 对比只接受范围和输入一致的两次成功分析，分别展示结论、配置、资源用量和原始证据。 安装 需要全局安装 DeepSeek Harness 0.1.0-rc.7 或 0.1.0-rc.8 ，并使用 Node.…

分类