前言¶
在 DeepSeek Harness(DSH)里跑长对话时,每一轮往往会展开大量思考过程、运行命令和工具调用行。官方界面可以逐条折叠,但轮次一多,滚动和点击成本都会上去。社区插件 dsh-turn-fold 参照 Codex 的折叠方式:每轮只保留一行「已完成,用时 …」,由这一行统一控制整轮思考过程(放进限高滚动窗口)和回复的展开或收起。插件只改前端显示,不修改会话数据;卸载后界面恢复原样。
下面介绍插件定位、能力、安装步骤和使用上需要注意的兼容性。
这是什么¶
dsh-turn-fold 是 DSH 的 Web 界面客户端插件,维护者为 whoishuhu,在 SkillHub 社区目录中归类为 客户端。当前资料中的版本为 0.1.0,许可证 MIT。它通过替换官方 Chat 的 turn-process 节点渲染器,并在 conversation.chat.assistant-actions 增加控件,实现「整轮折叠」而不是一条一条点官方折叠项。
核心功能¶
标题行与两个开关¶
每轮完成后的标题行形如「已完成,用时 X 分 X 秒」。该行右侧增加 思考过程 和 回复 两个按钮;点击标题文字本身也可切换思考过程的展开状态。
思考过程:滚动窗口与摘要¶
展开后,整轮的思考、运行命令、工具调用集中在 限高滚动窗口 内显示,避免把正文撑得很长。窗口内说明文字照常展示;两段文字之间的思考和工具调用会合并成一行摘要,例如「思考 · 运行命令 5 · 工具调用 2」。窗口右上角提供 展开全部 / 收起全部;每一行摘要也可单独点开。点击任意工具调用条目会打开官方的调用详情。
回复折叠¶
标题行的 回复 按钮,或回复下方操作栏中的折叠按钮,均可收起或展开该轮回复。
默认行为与状态保存¶
已完成的轮次默认 收起思考过程、显示回复;正在运行的一轮保持官方实时显示,跑完后自动折叠。折叠状态只保存在 当前页面内存 中,刷新或重启 DSH 后恢复默认。
安装与启用¶
在 DSH 侧栏 →「插件」→「添加插件」中填写:
github:whoishuhu/dsh-turn-fold
或使用命令行(将 <你的 profile> 换成实际 profile 名):
dsh plugin --profile <你的 profile> add github:whoishuhu/dsh-turn-fold
安装完成后 重启 DeepSeek Harness。界面插件会在页面加载时注入(package.json 中 dsh.client.immediately 为 true,并注入 @deepseek-ai/dsh-client-ui-chat)。
典型用法¶
- 安装并重启 DSH 后,打开任意会话,等待一轮对话完成。
- 在「已完成,用时 …」一行上,用 思考过程 查看滚动窗口内的整轮过程;需要时用窗口内 展开全部 看细节,或点单条工具调用看官方详情。
- 用 回复 或回复区折叠按钮控制该轮正文是否占用屏幕高度。
- 长会话中可让已完成轮次保持「思考收起、回复展开」,减少纵向滚动。
卸载可在插件面板移除,或执行:
dsh plugin --profile <你的 profile> remove dsh-turn-fold
适用场景与注意¶
适合谁:经常在 DSH Web 里阅读多轮智能体轨迹、希望用「一行 per 回合」管理思考与回复的开发者。
DSH 版本:在 DSH 0.2.2-rc.1 上开发和验证(package.json 的 engines.dsh 为 >=0.2.2-rc.1 <0.3.0)。升级 DSH 大版本前建议核对 engines 范围。
与官方 UI 的配合:「工作步骤展示」选任意档位均可使用;README 建议选 完全展开 或 详细,避免与官方自带折叠叠在一起产生重复交互。
耦合点:官方 Chat 若调整节点结构或行属性(如 data-chat-node-key、data-chat-turn),插件可能需要同步更新。
安全与权限:客户端插件随 DSH 进程在本地/Web 环境运行。安装前应查看仓库源码与 MIT 许可证,确认符合你的环境策略。SkillHub 目录为社区站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-turn-fold 把「整轮思考 + 回复」收成标题行上的两个开关,并用滚动窗口承载过程细节,适合长会话下的界面降噪。更多信息见社区目录与源码仓库。
- 目录页:https://www.skillhub.cn/plugins/whoishuhu/dsh-turn-fold
- GitHub:https://github.com/whoishuhu/dsh-turn-fold