前言¶
DeepSeek Harness (DSH) 的 Web GUI 允许通过插件扩展功能。在开发或使用智能体进行长对话时，快速定位到特定的轮次或回顾上下文是常见需求。biggerboy/dsh-conversation-anchors 插件通过在对话区左侧绘制锚点轨，提供类似 Codex 的导航体验，并支持思考过程的折叠展示。
核心功能¶
该插件主要解决长会话的定位与阅读效率问题，包含以下核心能力：
- 锚点轨与悬停预览：默认 Codex 风格，在对话区左侧绘制浅灰短横线。当前滚动位置的线条更长、更深。鼠标悬停在横线上时，邻近线条会按距离缩短形成起伏，并弹出包含问题与回复摘要的预览卡片。
- 多风格切换：支持在设置中切换至 DeepSeek（右侧）风格，或使用 DSH 官方（右侧）风格。切换后，锚点轨会出现在对话区右侧或使用官方内置轨道。
- 键盘导航：在横线轨上或聚焦时，支持使用
j/k上下跳转，Home/End到首尾，实现无鼠标操作。 - 思考过程折叠：兼容旧版 DSH。当 DSH 官方 Compact 折叠未启用时，插件会将每轮回复中的“思考过程”折叠为单行展示，点击可展开/收起。
- 全会话大纲：DSH 0.1.2-alpha.3+ 版本支持
turnOutline投影，插件可列出全部轮次（含尚未载入的部分），点击未加载的刻度会按需分页加载并跳转。
安装与启用¶
安装前需确保环境满足要求：Node 版本为 ^22.19 || >=24，并安装了 dsh CLI。
1、使用以下命令从 npm registry 安装（推荐）：
dsh plugin --profile web add @biggerboy123/dsh-conversation-anchors
安装过程中 pnpm 可能会打印 missing peer 警告，这是良性提示，只要命令退出码为 0 即可。
2、重启 dsh web 服务以加载插件。刷新浏览器页面不会重新拉取插件。
使用方法¶
1、默认模式（Codex 左侧）：左侧短横线对应每一轮用户提问。悬停查看预览卡片，点击横线即可平滑滚动定位到对应消息。
2、切换到 DeepSeek（右侧）：打开 设置 → 通用，在「锚点风格」里选「DeepSeek（右侧）」。切换后，锚点轨会出现在右侧，槽位高度约 30%。
3、键盘操作：使用 Tab 键将焦点移动到横线轨上，然后使用方向键或 j/k 键快速跳转。
4、思考过程折叠：若 DSH 官方 Compact 折叠已启用，则由官方负责折叠；否则插件会将过程叙述收成「思考过程 · N 步」。
技术细节与限制¶
1、平台限制：仅支持 Web GUI 平台（platform: "web"），不支持 TUI 或 headless 模式。
2、DOM 注入：由于侧边栏 shell 无对外可注册的 slot，本插件采用 DOM 级注入的方式实现。
3、历史加载策略：
- 在 DSH 0.1.2-alpha.3+ 版本且支持 turnOutline 时，插件会合并官方大纲，不再自动后台拉取历史，避免拖死标签页。
- 在旧版 DSH（无大纲投影）或风格选择为官方时，插件会在打开会话后循环 loadOlder()，但最多会在约 4000 条消息（80 页）处停止，以防止浏览器卡顿。
4、版本依赖：推荐 DSH 0.1.2 及以上版本（含 alpha 版本），以获得全会话大纲支持。
总结¶
该插件通过锚点导航和条件性的思考过程折叠，为 DSH Web GUI 提供了增强的阅读体验。对于需要频繁回顾上下文或处理长对话的开发者来说，这能有效降低认知负荷。
