dsh-plugin-litellm-bridge 2.1.1 → 2.1.3

package/README.md

@@ -1,4 +1,4 @@
-# dsh-fallback-auto-pool-arch
+# dsh-plugin-litellm-bridge
 
 DSH + LiteLLM 网关桥接方案。
 
@@ -76,7 +76,7 @@ DSH + LiteLLM 网关桥接方案。
 `dsh-plugin-litellm-bridge/` 里的实现），所以可以直接按 git 装：
 
 ```
-git+https://github.com/heixiua/dsh-fallback-auto-pool-arch.git#<commit-sha>
+git+https://github.com/heixiua/dsh-plugin-litellm-bridge.git#<commit-sha>
 ```
 
 在插件市场里粘贴这个地址即可。**建议带上 commit sha**（而不是 `#main`），
@@ -87,7 +87,7 @@ git+https://github.com/heixiua/dsh-fallback-auto-pool-arch.git#<commit-sha>
 ```bash
 # 完全退出 DSH（全部 6 个 DeepSeek Harness.exe 进程）后
 cd "D:\AI agent cache\dsh\profiles\desktop"
-pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-fallback-auto-pool-arch"
+pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-plugin-litellm-bridge"
 ```
 
 > ⚠ 装完立刻检查 `pnpm-workspace.yaml` 的 `allowBuilds` 里有没有
@@ -97,7 +97,7 @@ pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-fallback-auto-pool-arch"
 ### 方式 C：从子目录装（旧方式，仍支持）
 
 ```bash
-pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-fallback-auto-pool-arch/dsh-plugin-litellm-bridge"
+pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-plugin-litellm-bridge/dsh-plugin-litellm-bridge"
 ```
 
 子目录里保留了完整、可独立安装的 `package.json`，与根目录指向同一份实现

package/docs/README.md

@@ -1,4 +1,4 @@
-# dsh-fallback-auto-pool-arch
+# dsh-plugin-litellm-bridge
 
 DSH 插件 **litellm-bridge**：一个 LiteLLM 网关桥接面板。
 
@@ -94,7 +94,7 @@ DSH 插件 **litellm-bridge**：一个 LiteLLM 网关桥接面板。
 ## 3. 仓库结构
 
 ```
-dsh-fallback-auto-pool-arch/
+dsh-plugin-litellm-bridge/
 ├── dsh-plugin-litellm-bridge/          # ① DSH 桥接插件本体
 │   ├── package.json                    #    dsh.bundle.patch + dsh.client 声明
 │   ├── cordis.patch.yml                #    挂进 profile 组合树的补丁
@@ -273,7 +273,7 @@ Copy-Item "$p\cordis.patch.yml" "$p\cordis.patch.yml.bak" -Force
 
 # 3) 以 file: 依赖安装（路径必须绝对）
 Set-Location $p
-pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-fallback-auto-pool-arch/dsh-plugin-litellm-bridge"
+pnpm add "file:D:/AI sandbox/dsh-sandbox/dsh-plugin-litellm-bridge/dsh-plugin-litellm-bridge"
 
 # 4) 确认包体完整（文件数 > 0，且 package.json 存在）
 Get-ChildItem "$p\node_modules\dsh-plugin-litellm-bridge" -Recurse | Measure-Object
@@ -622,14 +622,14 @@ python litellm-gateway/test-probe.py --model root-primary
 
 ## 9. 推送到 GitHub
 
-仓库地址：<https://github.com/heixiua/dsh-fallback-auto-pool-arch>
+仓库地址：<https://github.com/heixiua/dsh-plugin-litellm-bridge>
 
 ```bash
-cd dsh-fallback-auto-pool-arch
+cd dsh-plugin-litellm-bridge
 
 git init
 git branch -M main
