对话折叠导航器 KhalilHsu/dsh-plugins

DSH 插件

[!IMPORTANT]
停止维护 / Maintenance ended — 2026-10-16

DeepSeek Harness 官方现已内置过程折叠与轮次导航，覆盖本仓库两个插件的核心功能。本仓库即日起停止更新和维护，不再适配新版 DSH 或发布新版本。请使用官方实现，以官方版本为准。下方文档保留作为历史参考，不建议在当前 DSH 中安装这些旧插件。

DeepSeek Harness now includes native process folding and turn navigation, covering the core features of these plugins. This repository is no longer maintained and will receive no further compatibility updates or releases. Please use the official DSH implementation. The documentation below is retained for historical reference; these legacy plugins are not recommended for current DSH versions.

面向 DeepSeek Harness (DSH) Web GUI 的纯 UI 插件。通过官方 Profile-Plugin 机制（dsh plugin）干净安装，无需改动上游 Harness 源码。

📦 包列表

| 目录 | 包 | 状态 | 功能 |
| ui-conversation-folded/ | @khalilhsu/dsh-ui-conversation-folded | 已停止维护 | 按轮折叠聊天内容：每一轮的中间活动（思考 / CoT、工具调用、过程叙述）整齐折叠进一个 288px 的滚动区。最终结论文本和轮次指标留在外面，保持可见。支持流式自动滚动、总结后自动折叠、全局开关。 |
| query-navigator/ | @khalilhsu/dsh-ui-query-navigator | 已停止维护 | Codex 风格的多轮查询导航器：左侧固定一条导轨，每条用户查询对应一个标记。滚动时高亮当前轮次，点击跳转，悬停预览。支持按需加载尚未载入的较早轮次。完全独立 —— 可与任意会话插件搭配使用。 |
| cot-fold/ | @deepseek-ai/dsh-client-ui-cot-fold | 已归档 | 早期实验：只对推理（「Think」）行做限高 / 折叠。已被 ui-conversation-folded 取代。 |

🚀 快速开始（安装与卸载）

通过 npm 安装（历史参考）

在 DeepSeek Harness 环境中运行：

Per-turn folding
dsh plugin --profile web add @khalilhsu/dsh-ui-conversation-folded

Query navigator (can be installed independently or together)
dsh plugin --profile web add @khalilhsu/dsh-ui-query-navigator

Restart dsh web, then refresh your browser
dsh web

卸载

dsh plugin --profile web remove @khalilhsu/dsh-ui-conversation-foldedsh
dsh plugin --profile web remove @khalilhsu/dsh-ui-query-navigator

💡 主要功能（ui-conversation-folded）

- 限高框架：中间思考过程和工具调用最高 288px（可用 --cot-fold-max-height 配置），内部滚动。
- 可折叠摘要栏：每一轮显示一条可展开的摘要栏，内容为 Duration · Tool count · Thinking blocks。
- 流式感知跟随：生成时自动滚动到最新的 token／工具输出。向上滚动时暂停；回到最底部时恢复。
- 完成时自动折叠：最终答案开始流式输出后，中间推理自动优雅折叠。
- 提问始终可见：ask_user_question 行渲染在折叠区之外，作为交互边界，因此待处理的「提问·等待回答」行永远不会被隐藏。
- 全局头部开关：会话头部有常驻的开关按钮（思考折叠 / 思考展开），状态保存在 localStorage。
- 标准附件槽位：完全对齐 DSH 附件槽位契约，适用于消息画廊和输入框附件。
- 交互零损失：所有子交互（查看工具输出、展开单个工具、复制 markdown）100% 可用。

💡 主要功能（query-navigator）

- 全会话轮次导轨：整个对话中每条用户提问对应一个标记，包括尚未加载的较早轮次。
- 滚动感知高亮：滚动时，最接近视口阅读线的标记自动高亮。
- 点击跳转与按需分页：点击任意标记即可滚动到对应提问；未加载的轮次按需分页载入。
- 悬停预览与智能摘要：轻量 Host 投影为所有轮次提供 80 字符摘要和图片数量徽标，无需下载庞大的助手历史。
- 全局头部开关：会话头部有常驻的开关按钮（Query 导航），状态保存在 localStorage。
- 完全独立：适用于任何声明了 conversation.input.dock 槽位的对话插件——不依赖本仓库中的其他插件。

🛠️ 本地开发与构建

如果你想从源码在本地构建或修改插件： sh
git clone https://github.com/KhalilHsu/dsh-plugins.git
cd dsh-plugins/ui-conversation-folded # or query-navigator

Symlink node_modules to your local deepseek-harness checkout

ln -s /path/to/deepseek-harness/packages/client/ui-conversation/node_modules node_modules

Build the client & node bundles

npm run bundle

Install locally into your profile

dsh plugin --profile web add /path/to/dsh-plugins/ui-conversation-folded

License

MIT