@sinm/kai 1.16.0 → 1.16.2

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.
Files changed (20) hide show
  1. package/README.md +97 -198
  2. package/RELEASE_NOTES.md +61 -0
  3. package/dist-cli/kai-cli.js +4494 -3158
  4. package/dist-electron/main/plugin-host.js +26 -2
  5. package/dist-electron/renderer/assets/{ContextDraftStrip-DgGrWpQa.js → ContextDraftStrip-CWXg4hmU.js} +3 -3
  6. package/dist-electron/renderer/assets/{desktop-overlay-reason-CIrczlM4.js → desktop-overlay-reason-cfmtdoP4.js} +38 -22
  7. package/dist-electron/renderer/assets/{index-Ds9SVVR0.js → index-BBL4bwnW.js} +2 -2
  8. package/dist-electron/renderer/assets/{index-Byy_48PP.js → index-CObwhkO8.js} +9146 -8207
  9. package/dist-electron/renderer/assets/{index-C2oDt0EL.css → index-DSggA-B_.css} +3004 -2309
  10. package/dist-electron/renderer/assets/{index-HFo3Rjsc.js → index-PLhxSKC5.js} +33 -4
  11. package/dist-electron/renderer/assets/{localUrlCodec-BgpHB7et.js → localUrlCodec-Bg7FpeI8.js} +10 -2
  12. package/dist-electron/renderer/assets/{office-preview-Bi474exi.js → office-preview-CyqocXBw.js} +3 -3
  13. package/dist-electron/renderer/assets/{overlay-CVoNuaDV.js → overlay-D8OF8lDc.js} +10 -10
  14. package/dist-electron/renderer/assets/{overlay-C9ghz5je.css → overlay-HLCSQ-UD.css} +29 -23
  15. package/dist-electron/renderer/assets/{parser-Dpx0j1yO.js → parser-qf1_X8VO.js} +1 -1
  16. package/dist-electron/renderer/assets/{spreadsheet-AxcoOBpQ.js → spreadsheet-kLECX3ut.js} +3 -3
  17. package/dist-electron/renderer/index.html +4 -4
  18. package/dist-electron/renderer/office-preview.html +2 -2
  19. package/dist-electron/renderer/overlay.html +4 -4
  20. package/package.json +1 -4
package/README.md CHANGED
@@ -2,38 +2,43 @@
2
2
 
3
3
  > 开启思考。不是帮你做事,是帮你想得更深、更远。
4
4
 
5
- KAi 是一款**多 AI Agent 协作桌面应用**。你创建的每个 Agent 都有独立的记忆、工作空间和能力边界——它们像一支真正的团队一样协作。
5
+ KAi 是一款**多 Agent 协作桌面应用**:你创建的每个 Agent 都有独立的身份、记忆、工作空间和能力边界,像一支真正的团队那样分工、交接和讨论。
6
6
 
7
7
  **一个人,一支团队。**
8
8
 
9
9
  ## 为什么
10
10
 
11
- 通用聊天助手的问题不是不聪明,而是没有结构:它什么都能答,却没有稳定身份、长期记忆、职责边界和团队协作。
11
+ 通用聊天助手不缺聪明,缺结构:没有稳定身份、没有长期记忆、没有职责边界,也没有“彼此”。
12
12
 
13
- KAi 的答案是 Agent 团队。你可以让一个「乔布斯」负责产品判断,一个「Anders Hejlsberg」把控类型和架构,一个「TJ Holowaychuk」快速落地,一个「Robert C. Martin」做代码审查。它们各有各的工作空间、记忆、工具和性格;它们会 @mention 彼此,会 handoff,会广播讨论,也会把子任务分派给后台 Agent。
13
+ KAi 把“一个全能助手”换成一支有分工的团队——一个「乔布斯」做产品判断,一个「Grady Booch」管抽象边界,一个「TJ Holowaychuk」快速落地,一个「Kent Beck」先写测试。它们各自持有工作空间与记忆,会 @mention、handoff、广播讨论,也会把子任务派给后台 Agent。你得到的不是更长的回答,而是一个能持续推进的工作面。
14
14
 
15
- ## 特性
15
+ ## 它能做什么
16
16
 
17
- ### 🧠 Agent 系统
17
+ ### 🧠 Agent:有自己的身份和记性
18
18
 
