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

DSH 插件

npm version
npm version
License: MIT

用于 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 环境中运行：

逐轮折叠
dsh plugin --profile web add @khalilhsu/dsh-ui-conversation-folded

查询导航器（可独立安装，也可一起安装）
dsh plugin --profile web add @khalilhsu/dsh-ui-query-navigator

重启 dsh web，然后刷新浏览器
dsh web

卸载

dsh plugin --profile web remove @khalilhsu/dsh-ui-conversation-folded
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 槽位的对话插件配合使用——不依赖本仓库中的其他插件。

🛠️ 本地开发与构建

如果你想从源码在本地构建或修改该插件：

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

许可证

MIT