dsh-turn-fold

English | 简体中文

一个基于 dsh-harmony 的 Provider，为 DSH WebUI 对话添加 Codex Desktop 风格的回合折叠。

https://github.com/user-attachments/assets/3c9dfdcf-a454-4750-9edf-76771ed5a9a6

回合进行期间，摘要栏保持可见，原生思考、说明、命令和工具调用继续流式输出。从第二项开始，连续的推理、上下文注入和工具活动会合并为一个紧凑分组。回合结束后，包括上下文注入在内的已知 Agent 活动会收进最终答复前方的折叠栏。摘要指标可以配置，默认显示耗时、工具调用次数以及输入/输出 token；只有当已加载的回合包含足够数据、无需猜测即可计算时才会展示对应指标。

最终答复通过 turn-tail.closing.finalNode 定位，不依赖 finish_reason 或 DOM 位置。正常完成、已停止和已中断的回合都会折叠，后两者显示不同的状态标签。当 DSH 将结束分支标记为不可用、结束答复之后仍有节点，或者用户的键盘焦点或文本选择位于活动内容中时，回合会保持展开。失败、达到最大 token、缺少结束节点以及仍在进行的回合也会保持展开，避免隐藏错误或未完成的工作。

展开后仍然使用原生节点渲染器，因此工具详情、复制功能和文件链接都能继续工作。WebUI 保持加载期间，每个会话和回合的展开状态都会被记住。折叠控件提供键盘可见焦点、无障碍状态与操作标签、响应式换行、减少动态效果支持，以及关闭后再卸载活动内容的短暂开合动画。

工作原理

三个带形状校验的 Source Patch 会在内存中修改 @deepseek-ai/dsh-client-ui-conversation >=0.1.0-rc.8 <0.2.0-0 的编译后浏览器包（lib/client.js），不会修改已安装的 DSH 文件。每条选择器仍必须恰好命中一次，因此遇到不兼容的编译形状时会停止应用，而不会修改不确定的目标。

Patch	选择器（预期命中 1 次）	作用
inject-turn-fold-runtime	FunctionDeclaration[name.name="ChatView"], VariableStatement:has(VariableDeclaration[name.name="ChatView"])	向原生或已装饰的 ChatView 注入折叠渲染器和折叠 UI
rewrite-node-render-loop	CallExpression[expression.name.name="map"][expression.expression.name="order"]	将 order.map(...) 节点循环替换为按回合渲染器
install-turn-fold-services	VariableStatement:has(VariableDeclaration[name.name="t"][initializer.expression.name.name="bind"])	通过 DSH 原生语言服务注册内置的中英文词典，并绑定原生设置作用域

安装

dsh plugin --profile web add github:CH4ACKO3/dsh-turn-fold
dsh harmony status --profile web   # 三个 Patch 都必须为 `bound`

测试

node test/run.cjs

npm install 会安装测试工具所需的依赖。测试套件会在内存中应用三个 Patch、解析最终浏览器包，并覆盖已完成回合、分段活动、结束后活动、部分历史、失败、中断、进行中、无障碍、本地化、设置和状态保留等行为。目标缺失或选择器不匹配会使测试失败，不会被报告为跳过后通过。

CI 与发布

GitHub Actions 会在每个 Pull Request 和每次推送到 main 时运行测试套件及 包内容预检。版本标签通过 Trusted Publishing（OIDC）发布到 npm，无需保存 长期 npm Token。

首次使用时配置一次 npm 可信发布者：

npx npm@^11.15.0 trust github @ch4acko3/dsh-turn-fold \
  --repo ch4acko3/dsh-turn-fold \
  --file release.yml \
  --allow-publish

之后创建与 package.json 版本一致的标签并推送：

npm version patch
git push --follow-tags