前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时，长对话的管理与内容定位是常见痛点。官方 Turn Rail 导航轨虽然提供了刻度，但在查看历史记录时往往缺乏内容预览和精细过滤能力，导致在长对话中难以快速定位关键信息。dsh-chat-toc 插件旨在解决这一导航与大纲增强问题，通过深度赋能原生 Turn Rail，提供轻量级、高性能的对话浏览体验。
是什么¶
dsh-chat-toc 是一款 DSH Web GUI 的对话导航与大纲增强插件，由开发者 a792883583 维护。它 100% 融合官方原生 Turn Rail 导航轨，移除冗余轨道，提供双向悬停卡片、收藏过滤及 Markdown 导出功能，无需额外配置即可在 Web 界面中运行。
核心功能¶
- 原生融合与视觉优化：100% 融合官方 Turn Rail 导航轨，移除冗余轨道，不破坏界面原有留白。
- 悬停卡片：鼠标滑过轨道刻度时，优雅弹出预览卡片，清晰呈现用户提问与 AI 回答。
- 稳定性机制：采用 300ms 黄金防抖，鼠标从轨道移入卡片时卡片保持稳定悬浮，便于选中文本或点击操作。
- 交互操作：卡片支持一键收藏对话与复制内容。
- 持久化存储：基于会话 ID 和消息指纹进行跨会话持久化，刷新页面不丢失收藏状态。
- 工具条功能：右上角提供扁平工具条，包含关键词搜索（支持 Enter 触发深度回溯搜索）、代码/工具胶囊过滤、Markdown 大纲导出。
- 主题适配：支持多语言与明暗主题自适应。
安装与启用¶
安装插件：
dsh plugin --profile web add dsh-chat-toc
安装或更新后，刷新 dsh web 页面即可生效。
典型用法¶
- 本地开发调试时，可使用链接方式安装：
dsh plugin --profile web add link:/path/to/dsh-chat-toc
- 在长对话中，按 Enter 键可触发全会话深度回溯搜索，系统会自动加载更早的消息并定位目标。
- 点击工具条中的代码过滤胶囊，可快速过滤出代码变更或工具调用轮次。
- 点击收藏按钮开启收藏过滤模式，已收藏项会呈金色高亮。
- 点击大纲导出按钮，可将整场对话的 Markdown 结构大纲复制到剪贴板。
适用场景与注意¶
该插件适合需要频繁查阅长对话历史、进行代码或工具调用定位、以及对对话内容进行归档分享的开发者。
注意：
* 需要使用带有官方 Turn Rail 导航轨的 DSH Web 版本（已在 @deepseek-ai/dsh@0.1.5-rc.2 测试通过）。
* 插件依赖 @deepseek-ai/dsh-client-locale 和 @deepseek-ai/dsh-client-runtime。
* 纯前端增强，无需宿主侧服务，无需额外配置。
短结尾¶
dsh-chat-toc 通过增强原生 Turn Rail，为长对话提供了轻量级、高性能的导航与大纲工具。它不改变 DSH 的核心架构，而是作为客户端插件无缝集成。更多细节可在 GitHub 查看。
