@zhushanwen/zcode-subagent-cli 0.5.0 → 0.7.0

package/dist/index.cjs

@@ -46,7 +46,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // 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";
@@ -82,13 +82,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");
@@ -159,6 +159,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) {
@@ -167,35 +168,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;
@@ -230,6 +277,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;
@@ -320,15 +401,14 @@ function defaultProviderForShortName(conf, withKey) {
   return withKey[0][0];
 }
 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 "";
@@ -339,26 +419,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;
@@ -378,7 +458,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";
@@ -390,6 +470,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');
+// \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
@@ -398,6 +484,10 @@ const CONFIG_PATH = path.join(os.homedir(), '.zcode', 'cli', 'config.json');
 // \u914D\u7F6E\uFF082026-08-25 \u4E8B\u6545\uFF1A\u6B8B\u7559\u65E7 key \u538B\u8FC7\u65B0\u51ED\u636E\u81F4 turn 0 401\uFF09\uFF0C\u6545\u4E0D\u53D6 real \u4F18\u5148\u3002
 // model.main \u7F3A\u5931\u65F6\u53EA\u4ECE v2 \u900F\u4F20\uFF08v2 \u4E5F\u6CA1\u6709\u5219\u4E0D\u4F2A\u9020\u2014\u2014CLI \u7F3A\u7701\u89E3\u6790\u81EA\u4F1A\u843D\u5230\u6CE8\u518C\u8868
 // \u53EF\u7528\u6A21\u578B\uFF1Bplan \u5BB6\u65CF id \u5DF2\u4E0D\u53EF\u7528\uFF0C\u4E0D\u518D\u515C\u5E95\u4F2A\u9020\uFF09\u3002
+// [D3 \u987A\u5E26\u53D1\u73B0 6] provider_config.json\uFF08\u5F15\u64CE\u4FA7\u6A21\u578B\u6821\u9A8C\u6E90\uFF09\u8865\u6CE8\u5165\uFF1A\u4EC5\u5B58\u5728\u4E8E
+// providerRules \u7684\u4E2A\u4EBA provider\uFF08v2 \u5B57\u5178\u672A\u7269\u5316\uFF09\u4E0D\u5728\u6CE8\u5165\u96C6 \u2192 app-server \u6CE8\u518C\u8868
+// \u7F3A\u6761\u76EE\uFF0C\u663E\u5F0F\u6A21\u578B\u9996\u6D3E\u5373\u62A5\u300CProvider Registry \u4E2D\u4E0D\u5B58\u5728 Model\u300D\u3002\u4E3A\u5E26 apiKey+baseUrl
+// \u4E14 v2/real \u5747\u7F3A\u5931\u7684 rule \u5408\u6210 cli-config \u6761\u76EE\uFF08\u5F62\u72B6\u7167\u6284\u73B0\u7F51\u4E2A\u4EBA\u6761\u76EE\uFF09\u3002
 // \u8FD4\u56DE null = \u65E0\u53EF\u6CE8\u5165\u51ED\u636E\uFF08v2 \u65E0 provider \u6761\u76EE\uFF09\u2014\u2014\u4E0D patch\uFF0C\u8BA9\u539F\u751F\u62A5\u9519\u900F\u51FA\u3002
 // \u8BFB\u6E90\u7ECF readOrig \u95F4\u63A5\u53D6\uFF1Apatch \u524D\u9996\u8C03 = fs.readFileSync \u672C\u4F53\uFF1Bpatch \u540E = \u539F\u51FD\u6570
 // \uFF08\u9632 patch \u540E\u7684\u9012\u5F52\u81EA\u8C03\u7528\uFF09\u3002
@@ -415,6 +505,7 @@ function injectedConfigText() {
     }
     return null;
   }
+  const realProviders = real.provider && typeof real.provider === 'object' ? real.provider : {};
   const v2Providers = v2.provider && typeof v2.provider === 'object' ? v2.provider : {};
   const hasKey = (entry) => entry && typeof entry === 'object'
     && entry.options && typeof entry.options.apiKey === 'string' && entry.options.apiKey !== '';
