@zhushanwen/zcode-subagent-cli 0.5.0 → 0.6.0

package/dist/{chunk-NC4FSPIM.js → chunk-PWNJ5JYZ.js}

@@ -600,6 +600,7 @@ 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');
 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
@@ -608,6 +609,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
@@ -625,6 +630,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 !== '';
@@ -632,9 +638,60 @@ 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] = {};
+      }
+      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',
+        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 };
@@ -1973,7 +2030,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 无公开契约，版本漂移的入口信号）。 */
@@ -2290,6 +2350,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();
     const sessionDbPath = zcodeSessionDbPath(engineDataDir);
     env.ZCODE_SESSION_DB_PATH = sessionDbPath;
     delete env.ZCODE_SESSION_DB;

package/dist/index.cjs

@@ -390,6 +390,7 @@ 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');
 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 +399,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 +420,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 +428,60 @@ 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] = {};
+      }
+      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',
+        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 };
@@ -1991,7 +2048,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 +2368,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();
     const sessionDbPath = zcodeSessionDbPath(engineDataDir);
     env.ZCODE_SESSION_DB_PATH = sessionDbPath;
     delete env.ZCODE_SESSION_DB;

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   readZcodeSessionView,
   zcodeDbPathAllowlist,
   zcodeSessionDbPath
-} from "./chunk-NC4FSPIM.js";
+} from "./chunk-PWNJ5JYZ.js";
 
 // src/golden-sample.ts
 var ZCODE_APPSERVER_GOLDEN = {

package/dist/main.cjs

@@ -370,6 +370,7 @@ 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');
 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
@@ -378,6 +379,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
@@ -395,6 +400,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 !== '';
@@ -402,9 +408,60 @@ 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] = {};
+      }
+      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',
+        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 };
@@ -1971,7 +2028,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 无公开契约，版本漂移的入口信号）。 */
@@ -2288,6 +2348,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();
     const sessionDbPath = zcodeSessionDbPath(engineDataDir);
     env.ZCODE_SESSION_DB_PATH = sessionDbPath;
     delete env.ZCODE_SESSION_DB;

package/dist/main.js

@@ -1,6 +1,6 @@
 import {
   EngineProtocolServer
-} from "./chunk-NC4FSPIM.js";
+} from "./chunk-PWNJ5JYZ.js";
 
 // src/main.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/zcode-subagent-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "zcode subagent engine as an independent CLI package (W5 of subagent-engine-protocolization): speaks engine-protocol v1 over NDJSON stdio, depends only on @zhushanwen/subagent-engine-sdk (never subagent-core)",
   "type": "module",
   "license": "MIT",
@@ -46,7 +46,8 @@
         "resume": "cold",
         "interrupt": "kill-only",
         "permissionMode": "native",
-        "maxTurns": false
+        "maxTurns": false,
+        "setModel": "unsupported"
       },
       "modelCatalog": {
         "dynamic": true,
@@ -62,7 +63,7 @@
     "dist/"
   ],
   "dependencies": {
-    "@zhushanwen/subagent-engine-sdk": "0.9.0"
+    "@zhushanwen/subagent-engine-sdk": "0.10.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",