dsh-query-jump

简介

面向 DeepSeek Harness 的轻量插件：

• 对话区右缘一条淡色短横线
• 悬停展开提问列表，点击平滑跳回气泡
• 只收录真实用户提问，干净好翻

适合超长会话里快速定位历史问题 ✧

---

功能

功能	说明
提问列表	仅用户 Query，带日期 + 时间
一键跳转	点击 → 平滑滚动到对应消息
当前位置	正在阅读的条目会浮起高亮
低调轨道	平时几乎不抢视线，悬停才展开
自定义前缀	🤗 / ★ / 序号，自己定
设置页	设置 → 插件 → Query 定位
同步历史提问	从会话日志补全安装前未记录的 query
删除会话	永久删除（会话头 / 侧栏菜单，可开关）
缓存同步	删会话、删工作区、分叉时自动对齐
持久化	重启、更新后列表通常还在

---

安装

dsh plugin --profile web remove dsh-query-jump
dsh plugin --profile web add github:SocFeng/dsh-query-jump

装完后：

1. 重启 dsh web
2. 浏览器硬刷新（Ctrl + F5）

本地开发：

npm install && npm run build
dsh plugin --profile web add link:.

安装时若出现 peer 依赖 WARN，可直接忽略 (￣▽￣)

卸载：

dsh plugin --profile web remove dsh-query-jump

---

使用

步骤	操作
1	打开会话，看对话区右侧淡色短横线
2	鼠标移上 → 弹出提问列表
3	点击条目 → 跳到对应气泡（列表仍保留）
4	鼠标移出 → 列表自动收起

对话区                              右缘
┌─────────────────────┐            ──
│                     │            ──
│   ┌───────────┐     │ ◀── 跳转   ██  ← 当前
│   │ 提问气泡   │     │            ──
│   └───────────┘     │
│                     │     悬停 → 🤗 问过 A
│                     │           🤗 问过 B
└─────────────────────┘           🤗 问过 C

---

配置

路径：设置 → 插件 → Query 定位

选项	说明
启用面板	总开关
同步历史提问	按提问时间线补全未记录的 query
显示删除会话	控制标题栏垃圾桶与侧栏删除入口
自定义符号 / 序号	列表前缀样式
符号内容	最多 8 个字符，默认 🤗

也可以写进 profile：

config:
  enable: true
  markerStyle: emoji    # 或 number
  markerSymbol: "🤗"
  maxQuery: 200
  syncHistoricalQueries: true
  showDeleteSession: true   # false 隐藏删除入口

---

版本

当前稳定版：0.3.1

完整变更记录见 CHANGELOG.md。GitHub 上只维护 Latest release 一条说明；历史版本不再单独建 Release。

发版时：bump version → push → git tag vX.Y.Z → 新建一个 Release，notes 从 CHANGELOG 复制（模板见 .github/release-template.md）。

---

开发

npm install
npm run build
npm test

src/     Host + Client
lib/     构建产物
test/    单元测试

联调：link:. → 改代码 → npm run build → 硬刷新
（插件集合变更时需重启 dsh web）

---

说明

• 建议本机 127.0.0.1 访问 WebUI
• 很早的历史会先自动「加载更早」再跳转，稍等即可
• 不收录注入消息 / 工具事件
• 可与 Trajectory 等插件并存

---