dsh-bundle-antigravity-host 0.1.25 → 0.1.26
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 +17 -4
- package/dist/adapter/antigravity-adapter.d.ts +34 -9
- package/dist/adapter/antigravity-adapter.js +505 -44
- package/dist/adapter/antigravity-adapter.js.map +1 -1
- package/dist/adapter/continuation-state.d.ts +5 -1
- package/dist/adapter/continuation-state.js +3 -2
- package/dist/adapter/continuation-state.js.map +1 -1
- package/dist/adapter/image-content.d.ts +7 -0
- package/dist/adapter/image-content.js +23 -2
- package/dist/adapter/image-content.js.map +1 -1
- package/dist/adapter/prompt-transcript.d.ts +36 -3
- package/dist/adapter/prompt-transcript.js +86 -3
- package/dist/adapter/prompt-transcript.js.map +1 -1
- package/dist/adapter/prompt-turn.d.ts +8 -3
- package/dist/adapter/prompt-turn.js +15 -5
- package/dist/adapter/prompt-turn.js.map +1 -1
- package/dist/adapter/session-reuse.d.ts +19 -0
- package/dist/adapter/session-reuse.js +102 -0
- package/dist/adapter/session-reuse.js.map +1 -0
- package/dist/bridge/mcp-bridge.d.ts +9 -2
- package/dist/bridge/mcp-bridge.js +15 -2
- package/dist/bridge/mcp-bridge.js.map +1 -1
- package/dist/client.js +16 -3
- package/dist/index.js +32 -8
- package/dist/index.js.map +1 -1
- package/dist/pool/pooled-adapter.d.ts +7 -0
- package/dist/pool/pooled-adapter.js +53 -3
- package/dist/pool/pooled-adapter.js.map +1 -1
- package/dist/protocol/agent-link.d.ts +11 -1
- package/dist/protocol/agent-link.js +25 -0
- package/dist/protocol/agent-link.js.map +1 -1
- package/dist/runtime/session-map.d.ts +53 -0
- package/dist/runtime/session-map.js +213 -0
- package/dist/runtime/session-map.js.map +1 -0
- package/dist/settings.d.ts +31 -0
- package/dist/settings.js +5 -0
- package/dist/settings.js.map +1 -1
- package/docs/changelog.md +11 -0
- package/docs/configuration.md +34 -2
- package/docs/development.md +3 -3
- package/docs/reference.md +21 -5
- package/package.json +16 -1
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DSH 会话 → ACP 会话 的映射缓存(只存 id 与已发送历史的指纹,不存对话内容)。
|
|
3
|
+
*
|
|
4
|
+
* 用途:`resumeSessions` 打开时,插件/宿主重启后还能找回上一次的 ACP 会话并
|
|
5
|
+
* 用 `session/load` 恢复,而不是从零重建。历史权威仍是 DSH:这里只记录
|
|
6
|
+
* 「哪些消息已经发给了那个 ACP 会话」,用于校验当前历史是否仍是它的纯追加。
|
|
7
|
+
*
|
|
8
|
+
* 缓存语义(刻意保守):
|
|
9
|
+
* - 只存 ID、条数与 sha256 指纹,绝不写入消息正文、系统提示或凭据;
|
|
10
|
+
* - 读取失败、JSON 损坏、格式版本不符一律当作没有映射,静默回退重建;
|
|
11
|
+
* - 条目按最近使用时间保留有限条,避免无限增长。
|
|
12
|
+
*/
|
|
13
|
+
import { mkdir, open, readFile, rename, unlink } from 'node:fs/promises';
|
|
14
|
+
import { randomUUID } from 'node:crypto';
|
|
15
|
+
import { basename, dirname, join } from 'node:path';
|
|
16
|
+
/** 映射文件格式版本。 */
|
|
17
|
+
const SESSION_MAP_FORMAT = 2;
|
|
18
|
+
/** 默认保留的会话映射条数。 */
|
|
19
|
+
const MAX_ENTRIES = 64;
|
|
20
|
+
/** 默认文件名。 */
|
|
21
|
+
const FILE_NAME = 'sessions.json';
|
|
22
|
+
/** 读取会话映射;任何异常都返回空表(调用方回退重建)。 */
|
|
23
|
+
export async function readSessionMap(cacheDir) {
|
|
24
|
+
const file = join(cacheDir, FILE_NAME);
|
|
25
|
+
let raw;
|
|
26
|
+
try {
|
|
27
|
+
raw = await readFile(file, 'utf8');
|
|
28
|
+
}
|
|
29
|
+
catch {
|
|
30
|
+
return {};
|
|
31
|
+
}
|
|
32
|
+
try {
|
|
33
|
+
const parsed = JSON.parse(raw);
|
|
34
|
+
if (parsed.format !== SESSION_MAP_FORMAT || typeof parsed.entries !== 'object' || parsed.entries === null)
|
|
35
|
+
return {};
|
|
36
|
+
const entries = {};
|
|
37
|
+
for (const [key, entry] of Object.entries(parsed.entries)) {
|
|
38
|
+
if (!entry || typeof entry !== 'object')
|
|
39
|
+
continue;
|
|
40
|
+
const row = entry;
|
|
41
|
+
if (typeof row.sessionId !== 'string' || row.sessionId === '')
|
|
42
|
+
continue;
|
|
43
|
+
if (typeof row.cwd !== 'string' || row.cwd === '')
|
|
44
|
+
continue;
|
|
45
|
+
if (!Number.isSafeInteger(row.sentCount) || row.sentCount === undefined || row.sentCount < 0)
|
|
46
|
+
continue;
|
|
47
|
+
if (!isHash(row.sentHash) || !isHash(row.outputHash) || !isHash(row.route))
|
|
48
|
+
continue;
|
|
49
|
+
if (key === '__proto__' || key === 'constructor' || key === 'prototype')
|
|
50
|
+
continue;
|
|
51
|
+
entries[key] = {
|
|
52
|
+
sessionId: row.sessionId,
|
|
53
|
+
cwd: row.cwd,
|
|
54
|
+
sentCount: row.sentCount,
|
|
55
|
+
sentHash: row.sentHash,
|
|
56
|
+
outputHash: row.outputHash,
|
|
57
|
+
route: row.route,
|
|
58
|
+
updatedAt: typeof row.updatedAt === 'number' && Number.isFinite(row.updatedAt) ? row.updatedAt : 0,
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
return entries;
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
return {};
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* 写入会话映射。写入失败(只读缓存目录、磁盘满、文件被占用)静默忽略:
|
|
69
|
+
* 恢复能力是优化,不是功能。
|
|
70
|
+
*/
|
|
71
|
+
export async function writeSessionMap(cacheDir, entries) {
|
|
72
|
+
const kept = Object.entries(entries)
|
|
73
|
+
.sort(([, a], [, b]) => b.updatedAt - a.updatedAt)
|
|
74
|
+
.slice(0, MAX_ENTRIES);
|
|
75
|
+
const payload = { format: SESSION_MAP_FORMAT, entries: Object.fromEntries(kept) };
|
|
76
|
+
const file = join(cacheDir, FILE_NAME);
|
|
77
|
+
const temporary = join(dirname(file), `.${basename(file)}.${randomUUID()}.tmp`);
|
|
78
|
+
let ownsTemporary = false;
|
|
79
|
+
try {
|
|
80
|
+
await mkdir(dirname(file), { recursive: true });
|
|
81
|
+
const handle = await open(temporary, 'wx', 0o600);
|
|
82
|
+
ownsTemporary = true;
|
|
83
|
+
try {
|
|
84
|
+
await handle.writeFile(`${JSON.stringify(payload, null, 2)}\n`, 'utf8');
|
|
85
|
+
}
|
|
86
|
+
finally {
|
|
87
|
+
await handle.close();
|
|
88
|
+
}
|
|
89
|
+
await rename(temporary, file);
|
|
90
|
+
ownsTemporary = false;
|
|
91
|
+
return true;
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
return false;
|
|
95
|
+
}
|
|
96
|
+
finally {
|
|
97
|
+
if (ownsTemporary)
|
|
98
|
+
await unlink(temporary).catch(() => undefined);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* 跨 Host 的排他写租约;另一实例持有缓存时,本实例仅保留内存复用,不读写恢复映射。
|
|
103
|
+
* 不按 mtime 猜测锁过期:崩溃残留锁需在确认所有 Host 已退出后人工清理。
|
|
104
|
+
*/
|
|
105
|
+
export function createFileSessionMapStore(cacheDir, onError) {
|
|
106
|
+
const file = join(cacheDir, 'sessions.lock');
|
|
107
|
+
const marker = JSON.stringify({ pid: process.pid, token: randomUUID() });
|
|
108
|
+
let handle;
|
|
109
|
+
let ready = false;
|
|
110
|
+
return new SessionMapStore({
|
|
111
|
+
load: async () => {
|
|
112
|
+
await mkdir(cacheDir, { recursive: true });
|
|
113
|
+
handle = await open(file, 'wx', 0o600);
|
|
114
|
+
await handle.writeFile(marker, 'utf8');
|
|
115
|
+
ready = true;
|
|
116
|
+
return readSessionMap(cacheDir);
|
|
117
|
+
},
|
|
118
|
+
save: async (entries) => {
|
|
119
|
+
if (!ready || !await writeSessionMap(cacheDir, entries))
|
|
120
|
+
throw new Error('Session map unavailable');
|
|
121
|
+
},
|
|
122
|
+
onError,
|
|
123
|
+
close: async () => {
|
|
124
|
+
if (!handle)
|
|
125
|
+
return;
|
|
126
|
+
ready = false;
|
|
127
|
+
const owned = handle;
|
|
128
|
+
handle = undefined;
|
|
129
|
+
await owned.close();
|
|
130
|
+
// 只删除本实例确实创建、且内容仍匹配的锁;绝不清理其他 Host 的锁。
|
|
131
|
+
if (await readFile(file, 'utf8').catch(() => '') === marker)
|
|
132
|
+
await unlink(file).catch(() => undefined);
|
|
133
|
+
},
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
function isHash(value) {
|
|
137
|
+
return typeof value === 'string' && /^[a-f0-9]{64}$/.test(value);
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* 同一插件的所有 worker 共用一个存储:键的所有权与增量更新集中管理,写入串行化。
|
|
141
|
+
* 接管仍被另一 worker 持有的键时不 load 旧 ACP 会话(它仍可能在旧进程内存中)。
|
|
142
|
+
* 每次只更新调用方本轮的键,旧 worker 无法覆盖或删除新 owner 的状态。
|
|
143
|
+
*/
|
|
144
|
+
export class SessionMapStore {
|
|
145
|
+
storage;
|
|
146
|
+
#owners = new Map();
|
|
147
|
+
#entries = {};
|
|
148
|
+
#ready;
|
|
149
|
+
#writes = Promise.resolve();
|
|
150
|
+
#errorReported = false;
|
|
151
|
+
constructor(storage) {
|
|
152
|
+
this.storage = storage;
|
|
153
|
+
}
|
|
154
|
+
async claim(key, owner) {
|
|
155
|
+
this.#ready ??= this.storage.load().then(entries => { this.#entries = { ...entries }; }, () => { this.#reportError(); });
|
|
156
|
+
await this.#ready;
|
|
157
|
+
const previous = this.#owners.get(key);
|
|
158
|
+
const entry = previous === undefined || previous === owner ? this.#entries[key] : undefined;
|
|
159
|
+
this.#owners.delete(key);
|
|
160
|
+
this.#owners.set(key, owner);
|
|
161
|
+
if (previous !== undefined && previous !== owner) {
|
|
162
|
+
delete this.#entries[key];
|
|
163
|
+
this.#enqueue();
|
|
164
|
+
}
|
|
165
|
+
while (this.#owners.size > MAX_ENTRIES) {
|
|
166
|
+
const oldest = this.#owners.keys().next().value;
|
|
167
|
+
if (oldest === undefined)
|
|
168
|
+
break;
|
|
169
|
+
this.#owners.delete(oldest);
|
|
170
|
+
}
|
|
171
|
+
return entry ? { ...entry } : undefined;
|
|
172
|
+
}
|
|
173
|
+
owns(key, owner) { return this.#owners.get(key) === owner; }
|
|
174
|
+
set(key, owner, entry) {
|
|
175
|
+
if (!this.owns(key, owner))
|
|
176
|
+
return;
|
|
177
|
+
this.#entries[key] = { ...entry };
|
|
178
|
+
this.#entries = Object.fromEntries(Object.entries(this.#entries)
|
|
179
|
+
.sort(([, a], [, b]) => b.updatedAt - a.updatedAt).slice(0, MAX_ENTRIES));
|
|
180
|
+
this.#enqueue();
|
|
181
|
+
}
|
|
182
|
+
delete(key, owner) {
|
|
183
|
+
if (!this.owns(key, owner))
|
|
184
|
+
return;
|
|
185
|
+
delete this.#entries[key];
|
|
186
|
+
this.#enqueue();
|
|
187
|
+
}
|
|
188
|
+
/** 卸载释放内存所有权但保留可恢复条目。 */
|
|
189
|
+
release(owner) {
|
|
190
|
+
for (const [key, current] of this.#owners)
|
|
191
|
+
if (current === owner)
|
|
192
|
+
this.#owners.delete(key);
|
|
193
|
+
}
|
|
194
|
+
async flush() { await this.#writes; }
|
|
195
|
+
async close() {
|
|
196
|
+
await this.#ready;
|
|
197
|
+
await this.flush();
|
|
198
|
+
await this.storage.close?.();
|
|
199
|
+
}
|
|
200
|
+
#enqueue() {
|
|
201
|
+
const snapshot = structuredClone(this.#entries);
|
|
202
|
+
this.#writes = this.#writes.then(async () => {
|
|
203
|
+
await this.storage.save(snapshot);
|
|
204
|
+
this.#errorReported = false;
|
|
205
|
+
}).catch(() => { this.#reportError(); });
|
|
206
|
+
}
|
|
207
|
+
#reportError() {
|
|
208
|
+
if (!this.#errorReported)
|
|
209
|
+
this.storage.onError?.();
|
|
210
|
+
this.#errorReported = true;
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
//# sourceMappingURL=session-map.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session-map.js","sourceRoot":"","sources":["../../src/runtime/session-map.ts"],"names":[],"mappings":"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"}
|
package/dist/settings.d.ts
CHANGED
|
@@ -48,6 +48,27 @@ export interface AntigravityHostConfig {
|
|
|
48
48
|
* 因为私有 MCP 桥与 OAuth 回调都在 loopback 上。
|
|
49
49
|
*/
|
|
50
50
|
proxyBypass?: string;
|
|
51
|
+
/**
|
|
52
|
+
* 复用同一个 ACP 会话:同一 DSH 对话的后续回合只发送新增消息,不再每轮
|
|
53
|
+
* `session/new` 并重放全部历史。历史被压缩/回退、模型或工具目录变化时
|
|
54
|
+
* 仍会受控重建。关闭后回到「每轮新会话 + 全量重放」的旧行为。
|
|
55
|
+
*/
|
|
56
|
+
reuseSessions?: boolean;
|
|
57
|
+
/**
|
|
58
|
+
* 跨进程恢复 ACP 会话:插件/宿主重启后,若上次留下会话映射,尝试用
|
|
59
|
+
* `session/load` 恢复该对话而不是从零重建。依赖 agent 的 `loadSession`
|
|
60
|
+
* 能力;agent 侧历史可能与 DSH 当前历史不一致,失败时自动回退重建。
|
|
61
|
+
*/
|
|
62
|
+
resumeSessions?: boolean;
|
|
63
|
+
/**
|
|
64
|
+
* 用户取消(停止按钮)后是否保留官方进程:默认关闭(立即回收,下一轮冷启动)。
|
|
65
|
+
* 开启后先等 `cancelGraceMs` 让 agent 确认停止;确认了就只丢弃会话、保留进程。
|
|
66
|
+
*/
|
|
67
|
+
keepProcessAfterCancel?: boolean;
|
|
68
|
+
/** 取消后的确认宽限(毫秒);0 表示不等待、立即回收。 */
|
|
69
|
+
cancelGraceMs?: number;
|
|
70
|
+
/** 保留进程的最长空闲时间(毫秒),超时回收;0 表示不设上限。 */
|
|
71
|
+
idleRecycleMs?: number;
|
|
51
72
|
}
|
|
52
73
|
export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
|
|
53
74
|
maxConcurrentSessions: Schema<number, number, "defined">;
|
|
@@ -66,6 +87,11 @@ export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
|
|
|
66
87
|
preferredModel: Schema<string, string, "plain">;
|
|
67
88
|
proxyUrl: Schema<string, string, "plain">;
|
|
68
89
|
proxyBypass: Schema<string, string, "plain">;
|
|
90
|
+
reuseSessions: Schema<boolean, boolean, "defined">;
|
|
91
|
+
resumeSessions: Schema<boolean, boolean, "defined">;
|
|
92
|
+
keepProcessAfterCancel: Schema<boolean, boolean, "defined">;
|
|
93
|
+
cancelGraceMs: Schema<number, number, "defined">;
|
|
94
|
+
idleRecycleMs: Schema<number, number, "defined">;
|
|
69
95
|
}>>, Schemastery.ObjectT<NoInfer<{
|
|
70
96
|
maxConcurrentSessions: Schema<number, number, "defined">;
|
|
71
97
|
queueTimeoutMs: Schema<number, number, "defined">;
|
|
@@ -83,4 +109,9 @@ export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
|
|
|
83
109
|
preferredModel: Schema<string, string, "plain">;
|
|
84
110
|
proxyUrl: Schema<string, string, "plain">;
|
|
85
111
|
proxyBypass: Schema<string, string, "plain">;
|
|
112
|
+
reuseSessions: Schema<boolean, boolean, "defined">;
|
|
113
|
+
resumeSessions: Schema<boolean, boolean, "defined">;
|
|
114
|
+
keepProcessAfterCancel: Schema<boolean, boolean, "defined">;
|
|
115
|
+
cancelGraceMs: Schema<number, number, "defined">;
|
|
116
|
+
idleRecycleMs: Schema<number, number, "defined">;
|
|
86
117
|
}>>, "plain">;
|
package/dist/settings.js
CHANGED
|
@@ -21,5 +21,10 @@ export const Config = Schema.object({
|
|
|
21
21
|
preferredModel: Schema.string().description('默认/自定义模型 ID,优先列入目录;目录外 ID 未验证。兼容旧 server-default 路由,留空不指定默认项'),
|
|
22
22
|
proxyUrl: Schema.string().description('官方进程出网代理,如 http://127.0.0.1:7890(缺 scheme 按 http 处理)。留空继承宿主代理,宿主也未配置时才直连'),
|
|
23
23
|
proxyBypass: Schema.string().description('代理排除列表,逗号分隔,如 example.internal,*.internal;不支持 CIDR。localhost/127.0.0.1/::1 始终自动排除'),
|
|
24
|
+
reuseSessions: Schema.boolean().default(true).description('复用同一个 ACP 会话,后续回合只发送新增消息;历史被压缩/回退或模型、工具目录变化时自动重建。关闭则每轮新会话并重放全部历史'),
|
|
25
|
+
resumeSessions: Schema.boolean().default(false).description('重启后尝试用 session/load 恢复上次的 ACP 会话;依赖 agent 的 loadSession 能力,恢复失败会自动重建'),
|
|
26
|
+
keepProcessAfterCancel: Schema.boolean().default(false).description('用户取消后保留官方进程:宽限内确认 agent 已停止就只丢弃会话,下一轮不必冷启动;默认关闭'),
|
|
27
|
+
cancelGraceMs: Schema.natural().max(60_000).default(30_000).description('取消后等待 agent 确认停止的上限(毫秒);0 表示不等待、立即回收'),
|
|
28
|
+
idleRecycleMs: Schema.natural().max(3_600_000).default(300_000).description('保留进程的最长空闲时间(毫秒),超时回收;0 表示不设上限。默认 5 分钟是本插件的资源回收策略,不代表上游缓存 TTL'),
|
|
24
29
|
});
|
|
25
30
|
//# sourceMappingURL=settings.js.map
|
package/dist/settings.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;
|
|
1
|
+
{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
|
package/docs/changelog.md
CHANGED
|
@@ -4,6 +4,17 @@
|
|
|
4
4
|
|
|
5
5
|
记录源码与发布内容,不将本地构建、npm 发布和本机升级混为同一状态。日期采用 Asia/Hong_Kong。更早历史见 [Git 提交记录](https://github.com/KouzakiUmi/dsh-antigravity-acp/commits/main/)。
|
|
6
6
|
|
|
7
|
+
## 0.1.26 · 2026-10-23
|
|
8
|
+
|
|
9
|
+
- **消息一致性**:同一 DSH 对话可增量复用 ACP 会话;在交付 `finish` 前提交输入与输出指纹,调用方立即结束读取也不会重发旧问题。编辑回答、外部模型输出或历史/路由变化时完整重建;去重后没有可发送增量也回退完整重建,不发空 prompt。
|
|
10
|
+
- **上下文去重**:仅省略已见且未变化的上下文,不再按 form 整类丢弃;新规则、变化快照、目录更新与状态回滚继续发送。
|
|
11
|
+
- **取消排空**:可选保留进程,但必须先取得正常停止应答;新轮不能撤销宽限。本地超时/运输错误仍回收。`cancelGraceMs=0` 的语义调整为不等待、立即回收,而非保留未确认连接。
|
|
12
|
+
- **统一空闲回收**:聊天、预热和目录发现均纳入计时;活动请求、工具 park 与取消排空不算空闲。一次性标题/压缩/发现会话结束后关闭;内存复用记录最多 64 条。
|
|
13
|
+
- **恢复映射 v2**:共享存储管理 worker 所有权与串行写入,只落盘 ID、计数和指纹;旧格式安全失效。正常空闲回收保留有效映射,恢复后校正并核对模型;选模响应不完整时安全失败但保留上一份有效目录。load 拒绝、超时或取消先清理旧连接,避免迟到回放混入新轮。
|
|
14
|
+
- **跨 Host 隔离**:恢复缓存使用排他租约,占用时仅降级磁盘恢复,不影响聊天。崩溃残留锁不自动抢占,确认相关 Host 退出后再处理。
|
|
15
|
+
- **设置与文档**:设置卡增加复用、恢复、取消保留与两个计时字段;数值校验和只提交修改项的行为一致。修正采样参数、token 轮换及缓存 TTL 的旧描述;5 分钟是插件资源策略,不是上游 TTL 保证。
|
|
16
|
+
- **验证边界**:补齐 finish 即 return、输出改写/外部模型、上下文变化、取消/空闲竞态、恢复失败/工具桥/选模、文件格式与共享所有权回归;本地 `npm run check` 通过(36 个文件 / 591 项)。发布不代表本机升级,真实上游与 Desktop GUI 仍需单独验收。
|
|
17
|
+
|
|
7
18
|
## 0.1.25 · 2026-10-22
|
|
8
19
|
|
|
9
20
|
- **修复登录 / 预热超时**:新增 `handshakeTimeoutMs`(默认 120 秒),取代写死的 15 秒握手上限。官方进程需解包 218MB 单文件并导入 Python 依赖,冷启动约 52 秒、热启动约 10 秒。
|
package/docs/configuration.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[返回主页](../README.md) · [使用与排障](reference.md) · [开发与验证](development.md)
|
|
4
4
|
|
|
5
|
-
以下对应 **0.1.
|
|
5
|
+
以下对应 **0.1.26**,以 [`src/settings.ts`](https://github.com/KouzakiUmi/dsh-antigravity-acp/blob/main/src/settings.ts) 的 Config 为准。字段均位于 `llm-antigravity-acp` 插件配置根级,不需要额外包装一层对象。设置页只展示常用项,其余可通过宿主提供的配置面编辑。
|
|
6
6
|
|
|
7
7
|
## 配置清单
|
|
8
8
|
|
|
@@ -24,6 +24,11 @@
|
|
|
24
24
|
| `preferredModel` | 未设置 | 默认 / 自定义模型 ID,在目录中优先列出;目录外 ID 未验证。兼容旧 `server-default` 路由,不替换现有会话选择。 |
|
|
25
25
|
| `proxyUrl` | 未设置 | 显式出网代理;留空继承 Host 代理环境,Host 也未配置才直连。支持 HTTP、HTTPS、SOCKS5、SOCKS5H。 |
|
|
26
26
|
| `proxyBypass` | 未设置 | 逗号分隔排除列表,支持域名匹配,不支持 CIDR;始终合并 localhost、127.0.0.1、::1。 |
|
|
27
|
+
| `reuseSessions` | `true` | 复用同一个 ACP 会话:同一 DSH 对话的后续回合只发送**新增消息**,不再每轮 `session/new` 并重放全部历史。历史被压缩、回退或编辑,模型/思考强度变化,工具目录变化,或 MCP 桥被其他对话接管时自动重建。关闭后回到旧的「每轮新会话 + 全量重放」。 |
|
|
28
|
+
| `resumeSessions` | `false` | 插件或 Host 重启后,尝试用 `session/load` 恢复上次的 ACP 会话。映射写在缓存目录的 `sessions.json`,只存会话 ID、cwd、已发送条数、输入/输出与路由 sha256 和时间戳,不存对话内容、system 提示或工具 schema。恢复失败或前缀不一致时自动回退为新轮重建。 |
|
|
29
|
+
| `keepProcessAfterCancel` | `false` | 用户按停止后是否保留官方进程。关闭时立即回收(下一轮冷启动);开启后先等 `cancelGraceMs` 确认 agent 已停止,确认了就只丢弃会话、保留进程。 |
|
|
30
|
+
| `cancelGraceMs` | `30000` | 取消后等待 agent 确认停止的上限(毫秒);`0` 表示不等待、立即回收进程。热启动约 10 秒,30 秒留出余量。 |
|
|
31
|
+
| `idleRecycleMs` | `300000` | 保留进程的最长空闲时间(毫秒),超时回收释放内存;`0` 表示不设上限。适用于聊天、预热及目录发现结束;等待工具和取消排空不算空闲。5 分钟是插件资源策略,不代表上游缓存寿命。 |
|
|
27
32
|
|
|
28
33
|
示例(不包含代理密码或账号材料):
|
|
29
34
|
|
|
@@ -34,10 +39,37 @@
|
|
|
34
39
|
"autoWarmup": true,
|
|
35
40
|
"autoDownload": true,
|
|
36
41
|
"acpVersion": "1.4.0",
|
|
42
|
+
"reuseSessions": true,
|
|
43
|
+
"resumeSessions": false,
|
|
37
44
|
"proxyUrl": "http://127.0.0.1:7890"
|
|
38
45
|
}
|
|
39
46
|
```
|
|
40
47
|
|
|
48
|
+
### 会话复用与恢复
|
|
49
|
+
|
|
50
|
+
ACP 官方 agent 在同一会话内会保留上下文(2026-10-23 真机验证:同一 `session` 连发两条 prompt,第二条能复述第一条的暗号),并且声明了 `loadSession`。因此插件默认复用会话:
|
|
51
|
+
|
|
52
|
+
- 同一 DSH 对话的**普通聊天回合**校验输入前缀与上轮实际交付输出后,只发送新增消息;system、工具策略与历史不再每轮重放。收到 `finish` 即结束消费也会提交游标。
|
|
53
|
+
- 注入内容按 producer 与内容去重:仅省略相同的快照/目录/指令或已见召回材料;首次出现、变化或恢复旧版本的状态仍发送。真实用户消息、notice、relay 与未知类别不去重。
|
|
54
|
+
- 出现以下任一情况即受控重建(`session/close` + `session/new` + 全量重放):历史不是已发送前缀的追加(压缩检查点、回退、编辑)、模型或思考强度变化、system 或工具目录变化、MCP 桥被另一对话接管、回合异常终止。
|
|
55
|
+
- 标题、压缩等一次性请求不参与复用,各自独立建会话,结束后尽力关闭。内存会话与磁盘映射最多各保留 64 条,淘汰会话会关闭。
|
|
56
|
+
- 连接池会把同一对话粘在同一个 worker 上(换 worker 就丢了会话记录);新对话优先使用未被占用的 worker,容量用尽才排队。
|
|
57
|
+
- `resumeSessions` 同时验证路由、输入前缀和上轮输出;恢复后核对/校正实际模型。恢复失败先回收连接,再完整重建,避免迟到回放混入新轮。
|
|
58
|
+
- 所有 worker 共用一个映射存储,串行提交且只修改本轮所属键。对话迁移到另一 worker 时保守新建会话,旧 worker 不能覆盖新游标。映射格式升级到 v2,旧格式自动失效并重建。
|
|
59
|
+
- 跨 Host 使用 `sessions.lock` 排他租约。另一 Host 已占用缓存时,本实例不读写恢复映射,只保留内存复用并记录警告;普通聊天不受影响。正常卸载 flush 后释放租约。若 Host 崩溃留下锁,不按时间猜测过期;确认使用此缓存的所有 Host 均已退出后,才可人工移除残留锁。
|
|
60
|
+
|
|
61
|
+
### 取消与进程保留
|
|
62
|
+
|
|
63
|
+
`session/cancel` 是通知,不代表官方 agent 的执行已经停止;因此默认仍在取消后回收进程(安全优先,代价是下一轮冷启动)。开启 `keepProcessAfterCancel` 后:
|
|
64
|
+
|
|
65
|
+
- 先给 `cancelGraceMs`(默认 30 秒,热启动约 10 秒)让 agent 回应 `cancelled`;确认了就只丢弃会话、保留进程(下一轮免冷启动)。
|
|
66
|
+
- 宽限内没有确认、本地超时或通信失败 → 照旧回收;本地 promise 结束不等于 agent 已停止。`cancelGraceMs=0` 表示立即回收。
|
|
67
|
+
- 新轮不能撤销旧回合的取消宽限;需等待确认或完成回收后才使用连接。
|
|
68
|
+
- 保留期间 `idleRecycleMs` 内没有新消息 → 回收,释放常驻内存。
|
|
69
|
+
- 保留进程不等于复用会话:被取消的会话一律作废,避免沿用可能仍在执行的 turn。
|
|
70
|
+
|
|
71
|
+
实测(2026-10-23,官方 1.4.0):同一会话空闲 60s、120s 后仍能复述上一轮暗号,响应耗时稳定(约 3s);`usage_update.used` 持续累计(3463 → 3628 → 3745)。官方会话空闲 TTL 未知;ACP 会话上下文、Gemini 显式缓存与模型前缀缓存不是同一个保证。默认 5 分钟仅是本插件在启动延迟与常驻资源之间选取的回收策略,可自行调整或设 0 禁用。
|
|
72
|
+
|
|
41
73
|
配置更新可能重载插件。非法代理当前会在插件装载期抛 `ProxyConfigError`,可能需要通过宿主通用配置面修复,不能假定本插件卡片还能显示。需要代理时先保存再连接;已有官方进程不会因为页面上的文本变化自动换出口。按部署方式重载 Host / 重启 Desktop,不把刷新网页当成 Host 已更新。
|
|
42
74
|
|
|
43
75
|
## 环境变量
|
|
@@ -66,6 +98,6 @@
|
|
|
66
98
|
|
|
67
99
|
## 设置页可以做什么
|
|
68
100
|
|
|
69
|
-
常用操作:连接 / 取消、预热、目录刷新、默认模型、CLI
|
|
101
|
+
常用操作:连接 / 取消、预热、目录刷新、默认模型、CLI 路径、代理、会话复用 / 重启恢复 / 取消保留开关、取消宽限与空闲计时、额度 / Credits 刷新。并发上限可通过宿主配置面调整。会显示生命周期计时、容量与排队。
|
|
70
102
|
|
|
71
103
|
不提供账户切换、模型删除 / 禁用或付费 Credits 开关。思考强度由 DSH 会话菜单选择,不在此维护第二份独立档位配置。只读 Profile 禁止修改;外部刷新不会覆盖未保存草稿,保存失败保留输入。
|
package/docs/development.md
CHANGED
|
@@ -58,18 +58,18 @@ npm pack
|
|
|
58
58
|
|
|
59
59
|
## 本次验证矩阵
|
|
60
60
|
|
|
61
|
-
0.1.
|
|
61
|
+
0.1.26 本地检查日期:**2026-10-23**。
|
|
62
62
|
|
|
63
63
|
| 验证项 | 状态与范围 |
|
|
64
64
|
|---|---|
|
|
65
65
|
| TypeScript | `npm run typecheck` 通过 |
|
|
66
|
-
| 隔离回归 | `npm test`:
|
|
66
|
+
| 隔离回归 | `npm test`:36 个文件 / 591 项通过 |
|
|
67
67
|
| 构建 | `npm run build` 通过 |
|
|
68
68
|
| 工具 / runtime | 假 ACP / MCP、乱序工具结果、池所有权、续轮变更、取消、写入阻塞和回收 |
|
|
69
69
|
| 图片 | 附件引用校验、图片内容映射与跨 worker 能力;未调用真实视觉模型 |
|
|
70
70
|
| 设置交互 | React 18 renderer 测试草稿、冲突、只读与连接状态;不是浏览器像素测试 |
|
|
71
71
|
| 代理 | 合成依赖、失败不直连、本地 SOCKS 测试;不是 Google 网络可达性保证 |
|
|
72
|
-
| 真实上游 / GUI | 本次未验收 0.1.
|
|
72
|
+
| 真实上游 / GUI | 本次未验收 0.1.26 安装后的 GUI、真实生成或图片识别 |
|
|
73
73
|
| 非 Windows | 有平台映射与契约测试,未实机验收 |
|
|
74
74
|
| 生产依赖漏洞 | `check` 不包含漏洞审计;没有单独成功审计证据就不声明通过 |
|
|
75
75
|
|
package/docs/reference.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[返回主页](../README.md) · [配置](configuration.md) · [更新记录](changelog.md) · [开发与验证](development.md)
|
|
4
4
|
|
|
5
|
-
本文对应 `dsh-bundle-antigravity-host` **0.1.
|
|
5
|
+
本文对应 `dsh-bundle-antigravity-host` **0.1.26**。安装或连接成功不等于真实模型生成、图片识别或所有平台已验收。
|
|
6
6
|
|
|
7
7
|
## 安装与更新
|
|
8
8
|
|
|
@@ -67,7 +67,7 @@ dsh plugin --profile web add ./dsh-bundle-antigravity-host-0.1.24.tgz
|
|
|
67
67
|
|---|---|
|
|
68
68
|
| `reasoningEffort` | 官方档位路由键,不是采样参数 |
|
|
69
69
|
| `maxTokens` | 忽略;宿主标题等内建流程也会携带此项,输出限制由官方 agent 决定 |
|
|
70
|
-
| `temperature` / `stop` |
|
|
70
|
+
| `temperature` / `stop` | 记录警告并忽略;值不生效,不冒充采样控制已满足 |
|
|
71
71
|
|
|
72
72
|
## 并发与工具续轮
|
|
73
73
|
|
|
@@ -79,7 +79,7 @@ dsh plugin --profile web add ./dsh-bundle-antigravity-host-0.1.24.tgz
|
|
|
79
79
|
|
|
80
80
|
1. 插件通过宿主 `ctx.subprocess` 以 stdio 启动官方 ACP server。
|
|
81
81
|
2. 会话使用厂商扩展 `_meta.antigravity.enabledTools: []` 关闭内置工具,使用 `eagerMcpServers: ["dsh-tools"]` 提供当前 DSH 工具 schema。此扩展的默认适配基准是官方 server 1.4.0,不保证任意版本同样实现。
|
|
82
|
-
3. 私有 MCP 桥仅绑定 `127.0.0.1
|
|
82
|
+
3. 私有 MCP 桥仅绑定 `127.0.0.1`,新建或重建带工具的 ACP 会话时轮换 token 与授权代次;同一会话复用时保留授权,目录/归属变化则重建。
|
|
83
83
|
4. ACP 权限提示只对已识别私有桥请求选择 `allow_once`,不会自身产生 DSH 调用;真正的 `tools/call` 到桥后才挂起,并以 `tool-call` 交给 DSH。
|
|
84
84
|
5. DSH 负责校验、审批、执行;工具结果按调用 ID 匹配,携带 `isError` 回填同一 ACP prompt。支持乱序结果与后续批次。
|
|
85
85
|
|
|
@@ -87,7 +87,7 @@ dsh plugin --profile web add ./dsh-bundle-antigravity-host-0.1.24.tgz
|
|
|
87
87
|
|
|
88
88
|
续轮会校验模型、思考强度、system、工具 schema、历史前缀与上轮实际输出。变更后取消旧 prompt,按新历史重建。`finish(tool-calls)` 只封住当前 DSH 输出,不代表官方 prompt 已结束;封口后到达的内容留给续轮。
|
|
89
89
|
|
|
90
|
-
|
|
90
|
+
普通用户回合默认复用 ACP session,校验输入前缀和上一步实际输出,只发增量;编辑回答、外部 provider 的额外输出或路由变化会触发全量重建。`resumeSessions` 可选开启跨进程恢复(默认关闭),恢复后校正模型;文本历史信封不等同于模型 API 的原生角色消息。上游 `end_turn` 没有可见文本或工具调用时返回 `AGY_EMPTY_RESPONSE`,仅思考或进度通知不算成功。
|
|
91
91
|
|
|
92
92
|
ACP fs / terminal 与未知原生权限请求始终拒绝。单次拒绝允许模型改用 DSH 工具;同回合反复索要超过 3 次会 fail-closed 终止。协议能力与权限拒绝**不是操作系统沙箱**,不证明官方二进制只能执行被协议观察到的操作。
|
|
93
93
|
|
|
@@ -167,6 +167,22 @@ onefile 临时展开使用用户级根目录内独立的 `runtime/instance-*`,
|
|
|
167
167
|
|
|
168
168
|
设置草稿与远端快照分离,只提交已修改字段,支持清空。外部更新产生冲突时提示并可恢复远端值;保存失败保留草稿。加载、只读与保存期间禁用相应编辑,不提供账户切换、模型删除 / 禁用或付费开关。
|
|
169
169
|
|
|
170
|
+
## 已知限制与绕过
|
|
171
|
+
|
|
172
|
+
下面这些来自 ACP 官方 agent 或协议层,插件不能完全消除;写在这里避免被误当成故障。
|
|
173
|
+
|
|
174
|
+
| 限制 | 现状 | 绕过 / 处理 |
|
|
175
|
+
|---|---|---|
|
|
176
|
+
| 没有 token 用量 | 协议把 `PromptResponse.usage` 标为“本轮用量”(UNSTABLE),但官方 1.4.0 实测不返回,宿主拿不到计费 token;只有 `usage_update.used/size` 反映上下文占用。 | 不估算、不伪造计费数字,也不对累计值做差;额度以官方客户端/额度药丸为准。 |
|
|
177
|
+
| 工具参数非流式 | ACP 桥在工具被调用后才拿到完整参数,界面里工具调用一次性出现。 | 协议没有增量参数通道,暂无。 |
|
|
178
|
+
| 标题 / 压缩走当前 provider | DSH 用当前模型生成标题、做压缩,各自新建一次 ACP 会话(约 3–20 秒、消耗额度)。 | 标题超时已收紧到 90 秒、压缩 10 分钟;可在 DSH 侧关闭自动标题或改用更便宜的 provider。 |
|
|
179
|
+
| `temperature` / `stop` 不生效 | ACP v1 没有对应会话通道;插件记录警告并忽略,不再整单失败。 | 需要采样控制时使用官方 agent 自身的会话配置。 |
|
|
180
|
+
| 上下文去重 | 相同 producer 的未变化快照/目录/指令与已见召回材料不重复发送;新内容、变化和状态回滚仍发送。 | 不再整类跳过注入;未知来源保守发送。需要每轮全量重放可关闭 `reuseSessions`。 |
|
|
181
|
+
| 取消后默认回收进程 | `session/cancel` 只是通知;默认安全优先,下一轮冷启动(热启动约 10 秒、冷启动可达 50 秒)。 | 开启 `keepProcessAfterCancel`,用 `cancelGraceMs` 等确认、`idleRecycleMs` 限制空闲保留。 |
|
|
182
|
+
| `session/load` 会回放历史 | 官方通过 `session/update` 重放历史(含 `user_message_chunk`);插件在加载期间全部丢弃,避免混入本轮输出。 | 无需操作。 |
|
|
183
|
+
| 恢复缓存由其他 Host 占用 / 崩溃残留锁 | 排他租约不可取得时,仅禁用本实例的磁盘恢复,不影响普通聊天;不自动抢锁。 | 使用独立缓存目录,或确认相关 Host 全部退出后清理残留 `sessions.lock`。 |
|
|
184
|
+
| 旧版本 load 回放异常 | 社区报告 agy_acp_server 1.2.1 上 `session/load` 可能回放零历史。本插件默认 1.4.0;恢复失败会自动重建。 | 遇到异常先升级 ACP server 版本。 |
|
|
185
|
+
|
|
170
186
|
## 排障
|
|
171
187
|
|
|
172
188
|
| 现象 / 错误码 | 可能原因 | 检查与处理 |
|
|
@@ -186,4 +202,4 @@ onefile 临时展开使用用户级根目录内独立的 `runtime/instance-*`,
|
|
|
186
202
|
| 药丸完全消失 | 未选择本 provider,或 Client / remote 未装载 | 先确认选中 `antigravity-acp`、Host 与 Client 同版本;开发时核对 `$mount` 与依赖,避免让贡献型 remote 等待自身。 |
|
|
187
203
|
| 运行目录积累 | 被强杀后残留或所有权 / 退出状态未知 | 未知目录不会按时间自动删除;停止相关进程后人工核对,不在进程仍活跃时批量清理。 |
|
|
188
204
|
|
|
189
|
-
|
|
205
|
+
异常失败会撤销桥授权并回收受管进程;正常应答的 refusal / 空回复可保留自洽连接。取消默认回收;开启保留后必须等 agent 的正常停止应答,超时或通信错误仍回收,期间新轮不能绕过排空屏障。无法确认回收完成时拒绝使用旧连接。provider 不声明可安全重试错误码,避免宿主整步重放导致重复认证、生成或工具调用。定位后由用户决定是否重试,不将错误掩盖为成功。
|
package/package.json
CHANGED
|
@@ -1,11 +1,26 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-bundle-antigravity-host",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.26",
|
|
4
4
|
"description": "DeepSeek Harness host bundle that talks to the official Antigravity ACP server over stdio (Agent Client Protocol v1).",
|
|
5
|
+
"displayName": "Antigravity ACP",
|
|
6
|
+
"keywords": [
|
|
7
|
+
"dsh",
|
|
8
|
+
"dsh-plugin",
|
|
9
|
+
"dsh-bundle",
|
|
10
|
+
"antigravity",
|
|
11
|
+
"acp",
|
|
12
|
+
"agent-client-protocol",
|
|
13
|
+
"gemini",
|
|
14
|
+
"model-provider"
|
|
15
|
+
],
|
|
5
16
|
"repository": {
|
|
6
17
|
"type": "git",
|
|
7
18
|
"url": "git+https://github.com/KouzakiUmi/dsh-antigravity-acp.git"
|
|
8
19
|
},
|
|
20
|
+
"homepage": "https://github.com/KouzakiUmi/dsh-antigravity-acp#readme",
|
|
21
|
+
"bugs": {
|
|
22
|
+
"url": "https://github.com/KouzakiUmi/dsh-antigravity-acp/issues"
|
|
23
|
+
},
|
|
9
24
|
"type": "module",
|
|
10
25
|
"main": "./dist/index.js",
|
|
11
26
|
"types": "./dist/index.d.ts",
|