dsh-conversation-folding
dsh-conversation-folding 是一个纯 UI 增强插件，用于优化 DSH 对话流的阅读体验。它把思考过程、工具调用等中间过程折叠起来，同时保持用户输入和 LLM 输出使用原生渲染样式，不改变内容本身。
✨ 功能一览
-
整轮折叠（默认）
- 用户输入保持原生样式。
- 思考/工具调用过程被折叠为一个独立的折叠栏。
- 尚未生成正文时，折叠栏下方保留最近一次过程预览；开始生成正文后，过程自动隐藏，只显示正文。
- 点击“展开过程”可以查看完整过程。
-
Tool call 分组折叠
- 连续的
tool-call 步骤会折叠成组，默认只显示最新一个，减少对话流中的重复工具调用刷屏。
-
思维链增强
Think 块默认展开为可滚动子框。- 生成过程中自动跟随底部，方便实时阅读。
- 新的思维链出现时，只折叠紧邻的前一个，保持上下文连续。
-
辅助项可见性可配置
- 代码内部默认将上下文注入、skill 加载等辅助项全部隐藏。
- 插件默认配置把
context 和 skill 列为例外，因此安装后仍会显示。
- 在 profile 中用
auxVisible: [] 可覆盖为全部隐藏。
📦 安装
前置条件：已安装 DSH，且 dsh web 可以正常运行。
通过 npm / DSH CLI 安装
dsh plugin --profile web add @theheartfickle/dsh-conversation-folding-plugin@latest
通过 plugin-registry 安装
npm run package:registry
dsh registry install ./registry
dsh registry enable theheartfickle/dsh-conversation-folding
registry/ 是本地生成的安装暂存目录，不会提交到仓库。
🚀 快速上手
- 安装插件后重启 DSH，并刷新浏览器页面。
- 发送一条消息，观察：
- 思考/工具调用过程被折叠为独立折叠栏；
- 正文开始输出后，过程自动隐藏；
- 点击“展开过程”可查看完整过程。
- 想要关闭整轮折叠时，修改配置中的
foldMode 即可。
⚙️ 配置
在 profile 的 cordis.patch.yml 中配置：
- id: conversation-folding
name: '@theheartfickle/dsh-conversation-folding-plugin'
config:
foldMode: 'all'
auxVisible:
- context
- skill
foldMode 可选值：
| 值 | 行为 |
|---|
all | 整轮折叠，默认值 |
toolcall | 只折叠 thinking 之间的 tool call |
none | 关闭整轮折叠和 tool-call 分组，保留 thinking 增强样式 |
auxVisible 是“折叠时仍显示”的辅助项例外列表：
context：上下文注入行；不在列表中时折叠状态下隐藏。skill：skill 加载行；不在列表中时折叠状态下隐藏。auxVisible: [] 表示所有辅助项都隐藏（相当于之前的全隐藏行为）。
🗂️ 效果示意
思考阶段（正文未开始）
用户输入
┌──────────────────────────────┐
│ 折叠栏：展开过程 │
└──────────────────────────────┘
最近一次 thinking / tool call（增强样式）
正文输出后
用户输入
┌──────────────────────────────┐
│ 折叠栏：展开过程 │
└──────────────────────────────┘
LLM 输出（原生正文样式）
🔧 环境要求
- Node.js ≥ 20
- DSH（DeepSeek Harness）
许可证
MIT
