DeepSeek Harness (DSH) 的 Web 界面在调试智能体时会生成大量日志。这些日志在 Turn 运行时和结束后会占据大量屏幕空间,导致界面难以阅读。dsh-reasoning-fold 插件引入了一种 Codex 风格的折叠机制,将连续的操作流压缩为摘要行,在保持日志可追溯性的同时,提升 Web 界面的整洁度。
插件介绍¶
这是一个为 DSH Web 界面设计的折叠插件,由 Iwwww 维护。它通过折叠已完成操作和推理过程,将 Web 界面从杂乱的日志堆中解放出来。
核心功能¶
- 保持最新操作可见:运行中的 Turn 仅显示最近 3 个操作,其余操作折叠在摘要行下。
- 完成状态折叠:已完成的 Turn 会折叠为时长行(例如 “Worked 42s · 17 earlier actions”)。
- 精准折叠类型:仅折叠
tool-call、context、model-retry和reasoning类型的行,错误或未知节点类型保持原样。 - 保留助手文本:折叠推理正文时,不隐藏助手原本的文本内容;若步骤同时包含文本和推理,仅折叠推理行。
- 保持滚动位置:折叠操作不会读取或修改页面的滚动位置。
安装与启用¶
在终端执行以下命令安装插件:
dsh plugin --profile web add dsh-reasoning-fold
安装完成后刷新页面即可生效。
使用方法¶
安装后,在 Web 界面的 General 设置 中找到 Fold steps 选项,可选择 Off、1、3、5 或 10。默认值为 3。
注意事项¶
- 插件不干扰 DeepSeek Harness 自身的折叠功能。
- 隐藏的单元使用
display: none样式,不处理锚点跳转。 - 运行环境需满足 Node 22 或更新版本。
- 插件以当前 dsh 进程的权限运行,安装前建议检查源码与许可证。
结语¶
通过 dsh-reasoning-fold,开发者可以在保持日志可追溯的前提下,大幅提升 Web 界面的阅读体验。相关文档与源码可在 GitHub 查看。