dsh-router-core 0.3.9 → 0.3.11

package/lib/types/suppliers/contract.d.ts

@@ -22,6 +22,21 @@ export interface SupplierEnv {
     store: SupplierConfigStore;
     /** 通用凭证存储（账号凭证，核心统一管）。 */
     credentials: CredentialStore;
+    /**
+     * 迟到的失败上报（可选）——**只在响应已提交之后**才用。
+     *
+     * 流式请求一旦写出第一个字节就绑死（HTTP 语义），此时上游再报错已经换不了
+     * 号、也改不了状态码。但「这个号坏了」这件事对**后续**请求仍然有价值：
+     * 不报上来，它就会继续留在池里被轮转选中，每次都白撞一次同一个错误。
+     *
+     * 核心实现 = `pool.noteFailure(uid, model, state, message)`，按该状态的规则
+     * 冷却/禁用。真实案例：TRAE 免费通道对某账号拒绝某模型时发 HTTP 200 +
+     * 流内 `code=4008`，三个号里两个如此，round-robin 下 2/3 请求直接失败
+     * （2026-09-08 实测）——有了这条通道，坏号被冷一次就退出轮转。
+     *
+     * 插件拿不到也不用兜底：不调用就退化成今天的行为，不影响正确性。
+     */
+    onLateFailure?: (uid: string, model: string, state: AccountState, message: string) => void;
 }
 /** 通用供应商工厂：一个 js 模块 export 它（或 default export 它），loader 调用得到实例。 */
 export type SupplierFactory = (env: SupplierEnv) => SupplierModule;