19
- - **独立身份** — 每个 Agent 有自己的名字、头像、描述和 SOUL(行为准则)。
20
- - **持久记忆** — Agent 自主维护 `MEMORY.md` 和每日笔记,跨会话保留上下文。
21
- - **独立工作空间** — 每个 Agent 拥有自己的文件工作区:`~/.kai/agents/{agentId}/workspace/`。
22
- - **能力边界** — 可为 Agent 分配 Skills、MCP 服务、禁用工具和监督参数。
19
+ - **独立身份** — 名字、头像、描述与 SOUL(行为准则),不是换了个提示词的同一个模型。
20
+ - **持久记忆** — 文件化的 `MEMORY.md` + `memory/YYYY-MM-DD.md` 每日笔记,跨会话保留上下文,夜间自动提炼。
21
+ - **独立工作空间** — 每个 Agent 一个目录:`~/.kai/agents/{agentId}/workspace/`。
22
+ - **能力边界** — 按 Agent 分配 Skills、MCP 服务、禁用工具与监督参数。
23
+ - **克隆与派生** — 复制已有 Agent 或群组的配置与工作空间,快速开新主体。
23
24
 
24
- ### 👥 多 Agent 协作
25
+ ### 👥 协作:从单聊到群聊
25
26
 
26
- - **Session 化对话** — 单聊和群聊都以 Session 为主概念;一个群组可拥有多个隔离 Session。
27
- - **单聊多 Session** — 同一个 Agent 可并行开启多个讨论,适合把不同任务、分支思路和长期陪跑拆开。
28
- - **Handoff 交接** — Agent 可以主动交接任务,并附带原因和上下文摘要。
29
- - **@mention** — 在消息中 @ 指定 Agent,触发协作或路由。
30
- - **Broadcast 广播** — 一次问题并行询问多个 Agent,聚合不同专业判断。
31
- - **子任务分派** — Agent 可以创建前台或后台任务,委托其他 Agent 执行。
32
- - **Goal 模式** — 用 `/goal` 指定一个 Agent 作为 Goal 负责人,在 Goal 工作区里维护 goal.md / plan.md / todo.md,按成果完成门禁推进并在 Goal Review 收口。
27
+ - **Session 为主概念** — 单聊与群聊都以 Session 运行;同一个 Agent、同一个群都可并行开多个 Session。
28
+ - **Handoff / @mention / Broadcast** — 交接带原因与上下文摘要;@ 指定 Agent 路由;一次问题并行问多个 Agent 汇总判断。
29
+ - **子任务分派** — Agent 可创建前台或后台任务委托他人执行,过程中可继续引导。
30
+ - **Goal 模式** — `/goal` 指定负责人,在 Goal 工作区维护 goal.md / plan.md / todo.md,按成果门禁推进并在 Review 收口。
33
31
 
34
- ### 🛠 内置工具
32
+ ### 💬 聊天体验
33
+
34
+ - 流式输出,实时渲染 Markdown、代码高亮与推理过程。
35
+ - 图片、文件附件、剪贴板图片与多模态消息;工具调用、任务结果、广播结果以结构化卡片展示状态与耗时。
36
+ - Session Tabs:新建、切换、重命名、归档、从某一点 Fork。
37
+ - 明暗主题自适应,中英文 i18n,产品级快捷键(见 [`docs/decisions/keyboard-shortcuts.md`](docs/decisions/keyboard-shortcuts.md))。
35
38
 
36
- Agent 开箱即用的能力:
39
+ 完整能力清单见 [功能清单](docs/product/features.md)。
40
+
41
+ ### 🛠 内置工具
37
42
 
38
43
  | 工具 | 功能 |
39
44
  | -------------- | -------------------------------------------- |
@@ -47,42 +52,24 @@ Agent 开箱即用的能力:
47
52
  | **MCP** | 通过 Model Context Protocol 连接外部工具服务 |
48
53
  | **Image** | 图片识别与图片生成 |
49
54
 
