dsh-home-ilife 0.3.83 → 0.3.85

package/dist/bridge.d.ts

@@ -1,3 +1,17 @@
+/** dsh-home-ilife 取数桥（P10 脚手架：纯 CLI 单轨）。
+ *
+ * #696 起兼设置页的配置读写口。
+ *
+ * 本文件只剩「本家的规格 ＋ 契约收窄」：机械动作（定位已装技能包、异步 spawn、超时杀进程、
+ * 信封校验、错误码映射）收进总管共用件 `dsh-life-pack` 根入口的 skill-cli 共用件——六家只有那一份实现。
+ * 边界不变：面板与跨技能只经 host.call 触发本桥，本桥只经 spawn 调技能包唯一出口
+ * packages/skill-home/dist/cli/cmd_read.js（argv+JSON+exit，stdout 纯 envelope JSON 一行）；
+ * 本文件不 import 任何技能实现（只读消费其 dist/CLI）；缺失阻断不返空：
+ * CLI 缺席/非 0/非 JSON/回执 key 不符一律抛错，绝不返回空数组冒充正常。
+ * 技能包不动（只读）；combos.yaml 不动。
+ */
+import { resolveNodeBin, SPAWN_TIMEOUT_MS } from 'dsh-life-pack';
+import type { SkillCliErrorCode } from 'dsh-life-pack';
 import type { ConfigSurfaceReply } from './contract.js';
 export declare const SKILL_PACKAGE: "skill-home";
 export declare const SKILL_CLI: "packages/skill-home/dist/cli/cmd_read.js";
@@ -5,40 +19,30 @@ export declare const HOST_CALL_METHOD: "ilife.home.read";
 export declare const MANAGER_PACKAGE: "dsh-life-pack";
 export declare const MANAGER_MISSING_HINT = "\u603B\u7BA1\u7F3A\u5E2D\uFF0C\u8BF7\u8865\u88C5\uFF1Adsh plugin add dsh-life-pack dsh-home-ilife\uFF08\u4E0D\u8BB8\u5355\u5378\u603B\u7BA1\uFF09";
 export declare class SkillBridgeError extends Error {
-    readonly code: 'missing-cli' | 'fetch-failed' | 'bad-json' | 'key-mismatch';
-    constructor(code: SkillBridgeError['code'], message: string);
+    readonly code: SkillCliErrorCode;
+    constructor(code: SkillCliErrorCode, message: string);
 }
 /** 包内 CLI 相对路径（相对技能包根，与 SKILL_CLI 尾段一致）。 */
 export declare const SKILL_CLI_REL: "dist/cli/cmd_read.js";
 export declare function cliPath(): string;
 export declare function assertCliPresent(path?: string): void;
 /** host.call 侧处理函数：由 host 注册到 connection RPC，供面板调用。 */
-export declare function handleHostCall(key: string, params?: Record<string, unknown>): unknown;
+export declare function handleHostCall(key: string, params?: Record<string, unknown>): Promise<unknown>;
 /** 面板侧请求函数：只经 host.call，不直调技能实现。 */
 export declare function requestViaHost(host: {
     call(method: string, args: unknown): Promise<unknown>;
 }, key: string, params?: Record<string, unknown>): Promise<unknown>;
