dsh-agy-acp 0.1.2 → 0.1.3

package/client.js

@@ -101,6 +101,22 @@
     return value !== null && typeof value === 'object' && !Array.isArray(value);
   }
 
+  /**
+   * 解包真实宿主 @deepseek-ai/dsh-api-gateway 的一元 Remote 结果信封。
+   *
+   * 网关客户端 invoke() 的成功返回是 { ok: true, value: <payload> }（失败是
+   * { ok: false, error }），并不是裸 payload；离线的远程替身与旧宿主则直接返回
+   * payload。这里只剥一层、且只剥「成功信封」：
+   *   - ok:false 的失败信封原样返回，交给调用方既有的错误分支处理；
+   *   - 裸 payload 原样返回，绝不误剥业务字段里自带的 ok/value 组合。
+   */
+  function unwrapRemoteResult(response) {
+    if (isPlainObject(response) && response.ok === true && 'value' in response && response.value !== undefined) {
+      return response.value;
+    }
+    return response;
+  }
+
   function resolveService(ctx, name) {
     if (!ctx || typeof ctx !== 'object') return null;
     try {
@@ -960,7 +976,7 @@
         if (!api || typeof api.getAcpSnapshot !== 'function') {
           throw new Error('Host 端 dsh-agy-acp.getAcpSnapshot 服务未就绪');
         }
-        const response = await api.getAcpSnapshot({ sessionId: focusSessionId || GLOBAL });
+        const response = unwrapRemoteResult(await api.getAcpSnapshot({ sessionId: focusSessionId || GLOBAL }));
         if (isPlainObject(response) && response.ok === false) {
           throw new Error(formatErrorMessage(response.error || response));
         }
@@ -974,7 +990,7 @@
           if (!api || typeof api.stopAcpRun !== 'function') {
             return { ok: false, stopped: false, runId, phase: '', reason: 'host-unavailable' };
           }
-          const response = await api.stopAcpRun({ runId });
+          const response = unwrapRemoteResult(await api.stopAcpRun({ runId }));
           if (isPlainObject(response) && response.ok === false && response.error) {
             throw new Error(formatErrorMessage(response.error));
           }
@@ -1008,7 +1024,9 @@
         if (!remoteApi || typeof remoteApi.getAcpQuota !== 'function') {
           throw new Error('Host 端 dsh-agy-acp.getAcpQuota 服务未就绪');
         }
-        const response = await remoteApi.getAcpQuota(isPlainObject(options) ? options : { force: true });
+        const response = unwrapRemoteResult(
+          await remoteApi.getAcpQuota(isPlainObject(options) ? options : { force: true })
+        );
         if (isPlainObject(response) && response.ok === false && response.error) {
           throw new Error(formatErrorMessage(response.error));
         }
@@ -1187,9 +1205,10 @@
             order: PATCH_ORDER,
             label: () => (locale && typeof locale.bind === 'function' ? locale.bind(SETTINGS_NS)('title') : 'Antigravity ACP'),
             locale: SETTINGS_NS,
-            // api 允许设置页在连接就绪后补拉一次 snapshot.models；
-            // 拿不到时组件自动降级到内置静态目录，绝不阻塞渲染。
-            inject: () => ({ form, api: getAcpApi() }),
+            // api 是上面构造好的客户端封装（fetchSnapshot 已解包宿主网关信封），
+            // 传入后设置页能真正拉到宿主实测 snapshot.models；拿不到时组件自动降级到
+            // 内置静态目录，绝不阻塞渲染、也绝不让离线单测崩掉。
+            inject: () => ({ form, api }),
           }, AcpSettingsView))
         ));
         return () => {
@@ -1309,6 +1328,7 @@
     DEFAULT_SETTINGS,
     DEFAULT_MODEL_OPTIONS,
     MODEL_ACCESS_VALUES,
+    unwrapRemoteResult,
     normalizeModelCatalog,
     normalizeStringList,
     mergeModelCatalog,
@@ -1406,14 +1426,20 @@
 
     // 连接就绪后再补一次真实模型目录；任何异常（远程未挂载 / 未注入 api）都静默
     // 降级到内置静态目录，绝不阻塞渲染、也绝不让离线单测崩掉。
-    const snapshotApi =
-      props && props.api && typeof props.api.getAcpSnapshot === 'function' ? props.api : null;
+    // 两种注入形态都支持：本插件客户端封装 api.fetchSnapshot（已解包宿主网关
+    // { ok: true, value } 信封），以及宿主远程命名空间 api.getAcpSnapshot（这里再解一次）。
+    const snapshotApi = props && props.api ? props.api : null;
+    const useApiFetch = Boolean(snapshotApi && typeof snapshotApi.fetchSnapshot === 'function');
+    const canPullSnapshot =
+      useApiFetch || Boolean(snapshotApi && typeof snapshotApi.getAcpSnapshot === 'function');
     React.useEffect(() => {
-      if (!snapshotApi) return undefined;
+      if (!canPullSnapshot || !snapshotApi) return undefined;
       let cancelled = false;
       const pull = async () => {
         try {
-          const snap = await snapshotApi.getAcpSnapshot({ sessionId: GLOBAL });
+          const snap = useApiFetch
+            ? await snapshotApi.fetchSnapshot(GLOBAL)
+            : unwrapRemoteResult(await snapshotApi.getAcpSnapshot({ sessionId: GLOBAL }));
           if (cancelled) return;
           const models = normalizeModelCatalog(snap && snap.models);
           if (models.length > 0) setCatalogModels(models);
@@ -1425,7 +1451,7 @@
       return () => {
         cancelled = true;
       };
-    }, [snapshotApi]);
+    }, [canPullSnapshot, snapshotApi, useApiFetch]);
 
     const val = (state && state.value) || {};
     const isReady = state && state.status === 'ready';

package/docs/changelog.md

@@ -2,6 +2,17 @@
 
 [返回主页](../README.md) · [配置参考](configuration.md) · [接口参考](reference.md) · [开发与发布](development.md)
 
+## [0.1.3] - 2026-11-15
+
+### 修复
+- 修复真实宿主 `@deepseek-ai/dsh-api-gateway` 的一元 Remote 结果信封 `{ ok: true, value: <payload> }` 未解包的问题：`client.js` 新增 `unwrapRemoteResult()`（只剥成功信封；`ok: false` 失败信封与离线替身/旧宿主的裸 payload 一律原样返回），并接入 `fetchSnapshotOnce` / `stopRun` / `fetchQuotaOnce` 三处。
+  - 症状：面板快照恒为空、停止运行恒报 `stopped: false`、额度卡片读不到 `groups`，设置页也拿不到宿主实测模型列表。
+- 设置页 `settings.section` 槽位的 `inject` 改为传入已构造好的客户端封装 `api`（原为远程命名空间），并把 `AcpSettingsView` 的快照拉取改走 `api.fetchSnapshot`（仍兼容 `api.getAcpSnapshot` 形态并同样解包信封），真实桌面打开设置页即可把宿主实测模型合并进权限矩阵；离线测试只传 `{ form }` 时仍安全降级、绝不报错。
+
+### 测试
+- `test/acp-panel.test.mjs`：新增 `unwrapRemoteResult` 边界用例（成功信封 / 失败信封 / 裸 payload / `value: undefined`）、三处远程调用解包回归（`models`、`stopped: true`、`quota.groups`）、以及挂载后设置页注入 `api` 解包拉取 `models` 并合并进权限矩阵的回归。
+- `test/acp-quota.test.mjs`：新增 `api.fetchQuota` 解包网关信封后额度卡片读到 `groups`（0 余额精确保留）与失败信封继续抛错的回归。
+
 ## [0.1.2] - 2026-11-15
 
 ### 新增

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agy-acp",
   "displayName": "Antigravity ACP Worker",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Antigravity CLI (agy) ACP bridge for DeepSeek Harness: resumable worker turns, background job wakeup, semaphore queuing, four-tier permission gating, zero-sidecar SQLite token ledger, and on-demand quota inspection.",
   "license": "MIT",
   "author": "higekibaka",

package/src/acp-client.js

@@ -22,7 +22,7 @@ const executableMod = require('./executable.js');
 const imagesMod = require('./images.js');
 
 const PLUGIN_NAME = 'dsh-agy-acp';
-const PLUGIN_VERSION = '0.1.2';
+const PLUGIN_VERSION = '0.1.3';
 const PROTOCOL_VERSION = 1;
 const MAX_LINE_BYTES = 8 * 1024 * 1024;