TheHeartFickle/dsh-conversation-folding

dsh-conversation-folding

dsh-conversation-folding 是一个纯 UI 增强插件，用于优化 DSH 对话流的阅读体验。它把思考过程、工具调用等中间过程折叠起来，同时保持用户输入和 LLM 输出使用原生渲染样式，不改变内容本身。

✨ 功能一览

- 整轮折叠（默认）
- 用户输入保持原生样式。
- 思考/工具调用过程被折叠为一个独立的折叠栏。
- 尚未生成正文时，折叠栏下方保留最近一次过程预览；开始生成正文后，过程自动隐藏，只显示正文。
- 点击“展开过程”可以查看完整过程。

- Tool call 分组折叠
- 连续的 tool-call 步骤会折叠成组，默认只显示最新一个，减少对话流中的重复工具调用刷屏。

- 思维链增强
- Think 块默认展开为可滚动子框。
- 生成过程中自动跟随底部，方便实时阅读。
- 新的思维链出现时，只折叠紧邻的前一个，保持上下文连续。

- 折叠的步骤类型可按类型配置
- 设置 →「对话折叠」独立标签页：18 个步骤类型分别开关是否折叠
（bash / think / read / write / edit / glob / grep / web / skill / 子代理 /
后台任务 / goal / 任务清单 / 提问 / ralph / workflow / 上下文注入 / 系统提示词）。
- 默认不折叠：上下文注入、skill、系统提示词；其余类型折叠。

📦 安装

前置条件：已安装 DSH，且 dsh web 可以正常运行。

通过 npm / DSH CLI 安装

dsh plugin --profile web add @the-heart-fickle/dsh-conversation-folding@latest

通过 plugin-registry 安装

npm run package:registry
dsh registry install ./registry
dsh registry enable the-heart-fickle/dsh-conversation-folding

registry/ 是本地生成的安装暂存目录，不会提交到仓库。

🚀 快速上手

1. 安装插件后重启 DSH，并刷新浏览器页面。
2. 发送一条消息，观察：
- 思考/工具调用过程被折叠为独立折叠栏；
- 正文开始输出后，过程自动隐藏；
- 点击“展开过程”可查看完整过程。
3. 想回到官方渲染时，在设置中把「对话显示」切换为 Normal / Compact 即可。

⚙️ 配置

全部配置在浏览器端「设置」内完成，经 host 设置系统持久化到
~/.dsh/settings.yaml（dsh-conversation-folding: 命名空间），跨端/重载恢复：

- 对话显示（设置 → 对话显示）：Normal / Compact / Fold。仅「Fold」由
本插件接管过程折叠，折叠行为只有一种：整轮折叠，正文永不折叠。
- 对话折叠（独立标签页）：各步骤类型的「是否折叠」开关。工具调用按 host
工具注册表的字面注册名经匹配表精确匹配（如 pwsh→Shell 命令、
str_replace_editor→编辑文件、todo_write→任务清单、ask_user_question→提问）；
未列入匹配表的工具类型始终折叠。默认不折叠：上下文注入、skill、系统提示词。
浏览器 localStorage 不存任何配置。

0.1.x 曾支持 profile cordis.patch.yml 下发 foldMode / auxVisible；自本版本起
配置全部移到浏览器设置，host 不再持有配置。

🗂️ 效果示意

思考阶段（正文未开始）

用户输入
┌──────────────────────────────────┐
│ 折叠栏：展开过程   N 个步骤      │
└──────────────────────────────────┘
最近一次 thinking / tool call（增强样式）

正文输出后（多段正文全部保留，仅过程折叠）

用户输入
┌──────────────────────────────────┐
│ 折叠栏：展开过程   N 个步骤      │
└──────────────────────────────────┘
LLM 输出（原生正文样式，中间播报也完整可见）

🔧 环境要求

- Node.js ≥ 20
- DSH ≥ 0.1.2-rc.1（client 半边依赖 0.1.2 的 useChat ChatSnapshot）

📡 通信架构

host 半边只经官方 settings 服务触达配置：注册自有 settings 命名空间，经插件
RPC 路由 /conversation-folding/config 读写（src/index.ts）；client 半边经
官方 Loader + slots 注入（0.1.2 slot 选举制约束见 docs/SPEC.md 与
docs/BUGS.md）：

- 构建：源码在 src/（host 半边 src/index.ts，浏览器端 src/client/），
npm run build 经 esbuild 生成 lib/——lib/index.js 与以
window.__ModuleLoader__.load({ id, factory }) 包装注册的单文件 bundle
lib/client.js（除 react 与官方 primitives 外全部内联）。lib/ 为构建产物
不入库，npm test 前自动构建。
- 官方 Loader：dsh.plugin.json 仅负责装载浏览器半边 lib/client.js；
host 壳（lib/index.js）是零依赖占位，不注入任何官方服务。
- 显隐实现约束（0.1.2 slot 选举制）：shadow 官方 tool-call 树再转发不可行
（shadowed entry 对查询不可见，输赢取决于 bundle 加载顺序），插件只 shadow
assistant-step / turn-process，tool-call / context 由按座位 anchor key
生成的动态 CSS 控制显隐，官方组件原生渲染。

许可证

MIT