-/** spawn 超时毫秒：子进程超期未退即杀掉，转 fetch-failed，绝不无限挂起。
- * #48 真机根因：Desktop 宿主的 process.execPath 是 Electron 二进制，直 spawn 会起 GUI 子进程永不退出。 */
-export declare const SPAWN_TIMEOUT_MS: 20000;
-/** node 可执行体解析（纯函数，execPath 可注入单测）。
- * execPath 是 node 即直用；否则（Electron 宿主）沿用该二进制但加官方 ELECTRON_RUN_AS_NODE 语义当 node 用。
- * #696：本文件原先是 `spawnSync(process.execPath, …)` 且不传 env —— 桌面宿主里那会起一个 GUI 子进程，
- * 配置读写与取数都拿不到回执。照卡路里／记账／大厨三家补齐。 */
-export declare function resolveNodeBin(execPath?: string): {
-    readonly bin: string;
-    readonly extraEnv: Record<string, string>;
-};
-/** 同步取数：spawn 技能 cmd_read，返回 envelope data（缺失阻断）。 */
-export declare function readViaCli(key: string, params?: Record<string, unknown>): unknown;
+/** 异步取数：spawn 技能 cmd_read，返回 envelope data（缺失阻断）。 */
+export declare function readViaCli(key: string, params?: Record<string, unknown>): Promise<unknown>;
+export { resolveNodeBin, SPAWN_TIMEOUT_MS };
 /** 设置页的三个配置 key。
  *
  * **唯一定义地是技能侧** `packages/skill-home/src/cli/config.ts` 的 `CONFIG_KEYS`
  * （那里写了「插件侧镜像同值」）；本处只是镜像，值改一处要两处一起改，
- * 对齐由 `test/config-surface-696.test.mjs` 锁死。
+ * 对齐由 `test/config-surface-*.test.mjs` 锁死。
  *
  * 为什么走 CLI 而不在插件里读盘：单品插件的冻结边界是「只读消费技能 dist／CLI，纯 CLI 单轨」
- * （`test/plugin-p10-boundaries.test.mjs`：单品不 import `base-*`、不 import `skill-*`，
+ * （`test/plugin-p10-boundaries.test.mjs`：单品不 import `base-`、不 import `skill-`，
  * 必须经 host.call 与 spawn 到 cmd_read）。配置文件的读写实现住技能的 `src/config.ts`，
  * 插件只经这三个 key 取用——同一份实现不抄第二处。
  */
@@ -48,19 +52,18 @@ export declare const CONFIG_RESET_KEY: "home.config.reset";
 /** #706 配置体检：只读一条，回一份报告（判据由技能侧出，本包只透传，不重写一个字）。 */
 export declare const CONFIG_CHECK_KEY: "home.config.check";
 /** 设置页整面：文件在哪、数据在哪、当前值、是不是这次新建的（取自技能 `home.config.read`）。 */
-export declare function readConfigSurface(): ConfigSurfaceReply;
+export declare function readConfigSurface(): Promise<ConfigSurfaceReply>;
 /** 保存一份配置（技能侧按键覆盖，组里没给的子项保留现值；写出去的是完整一份）。 */
-export declare function writeConfigValues(values: Record<string, unknown>): {
+export declare function writeConfigValues(values: Record<string, unknown>): Promise<{
     path: string;
     values: Record<string, unknown>;
-};
+}>;
 /** 重置为默认（技能侧先另存 `<配置目录>/home.yaml.bak`）。 */
-export declare function resetConfigToDefaults(): {
+export declare function resetConfigToDefaults(): Promise<{
     path: string;
     backupPath: string | null;
-};
+}>;
 /** 配置体检（#706）：只读一份报告，面板侧**不校验也不重写**——形状的唯一真相在技能侧
- *  `packages/skill-home/src/health.ts`，认形状是面板的事
- *  （`packages/plugin-manager/src/health-contract.ts`）。 */
-export declare function readConfigHealth(): unknown;
+ *  `packages/skill-home/src/health.ts`，认形状是面板的事（`packages/plugin-manager/src/health-contract.ts`）。 */
+export declare function readConfigHealth(): Promise<unknown>;
 //# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,eAAO,MAAM,aAAa,EAAG,YAAqB,CAAC;AACnD,eAAO,MAAM,SAAS,EAAG,0CAAmD,CAAC;AAC7E,eAAO,MAAM,gBAAgB,EAAG,iBAA0B,CAAC;AAC3D,eAAO,MAAM,eAAe,EAAG,eAAwB,CAAC;AAExD,eAAO,MAAM,oBAAoB,sJAC+B,CAAC;AAEjE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,CAAC;gBAChE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK5D;AAMD,4CAA4C;AAC5C,eAAO,MAAM,aAAa,EAAG,sBAA+B,CAAC;AAe7D,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAOpD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAEzF;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnK;AAED;kFACkF;AAClF,eAAO,MAAM,gBAAgB,EAAG,KAAe,CAAC;AAEhD;;;mCAGmC;AACnC,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAyB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAGvI;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAwBrF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAG,kBAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAC7D,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAC7D,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAE7D,6DAA6D;AAC7D,wBAAgB,iBAAiB,IAAI,kBAAkB,CAEtD;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAEpH;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAEnF;AAED;;0DAE0D;AAC1D,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAwB,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,eAAO,MAAM,aAAa,EAAG,YAAqB,CAAC;AACnD,eAAO,MAAM,SAAS,EAAG,0CAAmD,CAAC;AAC7E,eAAO,MAAM,gBAAgB,EAAG,iBAA0B,CAAC;AAC3D,eAAO,MAAM,eAAe,EAAG,eAAwB,CAAC;AAExD,eAAO,MAAM,oBAAoB,sJAC+B,CAAC;AAEjE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBACrB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAKrD;AAED,4CAA4C;AAC5C,eAAO,MAAM,aAAa,EAAG,sBAA+B,CAAC;AAY7D,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAElG;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnK;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9F;AAED,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAG,kBAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAC7D,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAC7D,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAE7D,6DAA6D;AAC7D,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAE/D;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAE7H;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAE5F;AAED;sGACsG;AACtG,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEnD"}

