前言¶
在 DeepSeek Harness (DSH) Web 界面中，调试智能体时会产生大量连续的步骤卡片，包括工具调用、推理过程和上下文注入。这些内容堆叠在一起会占据大量垂直空间，干扰视线。dsh-plugin-collapsible-steps 插件通过将连续的步骤卡片折叠为单个条目，来减少视觉噪音。
插件介绍¶
这是一个 DSH Web 插件，由 mervyn-teo 维护。它的核心作用是将消息之间连续的 collapsible-card 步骤运行折叠为一个 + N steps 的行。点击该行即可折叠或展开该组步骤。
核心功能¶
- 会话头部控制：在会话头部添加了“Collapse steps / Expand steps”控制按钮。
- 步骤分组折叠：在连续的步骤节点运行前添加
- N steps行。点击该行可折叠该组的所有卡片，只保留最新的一条卡片；再次点击则展开。 - 步骤类型定义：插件定义了“step”类型，包括 tool-call、workflow-run、command、command-input、compaction、context、manual-compaction、model-retry 以及助手消息的 Think 折叠区。用户/助手消息和回合通知作为分组边界。
- 默认设置：在 Settings → Plugins → Collapsible steps 卡片中，可以控制
collapseByDefault（默认为true），决定运行步骤是否默认折叠。
安装与启用¶
使用 DSH 官方插件命令安装。安装后需重启 dsh web 以加载主机端代码。
dsh plugin --profile web add github:mervyn-teo/dsh-plugin-collapsible-steps
典型用法¶
- 在会话界面中，连续的步骤卡片前会出现
- N steps的行。 - 点击该行，界面会折叠该组所有卡片，仅保留最新的一条，下方显示
+ N steps。 - 点击
+ N steps可重新展开。 - 进入 Settings → Plugins → Collapsible steps 卡片，关闭
collapseByDefault以保持展开状态。
适用场景与注意事项¶
依赖要求：该插件要求 DSH 挂载了基础对话 UI (@deepseek-ai/dsh-client-ui-conversation)，它会将括号头插入该 UI 的聊天流中。
实现方式：由于插槽系统的限制，插件无法包裹已发货的对话卡片，因此它通过注解现有 DOM 来实现，即读取会话钩子中的节点顺序，计算连续运行，并将括号头插入现有 DOM，不移动节点本身。
安全性：插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证（MIT）。
兼容性：已发货的对话卡片和 markdown 渲染保持不变，不受影响。
结语¶
该插件通过简单的注解方式优化了 DSH Web 界面的步骤展示，适合需要在大量调试信息中保持界面整洁的开发者。
