dsh-conversation-map

会话代码地图（Conversation Minimap）—— DeepSeek Harness (dsh) Web 客户端插件。

当前版本：0.1.4

在对话区右侧渲染一条可拖动的会话代码地图，像编辑器的 minimap 一样预览整段会话并快速滚动：

双模式：宽度 < 50px 为色块模式（按消息类型着色：🔵 用户 / ⚪ 助手 / 🟡 工具调用 / 🟢 命令 / 🔴 错误，悬停弹出内容预览）；宽度 ≥ 50px 自动切换为缩略图模式（整段会话按比例缩微显示，能看到消息、代码块、卡片的真实结构）。
拖动调宽：按住地图左侧把手左右拖动（10–320px），右缘固定，拖动时显示实时宽度徽标。
快速滚动：点击任意位置跳转，按住拖动连续滚动；半透明视口指示条实时显示当前可见区域。
悬停放大预览：缩略图模式下悬停地图任意位置，光标左侧实时弹出放大预览窗口，整行完整展示，跟随鼠标移动实时刷新。
收起/展开：悬停地图顶部点击 » 收起为 4px 细条，点击细条展开。
实时同步：消息流式输出、工具调用、切换会话时自动刷新；开合侧栏/详情面板、窗口缩放自动跟随。
高度自适应：地图高度随会话内容实时伸缩——内容不足一屏时，缩略图按地图宽度等比缩微显示，保持真实宽高比、不纵向拉伸（居中于轨道）；超出一屏时填满可用高度。

缩略图模式（加宽后，整段会话按比例缩微显示）：

缩略图模式

色块模式（窄条，按消息类型着色，悬停预览）：

色块模式

dsh plugin --profile web add dsh-conversation-map

验证层已挂载，然后启动：

dsh --profile web --dump-config   # 应出现 "# == dsh-conversation-map" 层
dsh --profile web

卸载：dsh plugin --profile web remove dsh-conversation-map

DeepSeek Harness 处于 developer preview，接口会破坏性变更；本插件当前基于 dsh 0.1.x 的 Web 会话 DOM 契约实现：
- [data-conversation-scroll] 会话滚动容器（注意：切换会话时框架会重建会话列，该容器每次都是新节点，插件通过稳定祖先观察 + 每次计算重解析自动跟随）
- [data-chat-anchor-key] / [data-chat-flow-kind] 会话节点行
- [data-composer-seat] 底部输入区
地图常驻：切换会话无需刷新，色块/缩略图内容自动同步当前会话；新会话加载期间显示空轨道。
宽度与收起状态持久化于浏览器 localStorage（键 dsh-conversation-map:width / dsh-conversation-map:collapsed），切换会话与刷新页面均保持。
插件为纯客户端：Host 半身是空实现，浏览器半身通过 shell.overlay 槽位挂载，仅使用平台模块 react 与 slots 服务，无网络请求、无遥测（除上述 localStorage 本地状态外无其他持久化）。

pnpm install
pnpm run build    # tsdown → lib/client.js（__ModuleLoader__ 工厂包壳）

构建产物契约：CJS + window.__ModuleLoader__.load({ id, factory }) 包装；react 等平台模块保持外部引用，其余依赖全部内联（本插件除 react 外无其他依赖）。

缩略图阈值：src/client/index.ts 中的 THUMB_MIN_WIDTH（默认 50）
宽度范围：WIDTH_MIN / WIDTH_MAX（默认 10 / 320）
缩略图刷新节流：THUMB_CLONE_INTERVAL（默认 200ms）
放大镜参数：LOUPE_W / LOUPE_H（默认 854 / 200，整行按面板宽度等比展示）、LOUPE_SCALE（放大上限，默认 1 = 真实比例）

MIT

Installation