dsh-indexbookmark
DSH（DeepSeek Harness）Web 界面插件：对话问题索引。在输入框右侧加一个 ☰ 按钮，点开就能看到当前会话里你提过的所有问题，点击任意一条，对话直接滚动定位到那条消息并高亮。
解决长对话的痛点：几十上百轮之后，翻找"我之前问过什么、那条讨论在哪"很痛苦。dsh-indexbookmark 把这个问题变成一次点击。
功能特性
- 📋 问题索引：列出当前会话所有
user/message，按时间顺序带全局序号
- 🎯 点击定位：滚动到对应消息 + 1.6s 高亮闪烁
- 🔍 搜索过滤：大小写不敏感子串匹配，标题实时显示
命中数/总数
- 📄 视图分页：每页 10 / 30 / 50 条可调，
‹ 1/3 › 翻页，全局编号
- ⏳ 懒加载 + 分页：打开面板才拉取，每次最多 200 条消息，更早的按需"加载更早的问题"
- ⚡ 会话级内存缓存：同一会话 60 秒内重复打开秒开（零请求零处理），LRU 上限 5 个会话
- 🪄 顺滑交互：展开/收起淡入淡出动画；点击外部 / 按 Esc 收起；面板内滚轮独占不外泄
- 🌗 主题适配：全部使用 DSH 主题变量（
--dsw-alias-*），亮暗色自动适配
- 🌐 中英文案：zh / en 字典随界面语言切换
安装
方式一：从 GitHub 安装（推荐）
# 前提：全局 dsh 与 pnpm（`dsh plugin` 依赖 pnpm）
dsh plugin --profile web add github:cuhaitiang0405-collab/dsh-indexbookmark
dsh plugin 会：
- 通过 pnpm 拉取仓库（打包产物
lib/client.js 已随仓库发布，无需构建）；
- 检测到包声明了
dsh.bundle，自动加入 dsh.profile.bundles；
- 无需手动改
cordis.patch.yml。
安装完成后重启网页版生效：
# 停掉当前 dsh web，然后
dsh web
方式二：本地开发安装（软链，改码即生效）
cd dsh-indexbookmark # 插件源码目录的父目录
dsh plugin --profile web add ./dsh-indexbookmark
软链方式下，修改 src/client.tsx → node build.mjs → 浏览器硬刷新（Ctrl+Shift+R）即可，无需重新安装。
卸载
dsh plugin --profile web remove dsh-indexbookmark
使用
- 打开任意有历史的会话；
- 点击输入框右侧的 ☰ 按钮；
- 面板向上弹出：搜索框过滤问题，点击条目直接跳到对话对应位置；
- 面板底部可切换每页条数（10/30/50），长会话可"加载更早的问题"；
- 点击面板外部或按
Esc 收起。
目录结构
dsh-indexbookmark/
├── package.json # 插件清单：dsh.bundle + dsh.client 声明
├── cordis.patch.yml # bundle 补丁层（插入插件行）
├── build.mjs # esbuild 构建脚本（JSX → 加载器格式 bundle）
├── lib/
│ ├── index.js # host 端（最小实现，让 Loader 挂载）
│ └── client.js # 浏览器端 bundle（构建产物，随仓库发布）
└── src/
└── client.tsx # 浏览器端源码（唯一需要手写的部分）
开发
# 环境：Node.js 24+，pnpm（dsh plugin 用）
cd dsh-indexbookmark
# 首次：安装构建工具
& "C:\Program Files\nodejs\npm.cmd" install --save-dev esbuild
& "C:\Program Files\nodejs\npm.cmd" approve-scripts esbuild # npm 新版需批准安装脚本
# 构建（产出 lib/client.js）
node build.mjs # 或 npm run build
开发循环：改 src/client.tsx → node build.mjs → 浏览器硬刷新。
Windows 提示：若 npm 命令无效，可能是被系统残留的 0 字节假文件遮蔽，请用完整路径 C:\Program Files\nodejs\npm.cmd。
架构要点
- 双面插件：host 端极简（仅让 Cordis Loader 挂载），浏览器端承载全部功能；
- 加载器格式：
window.__ModuleLoader__.load({id, factory})，模块导出 {name, inject, apply}；
- 挂载槽位：
conversation.input.right（输入框右侧工具位，避免与侧边栏插件挤占）；
- 数据源：
api.sessions.history({sessionId, beforeSeq?, maxMessages?})，过滤 user/message（仅 surfaceOp === 'append'）；
- 缓存：模块级
Map，只存提取后的问题，尾页 TTL 60s + 按 seq 增量合并，LRU 5 会话。
已知限制
- 定位使用文本前缀匹配（前 40 字符），前缀完全相同的问题可能定位到较早一条；目标行未渲染（极长会话）时会自动分段滚动加载后定位，加载不出则提示；
- 索引仅收录追加来源（
surfaceOp: append）的问题——与对话实际渲染一致，保证每条都可跳转；
- 搜索仅覆盖已加载页的问题；
- 缓存为浏览器内存级，刷新页面（F5）后清空。
路线图（未实现）
- 工作区级 md 缓存（持久化，F5 不丢）+ MD5 校验
- 节点 key 精确锚定（替代文本匹配）
- 问题分组 / 按轮次归并
- 会话事件流实时增量订阅
许可
MIT
