dsh-vertex-argon 1.6.4 → 2.0.0
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/CHANGELOG.md +21 -1
- package/README.md +134 -139
- package/adapter.js +102 -94
- package/client.js +26 -65
- package/diagnostic-store.js +2 -2
- package/google-connection.js +2 -5
- package/index.js +3 -7
- package/inspector-tool.js +1 -1
- package/interaction-adapter.js +8 -8
- package/interaction-state.js +2 -2
- package/interactions-input.js +4 -3
- package/locale/en.json +2 -2
- package/locale/zh.json +2 -2
- package/package.json +3 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,26 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
All notable changes to `dsh-vertex-argon` are documented in this file.
|
|
3
|
+
All notable changes to **Gemini 4 Adapter** (`dsh-vertex-argon`) are documented in this file.
|
|
4
|
+
|
|
5
|
+
## [2.0.0] - 2026-11-11
|
|
6
|
+
|
|
7
|
+
### Breaking Changes
|
|
8
|
+
- **Focused Dual Official Channels & Proxy Route Removal (`adapter.js`, `index.js`, `interaction-adapter.js`, `client.js`)**:
|
|
9
|
+
- Removed the third-party Antigravity reverse-proxy route (`gemini-4-argon-proxy`, `gemini-3.8-flash-proxy`), dedicated `proxy*` settings (`proxyEnabled`, `proxyBaseUrl`, `proxyApiKey`), and the reverse-proxy settings card introduced in `1.6.0`–`1.6.3`, streamlining volatile plugin settings from 16 to **13** and focusing exclusively on official **Vertex AI** and **Gemini Developer API** channels.
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
- **Gemini 4 Carbon Support Across Both Official Channels (`adapter.js`, `interaction-adapter.js`, `client.js`, `package.json`)**:
|
|
13
|
+
- Added `CARBON_MODEL = 'gemini-4-carbon'` (Vertex AI) and `GOOGLE_API_CARBON_MODEL = 'gemini-4-carbon-google'` (Gemini API) alongside the Argon models via `officialUpstreamModel` and `detectPiAiArgonRoutes`, forming a 4-model official matrix with shared long-decode, service-tier validation, and cross-model tool-history downgrade protection.
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
- **Rebranded Display Surface to Gemini 4 Adapter (`locale/zh.json`, `locale/en.json`, `adapter.js`, `client.js`, `README.md`)**:
|
|
17
|
+
- Updated UI display titles, model-picker group name, diagnostics views (**Gemini 4 诊断** / **Gemini 4 diagnostics**), and package metadata to **Gemini 4 Adapter** while preserving the npm package name (`dsh-vertex-argon`), provider ID (`google-vertex-argon`), patch row ID (`local-vertex-argon`), tool name (`argon_inspect`), and storage domains (`vertex_argon_*`) for seamless in-place upgrades.
|
|
18
|
+
- Rewrote `README.md` for clarity, onboarding, and full `v2.0.0` architecture alignment.
|
|
19
|
+
|
|
20
|
+
### Fixed
|
|
21
|
+
- **Direct-Adapter `max` → `high` Reasoning Convergence & Test Isolation (`adapter.js`, `interaction-adapter.js`, `interactions-input.js`, `test/*.test.mjs`)**:
|
|
22
|
+
- Added `narrowMaxReasoning` across `ArgonAdapter.prepareCall`, `gemini4StreamSimple`, `interaction-adapter`, and `interactions-input` so callers invoking `adapter.stream` or `prepareCall().stream` directly (bypassing `agent/request`, such as advisor plugins) consistently normalize `max` reasoning effort to `high` while continuing to reject `off` / `minimal` / `xhigh`.
|
|
23
|
+
- Isolated per-test `globalThis.fetch` mocks and SDK prototype patches across the offline test suite so single-process `--test-isolation=none` runs match per-file isolated runs.
|
|
4
24
|
|
|
5
25
|
## [1.6.4] - 2026-11-05
|
|
6
26
|
|
package/README.md
CHANGED
|
@@ -1,203 +1,198 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Gemini 4 Adapter
|
|
2
2
|
|
|
3
|
-

