前言¶
在 DeepSeek Harness（DSH）里做长会话时，右侧的轮次导航条能按刻度回看每一轮，但要把「自己当时问了什么」串起来，往往还得在对话区里上下翻。内置索引侧重轮次刻度与预览，不单独列出全部人类提问，也不提供按关键词筛问句的入口。
下面介绍社区插件 dsh-plugin-turn-index（维护者 lizongze，分类：客户端）。它在不替换原导航的前提下，在索引条底部增加可展开的提问列表，支持搜索、高亮与点击跳转，适合在 Web / Desktop 客户端里快速定位某一轮的提问。
这是什么¶
dsh-plugin-turn-index 是 DSH 的 客户端插件（dsh.client.platform: web），当前版本 1.0.1，许可证 MIT。源码与说明见 GitHub，社区目录页为 skillhub.cn 插件条目。
一句话定位：给会话右侧「轮次导航」索引条追加提问索引——展开全部提问、模糊搜索过滤、高亮命中并点击跳到对应轮次；原有的刻度、悬浮预览、当前轮高亮、历史回补逻辑保持不变。
核心功能¶
资料中明确的能力如下。
- 入口：轮次导航条出现时，索引条底部出现一个
<箭头；点开展开「提问索引」浮层。 - 列表：每行显示轮次编号与该轮提问的前几行；标题后显示当前列表中的提问数量（一个数字）。
- 搜索：标题与搜索框同一行；输入关键词即时过滤，匹配位置背景高亮，结果按相关度排序；
Enter跳到第一条匹配，Esc先清空搜索、再按一次收起浮层。 - 跳转：点击某一行跳到该轮；浮层内当前轮高亮。目标轮尚未加载进窗口时，会先自动回补历史再跳转。
- 布局：内容少时浮层底部贴索引条、向上延伸；内容超出上方空间后，顶部停在聊天区顶部，直至占满窗口底部后才在浮层内滚动；点浮层外或再点箭头可收起。
- 范围：只增强内置索引，不替换索引条本身。
显示条件：内置轮次导航在会话面板较窄时会被容器查询隐藏（<= 900px），此时插件也不显示；拉宽窗口或调整界面缩放后即可看到索引条与箭头。
原理概要¶
便于判断是否与自己的 DSH 版本匹配，简要说明实现依赖（均来自 README）。
- 数据：读取当前会话的
turnOutline投影（轮次号、turn/start的 seq、提问/回答预览），未加载进窗口的旧轮次也能列出。 - 注册：挂到
shell.overlayframe 级浮层槽位，无需改动对话视图或索引条源码。 - 定位：通过 DOM 找到带
button[data-index]刻度的<nav>，测量位置，箭头固定在索引条底部。 - 跳转：点击列表项时驱动索引条刻度按钮（必要时先滚动索引条以渲染虚拟化刻度），复用官方的
loadThrough、滚动与当前轮激活逻辑。
兼容性说明：依赖 DSH 0.2.x 的 turnOutline 投影与 button[data-index] 轮次刻度 DOM。
安装与启用¶
要求 DSH 0.2.x（Web / Desktop 客户端均适用）。
从本地目录安装到某个 profile（示例路径按 README 原文）：
dsh plugin --profile web add file:D:\path\to\dsh-plugin-turn-index
发布到 npm 后也可按包名安装：
dsh plugin --profile web add dsh-plugin-turn-index
或在 Web UI 的「插件」管理里把该目录作为本地包安装。安装后刷新页面。
Desktop 的 desktop profile 由 Electron 托管，CLI 不直接管理；可通过插件管理面板或宿主提供的安装入口，使用 file:D:\path\to\dsh-plugin-turn-index 装入该 profile。
卸载示例：
dsh plugin --profile web remove dsh-plugin-turn-index
或在插件管理中移除 dsh-plugin-turn-index。
插件以当前 DSH 进程权限在浏览器侧运行；安装前建议浏览 lib/client.js 等源码并确认 MIT 许可证是否符合你的环境要求。
典型用法¶
交互步骤与 README 一致，可按下面顺序自测。
- 打开一段有多轮对话的会话，确认右侧出现轮次导航条（面板宽度需大于约 900px）。
- 点击索引条底部的
<箭头，展开提问列表。 - 在标题行旁的搜索框输入关键词，观察过滤与高亮；按
Enter跳到第一条匹配。 - 点击任意一行，确认跳转到对应轮次；对尚未加载的旧轮，应先回补再定位。
- 按
Esc清空搜索，或点浮层外 / 再点箭头收起。
适用场景与注意¶
适合：在长 Harness 会话里按「问过的原话」检索并跳轮，而不是仅靠刻度编号回忆内容。
注意：
- 窄屏下内置导航隐藏时插件不会出现，这是与内置行为一致的限制，不是单独故障。
- 将来若 DSH 为索引条提供正式扩展槽位，插件可能改为槽位接入并去掉部分 DOM 兼容层（README 中的兼容性说明）。
- 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文事实以仓库 README 与
package.json为准。
结尾¶
dsh-plugin-turn-index 在保留官方轮次导航的前提下，用 turnOutline 与 shell.overlay 补上「全部提问 + 搜索 + 跳转」这一层。需要安装命令与交互细节时，可直接查阅 GitHub 仓库 或上述目录页。