50
- ### 💬 聊天体验
51
-
52
- - 流式输出,实时渲染 Markdown / 代码高亮 / 推理过程。
53
- - 支持图片、文件附件和多模态消息。
54
- - 工具调用、任务结果、广播结果以结构化卡片展示,并展示状态与耗时。
55
- - 群聊与单聊都支持顶部 Session Tabs:新建、切换、重命名、归档。
56
- - 快捷回复支持独立 `⚡` 入口与键盘直发;`/` 命令保留给真正的命令。
57
- - 产品级快捷键绑定见 `docs/decisions/keyboard-shortcuts.md`。
58
- - 明暗主题自适应。
59
- - 中英文国际化(i18n)。
60
-
61
55
  ### 🔌 连接与自动化
62
56
 
63
- - **模型通道** — 支持主模型、备用模型、自动 fallback 和健康状态记录。
64
- - **模型能力学习** — 根据真实报错学习上下文窗口 / 最大输出限制,自动修正后重试。
65
- - **MCP 服务** — 在设置中添加 MCP 服务,并一键应用到指定 Agent。
66
- - **Bot 接入** — 支持外部频道接入,让 Agent 不只活在桌面窗口里。
67
- - **远程访问** — 可通过远程入口访问本地 KAi。
57
+ - **模型通道** — 主模型 + 备用模型 + 自动 fallback,带健康状态与失败学习(上下文窗口、最大输出)。
58
+ - **MCP 服务** — 设置里添加服务,一键应用到指定 Agent。
59
+ - **Bot 接入** — 外部频道接入,让 Agent 不只活在桌面窗口里。
60
+ - **远程访问** — 通过远程入口访问本地 KAi;另有 CLI 形态。
68
61
  - **定时任务** — 定期触发消息、记忆整理或自动化工作流。
69
- - **自动更新** — 桌面应用支持检查更新、下载进度和安装更新。
62
+ - **自动更新** — 检查、下载进度与安装。
70
63
 
71
64
  ## 技术栈
72
65
 
73
66
  ```text
74
- Electron 42 + React 19 + TypeScript 5
75
- Vercel AI SDK + SQLite3 + Zustand + CSS Modules
67
+ Electron 43 + React 19 + TypeScript 5
68
+ Vercel AI SDK + SQLite3 + Zustand 5 + CSS Modules
76
69
  electron-vite + Vitest + Playwright
77
70
  ```
78
71
 
79
- - **运行形态**:Electron 桌面应用 + CLI + 本地 telemetry dashboard
80
- - **Core**:Agent / Message / Tool / Skill 等领域逻辑与端口接口。
81
- - **Adapters**:LLM、MCP、DB、文件存储、工具、调度器、外部频道等具体实现。
82
- - **Electron Main**:应用启动、IPC、自动更新、崩溃日志、远程访问。
83
- - **Renderer**:React UI,沙箱化运行(`contextIsolation: true`)。
84
- - **Preload**:通过 `contextBridge` 暴露受控 API。
85
- - **CLI**:复用核心链路的命令行入口。
72
+ 一个内核,四种交付面:Electron 桌面应用、CLI、VS Code 扩展与浏览器扩展、本地 telemetry dashboard。
86
73
 
87
74
  ## 快速开始
88
75
 
@@ -91,17 +78,12 @@ electron-vite + Vitest + Playwright
91
78
  - Node.js >= 22
92
79
  - Yarn 1.x
93
80
 
94
- ### 安装
81
+ ### 从源码运行
95
82
 
96
83
  ```bash
97
- git clone https://github.com/pansinm/kai.git
84
+ git clone <仓库地址>
98
85
  cd kai
99
86
  yarn install
100
- ```
101
-
102
- ### 开发
103
-
104
- ```bash
105
87
  yarn dev
106
88
  ```
107
89
 
@@ -109,186 +91,103 @@ yarn dev
109
91
 