-git remote add origin https://github.com/heixiua/dsh-fallback-auto-pool-arch.git
+git remote add origin https://github.com/heixiua/dsh-plugin-litellm-bridge.git
 
 # 提交前务必确认没有密钥混进来
 git status --short

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,241 +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
-      //
-      // 【重要】settings.section 是 **root scope**（全局设置页），它不属于
-      // 任何一个会话，所以这里**拿不到真实 sessionId**。
-      // 之前静默用 'current' 兜底，导致用户以为绑定成功了，
-      // 实际写进了一个名为 current 的假会话，真实会话读不到 —— 这是错的。
-      //
-      // 现在的策略：
-      //   1) 仍尝试从 ctx / URL 拿（某些宿主版本可能给）
-      //   2) 拿不到就标记 isFallback=true，UI 明确提示「去会话标题旁选」
-      //   3) 不再假装成功
-      const sessionInfo = useMemo(() => {
-        try {
-          const fromCtx = ctx?.session?.id || ctx?.sessionId;
-          if (fromCtx) return { id: String(fromCtx), isFallback: false };
-          const loc = globalThis.location;
-          const hay = String(loc?.hash || '') + String(loc?.search || '');
-          const m = hay.match(/session[=/]([A-Za-z0-9-]{8,})/i);
-          if (m) return { id: m[1], isFallback: false };
-        } catch { /* 落到 fallback */ }
-        return { id: 'current', isFallback: true };
-      }, []);
-      const sessionId = sessionInfo.id;
-      const sessionIdIsFallback = sessionInfo.isFallback;
-
-      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,
-        // 【关键提示】拿不到真实 sessionId 时，必须明确告诉用户去哪操作，
-        // 而不是让人以为在这里选完就生效了。
-        sessionIdIsFallback && h('div', { style: S.notice('warn') },
-          h('div', { style: { fontWeight: 600, marginBottom: 4 } },
-            '设置页绑定不到「某一个会话」'),
-          h('div', null,
-            '这里是全局设置页，不属于任何具体会话，所以无法确定"当前会话"是哪一个。'),
-          h('div', { style: { marginTop: 6, fontWeight: 600 } },
-            '→ 请用会话标题旁的那个小按钮来切换本会话的降级链。'),
-          h('div', { style: { marginTop: 4, opacity: 0.8 } },
-            '（在主界面对话标题右边，显示当前 profile 名，点开即可选）'),
-        ),
-
-        h('div', { style: S.card },
-          h('div', { style: S.fieldRow },
-            h('div', { style: { flex: '1 1 220px' } },
-              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: { flex: '0 0 160px' } },
-              h('label', { style: S.label }, '会话标识'),
-              h('div', {
-                style: {
-                  ...S.input, display: 'flex', alignItems: 'center', gap: 6,
-                  ...S.mono, fontSize: 11,
-                  color: sessionIdIsFallback ? T.warn : T.labelPrimary,
-                },
-              },
-                sessionIdIsFallback
-                  ? h('span', null, '（设置页无会话上下文）')
-                  : h('span', { style: { wordBreak: 'break-all' } }, String(sessionId).slice(0, 20)),
-              ),
-            ),
-          ),
-          h('div', { style: S.hint },
-            '绑定后：本会话的 root 请求按该 profile 的 root 链走；' +
-            'spawn 的子 Agent 按同 profile 的 coder/research 链走。'),
-          h('div', { style: { ...S.row, marginTop: 10 } },
-            h('button', {
-              style: S.btn('primary'), onClick: save,
-              disabled: busy || sessionIdIsFallback,
-            }, sessionIdIsFallback ? '请用会话标题旁的按钮' : '保存到会话变量'),
-            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 },
-          }, safeText(saved.text)),
-          probe && h('div', {
-            style: { marginTop: 9, fontSize: 12, color: probe.kind === 'ok' ? T.success : T.error },
-          }, safeText(probe.text)),
-        ),
-
-        // 【新增】这条会话实际会用哪条链 —— 让「有没有生效」可见、可验证
-        rt && h('div', { style: S.card },
-          h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '这条会话实际走哪条链'),
-          (() => {
-            const effProfile = rt.sessionProfile || rt.defaultProfile || '(默认)';
-            const heads = rt.chainHeads || {};
-            return h('div', null,
-              h('div', { style: { ...S.row, marginBottom: 8 } },
-                h('span', { style: S.badge(T.brand, tint(T.brand, 14)) },
-                  `profile: ${safeText(effProfile)}`),
-                !rt.sessionProfile && h('span', { style: S.badge(T.warn, tint(T.warn, 14)) },
-                  '未绑定，用默认 profile'),
-              ),
-              h('div', {
-                style: {
-                  ...S.mono, fontSize: 11.5, lineHeight: 1.9,
-                  background: T.bgLayer1, border: `1px solid ${T.borderL1}`,
-                  borderRadius: 6, padding: '8px 10px',
-                },
-              },
-                h('div', null, `root      → ${safeText(heads.root, '—')}`),
-                h('div', null, `coder     → ${safeText(heads.coder, '—')}`),
-                h('div', null, `research  → ${safeText(heads.research, '—')}`),
-              ),
-              h('div', { style: { ...S.hint, marginTop: 6 } },
-                '子 Agent 被改道到网关时，请求的 model 就是上面 coder / research 对应的链头；' +
-                '网关再按该链配置的 fallback 顺序重试。'),
-            );
-          })(),
-        ),
-
-        // 已知会话列表（用于确认绑定是否真的写到了正确会话）
-        rt && Array.isArray(rt.knownSessions) && rt.knownSessions.length > 0 &&
-          h('div', { style: S.card },
-            h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '已观测到的会话'),
-            h('div', { style: { ...S.hint, marginBottom: 8 } },
-              '这些会话实际发出过模型请求，插件据此记录了它们的供应商与绑定。'),
-            rt.knownSessions.slice(0, 10).map((s, i) => h('div', {
-              key: i,
-              style: {
-                ...S.mono, fontSize: 11, padding: '5px 8px', marginBottom: 3,
-                borderRadius: 4, background: T.bgLayer1, border: `1px solid ${T.borderL1}`,
-                wordBreak: 'break-all',
-              },
-            },
-              h('span', { style: { opacity: 0.6 } }, `${String(s.sessionId).slice(0, 24)} `),
-              h('span', { style: S.badge() }, safeText(s.provider, '?')),
-              s.profile && h('span', { style: S.badge(T.brand, tint(T.brand, 12)) }, safeText(s.profile)),
-            )),
-          ),
-
-        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() }, `当前供应商: ${safeText(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);
@@ -1416,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），
     //   注册即替换掉官方选择器，得不偿失。
@@ -1584,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);
 
@@ -1596,7 +1362,6 @@ window.__ModuleLoader__.load({
         ['gateway', '网关设置'],
         ['routes', '路由配置'],
         ['logs', '日志面板'],
-        ['session', '当前会话'],
       ];
 
       return h('div', { style: S.page },
@@ -1611,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 })),
         ),
       );
     }
@@ -1655,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 注册每个资源并返回清理函数。
@@ -1680,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/gateway-supervisor.js

@@ -25,6 +25,7 @@ import { createConnection } from 'node:net';
 import { existsSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { tmpdir } from 'node:os';
 
 /** 默认网关地址。 */
 export const DEFAULT_GATEWAY_URL = 'http://127.0.0.1:4000';
@@ -157,14 +158,14 @@ export function findGatewayDir(explicitDir) {
     for (let i = 0; i < 6; i++) {
       cur = resolve(cur, '..');
       push(join(cur, 'litellm-gateway'));
-      push(join(cur, 'dsh-fallback-auto-pool-arch', 'litellm-gateway'));
+      push(join(cur, 'dsh-plugin-litellm-bridge', 'litellm-gateway'));
     }
   } catch {
     /* ignore */
   }
 
   // 4) 常见绝对路径兜底
-  push('D:/AI sandbox/dsh-sandbox/dsh-fallback-auto-pool-arch/litellm-gateway');
+  push('D:/AI sandbox/dsh-sandbox/dsh-plugin-litellm-bridge/litellm-gateway');
 
   for (const c of candidates) {
     try {
@@ -267,7 +268,13 @@ export class GatewaySupervisor {
           '--port', String(port),
         ],
         {
-          cwd: dir,
+          // 【关键】cwd 绝不能是网关目录 / 工作区目录。
+          //   旧版本传 cwd: dir，配合 start-gateway.sh 里的 `cd "$SCRIPT_DIR"`，
+          //   会让网关进程把 CWD 钉在工作区里；Windows 随即拒绝对整个工作区目录树
+          //   做 rename/move（EPERM），用户改文件夹名时看到「被占用」。
+          //   脚本内所有路径都是 $SCRIPT_DIR 绝对形式，不需要任何特定 CWD；
+          //   用系统临时目录既安全又不会锁住工作区。
+          cwd: tmpdir(),
           env: {
             ...process.env,
             ...(this.envFile ? { LITELLM_BRIDGE_ENV: this.envFile } : {}),

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,222 @@
+/**
+ * 从 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';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * 定位 profile 的 cordis.patch.yml。
+ *
+ * 【曾经的致命 bug · 2026-11-10 修复】
+ *   旧代码用 `new URL('.', import.meta.url).pathname` 反推模块目录。这在 Windows 上
+ *   返回的是 **URL 形态**的路径，而不是文件系统路径：
+ *
+ *       new URL('.', import.meta.url).pathname
+ *         → "/D:/AI%20agent%20cache/dsh/profiles/desktop/node_modules/.../lib/"
+ *                     ^^^^ 前导斜杠          ^^^^ 空格被百分号编码
+ *
+ *   existsSync("/D:/AI%20agent...") 恒为 false（msys 风格盘符 + %20 都不合法），
+ *   于是本函数在 **DSH 宿主进程里永远返回 null**，patchMap 恒空，baseURL 一条都补不上，
+ *   用户持续看到「供应商 agnes 缺少 API 地址」。
+ *
+ *   为什么我早期的自测没发现：当时是用 shell 里带着 `DSH_PROFILE_DIR` 环境变量跑的，
+ *   命中了第 1 个候选分支就提前 return，兜底分支的 bug 被掩盖。
+ *
+ *   修法：一律走 `fileURLToPath()`（它负责 decodeURIComponent + 盘符规范化），
+ *   并把「用户主目录下的 .dsh」作为独立候选 —— 不依赖任何可选环境变量。
+ */
+export function profilePatchPath() {
+  const candidates = [];
+
+  // 1) 显式 profile 目录（部分宿主版本会注入）
+  const profileDir = process.env.DSH_PROFILE_DIR;
+  if (profileDir) candidates.push(join(profileDir, 'cordis.patch.yml'));
+
+  // 2) DSH_HOME —— 可能是 .dsh 根，也可能直接是 profile 目录
+  const home = process.env.DSH_HOME;
+  if (home) {
+    candidates.push(join(home, 'cordis.patch.yml'));
+    candidates.push(join(home, 'profiles', 'desktop', 'cordis.patch.yml'));
+    const profileName = process.env.DSH_PROFILE;
+    if (profileName) candidates.push(join(home, 'profiles', profileName, 'cordis.patch.yml'));
+  }
+
+  // 3) 从本模块位置反推：<profile>/node_modules/<pkg>/<pkg>/lib/patch-providers.js
+  //    必须用 fileURLToPath —— 见上方 bug 说明。
+  try {
+    const here = fileURLToPath(new URL('.', import.meta.url)).replace(/\\/g, '/');
+    let idx = here.indexOf('/node_modules/');
+    while (idx > 0) {
+      const root = here.slice(0, idx);
+      candidates.push(join(root, 'cordis.patch.yml'));
+      candidates.push(join(root, 'profiles', 'desktop', 'cordis.patch.yml'));
+      idx = here.indexOf('/node_modules/', idx + 1);
+    }
+  } catch { /* ignore */ }
+
+  // 4) 用户主目录兜底：只依赖 homedir()，不依赖任何可选环境变量
+  try {
+    const h = homedir();
+    candidates.push(join(h, '.dsh', 'profiles', 'desktop', 'cordis.patch.yml'));
+    const profileName = process.env.DSH_PROFILE;
+    if (profileName) {
+      candidates.push(join(h, '.dsh', 'profiles', profileName, '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/dsh-plugin-litellm-bridge/manifest.json

@@ -53,5 +53,5 @@
     }
   ],
   "license": "MIT",
-  "repository": "https://github.com/heixiua/dsh-fallback-auto-pool-arch"
+  "repository": "https://github.com/heixiua/dsh-plugin-litellm-bridge"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-litellm-bridge",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "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",
@@ -16,12 +16,12 @@
   "author": "heixiua",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/heixiua/dsh-fallback-auto-pool-arch.git"
+    "url": "git+https://github.com/heixiua/dsh-plugin-litellm-bridge.git"
   },
   "bugs": {
-    "url": "https://github.com/heixiua/dsh-fallback-auto-pool-arch/issues"
+    "url": "https://github.com/heixiua/dsh-plugin-litellm-bridge/issues"
   },
-  "homepage": "https://github.com/heixiua/dsh-fallback-auto-pool-arch#readme",
+  "homepage": "https://github.com/heixiua/dsh-plugin-litellm-bridge#readme",
   "main": "./dsh-plugin-litellm-bridge/lib/index.js",
   "icon": "./dsh-plugin-litellm-bridge/icon.svg",
   "exports": {