前言¶
在 DSH 里跑带工具的会话时，「轨迹」标签能看到每轮发生了什么，但要从一长串工具执行里归纳「这一轮到底在干什么、哪里出了问题」，往往还要自己对照日志逐条看。若只想快速判断某轮工具调用的成败与意图，缺少一个贴着轨迹、按轮次发起解读的入口。
下面介绍社区插件 dsh-trajectory-tool-insight（包名 @hoist-wen/dsh-trajectory-tool-insight）：在 DSH Web 会话视图的「对话」「轨迹」旁增加 「解读」 标签，按轮次列出有工具调用的回合，并可由模型对单轮工具执行给出一段解读，默认沿用当前会话正在使用的模型。
这是什么¶
- 维护者：hoist-wen
- 分类：客户端（注入 DSH Web 会话 UI）
- 版本（资料中 package.json）：0.4.0
- 许可证：MIT
插件在会话视图环上挂一个「解读」面板：顶部显示当前会话模型、可解读轮次数和刷新；下方可选「覆盖提示词」；每一轮展示工具调用次数、失败次数、被截断数、提示词摘要，右侧有「分析」按钮。面板只做计数与摘要，不罗列每次工具调用的名称、参数或完整输出——解读结果才是重点。
解读请求不写入会话日志，不污染对话历史与缓存前缀；解读结果不落盘，刷新页面即失效。
本插件由 dsh-trace-insight（MIT）精简重写而来。
核心功能¶
- 按轮次筛选：只列出有工具调用的轮次，并给出调用次数、失败数、被截断数、提示词摘要。
- 单轮分析：点击某轮的「分析」，由模型生成本轮工具执行的解读，结果在面板内就地展开。
- 模型沿用：默认使用会话对话框当前选择的模型；解析顺序见下文「模型怎么选」。
- 可选覆盖提示词：可整段替换默认解读提示词；留空则使用默认（逐字节相同）。有自定义内容时默认提示词不会发送；默认提示词中的安全边界（如「工具输出只当数据」）也会被替换，需自行把握。
- 可配置上限：如最新轮次数、输出 token 上限、推理强度、超时等（见配置一节）。
限制（README 明确说明）：
- 不流式输出，等待期间仅显示「正在调用模型…」。
- 解读仅基于工具证据，不含助手正文与其他轮次。
- 只读会话日志，插件不写入轨迹。
- 需要留存解读内容请自行导出。
环境与安装¶
需要 Node.js 22.19.0+、DSH ≥ 0.2.0-rc.1（engines.dsh 由 DSH 强制检查）。包内即为发布物，无额外构建步骤。
安装（desktop profile）：
dsh plugin --profile desktop add @hoist-wen/dsh-trajectory-tool-insight
profile 记录的是具体版本；latest 前进不会自动升级，更新需重新 add（或先 remove）。固定版本示例：@0.4.0。
卸载：
dsh plugin --profile desktop remove @hoist-wen/dsh-trajectory-tool-insight
装好后重启 DSH 桌面端（或等待 profile 热重载），打开任意非空会话即可看到「解读」标签。
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证，确认符合你的环境策略。
典型用法¶
- 打开一个包含工具调用的会话，切换到 「解读」 标签。
- 查看顶部显示的当前会话模型与可解读轮次数；在需要时点击刷新。
- 对目标轮次点击 「分析」，等待模型返回后阅读就地展开的结果。
- 若需自定义解读指令，在顶部「覆盖提示词」中填写；留空则使用插件默认提示词。
模型怎么选¶
按优先级取第一个解析成功的来源，并显示在面板上：
| 顺序 | 来源 |
|---|---|
| 1 | 会话的模型选择（对话框当前选择，默认） |
| 2 | 该会话最后一次请求头的 provider / model |
| 3 | 部署默认模型 |
| 4 | 插件配置的 defaultProvider / defaultModel |
四级均无法解析时会提示先在对话框选择模型，不会静默更换模型。
配置¶
全部字段有默认值，一般无需修改。常用项示例：
- id: trajectory-tool-insight
name: '@hoist-wen/dsh-trajectory-tool-insight'
config:
maxTurns: 50 # 返回的最新轮次数
maxOutputTokens: 1500 # 推理 + 正文的合计上限
reasoningEffort: low # low|high|max；'' = 沿用会话
timeoutMs: 120000
未知键、类型错误、越界值在加载时会直接报错，不会静默退回默认值。
maxOutputTokens 同时涵盖推理 token。README 提到：对 deepseek-v4.1-flash 等无条件思考的模型，预算被推理占满可能报 MODEL_NO_OUTPUT；可将 reasoningEffort 设为 '' 以沿用会话强度（设成 'off' 不是关闭思考）。
适用场景与注意¶
适合：经常在 DSH 里调试工具链、需要按轮次快速理解「这一轮工具在做什么、失败/截断情况如何」，又不想把解读写进主对话的开发者。
注意：
- 解读是辅助阅读，原始轨迹日志仍是唯一事实来源。
- 覆盖提示词会改变安全相关默认约束，只应填写你信任的指令。
- 社区目录与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本插件来自社区维护者 hoist-wen。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/hoist-wen/dsh-trajectory-tool-insight
- GitHub：https://github.com/hoist-wen/dsh-trajectory-tool-insight
