# 更新记录 [返回主页](../README.md) · [使用参考](reference.md) · [配置](configuration.md) · [开发与验证](development.md) 记录源码与发布内容,不将本地构建、npm 发布和本机升级混为同一状态。日期采用 Asia/Hong_Kong。更早历史见 [Git 提交记录](https://github.com/KouzakiUmi/dsh-antigravity-acp/commits/main/)。 ## 0.1.40 · 2026-11-19 - 代理生成流的总响应预算从 8 MiB 提高到 64 MiB,原始响应和解压后数据分别计数。单帧上限仍为 2 MiB;目录、额度等接口及非成功响应仍走原有预算。超限错误显示实际触发的上限。 ## 0.1.39 · 2026-11-19 - 保留 `LlmError.fromFailure` 适配,同时回退到旧宿主的构造函数,避免没有工厂方法时用 `TypeError` 覆盖原始错误。错误码、HTTP 状态、重试时间和错误原因仍沿原路径上报。 - 新增桌面兼容性检查,使用 DSH NEXT 2.0.23-next 分发包内 Core 0.2.2-rc.3 的真实组件验证路由互斥、Typert 注册与清理,不加载桌面 Profile。 - **代理模型与档位**:不再展示上游标记停用的条目或从家族名推断所有档位;使用账户目录确认的档位。失效的默认档位回退到已观测项,显式选择不可用档位时在发送前报错;手动 `target` 仍优先。 - **代理 Schema 和额度**:联合分支只补充主定义中没有的字段;项目探测临时不可用时,使用当前账户已保存的项目读取额度汇总,认证失败仍换发一次。 ### DSH Core 0.2.2 适配 - **peer 范围补 `0.2.2` prerelease 界标**:三个 `dsh-*` peer 改为 `>=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0 <0.3.0-0 || >=0.2.2-0 <0.3.0-0`。修正 0.1.38 里「既有范围本已覆盖 `0.2.2-rc.1`」的错误判断:semver 的 `-0` 界标只放行同一版本组的 prerelease,不外推到更高 patch,实测旧范围拒绝 `0.2.2-rc.1` / `0.2.2-rc.3`(宿主已装 0.2.2-rc.3 时 `npm install` 直接 ERESOLVE);整体放宽为 `>=0.2.0-0 <0.3.0-0` 同样拒绝 `0.2.2-rc.3`,必须单列 `>=0.2.2-0` 段。该范围只约束 npm 安装准入,DSH loader 装载另有宿主条件。 - **开发契约基准对齐 rc.3**:`dsh-llm` / `dsh-attachment` / `dsh-subprocess` / `dsh-typert-protocol` 开发依赖升到 `0.2.2-rc.3`,与实机分发包(app.asar)内嵌版本一致;`dsh-brand` 随 `dsh-attachment` 的 peer 需求一并显式列为开发依赖。Cordis 保持 `4.1.0`。 - **自定义错误码改走 `LlmError.fromFailure`**:rc.3 起 `LlmError` constructor 只接受 `BuiltinLlmFailureCode`(50 个内置码 + `HTTP_${number}`),`AGY_*`、`PROTOCOL_DRIFT`、`CANCELLED` 等 100 处自定义码调用改经新增的 [`src/runtime/llm-error.ts`](../src/runtime/llm-error.ts) `llmError()` 薄封装转发到 `fromFailure`——这是官方为「凭外部码重新抛出」预留的通道,运行时码字符串全部保持不变,用户与日志的排查口径不受影响。内置码(`TRANSPORT`、`AUTH`、`NO_ADAPTER`、`RATE_LIMIT`、`IMAGE_OFFLOAD_REQUIRED` 等)仍走 constructor。读取侧已有 `error.failure.status` 用法不受影响,`.code` / `.message` 由 `HarnessError` / `Error` 基类继续提供。 - **验证**:`npm run typecheck`、`npm test`(47 个文件 / 843 项,并发全量下 2 项 CLI 相关测试偶发 5s 超时、单独重跑通过)、`npm run build`、`npm run check` 通过;模拟宿主已装 `dsh-llm@0.2.2-rc.3` 后 `npm install` 本包打包产物不再 ERESOLVE。未安装到运行中的 Desktop,未做真实账户与 GUI 验收。 - **转发型请求的 `purpose` 放宽**:`dsh-llm` 0.2.2 起 `GenerateOptions.purpose` 由生产者包声明合并(`LlmRequestPurposeMap`)给出;本包不扩展该 map,默认泛型下 `purpose` 退化为 `never`——测试代码无法构造带用途的请求,而生产代码里的用途比较(回合归属、超时、会话亲和、请求重建)在类型层静默失效、失去保护。新增 [`src/adapter/request-options.ts`](../src/adapter/request-options.ts),把入站请求、回合归属判定与准备结果的 `purpose` 统一放宽为 `string`;这是 `dsh-llm` 类型注释明确允许的转发型适配器口径,运行时行为不变。 ## 0.1.38 · 2026-11-12 - **无档位模型不再产出非法元数据**:目录里没有思考强度变体的家族 id 之前返回 `reasoning: { efforts: [] }`,宿主把空数组判为 `INVALID_MODEL_REASONING` 并让该模型完全不可用;现在改为省略 `reasoning`(不支持档位就是不声明菜单)。 - **切回 ACP 一定恢复路由**:模式总线的「上次模式」改为按当前配置初始化。此前「加载时已是代理模式、且代理行缺席」时,第一次关闭 `proxyMode` 会被判成没有变化而吞掉广播,ACP 路由永久停在注销状态。 - **设置卡片只编辑即时字段**:宿主只把 volatile 字段投影进设置文档,也会拒绝 `mutate` 非 volatile 路径;卡片原先把并发、二进制与各段超时渲染成输入框,结果是「显示的不是真值、一改就整批保存失败」。这些普通配置现在只在卡片里列出字段名,并指引到普通配置编辑器(保存后由宿主重载生效)。 - **会话选模短路按会话判定**:`session/set_config_option` 的短路不再用连接级选择器的 `currentValue`(它可能来自别的会话或上一次 `session/new`),新会话省略 `configOptions` 时不会再静默跑在 agent 默认模型上。 - **一次性请求不再占死 worker**:标题生成与压缩这类请求的调用方不会回喂工具结果;这类回合收到工具调用时立即以错误结算(而不是 park 等待一次永远不来的回喂),避免 worker 永久 busy、池位不释放。 - **账户串行与失败语义**:并发取凭据时共享换发不再绑定先到者的 `AbortSignal`(一个请求被取消不再把其他等待者判成未登录);换发失败会在状态里留下可读原因,不再出现「界面已登录、请求说未登录」而没有任何解释。 - **工具结果不再被改写**:历史里出现没有匹配调用的工具结果时明确报错(`INVALID_ARGS`),不再把它当普通用户文本发给上游。 - **错误原因与日志**:上游错误事件(429 / SAFETY / 上下文超限)不再被半截工具调用参数的 `PROTOCOL_DRIFT` 顶掉;代理模式构包失败的异常分类不再一律报成图片准入问题;代理行日志回调补上脱敏。 - **资源回收与缓存自愈**:prompt 构造阶段失败时当场关闭刚建立的 ACP 会话并归还磁盘 claim;同版本二进制缓存损坏时可自愈(清掉损坏目录后重试一次);流式下载中断上报真实原因(不再用 `arrayBuffer()` 二次失败掩盖);凭据原子写的临时名改用 UUID + `'wx'`。 - **ACP 单帧上限**:stdout 的行缓冲此前没有上限,对端吐出一条永不换行的超长行(畸形输出或二进制垃圾)会让内存一路增长;现在按 **64 MiB** 判定协议违规并关闭链路(口径对齐社区 magpie / agy bridge 实现),失败原因保留 `AGY_PROTOCOL_VIOLATION` 而不是笼统的「链接关闭」。 - **工具 schema 的两处上游拒绝形态**:① DSH 的工具参数会带同一 schema 内部的本地引用,原实现把 `$ref` 当未知键丢掉,参数结构退化成空对象;现在按 JSON Pointer(`#/properties/…`)、`$defs` / `definitions` 名字展开,引用节点的 `description` 覆盖被引用节点,解析不到时退化为无字段 object,循环引用由深度上限截断。② 对象节点带**兄弟 union**(`{type:object, properties:{…}, oneOf:[{required:[…]}]}`,只表达字段互斥)时,原实现按类型联合会折叠掉整个对象、丢掉 `properties`,上游随即要求 `input_schema.type: object` 而 400;现在保留对象结构并丢弃该 union。两处口径都来自 magpie 直连实现对同一形态的处理(其 issue #4046/#4561)。 - **上游指纹诊断(只读)**:magpie 生态的实测结论是 Antigravity 会把「请求文本里出现已知客户端指纹」(`x-anthropic-billing-header` 计费行、Claude Code / Agent SDK 身份句、`system-directive`、`RFC 2119` 等)的请求统一伪装成 `429 Resource has been exhausted`,换账号与等额度都无效;而 magpie 本体对 Code Assist 反而**保留**计费行(去掉它是为了别的厂商的前缀缓存命中率),两派做法互斥。本包不选边:代理模式只扫描本轮 system 并在命中时记一条诊断(仅规则 id 与次数),**不改写**任何请求内容;命中指纹时若上游回 429,错误文案会直接说明「可能是被拒绝的提示词指纹而不是额度耗尽」(magpie 对同一现象的态度也是如实告知,而不是让用户追着额度跑)。 - **身份指纹打散(可选,默认关闭)**:新增即时开关 `cloakSensitiveWords`。照 magpie 的实测口径(其 `googleTurnsAway` 词表与 `antigravityCloak` 算法,输出逐字符对齐):命中区间内的 ASCII 词段在首两个字符后各插一个零宽空格,只作用于 system 指令、不改用户消息,去掉零宽即还原原文。属于绕过上游识别,默认关闭。 - **账号被停用不再当作「未授权」**:403 且上游写明 `violation of Terms of Service` / `disabled in this account` 时不再换发登录态重试,直接报 `AGY_ACCOUNT_SUSPENDED` 并说明需要申诉。 - **三路静态审查后的修复**:① 指纹打散改用只降 ASCII 的小写(`toLowerCase` 对 `İ` 这类字符会变长,用降级串的下标切原串会错位,最坏情况是「日志说已打散、文本原样上行」);② 打散与诊断覆盖整条 system 指令(`options.system` 与 `role: system/developer` 的消息——Codex 的身份句正是以后者进来的),且诊断读的是实际发出的文本、不再与打散状态自相矛盾;③ 429 只有在读到的上游原话确实是 `Resource has been exhausted` 时才做指纹归因,其余如实报限流并带上脱敏后的上游原话;④ 账号停用识别覆盖流内 error 事件与刷新后的第二次 403(payload 保留有界的上游 message);⑤ 同版本二进制缓存自愈只在 `EEXIST`/`ENOTEMPTY` 时清目录重试,其余错误带原因抛出;⑥ 代理账户副本的原子写与凭据/缓存/会话映射统一用 UUID 临时名,共享换发的 `finally` 先挂 `catch`(不留无 handler 的 rejection),设置卡片的代理专属开关在 ACP 模式隐藏。 - **DSH 兼容性核对**:对本机实机 **dsh 0.2.2-rc.1 / cordis 4.1.0** 逐个核对运行时导出——`LlmAdapter` 方法集、`registerAdapter().replace([])`、`LlmError`、品牌类型构造函数、`settings.describe/mutate`(含非 volatile 拒绝文案)、`attachments` 服务名与 `readImage` / `requestImageDimensions`、Typert 远程注册形状、客户端 `__ModuleLoader__.load` / `$mount` / `settings.section` 槽位——全部存在且签名一致;`cordis` peer 由 `~4.0.4 || 4.0.5-alpha.x` 放宽为 `>=4.0.4 <5` 以覆盖实机的 4.1.0,并删掉客户端 `inject` 里实机不存在的 `@deepseek-ai/dsh-client-ui-slots`。README 兼容性矩阵新增「实机运行时核对」一行。 - **验证**:类型检查、47 个文件 / 843 项测试、构建通过。未在运行中的 Desktop 上实机验收,也未用真实 Google 账户复检。 ## 0.1.37 · 2026-11-04 - **AI Credits 未开启时整块隐藏**:药丸展开详情与设置页额度面板中,「用 agy CLI 查询额度」未开启(新错误码 `cli-disabled`)时不再渲染 AI Credits 区块,也不显示占位说明文字;开关已开但 CLI 缺失、CLI 不支持或上游无数据仍显示错误信息,便于排查。删除代理模式详情与设置页共用区块底部「套餐额度属于代理账户……」的整段说明。 - **保存栏样式与面板统一**:设置页 sticky 保存操作不再以整块 `--dsh-surface` 底色呈现,改为与其它面板一致的圆角细边框浅底面板,sticky 层仅保留遮滚动内容的表面底色。 - **验证**:类型检查、44 个文件 / 804+ 项测试、构建与离线预览截图生成通过;README 与参考文档版本行同步 0.1.37。保存栏视觉经脏状态离线渲染核验结构,未在运行中的 Desktop 上实机验收。 ## 0.1.36 · 2026-11-04 - **额度查询默认不再调用 agy**:新增即时开关 `cliQuotaEnabled`(默认关闭)。关闭时 ACP 套餐额度走内置 Cloud Code Assist 直连、代理模式走代理账户,两种模式都不 spawn `agy`,AI Credits 不查询。打开并保存后,ACP 模式才运行 `agy -p /usage` 与 `agy -p /credits`;代理模式套餐额度仍用代理账户,只有 AI Credits 调用 `agy -p /credits`。开关翻转后旧额度快照立即失效。 - **设置页精简重排**:分为「连接 / 模型 / 额度 / 高级」,默认只显示当前模式所需的账户与连接操作;删除重复标题,无修改时不显示保存横幅,编辑后仅出现细常驻操作行。模型改为紧凑列表,支持搜索、启停筛选与筛选结果批量启用 / 隐藏;完整 ID、输入能力、显示名和官方映射在单条详情中编辑。高级设置按网络、启动、连接池、超时、会话进程独立展开;所有非活动页仍保留挂载与草稿。 - **模型与账户隔离修复**:ACP 复用会话会识别官方映射 / 默认档位变化并重建;代理目录按账户代际清空,失效后直接重登发布新代际;已有代理账户刷新失败不再静默导入 CLI 的另一账户。 - **额度归因修复**:请求携带期望模式和公开模型,模式不一致时明确拒绝,跨家族映射按实际官方模型选择额度组,迟到模型响应不覆盖新型号。 - **验证**:类型检查、44 个文件 / 804 项测试、构建与离线预览生成通过。未在运行中的 Desktop 上实机验收,也未用真实 Google 账户验证额度来源。 ## 0.1.35 · 2026-11-03 本节与下方 0.1.32–0.1.34 三节的源码改动合并为一次 npm 发布:npm 上从 0.1.31 直接到 0.1.35,0.1.32 / 0.1.33 / 0.1.34 不作为独立版本存在。三节保留为源码演进记录。 - **代理模式彻底停用 ACP**:保存 `proxyMode` 即注销 ACP,不再等待代理路由就绪,也不在代理组件缺席、卸载或注册失败时回退。Host 控制层拒绝 ACP 登录与预热,设置页隐藏 ACP 专属控制项;关闭自动预热时也不再预读官方二进制。 - **完整设置与详情布局**:设置页补齐 ACP 二进制、自动下载、版本、额外参数、并发、排队和各类超时控制,额外参数按行编辑;移除代理排除列表控制项。对话药丸保留原尺寸并只显示额度入口,移除并排预热按钮与 ACP 状态轮询;展开详情按组分隔、额度窗口并排,使用细进度条与紧凑 Credits / 刷新区域。 - **验证**:类型检查、44 个文件 / 792 项测试、构建与离线预览生成通过;未安装到运行中的 Desktop,未重新验收真实账户与 GUI。 ## 0.1.34 · 2026-11-03 - **无 CLI 的 OAuth 闭环**:CLI 登录文件不存在时直接返回 Google 授权入口。使用实际 OAuth 状态机、真实本地 HTTP 回调、模拟 Google 换码和项目响应,验证 PKCE、真实临时存储、模型目录及服务重建。代理登录、目录、套餐额度与聊天不要求安装 agy CLI;AI Credits 仍来自可选 CLI 账户。 - **登录与取消修复**:显示检查登录态、等待浏览器和完成登录阶段;后台取凭据不覆盖在途授权。取消覆盖授权前换发/项目检测和回调后换码/提交,监听关闭不阻塞重试;拒绝、缺码、过期、端口占用、项目和保存失败分别反馈原因。 - **常驻保存栏**:保存、未保存计数、撤销、刷新、冲突与结果集中到顶部,滚动时保持可见。网络草稿需先保存再连接,取消和退出仍可用;窄屏标题可换行,提示文字适配深浅主题。 - **设置页拉取额度**:新增「套餐额度 → 拉取额度」,打开页面不自动查询。与药丸共享读取器,按实际模式和账户隔离结果,旧请求不广播到新账户;代理药丸在设置页关闭时也跟随账户变化。 - **紧凑药丸**:外观交互参考 dsh-subusage 0.23.0(MIT),取数由本插件负责。正常显示迷你余量条,异常增加简短状态,详情增加关闭按钮;修复共享广播导致刷新按钮持续忙碌。 - **验证**:类型检查、44 个文件 / 793 项测试、构建及 36 组离线 Chrome 布局检查通过。真实 Google 授权、上游生成与安装后 Desktop GUI 尚未验收。 ## 0.1.33 · 2026-11-02 - **修复代理模式漏走环境代理**:原生 TLS 之前只读取插件 `proxyUrl`,留空就直连,未继承宿主代理环境。现在 OAuth、项目检测、模型目录、额度与生成统一使用 HTTPS 出网解析:显式配置优先,留空继承 HTTPS / ALL / HTTP 代理;小写变量优先。ACP 既有出网接线保持原状。 - **排除列表生效**:原生 TLS 现在检查 `proxyBypass` / `NO_PROXY`,仅命中目标时绕过出网代理。代理配置或连接失败继续报错。 - **验证**:类型检查、43 个文件 / 772 项测试、构建通过;新增环境代理优先级、OAuth 接线、真实本地 CONNECT 首包及排除列表覆盖。本机无凭据对比:直连约 3.5 秒超时,经本地代理约 170 毫秒收到上游预期的 401;该探针不验证账户授权或模型生成。 ## 0.1.32 · 2026-11-02 新增**代理模式**(默认关闭):bundle 增加第二组件 `antigravity-proxy-router`,开启 `proxyMode` 后模型生成不再经过官方 ACP 进程,而是由插件自持登录态、以 agy CLI 线身份直连 Cloud Code Assist;官方 ACP 路由同时注销,两种模式互斥。 - **模式开关**:`proxyMode`(volatile,默认 `false`)位于设置卡片「运行模式」。保存后仅在代理行取得路由时撤下 ACP;组件缺席、卸载或注册失败时保留 ACP,并解释原因。目录、额度与运行状态统一按实际模式取数,未保存的草稿不冒充已生效模式;代理模式隐藏 ACP 连接与进程操作。 - **OAuth**:代理账户独立于 ACP 登录。连接时先只读导入官方 CLI 登录态(`~/.gemini/antigravity-cli/antigravity-oauth-token`,官方文件保持只读);无可用登录态时启动 PKCE + loopback 回调(`localhost:51121/oauth-callback`,只绑 127.0.0.1,5 分钟 TTL,state 不匹配不消耗在途 flow)。副本落盘 `proxy-account.json`(原子写、尽力 0600),access 过期用 refresh 换发后只写副本。设置页新增「代理账户」面板(连接 / 取消 / 退出、一次性授权 URL)。 - **线伪装**:复用 `@cortexkit/antigravity-auth-core@3.0.14`(与 dsh-tool-antigravity 0.5.2 同版本)的 agy 头序列、chunked 分帧、OAuth 常量、Gemini/Claude 请求变换与模型注册表;本包新增有界 HTTP/1.1 传输(字面请求字节、chunked/gzip 解码、头/体/帧上限、HTTP CONNECT 代理)。端点白名单仅 Cloud Code Assist 五方法与 Google token 端点;SOCKS 代理在代理模式明确报错。与参考实现的差异:不携带 DSH 归属第二头、单账户不轮转 429。 - **额度监控复用**:额度药丸在代理模式改走代理账户的 `loadCodeAssist` + `retrieveUserQuotaSummary`(同一 agy 线传输,401/403 按 `failure.status` 换发一次重试);AI Credits 仍走官方 CLI 只读命令。模式切换失效旧模式额度缓存。药丸在代理模式显示「代理」标记并隐藏 ACP 预热按钮。 - **模型目录**:代理路由目录 = core 审计快照 ∩ `fetchAvailableModels` 实况(30s TTL);刷新失败仅复用同账户已观测目录,无记录则报告错误。模型隐藏、显示名、默认思考档位与映射实际生效,准备与派发使用同一份设置快照。 - **图片输入**:代理模式接受图片(宿主附件服务在场时):`readImageRequest` 有界投影(单图 4MP / 1MB)转 `inlineData`,整请求 12MB 内联预算,超预算按最旧优先报 `IMAGE_OFFLOAD_REQUIRED` 协商 offload;已 offload 的图片投影为占位文本。附件服务缺席时报 `UNSUPPORTED_MODALITY`,文本能力不受影响。输出含图片的型号(图像生成类)仍不在代理路由内。 - **边界**:代理模式不 spawn 官方进程、无 ACP 会话复用概念;`autoWarmup` 在代理模式下不预热 ACP;429 不做多账户轮转。 - **工具与历史回放修正**:无 ID 的并行工具调用分开组装,避免两份 JSON 参数被拼接后整轮失败;文本与思考块在后续分片收到的签名进入 replay 元数据。 - **设置页目录修正**:代理模式的模型读取与手动刷新走代理行的目录服务,强制刷新绕过目录缓存;切换来源时清空旧目录,迟到结果按当前模式重读。目录服务随代理行依赖卸载清理。 - **HTTPS 代理修正**:先与 HTTPS 代理完成 TLS 握手,再发送 CONNECT;省略代理端口时使用 443。HTTP 代理继续使用原有 CONNECT 流程。 - **登录取消与退出修正**:OAuth 回调后仍可取消 token 交换;退出使在途刷新失效,保存与清除按顺序完成,旧请求不能恢复登录。退出后本次插件生命周期内暂停自动导入,显式连接可重新登录。 - **额度切换修正**:模式切换时清除宿主旧额度与药丸旧快照,立即重取;在途旧请求按当前模式补读。代理模型的 `antigravity-` 前缀正常匹配额度组。 - **修复代理账户服务不可用**:Host 将额度与账户描述符合并为一次 Typert contribution,Client 合并为一次 `$mount`。当前桌面分发包的注册器拒绝同包重复身份;此前第二次注册或挂载会失败。 - **连接闭环修复**:导入后验证/刷新凭据,并沿用参考插件的只读 Cloud Code Assist 项目检测;未返回项目时明确报错,失效登录态允许重新 OAuth。登录完成与退出自动更新模型,状态轮询反映授权失败或过期,授权链接只从显式登录返回。 - **取消与账户隔离修复**:取消/退出抢占在途登录;存储加载单飞并隔离迟到结果,已开始保存的取消提交不残留。删除失败不再报告成功。目录和套餐额度绑定账户代际,同模式重新登录不会展示前账户数据。 - **生成与传输修复**:兼容 Google SSE 错误字段,401/403 首块前换发一次,工具调用配合 `STOP` 正确进入续轮;保留长思考签名与 developer 指令。未完成就断开的响应报错,HTTP chunk 增量解码并校验截断;图片能力与实际附件服务、发送尺寸一致。 - **验证边界**:本地类型检查、**43 个文件 / 766 项隔离测试**与构建通过。覆盖代理账户、设置交互、模型路由、工具续轮、图片、HTTP/SSE、跨账户缓存与模式回退;另使用当前桌面分发包的真实 Core 0.2.1-rc.5 / Cordis 4.0.5 / Typert 依赖验证构建产物加载、单次贡献注册、代理路由及卸载清理。真实 Google 授权、上游生成与 Desktop GUI 未重新验收。 ## 0.1.31 · 2026-10-30 一轮可靠性加固,均为既有行为的缺陷修正,不改变对外配置字段与协议契约。 - **额度取数不再可能永久卡住**:HTTP 回退的换发与 Cloud Code Assist 请求此前没有超时。并发刷新会合并到同一个在途 promise 上,一次挂起的请求就让额度药丸永远停在「读取中」,手动刷新也救不回来。现在各有 20 秒上限,超时折叠成可读的失败快照并释放在途状态。 - **401/403 重试改按状态码判断**:此前靠匹配错误文案里的 `HTTP 401` 字符串,文案一改就静默丢掉「换发后再试一次」。`QuotaError` 现在携带 `status`,判断只看状态码;非 401/403 的失败不再触发无谓换发。 - **非法代理不再让插件装载失败**:此前 apply 一开始就同步解析 `proxyUrl`,保存了非法地址后重启宿主,插件加载即失败——而修正它的设置卡片正是本插件贡献的,用户只能手改配置文件。现在装载期只告警并继续加载,真正用到代理时各自失败(启动 ACP 报 `AGY_INVALID_PROXY`)。 - **运行期代理地址变坏按 Promise 拒绝**:插件自身的 `fetch` 与 CLI 取数入口此前会在同步阶段抛错,调用方的 `.catch()` 收不到。现按各自契约返回 rejected promise,由既有的「折叠成可读错误」路径处理。 - **恢复会话失败时归还磁盘 claim**:认领会话映射后若启动失败,所有权会残留到卸载。新增 `SessionMapStore.unclaim`,恢复与建轮两条失败路径都归还,别的 worker 可立即接管仍有效的条目。 - **单条畸形 JSON-RPC 帧不再判死整条链路**:无法路由的消息此前抛 `PROTOCOL_VIOLATION`,被消息泵当成流读取失败,链路关闭、对外报 `LINK_CLOSED`,所有在途请求一起失败。现在只丢弃该帧并留痕,链路与在途请求不受影响。带 id 却缺 `result`/`error` 的畸形响应单独处理:命中在途请求时立即按 `AGY_PROTOCOL_VIOLATION` 拒绝它,而不是丢弃后让那个请求白等到超时。 - **中止错误码统一**:连接池的 `AGY_TURN_ABORTED` 改为与适配器、协议层一致的 `AGY_ABORTED`。两者同属 `AGY_` 前缀,原本就不会命中宿主的重试词表,此处只消除排障时的语义分叉。 - **zip 解压加压缩炸弹上限**:条目数、单条目与解压总量三道守卫,并在写盘前判定。中央目录谎报解压大小的包由 yauzl 的大小校验拦下(构造用例已覆盖);另按实际流出字节数加了兜底,用于该校验被关闭或换实现时的纵深防御。官方包远低于上限。 - **细节修正**:OAuth client 元数据多份并存时按出现顺序配对(此前固定取第一个 secret,可能与所选 client id 不配套),同一 secret 重复出现时也不会配错;MCP 桥 Bearer 头改常数时间比较;`parseTokenState` 去掉重复查询;额度超时文案在不足 1 秒时报毫秒,不再显示「超过 0 秒」。 - **验证边界**:本地类型检查、38 个文件 / 658 项隔离测试与构建通过。真实 Desktop GUI、官方账号与非 Windows 实机未重新验收;未用真实官方 zip 或真实对端造过异常输入,畸形帧与解压上限均由构造用例覆盖。 ## 0.1.30 · 2026-10-27 - **移除「默认模型」**:设置页不再维护一个「新对话优先使用」的模型 ID。DSH 自带模型选择器负责选模,插件侧再存一份只会与它冲突;`preferredModel` 字段及旧 `server-default` 映射一并删除。 - **模型列表设置**:设置页按模型逐项设置——是否出现在 DSH 模型选择器、默认思考档位(低 / 中 / 高 / 跟随官方)、显示名覆盖、映射到官方模型 ID。改动合并成一份 `modelOverrides` 保存,清空的项自动移除,不留空壳配置。 - **生效路径**:停用只影响选择器,不删除目录条目;映射目标原样写入 ACP 会话,优先于家族 + 档位路由;默认档位在未选择思考强度时生效,官方未声明该档位时退回官方默认。保存后立即通知宿主刷新目录。 - **验证边界**:本地类型检查、38 个文件 / 639 项隔离测试与构建通过;覆盖逐模型设置的草稿合并、只提交改动项、目录变化与只读状态,以及映射与档位路由。真实 Desktop GUI 与官方账号未重新验收。 ## 0.1.29 · 2026-10-26 - **恢复设置编辑与保存**:将设置卡片的 10 个字段声明为宿主可编辑的即时配置,修复默认模型、代理、会话开关和计时字段被统一禁用的问题;配置文档缺失时显示原因和恢复提示,而非静默禁用。 - **配置实际生效**:默认模型更新通知宿主选择器;CLI 路径及插件请求代理随下一次操作读取,会话偏好在下一轮聊天、预热或目录发现时捕获,不替换正在输出或等待工具的回合配置。旧代理连接保留到卸载时统一清理,避免打断在途响应。 - **生效边界**:自动预热开关在下次启用插件时生效;已有 ACP 进程保留原启动环境,切换其代理仍需重新加载插件。普通启动与并发配置继续遵循宿主重载流程。 - **验证边界**:本地类型检查、37 个文件 / 625 项隔离测试与构建通过;覆盖真实 React renderer 的控件编辑、保存回读、只读和配置恢复,以及即时引用、偏好更新与代理生命周期。真实 Desktop GUI、官方账号及非 Windows 实机未重新验收;npm 发布不代表本机安装已更新。 ## 0.1.28 · 2026-10-25 - **功能可靠性**:手动预热 / 目录刷新可从一次暂时回收故障中恢复,持续失败仍拒绝复用旧进程;后续会话省略模型配置时保留已知目录,worker 间模型名称、输入模态与实测上下文元数据一致,默认思考档位不指向不存在的选项。 - **额度读取**:校验 `/usage` 成功信封;统一双路缓存时间戳并修正强制刷新与部分刷新交错时的合并,避免多余 CLI 查询。客户端刷新失败保留成功快照并标缓存,Argon 无独立额度组时回落到 Gemini 共享组。 - **设置页体验**:连接、默认模型、常用偏好分区,高级选项与连接诊断按需展开;移除重复的额度 / Credits 模块及其设置页后台读取,保留药丸详情与全部配置能力、草稿冲突保护。 - **验证边界**:本地类型检查、36 个文件 / 617 项隔离测试与构建通过;源码构建不代表已发布或本机安装已更新,真实 Desktop GUI 与官方账号仍需单独验收。 ## 0.1.27 · 2026-10-23 - **恢复模型选择**:`session/set_config_option` 成功后不再要求服务端回显 ID 与请求逐字一致;允许模型 ID 归一化,响应缺少模型配置时保留已知目录。RPC 本身失败仍正常报错。 - **模型拉取可用性**:手动拉取优先于后台目录通知,立即显示进度并保留失败原因;ACP 发现沿用排队、握手与会话请求各阶段超时,不再被客户端 60 秒或普通请求预算提前截断。 - **避免无谓冷启动**:预热、目录发现与能力准备复用已有空闲 worker;聊天会话粘性不再导致这些操作额外扩容。 - **权限提示与执行分离**:已识别私有桥请求不因展示分类、提示参数缺失或包装差异被额外拒绝;实际调用仍通过 MCP 桥交给 DSH 校验、审批和执行。原生能力请求仍逐次拒绝并记录,但不因累计次数终止整轮对话。 - **余额解析**:保留成功状态、命令和有效金额校验,移除无关的 `num_turns=0` 要求。 - **验证边界**:本地类型检查、36 个文件 / 603 项隔离测试与构建通过;发布不代表本机已升级,真实官方服务与 Desktop GUI 仍需单独验收。 ## 0.1.26 · 2026-10-23 - **消息一致性**:同一 DSH 对话可增量复用 ACP 会话;在交付 `finish` 前提交输入与输出指纹,调用方立即结束读取也不会重发旧问题。编辑回答、外部模型输出或历史/路由变化时完整重建;去重后没有可发送增量也回退完整重建,不发空 prompt。 - **上下文去重**:仅省略已见且未变化的上下文,不再按 form 整类丢弃;新规则、变化快照、目录更新与状态回滚继续发送。 - **取消排空**:可选保留进程,但必须先取得正常停止应答;新轮不能撤销宽限。本地超时/运输错误仍回收。`cancelGraceMs=0` 的语义调整为不等待、立即回收,而非保留未确认连接。 - **统一空闲回收**:聊天、预热和目录发现均纳入计时;活动请求、工具 park 与取消排空不算空闲。一次性标题/压缩/发现会话结束后关闭;内存复用记录最多 64 条。 - **恢复映射 v2**:共享存储管理 worker 所有权与串行写入,只落盘 ID、计数和指纹;旧格式安全失效。正常空闲回收保留有效映射,恢复后校正并核对模型;选模响应不完整时安全失败但保留上一份有效目录。load 拒绝、超时或取消先清理旧连接,避免迟到回放混入新轮。 - **跨 Host 隔离**:恢复缓存使用排他租约,占用时仅降级磁盘恢复,不影响聊天。崩溃残留锁不自动抢占,确认相关 Host 退出后再处理。 - **设置与文档**:设置卡增加复用、恢复、取消保留与两个计时字段;数值校验和只提交修改项的行为一致。修正采样参数、token 轮换及缓存 TTL 的旧描述;5 分钟是插件资源策略,不是上游 TTL 保证。 - **验证边界**:补齐 finish 即 return、输出改写/外部模型、上下文变化、取消/空闲竞态、恢复失败/工具桥/选模、文件格式与共享所有权回归;本地 `npm run check` 通过(36 个文件 / 591 项)。发布不代表本机升级,真实上游与 Desktop GUI 仍需单独验收。 ## 0.1.25 · 2026-10-22 - **修复登录 / 预热超时**:新增 `handshakeTimeoutMs`(默认 120 秒),取代写死的 15 秒握手上限。官方进程需解包 218MB 单文件并导入 Python 依赖,冷启动约 52 秒、热启动约 10 秒。 - **默认预热**:`autoWarmup` 默认改为 `true`,插件启用即后台启动并保留官方进程;关闭时改为预读官方 exe 以缓解冷启动。 - **启动进度提示**:连接中状态行显示阶段、已用时间,以及冷启动可能约需 1 分钟的提示。 ## 0.1.24 · 2026-10-22 ### 日常使用 - **有界并发池**:默认最多 2 个按需启动的独立 worker,可设 1–4;同会话工具结果回原 worker。等待队列最多 64 项,默认 120 秒,支持取消;主对话优先于排队中的后台标题。 - **先登录再取模型**:「连接 / 登录 ACP」建立不发送 prompt 的发现会话,验证连接并读取目录。无 CLI 时也可从已有 ACP 登录态刷新;目录、上下文容量与图片能力跨 worker 同步。 - **原生图片输入**:通过宿主附件服务发送当前 / 历史消息与工具结果中的图片,协商上游能力,校验引用、媒体类型与字节数。支持 PNG、JPEG、WebP、GIF;已卸载图片明确说明没有像素。 - **可观测连接**:区分预热、登录、建会话、生成、等待工具与停止;设置页显示队列与分阶段耗时,药丸可直接预热。 - **更可靠的设置草稿**:远端更新保留 dirty 字段,仅提交修改项,显示冲突,遵守只读状态并防重复保存。 ### 工具与可靠性 - 续轮检查模型、思考强度、system、工具 schema、完整历史与上轮输出;不兼容时取消旧 prompt 并按新历史重建。 - MCP 参数按 schema 修正常见无歧义别名;缺必填字段返回 `AGY_BRIDGE_INVALID_ARGUMENTS` 与签名,不进入 DSH。类型与取值仍由 DSH 最终校验。 - stdin 写入与响应等待共享 deadline / abort;阻塞写入、缺管道、构造失败与握手失败进入统一回收路径。 - 验证 ACP v1 版本与所需 MCP / image 能力;未声明能力不当作支持。 - 取消与失败撤销桥授权;通过宿主受管进程终止并等待退出,不能确认退出时不允许新进程覆盖跟踪状态。 ### 运行与网络加固 - 下载流写临时文件,限制来源与重定向,校验 ZIP 路径与布局;保留手动二进制优先级。 - 补齐 macOS / ARM64 / POSIX `.par` 与 Linux 参数的官方发行布局映射;默认 server 仍为 **1.4.0**,不自动追最新。 - onefile 运行代码迁至用户级独立 `runtime/instance-*`,记录所有权,只清理确认已退出的本插件目录;未知历史目录不按 mtime 删除。 - 直接声明 `undici` 依赖,统一下载、OAuth 与 HTTP 额度代理;显式代理失败不静默直连,关闭插件持有的连接池。 - 补齐结构化 token、无 scheme 代理材料和错误日志的脱敏;CLI 路径支持显式配置、PATH 与重新探测。 ### 文档 - 主页采用快速开始、功能亮点、能力边界与验证矩阵分层,详细契约移至 `docs/`。 - 补齐完整配置、环境变量、安装 / 更新区别、登录材料读写范围、排障与维护发布流程。 - 明确 npm 发布不代表本机安装;不提供不存在的 GitHub Release 下载入口,不把示意或隔离测试当成真实 GUI 证据。 ### 验证与剩余限制 本次本地 `npm run check` 通过:**33 个测试文件、515 项测试、TypeScript 类型检查与构建**。覆盖假 ACP / MCP、真实 React 18 renderer 交互、池与续轮、图片映射、阻塞写入、安全回收和本地 SOCKS 代理测试。React renderer 不是浏览器像素验收;假上游不证明真实 Google 服务兼容。 已知维护缺口(记录 0.1.25 当时的状态):非法代理在插件装载期抛 `ProxyConfigError`,需要通过宿主通用配置面修复——**该条已在 0.1.31 解除**,现在装载期只告警;宿主崩溃、没有明确子进程退出记录的运行目录不会自动回收;已有解压目录损坏且缺少有效可执行文件时不保证自动自愈。其余限制见[排障](reference.md#排障)。 尚未完成 **0.1.24 安装后的 Desktop GUI、真实上游生成、真实图片识别、非 Windows 实机验证**。未在本次执行真实登录 / 额度 / Credits 调用,未将历史记录升级为当前版验收。生产依赖漏洞审计不由上述检查覆盖。 普通新用户回合仍创建 ACP session 并重放完整历史;不提供跨进程会话恢复,不承诺 API 式角色层级、采样控制或延迟。`maxTokens` 仍忽略,`temperature` / `stop` 仍拒绝。ACP 原生工具保护仍是协议与生命周期约束,**不是 OS 沙箱**。 ### 升级注意 - 更新后按部署方式重载 Host 与 Client;Desktop 按目标版本要求退出 / 重开。只刷新页面不足以升级后台。 - 默认双 worker 比单进程可能占用更多内存;资源受限时设置 `maxConcurrentSessions: 1`。池容量不提升上游账号额度。 - 无目录时先连接 / 登录,不再依赖“首次对话登录”占位项;旧 `server-default` 路由保留兼容。 - CLI 额度与 ACP 连接认证分别检查;ACP 登录不替 CLI 登录。已有缓存不代表上游持续可用。 - 不为迁移批量删除旧 `_MEI*` 或修改 ACL;先确认所属进程已停,再人工处理未知历史目录。 ## 0.1.23 · 2026-10-22 - 版本由 [`1d81265`](https://github.com/KouzakiUmi/dsh-antigravity-acp/commit/1d81265) 发布准备提交确定。 - 前置 [`d4c6e91`](https://github.com/KouzakiUmi/dsh-antigravity-acp/commit/d4c6e91) 补充 npm provenance 所需仓库声明,前置 [`8b81df5`](https://github.com/KouzakiUmi/dsh-antigravity-acp/commit/8b81df5) 修复跨平台发布 CI。 - 保留既有 GitHub Actions 手动发布到 npm 的流程;后续功能加固归入 0.1.24,不追溯写入旧 npm 版本。