package/dist/bridge.js

@@ -1,16 +1,16 @@
-/** dsh-home-ilife 取数桥（P10 脚手架：纯 CLI 单轨；#696 起兼设置页的配置读写口）。
+/** dsh-home-ilife 取数桥（P10 脚手架：纯 CLI 单轨）。
  *
- * 面板与跨技能只经 host.call 触发本桥，本桥只经 spawn 调技能包唯一出口
- * packages/skill-home/dist/cli/cmd_read.js（argv+JSON+exit，stdout 纯 envelope JSON 一行）。
+ * #696 起兼设置页的配置读写口。
+ *
+ * 本文件只剩「本家的规格 ＋ 契约收窄」：机械动作（定位已装技能包、异步 spawn、超时杀进程、
+ * 信封校验、错误码映射）收进总管共用件 `dsh-life-pack` 根入口的 skill-cli 共用件——六家只有那一份实现。
+ * 边界不变：面板与跨技能只经 host.call 触发本桥，本桥只经 spawn 调技能包唯一出口
+ * packages/skill-home/dist/cli/cmd_read.js（argv+JSON+exit，stdout 纯 envelope JSON 一行）；
  * 本文件不 import 任何技能实现（只读消费其 dist/CLI）；缺失阻断不返空：
  * CLI 缺席/非 0/非 JSON/回执 key 不符一律抛错，绝不返回空数组冒充正常。
  * 技能包不动（只读）；combos.yaml 不动。
  */
-import { spawnSync } from 'node:child_process';
-import { accessSync, constants } from 'node:fs';
-import { createRequire } from 'node:module';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { createSkillCliBridge, resolveNodeBin, SPAWN_TIMEOUT_MS } from 'dsh-life-pack';
 export const SKILL_PACKAGE = 'skill-home';
 export const SKILL_CLI = 'packages/skill-home/dist/cli/cmd_read.js';
 export const HOST_CALL_METHOD = 'ilife.home.read';
@@ -24,93 +24,44 @@ export class SkillBridgeError extends Error {
         this.code = code;
     }
 }
-function repoRoot() {
-    return join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
-}
 /** 包内 CLI 相对路径（相对技能包根，与 SKILL_CLI 尾段一致）。 */
 export const SKILL_CLI_REL = 'dist/cli/cmd_read.js';
