dsh-plugin-litellm-bridge 2.0.8 → 2.1.0

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

@@ -637,24 +637,24 @@ window.__ModuleLoader__.load({
           return next;
         });
 
-      // ---- 拖拽排序：fallback 列表顺序即降级优先级 ----
+      // ---- 拖拽排序：整条链（首选 + 备选）的先后顺序即降级优先级 ----
       const onDragStart = (at, idx) => { dragRef.current = { at, idx }; };
-      const onDrop = (at, idx) => {
+      /**
+       * 拖拽落点：把 src 位置的模型插到 target 位置。
+       * 操作对象是**整条链**（primary 是第 0 位），
+       * 所以拖到第 1 位就等于「换首选」，不需要额外按钮。
+       */
+      const onDropChain = (at, idx) => {
         const src = dragRef.current;
+        dragRef.current = null;
         if (!src || src.at !== at || src.idx === idx) return;
-        const list = [...prof.agents[at].fallbacks];
+        const cfg = prof?.agents?.[at];
+        if (!cfg) return;
+        const list = [cfg.primary, ...(cfg.fallbacks || [])].filter(Boolean);
+        if (src.idx < 0 || src.idx >= list.length) return;
         const [moved] = list.splice(src.idx, 1);
         list.splice(idx, 0, moved);
-        setAgent(at, { fallbacks: list });
-        dragRef.current = null;
-      };
-
-      /** 把某个模型从「备选」提升为「首选」，原首选下沉为第一备选。 */
-      const promote = (at, idx) => {
-        const cfg = prof.agents[at];
-        const target = cfg.fallbacks[idx];
-        const rest = cfg.fallbacks.filter((_, i) => i !== idx);
-        setAgent(at, { primary: target, fallbacks: cfg.primary ? [cfg.primary, ...rest] : rest });
+        setAgent(at, { primary: list[0] || '', fallbacks: list.slice(1) });
       };
 
       const saveSection = async (at) => {
@@ -725,7 +725,51 @@ window.__ModuleLoader__.load({
 
       const allIds = (pool.models || []).map((x) => x.id);
 
+      // ---------------------------------------------------------------------
+      // 【关键】链成员的唯一标识必须是「供应商 + 模型」，不能只用模型名。
+      //
+      // 实测模型池里有大量同名模型分布在不同供应商/账号：
+      //   agnes-3.0-flash      → agnes / agnes-backup / llm-pi-ai  （3 个不同账号）
+      //   DeepSeek-V4.1-Flash  → amd / trae / workbuddy           （3 个不同渠道）
+      //   GLM-5.3-Flash        → amd / trae
+      //
+      // 这些是**不同凭证、不同配额**的独立路由，恰恰是降级最该利用的
+      //（1 号账号限流就换 2 号账号的同一个模型）。
+      // 若按模型名去重，选了 agnes 的 agnes-3.0-flash 后就再也选不到
+      // agnes-backup 的同名模型 —— 把最核心的备份场景堵死了。
+      //
+      // 所以链里存 "供应商::模型" 复合键；写进网关配置时再拆开。
+      // ---------------------------------------------------------------------
+      const keyOf = (provider, id) => `${provider}::${id}`;
+      const parseKey = (k) => {
+        const i = String(k).indexOf('::');
+        return i < 0 ? { provider: '', id: String(k) } : {
+          provider: String(k).slice(0, i),
+          id: String(k).slice(i + 2),
+        };
+      };
+      /** 把池里的 (provider,id) 转成展示用文字 */
+      const labelOf = (provider, id) => (provider ? `${provider} / ${id}` : id);
+
       return h('div', null,
+        // ---- 使用引导：第一次进来的人 3 秒看懂这页在做什么 ----
+        h('div', {
+          style: {
+            padding: '10px 12px', marginBottom: 18, borderRadius: 6,
+            background: tint(T.brand, 6), border: `1px solid ${tint(T.brand, 25)}`,
+            fontSize: 12, lineHeight: 1.7, color: T.labelPrimary,
+          },
+        },
+          h('div', { style: { fontWeight: 600, marginBottom: 4 } }, '这页在做什么'),
+          h('div', null,
+            '给三类 Agent 各配一条「降级链」：先试第 1 个模型，失败就换第 2 个，再失败换第 3 个。',
+          ),
+          h('div', { style: { marginTop: 4 } },
+            '配好后点最下方「保存并下发到网关」，网关就会按这个顺序执行重试。'),
+          h('div', { style: { marginTop: 6, opacity: 0.75 } },
+            '提示：不用每条链都配。只配 root 也能用；coder / research 留空表示沿用 DSH 原来的行为。'),
+        ),
+
         // ---- Profile 分组：选择 / 新建 / 删除 ----
         h('div', { style: S.h2Row },
           h('h2', { style: S.h2 }, 'Profile 分组'),
@@ -747,6 +791,9 @@ window.__ModuleLoader__.load({
             }, '删除当前'),
           ),
         ),
+        h('div', { style: { ...S.hint, marginTop: -6, marginBottom: 14 } },
+          '一个 profile = 一套降级方案。可以配多套（例如「稳定优先」「省钱优先」），' +
+          '再到「当前会话」里选用哪一套。'),
 
         showNew && h('div', { style: { ...S.row, marginBottom: 14 } },
           h('input', {
@@ -774,18 +821,113 @@ window.__ModuleLoader__.load({
           // 直接读 cfg.primary 会抛 TypeError，进而让整页崩掉。
           const cfg = prof?.agents?.[at]
             || { label: at, primary: '', timeoutMs: 600000, fallbacks: [] };
+
+          // 链里存的是 "供应商::模型" 复合键；兼容旧数据（纯模型名）
+          const chainKeys = [cfg.primary, ...(cfg.fallbacks || [])]
+            .filter(Boolean)
+            .map((v) => {
+              const s = String(v);
+              if (s.includes('::')) return s;
+              // 旧数据只有模型名：在池里找它的供应商，找不到就留空供应商
+              const hit = (pool.models || []).find((m) => m.id === s);
+              return hit ? keyOf(hit.provider, hit.id) : keyOf('', s);
+            });
+          const chain = chainKeys;
           const isSub = at !== 'root';
-          const groupLabel = at === 'root' ? 'root · 主代理降级链'
-            : at === 'coder' ? 'coder · 子代理降级链（Coder）'
-            : 'research · 子代理降级链（Research）';
-          const chainLen = [cfg.primary, ...(cfg.fallbacks || [])].filter(Boolean).length;
 
-          return h('div', { key: at },
+          // 每个角色的说明：用「人话」讲清楚它管什么
+          const meta = at === 'root'
+            ? {
+                title: 'root · 主代理',
+                desc: '你自己直接对话的那个 Agent。它出问题时按下面的顺序换模型重试。',
+                hint: '通常放最稳、上下文最大的模型。',
+              }
+            : at === 'coder'
+              ? {
+                  title: 'coder · 子代理（写代码）',
+                  desc: 'Agent 里 spawn 出来的「写代码」子任务用它，和 root 完全独立。',
+                  hint: '可放长输出、便宜的模型。',
+                }
+              : {
+                  title: 'research · 子代理（调研）',
+                  desc: 'Agent 里 spawn 出来的「调研/检索/分析」子任务用它。',
+                  hint: '可放推理强或便宜的模型。',
+                };
+
+          /** 修改整条链（统一入口，避免 primary/fallbacks 两个来源打架） */
+          const setChain = (nextList) => {
+            const list = nextList.filter(Boolean);
+            setAgent(at, { primary: list[0] || '', fallbacks: list.slice(1) });
+          };
+          const moveUp = (i) => {
+            if (i <= 0) return;
+            const l = [...chain];
+            [l[i - 1], l[i]] = [l[i], l[i - 1]];
+            setChain(l);
+          };
+          const removeAt = (i) => setChain(chain.filter((_, j) => j !== i));
+          /** 添加一个 (provider, model) —— 复合键去重，同名不同账号可以共存 */
+          const addModel = (provider, id) => {
+            if (!id) return;
+            const k = keyOf(provider, id);
+            if (chain.includes(k)) return;
+            setChain([...chain, k]);
+          };
+
+          /** 一个可拖拽的链节点 */
+          const row = (key, i) => {
+            const { provider, id } = parseKey(key);
+            return h('div', {
+              key: `${at}-${key}-${i}`,
+              draggable: true,
+              onDragStart: () => onDragStart(at, i),
+              onDragOver: (e) => e.preventDefault(),
+              onDrop: () => onDropChain(at, i),
+              style: {
+                display: 'flex', alignItems: 'center', gap: 8, padding: '6px 10px',
+                marginBottom: 4, borderRadius: 6, cursor: 'grab',
+                background: i === 0 ? tint(T.success, 7) : T.bgLayer2,
+                border: `1px solid ${i === 0 ? tint(T.success, 30) : T.borderL1}`,
+              },
+            },
+              h('span', { style: { opacity: 0.4, ...S.mono } }, '⠿'),
+              h('span', {
+                style: {
+                  ...S.mono, fontSize: 11, width: 20, textAlign: 'center',
+                  flex: '0 0 20px', fontWeight: 600,
+                  color: i === 0 ? T.success : T.labelSecondary,
+                },
+              }, String(i + 1)),
+              // 【关键】必须把供应商显式展示出来，
+              // 否则「agnes 的 agnes-3.0-flash」和「agnes-backup 的 agnes-3.0-flash」
+              // 在列表里长得一模一样，用户根本分不清哪个是哪个账号。
+              provider
+                ? h('span', { style: S.badge(T.brand, tint(T.brand, 12)), title: `账号/供应商：${provider}` },
+                    safeText(provider))
+                : h('span', { style: S.badge(T.warn, tint(T.warn, 14)) }, '供应商未知'),
+              h('span', { style: { flex: '1 1 auto', ...S.mono, wordBreak: 'break-all' } }, safeText(id)),
+              i === 0
+                ? h('span', { style: S.badge(T.success, tint(T.success, 16)) }, '先用这个')
+                : h('span', { style: S.badge() }, i === 1 ? '失败后换它' : `${i + 1} 顺位`),
+              i > 0 && h('button', {
+                style: { ...S.btnSm, height: 22, fontSize: 11 },
+                onClick: () => moveUp(i),
+                title: '往前挪一位（往前 = 更优先）',
+              }, '↑'),
+              h('button', {
+                style: { ...S.btnSm, height: 22, fontSize: 11, color: T.error, borderColor: tint(T.error, 35) },
+                onClick: () => removeAt(i),
+              }, '删'),
+            );
+          };
+
+          return h('div', { key: at, style: { marginBottom: 22 } },
+            // 标题行
             h('div', { style: S.h2Row },
-              h('h2', { style: S.h2 }, safeText(groupLabel)),
+              h('h2', { style: S.h2 }, safeText(meta.title)),
               isSub && h('span', { style: S.badge() }, '仅子 Agent 使用'),
               h('span', { style: { ...S.mono, fontSize: 11, color: T.labelSecondary } },
-                chainLen ? `链长 ${chainLen}` : '未配置'),
+                chain.length ? `${chain.length} 个模型` : '还没配'),
               h('div', { style: S.sectionActions },
                 h('button', {
                   style: S.btnSm,
@@ -794,97 +936,100 @@ window.__ModuleLoader__.load({
                     next[pid].agents[at] = JSON.parse(JSON.stringify(state.routes[pid].agents[at]));
                     return next;
                   }),
-                }, 'Discard'),
+                }, '撤销修改'),
                 h('button', {
                   style: { ...S.btn('primary'), height: 26, padding: '0 10px', fontSize: 12 },
                   disabled: busy,
                   onClick: () => saveSection(at),
-                }, 'Save'),
+                }, '保存这条链'),
               ),
             ),
 
-            h('div', { style: S.fieldRow },
-              h('div', { style: { flex: '1 1 260px' } },
-                h('label', { style: S.label }, '首选模型（来自 DSH 模型池）'),
-                h('select', {
-                  style: S.input,
-                  value: cfg.primary || '',
-                  onChange: (e) => setAgent(at, { primary: e.target.value }),
-                },
-                  h('option', { value: '' }, '— 请选择 —'),
-                  byProvider.map(([prov, rows]) => h('optgroup', { key: prov, label: prov },
-                    rows.map((m) => h('option', { key: `${prov}:${m.id}`, value: m.id },
-                      m.name && m.name !== m.id ? `${m.id}  ·  ${m.name}` : m.id)),
-                  )),
+            // 说明（讲清楚这一链管什么）
+            h('div', { style: { ...S.hint, marginTop: -4, marginBottom: 10 } },
+              safeText(meta.desc),
+              h('span', { style: { opacity: 0.7 } }, ` 建议：${safeText(meta.hint)}`)),
+
+            // 完整降级序列（首选 + 备选合在一起看）
+            chain.length === 0
+              ? h('div', {
+                  style: {
+                    padding: '14px 12px', marginBottom: 8, borderRadius: 6,
+                    background: T.bgLayer1, border: `1px dashed ${T.borderL2}`,
+                    fontSize: 12, color: T.labelSecondary, textAlign: 'center',
+                  },
+                }, '还没有选模型。从下面的下拉框加第一个 —— 它就是这个链的首选。')
+              : h('div', { style: { marginBottom: 8 } },
+                  h('div', { style: { ...S.label } }, '降级顺序（从上到下 = 先试这个，不行再试下一个）'),
+                  chain.map((key, i) => row(key, i)),
                 ),
-              ),
-              h('div', { style: { flex: '0 0 150px' } },
-                h('label', { style: S.label }, '超时（毫秒）'),
-                h('input', {
-                  style: S.input, type: 'number', value: cfg.timeoutMs,
-                  onChange: (e) => setAgent(at, { timeoutMs: Number(e.target.value) }),
-                }),
-              ),
-            ),
 
-            // ---- fallback 链：拖拽排序 ----
-            h('div', { style: S.field },
-              h('label', { style: S.label }, 'fallback 降级序列（拖拽排序，顺序即网关执行的降级优先级）'),
-              (cfg.fallbacks || []).length === 0
-                ? h('div', { style: { ...S.mono, fontSize: 11.5, color: T.labelSecondary, padding: '5px 0' } }, '（无备选）')
-                : cfg.fallbacks.map((f, i) => h('div', {
-                    key: `${f}-${i}`, draggable: true,
-                    onDragStart: () => onDragStart(at, i),
-                    onDragOver: (e) => e.preventDefault(),
-                    onDrop: () => onDrop(at, i),
-                    style: {
-                      display: 'flex', alignItems: 'center', gap: 8, padding: '5px 9px',
-                      marginBottom: 3, borderRadius: 5, cursor: 'grab',
-                      background: T.bgLayer2, border: `1px solid ${T.borderL1}`,
-                    },
-                  },
-                    h('span', { style: { opacity: 0.45, ...S.mono } }, '⠿'),
-                    h('span', { style: S.badge() }, `第 ${i + 2} 顺位`),
-                    h('span', { style: { flex: 1, ...S.mono, wordBreak: 'break-all' } }, f),
-                    h('button', { style: S.btnSm, onClick: () => promote(at, i), title: '提升为首选' }, '↑ 首选'),
-                    h('button', {
-                      style: S.btnSm,
-                      onClick: () => setAgent(at, { fallbacks: cfg.fallbacks.filter((_, j) => j !== i) }),
-                    }, '移除'),
-                  )),
-
-              // 追加备选：下拉选 DSH 模型池里的模型
-              h('div', { style: { ...S.row, marginTop: 7 } },
-                h('select', {
-                  style: { ...S.inputAuto, flex: '1 1 260px' },
-                  value: '',
-                  onChange: (e) => {
-                    const v = e.target.value;
-                    if (!v) return;
-                    const cur = cfg.fallbacks || [];
-                    if (v === cfg.primary || cur.includes(v)) return;
-                    setAgent(at, { fallbacks: [...cur, v] });
-                    e.target.value = '';
-                  },
+            // 追加模型
+            //
+            // 【去重规则】用 "供应商::模型" 复合键，**不是** 模型名。
+            // 这样 agnes 与 agnes-backup 的同名模型可以同时出现在链里 ——
+            // 它们本来就是两个账号、两份配额，互为备份正是降级的意义。
+            h('div', { style: { ...S.row, marginBottom: 10 } },
+              h('select', {
+                style: { ...S.inputAuto, flex: '1 1 300px' },
+                value: '',
+                onChange: (e) => {
+                  const raw = e.target.value;
+                  e.target.value = '';
+                  if (!raw) return;
+                  const { provider, id } = parseKey(raw);
+                  addModel(provider, id);
                 },
-                  h('option', { value: '' }, '+ 添加备选模型（从 DSH 模型池选择）'),
-                  byProvider.map(([prov, rows]) => h('optgroup', { key: prov, label: prov },
-                    rows.filter((m) => m.id !== cfg.primary).map((m) =>
-                      h('option', { key: `${prov}:${m.id}`, value: m.id }, m.id)),
-                  )),
-                ),
+              },
+                h('option', { value: '' },
+                  chain.length ? '+ 再加一个备选模型' : '+ 选择这个链的第一个模型'),
+                byProvider.map(([prov, provRows]) => h('optgroup', { key: prov, label: prov },
+                  provRows
+                    .filter((m) => !chain.includes(keyOf(prov, m.id)))
+                    .map((m) => {
+                      // 同一供应商下有重名时加后缀，避免浏览器无法区分
+                      const dup = provRows.filter((x) => x.id === m.id).length > 1;
+                      return h('option', { key: keyOf(prov, m.id), value: keyOf(prov, m.id) },
+                        dup ? `${m.id}（${prov}）` : m.id);
+                    }),
+                )),
               ),
-              allIds.length === 0 && h('div', { style: { ...S.hint, color: T.warn } },
-                '模型池为空：请先到【设置 → 模型】里配置供应商，并用【获取可用模型】拉取模型目录。'),
             ),
+
+            // 超时（放在最后，因为它多数情况不用改）
+            h('div', { style: { ...S.row } },
+              h('span', { style: { ...S.label, marginBottom: 0 } }, '单次请求超时'),
+              h('input', {
+                style: { ...S.inputAuto, width: 120 },
+                type: 'number',
+                value: cfg.timeoutMs,
+                onChange: (e) => setAgent(at, { timeoutMs: Number(e.target.value) }),
+              }),
+              h('span', { style: { ...S.mono, fontSize: 11, color: T.labelSecondary } }, '毫秒'),
+              h('span', { style: { ...S.mono, fontSize: 11, color: T.labelSecondary } },
+                `（约 ${Math.round((cfg.timeoutMs || 0) / 60000)} 分钟）`),
+            ),
+
+            allIds.length === 0 && h('div', { style: { ...S.hint, color: T.warn } },
+              '模型池为空：请先到【设置 → 模型】里配置供应商，并用【获取可用模型】拉取模型目录。'),
           );
         }),
 
         // ---- 下发区 ----
-        h('div', { style: { ...S.row, marginTop: 16 } },
-          h('button', { style: S.btn('primary'), onClick: applyChains, disabled: busy },
-            busy ? '处理中…' : '保存并下发到网关'),
-          h('button', { style: S.btn(), onClick: preview, disabled: busy }, '预览 YAML'),
+        h('div', {
+          style: {
+            marginTop: 22, paddingTop: 16, borderTop: `1px solid ${T.borderL1}`,
+          },
+        },
+          h('div', { style: { ...S.label } }, '最后一步'),
+          h('div', { style: { ...S.hint, marginBottom: 10 } },
+            '「保存并下发」会把上面三条链写成网关配置并重启网关，让它按这个顺序执行。' +
+            '只保存不下发的话，网关不会生效。'),
+          h('div', { style: { ...S.row } },
+            h('button', { style: S.btn('primary'), onClick: applyChains, disabled: busy },
+              busy ? '处理中…' : '保存并下发到网关'),
+            h('button', { style: S.btn(), onClick: preview, disabled: busy }, '先看看生成的配置'),
+          ),
         ),
 
         msg && h('div', {

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

@@ -61,39 +61,66 @@ export function assembleChainConfig(state, pool = null) {
   }
 
   const warnings = [];
-  /** 真实上游：model id → { name, provider, baseUrl, keyEnv, timeoutSec } */
+  /** 真实上游：复合键 → { name, providerId, baseUrl, keyEnv, timeoutSec } */
   const upstreams = new Map();
   /** 链：{ pid, at, head, chain, timeoutMs } */
   const chains = [];
 
+  /**
+   * 解析链成员标识。
+   *
+   * 【复合键】界面存的是 "供应商::模型"，因为同一个模型名可能挂在多个
+   * 供应商下（实测 agnes-3.0-flash 同时存在于 agnes / agnes-backup / llm-pi-ai；
+   * DeepSeek-V4.1-Flash 同时存在于 amd / trae / workbuddy）。
+   * 它们是不同账号、不同配额，互为备份正是降级的核心用途，
+   * 所以必须区分到「供应商级」而不是「模型名级」。
+   *
+   * 【兼容旧数据】早期版本只存纯模型名，这里回退到按池里第一个匹配解析。
+   */
+  const parseMember = (member) => {
+    const s = String(member || '');
+    const i = s.indexOf('::');
+    if (i >= 0) {
+      return { provider: s.slice(0, i), model: s.slice(i + 2), key: s };
+    }
+    // 旧数据：纯模型名 → 找池里第一个归属供应商
+    const provider = providerOfModel.get(s) || '';
+    return { provider, model: s, key: provider ? `${provider}::${s}` : s };
+  };
+
   // ---- 1. 收集所有链与上游 ------------------------------------------------
   for (const pid of Object.keys(routes)) {
     const agents = routes[pid]?.agents || {};
     for (const at of Object.keys(agents)) {
       const cfg = agents[at];
       if (!cfg?.primary) continue;
-      const chain = [cfg.primary, ...(cfg.fallbacks || [])].filter(Boolean);
-      if (!chain.length) continue;
+      const members = [cfg.primary, ...(cfg.fallbacks || [])].filter(Boolean);
+      if (!members.length) continue;
+
+      const parsed = members.map(parseMember);
 
       chains.push({
         pid,
         at,
         head: `${at}-${pid}-primary`,
-        chain,
+        // 链在配置里用**供应商限定的实名**引用，避免同名串味
+        chain: parsed.map((p) => p.model),
+        members: parsed,
         timeoutMs: cfg.timeoutMs || 600000,
       });
 
-      for (const modelId of chain) {
-        if (upstreams.has(modelId)) continue;
-        const providerId = providerOfModel.get(modelId) || '';
-        const prov = providerMap.get(providerId);
+      for (const member of parsed) {
+        const { provider: providerId, model: modelId, key } = member;
+        if (upstreams.has(key)) continue;
+
         if (!providerId) {
           warnings.push(
-            `模型 ${modelId} 不在 DSH 模型池里（可能已被删除或改了名）。` +
+            `模型 ${modelId} 找不到归属供应商（可能不在 DSH 模型池里）。` +
             '请到【设置-模型】确认，或在「路由配置」里重新选择。',
           );
           continue;
         }
+        const prov = providerMap.get(providerId);
         if (!prov?.baseUrl) {
           warnings.push(
             `供应商 ${providerId} 缺少 API 地址（baseURL），模型 ${modelId} 无法下发。` +
@@ -101,7 +128,9 @@ export function assembleChainConfig(state, pool = null) {
           );
           continue;
         }
-        upstreams.set(modelId, {
+
+        upstreams.set(key, {
+          key,
           name: modelId,
           providerId,
           prefix: protocolPrefix(prov),
@@ -117,6 +146,31 @@ export function assembleChainConfig(state, pool = null) {
   const lines = [];
   const push = (s = '') => lines.push(s);
 
+  /**
+   * 给每个上游分配一个**在 model_list 内唯一**的 model_name。
+   *
+   * 【为什么需要改】同名模型可能来自不同供应商账号：
+   *   agnes::agnes-3.0-flash         （账号 1）
+   *   agnes-backup::agnes-3.0-flash  （账号 2）
+   *   llm-pi-ai::agnes-3.0-flash     （平台通道）
+   * LiteLLM 的 model_list 按 model_name 索引，两个同名条目会互相覆盖，
+   * 导致降级时永远只能命中其中一个 —— 备份账号形同虚设。
+   *
+   * 规则：模型名在全表唯一时保持原样（可读性最好）；
+   *       一旦重名，就追加 @供应商 后缀区分。
+   */
+  const nameCount = new Map();
+  for (const u of upstreams.values()) {
+    nameCount.set(u.name, (nameCount.get(u.name) || 0) + 1);
+  }
+  for (const u of upstreams.values()) {
+    u.litellmName = (nameCount.get(u.name) || 0) > 1
+      ? `${u.name}@${u.providerId}`
+      : u.name;
+  }
+  /** 复合键 → 实际写进 YAML 的 model_name */
+  const yamlNameOf = (key) => upstreams.get(key)?.litellmName || null;
+
   push('# ============================================================================');
   push('#  Generated by dsh-plugin-litellm-bridge - profile fallback chains');
   push(`#  Generated at: ${new Date().toISOString()}`);
@@ -125,12 +179,13 @@ export function assembleChainConfig(state, pool = null) {
   push('#  This file only mirrors those upstreams so the gateway can execute the');
   push('#  fallback order. The plugin itself performs no routing / retry / fallback.');
   push('#  api_key entries are os.environ references - never plaintext.');
+  push('#  Entries with the same model but different accounts get a @provider suffix.');
   push('#');
 
   push('model_list:');
   for (const u of upstreams.values()) {
-    push(`  # ${u.providerId}`);
-    push(`  - model_name: ${u.name}`);
+    push(`  # provider: ${u.providerId}${u.litellmName !== u.name ? ` | model: ${u.name}` : ''}`);
+    push(`  - model_name: ${u.litellmName}`);
     push('    litellm_params:');
     push(`      model: ${u.prefix}/${u.name}`);
     push(`      api_base: ${u.baseUrl}`);
@@ -139,9 +194,9 @@ export function assembleChainConfig(state, pool = null) {
   }
   // 链头：逻辑名 → 链首模型的真实上游
   for (const c of chains) {
-    const first = upstreams.get(c.chain[0]);
+    const firstKey = c.members?.[0]?.key;
+    const first = firstKey ? upstreams.get(firstKey) : null;
     if (!first) continue;
-    if (upstreams.has(c.head)) continue;
     push(`  # chain head: ${c.pid} / ${c.at}`);
     push(`  - model_name: ${c.head}`);
     push('    litellm_params:');
@@ -153,20 +208,34 @@ export function assembleChainConfig(state, pool = null) {
   push('');
 
   // ---- 3. 降级顺序（网关执行）--------------------------------------------
+  // 注意：fallbacks 里必须用**YAML 中的实名**（带 @provider 后缀的那个），
+  // 不能用裸模型名，否则同名上游会串。
   push('litellm_settings:');
   push('  # Fallback order is assembled by the plugin, executed by the gateway.');
-  const multi = chains.filter((c) => c.chain.length >= 2 && upstreams.has(c.chain[0]));
+  const multi = chains.filter((c) => (c.members || []).length >= 2);
   push('  fallbacks:');
   if (!multi.length) {
     push('    []');
   } else {
-    for (const c of multi) push(`    - ${c.head}: [${c.chain.slice(1).map((m) => `"${m}"`).join(', ')}]`);
+    for (const c of multi) {
+      const rest = c.members.slice(1)
+        .map((m) => yamlNameOf(m.key))
+        .filter(Boolean)
+        .map((n) => `"${n}"`);
+      if (!rest.length) continue;
+      push(`    - ${c.head}: [${rest.join(', ')}]`);
+    }
   }
   push('  context_window_fallbacks:');
   if (!multi.length) {
     push('    []');
   } else {
-    for (const c of multi) push(`    - ${c.head}: ["${c.chain[c.chain.length - 1]}"]`);
+    for (const c of multi) {
+      const last = c.members[c.members.length - 1];
+      const n = yamlNameOf(last.key);
+      if (!n) continue;
+      push(`    - ${c.head}: ["${n}"]`);
+    }
   }
   push('  num_retries: 2');
   push('  request_timeout: 900');

package/dsh-plugin-litellm-bridge/lib/config-store.js

@@ -93,6 +93,34 @@ export function statePath() {
   return join(stateDir(), 'state.json');
 }
 
+/**
+ * 旧版遗留的「假模型名」。
+ *
+ * 插件 1.x 时代网关自己维护 model_list，写死过一批别名
+ * （root-primary / coder-fallback-1 之类）。架构修正后模型池改由
+ * DSH【设置-模型】提供，这些名字**在真实模型池里一个都不存在**。
+ *
+ * 用户机器上的 state.json 会带着它们，表现就是：
+ *   首选模型下拉显示「— 请选择 —」，但下面 fallback 里挂着一串
+ *   永远连不上的假名字 —— 这就是「看不懂怎么配」的直接来源。
+ *
+ * 这里做一个自动迁移：加载状态时把它们清掉，让界面回到干净骨架。
+ */
+const LEGACY_MODEL_RE = /^(root|coder|research)-(primary|fallback-\d+|profile-\w+)$/;
+
+function isLegacyModelName(name) {
+  return typeof name === 'string' && LEGACY_MODEL_RE.test(name.trim());
+}
+
+/** 清理一条链里所有旧版假模型名，返回清理后的链与是否发生变更。 */
+function stripLegacyModels(chain) {
+  const before = JSON.stringify(chain);
+  const primary = isLegacyModelName(chain.primary) ? '' : chain.primary;
+  const fallbacks = (chain.fallbacks || []).filter((f) => !isLegacyModelName(f));
+  const after = JSON.stringify({ ...chain, primary, fallbacks });
+  return { chain: { ...chain, primary, fallbacks }, changed: before !== after };
+}
+
 /** 归一化一条 agent 链（容忍旧版本 / 残缺字段）。 */
 function mergeAgentChain(src, base) {
   const out = { ...base };
@@ -128,6 +156,9 @@ function mergeState(base, loaded) {
       };
       for (const at of AGENT_TYPES) {
         out.agents[at] = mergeAgentChain(prof?.agents?.[at], skeleton.agents[at]);
+        // 自动清理旧版遗留的假模型名（root-primary 之类）
+        const { chain } = stripLegacyModels(out.agents[at]);
+        out.agents[at] = chain;
       }
       merged.routes[pid] = out;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-litellm-bridge",
-  "version": "2.0.8",
+  "version": "2.1.0",
   "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",