dsh-msg-index

dsh-msg-index

长对话的时候经常忘了自己下了什么命令，dsh对话太长翻起来很麻烦，因此搓了这个项目。在代码能跑的基础上添加了没什么用的模糊。

注意⚠️：代码几乎完全由deepseek完成，目前这个版本在本人harness中暂时良好运行，但是不保证不会出现任何bug，本人非计算机专业，此项目发出来主要是存档自用，同时希望能方便到和我有同样需求的用户，欢迎各位大佬修改完善、批评指正

DeepSeek Harness 的对话窗口消息索引插件：一个悬浮在对话窗口的类磨砂玻璃圆球，点击展开当前会话的用户消息索引，点击任意条目即可平滑定位到对应消息。

功能

• 消息索引：展开后列出当前会话的用户消息（编号 + 内容预览），不主动加载全部历史。
• 点击定位：点击索引条目平滑滚动到对应消息。
• 搜索：标题栏 🔍 按钮弹出搜索框，支持按消息编号（数字）或消息内容（不区分大小写）搜索，实时预览匹配结果并高亮命中片段，保留原始编号。

关于"更早的消息"

DSH 的对话页面只渲染视口附近的少量消息（虚拟窗口），更早的消息虽然在数据里、但不在页面上。本插件不会在打开面板时一次性加载全部历史（避免所有对话被一次性渲染导致卡顿），而是：

• 只展示当前已加载的部分，并在头部显示"更早未加载"标记；
• 未加载的：点击列表顶部的"加载更早消息"按钮逐页加载；
• 已加载但未渲染到页面（虚线框分组）：点击会自动加载并定位（先加载数据，再滚动触发渲染，稍慢几秒）；这是 Harness 的渲染窗口限制，插件只能尽量绕开。

安装

# 始终安装最新版（推荐）：
dsh plugin --profile web add -w https://github.com/stnt04/dsh-msg-index/releases/latest/download/dsh-msg-index.tgz

# 或指定版本安装：
dsh plugin --profile web add -w https://github.com/stnt04/dsh-msg-index/releases/download/v1.0.0/dsh-msg-index.tgz

安装后重启 dsh web，在对话窗口右下角即可看到悬浮圆球。

升级插件：重新执行上面的命令（latest 链接会自动拿到最新版），然后刷新浏览器页面即可生效。若重新执行后版本未更新（pnpm 可能缓存了同一 URL），改用指定版本的链接，或执行 dsh plugin --profile web update dsh-msg-index。若涉及服务端或配置变更需重启 dsh web。

发布

打一个 v* 标签推送到 GitHub 即可触发 Actions 自动构建并发布 Release（附件为固定文件名 dsh-msg-index.tgz，latest 链接自动指向最新版）：

git tag v1.0.0
git push origin v1.0.0

构建

pnpm install   # 需要 pnpm 11+（lockfile 由 pnpm 11 生成）
pnpm build     # tsc 编译服务端(lib/) + tsdown 打包 client(client/client.js)
npm pack       # 生成发布用 dsh-msg-index-<version>.tgz（可选，本地验证用）

产物：client/client.js（__ModuleLoader__ 格式）、lib/index.js。

工作原理

• 通过 shell.overlay 插槽注入宿主组件，再用 SessionProvider 桥接一个 session 作用域子插槽（dsh-msg-index.rail），组件直接拿到当前 sessionId 与 useSession 订阅器。
• 会话数据来自 sessions 服务：session.getSnapshot() 读取 chat.order / chat.nodes，session.loadOlder() 拉取更早历史，直到 hasMore 为 false。
• 用户消息 = 节点 kind === "user" 的条目，文本从 data.content 提取。
• 页面定位用运行时自带的 data-chat-anchor-key 属性（值即节点 key）精确匹配行元素，未渲染的行按其在消息顺序中的比例粗滚滚动容器后再轮询定位。

已知问题

⚠️ 点击"加载更早"多次或定位很远的早期消息时，加载较多消息可能导致网页渲染变慢，但事实上输入输出速度并未受到影响

注意事项

• 页面行定位依赖 DSH 运行时提供的 data-chat-anchor-key 属性与主滚动容器的 _scrollBody 类后缀；若 DSH 版本更新导致这些选择器失效，需同步调整。
• 纯自用/留档项目：代码以满足"能跑"为标准。

License

MIT