在 DeepSeek Harness (DSH) 的调试与演示场景中，对话流通常包含大量的工具调用卡片和思考块。这些内容对于排查问题很有价值，但在查看最终结果时往往造成视觉干扰。本文介绍 dsh-tool-fold 插件，它的核心作用是将所有处理内容折叠为单个开关，默认隐藏，仅保留用户消息和助手回复，从而提供更干净的视图。
核心功能¶
- 最大折叠模式：默认状态下，所有工具调用卡片（
[data-chat-flow-kind="tool-call"]）和思考块（[data-variant="think"]）完全隐藏。对话界面仅显示用户消息和助手回复。 - 全局开关控制：通过设置中的全局开关控制显示与隐藏。开启开关后，所有内容恢复原生渲染，保证零内容丢失。
- 状态持久化：折叠状态会保存到浏览器的
localStorage中，刷新页面后状态保持不变。 - 渲染适配：自动适应流式传输和虚拟化渲染，无需修改主机代码。
- 视觉区分：处理块（如思考块）在展开时会使用品牌蓝色高亮显示，以在视觉上区分“处理过程”与“最终结果”。
安装与启用¶
该插件为纯客户端插件。安装前需确保环境满足以下依赖：
- 需要
@deepseek-ai/dsh-client-runtime - 需要
@deepseek-ai/cordis(^4.0.1)
安装与启用步骤如下：
- 将插件代码下载到本地路径，例如
/path/to/dsh-tool-fold。 - 执行安装命令：
dsh plugin --profile web add /path/to/dsh-tool-fold
- 重启
dsh web进程，并刷新页面。 - 打开 设置 -> 通用设置（第 15 位），找到“全局折叠开关”进行控制。
典型用法¶
- 查看原始流：在通用设置中开启全局折叠开关，此时对话中的所有工具调用卡片和思考块会以品牌蓝色高亮显示，恢复完整的处理流程。
- 获取干净视图：关闭全局折叠开关，隐藏所有工具调用和思考块，仅保留用户提问和助手回复，界面更加简洁。
注意事项¶
- 生态说明：本插件由社区维护，与 DeepSeek 官方无直接从属关系。
- 许可证：基于 MIT 许可证。
- 安全检查：安装前建议检查源码与许可证，确保符合使用规范。
通过上述配置，开发者可以在保持对话完整性的同时，灵活切换“纯净模式”与“调试模式”。
