dsh-milestone 0.6.5 → 0.7.0

package/README.md

@@ -1,235 +1,182 @@
-<div align="center">
-
-<img src="https://raw.githubusercontent.com/SnowCrescenter-tech/dsh-milestone/main/assets/logo.svg" alt="dsh-milestone" width="112">
-
-# dsh-milestone
-
-**DeepSeek Harness 的会话里程碑导航条**
-
-像 Git 提交图一样，一眼定位每一次提问，一键跳转到任何位置。
-
-<p>
-  <a href="https://www.npmjs.com/package/dsh-milestone"><img src="https://img.shields.io/npm/v/dsh-milestone?color=2563eb" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/dsh-milestone"><img src="https://img.shields.io/npm/dm/dsh-milestone" alt="npm downloads"></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/dsh-milestone" alt="license"></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-2563eb" alt="dsh-plugin"></a>
-</p>
-
-</div>
-
----
-
-## 为什么需要它？
-
-- 上百轮对话之后，想找回「第 17 轮那个提问」？只能不停往上翻，在代码块和思考过程里大海捞针。
-- 右侧挂一条**圆点时间线**：一个提问一个圆点，悬停看内容，点击瞬间跳转——长对话的「导航地图」。
-- 官方 slot 机制挂载，不修改 harness 源码，装完即用。
-
-<img src="https://raw.githubusercontent.com/SnowCrescenter-tech/dsh-milestone/main/assets/demo.svg" alt="dsh-milestone 效果示意图" width="100%">
-
-## 快速开始
-
-```sh
-# 从 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 官方要求）。
-
-## 功能总览
-
-按类别分组，一屏扫完所有能力。
-
-| 类别 | 功能 · 一句话 | 键位 |
-| --- | --- | --- |
-| 定位导航 | 圆点时间线：每问一个圆点，点击平滑跳转 | |
-| 定位导航 | 当前位置高亮：视口最近的提问亮起白环 | |
-| 定位导航 | 加载更早：「···」继续加载历史，提示已显示条数 | |
-| 定位导航 | 全部提问列表：序号 + 轮次 + 预览一次看全，点击直达 | |
-| 定位导航 | 深链接：`#msg=` 锚点，刷新/分享后直达同一条 | |
-| 搜索过滤 | 站内搜索：匹配完整消息内容，实时 N/M 命中 | Enter 下一个 / Esc 清空 |
-| 搜索过滤 | 跨会话搜索：搜所有会话，点击打开对应会话 | |
-| 搜索过滤 | 收藏书签：悬停点星，★ 只看收藏 | |
-| 状态感知 | 轮次健康徽章：出错红 / 上限黄 / 重试橙 / 运行蓝 / 等待脉冲 | |
-| 状态感知 | 悬停元信息：时间 · 轮次 · 用时 · 结束原因 · TTFT · tok/s · 模型 · token 用量 | |
-| 个性化与效率 | 键盘导航：全程不用鼠标 | ↑↓ 移动 · Enter 跳转 · Home/End 首尾 |
-| 个性化与效率 | turn 分组折叠：按轮次成组，长轮次折成一条 | |
-| 个性化与效率 | 复制与 fork：一键复制提问全文 / 从此处分支 | |
-| 个性化与效率 | 聚焦模式：淡化 / 折叠思考与工具调用，强度可调、自由搭配 | |
-| 个性化与效率 | 折叠工具栏：功能键默认收起，箭头展开；设置菜单可把常用键钉到折叠外（持久化 + 恢复默认） | |
-| 个性化与效率 | 个性化外观：强调色 / 图标圆点大小 / 距侧边距离 / 位置左右（设置内即调即存） | |
-| 个性化与效率 | 语言切换：跟随系统 / 中文 / English，设置内一键切换 | |
-| 个性化与效率 | 点击外部关闭：搜索 / 列表等浮层自动收起 | |
-| 个性化与效率 | 新手教程：首次使用教练气泡引导，锚定真实组件（点击真实推进），设置内可重看 | |
-| 发布运维 | 更新检测：6h 缓存自动检查，新版徽章，一键去 npm | |
-| 发布运维 | 设置推广区：GitHub / Star / Issue / npm 四入口 | |
-
-另：滚轮可在里程碑条上直接滑动选点；圆点的固定间距与蓝色渐变见下方「圆点时间线」一节。
-
-## 核心功能详解
-
-### 圆点时间线与悬停元信息
-
-- 每个提问一个圆点，点击平滑跳转；悬停即看内容与元信息。
-- 圆点等距排列、不随对话长度变形；颜色由浅入深标出先后，同 Git 提交图。
-
-```
-┌──────────────────────────────────────────┐
-│ 第 3 / 5 条 · 第 2 轮         ☆ 复制 ✂    │  ← 序号 + 轮次 + 收藏/复制/fork
-│ 帮我优化这段代码的性能                     │  ← 消息预览（前 80 字）
-│ 5 分钟前 · 用时 1m30s · 首字 1.2s · 12.4 tok/s │  ← 时间 · 耗时 · TTFT · 吞吐
-│ v4 · continue · 1280 / 2560 tok           │  ← 模型 · 用途 · token 用量
-└──────────────────────────────────────────┘
-```
-
-元信息全部来自 harness 原生 session 快照（`turnTimings` / `timeline.turns` / `turn-tail`），无额外依赖。
-
-### 站内搜索
-
-- 搜索框过滤圆点，匹配的是**完整消息内容**（不是 80 字摘要），实时显示命中数 N/M。
-- `Enter` 跳到下一个匹配，`Esc` 一键清空。
-- 范围 = 当前已加载窗口；更早的历史先点「···」加载进来。
-
-### 收藏书签
-
-- 悬停圆点点星收藏，刷新后仍在（`store.persist`，按会话隔离）。
-- 顶部「★」一键只看收藏，把一次性跳转变反复回访。
-
-### 深链接 `#msg=`
-
-- 跳转时 URL 带上 `#msg=`，刷新或分享链接后仍回到同一条消息。
-- 目标在已加载窗口外时，自动先加载更早历史再定位（受加载上限约束）。
-
-### 跨会话搜索
-
-- 一键搜索**所有会话**的消息内容（harness 原生索引）。
-- 点击结果直接打开对应会话；最多 20 条结果，片段 ≤240 字符。
-
-### 更新检测
-
-- 自动检查 npm 新版本，6 小时缓存，不打扰。
-- 发现新版：功能键亮起提醒徽章；弹窗展示当前/最新版本与**已适配版本线**；一键去 npm 升级。
-
-## 工作原理
-
-双半边浏览器插件（空 node half + `shell.overlay` slot 挂载的 client half），零侵入：
-
-```
-shell.overlay (root scope)
-  └─ milestone.rail (session scope, 自声明子槽)
-       └─ useSession 读取会话快照 → 圆点列表 + 悬停 + 跳转
-```
-
-- **注入点**：`shell.overlay` 全框架浮动层，附加式、点击穿透，不碰现有 UI。
-- **数据源**：`chat.order` + `chat.nodes`（user 消息与 `turn-error`/`turn-max-tokens`/`model-retry` 节点）+ `chat.timeline`（turn 元数据）+ `hasMore`/`loadingOlder`（分页）+ `running`/`pending`（徽章）+ `loadOlder`（inject face）。
-- **跳转**：DOM 锚点 `data-chat-anchor-key`，`scrollIntoView` 平滑定位。
-- **持久化**：`store.persist`（每会话 localStorage，key `dsh-milestone.bookmarks.<sessionId>`），经 `defineStore` 引擎读写；工具栏偏好同理。
-- **纯函数分层**：搜索过滤 / 位置计算 / 圆点状态都在 `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 条）——更早的历史需先点顶部「···」加载进来，才能被搜到。
-
-<details>
-<summary>查看更多已知限制（点击展开）</summary>
-
-- TTFT / tokens/秒 依赖 turn 位置数据，窗口外或未完成的 turn 不显示（自动隐藏）。
-- 徽章的瞬态状态（运行中/等待输入）只点亮**最新一条可见提问**——若该轮次的提问在窗口外，则无脉冲。
-- 书签按**会话**隔离（不跨会话共享）。
-- 模型 / token 用量依赖该轮 assistant 节点的元数据，部分场景下缺失则自动隐藏该行。
-- fork 从选中消息所在轮次开始分支，不会自动打开子会话（需在会话列表手动打开）。
-- 深链接的目标消息若早于已加载窗口，会先自动加载更早历史再定位（受加载上限约束，极端深的历史可能定位失败）。
-- 跨会话搜索依赖 harness 的消息内容索引（`session.search`），仅返回片段（≤240 字符）、最多 20 条结果；命中过多时请细化关键词。
-- 聚焦模式作用于当前会话视图的思考区块，不影响其他插件或工具的展示。
-- 尚无全局快捷键聚焦里程碑条（需 Tab 键切换到）。
-- 功能键**默认折叠**，首次使用需点箭头展开；可在设置菜单里把常用键钉到折叠外。
-- 更新检测依赖浏览器能访问 npm 镜像（`registry.npmmirror.com` / `registry.npmjs.org`）；若页面 CSP 限制 `connect-src` 或离线，检查会静默失败。结果缓存 6 小时。
-- 工具栏固定偏好存于浏览器 localStorage（不跨浏览器/设备同步）。
-
-</details>
-
-## 更新日志
-
-<details>
-<summary>v0.6.5 / v0.6.4 / v0.6.3 / v0.6.2 / v0.6.1 / v0.6.0（点击展开）</summary>
-
-**v0.6.5** · 真实组件教练教程 + 设置对比度修复 · 386 项测试
-
-- **新手教程改为教练气泡（coach-mark）**：气泡锚定真实组件——欢迎 → 点展开箭头（真实点击自动推进）→ 点设置齿轮（真实打开自动推进，设置开着气泡挂起）→ 圆点 → 完成；目标高亮环 + 就近气泡 + 进度点 + 随时跳过，全部双语。
-- **设置模态白色背景修复**：UA 默认按钮底色漏出导致浅底浅字不可读，基础态补透明规则（Playwright 计算色实测验证）。
-
-> [GitHub Release v0.6.5](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.5)
-
-**v0.6.4** · 新手教程 · 385 项测试
-
-- **首次使用引导**：第一次安装后进入首个可用会话时弹出教程（全局持久化，**印象即写**——欢迎页一显示即记录，关页/刷新不重弹；想再看走设置里的「重新查看教程」）。
-- 4 步教学 + 内置演示：迷你圆点条 hover/点击、玩具搜索与收藏、个性化与设置图例、更新检测与支持；进度点 + 上一步/下一步 + 随时跳过，全部双语。
-- 设置与教程模态视觉共用 `modal-tokens.ts` 单一来源。
-
-> [GitHub Release v0.6.4](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.4)
-
-**v0.6.3** · 聚焦高级设置 + 设置模态重设计 · 363 项测试
-
-- **聚焦高级设置**：设置内「聚焦」可展开——自定义淡化/折叠 think 推理区与工具调用卡片，淡化强度 20%–80% 可调（稳定选择器 `[data-variant="think"]` / `[data-chat-call-id]`），搭配持久化。
-- **设置模态重设计**：功能悬停描述改为**就近 tip**（行旁悬浮，不再有大块常驻描述区）；恢复表头说明（「开启后，折叠时仍显示在箭头旁」）；个性化收进**可展开块**（默认折叠，头部实时摘要）；间距/圆角/强调色统一，修复行 hover 洗色失效。
-- README 图片改绝对 URL（npm 渲染器不重写相对路径），npm 页 logo/演示图恢复正常。
-
-> [GitHub Release v0.6.3](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.3)
-
-**v0.6.2** · 设置模态化 + 个性化 + 语言切换 · 346 项测试
-
-- 设置改为**居中模态框**：功能行悬停显示说明、按类别分区。
-- **个性化模块**：强调色（预设 + 自定义）、图标 / 圆点大小、距侧边距离、位置左或右（浮层自动换侧），全部即调即存。
-- **语言切换**：跟随系统 / 中文 / English（zh/en 词典完整，缺译即编译错）。
-- 设置按钮进入展开队列（折叠态更干净）；底部推广区改 2×2 卡片网格。
-- 圆点 turn 分隔线移除（改组间距表达）；状态徽章改为柔边光晕。
-- npm 包纳入 `assets/*.svg`（npm 页 README 图片恢复显示）。
-
-> [GitHub Release v0.6.2](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.2)
-
-**v0.6.1** · 对齐 `0.1.1-rc.2` 支持线 · 五项新功能 · 292 项测试
-
-- 折叠工具栏：功能键默认收起，箭头展开。
-- 设置菜单：常用功能「在折叠外显示」固定自定义；偏好持久化，一键恢复默认。
-- 设置底部推广区：GitHub / Star / Issue / npm 四入口。
-- 更新检测：6h 缓存自动检查、新版徽章、当前/最新版本与已适配版本线、一键去 npm。
-- 点击外部自动关闭各浮层（与官方 capture 阶段 pointerdown 契约一致）。
-
-> [GitHub Release v0.6.1](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.1)
-
-**v0.6.0** · P3 功能
-
-- 聚焦模式：淡化思考(thinking)区块，悬停或展开自动恢复。
-- 全部提问列表面板：序号 + 轮次 + 预览一次看全，点击即跳。
-- 深链接：`#msg=` 锚点，刷新或分享后直达同一条消息。
-- 跨会话搜索：搜索所有会话的消息内容，点击结果打开对应会话。
-
-> [GitHub Release v0.6.0](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.0)
-
-</details>
-
-维护者：发布清单见 [RELEASING.md](./RELEASING.md)。
-
-## License
-
-[MIT](./LICENSE)
-
----
-
-<p align="center">
-  觉得好用？给个 star 支持一下，或把它推荐给正在 DeepSeek Harness 里挣扎的开发者吧。
-</p>
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/SnowCrescenter-tech/dsh-milestone/main/assets/logo.svg" alt="dsh-milestone" width="112">
+
+# dsh-milestone
+
+**DeepSeek Harness 的会话里程碑导航条**
+
+像 Git 提交图一样，一眼定位每一次提问，一键跳转到任何位置。
+
+<p>
+  <a href="https://www.npmjs.com/package/dsh-milestone"><img src="https://img.shields.io/npm/v/dsh-milestone?color=2563eb" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-milestone"><img src="https://img.shields.io/npm/dm/dsh-milestone" alt="npm downloads"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/dsh-milestone" alt="license"></a>
+  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-2563eb" alt="dsh-plugin"></a>
+</p>
+
+</div>
+
+> **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, and collapse the whole rail into a draggable floating ball. 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 源码，装完即用。
+
+<img src="https://raw.githubusercontent.com/SnowCrescenter-tech/dsh-milestone/main/assets/demo.svg" alt="dsh-milestone 效果示意图" width="100%">
+
+## 快速开始
+
+```sh
+# 从 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 提交图。滚轮可在里程碑条上直接滑动选点，视口内最近的提问亮起白环。
+
+### 折叠为悬浮球
+
+一键把整条时间线收成一颗半透明悬浮球：**点击**展开，**拖动**可把它放到屏幕任意角落（拖动时不触发展开），松手即记住位置，刷新或下次会话仍在。设置里可选「**固定** / **可拖动**」，也可一键重置位置——右侧被其它面板（如 dsh-better-sidebar、explorer）占用时，把它拖到顺手的地方即可。
+
+### 全部提问列表
+
+一键打开面板，序号 + 轮次 + 预览一次看全，点击任意一条直接跳转。列表直接来自**整个会话的投影**，不用手动翻页——对藏在最早期的消息来说，比在小圆点上逐个找快得多。
+
+### 站内搜索
+
+搜索框过滤圆点，匹配的是**完整消息内容**（不是 80 字摘要）且覆盖**整个会话**（不受对话当前加载窗口限制），实时显示命中数 N/M。`Enter` 跳到下一个匹配，`Esc` 一键清空。
+
+### 跨会话搜索
+
+一键搜索**所有会话**的消息内容（harness 原生索引），点击命中结果直接打开对应会话。
+
+### 收藏书签与深链接
+
+悬停圆点点星收藏，刷新后仍在（按会话持久化），顶部「★」一键只看收藏。跳转时 URL 自动带上 `#msg=` 锚点，刷新或分享后仍回到同一条消息。
+
+### 悬停元信息
+
+时间 · 轮次 · 用时 · 结束原因 · TTFT · tok/s · 模型 · 用途 · token 用量，一张卡片看全。数据来自插件自注册的**会话投影**，零额外依赖：
+
+```
+┌──────────────────────────────────────────┐
+│ 第 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, 自声明子槽)
+       └─ useProjection('milestone.messages') → 圆点列表 + 悬停 + 跳转
+```
+
+- **注入点**：`shell.overlay` 全框架浮动层，附加式、点击穿透，不碰现有 UI。
+- **数据源**：插件自注册的 `milestone.messages` **会话投影**——host 端对完整事件日志做 fold（`turn/start` / `user/message` / `assistant/chunk` / `assistant/message` / `turn/end`），client 端经 `useProjection` 读取整会话的消息与每轮元数据；圆点列表与站内搜索覆盖**整个会话**，与 DOM 当前加载窗口无关。
+- **跳转**：以消息锚点做 DOM 定位，`scrollIntoView` 平滑滚动。
+- **分页**：顶部「···」按需把更早的对话载入 DOM（跳转 / 深链接定位所需）；提问列表本身来自投影，无需逐页加载。
+- **持久化**：书签、工具栏偏好与悬浮球位置经 `store.persist` 写入 localStorage。
+- **纯函数分层**：过滤、位置计算、圆点状态、悬浮球几何集中在纯函数层（`rail-logic.ts` / `ball-position.ts`），单测覆盖。
+
+## 版本与兼容
+
+- 当前官方支持线：**`0.1.5-rc.1`**（与 `@deepseek-ai/dsh` 最新 `latest` / `next` 标签一致）。
+- peer/dev 范围为收紧的 `>=0.1.5-rc.1 <0.3.0-0`（`dsh-client-locale` / `dsh-client-store` / `dsh-client-ui-slots`）：依赖解析到旧线时会得到明确的 ERESOLVE，而不是静默错配。
+- 0.1.5 起流式时序内嵌在 `assistant/message` / `assistant/attempt` 的紧凑 `stream` 中（独立的 `assistant/chunk` 事件已移除），TTFT 由官方 `assistantStreamFirstTokenTime` 读取；`TokenUsage` 字段更名为 `inputTokens`/`outputTokens`/`totalTokens` 并拆分缓存计数，插件的 `input` 显示为三项之和（缓存计入），保持旧的「提示词 token」含义。
+- 会话数据自 0.1.2 起改经**会话投影**提供（插件注册 `milestone.messages`，client 端 `useProjection` 读取）；`defineStore` 由 `@deepseek-ai/dsh-client-store` 提供。
+- 已知上游打包缺陷：`@deepseek-ai/dsh-client-store@0.1.5-rc.1` 的 `lib/index.js` 运行时引用 `zustand`/`immer`，清单却把它们放在 `devDependencies` 未声明为依赖——导入该模块即报 `Cannot find package 'zustand'`。本仓库用 pnpm `packageExtensions` 兜底补全（见 `pnpm-workspace.yaml`）。
+- harness 当前版本在浏览器端没有可信来源（`host.describe().version` 是占位值），因此不做精确探测，以插件声明的支持线为准。
+
+## 已知限制
+
+> ⚠️ 圆点列表与站内搜索现由**会话投影**驱动，覆盖**整个会话**，与 DOM 加载窗口无关；但**跳转**到很早的消息仍需先把该消息载入 DOM，插件会自动触发加载再定位。
+
+<details>
+<summary>查看更多已知限制（点击展开）</summary>
+
+- TTFT / tok/s 依赖 turn 位置数据，未完成的 turn 不显示（自动隐藏）。
+- 徽章的瞬态状态（运行中 / 等待输入）只点亮最新一条提问。
+- 书签按会话隔离，不跨会话共享。
+- fork 从选中消息所在轮次开始分支，不会自动打开子会话（需在会话列表手动打开）。
+- 深链接目标若早于已加载窗口，会先自动加载更早历史再定位；受加载上限约束，极端深的历史可能定位失败。
+- 跨会话搜索仅返回片段（≤240 字符）、最多 20 条结果，命中过多时请细化关键词。
+
+</details>
+
+## 更新日志
+
+<details>
+<summary>v0.7.0 / v0.6.6 / v0.6.5 / v0.6.4（点击展开）</summary>
+
+**v0.7.0** · 跟随官方 0.1.5（会话投影数据层）· 折叠为可拖动悬浮球（issue #4）· 447 项测试
+
+- **跟随官方 0.1.5**：会话数据由插件自注册的 `milestone.messages` 投影提供——host 端对完整事件日志 fold，client 端 `useProjection` 读取；圆点列表与站内搜索覆盖**整个会话**，与 DOM 加载窗口解耦。TTFT 改从结算事件内嵌的紧凑 `stream` 读取（独立的 `assistant/chunk` 已移除），`TokenUsage` 字段更名并计入缓存；peer 收紧到 `0.1.5-rc.1` 线，移除 `dsh-client-runtime` 依赖（含 `dsh.client.inject`）。
+- **折叠为悬浮球（issue #4）**：里程碑条可一键收成半透明悬浮球，自由拖到屏幕任意位置；点击展开、拖动移动（拖动与点击互斥），位置按 localStorage 记忆；设置里可选「固定 / 可拖动」并一键重置位置。
+
+> [GitHub Release v0.7.0](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.7.0)
+
+**v0.6.6** · 全部提问列表自动加载整个会话 · 折叠圆点 ×N 徽标 · 轮次连续显示 · 397 项测试
+
+- **全部提问列表一次看全**：打开时自动加载整个会话的历史，不再受初始加载窗口限制，点击任意一条直达。
+- **折叠轮次不藏消息**：汇总圆点带可见 ×N 计数徽标，悬停气泡显示覆盖的条数区间（第 a–b / m 条）。
+- **轮次编号连续化**：显示轮号按圆点顺序重编号（1、2、3…），不再跳空或重复；分组与折叠逻辑不变。
+- **列表点击外部自动关闭**：与搜索、跨会话搜索浮层同一套外部点击关闭契约。
+- README 重写为产品宣传结构：演示图第一屏，功能介绍分组清晰。
+
+> [GitHub Release v0.6.6](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.6)
+
+**v0.6.5** · 新手教程改为锚定真实组件的教练气泡引导，设置模态对比度修复 · 近 400 项测试
+
+> [GitHub Release v0.6.5](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.5)
+
+**v0.6.4** · 首次使用引导：4 步双语教学 + 内置演示，印象即写、关页不重弹
+
+> [GitHub Release v0.6.4](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.4)
+
+更早版本见 [GitHub Releases](https://github.com/SnowCrescenter-tech/dsh-milestone/releases)。
+
+</details>
+
+## License
+
+[MIT](./LICENSE)
+
+---
+
+<p align="center">
+  如果它帮你省下了一次翻找，欢迎给个 Star，或推荐给同样在 DeepSeek Harness 里长聊的开发者。
+</p>