@zhushanwen/zcode-subagent-cli 0.6.0 → 0.8.0

package/dist/main.cjs

@@ -23,10 +23,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/main.ts
-var import_subagent_engine_sdk15 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk16 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/server.ts
-var import_subagent_engine_sdk14 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk15 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/constants.ts
 var ZCODE_ENGINE_ID = "zcode";
@@ -62,13 +62,13 @@ var ZCODE_RESUME_CHARS_PER_TOKEN = 4;
 var ZCODE_SESSION_SWEEP_DEFER_MS = 50;
 
 // src/registration.ts
-var import_subagent_engine_sdk12 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk13 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/zcode-engine.ts
 var fs6 = __toESM(require("fs"), 1);
 var path4 = __toESM(require("path"), 1);
-var import_subagent_engine_sdk10 = require("@zhushanwen/subagent-engine-sdk");
 var import_subagent_engine_sdk11 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk12 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/journal-io.ts
 var import_subagent_engine_sdk = require("@zhushanwen/subagent-engine-sdk");
@@ -139,6 +139,7 @@ function synthesizeCoarseEvents(response, usage) {
 var fs = __toESM(require("fs"), 1);
 var os2 = __toESM(require("os"), 1);
 var path2 = __toESM(require("path"), 1);
+var import_subagent_engine_sdk4 = require("@zhushanwen/subagent-engine-sdk");
 var ZcodePrepareError = class extends Error {
   code;
   constructor(code, message) {
@@ -147,35 +148,81 @@ var ZcodePrepareError = class extends Error {
     this.code = code;
   }
 };
+var TAIJI_SYNC_GUIDANCE = "\u82E5\u4F7F\u7528 taiji \u540C\u6B65\u526F\u672C/\u9ED8\u8BA4\u6A21\u578B\uFF0C\u5230 taiji settings \u6838\u5BF9\u6216\u91CD\u9009\uFF0C\u91CD\u542F taiji \u751F\u6548\u3002";
 function isRecord(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 function strArray(v) {
   return Array.isArray(v) ? v.filter((m) => typeof m === "string" && m.trim() !== "") : [];
 }
-function readSourceConfig(absPath) {
-  const empty = { providers: /* @__PURE__ */ new Map(), order: [] };
+function readSourceJsonOrUndefined(absPath) {
   let raw;
   try {
     raw = fs.readFileSync(absPath, "utf8");
   } catch {
-    return empty;
+    return void 0;
   }
-  let parsed;
   try {
-    parsed = JSON.parse(raw);
+    return JSON.parse(raw);
   } catch {
-    return empty;
-  }
-  if (!isRecord(parsed)) return empty;
-  const rules = parsed["config"]?.["providerConfigRules"];
-  const providerRules = !isRecord(rules) ? void 0 : rules["providerRules"];
-  const orderSrc = parsed["config"]?.["providerOrder"];
-  const conf = { providers: /* @__PURE__ */ new Map(), order: strArray(orderSrc) };
-  if (!Array.isArray(providerRules)) return conf;
-  collectProviderRules(providerRules, conf);
+    return void 0;
+  }
+}
+function extractSourceConfig(parsed) {
+  const conf = { providers: /* @__PURE__ */ new Map(), order: [] };
+  if (!isRecord(parsed)) return conf;
+  const config = parsed["config"];
+  if (!isRecord(config)) return conf;
+  conf.order = strArray(config["providerOrder"]);
+  const rules = config["providerConfigRules"];
+  const providerRules = isRecord(rules) ? rules["providerRules"] : void 0;
+  if (Array.isArray(providerRules)) collectProviderRules(providerRules, conf);
   return conf;
 }
+function readSourceConfig(absPath) {
+  return extractSourceConfig(readSourceJsonOrUndefined(absPath));
+}
+function mergePersonalProviderConfig(realObj, copyObj) {
+  if (!isRecord(copyObj)) return realObj;
+  if (!isRecord(realObj)) return copyObj;
+  const cfgOf = (obj) => isRecord(obj["config"]) ? obj["config"] : {};
+  const rulesOf = (obj) => {
+    const pcr = cfgOf(obj)["providerConfigRules"];
+    const rules = isRecord(pcr) ? pcr["providerRules"] : void 0;
+    return Array.isArray(rules) ? rules : [];
+  };
+  const mergedRules = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const rule of rulesOf(realObj)) {
+    mergedRules.push(rule);
+    if (isRecord(rule)) {
+      const id = rule["providerId"];
+      if (typeof id === "string" && id !== "") seen.add(id);
+    }
+  }
+  for (const rule of rulesOf(copyObj)) {
+    if (!isRecord(rule)) continue;
+    const id = rule["providerId"];
+    if (typeof id !== "string" || id === "") continue;
+    if (seen.has(id)) continue;
+    seen.add(id);
+    mergedRules.push(rule);
+  }
+  const mergedOrder = [];
+  for (const id of [...strArray(cfgOf(realObj)["providerOrder"]), ...strArray(cfgOf(copyObj)["providerOrder"])]) {
+    if (!mergedOrder.includes(id)) mergedOrder.push(id);
+  }
+  const realCfg = cfgOf(realObj);
+  const realPcr = isRecord(realCfg["providerConfigRules"]) ? realCfg["providerConfigRules"] : {};
+  return {
+    ...realObj,
+    config: {
+      ...realCfg,
+      providerOrder: mergedOrder,
+      providerConfigRules: { ...realPcr, providerRules: mergedRules }
+    }
+  };
+}
 function collectProviderRules(providerRules, conf) {
   for (const rule of providerRules) {
     if (!isRecord(rule)) continue;
@@ -210,6 +257,40 @@ function defaultPersonalProviderConfigPath() {
 function defaultV2ConfigPath() {
   return path2.join(os2.homedir(), ...ZCODE_V2_CONFIG_PATH_SUFFIX);
 }
+function piSyncedProviderConfigPath(engineDataDir) {
+  return path2.join(engineDataDir, ...import_subagent_engine_sdk4.ZCODE_PI_SYNCED_PROVIDER_CONFIG_SEGMENTS);
+}
+function envEngineDataDirOrUndefined() {
+  try {
+    return (0, import_subagent_engine_sdk4.resolveEngineDataDir)(process.env);
+  } catch {
+    return void 0;
+  }
+}
+function resolvePersonalProviderSource(sources, engineDataDir) {
+  const explicit = sources?.personalProviderConfigPath;
+  if (explicit !== void 0) return { kind: "explicit", path: explicit };
+  const dataDir = engineDataDir ?? envEngineDataDirOrUndefined();
+  if (dataDir !== void 0 && fs.existsSync(piSyncedProviderConfigPath(dataDir))) {
+    return { kind: "copy", path: piSyncedProviderConfigPath(dataDir), realPath: defaultPersonalProviderConfigPath() };
+  }
+  return { kind: "real", path: defaultPersonalProviderConfigPath() };
+}
+function resolvePersonalProviderConfigPath(sources, engineDataDir) {
+  return resolvePersonalProviderSource(sources, engineDataDir).path;
+}
+function readPersonalProviderView(sources) {
+  const resolution = resolvePersonalProviderSource(sources);
+  if (resolution.kind !== "copy") {
+    return { conf: readSourceConfig(resolution.path), sourceDesc: resolution.path };
+  }
+  const copyJson = readSourceJsonOrUndefined(resolution.path);
+  const realJson = readSourceJsonOrUndefined(resolution.realPath);
+  return {
+    conf: extractSourceConfig(mergePersonalProviderConfig(realJson, copyJson)),
+    sourceDesc: `merge(\u771F\u5B9E ${resolution.realPath} + \u526F\u672C ${resolution.path})`
+  };
+}
 var SEMVER_SEGMENTS = 3;
 function locateZcodeBuiltinCatalog(sources) {
   if (sources?.builtinCatalogPath !== void 0) return sources.builtinCatalogPath;
@@ -256,21 +337,6 @@ function locateZcodeBuiltinCatalog(sources) {
   }
   return void 0;
 }
-function resolveZcodeMinimalReasoningLevel(modelRef, sources) {
-  const catalogPath = locateZcodeBuiltinCatalog(sources);
-  if (catalogPath === void 0) return void 0;
-  let parsed;
-  try {
-    parsed = JSON.parse(fs.readFileSync(catalogPath, "utf8"));
-  } catch {
-    return void 0;
-  }
-  const modelId = modelShort(modelRef);
-  const rules = parsed["config"];
-  const modelRules = isRecord(rules) && isRecord(rules["modelConfigRules"]) ? rules["modelConfigRules"]["modelRules"] : void 0;
-  if (!Array.isArray(modelRules)) return void 0;
-  return lastMatchingReasoningValues(modelRules, modelId)?.[0];
-}
 function lastMatchingReasoningValues(modelRules, modelId) {
   let values;
   for (const rule of modelRules) {
@@ -279,7 +345,7 @@ function lastMatchingReasoningValues(modelRules, modelId) {
     if (typeof match !== "string") continue;
     let re;
     try {
-      re = new RegExp(match);
+      re = new RegExp(match, "i");
     } catch {
       continue;
     }
@@ -291,6 +357,21 @@ function lastMatchingReasoningValues(modelRules, modelId) {
   }
   return values;
 }
+function resolveZcodeReasoningValues(modelRef, sources) {
+  const catalogPath = locateZcodeBuiltinCatalog(sources);
+  if (catalogPath === void 0) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(catalogPath, "utf8"));
+  } catch {
+    return void 0;
+  }
+  const modelId = modelShort(modelRef);
+  const rules = parsed["config"];
+  const modelRules = isRecord(rules) && isRecord(rules["modelConfigRules"]) ? rules["modelConfigRules"]["modelRules"] : void 0;
+  if (!Array.isArray(modelRules)) return void 0;
+  return lastMatchingReasoningValues(modelRules, modelId);
+}
 function defaultProviderForShortName(conf, withKey) {
   const ordered = conf.order.find((id) => {
     const entry = conf.providers.get(id);
@@ -299,19 +380,65 @@ function defaultProviderForShortName(conf, withKey) {
   if (ordered !== void 0) return ordered;
   return withKey[0][0];
 }
+function resolveAccountModelRef(wanted, wantedProvider, sources) {
+  const catalogPath = locateZcodeBuiltinCatalog(sources);
+  if (catalogPath === void 0) {
+    throw new ZcodePrepareError(
+      "model_not_available",
+      `account \u6A21\u578B "${wanted}" \u65E0\u6CD5\u6821\u9A8C\uFF1A\u5185\u5EFA\u76EE\u5F55\u5B9A\u4F4D\u5931\u8D25\uFF08ZCODE_BUILTIN_PROVIDER_CONFIG_FILE \u4E0E runtime/provider \u626B\u63CF\u5747\u672A\u547D\u4E2D\uFF09\u3002`
+    );
+  }
+  let catalog;
+  try {
+    catalog = JSON.parse(fs.readFileSync(catalogPath, "utf8"));
+  } catch (err) {
+    throw new ZcodePrepareError(
+      "model_not_available",
+      `account \u6A21\u578B "${wanted}" \u65E0\u6CD5\u6821\u9A8C\uFF1A\u5185\u5EFA\u76EE\u5F55\u4E0D\u53EF\u8BFB\uFF08${err instanceof Error ? err.message : String(err)}\uFF09\u3002`
+    );
+  }
+  const accountRule = findAccountProviderRule(catalog, wantedProvider);
+  if (accountRule === void 0) {
+    throw new ZcodePrepareError(
+      "model_not_available",
+      `\u672A\u77E5 account provider "${wantedProvider}"\uFF08\u5185\u5EFA\u76EE\u5F55\u65E0\u6B64\u89C4\u5219\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u76EE\u5F55\u5185 account:* \u89C4\u5219\uFF08\u5982 account:zai-individual-coding-plan / account:bigmodel-individual-coding-plan\uFF09\u3002`
+    );
+  }
+  assertAccountModelKnown(accountRule, wanted, wantedProvider);
+  return wanted;
+}
+function findAccountProviderRule(catalog, wantedProvider) {
+  const catalogRules = isRecord(catalog) && isRecord(catalog["config"]) && isRecord(catalog["config"]["providerConfigRules"]) ? catalog["config"]["providerConfigRules"]["providerRules"] : void 0;
+  const accountRule = Array.isArray(catalogRules) ? catalogRules.find((r) => isRecord(r) && r["providerId"] === wantedProvider) : void 0;
+  return isRecord(accountRule) ? accountRule : void 0;
+}
+function assertAccountModelKnown(accountRule, wanted, wantedProvider) {
+  const accountConfig = isRecord(accountRule["config"]) ? accountRule["config"] : {};
+  const modelIds = accountConfig["builtinModelIds"] ?? accountConfig["personalModelIds"];
+  const short = modelShort(wanted);
+  if (Array.isArray(modelIds) && modelIds.length > 0 && !modelIds.includes(short)) {
+    throw new ZcodePrepareError(
+      "model_not_available",
+      `\u672A\u77E5\u6A21\u578B "${short}"\uFF08account provider ${wantedProvider} \u4E0B\u53EF\u7528: ${modelIds.join(", ")}\uFF09\u3002`
+    );
+  }
+}
 function resolveZcodeModelRef(requested, sources) {
-  const srcPath = sources?.personalProviderConfigPath ?? defaultPersonalProviderConfigPath();
-  const conf = readSourceConfig(srcPath);
+  const { conf, sourceDesc } = readPersonalProviderView(sources);
   const withKey = [...conf.providers.entries()].filter(([, e]) => hasApiKey(e));
   const wanted = requested?.trim() || void 0;
   if (withKey.length === 0) {
     const hint = wanted ? `model="${wanted}" \u4E0D\u80FD\u6821\u9A8C` : "\u7F3A\u7701\u6A21\u578B\u89E3\u6790\u4E0D\u80FD\u6821\u9A8C";
     throw new ZcodePrepareError(
       "engine_credential_missing",
-      `zcode \u5F15\u64CE\u627E\u4E0D\u5230\u4EFB\u4F55\u5E26 apiKey \u7684\u4E2A\u4EBA provider\uFF08${hint}\uFF09\u3002\u5DF2\u8BFB\u6E90\uFF1A${srcPath}\u3002\u6062\u590D\u6307\u5F15\uFF1A\u5728 ZCode \u684C\u9762\u7AEF\u914D\u7F6E\u81F3\u5C11\u4E00\u4E2A\u4E2A\u4EBA provider\uFF08provider_config.json \u5185\u5B58\u5728 config.access.apiKey \u975E\u7A7A\u6761\u76EE\uFF09\u540E\u91CD\u8BD5\uFF1Bplan \u5957\u9910\u65CF\uFF08builtin:/account: \u524D\u7F00\uFF09\u7ECF\u8D26\u53F7 entitlement \u95E8\u63A7\uFF0C\u5916\u90E8 spawn \u7684\u5F15\u64CE\u6CE8\u518C\u8868\u4E0D\u88C5\u8F7D\uFF0C\u4E0D\u53EF\u4F5C\u4E3A\u5F15\u64CE\u6A21\u578B\u3002`
+      `zcode \u5F15\u64CE\u627E\u4E0D\u5230\u4EFB\u4F55\u5E26 apiKey \u7684\u4E2A\u4EBA provider\uFF08${hint}\uFF09\u3002\u5DF2\u8BFB\u6E90\uFF1A${sourceDesc}\u3002\u6062\u590D\u6307\u5F15\uFF1A\u5728 ZCode \u684C\u9762\u7AEF\u914D\u7F6E\u81F3\u5C11\u4E00\u4E2A\u4E2A\u4EBA provider\uFF08provider_config.json \u5185\u5B58\u5728 config.access.apiKey \u975E\u7A7A\u6761\u76EE\uFF09\u540E\u91CD\u8BD5\uFF1Bplan \u5957\u9910\u65CF\uFF08builtin:/account: \u524D\u7F00\uFF09\u7ECF\u8D26\u53F7 entitlement \u95E8\u63A7\uFF0C\u5916\u90E8 spawn \u7684\u5F15\u64CE\u6CE8\u518C\u8868\u4E0D\u88C5\u8F7D\uFF0C\u4E0D\u53EF\u4F5C\u4E3A\u5F15\u64CE\u6A21\u578B\u3002` + TAIJI_SYNC_GUIDANCE
     );
   }
   if (wanted === void 0) return "";
+  const wantedProvider = wanted.includes("/") ? providerOf(wanted) : void 0;
+  if (wantedProvider !== void 0 && wantedProvider.startsWith("account:")) {
+    return resolveAccountModelRef(wanted, wantedProvider, sources);
+  }
   const provider = wanted.includes("/") ? providerOf(wanted) : defaultProviderForShortName(conf, withKey);
   const short = modelShort(wanted);
   const entry = conf.providers.get(provider);
@@ -319,26 +446,26 @@ function resolveZcodeModelRef(requested, sources) {
     const known = withKey.map(([id]) => id).join(", ");
     throw new ZcodePrepareError(
       "model_not_available",
-      `\u672A\u77E5 provider "${provider}"\uFF08\u5E26\u51ED\u636E\u7684\u4E2A\u4EBA provider: ${known}\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u4E0A\u8FF0 provider \u4E4B\u4E00\uFF08\u5168\u540D provider/model\uFF09\uFF0C\u6216\u5728 ZCode \u684C\u9762\u7AEF\u914D\u7F6E\u8BE5 provider \u540E\u91CD\u8BD5\uFF1B\u7701\u7565 model \u53C2\u6570\u5219\u8D70\u5F15\u64CE\u7F3A\u7701\u89E3\u6790\uFF08CLI \u81EA\u8EAB\u9009\u53D6\u53EF\u7528\u6A21\u578B\uFF09\u3002`
+      `\u672A\u77E5 provider "${provider}"\uFF08\u5E26\u51ED\u636E\u7684\u4E2A\u4EBA provider: ${known}\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u4E0A\u8FF0 provider \u4E4B\u4E00\uFF08\u5168\u540D provider/model\uFF09\uFF0C\u6216\u5728 ZCode \u684C\u9762\u7AEF\u914D\u7F6E\u8BE5 provider \u540E\u91CD\u8BD5\uFF1B\u7701\u7565 model \u53C2\u6570\u5219\u8D70\u5F15\u64CE\u7F3A\u7701\u89E3\u6790\uFF08CLI \u81EA\u8EAB\u9009\u53D6\u53EF\u7528\u6A21\u578B\uFF09\u3002` + TAIJI_SYNC_GUIDANCE
     );
   }
   if (!hasApiKey(entry)) {
     throw new ZcodePrepareError(
       "engine_credential_missing",
-      `provider "${provider}" \u5B58\u5728\u4F46\u672A\u914D\u7F6E apiKey\u3002\u6062\u590D\u6307\u5F15\uFF1A\u5728 ZCode \u684C\u9762\u7AEF\u4E3A\u8BE5 provider \u914D\u7F6E\u51ED\u636E\uFF0C\u6216\u6539\u7528\u5DF2\u914D\u51ED\u636E\u7684 provider\uFF08${withKey.map(([id]) => id).join(", ")}\uFF09\u540E\u91CD\u8BD5\u3002`
+      `provider "${provider}" \u5B58\u5728\u4F46\u672A\u914D\u7F6E apiKey\u3002\u6062\u590D\u6307\u5F15\uFF1A\u5728 ZCode \u684C\u9762\u7AEF\u4E3A\u8BE5 provider \u914D\u7F6E\u51ED\u636E\uFF0C\u6216\u6539\u7528\u5DF2\u914D\u51ED\u636E\u7684 provider\uFF08${withKey.map(([id]) => id).join(", ")}\uFF09\u540E\u91CD\u8BD5\u3002` + TAIJI_SYNC_GUIDANCE
     );
   }
   const models = entry.models ?? [];
   if (models.length > 0 && !models.includes(short)) {
     throw new ZcodePrepareError(
       "model_not_available",
-      `\u672A\u77E5\u6A21\u578B "${short}"\uFF08provider ${provider} \u4E0B\u53EF\u7528: ${models.join(", ")}\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u8BE5 provider \u4E0B\u7684\u6A21\u578B\uFF0C\u6216\u5728 ZCode \u684C\u9762\u7AEF\u542F\u7528\u76EE\u6807\u6A21\u578B\u540E\u91CD\u8BD5\u3002`
+      `\u672A\u77E5\u6A21\u578B "${short}"\uFF08provider ${provider} \u4E0B\u53EF\u7528: ${models.join(", ")}\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u8BE5 provider \u4E0B\u7684\u6A21\u578B\uFF0C\u6216\u5728 ZCode \u684C\u9762\u7AEF\u542F\u7528\u76EE\u6807\u6A21\u578B\u540E\u91CD\u8BD5\u3002` + TAIJI_SYNC_GUIDANCE
     );
   }
   return `${provider}/${short}`;
 }
 function listZcodeModels(sources) {
-  const conf = readSourceConfig(sources?.personalProviderConfigPath ?? defaultPersonalProviderConfigPath());
+  const { conf } = readPersonalProviderView(sources);
   const out = [];
   for (const [pid, entry] of conf.providers) {
     if (!hasApiKey(entry)) continue;
@@ -358,7 +485,7 @@ var fs2 = __toESM(require("fs"), 1);
 var path3 = __toESM(require("path"), 1);
 
 // src/error-message.ts
-var import_subagent_engine_sdk4 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk5 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/appserver-launcher.ts
 var ZCODE_APPSERVER_LAUNCHER_NAME = "appserver-launcher.cjs";
@@ -370,7 +497,12 @@ const os = require('node:os');
 
 const CLI_PATH = process.env.ZCODE_ENG_CLI_PATH;
 const V2_PATH = process.env.ZCODE_ENG_V2_CONFIG || path.join(os.homedir(), '.zcode', 'v2', 'config.json');
-const PROVIDER_CONFIG_PATH = process.env.ZCODE_ENG_PROVIDER_CONFIG || path.join(os.homedir(), '.zcode', 'v2', 'provider_config.json');
+// \u771F\u5B9E provider_config.json\uFF08Registry \u76F4\u8BFB\u8DEF\u5F84\uFF0CA0 \u63A2\u9488\u5B9E\u8BC1\uFF09\u2014\u2014\u4E0E CONFIG_PATH \u540C\u6B3E
+// homedir \u63A8\u5BFC\u5F62\u6001\uFF0C\u4E0D\u53D7 env \u91CD\u5B9A\u5411\uFF08merge \u5206\u652F\u8981\u8BFB\u7684\u6B63\u662F\u8FD9\u4E2A\u771F\u5B9E\u8DEF\u5F84\u672C\u8EAB\uFF09
+const REAL_PROVIDER_CONFIG_PATH = path.join(os.homedir(), '.zcode', 'v2', 'provider_config.json');
+// taiji \u540C\u6B65\u526F\u672C\u8DEF\u5F84\uFF08ZCODE_ENG_PROVIDER_CONFIG \u8BED\u4E49\u6536\u7A84\uFF1B'' = \u672A\u8BBE \u2192 merge \u5206\u652F\u4E0D\u6FC0\u6D3B\uFF09
+const PI_SYNCED_PATH = process.env.ZCODE_ENG_PROVIDER_CONFIG || '';
+const PROVIDER_CONFIG_PATH = process.env.ZCODE_ENG_PROVIDER_CONFIG || REAL_PROVIDER_CONFIG_PATH;
 const CONFIG_PATH = path.join(os.homedir(), '.zcode', 'cli', 'config.json');
 
 // \u5408\u5E76\u5F62\u6001\uFF1A\u771F\u5B9E cli config \u539F\u6837\uFF08model/plugins/mcp/subagents \u7B49 worker \u7EE7\u627F\u9762\u4E0D\u53D8\uFF09
@@ -393,7 +525,7 @@ function injectedConfigText() {
   let v2 = {};
   try { v2 = JSON.parse(readOrig(V2_PATH, 'utf8')); }
   catch (err) {
-    // ENOENT = \u684C\u9762\u7AEF\u672A\u767B\u5F55\uFF08\u6B63\u5E38 no-patch\uFF0C\u9759\u9ED8\uFF09\uFF1B\u5176\u4ED6\u5931\u8D25\uFF08JSON \u635F\u574F/\u6743\u9650\uFF09
+    // ENOENT = \u684C\u9762\u7AEF\u672A\u767B\u5F55\uFF08\u6B63\u5E38 no-patch\uFF0C\u4E0D\u6784\u6210\u9519\u8BEF\uFF1B\u8DF3\u8FC7\u51B3\u7B56\u7531\u5B89\u88C5\u95E8\u65E5\u5FD7\u627F\u8F7D\uFF09\uFF1B\u5176\u4ED6\u5931\u8D25\uFF08JSON \u635F\u574F/\u6743\u9650\uFF09
     // \u51FA\u58F0\u2014\u2014\u5426\u5219\u6392\u969C\u4F1A\u88AB\u539F\u751F\u300C\u8BF7\u767B\u5F55\u300D\u62A5\u9519\u8BEF\u5BFC\uFF0C\u4E0E\u771F\u56E0\uFF08\u6587\u4EF6\u635F\u574F\uFF09\u4E0D\u7B26
     if (!err || err.code !== 'ENOENT') {
       process.stderr.write('[zcode-launcher] v2 config \u8BFB\u53D6\u5931\u8D25(' + ((err && err.code) || (err && err.message) || 'unknown') + '): ' + V2_PATH + '\u2014\u2014\u51ED\u636E\u6CE8\u5165\u672A\u751F\u6548\\n');
@@ -448,11 +580,14 @@ function injectedConfigText() {
       for (const mid of order) {
         if (typeof mid === 'string' && mid !== '' && !(mid in models)) models[mid] = {};
       }
+      // kind \u6309\u6761\u76EE api.type \u6D3E\u751F\uFF08D3\uFF09\uFF1Aanthropic-messages \u2192 anthropic\uFF0C\u5176\u4F59
+      // \uFF08openai-chat-completions / api.type \u7F3A\u5E2D / \u672A\u77E5\u503C\uFF09\u2192 openai-compatible
+      // \u2014\u2014\u5BF9\u9F50 v2 config.json \u65E2\u6709 kind \u4E24\u503C\u5F62\u6001\uFF1B\u4F5C\u7528\u4E8E\u8865\u6CE8\u5165\u6BB5\u5168\u90E8\u6761\u76EE\uFF08\u542B\u900F\u4F20
+      // \u771F\u5B9E\u6761\u76EE\uFF0Canthropic \u534F\u8BAE\u771F\u5B9E\u6761\u76EE\u4ECE\u65E7\u9519\u914D\u503C openai-compatible \u987A\u5E26\u4FEE\u6B63\uFF09\u3002
+      // \u672A\u77E5\u534F\u8BAE\u503C\u9519\u914D\u65F6\u8BF7\u6C42\u671F\u534F\u8BAE\u9519\u8BEF\u53EF\u89C1\uFF08\u4E0D\u963B\u585E\u6CE8\u518C\u8868\u88C5\u8F7D\uFF09\uFF0C\u771F\u673A\u6F02\u79FB\u4FE1\u53F7\u660E\u786E
       injectable[id] = {
         name: typeof rule.providerName === 'string' ? rule.providerName : id,
-        // provider_config.json \u4E0D\u643A\u5E26\u534F\u8BAE\u5F62\u6001\u2014\u2014standard-personal \u7EC4\u4EE5 openai-compatible
-        // \u4E3A\u591A\u6570\u5148\u4F8B\uFF1B\u9519\u914D\u65F6\u8BF7\u6C42\u671F\u534F\u8BAE\u9519\u8BEF\u53EF\u89C1\uFF08\u4E0D\u963B\u585E\u6CE8\u518C\u8868\u88C5\u8F7D\uFF09\uFF0C\u771F\u673A\u6F02\u79FB\u4FE1\u53F7\u660E\u786E
-        kind: 'openai-compatible',
+        kind: api.type === 'anthropic-messages' ? 'anthropic' : 'openai-compatible',
         options: { apiKey: access.apiKey, baseURL: api.baseUrl },
         source: 'custom',
         models: models,
@@ -469,50 +604,148 @@ function injectedConfigText() {
   return JSON.stringify(merged);
 }
 
+// [merge-fn-start]\uFF08\u5BF9\u8D26\u5355\u6D4B\u63D0\u53D6\u951A\u2014\u2014appserver-launcher.test.ts \u6309\u6807\u8BB0\u622A\u53D6\u672C\u51FD\u6570
+// eval \u6267\u884C\uFF1Bpreparer.ts mergePersonalProviderConfig \u4E0E\u672C\u51FD\u6570\u540C\u89C4\u5219\u9501\u6B65\uFF0C\u6539\u4EFB\u4E00\u4FA7
+// \u987B\u540C\u6B65\u53E6\u4E00\u4FA7\u5E76\u8DD1\u5BF9\u8D26\u5355\u6D4B\uFF09
+// merge(\u771F\u5B9E, \u526F\u672C)\u2014\u2014D3 \u6362\u8F68\u7248\u89C4\u5219\uFF1A
+//   - \u526F\u672C\u975E\u5BF9\u8C61 \u2192 \u539F\u6837\u8FD4\u56DE real\uFF08\u526F\u672C\u7F3A\u5E2D\u56DE\u843D\u8BED\u4E49\uFF1Bwrapper \u4FA7\u66F4\u65E9\u77ED\u8DEF\uFF0C\u9632\u5FA1\u5F62\u6001\uFF09
+//   - \u771F\u5B9E\u975E\u5BF9\u8C61\uFF08ENOENT/\u635F\u574F\uFF09\u2192 \u539F\u6837\u8FD4\u56DE copy\uFF08\u526F\u672C\u72EC\u6709\u6761\u76EE\u4E3A\u5168\u96C6\uFF1AproviderRules
+//     \u4EC5\u526F\u672C\u6761\u76EE + order \u4EC5\u526F\u672C\u5E8F\uFF0C\u9876\u5C42\u5B57\u6BB5\u968F\u526F\u672C\u4FDD\u6301\u5F62\u6001\u5B8C\u6574\uFF09
+//   - providerRules\uFF1A\u771F\u5B9E\u6761\u76EE\u6574\u6761\u4FDD\u7559\u5728\u524D\uFF0C\u526F\u672C\u72EC\u6709 id \u8FFD\u52A0\uFF08\u771F\u5B9E\u4F18\u5148 = \u540C\u540D\u8BA9\u4F4D
+//     \u7684\u8FD0\u884C\u65F6\u7B2C\u4E8C\u9053\u9632\u7EBF\uFF09\uFF1B\u65E0\u6709\u6548 providerId \u7684\u526F\u672C\u6761\u76EE\u4E22\u5F03\uFF0C\u771F\u5B9E\u6761\u76EE\u539F\u6837\u4FDD\u7559
+//   - providerOrder\uFF1A\u771F\u5B9E\u73B0\u503C\u5E8F + \u526F\u672C\u72EC\u6709 id \u8FFD\u52A0\uFF08\u53BB\u91CD\u4FDD\u5E8F\uFF09
+//   - \u5176\u4F59\u5B57\u6BB5\uFF08\u542B config \u5185\u5176\u4ED6\u952E\uFF09\u53D6\u771F\u5B9E\u73B0\u503C
+function mergeProviderConfig(realObj, copyObj) {
+  const isRec = (v) => v && typeof v === 'object' && !Array.isArray(v);
+  if (!isRec(copyObj)) return realObj;
+  if (!isRec(realObj)) return copyObj;
+  const cfgOf = (obj) => (isRec(obj.config) ? obj.config : {});
+  const rulesOf = (obj) => {
+    const pcr = cfgOf(obj).providerConfigRules;
+    const r = isRec(pcr) ? pcr.providerRules : undefined;
+    return Array.isArray(r) ? r : [];
+  };
+  const strArr = (v) => (Array.isArray(v) ? v.filter((s) => typeof s === 'string' && s.trim() !== '') : []);
+  const mergedRules = [];
+  const seen = {};
+  for (const rule of rulesOf(realObj)) {
+    mergedRules.push(rule);
+    if (isRec(rule) && typeof rule.providerId === 'string' && rule.providerId !== '') seen[rule.providerId] = true;
+  }
+  for (const rule of rulesOf(copyObj)) {
+    if (!isRec(rule) || typeof rule.providerId !== 'string' || rule.providerId === '') continue;
+    if (seen[rule.providerId]) continue;
+    seen[rule.providerId] = true;
+    mergedRules.push(rule);
+  }
+  const mergedOrder = [];
+  for (const id of strArr(cfgOf(realObj).providerOrder).concat(strArr(cfgOf(copyObj).providerOrder))) {
+    if (mergedOrder.indexOf(id) === -1) mergedOrder.push(id);
+  }
+  const outCfg = Object.assign({}, cfgOf(realObj), {
+    providerOrder: mergedOrder,
+    providerConfigRules: Object.assign(
+      {},
+      isRec(cfgOf(realObj).providerConfigRules) ? cfgOf(realObj).providerConfigRules : {},
+      { providerRules: mergedRules },
+    ),
+  });
+  return Object.assign({}, realObj, { config: outCfg });
+}
+// [merge-fn-end]
+
+// D3 \u6362\u8F68\u88C5\u8F7D\u901A\u9053\uFF1A\u547D\u4E2D\u771F\u5B9E provider_config.json \u7684\u8BFB\u53D6\u91CD\u5B9A\u5411\u4E3A merge(\u771F\u5B9E\u5B9E\u65F6
+// \u5185\u5BB9, taiji \u540C\u6B65\u526F\u672C)\u2014\u2014\u6BCF\u6B21\u8BFB\u53D6\u91CD\u7B97\uFF08\u4E8B\u5B9E\u9A71\u52A8\uFF0C\u65E0\u7F13\u5B58/\u65F6\u95F4\u7A97\uFF0CZCode \u7AEF\u53D8\u66F4
+// \u5B9E\u65F6\u751F\u6548\uFF09\u3002\u526F\u672C\u7F3A\u5931/\u4E0D\u53EF\u8BFB \u2192 null = \u8C03\u7528\u65B9\u77ED\u8DEF\u56DE\u539F\u6587\u4EF6\uFF08\u56DE\u843D\u771F\u5B9E\u6587\u4EF6\u8BED\u4E49\uFF0C
+// \u96F6\u884C\u4E3A\u53D8\u5316\uFF09\uFF1Benv \u672A\u8BBE \u2192 null\uFF08\u5206\u652F\u4E0D\u6FC0\u6D3B\uFF09\u3002\u8BFB\u53D6\u4E00\u5F8B\u7ECF readOrig \u95F4\u63A5\u53D6\uFF08\u9632
+// patch \u9762\u9012\u5F52\u81EA\u8C03\u7528\uFF09\u3002
+function mergedProviderConfigText() {
+  if (!PI_SYNCED_PATH) return null;
+  const readOrig = fs.__origReadFileSync || fs.readFileSync;
+  let copyObj;
+  try {
+    copyObj = JSON.parse(readOrig(PI_SYNCED_PATH, 'utf8'));
+  } catch { return null; }
+  if (!copyObj || typeof copyObj !== 'object' || Array.isArray(copyObj)) return null;
+  let realObj = null;
+  try {
+    const parsed = JSON.parse(readOrig(REAL_PROVIDER_CONFIG_PATH, 'utf8'));
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) realObj = parsed;
+  } catch { /* ENOENT/\u635F\u574F \u2192 \u526F\u672C\u72EC\u6709\u6761\u76EE\u4E3A\u5168\u96C6 */ }
+  return JSON.stringify(mergeProviderConfig(realObj, copyObj));
+}
+
 if (!CLI_PATH) {
   process.stderr.write('[zcode-launcher] ZCODE_ENG_CLI_PATH \u672A\u8BBE\u7F6E\uFF0C\u65E0\u6CD5\u542F\u52A8 app-server\uFF08\u8BE5 env \u7531\u5F15\u64CE\u81EA\u52A8\u8BBE\u7F6E\uFF1B\u624B\u5DE5\u8FD0\u884C wrapper \u9700\u663E\u5F0F\u4F20\u5165\uFF09\\n');
   process.exit(2);
 }
 
-const text = injectedConfigText();
-if (text !== null) {
-  // encoding \u5F52\u4E00\uFF08Node \u522B\u540D\u9762\uFF09\uFF1A'utf8'/'utf-8'/\u5927\u5C0F\u5199\u53D8\u4F53\u7EDF\u4E00\u6309 string \u8FD4\u56DE\u2014\u2014
-  // \u771F\u5B9E bundle \u7684 config \u8BFB\u53D6\u6070\u7528 'utf-8' \u5F62\u6001\uFF0C\u4EC5\u5339\u914D 'utf8' \u4F1A\u9519\u56DE Buffer
-  // \uFF08\u5F53\u4E0B\u6E38\u4E0D\u53EA JSON.parse \u800C\u505A\u5B57\u7B26\u4E32\u8FD0\u7B97\u65F6\u5373 TypeError\uFF09
-  const shape = (args, value) => {
-    const enc = args[0];
-    const e = typeof enc === 'string' ? enc
-      : (enc && typeof enc === 'object' && typeof enc.encoding === 'string' ? enc.encoding : undefined);
-    if (e !== undefined && String(e).toLowerCase().replace(/-/g, '') === 'utf8') return value;
-    return Buffer.from(value);
-  };
-  fs.__origReadFileSync = fs.readFileSync;
-  fs.readFileSync = function (p, ...rest) {
-    if (typeof p === 'string' && p === CONFIG_PATH) {
-      const cur = injectedConfigText();
-      if (cur !== null) return shape(rest, cur);
-    }
-    return fs.__origReadFileSync.call(fs, p, ...rest);
-  };
-  fs.promises.__origReadFile = fs.promises.readFile;
-  fs.promises.readFile = function (p, ...rest) {
-    if (typeof p === 'string' && p === CONFIG_PATH) {
-      const cur = injectedConfigText();
-      if (cur !== null) return Promise.resolve(shape(rest, cur));
+// [2026-10-13 account \u76F4\u901A] \u5185\u5EFA\u76EE\u5F55\u8BFB\u53D6\u62E6\u622A\uFF1A\u7ED9 zhipu-account \u6761\u76EE\u6CE8\u5165 entitled:true\u3002
+// app-server \u6CE8\u518C\u8868\u88C5\u8F7D\u5224\u636E = access.entitled === true\uFF0C\u5916\u90E8 spawn \u4ECE\u76EE\u5F55\u6784\u5EFA\u7684\u8D26\u53F7
+// \u6761\u76EE\u9ED8\u8BA4\u975E entitled\uFF08YXe \u786C\u7F16\u7801 !1\uFF09\u2192 plan \u5BB6\u65CF\u5F15\u7528\u4E00\u5F8B\u300C\u4E0D\u5B58\u5728 Model\u300D\u3002\u7528\u6237\u88C1\u51B3\uFF1A
+// zai \u7CFB\u8D70 account provider \u914D\u7F6E\u5E76\u7ED5\u8FC7\u8BE5\u9650\u5236\u2014\u2014patch \u53EA\u53D1\u751F\u5728\u672C wrapper \u7684\u8BFB\u53D6\u8FD4\u56DE\u503C\uFF0C
+// ZCode.app \u78C1\u76D8\u6587\u4EF6\u96F6\u89E6\u78B0\u3002null = \u76EE\u5F55\u65E0 zhipu-account \u6761\u76EE\uFF08\u65E0\u9700 patch\uFF09\u3002
+// \u672C\u51FD\u6570\u5FC5\u987B\u4EE5\u5B9A\u4F4D\u540E\u7684\u771F\u5B9E\u8DEF\u5F84\u8C03\u7528\uFF08\u5B89\u88C5\u95E8\u4F20 CATALOG_PATH\uFF09\u2014\u2014\u65E0\u53C2\u8C03\u7528\u4F1A\u5728\u8BFB\u6587\u4EF6
+// \u65F6\u629B\u9519\u88AB catch \u6052\u8FD4 null\uFF0C\u66FE\u81F4\u7EAF account \u5BBF\u4E3B\u8865\u4E01\u5C42\u9759\u9ED8\u4E0D\u5B89\u88C5\uFF08\u89C1\u5B89\u88C5\u95E8\u5904\u6CE8\u91CA\uFF09\u3002
+let CATALOG_PATH = process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE || null;
+const __catalogPatchCache = new Map();
+// \u8DF3\u8FC7\u51B3\u7B56\u5F52\u56E0\uFF082026-10 \u5BA1\u67E5\u8865\uFF09\uFF1AcatalogPatchText \u628A\u300C\u65E0\u6761\u76EE\u9700\u8865\u300D\u4E0E\u300C\u8BFB\u53D6/\u89E3\u6790\u5931\u8D25
+// \uFF08\u6587\u4EF6\u7F3A\u5931/\u635F\u574F\uFF09\u300D\u90FD\u6298\u6210 null\uFF0C\u8DF3\u8FC7\u65E5\u5FD7\u82E5\u4E0D\u533A\u5206\u4F1A\u628A\u635F\u574F\u6001\u8BEF\u62A5\u6210\u300C\u65E0\u6761\u76EE\u300D\uFF0C\u6392\u969C\u88AB\u8BEF\u5BFC
+const __catalogPatchStatus = new Map(); // path -> 'no-entries' | 'unreadable'
+function catalogPatchText(path) {
+  if (__catalogPatchCache.has(path)) return __catalogPatchCache.get(path);
+  let result = null;
+  try {
+    const readOrig = fs.__origReadFileSync || fs.readFileSync;
+    const parsed = JSON.parse(readOrig(path, 'utf8'));
+    const rules = parsed && parsed.config && parsed.config.providerConfigRules
+      && Array.isArray(parsed.config.providerConfigRules.providerRules)
+      ? parsed.config.providerConfigRules.providerRules : null;
+    let touched = 0;
+    if (rules) for (const rule of rules) {
+      const acc = rule && rule.config && rule.config.access;
+      if (acc && acc.type === 'zhipu-account' && acc.entitled !== true) { acc.entitled = true; touched++; }
+    }
+    result = touched > 0 ? JSON.stringify(parsed) : null;
+    __catalogPatchStatus.set(path, 'no-entries');
+  } catch { result = null; __catalogPatchStatus.set(path, 'unreadable'); }
+  __catalogPatchCache.set(path, result);
+  return result;
+}
+
+// [2026-10-13 account \u76F4\u901A\u2461] CLI bundle \u6E90\u7801\u5185\u5B58\u8865\u4E01\uFF1A\u5916\u90E8 spawn \u7684\u8D26\u53F7\u6761\u76EE\u6784\u5EFA
+// \u786C\u7F16\u7801 entitled:!1\uFF08YXe\uFF09\uFF0C\u6570\u636E\u9762\u6CE8\u5165\uFF08\u76EE\u5F55 entitled \u5B57\u6BB5\uFF09\u88AB\u5176\u65E0\u89C6\u2014\u2014\u6309\u7528\u6237\u88C1\u51B3
+// \u6539 zcode \u6E90\u7801\u7ED5\u8FC7\uFF1A\u62E6\u622A CLI bundle \u6E90\u7801\u8BFB\u53D6\uFF0C\u5185\u5B58\u66FF\u6362\u8BE5\u5B57\u9762\u91CF\u4E3A !0\uFF08ZCode.app
+// \u78C1\u76D8\u6587\u4EF6\u96F6\u89E6\u78B0\uFF1B\u951A\u4E32\u542B ]]:[] \u5C3E\u7F00\u552F\u4E00\u547D\u4E2D YXe \u6784\u9020\uFF0C\u53E6\u4E00\u5904\u540C\u540D\u6761\u4EF6\u903B\u8F91\u4E0D\u53D7\u5F71\u54CD\uFF09\u3002
+// \u951A\u4E0D\u547D\u4E2D\uFF08\u4E0A\u6E38\u6DF7\u6DC6\u5F62\u6001\u53D8\u5316\uFF09\u2192 \u539F\u6587\u900F\u51FA\uFF1A\u4EC5 account \u5BB6\u65CF\u7EE7\u7EED\u88AB\u62D2\uFF0C\u4E2A\u4EBA provider
+// \u4E0D\u53D7\u5F71\u54CD\u3002
+const __cliPatchCache = new Map();
+function patchedCliSource(path) {
+  if (__cliPatchCache.has(path)) return __cliPatchCache.get(path);
+  let result = null;
+  try {
+    const readOrig = fs.__origReadFileSync || fs.readFileSync;
+    const src = readOrig(path, 'utf8');
+    // \u7248\u672C\u9C81\u68D2\u951A\uFF082026-10-13 \u4FEE\u8BA2\uFF09\uFF1Aminified \u6807\u8BC6\u7B26\uFF08Uk/I3 \u7B49\uFF09\u968F zcode \u91CD\u65B0\u6253\u5305
+    // \u6F02\u79FB\uFF0C\u5C5E\u6027\u540D\uFF08zcodeBuiltinProviders / zhipu-account / entitled\uFF09\u662F\u6570\u636E/\u5951\u7EA6
+    // \u771F\u540D\u4E0D\u88AB\u6DF7\u6DC6\u2014\u2014\u4EE5\u5C5E\u6027\u540D\u5B9A\u4F4D + 600 \u5B57\u7B26\u7A97\u53E3\u5185\u628A\u8D26\u53F7\u6761\u76EE\u6784\u5EFA\u7684 entitled:!1
+    // \u7FFB\u8F6C\u4E3A !0\u3002\u7A97\u53E3\u96F6\u547D\u4E2D = \u4E0A\u6E38\u5F62\u6001\u6F02\u79FB \u2192 \u539F\u6587\u900F\u51FA + stderr warn\uFF08\u6F02\u79FB\u53EF\u89C1\uFF0C
+    // \u8FDB app-server stderr \u65E5\u5FD7\uFF09\uFF0C\u4E2A\u4EBA provider \u4E0D\u53D7\u5F71\u54CD\u3002
+    const anchorIdx = src.indexOf('zcodeBuiltinProviders.entries()');
+    if (anchorIdx >= 0) {
+      const window = src.slice(anchorIdx, Math.min(src.length, anchorIdx + 600));
+      if (window.indexOf('zhipu-account') >= 0 && window.indexOf('entitled:!1') >= 0) {
+        result = src.slice(0, anchorIdx)
+          + window.split('entitled:!1').join('entitled:!0')
+          + src.slice(anchorIdx + 600);
+      }
     }
-    return fs.promises.__origReadFile.call(fs.promises, p, ...rest);
-  };
-  // existsSync \u62E6\u622A\uFF1A\u771F\u5B9E bundle \u7684\u7528\u6237 config \u8BFB\u53D6\uFF08loadFileConfig\uFF09\u4EE5 existsSync
-  // \u4E3A\u77ED\u8DEF\u95E8\u2014\u2014\u6587\u4EF6\u4E0D\u5B58\u5728\u65F6\u8FD4\u56DE\u7A7A config \u4E14 readFileSync \u4E0D\u88AB\u8C03\u7528\uFF0CGUI-only
-  // \u767B\u5F55\u5BBF\u4E3B\uFF08cli/config.json \u4ECE\u672A\u88AB CLI \u4FA7\u5199\u8FC7\uFF09\u4E0A\u6CE8\u5165\u53EA\u6302\u5728\u8BFB\u53D6\u9762 = \u4E0D\u53EF\u89C1
-  fs.__origExistsSync = fs.existsSync;
-  fs.existsSync = function (p) {
-    if (typeof p === 'string' && p === CONFIG_PATH) {
-      const cur = injectedConfigText();
-      if (cur !== null) return true;
+    if (result === null) {
+      process.stderr.write('[zcode-launcher] account bypass: CLI bundle anchor not found (zcode upstream shape drifted?) - account family stays gated, personal providers unaffected\\n');
     }
-    return fs.__origExistsSync.call(fs, p);
-  };
+  } catch { result = null; }
+  __cliPatchCache.set(path, result);
+  return result;
 }
 
 // \u5185\u5EFA provider \u914D\u7F6E\u5B9A\u4F4D\uFF08\u6F02\u79FB\u9762\u2461\uFF09\uFF1A3.12.x \u8D77\u914D\u7F6E\u6587\u4EF6\u632A\u4F4D + CLI \u4F9D\u8D56\u5BBF\u4E3B\u6CE8\u5165
@@ -521,6 +754,11 @@ if (text !== null) {
 // <plat>-<arch> \u4F18\u5148\uFF0CRust arch \u53D8\u4F53\u5982 darwin-aarch64 \u5B57\u5178\u5E8F\u8DDF\u540E\uFF09\xD7 \u7248\u672C\u76EE\u5F55
 // \uFF08semver \u6700\u5927\uFF09\u7684 endpoint-*/zcode-builtin.json \u2192 \u90FD\u627E\u4E0D\u5230\u5219\u4E0D\u8BBE\u952E\uFF0C\u8BA9 CLI
 // \u539F\u751F\u62A5\u9519\u900F\u51FA\uFF08\u9519\u8BEF\u6587\u6848\u542B\u6062\u590D\u6307\u5F15\uFF09\u3002
+// [\u4F4D\u7F6E\uFF1A\u5B89\u88C5\u95E8\u4E4B\u524D] \u5B9A\u4F4D/env \u63A8\u5BFC\u5FC5\u987B\u5148\u4E8E\u5B89\u88C5\u95E8\u5224\u5B9A\u5B8C\u6210\u2014\u2014catalogPatchText
+// \u9700\u8981\u5B9A\u4F4D\u540E\u7684\u771F\u5B9E\u8DEF\u5F84\u53C2\u4E0E\u95E8\u5224\u5B9A\u3002\u66FE\u56E0\u95E8\u5148\u4E8E\u5B9A\u4F4D\u6267\u884C\u4E14\u65E0\u53C2\u8C03\u7528\uFF0C
+// fs.readFileSync(undefined) \u629B\u9519\u88AB catch \u6052\u8FD4 null \u2192 \u95E8\u9000\u5316\u4E3A text!==null\uFF0C
+// \u7EAF account \u5BBF\u4E3B\uFF08v2 \u65E0\u51ED\u636E\u6761\u76EE \u2192 text=null\uFF09\u4E0B\u8865\u4E01\u5C42\u9759\u9ED8\u4E0D\u5B89\u88C5\u3001account
+// \u76F4\u901A\u6574\u4F53\u5931\u6548\u4E14\u96F6\u65E5\u5FD7\uFF082026-10 \u56DE\u5F52\u4FEE\u590D\uFF09\u3002
 if (!process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE) {
   let located = null;
   try {
@@ -562,6 +800,7 @@ if (!process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE) {
     }
   } catch { /* provider \u76EE\u5F55\u7F3A\u5931/\u4E0D\u53EF\u8BFB \u2192 \u4E0D\u8BBE\u952E */ }
   if (located) process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE = located;
+  CATALOG_PATH = process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE || null;
   // endpoint origin \u5BF9\u9F50\uFF082026-09-29 \u8FC1\u79FB\u540C\u6B65\uFF09\uFF1ACLI \u6309 ZCODE_BASE_URL \u6D3E\u751F active
   // \u76EE\u5F55\u8DEF\u5F84\uFF08sha256(origin) \u524D\u7F00\uFF09\uFF1BGUI \u5B89\u88C5\u7684\u76EE\u5F55\u5728 refresh \u63A7\u5236\u6587\u4EF6\u7684 endpointKey
   // \u4E0B\uFF08\u5982 https://zcode.z.ai\uFF09\uFF0C\u4E0E CLI \u7F3A\u7701 origin\uFF08bigmodel.cn\uFF09\u4E0D\u540C\u2014\u2014\u4E0D\u6CE8\u5165\u5219
@@ -581,6 +820,115 @@ if (!process.env.ZCODE_BUILTIN_PROVIDER_CONFIG_FILE) {
   }
 }
 
+// \u5B89\u88C5\u95E8\uFF1A\u4EFB\u4E00 patch \u6E90\u53EF\u7528\u5373\u5B89\u88C5\u62E6\u622A\u5C42\uFF1B\u51B3\u7B56\u4E24\u6001\u90FD\u51FA\u58F0\uFF08\u88C5\u4E86\u54EA\u4E9B patch / \u4E3A\u4F55
+// \u8DF3\u8FC7\uFF09\u2014\u2014\u8865\u4E01\u5C42\u7684\u5931\u6548\u5F62\u6001\u662F\u9759\u9ED8\u7684\uFF08account \u76F4\u901A\u5931\u6548 = plan \u5BB6\u65CF\u62A5\u300C\u4E0D\u5B58\u5728
+// Model\u300D\u800C\u65E0\u4EFB\u4F55\u65E5\u5FD7\uFF09\uFF0C\u8DF3\u8FC7\u540C\u6837\u5FC5\u987B\u7559\u75D5\u3002
+const text = injectedConfigText();
+const catalogPatch = CATALOG_PATH !== null ? catalogPatchText(CATALOG_PATH) : null;
+if (text !== null || catalogPatch !== null) {
+  process.stderr.write('[zcode-launcher] \u8865\u4E01\u5C42\u5DF2\u5B89\u88C5: cli-config-inject=' + (text !== null ? 'on' : 'off')
+    + ', catalog-entitled=' + (catalogPatch !== null ? 'on' : 'off')
+    + ', provider-merge=' + (PI_SYNCED_PATH ? 'armed' : 'off') + ', cli-source-bypass=armed\\n');
+  // encoding \u5F52\u4E00\uFF08Node \u522B\u540D\u9762\uFF09\uFF1A'utf8'/'utf-8'/\u5927\u5C0F\u5199\u53D8\u4F53\u7EDF\u4E00\u6309 string \u8FD4\u56DE\u2014\u2014
+  // \u771F\u5B9E bundle \u7684 config \u8BFB\u53D6\u6070\u7528 'utf-8' \u5F62\u6001\uFF0C\u4EC5\u5339\u914D 'utf8' \u4F1A\u9519\u56DE Buffer
+  // \uFF08\u5F53\u4E0B\u6E38\u4E0D\u53EA JSON.parse \u800C\u505A\u5B57\u7B26\u4E32\u8FD0\u7B97\u65F6\u5373 TypeError\uFF09
+  // shape \u540C\u65F6\u670D\u52A1\u56DB\u5904 patch \u6E90\uFF08config / provider merge / \u5185\u5EFA\u76EE\u5F55 / \u2014\u2014encoding \u5F52\u4E00
+  // \u8BED\u4E49\u76F8\u540C\uFF0C\u5355\u526F\u672C\uFF1A\u76EE\u5F55\u6761\u76EE\u66FE\u53E6\u6301\u9010\u5B57\u91CD\u590D\u526F\u672C catalogShape\uFF0C\u5DF2\u5E76\u56DE\u672C\u51FD\u6570\uFF09
+  const shape = (args, value) => {
+    const enc = args[0];
+    const e = typeof enc === 'string' ? enc
+      : (enc && typeof enc === 'object' && typeof enc.encoding === 'string' ? enc.encoding : undefined);
+    if (e !== undefined && String(e).toLowerCase().replace(/-/g, '') === 'utf8') return value;
+    return Buffer.from(value);
+  };
+  fs.__origReadFileSync = fs.readFileSync;
+  fs.readFileSync = function (p, ...rest) {
+    if (typeof p === 'string' && p === CONFIG_PATH) {
+      const cur = injectedConfigText();
+      if (cur !== null) return shape(rest, cur);
+    }
+    // D3 \u6362\u8F68\uFF1ARegistry \u76F4\u8BFB\u771F\u5B9E provider_config.json \u2192 merge(\u771F\u5B9E, \u526F\u672C) \u89C6\u56FE
+    if (typeof p === 'string' && p === REAL_PROVIDER_CONFIG_PATH) {
+      const cur = mergedProviderConfigText();
+      if (cur !== null) return shape(rest, cur);
+    }
+    // account \u76F4\u901A\uFF1A\u5185\u5EFA\u76EE\u5F55\u8BFB\u53D6 \u2192 zhipu-account \u6CE8\u5165 entitled:true\u3002\u6309\u6587\u4EF6\u540D\u5339\u914D
+    // \uFF08app-server \u6309 ZCODE_BASE_URL \u81EA\u6D3E\u751F endpoint \u76EE\u5F55\uFF0C\u8BFB\u8DEF\u5F84\u2260env \u5B9A\u4F4D\u8DEF\u5F84\uFF09\u3002
+    if (typeof p === 'string' && p.endsWith('zcode-builtin.json')) {
+      const cur = catalogPatchText(p);
+      if (cur !== null) return shape(rest, cur);
+    }
+    // account \u76F4\u901A\u2461\uFF1ACLI bundle \u6E90\u7801 \u2192 YXe entitled:!1 \u5185\u5B58\u7FFB\u8F6C\u4E3A !0
+    if (typeof p === 'string' && p === CLI_PATH) {
+      const cur = patchedCliSource(p);
+      if (cur !== null) return cur;
+    }
+    return fs.__origReadFileSync.call(fs, p, ...rest);
+  };
+  fs.promises.__origReadFile = fs.promises.readFile;
+  fs.promises.readFile = function (p, ...rest) {
+    if (typeof p === 'string' && p === CONFIG_PATH) {
+      const cur = injectedConfigText();
+      if (cur !== null) return Promise.resolve(shape(rest, cur));
+    }
+    if (typeof p === 'string' && p === REAL_PROVIDER_CONFIG_PATH) {
+      const cur = mergedProviderConfigText();
+      if (cur !== null) return Promise.resolve(shape(rest, cur));
+    }
+    if (typeof p === 'string' && p.endsWith('zcode-builtin.json')) {
+      const cur = catalogPatchText(p);
+      if (cur !== null) return Promise.resolve(shape(rest, cur));
+    }
+    if (typeof p === 'string' && p === CLI_PATH) {
+      const cur = patchedCliSource(p);
+      if (cur !== null) return Promise.resolve(cur);
+    }
+    return fs.promises.__origReadFile.call(fs.promises, p, ...rest);
+  };
+  // [account \u76F4\u901A\u2461 \u8F7D\u4F53] .js \u6269\u5C55\u5904\u7406\u5668\u6302\u94A9\uFF1ANode \u5BF9 CJS \u5165\u53E3\u6E90\u7801\u7684\u8BFB\u53D6\u8D70\u539F\u751F
+  // internalModuleReadFile \u901A\u9053\uFF0Cfs \u7334\u8865\u4E01\u4E0D\u53EF\u89C1\u2014\u2014CLI bundle \u6E90\u7801\u8865\u4E01\u6539\u5728\u6269\u5C55
+  // \u5904\u7406\u5668\u5C42\u62E6\u622A\uFF08\u4EC5\u547D\u4E2D CLI_PATH\uFF1B\u5176\u4F59\u6587\u4EF6\u5168\u6743\u59D4\u6258\u539F handler\uFF0C\u96F6\u989D\u5916\u5F00\u9500\uFF09\u3002
+  const __Module = require('node:module');
+  const __origJsHandler = __Module._extensions['.js'];
+  __Module._extensions['.js'] = function (mod, filename) {
+    if (CLI_PATH && filename === CLI_PATH) {
+      const patched = patchedCliSource(filename);
+      if (patched !== null) {
+        let src = patched.charCodeAt(0) === 0xfeff ? patched.slice(1) : patched;
+        if (src.startsWith('#!')) src = src.slice(src.indexOf('\\n') + 1);
+        return mod._compile(src, filename);
+      }
+    }
+    return __origJsHandler(mod, filename);
+  };
+
+  // existsSync \u62E6\u622A\uFF1A\u771F\u5B9E bundle \u7684\u7528\u6237 config \u8BFB\u53D6\uFF08loadFileConfig\uFF09\u4EE5 existsSync
+  // \u4E3A\u77ED\u8DEF\u95E8\u2014\u2014\u6587\u4EF6\u4E0D\u5B58\u5728\u65F6\u8FD4\u56DE\u7A7A config \u4E14 readFileSync \u4E0D\u88AB\u8C03\u7528\uFF0CGUI-only
+  // \u767B\u5F55\u5BBF\u4E3B\uFF08cli/config.json \u4ECE\u672A\u88AB CLI \u4FA7\u5199\u8FC7\uFF09\u4E0A\u6CE8\u5165\u53EA\u6302\u5728\u8BFB\u53D6\u9762 = \u4E0D\u53EF\u89C1\u3002
+  // D3 \u6362\u8F68\uFF1A\u771F\u5B9E provider_config.json \u7684\u5B58\u5728\u6027 = \u771F\u5B9E\u6216\u526F\u672C\u4EFB\u4E00\u5B58\u5728\u5373 true
+  //\uFF08\u771F\u5B9E\u7F3A\u5931 + \u526F\u672C\u5B58\u5728\u65F6 Registry \u7684 existsSync \u95E8\u4E0D\u5F97\u62E6\u6389 merge \u89C6\u56FE\u8BFB\u53D6\uFF09
+  fs.__origExistsSync = fs.existsSync;
+  fs.existsSync = function (p) {
+    if (typeof p === 'string' && p === CONFIG_PATH) {
+      const cur = injectedConfigText();
+      if (cur !== null) return true;
+    }
+    if (typeof p === 'string' && p === REAL_PROVIDER_CONFIG_PATH && PI_SYNCED_PATH) {
+      if (fs.__origExistsSync.call(fs, REAL_PROVIDER_CONFIG_PATH)) return true;
+      return fs.__origExistsSync.call(fs, PI_SYNCED_PATH);
+    }
+    return fs.__origExistsSync.call(fs, p);
+  };
+} else {
+  process.stderr.write('[zcode-launcher] \u8865\u4E01\u5C42\u672A\u5B89\u88C5(\u8DF3\u8FC7): \u65E0\u51ED\u636E\u53EF\u6CE8\u5165(v2 config \u65E0 provider \u6761\u76EE)'
+    + (CATALOG_PATH !== null
+      ? (__catalogPatchStatus.get(CATALOG_PATH) === 'unreadable'
+        ? '; \u5185\u5EFA\u76EE\u5F55\u5DF2\u5B9A\u4F4D\u4F46 catalog \u8BFB\u53D6/\u89E3\u6790\u5931\u8D25(\u6587\u4EF6\u7F3A\u5931\u6216\u635F\u574F\uFF0C\u6392\u969C\u5165\u53E3: zcode-builtin.json\u2014\u2014\u975E\u300C\u65E0\u6761\u76EE\u300D)'
+        : '; \u5185\u5EFA\u76EE\u5F55\u5DF2\u5B9A\u4F4D\u4F46\u65E0 zhipu-account \u6761\u76EE\u9700\u8865(\u76EE\u5F55\u8BFB\u53D6\u539F\u751F\u900F\u51FA)')
+      : '; \u5185\u5EFA\u76EE\u5F55\u672A\u5B9A\u4F4D(env \u672A\u8BBE\u4E14\u81EA\u5B9A\u4F4D\u672A\u547D\u4E2D)')
+    + '\\n');
+}
+
 // \u4E0A\u6E38 provider bootstrap \u4EE5 argv[1] \u4E3A\u5165\u53E3\u951A\uFF0C\u4ECE\u8BE5\u8DEF\u5F84\u90BB\u8FD1\u5B9A\u4F4D CLI \u5185\u5EFA
 // provider \u914D\u7F6E\u2014\u2014wrapper \u5F62\u6001\u4E0B argv[1] = \u672C wrapper \u843D\u76D8\u8DEF\u5F84\uFF0Cbootstrap \u4F1A\u5728
 // wrapper \u90BB\u57DF\u627E provider \u914D\u7F6E\u800C\u5931\u8D25\uFF08\u771F\u673A\u62A5\u300C\u65E0\u6CD5\u5B9A\u4F4D CLI ZCode Built-in Provider
@@ -605,7 +953,7 @@ function ensureAppServerLauncher(engineDataDir) {
     fs2.writeFileSync(tmp, APPSERVER_LAUNCHER_SOURCE);
     fs2.renameSync(tmp, file);
   } catch (err) {
-    const reason = (0, import_subagent_engine_sdk4.toErrorMessage)(err);
+    const reason = (0, import_subagent_engine_sdk5.toErrorMessage)(err);
     throw new Error(
       `zcode app-server launcher \u843D\u76D8\u5931\u8D25: ${file}\uFF08${reason}\uFF09\u3002\u6062\u590D\uFF1A\u68C0\u67E5\u5F15\u64CE\u6570\u636E\u76EE\u5F55 \u5199\u6743\u9650\u4E0E\u78C1\u76D8\u7A7A\u95F4\uFF08engineDataDir \u7531\u5BBF\u4E3B\u4F20\u5165\uFF0C\u8DEF\u5F84\u89C1\u4E0A\uFF09\u540E\u91CD\u8BD5\u3002`
     );
@@ -863,21 +1211,21 @@ async function readZcodeSessionView(dbPath, sessionId) {
 var fs4 = __toESM(require("fs"), 1);
 var import_node_path = require("path");
 var import_node_os = require("os");
-var import_subagent_engine_sdk7 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk8 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/logs/stderr-rotation.ts
-var import_subagent_engine_sdk5 = require("@zhushanwen/subagent-engine-sdk");
 var import_subagent_engine_sdk6 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk7 = require("@zhushanwen/subagent-engine-sdk");
 var ZCODE_STDERR_LOG_PREFIX = "zcode-appserver-stderr-";
 function stderrLogPathFor(engineDataDir, pid) {
-  return (0, import_subagent_engine_sdk5.stderrLogPathFor)(engineDataDir, pid, ZCODE_STDERR_LOG_PREFIX);
+  return (0, import_subagent_engine_sdk6.stderrLogPathFor)(engineDataDir, pid, ZCODE_STDERR_LOG_PREFIX);
 }
 function cleanupSiblingStderrLogs(logPath, env, now) {
-  return (0, import_subagent_engine_sdk5.cleanupSiblingStderrLogs)(logPath, env, ZCODE_STDERR_LOG_PREFIX, now);
+  return (0, import_subagent_engine_sdk6.cleanupSiblingStderrLogs)(logPath, env, ZCODE_STDERR_LOG_PREFIX, now);
 }
 
 // src/connection.ts
-var logger = (0, import_subagent_engine_sdk7.getLogger)("subagents");
+var logger = (0, import_subagent_engine_sdk8.getLogger)("subagents");
 var RAW_FRAME_LOG_CHARS = 200;
 var RUNTIME_PREFERENCES = Object.freeze({
   nativeSearchEnhancementsEnabled: true,
@@ -899,11 +1247,11 @@ function frameIdOf(frame) {
   return typeof id === "string" || typeof id === "number" ? id : void 0;
 }
 function errMessage(err) {
-  return (0, import_subagent_engine_sdk4.toErrorMessage)(err);
+  return (0, import_subagent_engine_sdk5.toErrorMessage)(err);
 }
 function buildAppServerEnv(baseEnv = process.env) {
   return {
-    ...(0, import_subagent_engine_sdk7.buildNestedSpawnEnv)(baseEnv),
+    ...(0, import_subagent_engine_sdk8.buildNestedSpawnEnv)(baseEnv),
     ZCODE_MODEL_TELEMETRY_ENABLED: "false"
   };
 }
@@ -1053,7 +1401,7 @@ var AppServerConnection = class {
   close() {
     const child = this.child;
     if (child === null || this.killChainPromise !== void 0) return;
-    this.killChainPromise = (0, import_subagent_engine_sdk7.killChain)(child, { graceMs: ZCODE_KILL_GRACE_MS });
+    this.killChainPromise = (0, import_subagent_engine_sdk8.killChain)(child, { graceMs: ZCODE_KILL_GRACE_MS });
   }
   /**
    * 异步完整关闭面：SIGTERM → grace → SIGKILL 杀链走完（含收尸），resolve 于进程
@@ -1065,7 +1413,7 @@ var AppServerConnection = class {
     if (this.killChainPromise === void 0) {
       const child = this.child;
       if (child === null) return;
-      this.killChainPromise = (0, import_subagent_engine_sdk7.killChain)(child, { graceMs: opts?.graceMs ?? ZCODE_KILL_GRACE_MS });
+      this.killChainPromise = (0, import_subagent_engine_sdk8.killChain)(child, { graceMs: opts?.graceMs ?? ZCODE_KILL_GRACE_MS });
     }
     await this.killChainPromise;
   }
@@ -1084,10 +1432,10 @@ var AppServerConnection = class {
     this.generation += 1;
     const gen = this.generation;
     const script = this.launcherScript ?? this.cliPath;
-    const child = (0, import_subagent_engine_sdk7.spawnEngineChild)({
+    const child = (0, import_subagent_engine_sdk8.spawnEngineChild)({
       command: this.nodeBin,
       args: [script, "app-server", "--cwd", this.cwd],
-      env: (0, import_subagent_engine_sdk7.buildEngineChildEnv)(this.env, {
+      env: (0, import_subagent_engine_sdk8.buildEngineChildEnv)(this.env, {
         // L0 TAIJI_AGENT_DATA_DIR 缺省链：显式传参 > 宿主注入 env > tmpdir 占位
         //（app-server 不消费该键，占位仅满足 L0 必注入契约；生产调用方
         // zcode-engine.ensureAppServerRuntime 恒传 engineDataDir）。
@@ -1125,7 +1473,7 @@ var AppServerConnection = class {
         }
       }
     };
-    (0, import_subagent_engine_sdk7.pumpNdjsonLines)(child.stdout, (line) => this.handleLine(line));
+    (0, import_subagent_engine_sdk8.pumpNdjsonLines)(child.stdout, (line) => this.handleLine(line));
     child.stderr?.setEncoding("utf8");
     child.stderr?.on("data", (chunk) => {
       this.stderrTail = (this.stderrTail + chunk).slice(-ZCODE_APPSERVER_STDERR_TAIL_BUFFER_CHARS);
@@ -1266,8 +1614,8 @@ var AppServerConnection = class {
     }
     this.stderrStream.write(chunk);
     if (this.activeStderrLogPath !== null) {
-      const params = (0, import_subagent_engine_sdk6.stderrRotationParams)(process.env);
-      if ((0, import_subagent_engine_sdk6.rotateStderrLogIfNeeded)(this.activeStderrLogPath, params)) {
+      const params = (0, import_subagent_engine_sdk7.stderrRotationParams)(process.env);
+      if ((0, import_subagent_engine_sdk7.rotateStderrLogIfNeeded)(this.activeStderrLogPath, params)) {
         this.closeStderrStream();
       }
     }
@@ -1285,8 +1633,8 @@ var AppServerConnection = class {
 
 // src/session-channel.ts
 var import_node_crypto = require("crypto");
-var import_subagent_engine_sdk8 = require("@zhushanwen/subagent-engine-sdk");
-var logger2 = (0, import_subagent_engine_sdk8.getLogger)("subagents");
+var import_subagent_engine_sdk9 = require("@zhushanwen/subagent-engine-sdk");
+var logger2 = (0, import_subagent_engine_sdk9.getLogger)("subagents");
 var SUBSCRIBE_DELIVERY_KIND = "desktop-continuous";
 var WORKSPACE_KEY_HASH_CHARS = 16;
 var CREATE_REPLY_LOG_CHARS = 300;
@@ -1295,7 +1643,7 @@ function isRecord3(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 function errMessage2(err) {
-  return (0, import_subagent_engine_sdk4.toErrorMessage)(err);
+  return (0, import_subagent_engine_sdk5.toErrorMessage)(err);
 }
 function stableWorkspaceKey(workspacePath) {
   return "ws-" + (0, import_node_crypto.createHash)("sha256").update(workspacePath).digest("hex").slice(0, WORKSPACE_KEY_HASH_CHARS);
@@ -1822,8 +2170,8 @@ var SessionChannel = class {
 
 // src/session-db-maintenance.ts
 var fs5 = __toESM(require("fs"), 1);
-var import_subagent_engine_sdk9 = require("@zhushanwen/subagent-engine-sdk");
-var logger3 = (0, import_subagent_engine_sdk9.getLogger)("subagents");
+var import_subagent_engine_sdk10 = require("@zhushanwen/subagent-engine-sdk");
+var logger3 = (0, import_subagent_engine_sdk10.getLogger)("subagents");
 var ZCODE_SESSION_TTL_MS = 2592e6;
 var ZCODE_SESSION_SWEEP_INTERVAL_MS = 864e5;
 var SWEEP_BUSY_TIMEOUT_MS = 5e3;
@@ -1979,9 +2327,10 @@ function maybeSweepExpiredZcodeSessions(dbPath, opts = {}) {
 }
 
 // src/zcode-engine.ts
-var logger4 = (0, import_subagent_engine_sdk10.getLogger)("subagents");
+var logger4 = (0, import_subagent_engine_sdk11.getLogger)("subagents");
 var PROBE_VERSION_TIMEOUT_MS = 15e3;
 var COMMON_THOUGHT_LEVELS = ["low", "high", "max"];
+var OFF_FAMILY_THINKING_LEVELS = /* @__PURE__ */ new Set(["off", "minimal"]);
 var ZcodeEngine = class {
   id = ZCODE_ENGINE_ID;
   deps;
@@ -2194,7 +2543,7 @@ var ZcodeEngine = class {
    */
   async attemptAppServerTurn(task, ctx, modelRef, cwd, prompt, opts = {}) {
     const rt = this.ensureAppServerRuntime();
-    const reasoningLevel = modelRef !== void 0 && modelRef !== "" ? this.minimalReasoningFor(modelRef) : void 0;
+    const reasoningLevel = modelRef !== void 0 && modelRef !== "" ? this.reasoningLevelFor(modelRef, task.thinkingLevel) : void 0;
     const createParams = buildAppServerCreateParams(task, modelRef, cwd, reasoningLevel);
     let currentSessionId;
     let signalSessionCreated;
@@ -2348,7 +2697,7 @@ var ZcodeEngine = class {
     const env = buildAppServerEnv(this.deps.processEnv ?? process.env);
     env.ZCODE_ENG_CLI_PATH = cliPath;
     env.ZCODE_ENG_V2_CONFIG = this.deps.sources?.v2ConfigPath ?? defaultV2ConfigPath();
-    env.ZCODE_ENG_PROVIDER_CONFIG = this.deps.sources?.personalProviderConfigPath ?? defaultPersonalProviderConfigPath();
+    env.ZCODE_ENG_PROVIDER_CONFIG = resolvePersonalProviderConfigPath(this.deps.sources, engineDataDir);
     const sessionDbPath = zcodeSessionDbPath(engineDataDir);
     env.ZCODE_SESSION_DB_PATH = sessionDbPath;
     delete env.ZCODE_SESSION_DB;
@@ -2445,7 +2794,7 @@ var ZcodeEngine = class {
   /** abort 合成终态：exitCode=null（record 正常收尾，不留僵尸）。 */
   applyAbortedOutcome(outcome, task, ctx, final, emit) {
     outcome.exitCode = null;
-    outcome.error = isHostTimeoutAbort(ctx) ? (0, import_subagent_engine_sdk11.synthesizeTimeoutOutcome)(task, final.output.stdoutText, ZCODE_ENGINE_ID).error ?? (0, import_subagent_engine_sdk11.engineTimeoutDetail)(final.output.stdoutText) : final.abortMessage ?? `engine_run_failed: zcode \u4EFB\u52A1\u88AB\u4E2D\u6B62\uFF08app-server abort \u94FE\u6536\u53E3\uFF0C\u5BBF\u4E3B\u5408\u6210\u7EC8\u6001\uFF09\u3002\u8F93\u51FA\u5C3E\u90E8: ${final.output.stdoutText.slice(-ZCODE_ERROR_TAIL_CHARS)}`;
+    outcome.error = isHostTimeoutAbort(ctx) ? (0, import_subagent_engine_sdk12.synthesizeTimeoutOutcome)(task, final.output.stdoutText, ZCODE_ENGINE_ID).error ?? (0, import_subagent_engine_sdk12.engineTimeoutDetail)(final.output.stdoutText) : final.abortMessage ?? `engine_run_failed: zcode \u4EFB\u52A1\u88AB\u4E2D\u6B62\uFF08app-server abort \u94FE\u6536\u53E3\uFF0C\u5BBF\u4E3B\u5408\u6210\u7EC8\u6001\uFF09\u3002\u8F93\u51FA\u5C3E\u90E8: ${final.output.stdoutText.slice(-ZCODE_ERROR_TAIL_CHARS)}`;
     emit({ type: "error", message: outcome.error });
   }
   /**
@@ -2491,16 +2840,30 @@ var ZcodeEngine = class {
   listModels() {
     return listZcodeModels(this.deps.sources);
   }
-  /** 显式模型的最小 reasoning 档（目录 modelRules 值域；per-modelRef 记忆化——
+  /** 模型 reasoning 值域缓存（目录 modelRules 值域；per-modelRef 记忆化——
    *  目录文件在引擎进程生命周期内视为静态，重复 run 不重读）。 */
   reasoningMemo = /* @__PURE__ */ new Map();
-  minimalReasoningFor(modelRef) {
+  /**
+   * create 帧模型 reasoning 档择选（目录值域域内择档；2026-10-13 探针实测驱动）：
+   * - 无 thinkingLevel：目录值域首值（最小档，现状保形——轻推理默认）；
+   * - off 族（off/minimal，显式禁思考/最省）：恒值域首值（最小档）——绝不落
+   *   非最小档末值回退（那是「请求思考」档位的回退，off 族落之即意图反转）；
+   * - 其余 thinkingLevel：精确命中值域 → 用之；值域无精确名 → 取非最小档末值
+   *   （请求了思考 = reasoning 开；plan 网关对部分模型拒收 disabled——目录域含
+   *   disabled 但服务端只认非最小档，域与接受面漂移时显式意图走非最小档）。
+   */
+  reasoningLevelFor(modelRef, thinkingLevel) {
     const memoKey = `${locateZcodeBuiltinCatalog(this.deps.sources) ?? "none"}|${modelRef}`;
-    const hit = this.reasoningMemo.get(memoKey);
-    if (hit !== void 0 || this.reasoningMemo.has(memoKey)) return hit;
-    const level = resolveZcodeMinimalReasoningLevel(modelRef, this.deps.sources);
-    this.reasoningMemo.set(memoKey, level);
-    return level;
+    const memoHit = this.reasoningMemo.get(memoKey);
+    const domain = memoHit !== void 0 || this.reasoningMemo.has(memoKey) ? memoHit : resolveZcodeReasoningValues(modelRef, this.deps.sources);
+    this.reasoningMemo.set(memoKey, domain);
+    if (domain === void 0 || domain.length === 0) return void 0;
+    const requested = thinkingLevel?.trim();
+    if (requested === void 0 || requested === "") return domain[0];
+    if (domain.includes(requested)) return requested;
+    if (OFF_FAMILY_THINKING_LEVELS.has(requested)) return domain[0];
+    const nonMinimal = domain.slice(1);
+    return nonMinimal.length > 0 ? nonMinimal[nonMinimal.length - 1] : domain[0];
   }
   /**
    * [u-h2 D2-2] 派发同步期 model 校验：委托 resolveZcodeModelRef（与 run prepare 期
@@ -2550,7 +2913,7 @@ var ZcodeEngine = class {
         }
       } else {
         const poolDir = path4.resolve(
-          (0, import_subagent_engine_sdk11.resolvePoolDir)(this.deps.engineDataDir(), ZCODE_ENGINE_ID, import_subagent_engine_sdk11.SHARED_POOL_KEY)
+          (0, import_subagent_engine_sdk12.resolvePoolDir)(this.deps.engineDataDir(), ZCODE_ENGINE_ID, import_subagent_engine_sdk12.SHARED_POOL_KEY)
         );
         const resolved = path4.resolve(poolDir, dbPathRaw);
         if (resolved.startsWith(poolDir + path4.sep)) {
@@ -2568,7 +2931,7 @@ var ZcodeEngine = class {
           logger4.warn("[zcode-engine] native session read failed, degrade to journal replay", {
             dbPath,
             sessionId,
-            reason: (0, import_subagent_engine_sdk4.toErrorMessage)(err)
+            reason: (0, import_subagent_engine_sdk5.toErrorMessage)(err)
           });
         }
       }
@@ -2655,7 +3018,7 @@ var ZcodeEngine = class {
   buildPrompt(task, schema) {
     const segments = [...task.appendSystemPrompt ?? []];
     segments.push(task.prompt);
-    if (schema !== void 0) segments.push((0, import_subagent_engine_sdk11.buildSchemaEmulationSegment)(schema));
+    if (schema !== void 0) segments.push((0, import_subagent_engine_sdk12.buildSchemaEmulationSegment)(schema));
     return segments.join("\n\n");
   }
 };
@@ -2698,7 +3061,7 @@ function isPlainObject(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 function errMessage3(err) {
-  return (0, import_subagent_engine_sdk4.toErrorMessage)(err);
+  return (0, import_subagent_engine_sdk5.toErrorMessage)(err);
 }
 function resolveAppserverTimingMs(envName, fallbackMs, label) {
   const raw = process.env[envName];
@@ -2810,7 +3173,7 @@ function parsedAppServerAttempt(task, r) {
     kind: "parsed",
     output: syntheticAppServerOutput(0),
     payload: turnResultToPayload(r),
-    ...schema !== void 0 ? { schemaResult: (0, import_subagent_engine_sdk11.extractAndValidateStructuredOutput)(r.response, schema) } : {}
+    ...schema !== void 0 ? { schemaResult: (0, import_subagent_engine_sdk12.extractAndValidateStructuredOutput)(r.response, schema) } : {}
   };
 }
 function failedTerminalAppServerAttempt(r) {
@@ -2848,16 +3211,16 @@ function failedAppServerAttempt(err, currentSessionId, opts = {}) {
   };
 }
 function isHostTimeoutAbort(ctx) {
-  return ctx.signal?.aborted === true && ctx.signal.reason === import_subagent_engine_sdk11.HOST_TIMEOUT_ABORT_REASON;
+  return ctx.signal?.aborted === true && ctx.signal.reason === import_subagent_engine_sdk12.HOST_TIMEOUT_ABORT_REASON;
 }
 var PROBE_STDOUT_CAP_CHARS = 4096;
 async function defaultProbeVersion(cliPath, dataDir) {
   try {
     return await new Promise((resolve2, reject) => {
-      const child = (0, import_subagent_engine_sdk11.spawnEngineChild)({
+      const child = (0, import_subagent_engine_sdk12.spawnEngineChild)({
         command: "node",
         args: [cliPath, "--version"],
-        env: (0, import_subagent_engine_sdk11.buildEngineChildEnv)(process.env, { dataDir }),
+        env: (0, import_subagent_engine_sdk12.buildEngineChildEnv)(process.env, { dataDir }),
         stdout: "pipe",
         stderr: "ignore",
         signal: AbortSignal.timeout(PROBE_VERSION_TIMEOUT_MS)
@@ -2875,7 +3238,7 @@ async function defaultProbeVersion(cliPath, dataDir) {
     });
   } catch (err) {
     logger4.debug(
-      `[zcode-engine] probe version check failed (best-effort continue): ${(0, import_subagent_engine_sdk4.toErrorMessage)(err)}`
+      `[zcode-engine] probe version check failed (best-effort continue): ${(0, import_subagent_engine_sdk5.toErrorMessage)(err)}`
     );
     return void 0;
   }
@@ -2883,7 +3246,7 @@ async function defaultProbeVersion(cliPath, dataDir) {
 
 // src/registration.ts
 function defaultEngineDataDir() {
-  return (0, import_subagent_engine_sdk12.resolveEngineDataDir)(process.env);
+  return (0, import_subagent_engine_sdk13.resolveEngineDataDir)(process.env);
 }
 function createZcodeEngine(deps) {
   return new ZcodeEngine(deps);
@@ -2896,11 +3259,11 @@ function createDefaultZcodeEngine() {
 }
 
 // src/port-types.ts
-var import_subagent_engine_sdk13 = require("@zhushanwen/subagent-engine-sdk");
+var import_subagent_engine_sdk14 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/server.ts
 var import_server = require("@zhushanwen/subagent-engine-sdk/server");
-var logger5 = (0, import_subagent_engine_sdk14.getLogger)("subagents");
+var logger5 = (0, import_subagent_engine_sdk15.getLogger)("subagents");
 var EngineProtocolServer = class {
   write;
   engine;
@@ -2970,7 +3333,7 @@ var EngineProtocolServer = class {
     const active = { controller, seq: 0 };
     this.activeRuns.set(runId, active);
     const fullTask = (0, import_server.assembleFullTask)(task, ctx);
-    const ctxModel = (0, import_subagent_engine_sdk13.parseCtxModel)(ctx.ctxModel);
+    const ctxModel = (0, import_subagent_engine_sdk14.parseCtxModel)(ctx.ctxModel);
     const stream = ctx.streamMode === "stream" ? {
       onDelta: (delta) => {
         void this.reverseRequestInternal("host/streamDelta", { runId, delta }).catch(this.warnReverseFailure("host/streamDelta", `run ${runId}`));
@@ -3006,7 +3369,7 @@ var EngineProtocolServer = class {
   }
   validateModel(params) {
     if (this.engine.validateModel === void 0) {
-      throw new import_subagent_engine_sdk14.EngineSdkError(
+      throw new import_subagent_engine_sdk15.EngineSdkError(
         "engine_capability_unsupported",
         "engine does not implement validateModel",
         "Manifest omits modelCatalog; model validation falls back to run-time engine checks."
@@ -3033,7 +3396,7 @@ var EngineProtocolServer = class {
   warnReverseFailure(method, context) {
     return (err) => {
       logger5.warn(`[protocol] ${method} reverse request failed (${context}); continuing without it`, {
-        detail: (0, import_subagent_engine_sdk4.toErrorMessage)(err)
+        detail: (0, import_subagent_engine_sdk5.toErrorMessage)(err)
       });
     };
   }
@@ -3062,7 +3425,7 @@ var EngineProtocolServer = class {
     clearTimeout(pending.timer);
     this.reverseClock?.acked(String(id));
     this.reverseClock?.settled(String(id));
-    if (frame.error !== void 0) pending.reject(new Error(`reverse request ${String(id)} rejected: ${(0, import_subagent_engine_sdk4.toErrorMessage)(frame.error)}`));
+    if (frame.error !== void 0) pending.reject(new Error(`reverse request ${String(id)} rejected: ${(0, import_subagent_engine_sdk5.toErrorMessage)(frame.error)}`));
     else pending.resolve(frame.result);
   }
 };
@@ -3075,8 +3438,8 @@ function toProtocolError(err) {
 }
 
 // src/main.ts
-var clock = (0, import_subagent_engine_sdk15.armEngineSelfDestruct)({ stdin: process.stdin });
-(0, import_subagent_engine_sdk15.runEngineCliEntry)({
+var clock = (0, import_subagent_engine_sdk16.armEngineSelfDestruct)({ stdin: process.stdin });
+(0, import_subagent_engine_sdk16.runEngineCliEntry)({
   component: "zcode-engine-cli",
   server: new EngineProtocolServer({
     write: (frame) => {