前言¶
在 DeepSeek Harness Web 界面查看推理和工具调用时，信息层级可能变得复杂。dsh-turn-fold 插件通过将相关的推理步骤和工具调用分组为可折叠的结构，解决了这一问题。它安装为本地配置文件层，允许用户在保持最终回复可见的同时，折叠已完成轮次的过程细节。
插件定位¶
- 名称：dsh-turn-fold
- 维护者：ruisenbai
- 类别：客户端
- 核心功能：将推理和工具调用分组为可折叠步骤；已完成的轮次折叠其过程但保留最终回复；支持 Diff 可视化、路径复制和偏好设置持久化。
安装与配置¶
此插件需要 DeepSeek Harness 0.1.5-alpha.1。源码开发需要 Node.js 环境（^22.19.0 || >=24.0.0）。
在 DeepSeek Harness 仓库根目录下执行以下命令：
cd dsh-turn-fold
npm run dev:link
npm run build
dsh plugin --profile web add "$PWD" --offline
安装完成后，刷新正在运行的 Web 页面以激活插件。
使用说明¶
基本折叠与展开¶
- 流式回复期间：连续的推理和工具调用会共享一个折叠条，文本内容在步骤间可见。
- 回复完成后：一个轮次的完整过程会折叠为一个条。点击该条以查看步骤，再点击单个步骤以展开原始的推理卡片和工具卡片。
摘要与路径复制¶
- 摘要信息：显示工具类型图标、文件名、以及读取、编辑、搜索、命令、其他工具和失败的计数。
- 复制路径：点击摘要中的文件名可复制其完整工作区路径，不会改变折叠状态。
- Diff 可视化：成功的编辑操作会显示添加和移除的行（Diff），排除未改变的上下文。
配置入口¶
进入 Settings → Plugins，点击 Conversation folding 卡片。在此处可以配置折叠行为、自动折叠选项以及显示的指标（如持续时间、Token 使用量、缓存命中率等）。
功能细节¶
- 多语言支持：包含英文和中文设置。
- 交互反馈：展开、折叠和内容增长使用过渡动画；支持系统“减少运动”偏好设置。
- 状态管理：偏好设置会跨刷新持久化；关闭插件会恢复安装前的原生折叠状态。
- Diff 细节：多块内容会累积显示；失败或未完成的编辑没有行统计；匹配的文件名会显示其路径以示区分。
注意事项¶
- 插件通过 Bundle patch 注入 Host 插件，并接管了原生的折叠状态管理。
- 插件拥有派生的呈现方式和临时的查看选择权，不发布运行时不变量伴侣。
- 在使用前请确保本地环境满足 Node.js 版本要求，并检查与 DeepSeek Harness 版本的兼容性。
