Braidy-Wu/dsh-conversation-minimap

dsh-conversation-minimap

DeepSeek Harness (DSH) Web GUI 插件：Prompt 导航迷你地图（Prompt-based Conversation Minimap）。

长对话左侧显示一条纵向导航缩略条——复刻 ChatGPT 桌面端的对话迷你地图：

- 锚点 = 你发出的每一轮 Prompt（横向小胶囊，等距排列，居中显示）
- 鱼眼钟形：鼠标悬停处按高斯曲线向右侧放大（峰值 44px），在放大区域内移动不缩小，滑动顺滑
- 渐隐：rail 顶部/底部有渐变遮罩，超出范围的锚点自动淡出，永远不会超出范围
- 位置感知：滚动对话时蓝色高亮跟随当前 Prompt（Prompt 中线越过页面中线时切换）；
窗口压缩后仍自动贴底/跟随，可见锚点始终对应当前所在位置
- 交互：悬停显示完整 Prompt 预览；点击平滑滚动跳转到对应消息并高亮 2 秒（连续点击不留残影）
- 全历史：自动通过官方 loadOlder API 拉取完整历史，长对话的所有 Prompt 都能跳转；
目标行不在 DOM 时点击按需补拉历史再跳转（block: center 居中定位）
- 体验细节：视口 ≤767px 自动隐藏（移动端不遮挡）；遵循系统「减弱动态效果」
（prefers-reduced-motion 时禁用鱼眼/平滑滚动）；ARIA 无障碍（role=button、
aria-label、键盘 Enter/空格跳转）

screenshot

安装

方式一：npm（推荐）

dsh plugin --profile web add dsh-conversation-minimap

方式二：从 GitHub 安装

dsh plugin --profile web add github:Braidy-Wu/dsh-conversation-minimap

重启 dsh web 生效。

配置（cordis.patch.yml，全部可选，修改后重启 dsh web 生效）

- insert:
- id: conversation-minimap
name: dsh-conversation-minimap
config:
enabled: true    # 总开关（false = 完全不加载）
minPrompts: 4    # 会话内用户 Prompt 数 ≥ 此值才显示 rail（0 = 总是显示，默认 4，范围 0-100）
anchorSize: 3    # 锚点横条高度 px（默认 3，范围 2-8）

工作原理

- 数据源：官方 ctx.sessions.scope(id) + conversation.loadOlder() 拉取完整历史；
观察渲染后的对话 DOM——用户消息行带 data-chat-flow-kind="user"（含 steering），
跳转锚点用行上的 data-chat-anchor-key（与官方「滚动到消息」同一机制）
- 挂载：绝对定位 seat 挂在对话视口外层，不随内容滚动、不占布局；边缘裁剪 + mask 渐隐
- 更新：MutationObserver 监听消息列表（防抖 + key 集合 diff，流式输出不抖动）；
轮询处理会话切换；历史同步期间不渲染，拉完一次性显示完整 rail
- 安全：全程 try/catch，任何异常只禁用迷你地图本身，不影响 GUI

纯 vanilla JS 客户端插件（inject: ['sessions']，镜像 dsh-theme-plugin 结构），无构建步骤、无依赖。

开发

node --check client.js index.js   # 语法检查
冒烟测试：test/smoke.html + python3 -m http.server

License

MIT