前言¶
在 DeepSeek Harness(DSH)Web 客户端里跑智能体,一个回合往往包含上下文注入、思考块、工具调用和过程正文。这些内容默认全部展开,长会话里界面很快被工作流占满,模型最终回复反而要往下翻才能看到。
官方界面会显示 Deep diving... 等状态提示,但并不会把整段工作过程收成摘要行。dsh-auto-collapse 是一个纯前端 DOM 插件,挂在 DSH Web 聊天界面上,把工具卡片与 Think 推理块自动折叠,呈现接近 VSCode Codex 桌面端的折叠体验,同时支持把状态提示词改为可配置的 Deep sleeping...。下面介绍它的定位、能力与安装方式。
这是什么¶
dsh-auto-collapse 由 a179-sanae 维护,在 GitHub 上开源(MIT 许可,当前版本 0.1.4)。它不改动消息内容,只控制工作流程的显示状态;卸载(HMR stop)时可完整还原所有折叠、隐藏与改写。
插件挂在 DSH Web 聊天界面上,通过 DOM 操作把每个回合的工作过程收成一行摘要,点击后再展开完整流程。目标是让界面主要保留模型说的话。
核心功能¶
三级折叠结构¶
- 一级:回合完成自动收起。每个回合完成后,工作过程收成一行
已处理 X秒,只留模型最终正文。点击可展开完整工作流程(上下文注入 → 思考 → 工具调用 → 过程正文 → 最终正文)。 - 二级:工具与思考各自折叠。展开一级后,工具调用组与思考块各自折叠成一行 chip(
正在运行 {命令}/运行了命令/已思考),点击展开或收起。相邻工具组合并,正文输出是硬边界,不会跨正文合并。 - 三级:思考合并。展开
已思考后,连续思考合并为一个三级思考行(标题Think · 第一句),点击展开合并内容块;原始四级行不出现。
视觉与交互¶
- 图标盒 16px、glyph 14px、行高 24px、行距 16px,颜色使用 DSH 原生 token(
--dsw-alias-label-*),思考与命令图标取自 DSH 原生图标(IconThinkOutline14/IconApiOutline14)。 - 点击驱动的展开(淡入 + 4px 上移,合并思考正文带高度展开)与收起(镜像淡出)均为 180ms;仅用户点击触发动画,流式协调器决策保持瞬时。
- running 状态带文字平滑呼吸动画;
prefers-reduced-motion下停止动画,过渡动画同样禁用。
流式与兼容性¶
同一个 assistant-step 原地补正文、React 换节点和历史乱序挂载都会重新协调。除 tool-call 外,顶层 command / manual-compaction、context 和纯图片 final 都按同一回合语义处理。
可配置状态提示词¶
在 设置 → 插件 → 插件配置 中可以编辑「状态提示词」,默认 Deep sleeping...。留空保存后恢复官方 Deep diving...。
安装与启用¶
已发布 npm 包,推荐用构建好的版本:
dsh plugin --profile web add "dsh-auto-collapse"
从 GitHub 安装(开发版或需要跟随 main 分支时):
dsh plugin --profile web add "github:a179-sanae/dsh-auto-collapse#main"
安装后重启 DSH web 服务(或触发插件 HMR),页面 Ctrl+Shift+R 硬刷新即可生效。无需任何配置。
典型用法¶
安装并刷新后,插件自动生效,无需额外命令。
查看折叠效果:等一个回合完成后,工作过程会收成一行 已处理 X秒,模型最终正文留在界面上。点击该行可展开完整工作流程。
调整状态提示词:打开 DSH Web 客户端的 设置 → 插件 → 插件配置,编辑「状态提示词」。默认值为 Deep sleeping...;若希望恢复官方文案,留空保存即可回到 Deep diving...。
卸载还原:通过 dsh plugin 移除插件并触发 HMR stop,所有折叠、隐藏与文案改写会完整还原。
适用场景与注意¶
适合谁
- 经常在 DSH Web 上跑多步智能体任务,希望界面聚焦模型最终输出。
- 习惯 VSCode Codex 桌面端折叠体验,想在 Web 端获得类似交互。
- 需要可逆的 UI 增强,不希望改动底层消息数据。
使用前注意
- 插件以当前
dsh进程权限运行,安装前应检查 源码 与 MIT 许可证。 - 纯前端 DOM 插件,依赖 DSH Web 客户端的 DOM 结构与 React 渲染行为;DSH 大版本升级后若界面结构变化,可能需要等待插件适配。
- 社区目录 SkillHub 是独立站点,与 DeepSeek / 幻方无官方从属关系。
小结¶
dsh-auto-collapse 把 DSH Web 会话里的工具调用与思考块收成可展开的一行摘要,让长对话界面更干净,同时保留完整工作流的可查看性。安装一条命令即可启用,状态提示词可按需配置。