dsh-quick-toc

> [English](README.en.md) | 中文

DeepSeek Harness（DSH）对话大纲插件：把 AI 回复中的 Markdown 标题（H1–H6）提取成可导航的大纲面板，按对话回合分组，自动跟随阅读位置。

功能

• 按回合分组 —— 每条用户消息 + 其后续 AI 回复为一组，组头显示该组最后一条消息的结束时间
• 自动跟随高亮 —— 滚动对话框时，视口内可见的回合在大纲中自动点亮（多组可同时点亮）；大纲自动加载并滚动，保证正在读的组始终可见
• 平滑跳转 —— 点击标题平滑滚动到对话中该标题的准确位置
• 可停靠、可缩放 —— 左右停靠（拖顶部横条移动）、边缘/角部拖拽调整大小、收起成可拖动的边缘把手；大小与位置自动记忆
• 滚动条跟随停靠方向 —— 停靠左侧时滚动条在左，停靠右侧时在右
• 分页渲染 —— 默认显示最近几组，大纲滚动到顶部自动加载更早的组
• Markdown 清理 —— 标题中的 加粗、*斜体*、` 代码 、[链接](url)、~~删除线~~` 等行内标记自动剥离
• 对话无标题时自动隐藏；适配深色 / 浅色主题

安装

通过 DSH CLI 安装（已发布 npm，只要名字）：

dsh plugin --profile web add dsh-quick-toc

或从 GitHub 安装：

dsh plugin --profile web add github:LyaxZ/dsh-quick-toc

或本地目录安装：

dsh plugin --profile web add <本目录路径>

重启 DSH（Windows 上双击 restart-dsh.bat）后打开 Web UI。大纲默认收起——点击对话区左侧边缘的小把手展开。

使用

• 点击大纲标题跳转到对话中对应位置
• 拖动顶部横条移动面板；点 ◀ / ▶ 按钮切换左右停靠
• 拖右边缘调宽度、下边缘调高度、右下角同时调
• 大纲滚动到顶部可加载更早的组

开发

• lib/client.js —— 全部 UI 逻辑（浏览器端）
• lib/index.js —— 宿主端空入口
• cordis.patch.yml —— loader patch（符合官方 bundle 规范）
• 改 client.js 后浏览器硬刷新即可生效；改 loader / patch 需重启 DSH

License

MIT © 2026 LyaxZ