dsh-navigation-bar
钢琴键风格的会话内导航条 —— 为 DeepSeek Harness Web GUI 的单个会话提供多轮对话导航：
每根键锚定一条用户消息，悬停显示该轮「用户消息 + 模型回复」预览，点击平滑跳转到对应消息。
基于 DSH 官方双面插件机制（host + browser half），不侵入 DSH 源码。
English
截图
深色主题 · 悬停态（全屏 + 聚焦细节）：
深色悬停全屏
浅色主题（悬停 / 非悬停全屏）：
浅色悬停全屏
全屏图展示导航条在会话界面中的实际位置；聚焦图展示钢琴键细节（键形、悬停阶梯与消息预览气泡）。
功能
- 会话内导航：一根键 = 一条用户消息（含 agent 运行中发送的 steering 消息），按时间正序；
模型回复不单独占键，并入对应轮次的预览。
- 参考图级视觉：键簇固定 10px 键距、2px 键高、6px 最短长、26px 悬停长（≈4.3×），
在消息区内垂直居中；配色由参考图逐像素测量（浅色
#D2D3D3 / #767779 / #1A1C1F，
深色 #454545 / #A3A3A3 / #FFFFFF）。
- 悬停阶梯：悬停键变长变色，上下相邻 3 级阶梯（20 / 14 / 10px，≈77% / 54% / 38%），
第 4 邻恢复最短，首/尾键悬停时阶梯自然单侧裁剪。
- 悬停气泡：用户消息单行省略 + 对应模型回复最多 3 行（宽度模型 JS 截断 +
-webkit-line-clamp 双保险，超出以 … 省略）。
- 当前位高亮：非悬停时当前查看内容对应的键仅变色（长度不变），随滚动实时联动。
- 点击跳转；深浅色主题自适应（
data-ds-dark-theme + prefers-color-scheme 兜底）。
安装
基于 DSH 官方插件机制安装到 web profile：
# 从 npm 安装（正式发布）
dsh plugin --profile web add @kelearns/dsh-navigation-bar
# 或本地开发（link 方式；改 lib/client.js 后刷新页面即生效）
dsh plugin --profile web add link:<本目录>
npm 包已发布：npmjs.com/package/@kelearns/dsh-navigation-bar
注意：插件名单在实例启动时加载 —— 新装插件后需重启 dsh web 实例再刷新页面。
结构
| 文件 | 说明 |
|---|
index.js | host 半端（空操作 cordis 插件） |
lib/client.js | browser 半端（手写 bundle，无构建步骤；window.__ModuleLoader__.load） |
cordis.patch.yml | bundle patch：把插件行插入 web profile 名单 |
package.json | dsh.bundle.patch + dsh.client（platform web）声明 |
test/ | CDP 无头浏览器诊断脚本 + 独立离线测试页 |
数据来源（全部官方 API）：
ctx.sessions.binding(currentId).session → ConversationSnapshot
（useSyncExternalStore 实时订阅）- DOM 锚点：滚动容器
[data-conversation-scroll]，消息行 [data-chat-anchor-key]
开发 / 测试
# 无头 Edge + CDP 审计：打开真实会话，检查键布局 / 颜色 / tooltip
node test/cdp-audit.mjs
# 参考图像素测量（生成视觉规格：键距 / 阶梯 / 配色）
node test/img-analysis.cjs # 非悬停参考图
node test/img-strip.cjs # 悬停参考图（阶梯长度与颜色）
License
MIT
