前言¶
DeepSeek Harness 的生态以「一切皆插件」为核心理念。在处理长对话时，开发者往往难以快速定位到特定的轮次或当前阅读进度。dsh-conversation-minimap 是一个客户端插件，由 bilbillm 维护。它为 DeepSeek Harness 添加了类似 Codex 的对话列表面包导航，通过可视化的标记帮助定位具体轮次。
核心功能¶
该插件通过注册一个布局中立的入口，在对话头部提供导航辅助。主要功能包括：
- 可视化标记：每个引擎拥有的轮次对应一个标记，当前阅读的轮次会被高亮强调。
- 交互预览：鼠标悬停或键盘聚焦时，会弹出一个紧凑的预览卡片；点击、回车或空格键可滚动到该轮次。
- 信息展示：预览卡片显示用户请求摘要、助手最新结果摘要、运行状态（running, completed, failed, stopped）以及
ui-deliverables生成的文件路径。 - 布局适配：宽列显示左侧轨道，每个轮次有一个可视标记和可访问按钮；短历史在轨道中心保持紧凑；长历史随可用高度逐渐展开；窄列使用紧凑头部工具。
- 无侵入性：不替换对话主体，不改变宽度，不依赖 CSS-module 哈希，不抓取渲染后的文本。
安装与启用¶
需要构建源码并添加到独立的 Harness Web 配置文件中：
pnpm install
pnpm run build
cd C:\Users\lumoren\Documents\GitHub\deepseek-harness
pnpm dsh plugin --profile web add C:\Users\lumoren\Documents\GitHub\dsh-conversation-minimap
pnpm dsh web
使用示例¶
- 宽对话列：左侧会出现轨道，每个轮次有一个可视标记和可访问按钮。
- 短历史：标记在轨道中心保持紧凑的固定间距。
- 长历史：标记随可用高度逐渐展开。
- 预览交互：聚焦或悬停显示基于主题令牌的玻璃态预览卡片，包含请求和结果文本及状态。
- 禁用：若需在特定子树中禁用，可在 HTML 标签上添加
data-dsh-conversation-minimap="off"。
兼容性与注意¶
- 版本要求：目标为 Harness 语义化对话合约
0.1.0-rc.5和0.1.0-rc.6。 - 主题支持：支持 light、dark、angelina-light 和 angelina-dark 主题，颜色取自
--dsw-alias-*令牌。 - 运动偏好：独立于
dsh-motion，可通过data-dsh-motion="off"退出动画；实时监听prefers-reduced-motion。 - 性能：不使用轮询、定时器或永久动画帧，仅使用作用域在活动对话滚动区域的
MutationObserver。 - 许可证：MIT 许可证。
结语¶
该插件通过 Codex 风格的导航增强了 DeepSeek Harness 的长对话可读性，适合需要在复杂对话流中快速定位的开发者。
