前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在通过社区插件扩展功能。在处理长对话或历史记录时，快速定位到特定的用户提问通常需要手动滚动，效率较低。dsh-bookmark 插件通过在对话侧边栏添加导航标记，解决了这个问题，提供了类似 Codex 的导航体验。
插件介绍¶
dsh-bookmark 是由用户 leilei3167 维护的一个客户端插件。它为 DSH Web UI 提供对话导航功能，在对话左侧的边缘区域放置紧凑的标记，每个标记对应一个用户或引导消息。
安装与启用¶
安装该插件需要使用 DSH 的插件管理命令。安装后需要重启 Web 客户端以加载新功能。
安装命令如下：
dsh plugin --profile web add github:leilei3167/dsh-bookmark
安装完成后，需要完全停止并重启 dsh web 进程，以确保浏览器端接收到新的客户端包：
dsh web
若要更新已安装的插件，可以使用以下命令：
dsh plugin --profile web update dsh-bookmark
更新后同样需要重启 dsh web。
核心功能¶
该插件实现了以下核心能力：
- 消息标记：每个用户或引导消息都会生成一个标记。
- 紧凑展示与交互：标记尺寸为 12px，悬停时会展开，并呈现 Codex 风格的三级级联效果。
- 当前位置高亮：视口锚点附近的标记会显示为黑色，指示当前阅读位置。
- 悬停预览：悬停时，卡片会显示用户消息的标题以及下一条助手回复的预览。
- 直接导航：点击标记或使用键盘快捷键，可以直接平滑滚动到对应的对话回合。
- 会话跟随：插件会自动跟随当前选中的会话，包括已保存的对话历史。
- 历史加载：当查看旧会话时，插件会通过原生的 DSH 会话 API 加载历史记录。
- 响应式布局：当侧边栏或对话布局发生变化时，插件会自动重新定位。
典型用法¶
使用该插件主要涉及三种交互方式：
- 悬停预览：鼠标悬停在标记上，标记及其附近的标记会展开，显示用户提问和助手回复的预览。
- 点击跳转：点击标记，页面会平滑滚动到对应的用户消息处。
- 键盘导航：
- 使用
ArrowUp或ArrowDown键聚焦标记。 - 使用
Enter或Space键触发标记对应的滚动或按钮动作。
- 使用
注意事项与适用场景¶
- 运行环境：该插件完全在 DSH Web 客户端内部运行，不会读取 API 密钥，也不会将对话内容发送到外部服务。
- 数据来源：对话数据仅从活动的 DSH 会话快照和已渲染的聊天节点中读取，并保留在浏览器内存中。
- 技术实现：插件使用
[data-chat-anchor-key]和[data-chat-flow-kind]属性来关联标记与消息。DOM 选择器仅作为兼容性回退；插件不使用哈希主机类名。 - 生态发现：仓库使用了
deepseek-harness、dsh和dsh-plugin作为 GitHub 主题，以便 DSH 插件发现工具能够检索到它。 - 许可证：插件采用 MIT 许可证。
结语¶
dsh-bookmark 为 DSH Web UI 提供了基础的对话导航能力，适合需要在长对话中快速定位上下文的场景。安装前建议检查其源码与许可证。更多详情可访问 GitHub 仓库 或 DSH 社区目录。