-/** 按包名解析技能出口（#50 修法①之二，照抄 #48 卡路里样板）：createRequire 定位技能包（SKILL_PACKAGE）
- * 的 package.json，再拼包内 dist/cli/cmd_read.js。只读消费其 dist/CLI（spawn），
- * 绝不 import 技能实现。包名解析失败回退单仓相对路径；两者皆无由 assertCliPresent
- * 抛 missing-cli（缺失阻断不返空）。 */
-function resolveSkillCli() {
-    try {
-        const pkgJson = createRequire(import.meta.url).resolve(SKILL_PACKAGE + '/package.json');
-        return join(dirname(pkgJson), SKILL_CLI_REL);
-    }
-    catch {
-        return join(repoRoot(), SKILL_CLI);
-    }
-}
+/** 本家的桥：规格只此一份（出口在哪、错误类是谁）。 */
+const bridge = createSkillCliBridge({
+    skillPackage: SKILL_PACKAGE,
+    repoRelativeCli: SKILL_CLI,
+    packageRelativeCli: SKILL_CLI_REL,
+    moduleUrl: import.meta.url,
+    hostCallMethod: HOST_CALL_METHOD,
+    makeError: (code, message) => new SkillBridgeError(code, message),
+});
 export function cliPath() {
-    return resolveSkillCli();
+    return bridge.cliPath();
 }
 export function assertCliPresent(path) {
-    const p = path ?? cliPath();
-    try {
-        accessSync(p, constants.R_OK);
-    }
-    catch {
-        throw new SkillBridgeError('missing-cli', '技能出口缺失（先构建对应包）：' + p);
-    }
+    bridge.assertCliPresent(path);
 }
 /** host.call 侧处理函数：由 host 注册到 connection RPC，供面板调用。 */
 export function handleHostCall(key, params = {}) {
-    return readViaCli(key, params);
+    return bridge.handleHostCall(key, params);
 }
 /** 面板侧请求函数：只经 host.call，不直调技能实现。 */
 export function requestViaHost(host, key, params = {}) {
-    return host.call(HOST_CALL_METHOD, { key, params });
-}
-/** spawn 超时毫秒：子进程超期未退即杀掉，转 fetch-failed，绝不无限挂起。
- * #48 真机根因：Desktop 宿主的 process.execPath 是 Electron 二进制，直 spawn 会起 GUI 子进程永不退出。 */
-export const SPAWN_TIMEOUT_MS = 20_000;
-/** node 可执行体解析（纯函数，execPath 可注入单测）。
- * execPath 是 node 即直用；否则（Electron 宿主）沿用该二进制但加官方 ELECTRON_RUN_AS_NODE 语义当 node 用。
- * #696：本文件原先是 `spawnSync(process.execPath, …)` 且不传 env —— 桌面宿主里那会起一个 GUI 子进程，
- * 配置读写与取数都拿不到回执。照卡路里／记账／大厨三家补齐。 */
-export function resolveNodeBin(execPath = process.execPath) {
-    if (/(^|[\\/])node(\.exe)?$/i.test(execPath))
-        return { bin: execPath, extraEnv: {} };
-    return { bin: execPath, extraEnv: { ELECTRON_RUN_AS_NODE: '1' } };
+    return bridge.requestViaHost(host, key, params);
 }
-/** 同步取数：spawn 技能 cmd_read，返回 envelope data（缺失阻断）。 */
+/** 异步取数：spawn 技能 cmd_read，返回 envelope data（缺失阻断）。 */
 export function readViaCli(key, params = {}) {
-    const bin = cliPath();
-    assertCliPresent(bin);
-    const { bin: node, extraEnv } = resolveNodeBin();
-    const r = spawnSync(node, [bin, key, '--params', JSON.stringify(params)], { encoding: 'utf8', timeout: SPAWN_TIMEOUT_MS, env: { ...process.env, ...extraEnv } });
-    if (r.error) {
-        if (r.error?.code === 'ETIMEDOUT') {
-            throw new SkillBridgeError('fetch-failed', '出口超 ' + String(SPAWN_TIMEOUT_MS / 1000) + 's 未退，已杀掉（宿主非 node 时见 resolveNodeBin）');
-        }
-        throw new SkillBridgeError('fetch-failed', '出口 spawn 失败：' + r.error.message);
-    }
-    if (r.status !== 0) {
-        const tail = String(r.stderr ?? '').trim().split('\n').pop() ?? '';
-        throw new SkillBridgeError('fetch-failed', '出口非 0（' + String(r.status) + '）：' + tail);
-    }
-    let env;
-    try {
-        env = JSON.parse(String(r.stdout));
-    }
-    catch {
-        throw new SkillBridgeError('bad-json', '出口非 JSON');
-    }
-    if (!env || env.key !== key)
-        throw new SkillBridgeError('key-mismatch', '出口回执 key 不符');
-    if (env.data === null || env.data === undefined)
-        throw new SkillBridgeError('fetch-failed', '缺失阻断取数，不返空：' + key);
-    return env.data;
+    return bridge.readViaCli(key, params);
 }
