前言¶
在 DeepSeek Harness（DSH）里读长回复时，模型输出往往带多级 Markdown 标题，但 Web 与 Desktop 界面默认缺少「当前这一轮（Turn）内部」的章节索引。要在某一段落之间跳转，通常只能手动滚动或依赖外层的 Turn 导航，对阅读与复盘都不够顺手。
@addozhang/dsh-turn-toc 是面向 DSH Web 与 Desktop GUI 的客户端插件，在消息列右侧的 gutter 里渲染与内置 TurnNavigator 相近的无框刻度条，悬停可展开为多级标题大纲，并支持滚动跟踪与一键跳转。下面介绍它的定位、能力与安装方式。
这是什么¶
- 名称：
@addozhang/dsh-turn-toc（npm 包名；仓库addozhang/dsh-turn-toc） - 维护者：addozhang
- 分类：客户端（
dsh.client注入 Web 端 UI） - 一句话：Turn section outline (TOC) plugin for the DeepSeek Harness Web & Desktop GUI——为当前正在阅读的 Turn 提供可交互的多级标题大纲。
- 许可证：MIT（见仓库
LICENSE） - 当前版本（package.json）：0.1.1
- DSH 兼容（engines.dsh）：
>=0.2.0-rc.1 <0.3.0
插件挂在居中消息列外侧的右侧 gutter，与外层 TurnNavigator 并列，平时不遮挡正文。
核心功能¶
以下能力均来自项目 README 的功能说明。
静止态：无框刻度条¶
在消息列旁按标题层级（H1–H6）渲染 subtle 的横向刻度条，视觉风格与 DSH 内置 TurnNavigator 一致，不盖住文字，也不与外层 Turn 导航冲突。
双重滚动跟踪（Turn + 标题）¶
自动识别视口阅读线所在的 Turn，并在滚动时高亮当前章节（H1–H6）。
悬停展开与固定¶
指针悬停时平滑展开为半透明 MenuSurface 大纲卡片；提供 pin 开关，需要时可保持大纲常开。
一键跳转到章节¶
点击大纲中的标题行，或在不展开的情况下直接点击刻度条，即可平滑滚动到对应章节，并带有短暂高亮反馈。
快速切换 Turn¶
大纲头部提供按钮：跳转到当前 Turn 顶部（Turn N）、上一条 Turn（↑）、下一条 Turn（↓）。
响应式自动隐藏¶
仅当对话容器宽度 >= 1280px 且右侧 gutter >= 176px、有足够空间向右侧展开且不与消息列或外层 TurnNavigator 重叠时，才显示该组件。
安装与启用¶
插件通过 DSH 的 web profile 安装；安装后需重启正在运行的 dsh profile 或 DeepSeek Harness Desktop 应用，以便浏览器 roster 加载客户端 bundle。
从 npm 安装¶
dsh plugin --profile web add @addozhang/dsh-turn-toc
从 GitHub 安装¶
dsh plugin --profile web add github:addozhang/dsh-turn-toc
开发本插件时要求 Node >=22.19.0（见 package.json engines.node）；作为使用者只需满足 DSH 与上述 profile 要求即可。
典型用法¶
README 未单独列出配置文件或 CLI 子命令；启用插件后，在宽度足够的 Web/Desktop 界面中打开含 Markdown 标题的长 Turn 即可使用：
- 在右侧 gutter 查看按层级缩进的刻度条，确认当前阅读位置。
- 将指针移到 gutter 上，展开大纲；需要常驻时可打开 pin。
- 点击某一标题或刻度，跳转到该节；用头部按钮在当前 Turn 内回到顶部，或切换到相邻 Turn。
仓库 docs/demo.gif 展示了悬停展开与一键跳转的效果（见 GitHub README）。
适用场景与注意¶
适合谁：经常在 DSH Web 或 Desktop 里阅读带 H1–H6 结构的长回复、需要在单 Turn 内快速定位章节的开发者或日常用户；宽屏布局（满足上述最小宽度）下体验最完整。
生态说明：DSH 采用「一切皆插件」的扩展方式；社区目录站点（如 SkillHub 上的插件页）与 DeepSeek、幻方无官方从属关系，本文不以「官方应用商店」表述。
安全与权限：客户端插件随当前 DSH 进程在浏览器环境中运行，安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境与合规要求。
结尾¶
dsh-turn-toc 把 Turn 内的 Markdown 标题变成可跟踪、可跳转的侧边大纲，并与 DSH 既有 Turn 导航风格对齐。需要安装或 issue 时可访问：
- 社区目录页：https://www.skillhub.cn/plugins/addozhang/dsh-turn-toc
- GitHub：https://github.com/addozhang/dsh-turn-toc
