dsh-bundle-antigravity-acp 0.0.0-stage → 0.1.39

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 (118) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +60 -2
  3. package/README.upstream.md +184 -0
  4. package/cordis.patch.yml +5 -0
  5. package/dist/accounts/manager.d.ts +92 -0
  6. package/dist/accounts/manager.js +436 -0
  7. package/dist/accounts/manager.js.map +1 -0
  8. package/dist/accounts/oauth.d.ts +82 -0
  9. package/dist/accounts/oauth.js +273 -0
  10. package/dist/accounts/oauth.js.map +1 -0
  11. package/dist/accounts/paths.d.ts +14 -0
  12. package/dist/accounts/paths.js +25 -0
  13. package/dist/accounts/paths.js.map +1 -0
  14. package/dist/accounts/store.d.ts +23 -0
  15. package/dist/accounts/store.js +152 -0
  16. package/dist/accounts/store.js.map +1 -0
  17. package/dist/accounts/types.d.ts +76 -0
  18. package/dist/accounts/types.js +15 -0
  19. package/dist/accounts/types.js.map +1 -0
  20. package/dist/adapter/antigravity-adapter.d.ts +216 -0
  21. package/dist/adapter/antigravity-adapter.js +1709 -0
  22. package/dist/adapter/antigravity-adapter.js.map +1 -0
  23. package/dist/adapter/continuation-state.d.ts +12 -0
  24. package/dist/adapter/continuation-state.js +46 -0
  25. package/dist/adapter/continuation-state.js.map +1 -0
  26. package/dist/adapter/image-content.d.ts +20 -0
  27. package/dist/adapter/image-content.js +92 -0
  28. package/dist/adapter/image-content.js.map +1 -0
  29. package/dist/adapter/model-catalog.d.ts +44 -0
  30. package/dist/adapter/model-catalog.js +66 -0
  31. package/dist/adapter/model-catalog.js.map +1 -0
  32. package/dist/adapter/model-settings.d.ts +48 -0
  33. package/dist/adapter/model-settings.js +74 -0
  34. package/dist/adapter/model-settings.js.map +1 -0
  35. package/dist/adapter/permission-diagnostic.d.ts +36 -0
  36. package/dist/adapter/permission-diagnostic.js +55 -0
  37. package/dist/adapter/permission-diagnostic.js.map +1 -0
  38. package/dist/adapter/permission-handoff.d.ts +15 -0
  39. package/dist/adapter/permission-handoff.js +36 -0
  40. package/dist/adapter/permission-handoff.js.map +1 -0
  41. package/dist/adapter/prompt-transcript.d.ts +92 -0
  42. package/dist/adapter/prompt-transcript.js +210 -0
  43. package/dist/adapter/prompt-transcript.js.map +1 -0
  44. package/dist/adapter/prompt-turn.d.ts +151 -0
  45. package/dist/adapter/prompt-turn.js +564 -0
  46. package/dist/adapter/prompt-turn.js.map +1 -0
  47. package/dist/adapter/session-reuse.d.ts +22 -0
  48. package/dist/adapter/session-reuse.js +104 -0
  49. package/dist/adapter/session-reuse.js.map +1 -0
  50. package/dist/adapter/tool-args.d.ts +39 -0
  51. package/dist/adapter/tool-args.js +113 -0
  52. package/dist/adapter/tool-args.js.map +1 -0
  53. package/dist/bridge/mcp-bridge.d.ts +125 -0
  54. package/dist/bridge/mcp-bridge.js +425 -0
  55. package/dist/bridge/mcp-bridge.js.map +1 -0
  56. package/dist/client.js +1279 -0
  57. package/dist/index.d.ts +116 -0
  58. package/dist/index.js +756 -0
  59. package/dist/index.js.map +1 -0
  60. package/dist/pool/pooled-adapter.d.ts +58 -0
  61. package/dist/pool/pooled-adapter.js +353 -0
  62. package/dist/pool/pooled-adapter.js.map +1 -0
  63. package/dist/protocol/agent-link.d.ts +205 -0
  64. package/dist/protocol/agent-link.js +635 -0
  65. package/dist/protocol/agent-link.js.map +1 -0
  66. package/dist/quota/control.d.ts +55 -0
  67. package/dist/quota/control.js +82 -0
  68. package/dist/quota/control.js.map +1 -0
  69. package/dist/quota/quota-remote.d.ts +109 -0
  70. package/dist/quota/quota-remote.js +351 -0
  71. package/dist/quota/quota-remote.js.map +1 -0
  72. package/dist/runtime/agy-cli.d.ts +118 -0
  73. package/dist/runtime/agy-cli.js +352 -0
  74. package/dist/runtime/agy-cli.js.map +1 -0
  75. package/dist/runtime/binary.d.ts +266 -0
  76. package/dist/runtime/binary.js +707 -0
  77. package/dist/runtime/binary.js.map +1 -0
  78. package/dist/runtime/catalog-cache.d.ts +26 -0
  79. package/dist/runtime/catalog-cache.js +88 -0
  80. package/dist/runtime/catalog-cache.js.map +1 -0
  81. package/dist/runtime/credentials.d.ts +98 -0
  82. package/dist/runtime/credentials.js +373 -0
  83. package/dist/runtime/credentials.js.map +1 -0
  84. package/dist/runtime/credits.d.ts +5 -0
  85. package/dist/runtime/credits.js +54 -0
  86. package/dist/runtime/credits.js.map +1 -0
  87. package/dist/runtime/integrity.d.ts +53 -0
  88. package/dist/runtime/integrity.js +76 -0
  89. package/dist/runtime/integrity.js.map +1 -0
  90. package/dist/runtime/isolated-home.d.ts +1 -0
  91. package/dist/runtime/isolated-home.js +34 -0
  92. package/dist/runtime/isolated-home.js.map +1 -0
  93. package/dist/runtime/lifecycle.d.ts +68 -0
  94. package/dist/runtime/lifecycle.js +147 -0
  95. package/dist/runtime/lifecycle.js.map +1 -0
  96. package/dist/runtime/proxied-fetch.d.ts +44 -0
  97. package/dist/runtime/proxied-fetch.js +165 -0
  98. package/dist/runtime/proxied-fetch.js.map +1 -0
  99. package/dist/runtime/proxy-env.d.ts +67 -0
  100. package/dist/runtime/proxy-env.js +153 -0
  101. package/dist/runtime/proxy-env.js.map +1 -0
  102. package/dist/runtime/quota.d.ts +147 -0
  103. package/dist/runtime/quota.js +457 -0
  104. package/dist/runtime/quota.js.map +1 -0
  105. package/dist/runtime/redact.d.ts +28 -0
  106. package/dist/runtime/redact.js +71 -0
  107. package/dist/runtime/redact.js.map +1 -0
  108. package/dist/runtime/session-map.d.ts +60 -0
  109. package/dist/runtime/session-map.js +224 -0
  110. package/dist/runtime/session-map.js.map +1 -0
  111. package/dist/settings.d.ts +148 -0
  112. package/dist/settings.js +71 -0
  113. package/dist/settings.js.map +1 -0
  114. package/docs/changelog.md +215 -0
  115. package/docs/configuration.md +120 -0
  116. package/docs/development.md +143 -0
  117. package/docs/reference.md +225 -0
  118. package/package.json +87 -4
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-bundle-antigravity-acp contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,61 @@
1
- # Temporary Holding Version
1
+ # dsh-antigravity-acp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ [![Publish package](https://github.com/AlaIchhe/dsh-antigravity-acp/actions/workflows/publish.yml/badge.svg)](https://github.com/AlaIchhe/dsh-antigravity-acp/actions/workflows/publish.yml)
4
+
5
+ 在 [DeepSeek Harness](https://github.com/deepseek-ai/dsh) 里接入 Google 官方 **Antigravity ACP agent**:
6
+ 用 DSH 的界面选模型、发任务,工具调用仍由 DSH 审批和执行。
7
+
8
+ > 基于 [KouzakiUmi/dsh-antigravity-acp](https://github.com/KouzakiUmi/dsh-antigravity-acp)(MIT)的独立分支,
9
+ > 2026-11-17 起由 `AlaIchhe` 维护。上游原文见 [README.upstream.md](./README.upstream.md);
10
+ > 原作者如认为本分支不妥,提 [issue](https://github.com/AlaIchhe/dsh-antigravity-acp/issues) 即可,我会归档该仓库。
11
+
12
+ ## 功能
13
+
14
+ - **官方 agent,不是转发 API**:走 ACP 协议驱动官方 `agy` 二进制,账号、额度、模型目录都来自官方
15
+ - **工具留在 DSH**:agent 的工具调用经私有 MCP 桥回到 DSH,由 DSH 校验、审批、执行
16
+ - **模型选择器直连**:Gemini 4 Argon / Hydrogen、Claude Opus 5.5、Sonnet 5.5 等家族一行,思考强度由 DSH 菜单路由
17
+ - **多账号**:设置页里直接浏览器登录多个 Antigravity 账号,各自隔离 HOME;一键切换当前账号,额度按账号查看
18
+ - **额度可见**:按额度组显示窗口、剩余百分比与重置时间
19
+
20
+ ## 安装
21
+
22
+ ```bash
23
+ # 从 GitHub 安装
24
+ dsh plugin --profile <profile> add github:AlaIchhe/dsh-antigravity-acp
25
+ # 或从 npm 安装(包名与上游不同,见 docs/reference.md)
26
+ dsh plugin --profile <profile> add dsh-bundle-antigravity-acp
27
+ ```
28
+
29
+ 安装后重载 DSH 服务,在「设置 → Antigravity ACP」里点 **连接 / 登录 ACP** 完成授权。
30
+
31
+ ## 使用
32
+
33
+ 1. **登录**:设置页 →「账号」→「添加账号」,在浏览器里完成 Google 授权即可;也可以直接使用本机官方 CLI 的登录态(系统账号)。多账号之间互不覆盖,点「使用此账号」切换当前账号。
34
+ 2. **选模型**:对话里打开模型选择器,选 `Antigravity (ACP)` 下的模型家族。
35
+ 3. **调强度**:模型家族的思考强度在 DSH 的思考强度菜单里选,插件自动路由到官方档位。
36
+ 4. **看额度**:每个账号卡片里点「拉取额度」,或直接看输入框旁的额度药丸(跟随当前账号)。
37
+
38
+ 配置项、边界与排障见 [docs/reference.md](docs/reference.md) 与 [docs/configuration.md](docs/configuration.md)。
39
+
40
+ ## 本分支的改动
41
+
42
+ 只修了两处上游行为问题,其余与上游一致:
43
+
44
+ | 问题 | 处理 |
45
+ |---|---|
46
+ | 官方 1.5.x 给 Hydrogen 加了 `-xhigh` 档,上游正则不认,被折叠成独立家族 | 识别 `xhigh` 用于折叠,但不加进档位表(避免选中即 `UNSUPPORTED_REASONING_EFFORT`) |
47
+ | 上下文占用锚点缺失,投影只增不减,一直显示 100% | 用 `usage_update.used` 作为回合用量样本兜底 |
48
+
49
+ 详见 [CHANGELOG](docs/changelog.md)。
50
+
51
+ ## 开发
52
+
53
+ ```bash
54
+ npm ci
55
+ npx tsc --noEmit # 类型检查
56
+ npx vitest run # 47 个文件 / 846 项测试
57
+ ```
58
+
59
+ ## 许可
60
+
61
+ MIT,与上游一致。版权归 `dsh-bundle-antigravity-acp contributors`;本分支的修改同样以 MIT 发布。
@@ -0,0 +1,184 @@
1
+ <div align="center">
2
+
3
+ > **这是 `AlaIchhe/dsh-antigravity-acp` 的二次开源 fork**(上游:`KouzakiUmi/dsh-antigravity-acp`)。
4
+ > 差异见文末「本 fork 的改动」。许可证沿用上游 MIT。
5
+
6
+ # Antigravity ACP for DSH
7
+
8
+ **在 DSH 里使用 Antigravity 模型,工具仍交给 DSH。**
9
+
10
+ 接入 Google 官方 Antigravity ACP agent,在同一个对话界面选择模型、查看额度、预热连接。
11
+
12
+ [![npm](https://img.shields.io/npm/v/dsh-bundle-antigravity-host?color=3b82f6&label=npm)](https://www.npmjs.com/package/dsh-bundle-antigravity-host)
13
+ [![license](https://img.shields.io/badge/license-MIT-64748b)](LICENSE)
14
+ [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A522.19-64748b)](#兼容性与验证范围)
15
+
16
+ [快速开始](#快速开始) · [功能预览](#功能预览) · [功能亮点](#功能亮点) · [配置参考](docs/configuration.md) · [排障](docs/reference.md#排障) · [更新记录](docs/changelog.md)
17
+
18
+ <img src="https://raw.githubusercontent.com/KouzakiUmi/dsh-antigravity-acp/main/assets/banner.svg" width="1200" alt="Antigravity ACP for DSH:官方 Antigravity agent 经 ACP 与私有 loopback 桥相连,工具调用交给 DSH 校验、审批与执行,结果回填 agent(示意图)">
19
+
20
+ </div>
21
+
22
+ ---
23
+
24
+ > **0.1.38 · 修复档位元数据、模式回切与设置卡片**:没有思考档位变体的模型不再返回空 `reasoning.efforts`(宿主会判为非法元数据并使模型不可用);代理组件缺席时关闭 `proxyMode` 会真正恢复 ACP 路由;设置卡片不再渲染宿主拒绝写入的普通配置(并发 / 二进制 / 超时),改为指引到普通配置编辑器;会话选模短路、一次性请求占死 worker、工具结果与错误原因等逻辑一并修复;代理模式按 magpie 直连实现的实测口径修复工具 schema(本地 `$ref` 展开、对象兄弟 union、`items`/`properties` 优先于推断类型、空枚举值)并新增上游身份指纹诊断与可选打散、账号被停用识别,ACP 侧加了 64 MiB 单帧上限。类型检查、**47 个文件 / 843 项测试**与构建通过。[查看更新与限制](docs/changelog.md#0138--2026-11-12)
25
+
26
+ > **0.1.36 · 紧凑设置与账户隔离**:设置页改为连接 / 模型 / 额度 / 高级分页,无修改时隐藏保存横幅;模型使用紧凑列表,支持搜索、筛选、批量启停与完整详情。修复 ACP 复用会话沿用旧映射、代理目录跨账户残留、刷新失败误换 CLI 账户及额度来源错配。类型检查、**44 个文件 / 804 项测试**与构建通过。[查看更新与限制](docs/changelog.md#0136--2026-11-04)
27
+
28
+ > **0.1.25**:修复冷启动时登录 / 预热握手超时(新增 `handshakeTimeoutMs`,默认 120 秒),默认开启预热并显示启动进度。类型检查、**33 个文件 / 515 项测试**与构建通过;真实 Desktop GUI 与跨平台验收尚未完成。[查看本次更新与限制](docs/changelog.md#0125--2026-10-22)。上一版 0.1.24 的并发池、模型发现与图片输入见[更新记录](docs/changelog.md#0124--2026-10-22)。
29
+
30
+ > **0.1.31 · 一轮可靠性加固**:额度 HTTP 取数补超时(挂起的请求不再让药丸永久停在读取中)、401/403 重试改按状态码判断、非法代理不再让插件装载失败、恢复会话失败归还磁盘 claim、单条畸形 JSON-RPC 帧只丢弃不再判死整条链路、zip 解压加压缩炸弹上限。本地类型检查、**38 个文件 / 658 项测试**与构建通过。发布不代表本机安装已更新。[查看更新与生效边界](docs/changelog.md#0131--2026-10-30)
31
+
32
+ > **0.1.35 · 代理模式与完整设置**:保存 `proxyMode` 即注销 ACP,不再因代理组件缺席或注册失败回退官方进程;设置页补齐启动、并发、排队与各类超时控制,保存栏随滚动常驻顶部,对话药丸保留原尺寸且只留一个额度入口。本版本与 0.1.32–0.1.34 合并发布(npm 从 0.1.31 直达 0.1.35)。类型检查、**44 个文件 / 792 项隔离测试**与构建通过;真实账户与安装后的 GUI 尚待验收。[查看更新与生效边界](docs/changelog.md#0135--2026-11-03)
33
+
34
+ ## 快速开始
35
+
36
+ ```console
37
+ dsh plugin --profile web add dsh-bundle-antigravity-host
38
+ ```
39
+
40
+ `web` 是示例 Profile,请替换为实际目标。**DSH NEXT Desktop 使用目标桌面壳提供的 DSH Desktop CLI**;不要用独立 npm 公共 CLI 管理保留的 `desktop` Profile。[安装与更新说明](docs/reference.md#安装与更新)
41
+
42
+ 1. **安装并启用**:按部署方式重载或重启,让 Host 与 Client 一起生效;只刷新页面不保证 Host 已升级。
43
+ 2. **打开「设置 → Antigravity ACP」**:需要代理时先配置并保存,再点击 **连接 / 登录 ACP**。插件优先复用已有 ACP 登录态,或导入本机已登录的官方 CLI 登录态;必要时才进入官方浏览器授权。成功建会话后读取模型目录,不需要先发送聊天。
44
+ 3. **选择模型,开始对话**:提供商名称为 **Antigravity (ACP)**,路由 ID 为 `antigravity-acp`。模型选择器左侧出现紧凑额度药丸;预热入口位于设置页,工具调用继续走 DSH 的校验、审批与执行。
45
+
46
+ 使用代理模式时,启用插件页的 `antigravity-proxy-router` 组件,在设置页「运行模式」勾选并保存,再点击「连接代理账户 → 打开 Google 授权页」。**无需安装 agy CLI**,在运行 DSH 的同一台电脑上授权,账户和已有项目检测通过后自动读取模型,选择 **Antigravity(代理模式)** 的模型开始对话。组件未就绪时页面说明原因,ACP 仍保持停用;代理模式不会自动预热或启动官方进程。
47
+
48
+ **额度或 AI Credits 没有显示?** 额度查询默认不调用本机 `agy`。ACP 套餐额度走内置直连,代理模式走代理账户;AI Credits 默认不查询。只有在设置页「额度」打开「用 agy CLI 查询额度」并保存后,才会调用 `agy -p /usage` 与 `agy -p /credits`。ACP 登录成功不代表 CLI 也已登录。[登录态与数据来源](docs/reference.md#登录态与额度来源)
49
+
50
+ ## 功能预览
51
+
52
+ <picture>
53
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/KouzakiUmi/dsh-antigravity-acp/main/assets/readme/features-dark.png">
54
+ <img src="https://raw.githubusercontent.com/KouzakiUmi/dsh-antigravity-acp/main/assets/readme/features-light.png" width="1200" alt="模型选择器旁的额度药丸与展开的套餐额度弹层,以及「设置 → Antigravity ACP」中的连接状态与模型管理;虚构数据离线预览">
55
+ </picture>
56
+
57
+ 左:模型选择器旁的额度药丸,展开后按额度组显示窗口与剩余百分比。右:设置页的连接状态、分阶段耗时与模型管理。画面来自当前 `src/client.js` 的真实组件,数字与套餐名均为虚构。
58
+
59
+ ## 功能亮点
60
+
61
+ ### 多个对话,不再共用一个待审批回合
62
+
63
+ 默认按需启动最多 **2 个独立 worker**,可配置为 1–4 个。一个会话等待工具审批时,其它会话可使用空闲 worker;同一工具回合的结果仍回到原 worker。容量用满后排队,支持取消,默认等待上限 120 秒,主对话优先于排队中的后台标题。
64
+
65
+ 这不是无限并发,也不保证上游账户额度随 worker 数增加。[并发与续轮边界](docs/reference.md#并发与工具续轮)
66
+
67
+ ### 先连接、拿目录,再开始聊天
68
+
69
+ 设置页区分 **立即预热** 与 **连接 / 登录 ACP**:前者准备连接但不创建会话,后者验证会话并读取模型目录,两者都不发送聊天 prompt。目录使用缓存即时显示,支持主动刷新;模型列表按模型逐项控制是否出现在 DSH 选择器、默认思考档位、显示名与官方 ID 映射。
70
+
71
+ 模型家族与思考强度分开:选择家族,再由 DSH 的思考强度菜单路由到官方对应档位。不硬编码账号应当拥有的模型清单。[模型与请求项映射](docs/reference.md#模型目录与请求项)
72
+
73
+ ### 图片传给模型,不只传一段文字说明
74
+
75
+ 在 **宿主附件服务可用且上游声明 image capability** 时,当前消息、历史消息和工具返回的图片通过真实图片内容传入。支持 PNG、JPEG、WebP 与 GIF;只读取宿主附件,不自行抓取图片 URL。已被宿主卸载的图片会明确说明未发送像素。
76
+
77
+ 这是输入能力,不包含图片生成、音频或视频;真实图片识别效果尚未实机验收。[多模态限制](docs/reference.md#图片输入)
78
+
79
+ ### 额度、余额与连接状态,就在对话旁
80
+
81
+ - **额度药丸**:随当前模型切换对应额度组;展开查看三个组的窗口、剩余百分比、重置时间与缓存状态。上游未单列 Argon 组时使用 Gemini 共享额度,不误报未知。
82
+ - **AI Credits**:与套餐额度独立展示、独立缓存与报错;未知不是零,不会自动开启 Credits 付费回退。默认不查询,打开「用 agy CLI 查询额度」后来自官方 CLI 账户。
83
+ - **预热与诊断**:ACP 预热位于设置页;设置页集中连接、模型、完整配置与按需展开的诊断,代理登录显示准备、授权和完成阶段。
84
+ - **手动拉取额度**:设置页点击拉取,按当前模式取数并与对话药丸共享刷新结果;打开页面不自动查询。药丸采用 subusage 风格迷你条与简短状态。
85
+ - **常驻保存与草稿保护**:保存栏滚动时留在顶部,集中显示未保存计数、撤销与冲突;后台刷新保留输入,遵守只读状态。网络修改先保存再连接。
86
+
87
+ ## 它如何工作
88
+
89
+ ```mermaid
90
+ flowchart LR
91
+ D[DSH 对话] --> A[本插件 LlmAdapter / worker 池]
92
+ A -->|stdio · ACP v1| G[官方 Antigravity agent]
93
+ G -->|私有 loopback MCP| B[本插件工具桥]
94
+ B -->|挂起调用| T[DSH 校验 / 审批 / 执行]
95
+ T -->|工具结果回填原 prompt| B
96
+ B --> G
97
+ ```
98
+
99
+ 本包是 **Host + Web Client bundle**:Host 注册模型 provider、管理官方进程和工具桥,Client 提供设置页与额度药丸。不修改 DSH Core,也不把官方 CLI 包装成聊天接口;CLI 仅用于 ACP 只读模型目录,以及在显式开启「用 agy CLI 查询额度」后用于额度与余额查询。
100
+
101
+ **它不是直接的 Gemini 模型 API。** 默认情况下同一 DSH 对话会复用同一个 ACP 会话,在输入前缀与上一步输出一致时,后续回合只发送新增消息,未变化的上下文去重,变化内容仍发送,历史由官方 agent 自己持有;历史被压缩、回退或编辑,或模型、系统提示、工具目录变化时自动重建会话并全量重放一次(`reuseSessions=false` 可回到每轮重放)。工具续轮仍在同一个 prompt 内完成。角色消息、采样控制、延迟与计费不能视为和原生 API 相同。
102
+
103
+ ## 使用前,先知道这些边界
104
+
105
+ | 边界 | 当前行为 |
106
+ |---|---|
107
+ | 工具与权限 | AGY 内置工具、ACP fs / terminal 关闭;只允许已识别的私有桥请求进入 DSH,`allow_once` 不等于绕过 DSH 审批。协议约束**不是 OS 沙箱**。 |
108
+ | 登录材料 | 插件可能读取 CLI 登录文件,并为官方 ACP 写入 / 更新本机凭据文件;这些文件不是加密凭据库,Windows 访问保护依赖目录 ACL。 |
109
+ | 官方程序 | 按需从 `https://dl.google.com` 下载,拒绝重定向并检查 ZIP 路径;官方未提供校验和,不宣称签名验证通过。默认 server 版本为 **1.4.0**,不跟随 registry 自动升级。 |
110
+ | 模型参数 | `reasoningEffort` 映射官方档位;`maxTokens` 忽略;显式 `temperature` / `stop` 记录警告并忽略,值不生效。 |
111
+ | 数据可信度 | 缓存、失败、缺字段和未知分别标记;额度与余额仅供参考,不是计费依据。 |
112
+ | 版本与测试 | 宽 peer 范围是安装条件,不是全部 Core / 平台版本实机兼容证明;隔离测试不替代真实账号与 GUI 验收。 |
113
+
114
+ ## 兼容性与验证范围
115
+
116
+ | 项目 | 当前声明 / 证据 |
117
+ |---|---|
118
+ | Node.js | `>=22.19` |
119
+ | DSH Core peer 范围 | `>=0.2.0-rc.1 <0.2.1-0 \|\| >=0.2.1-0 <0.3.0-0`,适用于所声明的三个 `dsh-*` peer |
120
+ | 开发契约基准 | `dsh-llm` / `dsh-subprocess` / `dsh-typert-protocol` / `dsh-attachment` **0.2.1-alpha.4**,Cordis **4.0.5-alpha.2** |
121
+ | 上游协议 | ACP **v1**;SDK **1.4.0** 与默认 server **1.4.0** 是两个独立版本 |
122
+ | 当前源码本地验证 | 0.1.38 当前工作副本:类型检查、47 个文件 / 843 项测试与构建通过;另有无 CLI 的真实本地 OAuth 回调闭环及既有离线 Chrome 36 项布局检查 |
123
+ | 实机运行时核对 | 2026-11-12 对 `/opt/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` 槽位均在;未在 0.2.2-rc.1 上跑真实生成 |
124
+ | 桌面契约核对 | 使用分发包内 `dsh-llm` / `dsh-typert-protocol` 0.2.1-rc.5、Cordis 4.0.5、Typert 注册器隔离加载构建产物,验证单次贡献注册、代理路由及卸载清理;未调用真实账户 |
125
+ | 尚未覆盖 | 0.1.38 安装后的 Desktop GUI、真实 Google 授权、真实上游生成与图片识别、非 Windows 实机 |
126
+
127
+ 宿主附件服务是可选依赖,缺少时仍可文本聊天,但不声明图片能力。安装准入、开发类型检查和真实运行兼容性分别看待。[完整声明与验证方法](docs/development.md)
128
+
129
+ ## 文档导航
130
+
131
+ | 你想做什么 | 文档 |
132
+ |---|---|
133
+ | 安装、连接、查看额度或排查错误 | [使用与技术参考](docs/reference.md) |
134
+ | 调整并发、超时、模型、代理或二进制位置 | [完整配置与环境变量](docs/configuration.md) |
135
+ | 查看各版本更新、迁移注意与剩余限制 | [更新记录](docs/changelog.md) |
136
+ | 构建、测试、打包或维护 npm 发布流程 | [开发、验证与发布](docs/development.md) |
137
+
138
+ ## 许可与反馈
139
+
140
+ 本插件采用 [MIT License](LICENSE)。Google Antigravity 官方程序是独立下载的第三方软件,不随本包再分发;本插件并非 Google 官方产品。
141
+
142
+ 遇到问题请[提交 Issue](https://github.com/KouzakiUmi/dsh-antigravity-acp/issues),附插件版本、**实际 DSH Core 版本**、操作系统、操作步骤和已脱敏错误码。不要附 token、Cookie、完整 OAuth URL、代理密码或凭据文件。
143
+
144
+ ---
145
+
146
+ ## 本 fork 的改动
147
+
148
+ 二次开源不是重写,只改两处**上游已确认的行为缺陷**,其余与上游一致,便于随时 rebase。
149
+
150
+ ### 1. 识别 `xhigh` 档位,但不把它暴露成可选项
151
+
152
+ 官方 1.5.x 给 Gemini 4 Hydrogen 增加了 `-xhigh` 后缀。上游的档位正则只认
153
+ `low|medium|high`,于是 `gemini-4-hydrogen-xhigh` 匹配不到后缀,被当成**一个独立家族**
154
+ 出现在模型选择器里(显示为「Gemini 4 Hydrogen (XHigh)」)。
155
+
156
+ 但如果直接把 `xhigh` 加进 `AGY_REASONING_EFFORTS`,模型会声明四档,而宿主侧的
157
+ reasoning 校验只接受已经注册过的档位,选中后调用会以
158
+ `UNSUPPORTED_REASONING_EFFORT` 失败——上游 issue 里已经有这个症状。
159
+
160
+ 本 fork 的做法:
161
+
162
+ - 新增 `AgyModelTier = AgyReasoningEffort | 'xhigh'`,只用于**识别与折叠**
163
+ - `tierForModelId` / `stripTierLabel` 认 `xhigh`,家族折叠生效
164
+ - `AGY_REASONING_EFFORTS` 保持三档 → 思考强度菜单仍是 低/中/高,不会出现无法执行的选项
165
+
166
+ ### 2. 用量样本兜底:`usage_update.used`
167
+
168
+ 上下文占用投影需要一个「上一次请求的 prompt 用量」作为锚点。上游注释写的是
169
+ 「官方 `agy_acp_server` 1.4.0 实测不返回 `PromptResponse.usage`,因此通常不上报」,
170
+ 于是锚点长期不更新,投影只按消息增长累加,很快顶到窗口上限并**一直显示 100%**。
171
+
172
+ 本 fork 在收到 `usage_update` 时记录 `used`(ACP 定义:当前上下文已用 token),
173
+ 回合结束时若官方没有给 `usage`,就用它作为本轮样本上报:
174
+
175
+ ```ts
176
+ this.finishRound(mapUsage(response.usage) ?? this.#observedUsage)
177
+ ```
178
+
179
+ ### 与上游同步
180
+
181
+ ```bash
182
+ git remote add upstream https://github.com/KouzakiUmi/dsh-antigravity-acp.git
183
+ git fetch upstream && git rebase upstream/main
184
+ ```
@@ -0,0 +1,5 @@
1
+ # 单行组件:官方 ACP 宿主。不写入任何 agent-default-model row。
2
+ - insert:
3
+ - id: llm-antigravity-acp
4
+ name: dsh-bundle-antigravity-acp
5
+ inject: [llm, subprocess]
@@ -0,0 +1,92 @@
1
+ import type { OAuthClientMeta, TokenSet } from './oauth.js';
2
+ import { type AccountAdminRequest, type AccountAuthView, type AccountsSnapshot, type ResolvedAccount } from './types.js';
3
+ export interface AccountsManagerOptions {
4
+ /** 账号根目录;默认见 resolveAccountsDir()。 */
5
+ baseDir: string;
6
+ /** 真实 HOME(系统账号与默认 CLI 登录态所在)。 */
7
+ homeDir?: string;
8
+ now?: () => number;
9
+ randomId?: () => string;
10
+ /** OAuth 授权码换 token 用的 fetch(生产传插件代理 fetch)。 */
11
+ fetchImpl?: typeof fetch;
12
+ /** 解析官方 OAuth client;失败时回落到已审计的内嵌一对。 */
13
+ resolveClient?: () => Promise<OAuthClientMeta | undefined>;
14
+ /** 把刚拿到的登录态写成 ACP server 需要的两份文件(生产用 writeAcpCredentialFiles)。 */
15
+ writeCredentials?: (input: {
16
+ home: string;
17
+ client: OAuthClientMeta;
18
+ tokens: TokenSet;
19
+ }) => Promise<void>;
20
+ /** 打开默认浏览器;返回是否成功(失败时客户端仍可点授权链接)。 */
21
+ openBrowser?: (url: string) => Promise<boolean>;
22
+ /** 登录等待上限(毫秒)。 */
23
+ loginTimeoutMs?: number;
24
+ /** 本机回调端口;默认 51121(官方 Antigravity client 注册的回调),测试可传 0。 */
25
+ loginPort?: number;
26
+ /** 账号列表或当前账号变化后调用(index.ts 用来通知目录刷新)。 */
27
+ onChange?: () => void;
28
+ log?: {
29
+ info(message: string): void;
30
+ warn(message: string, error?: unknown): void;
31
+ };
32
+ }
33
+ export interface AccountActionResult {
34
+ snapshot: AccountsSnapshot;
35
+ message: string;
36
+ }
37
+ /** 账号管理器。所有 token / HOME 细节只在 Host 侧,客户端只看 AccountView。 */
38
+ export declare class AccountsManager {
39
+ private file;
40
+ private auth;
41
+ private login;
42
+ private authReset?;
43
+ private disposed;
44
+ /** 每个账号的登录态代际;重新登录成功后递增,只影响该账号的链路。 */
45
+ private readonly revisions;
46
+ /** 本进程见过的账号 id;保存时用来保留其它 Host 新增的记录。 */
47
+ private readonly knownIds;
48
+ private readonly baseDir;
49
+ private readonly homeDir;
50
+ private readonly now;
51
+ private readonly randomId;
52
+ private readonly fetchImpl;
53
+ private readonly writeCredentials;
54
+ private readonly openBrowser;
55
+ private readonly resolveClient;
56
+ private readonly loginTimeoutMs;
57
+ private readonly loginPort;
58
+ private readonly onChange;
59
+ private readonly log;
60
+ constructor(options: AccountsManagerOptions);
61
+ /** 客户端可见的快照:账号列表 + 当前账号 + 登录流程。 */
62
+ snapshot(): AccountsSnapshot;
63
+ /** 当前账号(ACP / CLI 子进程使用的 HOME)。 */
64
+ active(): ResolvedAccount;
65
+ /** 按 id 解析账号;系统账号或未知 id 返回 undefined / 系统账号。 */
66
+ resolve(id?: string): ResolvedAccount | undefined;
67
+ /** 面板动作入口。 */
68
+ handle(request: AccountAdminRequest): Promise<AccountActionResult>;
69
+ /** 登录流程结束后由面板轮询取走的状态;调用方不需要主动查询。 */
70
+ authState(): AccountAuthView;
71
+ dispose(): Promise<void>;
72
+ private systemResolved;
73
+ private resolvedOf;
74
+ private systemView;
75
+ private viewOf;
76
+ /** 只读检查登录态文件是否存在;不解析 token,避免把清单轮询变成磁盘热路径。 */
77
+ private tokenExists;
78
+ private activeRecordId;
79
+ private persist;
80
+ private activate;
81
+ private remove;
82
+ private beginAdd;
83
+ private beginRelogin;
84
+ /** 登录流程从 `preparing` 起就占用唯一槽位:listener 建立前的 await 窗口也不能被第二次点击穿进来。 */
85
+ private assertNoLogin;
86
+ private cancelLogin;
87
+ private setAuth;
88
+ private runLogin;
89
+ /** 把刚拿到的登录态写成 ACP server 需要的两个文件;未注入时视为成功。 */
90
+ private prepareCredentials;
91
+ private commitNewAccount;
92
+ }