dsh-milestone

DeepSeek Harness 的会话里程碑导航条

像 Git 提交图一样，一眼定位每一次提问，一键跳转到任何位置。

English: A Git-style milestone timeline for the DeepSeek Harness web UI — one dot per user message, hover for content and metadata (time, turn, duration, TTFT, tokens), click to jump anywhere. Full-session list, in-session & cross-session search, #msg= deep-link bookmarks, keyboard navigation. Install: dsh plugin --profile demo add dsh-milestone.

为什么需要它？

• 上百轮对话之后，想找回「第 17 轮那个提问」？只能不停往上翻，在代码块和思考过程里大海捞针。
• 右侧挂一条圆点时间线：一个提问一个圆点，悬停看内容，点击瞬间跳转——长对话的「导航地图」。
• 官方 slot 机制挂载，不修改 harness 源码，装完即用。

快速开始

# 从 npm 安装（推荐）
dsh plugin --profile demo add dsh-milestone

# 或从 GitHub 源码安装
dsh plugin --profile demo add "github:SnowCrescenter-tech/dsh-milestone#main"

# 启动 Web UI
npx @deepseek-ai/dsh web    # → http://127.0.0.1:3080

打开一个多轮对话（至少 2 条提问），会话视图右侧就会出现里程碑条。

要求 Node.js >= 24（harness 官方要求）。

功能详解

圆点时间线

每个提问一个圆点，点击平滑跳转；悬停即看内容与元信息。圆点等距排列、不随对话长度变形，颜色由浅入深标出先后，同 Git 提交图。滚轮可在里程碑条上直接滑动选点，视口内最近的提问亮起白环。

全部提问列表

一键打开面板，序号 + 轮次 + 预览一次看全，点击任意一条直接跳转。打开时会自动加载整个会话的历史，不用手动翻页——对藏在最早期的消息来说，比在小圆点上逐个找快得多。

站内搜索

搜索框过滤圆点，匹配的是完整消息内容（不是 80 字摘要），实时显示命中数 N/M。Enter 跳到下一个匹配，Esc 一键清空。

跨会话搜索

一键搜索所有会话的消息内容（harness 原生索引），点击命中结果直接打开对应会话。

收藏书签与深链接

悬停圆点点星收藏，刷新后仍在（按会话持久化），顶部「★」一键只看收藏。跳转时 URL 自动带上 #msg= 锚点，刷新或分享后仍回到同一条消息。

悬停元信息

时间 · 轮次 · 用时 · 结束原因 · TTFT · tok/s · 模型 · 用途 · token 用量，一张卡片看全。数据全部来自 harness 原生会话快照，零额外依赖：

┌──────────────────────────────────────────┐
│ 第 3 / 5 条 · 第 2 轮         ☆ 复制 ✂    │  ← 序号 + 轮次 + 收藏/复制/fork
│ 帮我优化这段代码的性能                     │  ← 消息预览（前 80 字）
│ 5 分钟前 · 用时 1m30s · 首字 1.2s · 12.4 tok/s │  ← 时间 · 耗时 · TTFT · 吞吐
│ v4 · continue · 1280 / 2560 tok           │  ← 模型 · 用途 · token 用量
└──────────────────────────────────────────┘

更多效率功能

• 键盘导航：↑↓ 移动 · Enter 跳转 · Home/End 首尾，全程不用鼠标。
• turn 分组折叠：长轮次折成一条，汇总圆点带可见 ×N 徽标，一眼知道藏着几条。
• 复制与 fork：一键复制提问全文 / 从此处分支。
• 聚焦模式：淡化 / 折叠思考与工具调用，强度可调、自由搭配。
• 折叠工具栏：功能键默认收起，常用键可钉到折叠外；搜索 / 列表等浮层点击外部自动关闭。
• 个性化：强调色 / 圆点大小 / 距侧边距离 / 左右位置即调即存；中文 / English 一键切换。

工作原理

双半边浏览器插件（空 node half + shell.overlay slot 挂载的 client half），零侵入：

shell.overlay (root scope)
  └─ milestone.rail (session scope, 自声明子槽)
       └─ useSession 读取会话快照 → 圆点列表 + 悬停 + 跳转

• 注入点：shell.overlay 全框架浮动层，附加式、点击穿透，不碰现有 UI。
• 数据源：harness 原生会话快照（消息列表、turn 元数据、分页与运行状态），无自建抓取。
• 跳转：以消息锚点做 DOM 定位，scrollIntoView 平滑滚动。
• 分页：顶部「···」按需加载更早历史；全部提问列表打开时自动加载整个会话。
• 持久化：书签与工具栏偏好经 store.persist 按会话写入 localStorage。
• 纯函数分层：过滤、位置计算、圆点状态集中在 rail-logic.ts 纯函数层，单测覆盖。

版本与兼容

• 当前官方支持线：0.1.1-rc.2（peer/dev 依赖 ^0.1.1-rc.2，与 @deepseek-ai/dsh 最新 latest 标签一致）。
• 官方客户端包（dsh-client-runtime 等）在 npm 上走 next 标签发布（latest 标签仍是远古版本）；升级 harness 后若发现插件不匹配，请确认安装的依赖解析到了 0.1.1-rc.2 线。
• harness 当前版本在浏览器端没有可信来源（host.describe().version 是占位值），因此不做精确探测，以插件声明的支持线为准。

已知限制

⚠️ 最需要注意：站内搜索只覆盖当前已加载的消息窗口（初始 50 条），更早的历史需先点顶部「···」加载进来才能被搜到。「全部提问」列表不受此限：打开时会自动加载整个会话，始终一次看全。

更新日志

License

MIT

如果它帮你省下了一次翻找，欢迎给个 Star，或推荐给同样在 DeepSeek Harness 里长聊的开发者。