110
92
  ```bash
111
93
  yarn build:cli
112
- npx @sinm/kai@latest start --port 9529
113
- npx @sinm/kai@latest --version # 只打版本号一行,便于脚本取
114
- npx @sinm/kai@latest --help # 首行是版本
115
- ```
116
-
117
- ### 构建与打包
118
-
119
- ```bash
120
- yarn build # 构建 Electron 应用
121
- yarn package # 打包当前平台安装包,输出到 release/
122
- yarn build:cli # 构建 CLI
123
- ```
124
-
125
- ### 测试
126
-
127
- ```bash
128
- yarn test # Vitest
129
- npx tsc --noEmit -p tsconfig.web.json
130
- npx tsc --noEmit -p tsconfig.node.json
131
- yarn test:e2e # 内部会先执行 yarn build
132
- ```
133
-
134
- 发布前建议按这个顺序跑完整门禁:
135
-
136
- ```bash
137
- npx tsc --noEmit -p tsconfig.web.json
138
- npx tsc --noEmit -p tsconfig.node.json
139
- yarn test
140
- yarn test:e2e
94
+ npx @sinm/kai@latest start --port 9527 # 默认端口 9527
95
+ npx @sinm/kai@latest --version # 只打版本号一行,便于脚本取
96
+ npx @sinm/kai@latest --help # 首行是版本
141
97
  ```
142
98
 
143
99
  ## 架构
144
100
 
145
- KAi 的代码按职责分层,而不是按运行环境硬塞在一起:
101
+ KAi 按职责分层,而不是按运行环境硬塞在一起:
146
102
 
147
103
  ```text
148
104
  src/
149
- ├── entry/ # 系统对外接口面 + 平台专属装配(electron main/preload、cli、transport 接站)
150
- ├── client/ # 用户客户端:electron 窗口 + 远程浏览器面共用一份(React UI、状态、交互)
151
- ├── app/ # 应用服务(service,按聚合切)+ 组合根(composition)
152
- ├── domain/ # 业务规则与概念(DDD 战术模式,零依赖)
153
- ├── infra/ # 基础设施实现(DB、文件、LLM、PTY、遥测…)
154
- ├── contracts/ # 跨进程 wire 契约底层(只放 interface / type,零运行时、零依赖)
155
- └── __tests__/ # 跨层护栏
156
-
157
- servers/telemetry/ # 遥测服务端(独立 workspace 应用)
105
+ ├── main/ Node 侧:四层架构的全部层与契约底层
106
+ │ ├── entry/ 对外接口面 + 平台装配(electron main / preload、cli)
107
+ │ ├── app/ 应用服务层(按聚合切分的编排 service、API handler、组合根)
108
+ │ ├── engine/ Agent 机制内核(thread 驱动、多步循环、prompt、compaction)
109
+ │ ├── domain/ 领域层(零依赖聚合)
110
+ │ ├── infra/ 基础设施实现(db / pty / llm / transport / plugin / telemetry…)
111
+ │ └── contracts/ 跨进程 wire 契约(纯类型,零依赖、零运行时)
112
+ ├── renderer/ 渲染进程(React + Zustand)
113
+ ├── protocol/ renderer ↔ main 唯一的门(只转出 main 侧形状,不定义新形状)
114
+ └── utils/ 两端共用的纯底座(零 Node 内置依赖、零 src 层依赖)
115
+
116
+ apps/ 伴生交付面:browser-extension / vscode-extension / helpers
117
+ servers/ 自托管服务:telemetry(遥测 + Dashboard)、funasr(语音识别)
118
+ packages/ 被复用的库:kai-loop / kai-thread / kai-stepdriver / kai-step-contract / embed-sdk
158
119
  ```
159
120
 
160
- ### Agent 执行层
161
-
162
- ```text
163
- direct / swarm orchestration
164
- -> WorkerRuntime # Worker 连续性、持久化、压缩与写回
165
- -> LoopBackedAgentLoop # 多步循环、retry、fallback 与停止条件
166
- -> 局部 StepDriver 适配 # 组合根组装 ProviderStepInput 并投影结果
167
- -> ProviderStepExecutor # provider 单步执行端口与 runtime concern 装配
168
- -> provider-specific StepDriver # 单次模型请求、流消费、工具执行与结果投影
169
- ```
121
+ 依赖方向只有四句:`renderer → protocol → main`、`renderer → utils`、`main → utils`;反向两条禁令——protocol 不得依赖 renderer,main 不得依赖 protocol。裁决与守卫见 [src 顶层重组](docs/decisions/src-topology-and-protocol-layer.md)。
170
122
 
171
- ### 消息与 Session
123
+ **一次消息的路径**:
172
124
 
