dsh-milestone 0.6.4 → 0.6.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +56 -119
- package/lib/client.js +499 -967
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -44,79 +44,49 @@ npx @deepseek-ai/dsh web # → http://127.0.0.1:3080
|
|
|
44
44
|
|
|
45
45
|
> 要求 Node.js `>= 24`（harness 官方要求）。
|
|
46
46
|
|
|
47
|
-
##
|
|
48
|
-
|
|
49
|
-
按类别分组，一屏扫完所有能力。
|
|
50
|
-
|
|
51
|
-
| 类别 | 功能 · 一句话 | 键位 |
|
|
52
|
-
| --- | --- | --- |
|
|
53
|
-
| 定位导航 | 圆点时间线：每问一个圆点，点击平滑跳转 | |
|
|
54
|
-
| 定位导航 | 当前位置高亮：视口最近的提问亮起白环 | |
|
|
55
|
-
| 定位导航 | 加载更早：「···」继续加载历史，提示已显示条数 | |
|
|
56
|
-
| 定位导航 | 全部提问列表：序号 + 轮次 + 预览一次看全，点击直达 | |
|
|
57
|
-
| 定位导航 | 深链接：`#msg=` 锚点，刷新/分享后直达同一条 | |
|
|
58
|
-
| 搜索过滤 | 站内搜索：匹配完整消息内容，实时 N/M 命中 | Enter 下一个 / Esc 清空 |
|
|
59
|
-
| 搜索过滤 | 跨会话搜索：搜所有会话，点击打开对应会话 | |
|
|
60
|
-
| 搜索过滤 | 收藏书签：悬停点星，★ 只看收藏 | |
|
|
61
|
-
| 状态感知 | 轮次健康徽章：出错红 / 上限黄 / 重试橙 / 运行蓝 / 等待脉冲 | |
|
|
62
|
-
| 状态感知 | 悬停元信息：时间 · 轮次 · 用时 · 结束原因 · TTFT · tok/s · 模型 · token 用量 | |
|
|
63
|
-
| 个性化与效率 | 键盘导航：全程不用鼠标 | ↑↓ 移动 · Enter 跳转 · Home/End 首尾 |
|
|
64
|
-
| 个性化与效率 | turn 分组折叠：按轮次成组，长轮次折成一条 | |
|
|
65
|
-
| 个性化与效率 | 复制与 fork：一键复制提问全文 / 从此处分支 | |
|
|
66
|
-
| 个性化与效率 | 聚焦模式：淡化 / 折叠思考与工具调用，强度可调、自由搭配 | |
|
|
67
|
-
| 个性化与效率 | 折叠工具栏：功能键默认收起，箭头展开；设置菜单可把常用键钉到折叠外（持久化 + 恢复默认） | |
|
|
68
|
-
| 个性化与效率 | 个性化外观：强调色 / 图标圆点大小 / 距侧边距离 / 位置左右（设置内即调即存） | |
|
|
69
|
-
| 个性化与效率 | 语言切换：跟随系统 / 中文 / English，设置内一键切换 | |
|
|
70
|
-
| 个性化与效率 | 点击外部关闭：搜索 / 列表等浮层自动收起 | |
|
|
71
|
-
| 个性化与效率 | 新手教程：首次使用内置演示引导（悬停 / 搜索 / 收藏上手），设置内可重看 | |
|
|
72
|
-
| 发布运维 | 更新检测：6h 缓存自动检查，新版徽章，一键去 npm | |
|
|
73
|
-
| 发布运维 | 设置推广区：GitHub / Star / Issue / npm 四入口 | |
|
|
74
|
-
|
|
75
|
-
另：滚轮可在里程碑条上直接滑动选点；圆点的固定间距与蓝色渐变见下方「圆点时间线」一节。
|
|
76
|
-
|
|
77
|
-
## 核心功能详解
|
|
78
|
-
|
|
79
|
-
### 圆点时间线与悬停元信息
|
|
80
|
-
|
|
81
|
-
- 每个提问一个圆点，点击平滑跳转；悬停即看内容与元信息。
|
|
82
|
-
- 圆点等距排列、不随对话长度变形；颜色由浅入深标出先后，同 Git 提交图。
|
|
47
|
+
## 功能详解
|
|
83
48
|
|
|
84
|
-
|
|
85
|
-
┌──────────────────────────────────────────┐
|
|
86
|
-
│ 第 3 / 5 条 · 第 2 轮 ☆ 复制 ✂ │ ← 序号 + 轮次 + 收藏/复制/fork
|
|
87
|
-
│ 帮我优化这段代码的性能 │ ← 消息预览（前 80 字）
|
|
88
|
-
│ 5 分钟前 · 用时 1m30s · 首字 1.2s · 12.4 tok/s │ ← 时间 · 耗时 · TTFT · 吞吐
|
|
89
|
-
│ v4 · continue · 1280 / 2560 tok │ ← 模型 · 用途 · token 用量
|
|
90
|
-
└──────────────────────────────────────────┘
|
|
91
|
-
```
|
|
49
|
+
### 圆点时间线
|
|
92
50
|
|
|
93
|
-
|
|
51
|
+
每个提问一个圆点，点击平滑跳转；悬停即看内容与元信息。圆点等距排列、不随对话长度变形，颜色由浅入深标出先后，同 Git 提交图。滚轮可在里程碑条上直接滑动选点，视口内最近的提问亮起白环。
|
|
52
|
+
|
|
53
|
+
### 全部提问列表
|
|
54
|
+
|
|
55
|
+
一键打开面板，序号 + 轮次 + 预览一次看全，点击任意一条直接跳转。打开时会**自动加载整个会话**的历史，不用手动翻页——对藏在最早期的消息来说，比在小圆点上逐个找快得多。
|
|
94
56
|
|
|
95
57
|
### 站内搜索
|
|
96
58
|
|
|
97
|
-
|
|
98
|
-
- `Enter` 跳到下一个匹配，`Esc` 一键清空。
|
|
99
|
-
- 范围 = 当前已加载窗口；更早的历史先点「···」加载进来。
|
|
59
|
+
搜索框过滤圆点，匹配的是**完整消息内容**（不是 80 字摘要），实时显示命中数 N/M。`Enter` 跳到下一个匹配，`Esc` 一键清空。
|
|
100
60
|
|
|
101
|
-
###
|
|
61
|
+
### 跨会话搜索
|
|
102
62
|
|
|
103
|
-
|
|
104
|
-
- 顶部「★」一键只看收藏，把一次性跳转变反复回访。
|
|
63
|
+
一键搜索**所有会话**的消息内容（harness 原生索引），点击命中结果直接打开对应会话。
|
|
105
64
|
|
|
106
|
-
###
|
|
65
|
+
### 收藏书签与深链接
|
|
107
66
|
|
|
108
|
-
|
|
109
|
-
- 目标在已加载窗口外时，自动先加载更早历史再定位（受加载上限约束）。
|
|
67
|
+
悬停圆点点星收藏，刷新后仍在（按会话持久化），顶部「★」一键只看收藏。跳转时 URL 自动带上 `#msg=` 锚点，刷新或分享后仍回到同一条消息。
|
|
110
68
|
|
|
111
|
-
###
|
|
69
|
+
### 悬停元信息
|
|
112
70
|
|
|
113
|
-
|
|
114
|
-
- 点击结果直接打开对应会话；最多 20 条结果，片段 ≤240 字符。
|
|
71
|
+
时间 · 轮次 · 用时 · 结束原因 · TTFT · tok/s · 模型 · 用途 · token 用量，一张卡片看全。数据全部来自 harness 原生会话快照，零额外依赖：
|
|
115
72
|
|
|
116
|
-
|
|
73
|
+
```
|
|
74
|
+
┌──────────────────────────────────────────┐
|
|
75
|
+
│ 第 3 / 5 条 · 第 2 轮 ☆ 复制 ✂ │ ← 序号 + 轮次 + 收藏/复制/fork
|
|
76
|
+
│ 帮我优化这段代码的性能 │ ← 消息预览（前 80 字）
|
|
77
|
+
│ 5 分钟前 · 用时 1m30s · 首字 1.2s · 12.4 tok/s │ ← 时间 · 耗时 · TTFT · 吞吐
|
|
78
|
+
│ v4 · continue · 1280 / 2560 tok │ ← 模型 · 用途 · token 用量
|
|
79
|
+
└──────────────────────────────────────────┘
|
|
80
|
+
```
|
|
117
81
|
|
|
118
|
-
|
|
119
|
-
|
|
82
|
+
### 更多效率功能
|
|
83
|
+
|
|
84
|
+
- **键盘导航**：`↑↓` 移动 · `Enter` 跳转 · `Home/End` 首尾，全程不用鼠标。
|
|
85
|
+
- **turn 分组折叠**：长轮次折成一条，汇总圆点带可见 ×N 徽标，一眼知道藏着几条。
|
|
86
|
+
- **复制与 fork**：一键复制提问全文 / 从此处分支。
|
|
87
|
+
- **聚焦模式**：淡化 / 折叠思考与工具调用，强度可调、自由搭配。
|
|
88
|
+
- **折叠工具栏**：功能键默认收起，常用键可钉到折叠外；搜索 / 列表等浮层点击外部自动关闭。
|
|
89
|
+
- **个性化**：强调色 / 圆点大小 / 距侧边距离 / 左右位置即调即存；中文 / English 一键切换。
|
|
120
90
|
|
|
121
91
|
## 工作原理
|
|
122
92
|
|
|
@@ -129,94 +99,61 @@ shell.overlay (root scope)
|
|
|
129
99
|
```
|
|
130
100
|
|
|
131
101
|
- **注入点**：`shell.overlay` 全框架浮动层，附加式、点击穿透，不碰现有 UI。
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
102
|
+
- **数据源**：harness 原生会话快照（消息列表、turn 元数据、分页与运行状态），无自建抓取。
|
|
103
|
+
- **跳转**：以消息锚点做 DOM 定位，`scrollIntoView` 平滑滚动。
|
|
104
|
+
- **分页**：顶部「···」按需加载更早历史；全部提问列表打开时自动加载整个会话。
|
|
105
|
+
- **持久化**：书签与工具栏偏好经 `store.persist` 按会话写入 localStorage。
|
|
106
|
+
- **纯函数分层**：过滤、位置计算、圆点状态集中在 `rail-logic.ts` 纯函数层，单测覆盖。
|
|
136
107
|
|
|
137
108
|
## 版本与兼容
|
|
138
109
|
|
|
139
110
|
- 当前官方支持线：**`0.1.1-rc.2`**（peer/dev 依赖 `^0.1.1-rc.2`，与 `@deepseek-ai/dsh` 最新 `latest` 标签一致）。
|
|
140
111
|
- 官方客户端包（`dsh-client-runtime` 等）在 npm 上走 `next` 标签发布（`latest` 标签仍是远古版本）；升级 harness 后若发现插件不匹配，请确认安装的依赖解析到了 `0.1.1-rc.2` 线。
|
|
141
|
-
-
|
|
112
|
+
- harness 当前版本在浏览器端没有可信来源（`host.describe().version` 是占位值），因此不做精确探测，以插件声明的支持线为准。
|
|
142
113
|
|
|
143
114
|
## 已知限制
|
|
144
115
|
|
|
145
|
-
> ⚠️
|
|
116
|
+
> ⚠️ **最需要注意**：站内搜索只覆盖**当前已加载**的消息窗口（初始 50 条），更早的历史需先点顶部「···」加载进来才能被搜到。「全部提问」列表不受此限：打开时会自动加载整个会话，始终一次看全。
|
|
146
117
|
|
|
147
118
|
<details>
|
|
148
119
|
<summary>查看更多已知限制（点击展开）</summary>
|
|
149
120
|
|
|
150
|
-
- TTFT /
|
|
151
|
-
-
|
|
152
|
-
-
|
|
153
|
-
- 模型 / token 用量依赖该轮 assistant 节点的元数据，部分场景下缺失则自动隐藏该行。
|
|
121
|
+
- TTFT / tok/s 依赖 turn 位置数据，窗口外或未完成的 turn 不显示（自动隐藏）。
|
|
122
|
+
- 徽章的瞬态状态（运行中 / 等待输入）只点亮最新一条可见提问；该提问在窗口外时无脉冲。
|
|
123
|
+
- 书签按会话隔离，不跨会话共享。
|
|
154
124
|
- fork 从选中消息所在轮次开始分支，不会自动打开子会话（需在会话列表手动打开）。
|
|
155
|
-
-
|
|
156
|
-
-
|
|
157
|
-
- 聚焦模式作用于当前会话视图的思考区块，不影响其他插件或工具的展示。
|
|
158
|
-
- 尚无全局快捷键聚焦里程碑条（需 Tab 键切换到）。
|
|
159
|
-
- 功能键**默认折叠**，首次使用需点箭头展开；可在设置菜单里把常用键钉到折叠外。
|
|
160
|
-
- 更新检测依赖浏览器能访问 npm 镜像（`registry.npmmirror.com` / `registry.npmjs.org`）；若页面 CSP 限制 `connect-src` 或离线，检查会静默失败。结果缓存 6 小时。
|
|
161
|
-
- 工具栏固定偏好存于浏览器 localStorage（不跨浏览器/设备同步）。
|
|
125
|
+
- 深链接目标若早于已加载窗口，会先自动加载更早历史再定位；受加载上限约束，极端深的历史可能定位失败。
|
|
126
|
+
- 跨会话搜索仅返回片段（≤240 字符）、最多 20 条结果，命中过多时请细化关键词。
|
|
162
127
|
|
|
163
128
|
</details>
|
|
164
129
|
|
|
165
130
|
## 更新日志
|
|
166
131
|
|
|
167
132
|
<details>
|
|
168
|
-
<summary>v0.6.
|
|
169
|
-
|
|
170
|
-
**v0.6.4** · 新手教程 · 385 项测试
|
|
133
|
+
<summary>v0.6.6 / v0.6.5 / v0.6.4（点击展开）</summary>
|
|
171
134
|
|
|
172
|
-
|
|
173
|
-
- 4 步教学 + 内置演示：迷你圆点条 hover/点击、玩具搜索与收藏、个性化与设置图例、更新检测与支持；进度点 + 上一步/下一步 + 随时跳过，全部双语。
|
|
174
|
-
- 设置与教程模态视觉共用 `modal-tokens.ts` 单一来源。
|
|
175
|
-
|
|
176
|
-
> [GitHub Release v0.6.4](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.4)
|
|
135
|
+
**v0.6.6** · 全部提问列表自动加载整个会话 · 折叠圆点 ×N 徽标 · 轮次连续显示 · 397 项测试
|
|
177
136
|
|
|
178
|
-
|
|
137
|
+
- **全部提问列表一次看全**：打开时自动加载整个会话的历史，不再受初始加载窗口限制，点击任意一条直达。
|
|
138
|
+
- **折叠轮次不藏消息**：汇总圆点带可见 ×N 计数徽标，悬停气泡显示覆盖的条数区间（第 a–b / m 条）。
|
|
139
|
+
- **轮次编号连续化**：显示轮号按圆点顺序重编号（1、2、3…），不再跳空或重复；分组与折叠逻辑不变。
|
|
140
|
+
- **列表点击外部自动关闭**：与搜索、跨会话搜索浮层同一套外部点击关闭契约。
|
|
141
|
+
- README 重写为产品宣传结构：演示图第一屏，功能介绍分组清晰。
|
|
179
142
|
|
|
180
|
-
|
|
181
|
-
- **设置模态重设计**：功能悬停描述改为**就近 tip**（行旁悬浮，不再有大块常驻描述区）；恢复表头说明（「开启后，折叠时仍显示在箭头旁」）；个性化收进**可展开块**（默认折叠，头部实时摘要）；间距/圆角/强调色统一，修复行 hover 洗色失效。
|
|
182
|
-
- README 图片改绝对 URL（npm 渲染器不重写相对路径），npm 页 logo/演示图恢复正常。
|
|
143
|
+
> [GitHub Release v0.6.6](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.6)
|
|
183
144
|
|
|
184
|
-
|
|
145
|
+
**v0.6.5** · 新手教程改为锚定真实组件的教练气泡引导，设置模态对比度修复 · 近 400 项测试
|
|
185
146
|
|
|
186
|
-
|
|
147
|
+
> [GitHub Release v0.6.5](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.5)
|
|
187
148
|
|
|
188
|
-
|
|
189
|
-
- **个性化模块**：强调色（预设 + 自定义）、图标 / 圆点大小、距侧边距离、位置左或右（浮层自动换侧），全部即调即存。
|
|
190
|
-
- **语言切换**：跟随系统 / 中文 / English（zh/en 词典完整，缺译即编译错）。
|
|
191
|
-
- 设置按钮进入展开队列（折叠态更干净）；底部推广区改 2×2 卡片网格。
|
|
192
|
-
- 圆点 turn 分隔线移除（改组间距表达）；状态徽章改为柔边光晕。
|
|
193
|
-
- npm 包纳入 `assets/*.svg`（npm 页 README 图片恢复显示）。
|
|
149
|
+
**v0.6.4** · 首次使用引导：4 步双语教学 + 内置演示，印象即写、关页不重弹
|
|
194
150
|
|
|
195
|
-
> [GitHub Release v0.6.
|
|
196
|
-
|
|
197
|
-
**v0.6.1** · 对齐 `0.1.1-rc.2` 支持线 · 五项新功能 · 292 项测试
|
|
198
|
-
|
|
199
|
-
- 折叠工具栏：功能键默认收起，箭头展开。
|
|
200
|
-
- 设置菜单：常用功能「在折叠外显示」固定自定义；偏好持久化，一键恢复默认。
|
|
201
|
-
- 设置底部推广区：GitHub / Star / Issue / npm 四入口。
|
|
202
|
-
- 更新检测：6h 缓存自动检查、新版徽章、当前/最新版本与已适配版本线、一键去 npm。
|
|
203
|
-
- 点击外部自动关闭各浮层（与官方 capture 阶段 pointerdown 契约一致）。
|
|
204
|
-
|
|
205
|
-
> [GitHub Release v0.6.1](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.1)
|
|
206
|
-
|
|
207
|
-
**v0.6.0** · P3 功能
|
|
208
|
-
|
|
209
|
-
- 聚焦模式：淡化思考(thinking)区块，悬停或展开自动恢复。
|
|
210
|
-
- 全部提问列表面板：序号 + 轮次 + 预览一次看全，点击即跳。
|
|
211
|
-
- 深链接：`#msg=` 锚点，刷新或分享后直达同一条消息。
|
|
212
|
-
- 跨会话搜索：搜索所有会话的消息内容，点击结果打开对应会话。
|
|
151
|
+
> [GitHub Release v0.6.4](https://github.com/SnowCrescenter-tech/dsh-milestone/releases/tag/v0.6.4)
|
|
213
152
|
|
|
214
|
-
|
|
153
|
+
更早版本见 [GitHub Releases](https://github.com/SnowCrescenter-tech/dsh-milestone/releases)。
|
|
215
154
|
|
|
216
155
|
</details>
|
|
217
156
|
|
|
218
|
-
维护者：发布清单见 [RELEASING.md](./RELEASING.md)。
|
|
219
|
-
|
|
220
157
|
## License
|
|
221
158
|
|
|
222
159
|
[MIT](./LICENSE)
|
|
@@ -224,5 +161,5 @@ shell.overlay (root scope)
|
|
|
224
161
|
---
|
|
225
162
|
|
|
226
163
|
<p align="center">
|
|
227
|
-
|
|
164
|
+
如果它帮你省下了一次翻找，欢迎给个 Star，或推荐给同样在 DeepSeek Harness 里长聊的开发者。
|
|
228
165
|
</p>
|