@@ -422,9 +513,63 @@ function injectedConfigText() {
   for (const [id, entry] of Object.entries(v2Providers)) {
     if (hasKey(entry)) injectable[id] = entry;
   }
+  // provider_config.json \u8865\u6CE8\u5165\uFF08\u8BFB\u53D6\u5931\u8D25\u9759\u9ED8\u964D\u7EA7\u2014\u2014\u6821\u9A8C\u6E90\u7F3A\u5E2D\u65F6\u5F15\u64CE\u4FA7\u6821\u9A8C\u540C\u6837\u4E0D\u53EF
+  // \u7528\uFF0C\u6CE8\u5165\u9762\u7EF4\u6301 v2-only \u73B0\u72B6\uFF1BproviderRules \u7F3A\u5931\u4E0D\u6784\u6210\u51ED\u636E\u9519\u8BEF\uFF09\u3002
+  try {
+    const pc = JSON.parse(readOrig(PROVIDER_CONFIG_PATH, 'utf8'));
+    const pcCfg = pc && typeof pc.config === 'object' && pc.config ? pc.config : {};
+    const pcr = typeof pcCfg.providerConfigRules === 'object' && pcCfg.providerConfigRules ? pcCfg.providerConfigRules : {};
+    const rules = Array.isArray(pcr.providerRules) ? pcr.providerRules : [];
+    const mcr = typeof pcCfg.modelConfigRules === 'object' && pcCfg.modelConfigRules ? pcCfg.modelConfigRules : {};
+    const modelRules = Array.isArray(mcr.providerModelRules) ? mcr.providerModelRules : [];
+    const modelMeta = {};
+    for (const mr of modelRules) {
+      if (!mr || typeof mr !== 'object' || typeof mr.providerId !== 'string' || typeof mr.modelId !== 'string') continue;
+      (modelMeta[mr.providerId] = modelMeta[mr.providerId] || []).push(mr);
+    }
+    for (const rule of rules) {
+      if (!rule || typeof rule !== 'object') continue;
+      const id = typeof rule.providerId === 'string' ? rule.providerId : '';
+      const cfg = rule.config && typeof rule.config === 'object' ? rule.config : {};
+      const access = cfg.access && typeof cfg.access === 'object' ? cfg.access : {};
+      const api = cfg.api && typeof cfg.api === 'object' ? cfg.api : {};
+      // v2/real \u5DF2\u6709 \u2192 \u4E0D\u91CD\u590D\u5408\u6210\uFF08v2 \u6761\u76EE\u66F4\u5168\uFF0C\u6574\u6761\u4F18\u5148\u8BED\u4E49\u4E0D\u53D7\u5F71\u54CD\uFF09
+      if (!id || injectable[id] || realProviders[id]) continue;
+      // hasKey \u7EAA\u5F8B\u540C\u6B3E\uFF1A\u65E0 apiKey \u4E0D\u5408\u6210\uFF1B\u65E0 baseUrl\uFF08endpoint \u7531\u6A21\u677F\u63D0\u4F9B\u7684\u5F62\u6001\uFF09
+      // \u4E0D\u5408\u6210\u2014\u2014\u6B8B\u7F3A\u6761\u76EE\u6BD4\u4E0D\u6CE8\u5165\u66F4\u7CDF\uFF0C\u539F\u751F\u300C\u4E0D\u5B58\u5728 Model\u300D\u62A5\u9519\u7167\u65E7\u900F\u51FA
+      if (typeof access.apiKey !== 'string' || access.apiKey === '') continue;
+      if (typeof api.baseUrl !== 'string' || api.baseUrl === '') continue;
+      const order = Array.isArray(cfg.modelOrder) ? cfg.modelOrder
+        : (Array.isArray(cfg.personalModelIds) ? cfg.personalModelIds : []);
+      const models = {};
+      for (const mr of modelMeta[id] || []) {
+        const mrCfg = mr.config && typeof mr.config === 'object' ? mr.config : {};
+        if (mrCfg.enabled === false) continue; // \u7981\u7528\u6A21\u578B\u4E0D\u8FDB\u6CE8\u518C\u8868\uFF08GUI \u8BED\u4E49\u4E00\u81F4\uFF09
+        const props = mrCfg.properties && typeof mrCfg.properties === 'object' ? mrCfg.properties : {};
+        models[mr.modelId] = typeof props.contextWindow === 'number'
+          ? { limit: { context: props.contextWindow } }
+          : {};
+      }
+      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,
+        kind: api.type === 'anthropic-messages' ? 'anthropic' : 'openai-compatible',
+        options: { apiKey: access.apiKey, baseURL: api.baseUrl },
+        source: 'custom',
+        models: models,
+      };
+    }
+  } catch { /* provider_config \u7F3A\u5931/\u635F\u574F \u2192 \u8865\u6CE8\u5165\u9762\u9759\u9ED8\u964D\u7EA7\uFF08v2 \u6CE8\u5165\u4E0D\u53D7\u5F71\u54CD\uFF09 */ }
   if (Object.keys(injectable).length === 0) return null;
   const merged = { ...real };