173
125
  ```text
174
126
  User Input
175
- → window.api.sendUserMessage()
176
- → MessageQueue
177
- → MessageProcessor
178
- → SoloChat / GroupChat
179
- → SoloExecutor / SwarmExecutor
180
- → LLM + Tools
181
- → ConversationEvent stream
182
- → Zustand Store
183
- → React UI
184
- ```
185
-
186
- - 单聊与群聊都以 `Session` 作为主要运行单元。
187
- - 单聊的 Session 归属于某个 Agent;群组的 Session 归属于某个 Group。
188
- - `speaker` 是群组 Session 级状态,而不是全局群组状态。
189
- - 消息仍由 SQLite 持久化;长上下文由文件 `context.json` 保存。
190
-
191
- ### 消息压缩管线
192
-
193
- 长对话自动压缩,按成本从低到高处理:
194
-
195
- ```text
196
- ToolResultSpill
197
- → ReasoningRemoval
198
- → Summarization
199
- → Pruning
127
+ → MessageProcessor # 排队、路由、群聊广播准备
128
+ → direct / swarm 执行编排 # 谁在这一轮说话、并发几路
129
+ → engine thread 驱动 # 多步循环、retry、fallback、停止条件
130
+ → LLM + Tools # provider 单步、流消费、工具执行
131
+ → ConversationEvent 事件流
132
+ → Zustand store → React UI
200
133
  ```
201
134
 
202
- 触发时机、durable/runtime 消息边界、摘要与显式当前用户输入保留的完整契约见 [`docs/specs/context-compaction.md`](docs/specs/context-compaction.md)。
135
+ **长上下文**:到达阈值后自动压缩,重建基底时保留用户原话与事实段(失败命令、退出码、改动文件由规则抽取,不经模型转述),再补摘要与尾部窗口。契约见 [`docs/specs/context-compaction.md`](docs/specs/context-compaction.md) 与 [`compaction-baseline-composition`](docs/decisions/compaction-baseline-composition.md)。
203
136
 
204
- ### 数据存储
137
+ **数据在哪**(默认 `~/.kai/`,仅列常用路径):
205
138
 
206
139
  ```text
207
140
  ~/.kai/
208
- ├── kai.db # SQLite:消息等结构化数据
209
- ├── config/ # 应用配置,加密存储 API Key
210
- ├── direct-sessions/
211
- │ └── {sessionId}/
212
- │ └── context.json # 单聊 Session 上下文
213
- ├── agents/
214
- │ └── {agentId}/
215
- │ ├── meta.json # Agent 身份
216
- │ ├── config.json # 模型、fallback、skills、MCP、禁用工具等能力配置
217
- │ ├── context.json # legacy 单聊上下文兼容文件
218
- │ └── workspace/
219
- │ ├── SOUL.md
220
- │ ├── USER.md
221
- │ ├── MEMORY.md
222
- │ ├── AGENTS.md
223
- │ ├── TOOLS.md
224
- │ └── memory/
225
- ├── groups/
226
- │ └── {groupId}/
227
- │ ├── meta.json
228
- │ ├── config.json
229
- │ ├── members.json
230
- │ ├── GROUP_SETTINGS.md # 人可写,AI 只读
231
- │ ├── GROUP_MEMORY.md # 群长期记忆
232
- │ ├── memory/ # 群每日记忆
233
- │ └── sessions/
234
- │ └── {sessionId}/
235
- │ ├── meta.json
236
- │ ├── config.json
237
- │ └── context.json # 群组 Session 上下文
238
- ├── conversations/ # 追加式消息日志(jsonl,兼容运行链路)
239
- └── attachments/ # 对话附件
141
+ ├── kai.db # SQLite:消息等结构化数据
142
+ ├── config/ # 应用配置,API Key 加密存储
143
+ ├── agents/{agentId}/ # meta.json、config.json、sessions/、workspace/
144
+ │ └── workspace/ # SOUL.md、USER.md、MEMORY.md、TOOLS.md、AGENTS.md、memory/
145
+ ├── groups/{groupId}/ # meta.json、config.json、members.json、sessions/、memory/
146
+ │ ├── GROUP_SETTINGS.md # 人可写,AI 只读
147
+ │ └── GROUP_MEMORY.md # 群长期记忆
148
+ ├── data/sessions/{id}/ # 追加式消息日志(messages/YYYY-MM-DD.jsonl)
149
+ ├── plugins/ · skills/ · commands/
150
+ └── attachments/ · logs/ · journals/
240
151
  ```
