dsh-quick-jump

适用于 DeepSeek Harness Web GUI 的用户消息快速导航插件。它在聊天区域旁提供一条可拖动的轨迹栏，适合在长对话中快速定位用户消息。

Persistent, draggable user-message navigator for DeepSeek Harness Web.

功能

• 只导航用户消息：仅为普通 user 消息建立位置，不混入 Agent、Tool、系统消息和 steering。
• 三态圆点：
  • 暗色实心点：可跳转、未选中；
  • 空心点：暂无有效锚点；
  • 高亮实心点：当前选中的消息。
• 智能上一条/下一条：自动跳过空心坏点，并在末尾循环查找。
• 轨道自动跟随：当前点超出可见范围时，圆点窗口会自动滚动。
• 可拖动位置：按住轨道顶部 ⠿，自由调整 X/Y 坐标。
• 外观设置：可调整圆点大小、圆点间距、一次显示数量、整体缩放和透明背景。
• 目录搜索：点击标题栏“跳转”按钮，按消息摘要搜索并定位。
• 自然交互：点击弹窗外部自动收起，弹窗带圆角缩放动画。
• 持久设置：位置与外观按会话保存在浏览器 localStorage，键为 dsh.quickJump.v1。
• 响应式布局：窄屏下轨道自动移动到右侧，设置面板使用移动端宽度。

安装

从 GitHub 安装

在 DeepSeek Harness checkout 中运行：

pnpm run dsh -- plugin --profile web add github:EclipseZhu/dsh-quick-jump

也可以使用 Git URL：

pnpm run dsh -- plugin --profile web add git+https://github.com/EclipseZhu/dsh-quick-jump.git

安装命令会：

1. 把插件加入 ${DSH_HOME:-~/.dsh}/profiles/web/package.json；
2. 自动把 dsh-quick-jump 加入 dsh.profile.bundles；
3. 通过 cordis.patch.yml 挂载插件。

安装后重启当前 DSH Web 进程，并刷新原来的 Web GUI 页面。无需启动第二个服务器。

本地安装

克隆后在 DeepSeek Harness checkout 中运行：

pnpm run dsh -- plugin --profile web add /absolute/path/to/dsh-quick-jump

Windows 示例：

pnpm run dsh -- plugin --profile web add "D:\path\to\dsh-quick-jump"

使用

快速跳转

• 点击轨道圆点：跳转到对应用户消息的回复位置；
• 点击 ⌃ / ⌄：前往上一条或下一条可用消息；
• 点击数字计数：打开完整消息目录；
• 点击标题栏“跳转”：打开或关闭目录与设置。

调整轨道

1. 打开“跳转”；
2. 展开“轨道设置”；
3. 修改圆点大小、间距、显示点数、整体大小和背景透明度；
4. 或按住轨道顶部 ⠿ 直接拖动；
5. 点击“恢复默认设置”可回到默认值。

设置会即时保存，不需要单独点击保存。

升级

pnpm run dsh -- plugin --profile web update dsh-quick-jump

如果使用 GitHub spec 安装，也可以重新执行安装命令获取最新提交。

卸载

pnpm run dsh -- plugin --profile web remove dsh-quick-jump

卸载后重启 DSH Web。若还要清除浏览器中的外观设置，可删除 localStorage 键：

dsh.quickJump.v1

项目结构

.
├─ cordis.patch.yml        # Web profile 自动挂载层
├─ lib/
│  ├─ index.js             # Host 空入口
│  └─ client.js            # 浏览器 UI 与交互实现
├─ docs/
│  ├─ images/              # README 截图
│  └─ quick-jump-demo.html # 脱敏演示图源文件
└─ package.json

技术说明

插件通过以下 Cordis Slot 增量挂载，不替换整个聊天界面：

• conversation.chat.assistant-actions：为已完成的 Assistant 消息注册定位锚点；
• conversation.session.header.actions：注册“跳转”入口和轨道 UI。

插件是纯 Client UI；Host apply() 为空。所有 Slot、样式和订阅都随 Cordis Fiber 生命周期清理。

隐私

README 截图是脱敏演示图，不包含真实会话内容。插件不会上传消息数据；消息摘要只在当前浏览器页面中读取和显示。

License

MIT