dsh-plugin-litellm-bridge 2.1.0 → 2.1.2

package/dsh-plugin-litellm-bridge/client/index.js

@@ -14,7 +14,6 @@
  *                    保存 → 组装 yaml → 调网关热重载
  *   3. 日志面板      拉网关调用日志，按 agent-type / profile 筛选；
  *                    橙色高亮触发 fallback，红色标记全链路失败；默认留最近 50 条
- *   4. 当前会话      会话绑定 profile 下拉（持久化到会话变量）；
  *                    本会话最近降级记录；一键探针测试
  */
 
@@ -793,7 +792,7 @@ window.__ModuleLoader__.load({
         ),
         h('div', { style: { ...S.hint, marginTop: -6, marginBottom: 14 } },
           '一个 profile = 一套降级方案。可以配多套（例如「稳定优先」「省钱优先」），' +
-          '再到「当前会话」里选用哪一套。'),
+          '再到会话标题旁的按钮里选用哪一套。'),
 
         showNew && h('div', { style: { ...S.row, marginBottom: 14 } },
           h('input', {
@@ -1169,148 +1168,6 @@ window.__ModuleLoader__.load({
     }
 
     // -----------------------------------------------------------------------
-    // Tab 4：当前会话
-    // -----------------------------------------------------------------------
-    function SessionTab({ api, ctx, state, setState }) {
-      const profileIds = state?.profileIds || Object.keys(state?.routes || {});
-      const [profile, setProfile] = useState('');
-      const [saved, setSaved] = useState(null);
-      const [busy, setBusy] = useState(false);
-      const [probe, setProbe] = useState(null);
-      const [drops, setDrops] = useState([]);
-
-      // 当前会话 id：尽量从宿主会话上下文取；取不到就用 URL 里的会话标记
-      // 当前会话 id：尽量从宿主会话上下文取；取不到就用 URL 里的会话标记。
-      // 【注意】依赖数组里不能放 ctx / api —— 它们是每次渲染新建的对象，
-      // 放进去会触发无限重渲染（表现为整页空白）。
-      const sessionId = useMemo(() => {
-        try {
-          const fromCtx = ctx?.session?.id || ctx?.sessionId;
-          if (fromCtx) return String(fromCtx);
-          const loc = globalThis.location;
-          const hay = String(loc?.hash || '') + String(loc?.search || '');
-          const m = hay.match(/session[=/]([A-Za-z0-9_-]+)/i);
-          return m ? m[1] : 'current';
-        } catch {
-          return 'current';
-        }
-      }, []);
-
-      useEffect(() => {
-        api('session/getProfile', { sessionId }).then((r) => {
-          if (r.ok) setProfile(r.data || '');
-        });
-      }, [api, sessionId]);
-
-      // 本会话最近降级记录：从日志里按 profile 过滤出 fallback 行
-      const loadDrops = useCallback(async () => {
-        const r = await api('logs/fetch', { limit: 50 });
-        if (r.ok) setDrops((r.data || []).filter((l) => l.fallback === 'yes' || l.status === 'failure').slice(0, 10));
-      }, [api]);
-      useEffect(() => { loadDrops(); }, [loadDrops]);
-
-      // 子代理路由覆盖状态
-      const [rt, setRt] = useState(null);
-      useEffect(() => {
-        api('routing/status', { sessionId }).then((r) => { if (r.ok) setRt(r.data); });
-      }, [api, sessionId]);
-
-      const save = async () => {
-        setBusy(true);
-        const r = await api('session/setProfile', { sessionId, profile });
-        setSaved(r.ok ? { kind: 'ok', text: `已绑定 ${profile || '（已清空）'}，存入会话变量` } : { kind: 'err', text: r.error });
-        setBusy(false);
-      };
-
-      const runProbe = async () => {
-        setBusy(true); setProbe(null);
-        const agentType = 'root';
-        // 【需求4】探针测的是当前 profile 里选中的链头模型，不是写死的名字
-        const r = await api('probe/run', { agentType, profileId: profile || profileIds[0] });
-        setProbe(r.ok
-          ? { kind: 'ok', text: `探针通过（${r.latencyMs}ms）· 回复 ${JSON.stringify(r.data.reply)} · 上游模型 ${r.data.modelUsed}` }
-          : { kind: 'err', text: `探针失败：${r.error}` });
-        setBusy(false);
-      };
-
-      return h('div', null,
-        h('div', { style: S.card },
-          h('div', { style: S.field },
-            h('label', { style: S.label }, '本会话绑定的 Profile（降级链方案）'),
-            h('select', {
-              style: S.input, value: profile, onChange: (e) => setProfile(e.target.value),
-            },
-              h('option', { value: '' }, '（不绑定）'),
-              profileIds.map((p) => h('option', { key: p, value: p }, safeText(p))),
-            ),
-            h('div', { style: S.hint },
-              '绑定后：本会话的 root 请求按该 profile 的 root 链走；spawn 的子 Agent 按同 profile 的 coder/research 链走。'),
-          ),
-          h('div', { style: S.row },
-            h('button', { style: S.btn('primary'), onClick: save, disabled: busy }, '保存到会话变量'),
-            h('button', { style: S.btn(), onClick: runProbe, disabled: busy }, busy ? '测试中…' : '一键探针测试'),
-          ),
-          h('div', { style: { ...S.mono, color: T.labelSecondary, marginTop: 8, fontSize: 11 } },
-            `会话变量键：litellm-bridge/session-profile · sessionId=${sessionId}`),
-          saved && h('div', {
-            style: { marginTop: 9, fontSize: 12, color: saved.kind === 'ok' ? T.success : T.error },
-          }, saved.text),
-          probe && h('div', {
-            style: { marginTop: 9, fontSize: 12, color: probe.kind === 'ok' ? T.success : T.error },
-          }, probe.text),
-        ),
-
-        rt && h('div', { style: S.card },
-          h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '子代理路由覆盖'),
-          (() => {
-            const sp = rt.sessionProvider;
-            const isNative = sp && rt.nativeProviders.some((p) => sp.toLowerCase() === p || sp.toLowerCase().startsWith(p + '-'));
-            const isGw = sp && sp.toLowerCase().startsWith('litellm');
-            const verdict = !sp ? { t: '未知', c: S.warn, d: '尚未观察到本会话的模型请求，暂不覆盖（fail-open）' }
-              : isGw ? { t: '全部走网关', c: S.ok, d: '主 Agent 与子 Agent 均走网关链路，不做覆盖' }
-              : isNative ? { t: '子代理将改道网关', c: S.warn, d: `主 Agent 保留 ${sp}（消耗积分）；子 Agent 强制走 ${rt.gatewayProvider}` }
-              : { t: '不覆盖', c: S.ok, d: `供应商 ${sp} 不在覆盖名单` };
-            return h('div', null,
-              h('div', { style: { marginBottom: 6 } },
-                h('span', { style: S.badge() }, `当前供应商: ${sp || '未知'}`),
-                h('span', { style: { color: verdict.c, fontWeight: 600 } }, verdict.t),
-              ),
-              h('div', { style: { fontSize: 12, opacity: 0.75, marginBottom: 6 } }, verdict.d),
-              h('div', { style: { ...S.mono, fontSize: 11, opacity: 0.55 } },
-                `覆盖名单: ${rt.nativeProviders.join(' / ')}  ·  目标: ${rt.gatewayProvider}`),
-              h('div', { style: { ...S.mono, fontSize: 11, opacity: 0.55, marginTop: 3 } },
-                `已评估 ${rt.stats.evaluated} 次 · 改道 ${rt.stats.overridden} 次 · 跳过 ${rt.stats.skipped} 次 · 降级 ${rt.stats.degraded} 次`),
-            );
-          })(),
-        ),
-
-        h('div', { style: S.card },
-          h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '本会话最近降级记录'),
-          drops.length === 0
-            ? h('div', { style: { opacity: 0.5, fontSize: 12 } }, '暂无降级记录（或网关日志不含该字段）')
-            : drops.map((d, i) => h('div', { key: i, style: S.logRow(d.status === 'failure' ? 'failed' : 'fallback') },
-                h('span', { style: { ...S.mono } }, d.model),
-                h('span', { style: { ...S.mono, opacity: 0.6, marginLeft: 8 } },
-                  d.fallback === 'yes' ? '触发降级' : '失败'),
-                d.error && h('div', { style: { ...S.mono, fontSize: 11, color: S.err, marginTop: 3 } }, d.error),
-              )),
-        ),
-
-        h('div', { style: { ...S.mono, opacity: 0.5, fontSize: 11.5, lineHeight: 1.7 } },
-          h('div', null, '联动说明：本插件读写会话 profile 变量 + 子代理路由覆盖；'),
-          h('div', null, 'dsh-plugin-header-inject 读取该变量并注入 x-agent-type / x-session-profile。'),
-          h('div', null, '两插件通过会话变量解耦，互不依赖。'),
-        ),
-      );
-    }
-
-    /**
-     * 创建**稳定引用**的 api 函数（同一个插件实例只创建一次）。
-     *
-     * 为什么必须要稳定：各 Tab 的 useEffect 依赖数组里都有 [api]。若 api 每次
-     * 渲染都变，就会 effect→setState→重渲染→新 api→再 effect 无限循环，
-     * React 表现为组件反复重挂载、页面空白。
-     */
     const apiCache = new WeakMap();
     function createStableApi(ctx) {
       const hit = apiCache.get(ctx);
@@ -1323,10 +1180,12 @@ window.__ModuleLoader__.load({
     // -----------------------------------------------------------------------
     // 【会话级入口】标题旁的小按钮 —— 直接给当前会话选降级链（profile）
     //
-    // 槽位：conversation.session.header.actions（list，scope: session）
-    //   ownerProps 为空；组件通过标准 props 拿到 sessionId。
-    //   这是 dsh-llm-fallbacks 同款做法，replaceRisk: none，不动官方 UI。
+    // 槽位：conversation.session.header.actions（会话标题旁那排胶囊）
+    //   —— 与 dsh-llm-fallbacks 的 SubagentRoleBadge 同槽位，实测渲染正常
+    //   （用户截图里的「未绑定」按钮就出现在这排）。
     //
+    // 为什么不用 conversation.input.right：上一版挪过去后从未同步安装，
+    //   属于未验证的倒退；本槽位已有实证可显示，保持不动。
     // 为什么不做进右下角模型选择器：
     //   那个槽位是 conversation.input.model（single，shadows-shipped-ui），
     //   注册即替换掉官方选择器，得不偿失。
@@ -1491,7 +1350,7 @@ window.__ModuleLoader__.load({
     // 主面板 —— 对齐 dsh-llm-fallbacks 的官方设置页语言：
     //   扁平页面（无卡片壳）· 顶部标签导航 · 页内分区 h2 + 每区独立 Save/Discard
     // -----------------------------------------------------------------------
-    function BridgePanel({ api, ctx }) {
+    function BridgePanel({ api }) {
       const [tab, setTab] = useState('gateway');
       const [state, setState] = useState(null);
 
@@ -1503,7 +1362,6 @@ window.__ModuleLoader__.load({
         ['gateway', '网关设置'],
         ['routes', '路由配置'],
         ['logs', '日志面板'],
-        ['session', '当前会话'],
       ];
 
       return h('div', { style: S.page },
@@ -1518,7 +1376,6 @@ window.__ModuleLoader__.load({
           tab === 'gateway' && h(Guard, { title: '网关设置' }, () => h(GatewayTab, { api, state, setState })),
           tab === 'routes' && h(Guard, { title: '路由配置' }, () => h(RouteTab, { api, state, setState })),
           tab === 'logs' && h(Guard, { title: '日志面板' }, () => h(LogsTab, { api, state })),
-          tab === 'session' && h(Guard, { title: '当前会话' }, () => h(SessionTab, { api, ctx, state, setState })),
         ),
       );
     }
@@ -1562,7 +1419,7 @@ window.__ModuleLoader__.load({
       // 会导致「effect -> setState -> 重渲染 -> 新 api -> 再跑 effect」死循环，
       // 表现就是整页空白。
       const api = createStableApi(ctx);
-      const Panel = () => h(BridgePanel, { api, ctx });
+      const Panel = () => h(BridgePanel, { api });
 
       // 【必须用 ctx.effect 包住注册】
       // client 侧模板要求 apply 通过 ctx.effect 注册每个资源并返回清理函数。
@@ -1587,19 +1444,30 @@ window.__ModuleLoader__.load({
         });
 
         // ---- (2) 会话标题旁的小按钮：直接为当前会话选降级链 ----
-        //     槽位是 list + scope:session，组件通过标准 props 拿到 sessionId。
+        //
+        // 【为什么改成命名组件】
+        // 原来传的是内联箭头函数 (props) => h(...)。
+        // 内联函数每次 inject 都是**新的函数引用**，React 会视为不同组件类型
+        // 而卸载重挂 —— 轻则不显示，重则状态丢失。
+        // settings.section 传的是命名组件 Panel（能正常显示），这里照同一写法。
+        //
+        // 【order 从 -5 改为 0】
+        // 负 order 会排到列表最前，可能被容器左边缘裁掉
+        //（该 slot 文档写明「overflow is clipped and faded before the utilities」）。
+        // 用 0 让它排在默认位置。
+        const HeaderAction = (props) => h(SessionProfileButton, {
+          api,
+          sessionId: props?.sessionId ?? props?.session?.id ?? 'current',
+        });
+
         const disposeHeader = ctx.slots.inject('conversation.session.header.actions', () => {
           return ctx.slots.register(
             {
               name: 'conversation.session.header.actions',
               id: NS,
-              order: -5,
-              label: () => '降级链',
+              order: 4,
             },
-            (props) => h(SessionProfileButton, {
-              api,
-              sessionId: props?.sessionId ?? props?.session?.id ?? 'current',
-            }),
+            HeaderAction,
           );
         });
 

package/dsh-plugin-litellm-bridge/lib/assemble-chain.js

@@ -243,6 +243,28 @@ export function assembleChainConfig(state, pool = null) {
   push('  forward_client_headers_to_llm_api: true   # pass x-agent-type / x-session-profile through');
   push('');
 
+  // ---- 4. 请求体大小上限 ------------------------------------------------
+  //
+  // 【为什么必须配】
+  // 用户实测两个错误：
+  //   413 {"detail":{"error":{"message":"Request body is 6483286 bytes,
+  //        over the 5242880 byte limit","code":"request_too_large"}}}
+  //   502 Bad Gateway (nginx)
+  //
+  // 第一个是 LiteLLM 自己的限制：general_settings.max_request_size_mb
+  // 默认 5MB（5242880 字节）。长对话 + 图片附件很容易超。
+  // 官方生产建议 32MB。
+  //
+  // 第二个 502 来自前置 nginx：请求体过大时 nginx 直接断开，
+  // 表现为 502 而不是 413。LiteLLM 侧放宽后仍需 nginx 侧配合
+  // （client_max_body_size），这一项插件无法代配，会在 UI 提示。
+  push('general_settings:');
+  push('  # Allow large requests (long conversations + image attachments).');
+  push('  # Default is 5MB; the plugin raises it to 32MB (LiteLLM production guidance).');
+  push('  max_request_size_mb: 32');
+  push('  max_response_size_mb: 32');
+  push('');
+
   return {
     yaml: lines.join('\n'),
     warnings: [...new Set(warnings)],

package/dsh-plugin-litellm-bridge/lib/index.js

@@ -226,6 +226,25 @@ export function apply(ctx, config = {}) {
     return proceed();
   });
 
+  /**
+   * 给定 agent 类型与会话，算出它实际会用的链头名。
+   *
+   * 抽成独立函数的原因：子代理改道（modelFor）与 UI 的「这条会话走哪条链」
+   * 必须用**同一套逻辑**，否则显示的和实际跑的可能不一致 —— 那比不显示更糟。
+   */
+  function chainHeadFor(agentType, parentSessionId) {
+    try {
+      const profileId = parentSessionId ? getSessionProfile(ctx, parentSessionId) : '';
+      const routes = store.get().routes;
+      const pid = routes[profileId] ? profileId : Object.keys(routes)[0] || DEFAULT_PROFILE_ID;
+      const cfg = routes?.[pid]?.agents?.[agentType];
+      if (cfg?.primary) return `${agentType}-${pid}-primary`;
+      return `${agentType}-${pid}-primary`;
+    } catch {
+      return `${agentType}-${DEFAULT_PROFILE_ID}-primary`;
+    }
+  }
+
   // -------------------------------------------------------------------------
   // 子代理路由覆盖（Trae/WorkBuddy 会话的子代理强制改道网关）
   // -------------------------------------------------------------------------
@@ -244,19 +263,9 @@ export function apply(ctx, config = {}) {
      * 链的顺序与超时可在 UI 单独配置，与 root 链完全独立。
      *
      * 返回链头名（<at>-<pid>-primary），由网关按 fallbacks 执行后续降级。
+     * 注意：这里与 UI 的 chainHeadFor 用同一套逻辑，保证「显示的就是实际跑的」。
      */
-    modelFor: (agentType, parentSessionId) => {
-      try {
-        const profileId = parentSessionId ? getSessionProfile(ctx, parentSessionId) : '';
-        const routes = store.get().routes;
-        const pid = routes[profileId] ? profileId : Object.keys(routes)[0];
-        const cfg = routes?.[pid]?.agents?.[agentType];
-        if (cfg?.primary) return `${agentType}-${pid}-primary`;
-      } catch {
-        /* 读配置失败退回默认链头 */
-      }
-      return `${agentType}-${DEFAULT_PROFILE_ID}-primary`;
-    },
+    modelFor: (agentType, parentSessionId) => chainHeadFor(agentType, parentSessionId),
     debug: (m) => ctx.logger?.debug?.(m),
   });
   ctx.effect?.(() => () => routing.dispose());
@@ -606,7 +615,21 @@ export function apply(ctx, config = {}) {
       }
 
       // ---- 子代理路由覆盖状态 ----
-      case 'routing/status':
+      case 'routing/status': {
+        // 把「已观测到的会话」一并返回，方便 UI 显示真实 sessionId
+        // 并让用户确认「我这条会话到底走哪条链」。
+        const known = [];
+        for (const [sid, provider] of sessionProviders.entries()) {
+          known.push({
+            sessionId: sid,
+            provider,
+            profile: getSessionProfile(ctx, sid) || '',
+            // 该会话实际会用的链头（子代理被改道时用）
+            chainHeads: Object.fromEntries(
+              AGENT_TYPES.map((at) => [at, chainHeadFor(at, sid)]),
+            ),
+          });
+        }
         return {
           ok: true,
           data: {
@@ -614,8 +637,12 @@ export function apply(ctx, config = {}) {
             gatewayProvider: routing.gatewayProvider || GATEWAY_PROVIDER,
             stats: routing.stats(),
             sessionProvider: args.sessionId ? getSessionProvider(String(args.sessionId)) || null : null,
+            sessionProfile: args.sessionId ? getSessionProfile(ctx, String(args.sessionId)) || '' : '',
+            knownSessions: known,
+            defaultProfile: Object.keys(store.get().routes)[0] || DEFAULT_PROFILE_ID,
           },
         };
+      }
 
       default:
         return { ok: false, error: `未知操作: ${action}` };

package/dsh-plugin-litellm-bridge/lib/model-pool.js

@@ -163,6 +163,51 @@ export async function collectModelPool(ctx, { signal } = {}) {
         if (!providers.some((p) => p.id === c.id)) providers.push(c);
       }
 
+      // ---------------------------------------------------------------
+      // 【关键补齐】用户自定义 provider 的 baseURL / 凭证
+      //
+      // llm.listConfigurableProviders() 只对**内置目录** provider 返回
+      // defaultBaseURL / nativeAuth（settingsNs = 'llm-pi-ai'）。
+      // 用户在【设置-模型】里自己加的（agnes / agnes-backup / amd ...）
+      // 返回的是 baseUrl: null、authEnv: []、settingsNs: null。
+      //
+      // 而这些信息真实存在于 profile 的 cordis.patch.yml，所以这里
+      // 直接读该文件补齐。不补齐的话，下发网关时会报
+      // 「供应商 X 缺少 API 地址（baseURL）」—— 用户明确反馈过这条。
+      // ---------------------------------------------------------------
+      try {
+        const { loadPatchProviders } = await import('./patch-providers.js');
+        const patchMap = await loadPatchProviders();
+        if (patchMap.size) {
+          for (const p of providers) {
+            const hit = patchMap.get(p.id);
+            if (!hit) continue;
+            if (!p.baseUrl && hit.baseURL) p.baseUrl = hit.baseURL;
+            if ((!p.authEnv || !p.authEnv.length) && hit.apiKeyEnv) p.authEnv = [hit.apiKeyEnv];
+            if (!p.displayName && hit.displayName) p.displayName = hit.displayName;
+            p.baseUrlSource = p.baseUrl ? (hit.baseURL === p.baseUrl ? 'patch' : 'configurable') : 'missing';
+          }
+          // patch 里有、但 llm 服务完全没列出来的 provider 也补上
+          for (const [id, hit] of patchMap) {
+            if (providers.some((p) => p.id === id)) continue;
+            if (!hit.baseURL) continue;
+            providers.push({
+              id,
+              name: hit.displayName || id,
+              kind: null,
+              configured: true,
+              baseUrl: hit.baseURL,
+              baseUrlEnv: [],
+              authEnv: hit.apiKeyEnv ? [hit.apiKeyEnv] : [],
+              settingsNs: null,
+              baseUrlSource: 'patch',
+            });
+          }
+        }
+      } catch {
+        /* 读 patch 失败不影响主流程：只是少一层 baseURL 兜底 */
+      }
+
       if (providers.length && typeof llm.listModels === 'function') {
         for (const p of providers) {
           if (signal?.aborted) break;

package/dsh-plugin-litellm-bridge/lib/patch-providers.js

@@ -0,0 +1,184 @@
+/**
+ * 从 DSH profile 的 cordis.patch.yml 读取用户自定义 provider 配置
+ * ============================================================================
+ *
+ * 【为什么必须读这个文件】
+ * DSH 的 `llm.listConfigurableProviders()` 只对**内置目录 provider**
+ *（anthropic / deepseek / ant-ling 等，settingsNs = 'llm-pi-ai'）返回
+ * defaultBaseURL 与 nativeAuth。
+ *
+ * 用户自己在【设置-模型】里加的 provider（agnes / agnes-backup / amd /
+ * siliconflow ...）在 llm 服务里只有 { id, name }，**baseUrl 与 apiKeyEnv
+ * 全是空的**（settingsNs = null）。
+ *
+ * 实测证据：
+ *   {"id":"agnes","name":"Agnes 3.0 Flash","baseUrl":null,"authEnv":[],
+ *    "settingsNs":null}                       ← 用户自定义，拿不到
+ *   {"id":"ant-ling","baseUrl":"https://api.ant-ling.com/v1",
+ *    "authEnv":["ANT_LING_API_KEY"],"settingsNs":"llm-pi-ai"}  ← 内置，有
+ *
+ * 而这些信息**确实存在于** profile 的 cordis.patch.yml：
+ *     - id: llm-pi-ai
+ *       config:
+ *         providers:
+ *           agnes:
+ *             baseURL: https://apihub.agnes-ai.com/v1
+ *             apiKeyEnv: AGNES_API_KEY
+ *             models: [...]
+ *
+ * 所以本模块直接解析该 YAML 的 providers 段，补齐 llm 服务缺失的部分。
+ *
+ * 【设计约束】
+ *   - **只读**：绝不写这个文件（那是用户的 profile 配置，写坏了 DSH 起不来）
+ *   - 解析失败必须 fail-soft：返回空表，让上层走原有降级路径
+ *   - 不引入 YAML 依赖：只解析我们需要的固定结构（缩进稳定）
+ */
+
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** 定位 profile 的 cordis.patch.yml。 */
+export function profilePatchPath() {
+  const home = process.env.DSH_HOME || process.env.DSH_PROFILE_DIR || '';
+  const candidates = [];
+
+  if (process.env.DSH_PROFILE_DIR) {
+    candidates.push(join(process.env.DSH_PROFILE_DIR, 'cordis.patch.yml'));
+  }
+  if (home) {
+    // DSH_HOME 可能是 .dsh 根，也可能是 profile 目录
+    candidates.push(join(home, 'cordis.patch.yml'));
+    candidates.push(join(home, 'profiles', 'desktop', 'cordis.patch.yml'));
+  }
+  // 兜底：从 node_modules 位置反推 profile 目录
+  // <profile>/node_modules/dsh-plugin-litellm-bridge/lib/... → <profile>
+  try {
+    const here = new URL('.', import.meta.url).pathname;
+    const idx = here.replace(/\\/g, '/').indexOf('/node_modules/');
+    if (idx > 0) {
+      const profileRoot = here.slice(0, idx);
+      candidates.push(join(profileRoot, 'cordis.patch.yml'));
+    }
+  } catch { /* ignore */ }
+
+  for (const c of candidates) {
+    try {
+      if (c && existsSync(c)) return c;
+    } catch { /* ignore */ }
+  }
+  return null;
+}
+
+/**
+ * 解析 YAML 里的 providers 段。
+ *
+ * 只认这个固定结构（DSH 自己生成的，缩进稳定）：
+ *
+ *     providers:
+ *       <providerId>:
+ *         baseURL: https://...
+ *         apiKeyEnv: SOME_API_KEY
+ *         displayName: 显示名
+ *         models:
+ *           - id: model-id
+ *             name: 显示名
+ *
+ * 返回 Map<providerId, { baseURL, apiKeyEnv, displayName, models }>
+ */
+export function parseProvidersFromPatch(text) {
+  const out = new Map();
+  if (typeof text !== 'string' || !text) return out;
+
+  const lines = text.split('\n');
+  /** 当前所在的 providers: 块的缩进 */
+  let providersIndent = -1;
+  let cur = null;
+  /** 当前 provider 的字段缩进（provider 行的缩进 + 2） */
+  let fieldIndent = -1;
+
+  for (let i = 0; i < lines.length; i++) {
+    const raw = lines[i];
+    const line = raw.replace(/\r$/, '');
+    if (!line.trim() || line.trim().startsWith('#')) continue;
+
+    const indent = line.match(/^\s*/)[0].length;
+
+    // 进入/离开 providers: 块
+    if (/^\s*providers:\s*$/.test(line)) {
+      providersIndent = indent;
+      cur = null;
+      fieldIndent = -1;
+      continue;
+    }
+    if (providersIndent >= 0 && indent <= providersIndent) {
+      // 回到同级或更外层，说明 providers 块结束
+      providersIndent = -1;
+      cur = null;
+      fieldIndent = -1;
+    }
+    if (providersIndent < 0) continue;
+
+    // provider 定义行：比 providers 深一层，且以 `key:` 结尾
+    const mProvider = line.match(/^(\s+)([A-Za-z0-9._-]+):\s*$/);
+    if (mProvider && indent === providersIndent + 2) {
+      cur = {
+        id: mProvider[2],
+        baseURL: null,
+        apiKeyEnv: null,
+        displayName: null,
+        models: [],
+        settingsNs: null,
+      };
+      fieldIndent = indent + 2;
+      out.set(cur.id, cur);
+      continue;
+    }
+    if (!cur) continue;
+
+    // 【关键】只解析 provider **直属层级**的标量字段。
+    // 之前漏了这个判断，导致 models 列表项里的 `name:` 行
+    // （缩进更深）把 provider 的 displayName 覆盖成了模型名。
+    // 实测：agnes.displayName 被写成 "agnes-image-2.5-flash"。
+    if (indent === fieldIndent) {
+      const mScalar = line.match(/^\s+([A-Za-z_][\w]*):\s*(.+?)\s*$/);
+      if (mScalar) {
+        const key = mScalar[1];
+        let val = mScalar[2];
+        val = val.replace(/\s+#.*$/, '').trim();
+        val = val.replace(/^['"]|['"]$/g, '');
+        if (key === 'baseURL' || key === 'baseUrl' || key === 'api_base') cur.baseURL = val;
+        else if (key === 'apiKeyEnv' || key === 'api_key_env') cur.apiKeyEnv = val;
+        else if (key === 'displayName') cur.displayName = val;
+        else if (key === 'settingsNs') cur.settingsNs = val;
+        continue;
+      }
+    }
+
+    // models 列表项：`- id: xxx`（缩进比字段更深）
+    if (indent > fieldIndent) {
+      const mModelId = line.match(/^\s+-\s+id:\s*(.+?)\s*$/);
+      if (mModelId) {
+        const id = mModelId[1].replace(/\s+#.*$/, '').trim().replace(/^['"]|['"]$/g, '');
+        if (id) cur.models.push({ id, name: id });
+      }
+    }
+  }
+
+  return out;
+}
+
+/**
+ * 读取并解析 profile 的 providers 配置。
+ * @returns {Promise<Map<string, object>>} 失败返回空 Map（fail-soft）
+ */
+export async function loadPatchProviders() {
+  const path = profilePatchPath();
+  if (!path) return new Map();
+  try {
+    const text = await readFile(path, 'utf8');
+    return parseProvidersFromPatch(text);
+  } catch {
+    return new Map();
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-litellm-bridge",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "LiteLLM gateway bridge for DSH: assemble root / coder / research fallback chains from the DSH model pool and hand the order to a LiteLLM gateway that executes retries and fallbacks. The plugin performs no routing itself.",
   "keywords": [
     "dsh",