|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**面向 [DeepSeek Harness](<https://github.com/deepseek-ai/deepseek-harness>) 的 Google 官方双通道(Vertex AI + Gemini Developer API)Gemini 4 适配器,原生支持 Argon 与 Carbon 四模型路由、GenerateContent / Interactions 双协议、65K+ 多跳长解码与请求级诊断。**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
- **当前版本**:`2.0.0`([CHANGELOG.md](<CHANGELOG.md>))
|
|
8
|
+
- **npm 包名**:`dsh-vertex-argon`(保留既有包名、官方通道路由与本地存储域 ID,官方通道用户可直接原地升级;`2.0.0` 已移除 `1.6.x` 非官方反代通道)
|
|
9
|
+
- **运行要求**:DSH `>=0.2.0-rc.2`,Node.js `^22.19.0 || >=24.0.0`(见 [package.json](<package.json>))
|
|
8
10
|
|
|
9
|
-
[
|
|
11
|
+
[快速开始](<#快速开始>) · [双官方通道与四模型](<#双官方通道与四模型>) · [长解码与流式恢复](<#generatecontent长解码与四项韧性机制>) · [配置速查](<#完整配置13-项>) · [诊断与工具](<#gemini-4-诊断与-argon_inspect-工具>) · [长解码实测参考](<#历史实测参考奥德赛七号全年舰长日志>)
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+
---
|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
- **GenerateContent 长解码**:单跳输出上限 `65,536`,输出预算配置最高 `1,048,576`,所有尝试共用 32 跳上限;支持检查点恢复、阶段超时、安全首包重试和仅思考结束自愈。
|
|
15
|
-
- **Interactions 后台恢复与状态对账**:显式启用后台与存储后,用 `creating` 预写锁防止未知创建被自动重发,以 `last_event_id` 续读已知任务;兼容 `2026-05-20` 独立生命周期事件,并在同会话发起新提示词时自动以有界非流式探针对账历史任务(清理已 `failed` / `cancelled` / `404` 死锁,保留未回放终态句柄的同时放行新提示词)。
|
|
16
|
-
- **签名保真**:保留并回放仅含 `thoughtSignature` / `thought_signature` 的空 `Part`;思考档位为 `low` / `medium` / `high`,宿主传入 `max` 时收敛为 `high`。
|
|
17
|
-
- **聚焦请求诊断**:只展示请求摘要、基本 Token 水位、逐跳轨迹、原始响应和完整 JSON,不再提供费用估算、模态用量或范围概览。
|
|
15
|
+
## 核心特性
|
|
18
16
|
|
|
19
|
-
|
|
17
|
+
- **双官方通道 × 四模型路由**:同时接入 Google Cloud **Vertex AI**(`gemini-4-argon` / `gemini-4-carbon`)与 **Gemini Developer API**(`gemini-4-argon-google` / `gemini-4-carbon-google`),两通道凭据与网关严格隔离,绝不暗中互借或静默回退。
|
|
18
|
+
- **65K+ 多跳长解码与流自愈**:单跳上限 `65,536` tokens,最大输出预算可达 `1,048,576`(最多 32 跳);首个检查点前实时流式输出,支持检查点尾段回滚续传、逐跳四阶段超时看门狗、零交付首包重试、仅思考结束单次续答自愈,以及 `MALFORMED_FUNCTION_CALL` 后 `VALIDATED` → `AUTO` 工具模式自动退避。
|
|
19
|
+
- **Interactions 协议与后台任务恢复**:支持前台流式及显式授权后的云端后台执行;内置 `creating` 预写防重计费锁、`last_event_id` 断点续读、`2026-05-20` 独立生命周期事件兼容,以及同会话新提示词触发的历史死锁非流式探针对账。
|
|
20
|
+
- **签名保真与跨模型安全降级**:完整保留并回放 `thoughtSignature` / `thought_signature`(含无文本独立签名块);原生映射 `low` / `medium` / `high` 三档思考级别(宿主或子代理传入 `max` 时自动收敛为 `high`,永不下发 `thinkingBudget`);在 Argon ↔ Carbon 或跨通道切换时自动将旧工具历史安全降级为文本记录并清洗污染块。
|
|
21
|
+
- **Gemini 4 诊断面板与只读工具**:在右侧栏、会话详情页与单条回复底部提供请求摘要、基础 Token 水位(严格区分首跳上下文水位与跨跳累计用量)、11 列逐跳轨迹、分页原始响应证据、云端 Interaction ID 只读查询与全局恢复锁管理,并向智能体提供延迟加载的只读工具 `argon_inspect`。
|
|
20
22
|
|
|
21
|
-
|
|
23
|
+
---
|
|
22
24
|
|
|
23
|
-
|
|
24
|
-
|---|---|---|---|
|
|
25
|
-
| Vertex AI | `gemini-4-argon` | `google-vertex` | `vertexProtocol` / `vertexServiceTier` |
|
|
26
|
-
| Gemini Developer API | `gemini-4-argon-google` | `google-generative-ai` | `googleProtocol` / `googleServiceTier` |
|
|
27
|
-
| Antigravity Proxy | `gemini-4-argon-proxy` | `google-generative-ai` | 复用 `googleProtocol` / `googleServiceTier` |
|
|
28
|
-
| Antigravity Proxy | `gemini-3.8-flash-proxy` | `google-generative-ai` | 同上;与 Argon 共用代理地址与专属密钥 |
|
|
25
|
+
## 快速开始
|
|
29
26
|
|
|
30
|
-
|
|
27
|
+
### 1. 安装插件
|
|
31
28
|
|
|
32
|
-
|
|
29
|
+
在 DSH 对话中直接请求安装:
|
|
33
30
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
31
|
+
```text
|
|
32
|
+
请用 plugin_manager 的 install_bundle 安装 dsh-vertex-argon
|
|
33
|
+
```
|
|
37
34
|
|
|
38
|
-
|
|
35
|
+
或通过宿主 CLI 安装到桌面 Profile:
|
|
39
36
|
|
|
40
|
-
|
|
37
|
+
```sh
|
|
38
|
+
dsh plugin --profile desktop add dsh-vertex-argon
|
|
39
|
+
```
|
|
41
40
|
|
|
42
|
-
###
|
|
41
|
+
### 2. 声明模型入口
|
|
43
42
|
|
|
44
|
-
在
|
|
43
|
+
在 DSH「**设置 → 模型**」的原生 `Google` 或 `Google Vertex AI` 供应商下添加 `gemini-4-argon` 和/或 `gemini-4-carbon`,插件会自动识别并在模型选择器中暴露 **Gemini 4 Adapter** 分组下的对应模型。
|
|
45
44
|
|
|
46
|
-
|
|
47
|
-
- `proxyApiKey` 先去除首尾空白;有值时使用设置值,否则只读取 `ANTIGRAVITY_API_KEY`。
|
|
48
|
-
- **绝不回退到 Google/Vertex 密钥,也不把代理密钥送往 Google/Vertex。** 缺少专属密钥时应明确失败。
|
|
49
|
-
- 地址和密钥使用草稿输入,失焦或点击保存后提交,重置恢复默认值。填写的 Key 保存在插件配置中,密码框仅遮挡显示;也可留空并使用 DSH 凭据中的 `ANTIGRAVITY_API_KEY`,避免直接填写配置。设置实时更新时,模型列表缓存随之失效。
|
|
50
|
-
- 选中代理模型时,插件按推理档位(`low` / `medium` / `high`)把上游模型 ID 1:1 映射:`gemini-4-argon-proxy` → `gemini-4-argon-low`、`gemini-4-argon-medium`、`gemini-4-argon-high`;`gemini-3.8-flash-proxy` → `gemini-3.8-flash-low`、`gemini-3.8-flash-medium`、`gemini-3.8-flash-high`(官方 Vertex AI 与 Gemini API 路由保持 `gemini-4-argon`)。GenerateContent 与 Interactions 走同一份映射。代理沿用 Google 协议与服务层级配置;具体端点是否支持所选能力仍取决于代理实现,不是新增的云端验证结论。
|
|
51
|
-
- **两个代理模型之间切换**时,旧模型的 GenerateContent 工具历史会在出站前降级成文本记录、旧思考一并剔除;未完成的工具调用直接报错。只有与当前代理模型完全一致的历史才保留原生签名回放,避免底层按 provider/model 摘掉签名后仍发出裸 `functionCall` 或孤立 `functionResponse`。
|
|
45
|
+
### 3. 配置官方凭据
|
|
52
46
|
|
|
53
|
-
|
|
47
|
+
凭据统一按 DSH `credentials` → `launchEnvironment` → `process.env` 顺序解析;若凭据服务报错将直接失败,不会偷偷回退到旧环境变量。
|
|
54
48
|
|
|
55
|
-
|
|
49
|
+
- **Vertex AI(ADC 模式)**:配置 `GOOGLE_APPLICATION_CREDENTIALS`、`GOOGLE_CLOUD_PROJECT`(或 `GCLOUD_PROJECT`)与 `GOOGLE_CLOUD_LOCATION`。
|
|
50
|
+
- **Vertex AI(Express 模式)**:配置 `GOOGLE_CLOUD_API_KEY`。
|
|
51
|
+
- **Gemini Developer API**:配置 `GOOGLE_API_KEY` 或 `GEMINI_API_KEY`(或宿主模型设置中指定的 `apiKeyEnv`)。
|
|
56
52
|
|
|
57
|
-
|
|
58
|
-
|---|---|---|---|
|
|
59
|
-
| 基础与生成 | `showInModelPicker` | `true` | 是否在模型选择器显示插件模型 |
|
|
60
|
-
| 基础与生成 | `reasoning` | `medium` | `low` / `medium` / `high` |
|
|
61
|
-
| 基础与生成 | `maxTokens` | `65536` | `1`–`1048576`;超过单跳预算需启用长解码 |
|
|
62
|
-
| 基础与生成 | `contextWindow` | `1048576` | `1`–`1048576` |
|
|
63
|
-
| 基础与生成 | `longDecode` | `true` | GenerateContent 多跳/检查点续传和仅思考自愈;关闭不禁用零交付初始重试 |
|
|
64
|
-
| 协议与服务层级 | `googleProtocol` | `generate-content` | `generate-content` / `interactions`;Gemini API 与代理共用 |
|
|
65
|
-
| 协议与服务层级 | `vertexProtocol` | `generate-content` | `generate-content` / `interactions` |
|
|
66
|
-
| 协议与服务层级 | `googleServiceTier` | `standard` | `standard` / `flex` / `priority`;Gemini API 与代理共用 |
|
|
67
|
-
| 协议与服务层级 | `vertexServiceTier` | `standard` | `standard` / `flex` / `priority`;实际允许组合见下表 |
|
|
68
|
-
| 协议与服务层级 | `vertexPaygoOnly` | `false` | 仅 Vertex GenerateContent 的共享池请求 |
|
|
69
|
-
| Antigravity Proxy | `proxyEnabled` | `false` | 启用独立代理模型;显式路由也可开启 |
|
|
70
|
-
| Antigravity Proxy | `proxyBaseUrl` | `http://127.0.0.1:8045/v1beta` | HTTP(S) 代理地址,按上述规则规范化 |
|
|
71
|
-
| Antigravity Proxy | `proxyApiKey` | 空字符串 | 去除首尾空白后优先使用;空值只回退 `ANTIGRAVITY_API_KEY` |
|
|
72
|
-
| Interactions 后台模式 | `interactionsBackground` | `false` | 启用后台执行,须同时允许云端存储 |
|
|
73
|
-
| Interactions 后台模式 | `allowInteractionStorage` | `false` | 允许发送 `store: true`,用于后台恢复 |
|
|
74
|
-
| 诊断与高级 | `retainRawResponses` | `false` | 显式允许捕获新的上游 JSON 响应;关闭不清空旧记录 |
|
|
75
|
-
|
|
76
|
-
### 服务层级与 Vertex PayGo
|
|
77
|
-
|
|
78
|
-
[service-level.js](<service-level.js>) 在发包前校验能力矩阵;未支持的组合以 `ARGON_SERVICE_TIER_UNVERIFIED` 拒绝,不自动切换协议或层级。
|
|
79
|
-
|
|
80
|
-
| `route` | 协议 | 服务层级 | `vertexPaygoOnly` |
|
|
81
|
-
|---|---|---|---|
|
|
82
|
-
| `google-generative-ai`(含代理) | `generate-content` | `standard` / `flex` / `priority` | 不适用 |
|
|
83
|
-
| `google-generative-ai`(含代理) | `interactions` | `standard` / `flex` / `priority` | 不适用 |
|
|
84
|
-
| `google-vertex` | `generate-content` | `standard` / `priority` | 支持 |
|
|
85
|
-
| `google-vertex` | `interactions` | 仅 `standard` | 不支持 |
|
|
53
|
+
---
|
|
86
54
|
|
|
87
|
-
|
|
55
|
+
## 双官方通道与四模型
|
|
88
56
|
|
|
89
|
-
|
|
57
|
+
底层 Provider ID 为 `google-vertex-argon`,模型选择器分组显示为 **Gemini 4 Adapter**(实现见 [adapter.js](<adapter.js>) 与 [google-connection.js](<google-connection.js>))。
|
|
90
58
|
|
|
91
|
-
|
|
59
|
+
| 官方通道 | 模型 ID | 上游基础模型 | 协议/诊断 `route` | 协议与服务层级配置 |
|
|
60
|
+
|---|---|---|---|---|
|
|
61
|
+
| **Vertex AI** | `gemini-4-argon` | `gemini-4-argon` | `google-vertex` | `vertexProtocol` / `vertexServiceTier` |
|
|
62
|
+
| **Vertex AI** | `gemini-4-carbon` | `gemini-4-carbon` | `google-vertex` | `vertexProtocol` / `vertexServiceTier` |
|
|
63
|
+
| **Gemini API** | `gemini-4-argon-google` | `gemini-4-argon` | `google-generative-ai` | `googleProtocol` / `googleServiceTier` |
|
|
64
|
+
| **Gemini API** | `gemini-4-carbon-google` | `gemini-4-carbon` | `google-generative-ai` | `googleProtocol` / `googleServiceTier` |
|
|
92
65
|
|
|
93
|
-
|
|
94
|
-
2. **每跳独立的阶段超时**:首包、思考、思考到可见输出的转换阶段各 `180s`,可见文本或工具流的滑动等待为 `120s`。每跳使用独立 `AbortController`;仅真实进展(首次进入思考/转换阶段、非空文本、具名工具调用、本跳未见的新签名或新检查点)刷新等待预算,空帧、空思考帧、空工具对象与重复签名不续命。上游阻塞可终止,不把用户主动取消当作可恢复故障,也不让上一跳定时器影响下一跳;消费方暂停读取不消耗上游等待预算。
|
|
95
|
-
3. **首包安全重试与检查点恢复**:可恢复故障发生时,若本跳尚未向调用方 `yield` 任何分片,即使没有 `continuationToken` 也可 `retry-initial`,初次尝试之外最多重试 3 次;已有分片交付但没有检查点时不得整段重试。有检查点则丢弃未提交尾段并从检查点重连,同一检查点无进展也最多重试 3 次。**首个检查点之前实时 `yield`,不把整段输出全部缓存到检查点。**
|
|
96
|
-
4. **仅思考 STOP 自愈**:一跳只有思考、没有可见回答或工具调用,却以 `STOP` 结束时,最多追加一次 `thinking-dropout-heal`。有可用 token 则用 token 续写;没有则保留原思考与签名,追加 `model` 思考内容及 `user` 消息 `Continue and provide the final response or tool call.`。被安全规则阻止的回答不因此绕过限制;第二次仅思考结束不再循环。
|
|
66
|
+
### 跨模型切换与历史清洗规则
|
|
97
67
|
|
|
98
|
-
|
|
68
|
+
- **同模型连续对话**:完整保留原生 `thoughtSignature` / `thought_signature` 与 `functionCall` / `functionResponse` 签名回放。
|
|
69
|
+
- **跨模型或跨通道切换(如 Argon ↔ Carbon、Vertex ↔ Gemini API)**:出站前自动将含推理或工具调用的旧回合降级为纯文本记录(剔除旧思考块,将已完成工具调用转为角色安全的文本摘要,未完成调用直接拦截),避免因底层摘除跨模型签名而发出裸 `functionCall` 或孤立 `functionResponse`。
|
|
70
|
+
- **原生入口兼容保护**:插件同时为宿主原生 `google` 与 `google-vertex` 适配器中的 Gemini 4 模型注入 GenerateContent 思考档位映射、采样参数剥离与签名回放保护。
|
|
99
71
|
|
|
100
|
-
|
|
72
|
+
---
|
|
101
73
|
|
|
102
|
-
|
|
74
|
+
## GenerateContent:长解码与四项韧性机制
|
|
103
75
|
|
|
104
|
-
|
|
76
|
+
开启 `longDecode` 后,Vertex AI 使用 `v1beta1`,Gemini API 使用 `v1beta`(实现见 [generate-content.js](<generate-content.js>),完整契约见 [协议合同](<docs/implementation/DECISIONS.md>))。关闭 `longDecode` 仅停用跨跳续传与仅思考自愈,首包零交付重试和阶段看门狗依然生效。
|
|
105
77
|
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
- **原始响应**:显示捕获状态,通过 `ResponsePage` 按帧、按字符分页读取。
|
|
111
|
-
- **完整 JSON**:折叠展示 `locator` 与 `record`,保留排障所需的原始诊断字段。
|
|
78
|
+
1. **流内错误识别与服务端退避**:HTTP `200` 的 SSE 流中若出现顶层 `{ error }` 同样按流内故障处理。自动解析 `Retry-After`、Google `details` 中的 `retryDelay` / `quotaResetDelay` 及错误文本等待提示,叠加 `200ms` 余量后与指数退避取较大值;若服务端要求等待超过 `60s` 则立即失败,避免无意义长挂起。
|
|
79
|
+
2. **逐跳四阶段独立超时看门狗**:首包等待(`initial-ttft`)、思考流(`thinking`)、思考转正文/工具(`transition`)各 `180s`,可见正文或工具流滑动超时 `120s`。每跳持有独立 `AbortController`;仅真实生成进展会刷新超时预算,空心跳帧、空思考帧、无名工具块及重复签名均不会续命,且下游暂停消费不会消耗上游等待计时。
|
|
80
|
+
3. **首检查点前实时流式与检查点回滚恢复**:在取得首个 `32,768` token 检查点前实时向界面 `yield` 分片,零缓冲延迟;若在 `yield` 任何分片前遇可恢复中断,支持无 token 的 `retry-initial`(最多重试 3 次)。一旦取得 `continuationToken` 检查点,断流时自动丢弃未确认尾段并从最近检查点续传(同一检查点无进展最多重试 3 次)。
|
|
81
|
+
4. **仅思考结束(STOP)单次自愈**:当某一跳输出了思考内容却未产出任何可见文本或工具调用便以 `STOP` 结束(且非安全拦截)时,自动触发至多一次 `thinking-dropout-heal`——有检查点则直接续写,无检查点则携带原签名思考追加续答提示完成本轮输出。
|
|
112
82
|
|
|
113
|
-
|
|
83
|
+
---
|
|
114
84
|
|
|
115
|
-
|
|
116
|
-
reportedInputTokens, reportedCacheTokens, outputTokens, thoughtsTokens, totalTokens,
|
|
117
|
-
billedOutputTokens, billedThoughtsTokens, billedToolTokens,
|
|
118
|
-
billedPromptTokens, billedCachedTokens, billedTotalTokens
|
|
119
|
-
```
|
|
85
|
+
## 完整配置:13 项
|
|
120
86
|
|
|
121
|
-
|
|
87
|
+
以下为 [index.js](<index.js>) 定义的全部实时生效配置(UI 设置面板见 [client.js](<client.js>)):
|
|
122
88
|
|
|
123
|
-
|
|
89
|
+
| 分组 | 配置项 | 默认值 | 取值范围与说明 |
|
|
90
|
+
|---|---|---|---|
|
|
91
|
+
| 基础与生成 | `showInModelPicker` | `true` | 是否在会话模型选择器中显示 **Gemini 4 Adapter** 分组 |
|
|
92
|
+
| 基础与生成 | `reasoning` | `medium` | 默认思考档位:`low` / `medium` / `high` |
|
|
93
|
+
| 基础与生成 | `maxTokens` | `65536` | `1`–`1048576`;超过 `65,536` 需启用长解码(窗口 > 131K 时自动预留 131,072 历史空间) |
|
|
94
|
+
| 基础与生成 | `contextWindow` | `1048576` | `1`–`1048576`;供 DSH 本地预算与上下文压缩计算使用 |
|
|
95
|
+
| 基础与生成 | `longDecode` | `true` | 控制 > 65,536 输出上限、GenerateContent 检查点续传与仅思考自愈 |
|
|
96
|
+
| 协议与服务层级 | `googleProtocol` | `generate-content` | `generate-content` / `interactions`(仅作用于 Gemini API) |
|
|
97
|
+
| 协议与服务层级 | `vertexProtocol` | `generate-content` | `generate-content` / `interactions`(仅作用于 Vertex AI) |
|
|
98
|
+
| 协议与服务层级 | `googleServiceTier` | `standard` | `standard` / `flex` / `priority`(仅作用于 Gemini API) |
|
|
99
|
+
| 协议与服务层级 | `vertexServiceTier` | `standard` | `standard` / `flex` / `priority`(受下方能力矩阵约束) |
|
|
100
|
+
| 协议与服务层级 | `vertexPaygoOnly` | `false` | 仅为 Vertex AI GenerateContent 附加 PayGo 共享池请求头 |
|
|
101
|
+
| Interactions 后台模式 | `allowInteractionStorage` | `false` | 允许向 Google 发送 `store: true` 云端存储许可(后台模式前置条件) |
|
|
102
|
+
| Interactions 后台模式 | `interactionsBackground` | `false` | 启用 Interactions 云端后台执行与断点恢复 |
|
|
103
|
+
| 诊断与高级 | `retainRawResponses` | `false` | 允许本地留存解析后的上游 JSON 响应帧(关闭不影响既有记录) |
|
|
104
|
+
|
|
105
|
+
### 服务层级与 Vertex PayGo 能力矩阵
|
|
106
|
+
|
|
107
|
+
[service-level.js](<service-level.js>) 在发包前执行组合预检;不受支持的组合直接以 `ARGON_SERVICE_TIER_UNVERIFIED` 拒绝,绝不静默篡改用户所选层级或协议。
|
|
108
|
+
|
|
109
|
+
| 通道 `route` | 协议 | 支持的服务层级 | `vertexPaygoOnly` |
|
|
110
|
+
|---|---|---|---|
|
|
111
|
+
| `google-generative-ai` | `generate-content` | `standard` / `flex` / `priority` | 不适用 |
|
|
112
|
+
| `google-generative-ai` | `interactions` | `standard` / `flex` / `priority` | 不适用 |
|
|
113
|
+
| `google-vertex` | `generate-content` | `standard` / `priority` | 支持(`X-Vertex-AI-LLM-Request-Type: shared`) |
|
|
114
|
+
| `google-vertex` | `interactions` | 仅 `standard` | 不支持 |
|
|
124
115
|
|
|
125
|
-
|
|
126
|
-
- **后台恢复锁管理**:查看全局本地恢复状态;未知 `creating` 状态只能在用户明确确认后释放。释放本地锁不等于取消远端任务。
|
|
127
|
-
- 会话诊断、原始响应、云端查询、查询结果读取和全局锁管理各自检查权限;切换范围或卸载组件后,过期异步结果不得回写新视图。
|
|
116
|
+
---
|
|
128
117
|
|
|
129
|
-
|
|
118
|
+
## Gemini 4 诊断与 `argon_inspect` 工具
|
|
130
119
|
|
|
131
|
-
|
|
120
|
+
可通过右侧栏 **Gemini 4 诊断**、对话顶栏视图 **Gemini 4 详情** 或每条助手回复下方的详情图标打开面板。诊断记录经 [request-association.js](<request-association.js>) 精确绑定到最终 `messageId` 与 `settlementSeq`。
|
|
132
121
|
|
|
133
|
-
|
|
134
|
-
|---|---|---|
|
|
135
|
-
| `list` | 列出当前会话请求摘要 | `messageId?`、`limit?`(1–50) |
|
|
136
|
-
| `detail` | 分页读取完整诊断与逐跳记录 | `requestId`、`offset?`、`limit?`(1–10) |
|
|
137
|
-
| `response` | 分页读取已捕获上游 JSON 帧 | `requestId`、`index?`、`offset?`、`length?` |
|
|
138
|
-
| `query` | 对已知云端 ID 发起一次只读查询 | `route`、`id` |
|
|
139
|
-
| `query-response` | 读取 `query` 返回的临时结果 | `queryId`、`offset?`、`length?` |
|
|
122
|
+
### Debug 面板:单请求全链路证据
|
|
140
123
|
|
|
141
|
-
|
|
124
|
+
- **请求摘要**:请求 ID、官方通道(`Vertex AI` / `Gemini API`)、协议、思考档位、结果状态、失败类别、总耗时、末跳结束原因与消息关联状态。
|
|
125
|
+
- **Token 水位**:清晰拆分单次上下文水位(`reportedInputTokens` / `reportedCacheTokens` / `outputTokens` / `thoughtsTokens` / `totalTokens`)与多跳累计观测计数(`billedPromptTokens` / `billedCachedTokens` / `billedOutputTokens` / `billedThoughtsTokens` / `billedToolTokens` / `billedTotalTokens`),不做虚构计费估算。
|
|
126
|
+
- **11 列 Step / Hop 轨迹明细**:逐跳展示 `hopIndex`、`trigger`、`status`、`streamErrorStatus`、`errorPhase`、`backoffDelayMs`、`chunkCount`、`hasCheckpoint`、`finishReason`、`errorCodes` 与 `durationMs`。
|
|
127
|
+
- **原始响应与完整 JSON**:开启留存授权后可按帧、按字符分页检视上游 JSON 片段,并查看完整的 `locator` 与脱敏诊断对象。
|
|
142
128
|
|
|
143
|
-
|
|
129
|
+
### Operations 面板:云端查询与恢复锁管理
|
|
144
130
|
|
|
145
|
-
-
|
|
146
|
-
- `
|
|
147
|
-
- `vertex_argon_interactions`:后台任务的创建锁与恢复游标。
|
|
131
|
+
- **按 ID 查询云端状态**:使用当前通道凭据对已知 Cloud Interaction ID 发起一次只读 `GET`,不会恢复生成、取消任务或执行云端返回的工具调用。
|
|
132
|
+
- **全局防重复创建保护**:集中展示本地后台任务的恢复状态;当历史后台创建结果未知(`creating` / `unknown`)时阻止重复扣费请求,支持用户在核实后手动确认解除本地拦截。
|
|
148
133
|
|
|
149
|
-
|
|
134
|
+
### 只读智能体工具 `argon_inspect`
|
|
150
135
|
|
|
151
|
-
|
|
136
|
+
由 [inspector-tool.js](<inspector-tool.js>) 注册(默认 `deferLoading: true`,不占用常规对话首轮上下文),仅读取当前会话诊断或执行显式只读查询:
|
|
152
137
|
|
|
153
|
-
|
|
138
|
+
| `action` | 说明 | 主要参数 |
|
|
139
|
+
|---|---|---|
|
|
140
|
+
| `list` | 列出当前会话保留的请求摘要 | `messageId?`、`limit?`(1–50) |
|
|
141
|
+
| `detail` | 分页读取单条请求的诊断详情与逐跳轨迹 | `requestId`、`offset?`、`limit?`(1–10) |
|
|
142
|
+
| `response` | 按帧与字符偏移分页读取本地留存的上游 JSON | `requestId`、`index?`、`offset?`、`length?` |
|
|
143
|
+
| `query` | 使用官方通道当前凭据单次只读查询云端 Interaction ID | `route`、`id` |
|
|
144
|
+
| `query-response` | 分页读取 `query` 返回的临时查询结果 | `queryId`、`offset?`、`length?` |
|
|
154
145
|
|
|
155
|
-
|
|
146
|
+
---
|
|
156
147
|
|
|
157
|
-
|
|
148
|
+
## 存储与隐私说明
|
|
158
149
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
| 思考 / 输出预算 | `LOW` / `131072`,开启长解码 |
|
|
163
|
-
| 请求 / 观测服务层级 | `priority` → `standard`,来源 `traffic-type` |
|
|
164
|
-
| 第一跳 | HTTP `200`;`961,781 ms`;`1,291` 块;输入 `52,737`,输出 `65,536`;`CONTINUATION` |
|
|
165
|
-
| 第二跳 | HTTP `200`;`476,132 ms`;输入 `118,274`,输出 `33,449`;`STOP` |
|
|
166
|
-
| 单回合输出 / 总耗时 | **98,985 tokens** / **1,437,917 ms**(约 23 分 58 秒) |
|
|
167
|
-
| 输入水位 / 累计输入 / 累计总量 | `52,737` / `171,011` / `269,996` |
|
|
168
|
-
| 跳数 / 重连次数 | `2` / `0` |
|
|
150
|
+
- `vertex_argon_diagnostics`:保留最近 200 条脱敏结构化诊断记录,不含对话正文或密钥;读取旧版本历史记录时自动兼容剔除已退役字段,不改写旧磁盘文件。
|
|
151
|
+
- `vertex_argon_responses`:默认关闭;显式开启 `retainRawResponses` 后最多保留 20 条记录(总上限 64 MiB,单条上限 16 MiB / 16,384 帧)。留存内容为解析后的上游 JSON(可能含敏感正文、图片数据与签名),请按不可信数据审慎对待。
|
|
152
|
+
- `vertex_argon_interactions`:保存 Interactions 后台模式的预写创建锁与断点恢复游标。
|
|
169
153
|
|
|
170
|
-
|
|
154
|
+
---
|
|
171
155
|
|
|
172
|
-
|
|
156
|
+
## 历史实测参考:奥德赛七号全年舰长日志
|
|
173
157
|
|
|
174
|
-
|
|
175
|
-
请用 plugin_manager 的 install_bundle 安装 dsh-vertex-argon
|
|
176
|
-
```
|
|
158
|
+
> 以下数据采集自 `v1.5.0` 在 Vertex AI `gemini-4-argon` 上的真实长解码运行记录(诊断 ID:`f911d0c5-fe7a-43ca-b205-5d2202105a41`),用于展示跨 `65,536` 单跳上限的多跳续写表现;工程架构与离线回归详情见 [验证账本](<docs/implementation/STATUS.md>)。
|
|
177
159
|
|
|
178
|
-
|
|
160
|
+
任务要求单回合连续生成 `DAY 001` 至 `DAY 365` 的全年舰长日志,完整维持每日状态、每周维护、月末报告与第 100 / 200 / 215 / 300 / 365 天的锚定事件。
|
|
179
161
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
162
|
+
| 实测指标 | 记录值 |
|
|
163
|
+
|---|---|
|
|
164
|
+
| 通道 / 模型 / 协议 | `google-vertex` / `gemini-4-argon` / `generate-content`(`v1beta1`) |
|
|
165
|
+
| 思考档位 / 输出预算 | `LOW` / `131,072`(长解码开启) |
|
|
166
|
+
| 请求 / 观测服务层级 | `priority` → `standard`(来源:`traffic-type`) |
|
|
167
|
+
| Hop 1 | HTTP `200` · `961,781 ms` · `1,291` 块 · 输入 `52,737` / 输出 `65,536` · `CONTINUATION` |
|
|
168
|
+
| Hop 2 | HTTP `200` · `476,132 ms` · 输入 `118,274` / 输出 `33,449` · `STOP` |
|
|
169
|
+
| 单回合总输出 / 总耗时 | **98,985 tokens** / **1,437,917 ms**(约 23 分 58 秒) |
|
|
170
|
+
| 首跳输入水位 / 累计输入 / 累计总量 | `52,737` / `171,011` / `269,996` |
|
|
171
|
+
| 总跳数 / 异常重连次数 | `2` / `0` |
|
|
172
|
+
|
|
173
|
+
---
|
|
183
174
|
|
|
184
|
-
|
|
175
|
+
## 本地开发与离线测试
|
|
185
176
|
|
|
186
|
-
|
|
177
|
+
仓库内部架构说明见 [实现架构](<docs/implementation/README.md>),协议边界见 [协议合同](<docs/implementation/DECISIONS.md>),协作规范见 [AGENTS.md](<AGENTS.md>)。
|
|
187
178
|
|
|
188
179
|
```bash
|
|
180
|
+
# 标准离线测试(自动复用本机已有 DSH 依赖,全程拦截真实外网请求)
|
|
189
181
|
npm test
|
|
190
|
-
|
|
182
|
+
|
|
183
|
+
# 显式指定宿主目录运行
|
|
191
184
|
DSH_TEST_HOST_ROOT=/path/to/deepseek-harness npm test
|
|
192
|
-
```
|
|
193
185
|
|
|
194
|
-
|
|
186
|
+
# Windows 受限沙盒禁止子进程命名管道时,使用单进程聚合运行
|
|
187
|
+
node --experimental-transform-types --import ./test/offline-guard.mjs \
|
|
188
|
+
--import ./test/host-loader.mjs --test --test-isolation=none test/*.test.mjs
|
|
189
|
+
```
|
|
195
190
|
|
|
196
|
-
[host-
|
|
191
|
+
测试套件先经 [offline-guard.mjs](<test/offline-guard.mjs>) 封锁除测试自建 IPv4 回环外的全部网络访问,再由 [host-loader.mjs](<test/host-loader.mjs>) 与 [host-internals.mjs](<test/host-internals.mjs>) 加载真实宿主模块与匹配版本的 React 进行端到端离线核验。
|
|
197
192
|
|
|
198
|
-
## 与 billion-context
|
|
193
|
+
## 与 billion-context 配合提示
|
|
199
194
|
|
|
200
|
-
|
|
195
|
+
较早版本的代理网关可能重排消息或丢弃独立签名块(参考 [Issue #3159](<https://github.com/ranxianglei/billion-context/issues/3159>) / [PR #3167](<https://github.com/ranxianglei/billion-context/pull/3167>)、[Issue #3158](<https://github.com/ranxianglei/billion-context/issues/3158>) / [PR #3162](<https://github.com/ranxianglei/billion-context/pull/3162>))。搭配自定义网关时请开启对应上游透传支持;本插件的双官方通道凭据隔离规则不受自定义 `baseURL` 影响。
|
|
201
196
|
|
|
202
197
|
## License
|
|
203
198
|
|