dsh-query-jump
DSH WebUI 会话提问导航 · v1.1.0
长对话里，把「我之前问过什么」找回来
(｡･∀･)ﾉﾞ
简介
面向 DeepSeek Harness 的轻量插件：
- 对话区右缘一条淡色短横线
- 悬停展开提问列表，点击平滑跳回气泡
- 只收录真实用户提问，干净好翻
适合超长会话里快速定位历史问题 ✧
功能
| 功能 | 说明 |
|---|
| 提问列表 | 仅用户 Query，带日期 + 时间 |
| 一键跳转 | 点击 → 平滑滚动到对应消息 |
| 当前位置 | 正在阅读的条目会浮起高亮 |
| 低调轨道 | 平时几乎不抢视线，悬停才展开 |
| 自定义前缀 | 🤗 / ★ / 序号，自己定 |
| 设置页 | 设置 → 插件 → Query 定位 |
| 同步历史提问 | 从会话日志补全安装前未记录的 query |
| 删除会话 | 永久删除（会话头 / 侧栏菜单，可开关） |
| 缓存同步 | 删会话、删工作区、分叉时自动对齐 |
| 持久化 | 重启、更新后列表通常还在 |
安装
dsh plugin --profile web remove dsh-query-jump
dsh plugin --profile web add github:SocFeng/dsh-query-jump
装完后：
- 重启
dsh web
- 浏览器硬刷新（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
♪(´▽｀) Made for DeepSeek Harness
