前言¶

DeepSeek Harness (DSH) 采用插件化架构。在进行多轮对话或涉及分支/子会话时，快速定位特定提问往往需要手动滚动查找。dsh-chat-index 是一个 DSH Web 插件，通过可视化的提问索引和链面板，解决这一导航痛点。

核心功能¶

右侧提问窄条¶

在会话右侧会出现一个窄条，每个提问对应一个圆点。圆点按真实提问时间间隔分布，顶部为最早提问，底部为最近提问。
* 点击圆点：聊天区滚动定位并短暂高亮对应提问。
* 按住拖动：快速滑动聊天记录，拖动时右侧浮出该提问的摘要小窗。

链面板¶

点击会话标题行右侧的 ≡ 开关，或窄条底部的 ⇱，可展开链面板。面板展示每个节点的摘要和时间。
* 分支/子会话：以子树视图挂载在主会话下。点击节点可跳转，需先切换到对应会话再定位高亮。
* 收起：点击 ✕ 收起面板。

空会话处理¶

空会话不显示右侧窄条，但链面板始终可用，面板显示“还没有提问”。

技术实现¶

• 数据源：基于当前会话实时快照 + 持久历史 (session.history)，切换会话时自动重建。
• 纯前端：插件为纯前端实现，宿主仅保留最小 loader 入口。

安装与启用¶

通过 DSH 官方插件通道安装：

dsh plugin --profile web add dsh-chat-index

安装完成后刷新页面即可生效。

使用步骤¶

1、打开任意会话，右侧出现窄条（有提问时）。
2、点击圆点或按住拖动，跳到对应提问并高亮。
3、点击标题行右侧 ≡（或窄条底部 ⇱）展开链面板，点击节点跳转，✕ 收起。
4、会话内的开关状态各自记忆，刷新页面后默认收起。

注意事项¶

• 安装方式：手动安装与官方安装通道二选一，避免双重挂载。
• 环境要求：需配置 NPM_TOKEN 才能自动发布。

总结¶

dsh-chat-index 为 DSH Web 提供了可视化的会话导航能力，特别是针对分支会话的子树展示，能显著提升长对话的查阅效率。