dsh-router-core 0.4.8 → 0.4.9

package/lib/types/shared.d.ts

@@ -218,6 +218,8 @@ export interface RouterExtResponse {
 /** 供应商模型（含启用状态）。 */
 export interface RouterSupplierModel {
     id: string;
+    /** 可读名（上游写的，只用于显示；缺省 = id）。见 `ModelInfo.name`。 */
+    name?: string;
     context_length?: number;
     enabled: boolean;
     /** 是否为自定义（手动添加 / 拉取）模型，可删除。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-router-core",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "DSH plugin: a simplified 9router (AI routing gateway). Adds a 路由系统 (Routing System) sidebar entry beside 记忆系统; the panel shows suppliers, account pool, combos, and endpoint/API keys.",
   "type": "module",
   "repository": {

package/src/client/CombosTab.tsx

@@ -10,6 +10,7 @@ import {
   type RouterComboAlias,
   type RouterComboSupplierGroup,
 } from '../shared.ts'
+import { modelLabel, modelMatches } from './model-label.ts'
 import { Modal } from './Modal.tsx'
 
 /* ---------------- SVG 图标 ---------------- */
@@ -67,6 +68,22 @@ export function CombosTab({ combos, aliases, onRefresh }: CombosTabProps): JSX.E
       ?? groups.find(g => g.models.some(m => m.id === stored))
     return hit === undefined ? stored : `${hit.supplier.alias}/${stored}`
   }
+  /**
+   * 存储值 → 悬停说明。组合里存的、请求要发的都是 `alias/modelId`（上面那行），
+   * 但上游 key 往往不是人能读的（`qmodel_38max`），所以把上游的可读名
+   * （`Qwen3.8-Max`）放进 title 里，不占行宽也不改变「发什么」。
+   */
+  const comboTip = (stored: string): string => {
+    const name = displayName(stored)
+    const comma = stored.indexOf(',')
+    const mid = comma > 0 ? stored.slice(comma + 1) : stored
+    const sid = comma > 0 ? stored.slice(0, comma) : ''
+    const hit = (sid === '' ? groups : groups.filter(g => g.supplier.id === sid))
+      .flatMap(g => g.models)
+      .find(m => m.id === mid)
+    const readable = (hit?.name ?? '').trim()
+    return readable === '' || readable === mid ? name : `${readable}\n${name}（请求里用这个）`
+  }
   const [showForm, setShowForm] = useState(false)
   const [editing, setEditing] = useState<RouterCombo | null>(null)
   const [form, setForm] = useState<ComboForm>({ name: '', models: [] })
@@ -289,7 +306,7 @@ export function CombosTab({ combos, aliases, onRefresh }: CombosTabProps): JSX.E
                     : (
                       <>
                         {combo.models.slice(0, 4).map((model, i) => (
-                          <span key={`${model}-${i}`} className="dshr-comboChip">
+                          <span key={`${model}-${i}`} className="dshr-comboChip" title={comboTip(model)}>
                             <span className="dshr-comboChipNum">{i + 1}</span>
                             <span className="dshr-comboChipSupplier">{displayName(model)}</span>
                           </span>
@@ -349,7 +366,7 @@ export function CombosTab({ combos, aliases, onRefresh }: CombosTabProps): JSX.E
                         >
                           <span className="dshr-comboGrip" title="拖拽排序"><Icon d={I.grip} size={14} /></span>
                           <span className="dshr-comboStepNum">{index + 1}</span>
-                          <code className="dshr-comboSelectedModel">{displayName(model)}</code>
+                          <code className="dshr-comboSelectedModel" title={comboTip(model)}>{displayName(model)}</code>
                           <button type="button" className="dshr-iconBtn dshr-iconBtn-sm dshr-comboStepRemove" title="移除" onClick={() => removeModel(index)}>
                             <Icon d={I.delete} size={14} />
                           </button>
@@ -379,16 +396,20 @@ export function CombosTab({ combos, aliases, onRefresh }: CombosTabProps): JSX.E
                       : groups.map(g => {
                         const items = g.models.filter(m =>
                           !form.models.includes(`${g.supplier.id},${m.id}`) &&
-                          (modelQuery === '' || m.id.toLowerCase().includes(modelQuery.toLowerCase())))
+                          (modelQuery === '' || modelMatches(modelQuery, m)))
                         if (items.length === 0) return null
                         return (
                           <div key={g.supplier.id} className="dshr-comboPickGroup">
                             <p className="dshr-comboPickGroupTitle">{g.supplier.name} · {g.supplier.alias}</p>
-                            {items.map(m => (
-                              <button key={m.id} type="button" className="dshr-comboPickItem" onClick={() => toggleModel(g.supplier.id, m.id)}>
-                                <span className="dshr-comboPickName">{m.id}</span>
-                              </button>
-                            ))}
+                            {items.map(m => {
+                              const lab = modelLabel(m)
+                              return (
+                                <button key={m.id} type="button" className="dshr-comboPickItem" title={lab.title} onClick={() => toggleModel(g.supplier.id, m.id)}>
+                                  <span className="dshr-comboPickName">{lab.label}</span>
+                                  {lab.showId && <span className="dshr-comboPickKey">{m.id}</span>}
+                                </button>
+                              )
+                            })}
                           </div>
                         )
                       })}

package/src/client/SupplierDetail.tsx

@@ -13,6 +13,7 @@ import {
   type RouterSupplierModelsResponse,
 } from '../shared.ts'
 import { statusBadge } from './account-badge.ts'
+import { modelLabel, modelMatches } from './model-label.ts'
 import { Modal } from './Modal.tsx'
 
 /* ---------------- SVG 图标 ---------------- */
@@ -550,7 +551,7 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
     return out
   })()
   const q = modelQuery.trim().toLowerCase()
-  const matchQuery = (m: RouterSupplierModel): boolean => q === '' || m.id.toLowerCase().includes(q)
+  const matchQuery = (m: RouterSupplierModel): boolean => modelMatches(q, m)
   const enabledModels = models?.filter(m => m.enabled && matchQuery(m)) ?? []
   const disabledModels = models?.filter(m => !m.enabled && matchQuery(m)) ?? []
 
@@ -763,19 +764,24 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
               {enabledModels.map(model => {
                 const status = testResults[model.id]
                 const chipCls = status === 'ok' ? ' dshr-modelChip-ok' : status === 'error' ? ' dshr-modelChip-err' : ''
+                const lab = modelLabel(model)
                 return (
                   <div key={model.id} className={`dshr-modelChipWrap${chipCls}`}>
                     <button
                       type="button"
                       className="dshr-modelChip"
-                      title="点击禁用"
+                      title={`${lab.title}\n点击禁用`}
                       disabled={toggling}
                       onClick={() => void toggleModel(model.id, false)}
                     >
                       <span className="dshr-modelChipStatus">
                         <Icon d={status === 'ok' ? I.checkCircle : status === 'error' ? I.cancel : I.robot} size={13} />
                       </span>
-                      <span className="dshr-modelChipId">{model.id}</span>
+                      <span className="dshr-modelChipName">{lab.label}</span>
+                      {lab.showId && <span className="dshr-modelChipKey">{model.id}</span>}
+                      {typeof model.context_length === 'number' && model.context_length > 0 && (
+                        <span className="dshr-modelChipCtx">{model.context_length}K</span>
+                      )}
                     </button>
                     <div className="dshr-modelChipOps">
                       <button
@@ -819,11 +825,11 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
                         key={model.id}
                         type="button"
                         className="dshr-modelChip dshr-modelChip-off"
-                        title="点击恢复"
+                        title={`${modelLabel(model).title}\n点击恢复`}
                         disabled={toggling}
                         onClick={() => void toggleModel(model.id, true)}
                       >
-                        <span className="dshr-modelChipId">{model.id}</span>
+                        <span className="dshr-modelChipName">{modelLabel(model).label}</span>
                         <span className="dshr-modelChipRestore">+ 恢复</span>
                       </button>
                     ))}

package/src/client/model-label.test.ts

@@ -0,0 +1,33 @@
+/**
+ * 模型标签/搜索判据测试。
+ *
+ * 为什么要有：这两条判据错了都不会报错，只会让人在面板上做错事 ——
+ * 标签退化成 key（用户还是看不懂），或搜索只认 key（记不清 key 的人搜不到）。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { modelLabel, modelMatches } from './model-label.ts'
+
+test('有可读名：名字在前，key 作为副标签', () => {
+  const l = modelLabel({ id: 'qmodel_38max', name: 'Qwen3.8-Max' })
+  assert.equal(l.label, 'Qwen3.8-Max')
+  assert.equal(l.showId, true)
+  assert.match(l.title, /qmodel_38max/)
+})
+
+test('没有可读名 / 名字与 key 相同：只显示 key，不重复', () => {
+  assert.deepEqual(
+    { ...modelLabel({ id: 'gpt-4o' }), title: undefined },
+    { label: 'gpt-4o', showId: false, title: undefined },
+  )
+  assert.equal(modelLabel({ id: 'gpt-4o', name: 'gpt-4o' }).showId, false)
+  assert.equal(modelLabel({ id: 'gpt-4o', name: '   ' }).label, 'gpt-4o')
+})
+
+test('搜索：可读名与 key 都能命中', () => {
+  const m = { id: 'kmodel_latest', name: 'Kimi-K3.1-Pro' }
+  assert.equal(modelMatches('kimi', m), true)
+  assert.equal(modelMatches('KMODEL', m), true)
+  assert.equal(modelMatches('  ', m), true)
+  assert.equal(modelMatches('glm', m), false)
+})

package/src/client/model-label.ts

@@ -0,0 +1,48 @@
+/**
+ * 模型 chip 的标签 —— 「可读名 + 上游 key」两段。
+ *
+ * 为什么需要：有些上游的模型 key 是内部标识（Qoder 的 `qmodel_38max`、
+ * `kmodel_latest`、`mmodel`），面板上只剩一串猜不出含义的字母；而上游目录里
+ * 其实同时下发了可读名（`Qwen3.8-Max`、`Kimi-K3.1-Pro`）。丢掉它，用户点
+ * 「获取模型」之后仍然不知道自己勾的是什么。
+ *
+ * 但两段不能互相替代：**能发给上游的只有 key**。所以显示上可读名在前、key 在后
+ * （两者相同时只显示一次），复制按钮复制 key，请求/组合存的也是 key。
+ */
+
+/** 一个模型在面板上的呈现。 */
+export interface ModelLabel {
+  /** 主标签：上游给的可读名，没有（或与 key 相同）就用 key。 */
+  label: string
+  /** 是否还要把 key 作为副标签显示 —— 与主标签相同就不重复。 */
+  showId: boolean
+  /** 悬停提示：两个都给出来，并点明请求要用哪个。 */
+  title: string
+}
+
+/**
+ * 算出模型的展示标签。
+ * @param m 至少要有 `id`；`name` 是可读名（可缺、可空串）
+ */
+export function modelLabel(m: { id: string; name?: string }): ModelLabel {
+  const name = (m.name ?? '').trim()
+  const label = name === '' || name === m.id ? m.id : name
+  const showId = label !== m.id
+  return {
+    label,
+    showId,
+    title: showId ? `${label}\n${m.id}（请求与组合里用这个）` : m.id,
+  }
+}
+
+/**
+ * 搜索匹配：可读名与 key **都**参与。
+ *
+ * 两种说法都要能搜到：记得模型叫什么的人搜 `kimi`，记得上游 key 的人搜
+ * `kmodel`；只匹配一个等于把另一半人的搜索框作废。
+ */
+export function modelMatches(query: string, m: { id: string; name?: string }): boolean {
+  const q = query.trim().toLowerCase()
+  if (q === '') return true
+  return m.id.toLowerCase().includes(q) || (m.name ?? '').toLowerCase().includes(q)
+}

package/src/client/router.css

@@ -1900,9 +1900,16 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     cursor: default;
 }
 
-.dshr-modelChipId {
+/* 主标签 = 上游的可读名（缺省回落成 key），正文字号；key 用等宽淡字跟在后面，
+   两者相同时不渲染 key（判据见 model-label.ts） */
+.dshr-modelChipName {
+    font-size: 12px;
+}
+
+.dshr-modelChipKey {
     font-family: var(--rs-mono);
-    font-size: 11px;
+    font-size: 10px;
+    color: var(--rs-faint);
 }
 
 .dshr-modelChipCtx {
@@ -2047,61 +2054,6 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
     opacity: 1;
 }
 
-/* 旧 .dshr-modelChip 独立样式（disabled 区仍用） */
-.dshr-modelChip {
-    display: inline-flex;
-    align-items: center;
-    gap: 6px;
-    padding: 6px 10px;
-    border: 1px solid var(--rs-line);
-    border-radius: 8px;
-    color: var(--rs-text);
-    background: var(--rs-layer-1);
-    font-size: 12px;
-    cursor: pointer;
-    transition:
-        border-color 0.12s ease,
-        background 0.12s ease,
-        color 0.12s ease;
-}
-
-.dshr-modelChip:hover {
-    border-color: var(--rs-accent);
-    background: color-mix(in srgb, var(--rs-accent) 6%, transparent);
-}
-
-.dshr-modelChip:disabled {
-    opacity: 0.6;
-    cursor: default;
-}
-
-.dshr-modelChipId {
-    font-family: var(--rs-mono);
-    font-size: 11px;
-}
-
-.dshr-modelChipCtx {
-    flex: none;
-    color: var(--rs-faint);
-    font-size: 10px;
-}
-
-.dshr-modelChip-off {
-    border-style: dashed;
-    color: var(--rs-faint);
-    opacity: 0.8;
-}
-
-.dshr-modelChip-off:hover {
-    color: var(--rs-accent);
-    border-color: var(--rs-accent);
-}
-
-.dshr-modelChipRestore {
-    color: var(--rs-accent);
-    font-size: 10px;
-}
-
 /* 计数徽标跟在标题/操作按钮右侧（模型卡片） */
 .dshr-cardMetaAfter {
     margin-left: 0;
@@ -2484,9 +2436,20 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not(
 }
 
 .dshr-comboPickName {
-    flex: 1;
+    flex: 0 1 auto;
     min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+/* 挑选项里的上游 key：可读名之后的小号等宽淡字，两者相同时不渲染 */
+.dshr-comboPickKey {
+    flex: none;
+    margin-left: auto;
     font-family: var(--rs-mono);
+    font-size: 10px;
+    color: var(--rs-faint);
     overflow: hidden;
     text-overflow: ellipsis;
     white-space: nowrap;

package/src/router/models-cache.test.ts

@@ -752,3 +752,19 @@ test('正常供应商（listModels 全量返回）：列表内容与启用状态
   assert.deepEqual(models.map((m) => m.id).sort(), ['a-1', 'a-2'])
   assert.deepEqual(models.map((m) => m.enabled).sort(), [false, true], '启用状态仍由核心合并')
 })
+
+test('可读名原样透传到面板，且 id 不被它替换', async () => {
+  const router = new Router('')
+  // Qoder 的形状：id 是上游内部 key，可读名在 name 里
+  const a = supplier('a', [{ id: 'qmodel_38max', name: 'Qwen3.8-Max', context_length: 200 }])
+  addSupplier(router, a.s)
+
+  const models = await router.modelsOf('a')
+  assert.deepEqual(models, [{
+    id: 'qmodel_38max',
+    name: 'Qwen3.8-Max',
+    context_length: 200,
+    enabled: true,
+    custom: undefined,
+  }], '两个字段各自都必须在：拿 name 去请求上游会 404，只剩 id 则面板上看不懂')
+})

package/src/router/types.ts

@@ -35,7 +35,18 @@ export interface SupplierStatus {
 
 /** OpenAI 模型条目。 */
 export interface ModelInfo {
+  /** 上游的模型 key（**唯一标识**：组合存它、路由认它、上游收它）。 */
   id: string
+  /**
+   * 可读名（上游自己写的，如 `Qwen3.8-Max`）。**只用于显示**，缺省 = `id`。
+   *
+   * 为什么需要它：有些上游的 key 是内部标识（Qoder 的 `qmodel_38max`、
+   * `kmodel_latest`），面板上只剩一串猜不出含义的字母。既然上游在目录里
+   * 同时下发了 `display_name`，丢掉它就是把可读信息换成噪声。
+   * 反过来，**凡是"发给上游/存下来"的地方都得继续用 `id`**——用名字去请求
+   * 上游只会拿到 404。
+   */
+  name?: string
   context_length?: number
 }
 

package/src/shared.ts

@@ -227,6 +227,8 @@ export interface RouterExtResponse {
 /** 供应商模型（含启用状态）。 */
 export interface RouterSupplierModel {
   id: string
+  /** 可读名（上游写的，只用于显示；缺省 = id）。见 `ModelInfo.name`。 */
+  name?: string
   context_length?: number
   enabled: boolean
   /** 是否为自定义（手动添加 / 拉取）模型，可删除。 */