241
152
 
242
- ## 支持的 LLM
243
-
244
- KAi 通过 Vercel AI SDK 连接大语言模型,支持:
153
+ ## 开发
245
154
 
246
- - OpenAI Compatible(OpenAI、DeepSeek、Moonshot、MiniMax 等)
247
- - Anthropic Claude
248
- - Google Gemini
249
- - 任何兼容 OpenAI API 的模型服务
250
-
251
- 在设置的「模型通道」中配置 API Key 即可使用。
252
-
253
- ## MCP(Model Context Protocol)
254
-
255
- KAi 内置 MCP 客户端。在设置中添加 MCP 服务,然后应用到指定 Agent;只有被授权的 Agent 才会看到对应 MCP 工具。
155
+ ```bash
156
+ yarn dev # 开发模式
157
+ yarn build # 构建 Electron 应用(含 preload / plugin host / sharp 解包校验)
158
+ yarn package # 打包当前平台安装包到 release/
159
+ yarn build:cli # 构建 CLI
160
+ yarn test # Vitest(配置了远端时路由到远端执行)
161
+ yarn test:e2e # Playwright(内部先跑 yarn build)
162
+ yarn lint # ESLint
163
+ yarn docs:check # 文档索引、状态词、死链与分层的护栏
164
+ ```
256
165
 
257
- 示例配置形态:
166
+ 提交前跑完整门禁:
258
167
 