+export { resolveNodeBin, SPAWN_TIMEOUT_MS };
 /** 设置页的三个配置 key。
  *
  * **唯一定义地是技能侧** `packages/skill-home/src/cli/config.ts` 的 `CONFIG_KEYS`
  * （那里写了「插件侧镜像同值」）；本处只是镜像，值改一处要两处一起改，
- * 对齐由 `test/config-surface-696.test.mjs` 锁死。
+ * 对齐由 `test/config-surface-*.test.mjs` 锁死。
  *
  * 为什么走 CLI 而不在插件里读盘：单品插件的冻结边界是「只读消费技能 dist／CLI，纯 CLI 单轨」
- * （`test/plugin-p10-boundaries.test.mjs`：单品不 import `base-*`、不 import `skill-*`，
+ * （`test/plugin-p10-boundaries.test.mjs`：单品不 import `base-`、不 import `skill-`，
  * 必须经 host.call 与 spawn 到 cmd_read）。配置文件的读写实现住技能的 `src/config.ts`，
  * 插件只经这三个 key 取用——同一份实现不抄第二处。
  */
@@ -121,20 +72,19 @@ export const CONFIG_RESET_KEY = 'home.config.reset';
 export const CONFIG_CHECK_KEY = 'home.config.check';
 /** 设置页整面：文件在哪、数据在哪、当前值、是不是这次新建的（取自技能 `home.config.read`）。 */
 export function readConfigSurface() {
-    return readViaCli(CONFIG_READ_KEY, {});
+    return bridge.readViaCli(CONFIG_READ_KEY);
 }
 /** 保存一份配置（技能侧按键覆盖，组里没给的子项保留现值；写出去的是完整一份）。 */
 export function writeConfigValues(values) {
-    return readViaCli(CONFIG_WRITE_KEY, { values });
+    return bridge.readViaCli(CONFIG_WRITE_KEY, { values });
 }
 /** 重置为默认（技能侧先另存 `<配置目录>/home.yaml.bak`）。 */
 export function resetConfigToDefaults() {
-    return readViaCli(CONFIG_RESET_KEY, {});
+    return bridge.readViaCli(CONFIG_RESET_KEY);
 }
 /** 配置体检（#706）：只读一份报告，面板侧**不校验也不重写**——形状的唯一真相在技能侧
- *  `packages/skill-home/src/health.ts`，认形状是面板的事
- *  （`packages/plugin-manager/src/health-contract.ts`）。 */
+ *  `packages/skill-home/src/health.ts`，认形状是面板的事（`packages/plugin-manager/src/health-contract.ts`）。 */
 export function readConfigHealth() {
-    return readViaCli(CONFIG_CHECK_KEY, {});
+    return bridge.readViaCli(CONFIG_CHECK_KEY);
 }
 //# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -39,8 +39,21 @@ window.__ModuleLoader__.load({
 		* 维护者裁定**整条删除、删后不另找地方说**——理由：三家高级项全是只读行、不参与保存、根本没有"留空"，
 		* 而"留空会怎样"这条口径本就逐行住在每条的 `hint` 里（见本件 `ConfigItem.hint` 的契约）。 */
 		const ADVANCED_GROUP_TITLE = "高级";
-		/** 请求超时毫秒：与宿主侧 SPAWN_TIMEOUT_MS 同级，界面永不无限转圈。 */
-		const READ_TIMEOUT_MS = 2e4;
+		/** 面板读整面（config.get）的请求超时毫秒：界面永不无限转圈。
+		*
+		* 只作用于**面板首帧读整面**这一条路；宿主侧 `skill-cli/contract.ts` 的 SPAWN_TIMEOUT_MS（20s）
+		* 是 CLI spawn 进程自身的上限，两者不是同一个数、也不再「同级」——别拿这条去推断宿主侧时限。
+		*
+		* #1302：20s → 6s。机器级抖动下单次 CLI spawn 实测会到 10.3s／10.4s，20s 让一次慢例先空等 20s
+		* 才进重试；6s 落在验收带 5–8s 内（正常读回 <1s，不会误伤）。各插件包里另外那几条单次读时限
+		* （体检、版本、取数）是别的读路，按票面「本次不做」保持原值。 */
+		const READ_TIMEOUT_MS = 6e3;
+		/** 保存／重置（config.save／config.reset）的请求超时毫秒：#1302 只收**读整面**这一条路，写路保持 20s。
+		*
+		* 为什么不能跟着读一起收：写路不重试、不进预算（见上面 CONFIG_READ_RETRY_MS），而宿主侧 spawn 一个
+		* CLI 进程最多给 20s（`skill-cli/contract.ts` 的 SPAWN_TIMEOUT_MS）；慢例 spawn 实测到 10.3s，
+		* 若写路也 6s，界面会先判失败而宿主可能已经写成功——把一次成功的保存说成失败。 */
+		const WRITE_TIMEOUT_MS = 2e4;
 		/** 快路径首帧有界重试表（#1142，照 #982 更新目标表同值：瞬时未就绪不再整面失败）。
 		*
 		* 有界、调用方负责卸载清理（见 `config-panel.ts` 的取数），不是无界轮询；仅读整面用，保存／重置永不自动重试。 */
