前言¶
在 DeepSeek Harness 的 Web 界面调试 Agent 时,完整的轨迹往往包含大量中间步骤,如工具调用、steering、workflow 运行和上下文注入等,导致界面杂乱。下面介绍一个插件,可以在折叠这些中间轨迹的同时,始终保留 Agent 的最终输出。
插件介绍¶
名称:awesomehou/dsh-trajectory-collapse
维护者:AwesomeHou
定位:DeepSeek Harness Web 界面永久插件
核心价值:折叠 Agent 轨迹,同时始终保留 Agent 的最终输出。
核心功能¶
-
逐轮次折叠 Agent 轨迹
插件在每个已完成的 Agent 输出顶部注入了一个Expand trace / Collapse trace按钮。折叠是以轮次为单位的,你可以单独控制每一次输出的轨迹折叠状态。 -
始终保留最终输出
即使折叠后,用户消息与收尾的助手输出也始终可见,只有中间的轨迹被隐藏。 -
支持多种轨迹类型
支持折叠的类型包括:tool-call、assistant-step、steering、workflow、context以及unknown行。 -
默认折叠设置
在设置中可以配置默认折叠行为。进入 设置 -> 通用,勾选Collapse agent trace by default after final output即可开启。该项默认勾选。
安装与启用¶
该插件是永久插件,必须安装到 web profile。
- 在 DeepSeek Harness 的
webprofile 目录下执行安装命令:
dsh plugin --profile web add <本仓库路径>
安装完成后重启 Harness。
- 其他安装方式:
- 命令行:直接叫 Agent 帮你安装,例如:
帮我安装这个插件:https://github.com/AwesomeHou/dsh-trajectory-collapse
- 插件市场:先安装插件市场(https://github.com/AwesomeHou/dsh-plugin-marketplace),然后从市场内搜索安装。
典型用法¶
-
开启默认折叠:
进入 设置 -> 通用,勾选Collapse agent trace by default after final output。这样在 Agent 输出完成后,轨迹会自动折叠。 -
手动折叠/展开:
在聊天界面中,点击轨迹顶部的小按钮(Expand trace/Collapse trace)即可手动控制特定轮次的轨迹显示。
适用场景与注意¶
- 适用场景:适用于需要在 DeepSeek Harness Web 界面查看长轨迹、但希望保持界面整洁的开发者。
- 注意:
- 插件以当前 DSH 进程权限运行。
- 安装前建议检查源码与许可证(MIT)。
- 这是一个永久插件,需安装到
webprofile。
结语¶
该插件通过提供逐轮次的折叠控制,解决了长轨迹带来的界面杂乱问题。更多细节与源码可参考其目录页或 GitHub 仓库。