前言¶
在 DeepSeek Harness（DSH）里跑长对话时，助手回复往往带多级 Markdown 标题，正文一滚就很难找回「刚才那段讲的是什么」。靠浏览器自带目录、手动翻 DOM，或者事后复制全文再整理，都跟不上流式生成。
dsh-outline 是面向 DSH Web GUI 的客户端插件：在会话页右侧挂一棵实时大纲树，把用户问题与回复里的 H1–H6 标题串起来，流式输出时同步更新，点节点即可定位正文。交互形态移植自维护者 urzeye 的 Ophel 浏览器扩展，按 DSH 官方插件约定打包发布。
这是什么¶
dsh-outline（GitHub：urzeye/dsh-outline）由 urzeye 维护，当前 npm 版本为 0.1.6，MIT 许可证。分类为客户端插件，在 SkillHub 目录页可见：urzeye/dsh-outline。
它解决的核心问题是：长会话里缺少一个与内容同步、可点击跳转的结构化导航，而不是事后静态目录。
核心功能¶
实时大纲¶
大纲由会话事件流构建：用户问题作为一级节点，助手回复中的 Markdown 标题挂在其下，不抓取 DOM。流式生成时随 token 实时更新；刷新、重连、历史分页由 DSH runtime 自动重建。
点击节点会滚动定位到正文对应位置，并高亮当前阅读位置。
层级与视图¶
- 层级滑块控制展开深度（0–6 档），节点可单独展开/收起，支持一键展开/收起全部
- 关键词搜索（带匹配计数）、按会话收藏、「只看收藏」模式
- 一键复制大纲、回到顶部/底部
面板形态¶
面板以 shell.overlay 浮层呈现：右缘触发条悬停可预览，可固定常驻，可拖拽移动，不挤压聊天区。
主题与国际化¶
跟随 DSH 主题变量与明暗模式；界面文案中英文随 DSH 语言切换。
环境要求¶
- 已安装 DeepSeek Harness Web GUI
- Node.js ≥ 22.13（仅本地开发与构建时需要）
安装与启用¶
安装命令通过 dsh plugin 转发给 profile 目录内的 pnpm。安装后需重启 dsh web 生效——插件的 host 部分在 DSH 启动时加载。
从 npm 安装（推荐）¶
dsh plugin --profile web add dsh-outline@latest
已经装过时请带 @latest：裸包名会沿用 lockfile 里的旧版本，不会自动升级。
从 tarball 安装¶
可自行 pnpm pack，或从 GitHub Releases 下载：
dsh plugin --profile web add ./dsh-outline-0.1.6.tgz
本地路径安装（开发调试）¶
cd /path/to/dsh-outline
pnpm install
pnpm build
dsh plugin --profile web remove dsh-outline # 若先前装过 npm 版，先卸掉
dsh plugin --profile web add /path/to/dsh-outline
第一次安装（以及任何 host 半变更）后需重启 dsh web。打开任意会话页，悬停右缘大纲触发条，确认面板出现。
卸载¶
dsh plugin --profile web remove dsh-outline
典型用法¶
- 启动
dsh web，打开任意会话页。 - 鼠标悬停会话页右缘的大纲触发条，预览大纲面板。
- 点击触发条或面板右上角的固定按钮，将面板固定常驻；拖动标题栏可移动面板位置（拖动即固定）。
- 面板内：点击节点跳转正文；顶部滑块调整展开层级；节点行内提供展开/收起与收藏按钮；支持关键词搜索。
适用场景与注意¶
适合谁
- 经常在 DSH Web GUI 里跑长对话、技术文档式回复的开发者
- 需要在流式生成过程中随时回看章节结构、快速跳转的用户
使用注意
- 命令必须带
--profile web，否则加不到 Web GUI 那套 profile。 - 面板不出现：查看
dsh web终端是否有插件加载报错；确认装的是预期版本（本地路径而非 npm 旧版）。 - README 提示：若以浏览器方式使用 DeepSeek Harness，维护者建议优先体验 Ophel，功能更全面、体验更流畅；
dsh-outline面向 DSH 插件生态内的集成场景。 - 插件以当前
dsh进程权限运行，安装前应检查源码与 MIT 许可证，确认来源为 urzeye/dsh-outline。
SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-outline 把「用户问题 + Markdown 标题」收成一棵实时大纲，挂在 DSH 会话页右侧，流式更新、点击定位，适合长对话场景下的结构导航。