@@ -207,8 +220,11 @@ window.__ModuleLoader__.load({
 				}, ms);
 			});
 		}
-		/** 一次配置电话（走调用方给的那条通道，靠端点名分发；永不抛，失败落字，文案自带通道与下一步）。 */
-		async function configRpcOnce(call, channel, method, payload) {
+		/** 一次配置电话（走调用方给的那条通道，靠端点名分发；永不抛，失败落字，文案自带通道与下一步）。
+		*
+		* `timeoutMs` 由调用方按读路／写路给（#1302：读整面 6s 收口，保存／重置保持 20s）；
+		* 超时文案里的秒数也从它算，别在这里写死常量。 */
+		async function configRpcOnce(call, channel, method, payload, timeoutMs = READ_TIMEOUT_MS) {
 			if (typeof call !== "function") return {
 				ok: false,
 				message: `宿主连接缺席：connection.rpc.call 不可用（通道 ${channel}），稍后重试`
@@ -217,7 +233,7 @@ window.__ModuleLoader__.load({
 				const raw = await withDeadline(call("/api", channel.replace(/^\//, ""), {
 					method,
 					payload
-				}, AbortSignal.timeout(READ_TIMEOUT_MS)), READ_TIMEOUT_MS);
+				}, AbortSignal.timeout(timeoutMs)), timeoutMs);
 				if (!isRpcResult(raw)) return {
 					ok: false,
 					message: `回执信封异常（通道 ${channel}），点重试重新读取`
@@ -233,7 +249,7 @@ window.__ModuleLoader__.load({
 			} catch (e) {
 				if (e instanceof Error && (e.name === "AbortError" || e.name === "TimeoutError")) return {
 					ok: false,
-					message: `配置请求超时（${Math.round(READ_TIMEOUT_MS / 1e3)}s，通道 ${channel}）：宿主未回，点重试重新读取`
+					message: `配置请求超时（${Math.round(timeoutMs / 1e3)}s，通道 ${channel}）：宿主未回，点重试重新读取`
 				};
 				return {
 					ok: false,
@@ -246,10 +262,13 @@ window.__ModuleLoader__.load({
 			const delays = retry?.delays ?? [];
 			const sleepFn = retry?.sleep ?? retrySleep;
 			const alive = retry?.isAlive ?? (() => true);
+			const now = retry?.now ?? Date.now;
+			const deadline = now() + (retry?.budgetMs ?? 15e3);
 			let last = await configRpcOnce(call, channel, RPC_ENDPOINT_CONFIG_GET, {});
 			for (let i = 0; i < delays.length && !last.ok; i += 1) {
 				if (!alive()) return last;
 				const wait = delays[i] ?? 0;
+				if (now() + wait + 6e3 > deadline) break;
 				if (wait > 0) await sleepFn(wait);
 				if (!alive()) return last;
 				last = await configRpcOnce(call, channel, RPC_ENDPOINT_CONFIG_GET, {});
@@ -258,11 +277,11 @@ window.__ModuleLoader__.load({
 		}
 		/** 保存一份取值（回执只有 `{path, values}`，**不是**整面：写完要重新读一份整面；永不自动重试）。 */
 		function saveConfigSurface(call, channel, values) {
-			return configRpcOnce(call, channel, RPC_ENDPOINT_CONFIG_SAVE, { values });
+			return configRpcOnce(call, channel, RPC_ENDPOINT_CONFIG_SAVE, { values }, WRITE_TIMEOUT_MS);
 		}
 		/** 重置为默认（技能侧先落一份备份；回执同样不是整面，写完要重新读一份整面；永不自动重试）。 */
 		function resetConfigSurface(call, channel) {
-			return configRpcOnce(call, channel, RPC_ENDPOINT_CONFIG_RESET, {});
+			return configRpcOnce(call, channel, RPC_ENDPOINT_CONFIG_RESET, {}, WRITE_TIMEOUT_MS);
 		}
 		//#endregion
 		//#region ../plugin-manager/src/directory-browser-contract.ts