-  merged.provider = { ...(real.provider && typeof real.provider === 'object' ? real.provider : {}), ...injectable };
+  merged.provider = { ...realProviders, ...injectable };
   if ((!merged.model || typeof merged.model !== 'object' || !merged.model.main)
       && v2.model && typeof v2.model === 'object' && v2.model.main) {
     merged.model = { ...(merged.model || {}), main: v2.model.main };
@@ -432,6 +577,77 @@ 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);
@@ -455,6 +671,11 @@ if (text !== null) {
       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);
+    }
     return fs.__origReadFileSync.call(fs, p, ...rest);
   };
   fs.promises.__origReadFile = fs.promises.readFile;
@@ -463,17 +684,27 @@ if (text !== null) {
       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));
+    }
     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
+  // \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);
   };
 }
@@ -568,7 +799,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`
     );
@@ -826,21 +1057,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,
@@ -862,11 +1093,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"
   };
 }
@@ -1016,7 +1247,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 于进程
@@ -1028,7 +1259,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;
   }
@@ -1047,10 +1278,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）。
@@ -1088,7 +1319,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);
@@ -1229,8 +1460,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();
       }
     }
@@ -1248,8 +1479,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;
@@ -1258,7 +1489,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);
@@ -1785,8 +2016,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;
@@ -1942,7 +2173,7 @@ 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 ZcodeEngine = class {
@@ -1991,7 +2222,10 @@ var ZcodeEngine = class {
       // --mode build/edit/plan/yolo 原生权限档位
       permissionMode: "native",
       // [D3-④] 无 turn_end 语义，轮数上限不可兑现（预检 gate 据此同步拒绝）
-      maxTurns: false
+      maxTurns: false,
+      // [subagent-model-switch] zcode 引擎不在模型切换设计范围（协议面引擎中立预留，
+      // 后续另立项接入）——setModel 通路未接通，unsupported 如实声明
+      setModel: "unsupported"
     };
   }
   /** 探针（D7）：二进制存在 + 版本解析（zcode 无公开契约，版本漂移的入口信号）。 */
@@ -2308,6 +2542,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 = resolvePersonalProviderConfigPath(this.deps.sources, engineDataDir);
     const sessionDbPath = zcodeSessionDbPath(engineDataDir);
     env.ZCODE_SESSION_DB_PATH = sessionDbPath;
     delete env.ZCODE_SESSION_DB;
@@ -2404,7 +2639,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 });
   }
   /**
@@ -2509,7 +2744,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)) {
@@ -2527,7 +2762,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)
           });
         }
       }
@@ -2614,7 +2849,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");
   }
 };
@@ -2657,7 +2892,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];
@@ -2769,7 +3004,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) {
@@ -2807,16 +3042,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)
@@ -2834,7 +3069,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;
   }
@@ -2842,7 +3077,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);
@@ -2855,11 +3090,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;
@@ -2929,7 +3164,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}`));
@@ -2965,7 +3200,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."
@@ -2992,7 +3227,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)
       });
     };
   }
@@ -3021,7 +3256,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);
   }
 };