@@ -93,6 +108,12 @@ export interface SupplierModule {
     readonly priority?: number;
     /** 图标（URL 或 SVG data URI），面板供应商卡片显示。可选。 */
     readonly icon?: string;
+    /**
+     * 「添加 API key」弹窗的提示文案（HTML 未转义前是纯文本）。可选。
+     * 缺省时前端用通用文案。供应商若走 `addApiKey` 且有自己的 key 获取方式，
+     * 应提供它——否则所有供应商弹窗都显示同一句通用提示（如默认会写 OpenRouter）。
+     */
+    readonly apiKeyHint?: string;
     /** 报账号「现在状态」。冷却/禁用/错误累计由核心叠加，插件不算这些。 */
     status(): SupplierStatusNow;
     /** 模型来源。`force=true` 时强制刷新来源（核心「获取模型」按钮调用）。 */
@@ -102,10 +123,14 @@ export interface SupplierModule {
      * 选号/回退/健康判定全是核心的活。
      * 无账号供应商（如 opencode）传空 uid，忽略即可。
      *
+     * `lv` 是推理等级（reasoning effort），`'auto'` 表示不显式下发；
+     * 供应商各自决定怎么把 `lv` 映射到上游（OpenAI 兼容一般是
+     * `reasoning_effort` 字段）。
+     *
      * 失败原因通过返回值的 `message` 报（核心在测试模型时直接用它做诊断提示），
      * 插件不必自己存一份「上次失败」的状态。
      */
-    chatOnce(uid: string, req: ChatRequest): Promise<ChatOnceResult>;
+    chatOnce(uid: string, lv: string, req: ChatRequest): Promise<ChatOnceResult>;
     dispose(): void;
     /** 生成登录链接（加账号）。有它才显示连接池（账号池）。 */
     generateLoginUrl?(): string | {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-router-core",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "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/RouterView.tsx

@@ -54,7 +54,7 @@ interface RouterViewProps {
 
 export function RouterView({ onBack }: RouterViewProps): JSX.Element {
   const [tab, setTab] = useState<TabId>('overview')
-  const [detailSupplier, setDetailSupplier] = useState<{ id: string; name: string; icon?: string } | null>(null)
+  const [detailSupplier, setDetailSupplier] = useState<{ id: string; name: string; icon?: string; apiKeyHint?: string } | null>(null)
   const [snapshot, setSnapshot] = useState<Snapshot>({ health: null, status: null, combos: null })
   const [refreshing, setRefreshing] = useState(false)
   const mounted = useRef(true)
@@ -90,7 +90,7 @@ export function RouterView({ onBack }: RouterViewProps): JSX.Element {
   const combosError = snapshot.combos?.ok === false ? snapshot.combos.error : undefined
 
   /** 渲染一组供应商卡片（内置 / 插件分开）。 */
-  const renderSupplierGroup = (title: string, group: Array<{ id: string; name: string; icon?: string; source?: string }>): ReactNode => {
+  const renderSupplierGroup = (title: string, group: Array<{ id: string; name: string; icon?: string; apiKeyHint?: string; source?: string }>): ReactNode => {
     if (group.length === 0) return null
     return (
       <div className="dshr-supplierGroup">

package/src/client/StatsTab.tsx

@@ -70,10 +70,12 @@ function fmt(n: number | undefined): string {
   return new Intl.NumberFormat().format(n ?? 0)
 }
 
-/** 大数缩写：1.2K / 3.4M（卡片和柱图上放不下完整数字时用）。 */
+/** 大数缩写：1.2K / 3.4M / 5.6B / 7.8T（卡片和柱图上放不下完整数字时用）。 */
 function fmtShort(n: number | undefined): string {
   const v = n ?? 0
-  if (v >= 1_000_000) return `${(v / 1_000_000).toFixed(1)}M`
+  if (v >= 1e12) return `${(v / 1e12).toFixed(1)}T`
+  if (v >= 1e9) return `${(v / 1e9).toFixed(1)}B`
+  if (v >= 1e6) return `${(v / 1e6).toFixed(1)}M`
   if (v >= 10_000) return `${(v / 1000).toFixed(1)}K`
   return fmt(v)
 }

package/src/client/SupplierDetail.tsx

@@ -43,7 +43,7 @@ const I = {
 }
 
 interface SupplierDetailProps {
-  supplier: { id: string; name: string; capabilities?: string[]; icon?: string }
+  supplier: { id: string; name: string; capabilities?: string[]; icon?: string; apiKeyHint?: string }
   accounts: RouterAccount[]
   /** 状态是否还在加载。 */
   statusLoading: boolean
@@ -112,6 +112,8 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
   const [checkingIn, setCheckingIn] = useState(false)
   const [refreshing, setRefreshing] = useState(false)
   const [dragIndex, setDragIndex] = useState<number | null>(null)
+  const [renameUid, setRenameUid] = useState<string | null>(null)
+  const [renameDraft, setRenameDraft] = useState('')
   const mounted = useRef(true)
 
   useEffect(() => {
@@ -343,6 +345,33 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
     setRemoveTarget(null)
   }
 
+  const startRename = (account: RouterAccount): void => {
+    setRenameDraft(account.nickname ?? '')
+    setRenameUid(account.uid)
+  }
+
+  const saveRename = async (account: RouterAccount): Promise<void> => {
+    try {
+      const response = await fetch(`${ROUTER_API_BASE}/status/rename`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ supplier: supplier.id, uid: account.uid, name: renameDraft.trim() }),
+        cache: 'no-store',
+      })
+      if (!response.ok) {
+        showToast(`保存失败：HTTP ${response.status}`)
+        setRenameUid(null)
+        return
+      }
+      onRefresh()
+      showToast('连接名已保存')
+    } catch (err) {
+      showToast(`保存失败：${(err as Error).message}`)
+    } finally {
+      setRenameUid(null)
+    }
+  }
+
   const toggleModel = async (id: string, enabled: boolean): Promise<void> => {
     setToggling(true)
     try {
@@ -644,7 +673,7 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
                     <div
                       key={account.uid}
                       className={`dshr-linkRow${dragIndex === index ? ' dshr-linkRowDragging' : ''}`}
-                      draggable
+                      draggable={renameUid !== account.uid}
                       onDragStart={(e) => { setDragIndex(index); e.dataTransfer.effectAllowed = 'move' }}
                       onDragOver={(e) => { e.preventDefault(); e.dataTransfer.dropEffect = 'move' }}
                       onDrop={(e) => {
@@ -667,7 +696,20 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
                       </div>
                       <div className="dshr-linkMain">
                         <div className="dshr-linkTitleLine">
-                          <span className="dshr-linkName">{account.nickname || account.uid}</span>
+                          {renameUid === account.uid
+                            ? (
+                              <input
+                                className="dshr-input dshr-mono"
+                                value={renameDraft}
+                                autoFocus
+                                onChange={(e) => setRenameDraft(e.target.value)}
+                                onKeyDown={(e) => {
+                                  if (e.key === 'Enter') void saveRename(account)
+                                  if (e.key === 'Escape') setRenameUid(null)
+                                }}
+                              />
+                            )
+                            : <span className="dshr-linkName">{account.nickname || account.uid}</span>}
                           <span className={`dshr-badge ${badge.cls}`}>{badge.text}</span>
                         </div>
                         <div className="dshr-linkSub">
@@ -689,6 +731,17 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
                         </div>
                       </div>
                       <div className="dshr-linkOps">
+                        <button
+                          type="button"
+                          className={`dshr-iconBtn dshr-iconBtn-sm dshr-linkEdit${renameUid === account.uid ? ' dshr-linkEdit-active' : ''}`}
+                          title={renameUid === account.uid ? '保存名字' : '改名'}
+                          onClick={() => {
+                            if (renameUid === account.uid) void saveRename(account)
+                            else startRename(account)
+                          }}
+                        >
+                          <Icon d={renameUid === account.uid ? I.check : I.edit} size={15} />
+                        </button>
                         <button type="button" className="dshr-iconBtn dshr-iconBtn-sm dshr-linkDelete" title="删除链接" onClick={() => setRemoveTarget(account)}>
                           <Icon d={I.delete} size={15} />
                         </button>
@@ -895,7 +948,7 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
           {canApiKey
             ? (
               <div className="dshr-modalForm">
-                <p className="dshr-muted">填入 OpenRouter API key（https://openrouter.ai/settings/keys），可起名字区分多个 key。</p>
+                <p className="dshr-muted">{supplier.apiKeyHint ?? '填入 API key，可起名字区分多个 key。'}</p>
                 {error !== '' && <div className="dshr-alert"><strong>出错了</strong><span>{error}</span></div>}
                 <input
                   className="dshr-input"

package/src/client/router.css

@@ -1634,6 +1634,20 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not([data-dsh-ssh-
   background: color-mix(in srgb, var(--rs-danger) 14%, transparent);
 }
 
+/* 改名：与删除一致，hover 行才显示；编辑中保持可见（否则保存按钮被藏住） */
+.dshr-linkEdit {
+  color: var(--rs-muted);
+  opacity: 0;
+  transition: opacity .12s ease, color .12s ease, background .12s ease;
+}
+.dshr-linkRow:hover .dshr-linkEdit { opacity: 1; }
+.dshr-linkEdit:focus-visible { opacity: 1; }
+.dshr-linkEdit:hover {
+  color: var(--rs-accent);
+  background: color-mix(in srgb, var(--rs-accent) 14%, transparent);
+}
+.dshr-linkEdit.dshr-linkEdit-active { opacity: 1; }
+
 /* 模型 chips（9router ModelRow 风格） */
 .dshr-modelChips {
   display: flex;

package/src/data-dir.test.ts

@@ -0,0 +1,54 @@
+/**
+ * 数据目录解析测试 —— 锁死「落盘位置不跟 cwd 跑」这个 bug。
+ *
+ * 起因：以前写的是相对路径 `data/state.json`，宿主 Node 进程的 cwd 决定它
+ * 落到哪。从别的目录 `dsh web` 启动 → 配置静默写进另一个目录，面板显示空
+ * 配置，用户看到的就是「配置丢了」。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtempSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { dataDirOf, profileDirOf } from './data-dir.ts'
+
+/** 一个临时 profile 目录的 file: URL（宿主 `ctx.baseUrl` 的形状）。 */
+function tempProfileUrl(): { url: string; dir: string } {
+  const dir = mkdtempSync(join(tmpdir(), 'dshr-profile-'))
+  writeFileSync(join(dir, 'cordis.yml'), '[]\n') // 让它像个 profile
+  return { url: pathToFileURL(dir).href + '/', dir }
+}
+
+test('有 baseUrl → 数据目录钉在 profile 里（绝对路径）', () => {
+  const { url, dir } = tempProfileUrl()
+  assert.equal(profileDirOf(url), dir)
+  assert.equal(dataDirOf(url), join(dir, 'data'))
+})
+
+test('换 cwd 不影响落盘位置（回归：不跟 process.cwd() 跑）', () => {
+  const { url, dir } = tempProfileUrl()
+  const before = dataDirOf(url)
+  const cwd = process.cwd()
+  try {
+    process.chdir(tmpdir())
+    assert.equal(dataDirOf(url), before)
+  } finally {
+    process.chdir(cwd)
+  }
+  assert.ok(resolve(before).startsWith(resolve(dir)))
+})
+
+test('baseUrl 缺失/异常 → 兜底 $DSH_HOME 的 web profile', () => {
+  const saved = process.env.DSH_HOME
+  const home = mkdtempSync(join(tmpdir(), 'dshr-home-'))
+  try {
+    process.env.DSH_HOME = home
+    assert.equal(profileDirOf(undefined), join(home, 'profiles', 'web'))
+    assert.equal(profileDirOf(''), join(home, 'profiles', 'web'))
+    assert.equal(profileDirOf('http://example.com/x'), join(home, 'profiles', 'web'))
+  } finally {
+    if (saved === undefined) delete process.env.DSH_HOME
+    else process.env.DSH_HOME = saved
+  }
+})

package/src/data-dir.ts

@@ -0,0 +1,46 @@
+/**
+ * 落盘路径解析 —— dsh-router 所有持久化路径的唯一来源。
+ *
+ * 以前写的是相对路径 `data/state.json`：**落盘位置跟着 `process.cwd()` 跑**。
+ * 不在 `~/.dsh/profiles/web` 里 `dsh web` 启动，state.json / supplier-config.json
+ * / keys.json / usage.json 就会静默写进另一个目录（面板显示空配置），切回原目录
+ * 启动又「回来」——用户看到的是「配置丢了」。所以这里一律产出绝对路径。
+ */
+import { homedir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/**
+ * 本 profile 的目录。
+ *
+ * 宿主把配置树锚点 `ctx.baseUrl` 挂在每个插件的 context 上，它正是 profile
+ * 目录（`cordis.yml` 所在处）——不用猜、也不用像 dsh-market 那样嗅探 argv。
+ * 兜底只服务「宿主没给锚点」的冷启动（单测、非常规宿主）：沿用今天的事实
+ * 标准 `web` profile。
+ */
+export function profileDirOf(baseUrl?: string): string {
+  if (typeof baseUrl === 'string' && baseUrl !== '') {
+    try {
+      // 尾部斜杠留给 join 吸收是隐式的，这里显式归一：调用方拿到的是干净目录。
+      return resolve(fileURLToPath(baseUrl))
+    } catch {
+      // 不是 file: URL（或不可解析）——落到兜底分支
+    }
+  }
+  return join(dshHome(), 'profiles', 'web')
+}
+
+/** 数据目录：state.json / supplier-config.json / keys.json / auths/ 都在这里。 */
+export function dataDirOf(baseUrl?: string): string {
+  return join(profileDirOf(baseUrl), 'data')
+}
+
+/** `$DSH_HOME`（支持 `~` 前缀），缺省 `~/.dsh`。 */
+function dshHome(): string {
+  const raw = process.env.DSH_HOME
+  if (raw === undefined || raw.trim() === '') return join(homedir(), '.dsh')
+  const value = raw.trim()
+  if (value === '~') return homedir()
+  if (value.startsWith('~/') || value.startsWith('~\\')) return resolve(homedir(), value.slice(2))
+  return resolve(value)
+}

package/src/index.ts

@@ -30,7 +30,7 @@
  * active library key. `/router/api/*` is same-origin, no auth.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http'
-import { join, dirname } from 'node:path'
+import { join } from 'node:path'
 import { ROUTER_API_BASE, type RouterPeriod } from './shared.ts'
 import { Router } from './router/index.ts'
 import { RouterAdapter } from './llm/adapter.ts'
@@ -40,6 +40,7 @@ import { supplierRoutes } from './suppliers/registry.ts'
 import type { SupplierEnv, SupplierModule } from './suppliers/contract.ts'
 import { SupplierConfigStore } from './supplier-config.ts'
 import { CredentialStore } from './credential-store.ts'
+import { dataDirOf, profileDirOf } from './data-dir.ts'
 
 /**
  * Plugin identity for cordis.yml rows — 必须与 package.json 的 name 一致。
@@ -129,12 +130,18 @@ export function apply(rawContext: unknown): void {
     logger: { info: (message: string) => void; warn: (message: string) => void }
     effect: (fn: () => () => void, label?: string) => void
     inject: (services: string[], callback: (sctx: unknown) => void) => void
+    /** 配置树锚点 = profile 目录（宿主注入），用来把数据钉在 profile 里。 */
+    baseUrl?: string
   }
   const log = (msg: string): void => ctx.logger.info(`[dsh-router] ${msg}`)
 
-  const stateFile = 'data/state.json'
+  // 数据目录必须是绝对路径：相对路径会让落盘位置跟着 process.cwd() 跑，
+  // 从别的目录启动就静默换一套空配置（见 src/data-dir.ts）。
+  const dataDir = dataDirOf(ctx.baseUrl)
+  const stateFile = join(dataDir, 'state.json')
+  log(`data dir: ${dataDir}`)
   const store = new SupplierConfigStore(stateFile)
-  const credentials = new CredentialStore(join(dirname(stateFile), 'auths'))
+  const credentials = new CredentialStore(join(dataDir, 'auths'))
   const router = new Router(stateFile, store, log)
 
   const keys = new KeysStore(stateFile)
@@ -179,7 +186,6 @@ export function apply(rawContext: unknown): void {
   ctx.provide('router.suppliers', {})
 
   // 内置 + 用户 + 外部插件供应商（异步加载，完成后注册路由 + 加入路由器）
-  const dataDir = dirname(stateFile)
   const registerLoaded = (loaded: LoadedSupplier): void => {
     loadedSuppliers.push(loaded)
     router.add(loaded.supplier)
@@ -222,7 +228,8 @@ export function apply(rawContext: unknown): void {
   })
   void (async () => {
     try {
-      const userDir = join(join(process.env.HOME ?? '', '.dsh', 'profiles', 'web'), 'suppliers')
+      // 用户供应商目录也在 profile 里：跟着 baseUrl 走，别硬编码 `web`。
+      const userDir = join(profileDirOf(ctx.baseUrl), 'suppliers')
       const { suppliers, errors } = await loadSuppliers({
         builtinDir: join(import.meta.dirname, 'suppliers'), // 内置 js（opencode 等）
         userDir,
@@ -269,15 +276,18 @@ export function apply(rawContext: unknown): void {
       writeJson(res, 413, { error: { message: 'request body too large', type: 'api_error', code: 'request_too_large' } })
       return
     }
-    let peek: { stream?: boolean; model?: string }
+    let peek: { stream?: boolean; model?: string; reasoning_effort?: unknown }
     try {
-      peek = JSON.parse(body) as { stream?: boolean; model?: string }
+      peek = JSON.parse(body) as { stream?: boolean; model?: string; reasoning_effort?: unknown }
     } catch {
       writeJson(res, 400, { error: { message: 'invalid JSON body', type: 'api_error', code: 'invalid_request' } })
       return
     }
+    const lv = typeof peek.reasoning_effort === 'string' && peek.reasoning_effort !== ''
+      ? peek.reasoning_effort
+      : 'auto'
     await router.chatCompletions(
-      { rawBody: body, stream: !!peek.stream, model: typeof peek.model === 'string' ? peek.model : '' },
+      { rawBody: body, stream: !!peek.stream, model: typeof peek.model === 'string' ? peek.model : '', lv },
       res,
     )
   }))
@@ -294,6 +304,7 @@ export function apply(rawContext: unknown): void {
           id: s.id,
           name: s.name,
           icon: loaded?.supplier.icon,
+          apiKeyHint: loaded?.supplier.apiKeyHint,
           capabilities: loaded ? [...loaded.capabilities] : [],
           source: loaded?.source ?? 'external',
         }
@@ -309,6 +320,23 @@ export function apply(rawContext: unknown): void {
     writeJson(res, 200, { ok: true, accounts })
   })
 
+  // 连接池连接改名：只改面板显示名（存核心 store 的 accountNames，uid 不变）。
+  route(`${ROUTER_API_BASE}/status/rename`, async (req, res) => {
+    let body: { supplier?: string; uid?: string; name?: string }
+    try {
+      body = JSON.parse(await readBody(req, 64 << 10)) as { supplier?: string; uid?: string; name?: string }
+    } catch {
+      writeJson(res, 400, { ok: false, error: 'invalid JSON body' })
+      return
+    }
+    if (typeof body.supplier !== 'string' || body.supplier === '' || typeof body.uid !== 'string' || body.uid === '') {
+      writeJson(res, 400, { ok: false, error: 'supplier and uid are required' })
+      return
+    }
+    store.setAccountName(body.supplier, body.uid, typeof body.name === 'string' ? body.name : '')
+    writeJson(res, 200, { ok: true })
+  })
+
   route(`${ROUTER_API_BASE}/models`, async (_req, res) => {
     try {
       const models = await router.listModels()
@@ -484,10 +512,26 @@ export function apply(rawContext: unknown): void {
         return combos.map((c) => ({ id: c.name }))
       }))
       // adapter：模型目录自动带出组合；对话转发到本插件 /v1（组合路由在 /v1 内完成）。
+      // 带上组合的上下文窗口：没有它 dsh 的自动压缩算不出阈值、会静默关闭。
       disposers.push(ctx.llm.registerAdapter(['router'], new RouterAdapter('http://localhost:3080/v1', {
-        comboModels: async () => (await router.combos()).map((c) => ({ id: c.name })),
+        comboModels: async () => (await router.combos()).map((c) => {
+          const w = router.comboContextWindow(c)
+          return { id: c.name, ...(w !== undefined ? { contextWindow: w } : {}) }
+        }),
       })))
       log('llm provider (Router) + discovery + adapter registered ok')
+      // 预热模型缓存：`comboContextWindow` 只读缓存、不打上游，缓存空着就
+      // 报不出窗口。这里后台填一次，让第一次 resolveModel 就有值。
+      // 失败无所谓（下次 modelsOf 还会拉），不能冒出来。
+      void (async () => {
+        for (const c of await router.combos()) {
+          for (const ref of c.models) {
+            const at = ref.indexOf(',')
+            if (at < 0) continue
+            try { await router.modelsOf(ref.slice(0, at)) } catch { /* 单家失败不连坐 */ }
+          }
+        }
+      })().catch(() => {})
     } catch (err) {
       ctx.logger.warn(`[dsh-router] llm registration failed: ${(err as Error).message}`)
     }

package/src/llm/adapter.test.ts

@@ -509,3 +509,37 @@ test('流式：上游不发空行分隔时也要能分帧（前瞻完整 JSON）
   }
   assert.equal(texts.join(''), 'AB', '两帧都要收到')
 })
+
+test('模型目录：resolveModel 对每个组合声明推理等级（off/low/high/max，默认 high）', async () => {
+  const adapter = new RouterAdapter('http://x', { comboModels: async () => [
+    { id: 'c-a', name: '组合A' },
+    { id: 'c-b' },
+  ] })
+  const a = await adapter.resolveModel('router', 'c-a')
+  assert.equal(a.provider, 'router')
+  assert.equal(a.id, 'c-a')
+  assert.equal(a.name, '组合A')
+  assert.ok(a.reasoning, '组合应声明推理等级，DSH 才允许显式 effort')
+  assert.deepEqual(a.reasoning!.efforts.map((e) => e.id), ['off', 'low', 'high', 'max'])
+  assert.equal(a.reasoning!.defaultEffort, 'high', '默认 High：调用方不指定时物化为 high')
+  // 无显示名时用模型 id 兜底，保证 name 非空（dsh-llm normalizeModelInfo 要求）
+  const b = await adapter.resolveModel('router', 'c-b')
+  assert.equal(b.name, 'c-b')
+})
+
+/**
+ * 上下文窗口透传 —— dsh 的自动压缩靠 `resolveModel().context.contextWindow`
+ * 算阈值（默认用到 80% 触发）。缺失时 dsh-compaction-basic 抛错并静默关闭
+ * 自动压缩，上下文会一路涨到模型硬上限才炸。
+ */
+test('resolveModel 透传组合的 contextWindow（自动压缩才能算阈值）', async () => {
+  const adapter = new RouterAdapter('http://x', { comboModels: async () => [
+    { id: 'c-a', contextWindow: 1_000_000 },
+    { id: 'c-b' }, // 没拿到窗口
+  ] })
+  const a = await adapter.resolveModel('router', 'c-a')
+  assert.deepEqual(a.context, { contextWindow: 1_000_000 }, '有就报')
+
+  const b = await adapter.resolveModel('router', 'c-b')
+  assert.equal(b.context, undefined, '没拿到就不声明 context，绝不填一个假窗口')
+})

package/src/llm/adapter.ts

@@ -10,17 +10,26 @@ import {
   EMPTY_RESPONSE_CODE,
   LlmAdapter,
   LlmError,
+  ReasoningEffortId,
   ToolCallId,
   attributionHeaders,
   type GenerateOptions,
   type LlmModelInfo,
+  type LlmReasoningEffortInfo,
+  type LlmResolvedModelInfo,
   type StreamChunk,
 } from '@deepseek-ai/dsh-llm'
 import { mergeUsage, normalizeUsage, toTokenUsage, type UsageTokens } from '../router/usage-tokens.ts'
 
 /** 模型目录来源：组合。 */
 export interface RouterAdapterSource {
-  comboModels: () => Promise<Array<{ id: string; name?: string }>>
+  /**
+   * 组合列表。`contextWindow` 可选，但**必须尽量给**——自动压缩靠它算阈值
+   * （`dsh-compaction-basic` 在 `context` 缺失时直接抛错并静默关闭自动压缩，
+   * 于是上下文会一路涨到模型硬上限才炸）。
+   * 组合背后是异构供应商时给**最小的那个**（保守，宁可早压缩）。
+   */
+  comboModels: () => Promise<Array<{ id: string; name?: string; contextWindow?: number }>>
 }
 
 /**
@@ -353,6 +362,14 @@ function completeJson(text: string): boolean {
  * DSH adapter：provider `router`。模型目录 = 组合；stream 转发到本插件
  * /v1/chat/completions（组合路由在 /v1 内完成）。
  */
+/** Router provider 对外暴露的推理等级（对齐 dsh/DeepSeek：off/low/high/max）。 */
+const ROUTER_REASONING_EFFORTS: readonly LlmReasoningEffortInfo[] = [
+  { id: ReasoningEffortId('off'), name: 'Off' },
+  { id: ReasoningEffortId('low'), name: 'Low' },
+  { id: ReasoningEffortId('high'), name: 'High' },
+  { id: ReasoningEffortId('max'), name: 'Max' },
+]
+
 export class RouterAdapter extends LlmAdapter {
   private readonly baseURL: string
   private readonly source: RouterAdapterSource
@@ -379,6 +396,22 @@ export class RouterAdapter extends LlmAdapter {
     return out
   }
 
+  async resolveModel(_provider: string, model: string): Promise<LlmResolvedModelInfo> {
+    const combos = await this.source.comboModels()
+    const found = combos.find((m) => m.id === model || m.name === model)
+    const name = found?.name ?? found?.id ?? model
+    // 组合背后是异构供应商，统一声明 dsh 推理等级；实际能否生效取决于
+    // 命中的上游（供应商各有各自的映射/忽略规则，见 applyReasoning + chatOnce(lv)）。
+    // 默认 High：调用方不指定 effort 时，runtime 会物化为 'high' 下发。
+    return {
+      provider: 'router',
+      id: model,
+      name,
+      ...(found?.contextWindow !== undefined ? { context: { contextWindow: found.contextWindow } } : {}),
+      reasoning: { efforts: ROUTER_REASONING_EFFORTS, defaultEffort: ReasoningEffortId('high') },
+    }
+  }
+
   async *stream(options: GenerateOptions): AsyncIterable<StreamChunk> {
     const body = wireRequest(options)
     const controller = new AbortController()

package/src/router/index.ts

@@ -615,6 +615,38 @@ export class Router {
    * 只有两种情况会真的等:`force`(用户主动刷新)和**从来没有过缓存值**
    * (冷启动,没有旧值可给)。后者只发生一次。
    */
+  /**
+   * 组合的上下文窗口(token):组合内各模型窗口的**最小值**,拿不到就 undefined。
+   *
+   * 只读缓存、绝不打上游:调用方是 llm adapter 的 `resolveModel`,它在每次
+   * 请求前后都可能被调用,不能为了报一个容量去触发按供应商的网络往返。
+   * 冷启动(还没缓存)时给 undefined —— 自动压缩会因此跳过这一轮,下次就
+   * 有了,比撒谎说一个窗口值安全。
+   *
+   * 单位:`ModelInfo.context_length` 存的是 **K**(供应商插件统一
+   * `Math.round(tokens / 1000)`,见 codebuddy plugin),这里换算回 token。
+   *
+   * 取最小而不是最大:组合会按策略 fallback 到任意一个模型,按最窄的声明
+   * 才能让「快满了」这件事在任何一条分支上都成立。
+   */
+  comboContextWindow(combo: Combo): number | undefined {
+    let min: number | undefined
+    for (const ref of combo.models) {
+      const at = ref.indexOf(',')
+      if (at < 0) continue
+      const supplierId = ref.slice(0, at)
+      const modelId = ref.slice(at + 1)
+      const hit = this.modelsCache.get(supplierId)
+      if (hit === undefined) return undefined // 这家还没缓存过,不猜
+      const m = hit.models.find((x) => x.id === modelId)
+      const k = m?.context_length
+      if (typeof k !== 'number' || !Number.isFinite(k) || k <= 0) continue
+      const tokens = Math.round(k * 1000)
+      if (min === undefined || tokens < min) min = tokens
+    }
+    return min
+  }
+
   async modelsOf(supplierId: string, force = false): Promise<ModelWithEnabled[]> {
     const s = this.suppliers.find((x) => x.id === supplierId)
     if (s === undefined) return []
@@ -950,7 +982,7 @@ export class Router {
     const cfg = this.store.get(s.id)
     // 无账号供应商：直接调一次（uid 传空，插件忽略）
     if (s.accounts !== undefined && s.accounts().length === 0) {
-      const r = await s.chatOnce('', req)
+      const r = await s.chatOnce('', req.lv ?? 'auto', req)
       if (!r.ok) {
         if (r.state === 'no_such_model') return false // 不是我的模型：换供应商，不记账
         if (trace !== undefined) trace.lastState = r.state
@@ -977,7 +1009,7 @@ export class Router {
       const uid = pool.pick(s.accounts().filter((a) => !tried.has(a.uid)), cfg.poolOrder, cfg.poolStrategy, req.model)
       if (uid === undefined) return false
       tried.add(uid)
-      const r = await s.chatOnce(uid, req)
+      const r = await s.chatOnce(uid, req.lv ?? 'auto', req)
       if (!r.ok) {
         // 模型不属于本供应商：整个供应商都跳过，换号重试没有意义，
         // 也不能记在账号头上（否则无关账号会被攒够错误冷却掉）