SocFeng/dsh-query-jump

dsh-query-jump

DSH WebUI 会话提问导航 · v1.1.0

长对话里，把「我之前问过什么」找回来
(｡･∀･)ﾉﾞ

version
license
dsh

简介

面向 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 隐藏删除入口

版本

1.1.0 — 当前稳定版

- DOM Map 索引 + 对话区 Observer，减少全文档扫描
- scroll rAF 合帧；spyActive 从上次 active 向外搜索 + 行缓存
- 有 projection 时 降低 list RPC 轮询（8s）；关闭同步历史且投影可用时不轮询
- Rail 滚轮改为 native non-passive，避免带动对话区滚动

1.0.2

- 跳转加载以 DOM 行可见 为准，不再因 snapshot 已有而提前结束
- 精确 flowKey 查找，减少滚错气泡
- 修复 sessions 注入，缓解点击无反应

1.0.1

- 修复超长上下文需「加载更早」时点击 query 卡住的问题
- 设置项「显示删除会话」可开关删除按钮

0.3.0

- 同步历史提问（按时间线补全未记录 query）
- 永久删除会话（官方未暴露能力）
- 删会话 / 删工作区 / 分叉时缓存自动同步

0.2.0

- 通义风短横线 + 悬停列表
- 设置页配置启用与前缀
- 平滑跳转 · 当前位置浮起高亮
- 重启持久化

0.1.x 为早期迭代。

开发

npm install
npm run build
npm test

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

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

说明

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

MIT · GitHub

♪(´▽｀) 为 DeepSeek Harness 打造