259
- ```json
260
- {
261
- "command": "npx",
262
- "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
263
- }
168
+ ```bash
169
+ yarn verify:push # tsc、结构守卫、单测、e2e、CLI smoke、telemetry 一次跑完
264
170
  ```
265
171
 
266
- ## 安全模型
172
+ 「结构守卫」不是装饰:`src/__tests__/` 里的 import 边界、层内单口、写点收敛等断言会在引入反向依赖时直接失败。
267
173
 
268
- KAi 采用 Electron 三进程安全架构:
174
+ ## 安全模型
269
175
 
270
- - **渲染进程**:沙箱化,无 Node.js 直接访问。
271
- - **预加载层**:`contextIsolation: true` + `nodeIntegration: false`。
272
- - **主进程**:文件系统、网络、数据库和工具调用通过 IPC 受控暴露。
176
+ - **渲染进程**:沙箱化,`contextIsolation: true` + `nodeIntegration: false`,无 Node 直连。
177
+ - **主进程**:文件系统、网络、数据库与工具调用经 IPC 受控暴露。
273
178
  - **文件工具**:要求绝对 `workdir` + 相对 `path`,拒绝路径逃逸。
274
179
  - **数据库工具**:只允许只读查询。
275
- - **API Key**:使用本地 salt + machineId 派生密钥,并通过 AES-256-GCM 加密存储。
180
+ - **API Key**:本地 salt + machineId 派生密钥,AES-256-GCM 加密存储。
181
+ - 外部发送、发布与破坏性操作受授权边界约束;删除类操作要求可恢复路径。
276
182
 
277
- ## 项目文档
183
+ ## 文档
278
184
 
279
- - [功能清单](docs/product/features.md) — 从用户视角查看当前已实现能力
280
- - [文档索引](docs/INDEX.md) — architecture / design / workflow 等入口
185
+ - [文档索引](docs/INDEX.md) — 按主题取起点,含 architecture / decisions / specs / product / workflow 全量列表
186
+ - [功能清单](docs/product/features.md) — 从用户视角看当前已实现能力
187
+ - [架构文档](docs/architecture/architecture.md) — 最新宏观架构与模块职责
188
+ - [贡献指南](CONTRIBUTING.md) — 环境、变更流程与提交规范
281
189
  - [Release Notes](RELEASE_NOTES.md) — 已发布版本记录
282
190
 
283
- ## 进一步阅读
284
-
285
- - [架构文档](docs/architecture/architecture.md)
286
- - [功能清单](docs/product/features.md)
287
- - [Release skill](.agents/skills/release/SKILL.md)
288
- - [AI 变更工作流](docs/workflow/ai-change-workflow.md)
289
- - [Swarm Supervisor 设计](docs/specs/swarm-supervisor-design.md)
290
- - [Provider Step Driver 设计](docs/specs/provider-step-driver.md)
291
-
292
191
  ## License
293
192
 
294
193
  MIT
package/RELEASE_NOTES.md CHANGED
@@ -1,5 +1,66 @@
1
1
  # Release Notes
2
2
 
3
+ ## v1.16.2
4
+
5
+ 发布日期:`2026-11-16`
6
+
7
+ > 对比 `v1.16.1` → `v1.16.2`
8
+
9
+ ### ✨ 你会直接感受到的升级
10
+
11
+ - **反馈变成了能读回的线程** —— 每条反馈有了后续:设置里能看到历史与收到的回复,有未读时入口带小点;后台多出收件箱,可以回复、标记已解决。入口:设置 → 关于 → 反馈。
12
+ - **任务跑完看得见,提醒只剩一处** —— 会话行亮小点(失败红点),提示写会话名、定时任务加注脚;提醒挪到右上角、失败那张也能关掉(记录与小点仍在,打开会话才清),开关默认关。入口:设置 → 应用设置 → 通用。
13
+ - **「待办」工具可以关** —— Agent 能力里的禁用工具多了这一项:关掉后不再注入步骤清单,没有开工令与底栏待办读数,goal 进度退回由待办文件承担。入口:Agent → 能力 → 内置工具权限。
14
+ - **设置页按「模型能力 / 我的习惯」重排** —— 新增「Agent」页签集中提问、卡片图表、右侧文件与子 Agent 并发;「行为」改名通用;「历史思考过程保留条数」退役,旧配置统一按「全部保留」生效。入口:设置 → 应用设置。
15
+ - **过程组头不再复述正在跑的命令** —— 组头只留耗时与按类计数,在跑哪条命令由成员行自己说,长命令不再挤满一行。入口:对话里的过程组头。
16
+ - **远程访问下导出事件日志,直接下载一个 zip** —— 远程(浏览器形态)此前点「导出 ▸ 事件日志」只会报「浏览器模式不可用」;现在由浏览器下载压缩包,结构和桌面导出的文件夹逐字一致。入口:会话 → 导出 → 事件日志。
17
+
18
+ ### 🐛 重要修复
19
+
20
+ - **自定义皮肤压了透明度,弹窗不再透出正文** —— 弹窗、菜单、浮动工具栏改用写死实色的浮层底;此前把背景压成半透明后,弹窗叠菜单会读不出字。
21
+ - **MCP 读取失败不再说成「还没有连接任何服务器」** —— 失败态可重试,空态只在真读成功且为空时出现,不会再让人以为配置丢了、重建一份重复配置。入口:设置 → MCP。
22
+ - **选中文字后的工具栏不再一闪就没** —— 位置没变的滚动(贴底与高度补偿会重复发)不再算「用户滚走了」;工具栏留到你真的滚开。入口:对话里选中文字。
23
+ - **增量断链后界面不再停在断点** —— 此前有消息收不上来时,该会话的后续增量全都不上屏,只有重开会话才恢复;现在重建以权威快照收尾,洞与账本两端归零。入口:长会话的对话区。
24
+ - **插件浮层:顶条不占布局,Windows 上不带背景色** —— 顶条浮在画面上,宠物画面顶到窗口边(全平台,多出 28px);Windows 另给零 alpha 底,Win11 不再铺系统材质(仅过单测,未跑实机)。入口:插件浮层。
25
+ - **请求被拒不再说成「服务暂时不可用」** —— 上游指出请求内容有错时,先同模型自动重发一次(零 token),仍被拒就照实说「请求内容不被接受」,不再让你等、也不把账记到通道健康上。入口:报错提示。
26
+
27
+ ### 📐 内部整理
28
+
29
+ - **删掉两条只会白付代价的链** —— 恒失败的 tiktoken 估算分支(估算结果不变)、零消费的 ContextSurface 整链。
30
+ - **遥测口径收紧** —— 工具失败率只数真失败,渠道里没有的模型不再进重试。
31
+ - **测试与门禁** —— 加一条硬编码中文棘轮,冻结 481 处存量;三条 e2e 用例的等待判据分别收紧、放宽到 15 秒、改走真实事件总线。
32
+ - **存储面板打开时的全表扫描** —— 声明式 UI 的外置数据孤儿清扫改走部分索引,此前它会扫全表约 13 秒、期间占住写连接。
33
+
34
+ ## v1.16.1
35
+
36
+ 发布日期:`2026-11-12`
37
+
38
+ > 对比 `v1.16.0` → `v1.16.1`
39
+
40
+ ### ✨ 你会直接感受到的升级
41
+
42
+ - **插件图标真的显示出来了** —— 已装插件按包内的图标显示,插件市场里还没装的条目也有图标;没声明或加载失败就画默认图标,行首不留空档。入口:扩展 → 插件。
43
+ - **授权搬到行上,重做成一个对话框** —— 左边「给谁」右边「给什么」,底栏一句话写清「新增多少 · 跳过多少已有」,一个主按钮「应用 N 条」。跳过数不再在 15 行上重复 15 遍;行上只写短名,搜全名也能命中。入口:扩展 → 插件 → 已装 → 授权…
44
+ - **弹窗的确认与取消不再被内容推出屏幕** —— 技能详情、迁移向导、批量模型确认的出口动作常驻底栏,内容再长也点得到。入口:扩展 → 技能 → 详情;迁移向导与批量模型确认在各自流程里。
45
+ - **存储清理多了一项,也把「释放」说清了** —— 新增「声明式 UI 外置数据」:没被引用的先移入回收区、过了回收期才真正释放;提示分「已释放」「已移入回收区」「两者都有」三种说法,不再一律叫已释放。入口:设置 → 存储管理。
46
+ - **插件能直接开系统的选文件 / 选目录对话框** —— 插件不再只能让用户手打路径;打开、保存、选目录三种都有,仅桌面端。入口:插件里需要选路径的功能。
47
+ - **插件可以自己指定会话 id** —— 重启后能原样接回自己那条线;id 必须以约定前缀开头,已被占用就报错,不覆盖、不复用。
48
+
49
+ ### 🐛 重要修复
50
+
51
+ - **Windows 高 DPI 下插件浮层挪动会越挪越大** —— 125% / 150% 缩放下从 160×178 一路漂到 760×180;现在按缩放选路挪窗,尺寸不再累积漂移(1.25 倍下留 1 DIP 常驻偏差)。仅 Windows。
52
+ - **GPU 崩溃能自愈到能用** —— 10 分钟内第二次 GPU 进程崩溃即落标记:崩溃当刻提示一次,下次启动自动关闭硬件加速;7 天没有新崩溃就自动恢复。崩溃上报也补上了显卡事实。
53
+ - **模型报错时知道是哪一档在说话** —— 失败文案在原文后附「(来自模型 X)」;本地日志落盘上游响应前 2KB、请求字节数与工具名清单,便于指认是哪个字段。
54
+ - **加载失败的插件不再给授权入口** —— 插件跑不起来就没有能力可授予,摆个按钮等于骗人;授权台账读不到时按钮禁用、不印数字,只说算不出来。
55
+ - **授权结果不再虚报** —— 写完几条但有主体没写进去的项保持勾选作为重试入口,行尾照实写「已写 N,未写 M:原因」,回执里的项数与失败数不再超过真正提交过的项数。
56
+
57
+ ### 📐 内部整理
58
+
59
+ - **浏览器扩展与 VS Code 扩展收进同一套依赖** —— 两个 app 的子锁并进根锁,删掉各自的整套依赖副本(telemetry 独立部署,仍保自己的锁);声明的类型包与实际版本差一个大版本这类漂移随之消失。
60
+ - **lint 面扩到全仓** —— 此前 packages、apps、servers、e2e 共 459 个文件从未被检查过;e2e 门禁名单改为从用例首行派生,不再手写 42 条。
61
+ - **测试环境按目录切换** —— 浏览器环境只给渲染层,Node 侧 1187 个文件不再各付一次启动代价,全量测试约 242s → 164s;两个扩展的测试接进推送门禁。
62
+ - **删掉零引用死代码与装了不用的依赖** —— 31 处零引用导出、两个整目录;两个包各自复制的步骤合同(已漂移)下沉为共享包。
63
+
3
64
  ## v1.16.0
4
65
 
5
66
  发布日期:`2026-11-10`