kelearns/dsh-navigation-bar

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

已收录于 awesome-dsh-plugin 精选目录， 也可以在 dsh 设置页的 Plugin Market（dsh-market）中搜索 navigation-bar 一键安装。

注意：插件名单在实例启动时加载 —— 新装插件后需重启 dsh web 实例再刷新页面。

结构

数据来源（全部官方 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