前言¶

在使用 DeepSeek Harness Web UI 处理长对话时，默认的交互方式通常只能依赖页面滚动。随着对话记录变长，快速定位到特定提问或回顾上下文会变得低效。这种操作上的割裂感是提升使用体验的主要阻碍。DeepSeek Harness 消息导航器正是为了解决这一痛点而生，它通过在对话流左侧引入类似 Codex 的刻度导航，让浏览历史记录变得更加直观。

这是什么¶

这是一个运行在浏览器端的客户端插件，旨在为 DeepSeek Harness Web UI 增加会话消息导航能力。项目由 miaomiao636 维护，基于 MIT 许可证开源。它通过读取 Web UI 的渲染内容，为每一条普通用户消息生成可交互的刻度标记，无需在服务端存储任何数据。

核心功能¶

插件提供了一套完整的消息导航解决方案，核心能力包括：

1. 精准刻度生成：只为普通用户消息和用户插话生成刻度，AI 回答、思考过程、工具调用及状态内容不计入。
2. 历史记录加载：自动加载完整历史记录，突破 DSH 默认只渲染最新页面的限制。
3. 视觉跟随与定位：深色模式下的长刻度会跟随当前阅读位置；支持悬停预览、点击跳转，以及键盘操作（方向键、Home、End、Enter）。
4. 流式与状态处理：自动处理流式生成、新消息插入、加载较早记录、内容重排及会话切换，保证导航逻辑不中断。
5. 主题与性能：使用 Harness 的 --dsw-* 主题变量，兼容深色模式和减少动画设置；逻辑完全在浏览器本地运行，不持久化消息内容。

安装与启用¶

安装此插件需要目标环境支持 DeepSeek Harness 0.1.0-rc.6 Web UI 合约。

1. 安装插件
在终端中执行以下命令，将插件添加到 web profile：

dsh plugin --profile web add dsh-codex-message-navigator

2. 验证安装
安装完成后，进入 web profile 目录检查依赖树，确认插件已生效：

dsh plugin --profile web add dsh-codex-message-navigator
cd ~/.dsh/profiles/web
pnpm ls dsh-codex-message-navigator --depth 0

若需从本地源码安装，请使用绝对路径：

dsh plugin --profile web add /absolute/path/to/deepseek-message-navigator

典型用法¶

安装并重启 DSH Web UI 后，对话窗口左侧会自动出现消息刻度。操作方式如下：

• 浏览：鼠标悬停在刻度上，会显示对应问题的预览卡片。
• 跳转：点击刻度或预览卡片，页面会平滑滚动到对应的用户提问处。
• 键盘操作：使用方向键切换刻度，Home/End 快速定位首尾，Enter 确认跳转。

适用场景与注意¶

• 环境要求：确保 DeepSeek Harness 版本为 0.1.0-rc.6，当前插件依赖 Web UI 合约中的特定 DOM 结构（如 [data-conversation-scroll]）。
• 桌面版兼容：插件主要针对 web profile 设计。若在桌面版应用中使用，需确认该应用是否使用 web profile，并检查 DSH_HOME 配置是否正确指向应用的数据目录，否则可能安装失败。
• 隐私与安全：插件仅读取页面已渲染的文本进行导航生成，不包含网络请求、遥测或本地存储。所有刻度均为可聚焦的无障碍元素，并提供中文标签。
• 许可：使用本项目需遵守 MIT 许可证，建议安装前查看源码以确认当前运行逻辑。

结尾¶

消息导航器通过极简的本地化逻辑，解决了长对话场景下的导航痛点。对于需要频繁查阅历史上下文的开发者或用户，这是一个无需额外服务支持即可提升效率的工具。

• 项目地址：https://github.com/miaomiao636/dsh-message-navigator
• 插件目录：https://www.skillhub.cn/plugins/miaomiao636/dsh-message-navigator