dsh-router-core 0.3.20 → 0.4.0

package/src/ext/contract.ts

@@ -25,7 +25,6 @@
  *     file IO —— 落盘位置由核心锚定（不跟 cwd 跑），读写经核心，插件无状态。
  */
 import type { Context } from '@deepseek-ai/cordis'
-import type { IncomingMessage, ServerResponse } from 'node:http'
 
 /** 扩展器唯一 id（注册键）。 */
 export type ExtId = string
@@ -58,12 +57,6 @@ export interface RouterExt {
   readonly icon?: string
   /** 当前运行时状态（ready + 不就绪时的说明）。 */
   getState(): ExtState
-  /**
-   * 通用扩展 API 点（可选）：核心把 `/router/api/ext/{id}/{subpath}` 兜底路由派发进来，
-   * 由扩展器自己裁决/处理（如 watch 的 `processes`/`kill`）。返回 true 表示已处理；
-   * false / 未实现 → 核心回 404。这样扩展的执行面逻辑进插件，核心只加一条通用转发。
-   */
-  api?(subpath: string, req: IncomingMessage, res: ServerResponse): boolean | Promise<boolean>
   /** 卸载清理（表删除时由 dsh-router 调用，可选）。 */
   dispose?(): void
 }

package/src/host-version.test.ts

@@ -0,0 +1,61 @@
+/**
+ * 宿主版本探测测试 —— 锁死「最近命中徽章仅在 >= 0.1.7 出现」这条判定。
+ *
+ * 起因：`conversation.composer.dock` 座位在 0.1.5 也在，但渲染在 InputBar 之后
+ * 的独立块（位置不对）；只有 0.1.7 才放进底部操作行。座位名相同没法靠契约区分，
+ * 只能按宿主版本号判定——本测试就是这条判据的唯一守卫。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { detectHostVersion, isHost017Plus, supportsLastHitDock } from './host-version.ts'
+
+/** 造一个「装了指定版本 dsh」的临时 profile，返回它的 file: URL。 */
+function profileWithDsh(version: string | null): string {
+  const dir = mkdtempSync(join(tmpdir(), 'dshr-hostver-'))
+  if (version !== null) {
+    const pkgDir = join(dir, 'node_modules', '@deepseek-ai', 'dsh')
+    mkdirSync(pkgDir, { recursive: true })
+    writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: 'dsh', version }))
+  }
+  return pathToFileURL(dir).href + '/'
+}
+
+test('读得到版本：detectHostVersion 返回 profile 里装的 dsh 版本', () => {
+  assert.equal(detectHostVersion(profileWithDsh('0.1.5-rc.3')), '0.1.5-rc.3')
+  assert.equal(detectHostVersion(profileWithDsh('0.1.7-alpha.2')), '0.1.7-alpha.2')
+})
+
+test('支持位：>= 0.1.7 才为真（预发布标识忽略，按前导数字比）', () => {
+  assert.equal(supportsLastHitDock(profileWithDsh('0.1.7-alpha.2')), true)
+  assert.equal(supportsLastHitDock(profileWithDsh('0.1.7')), true)
+  assert.equal(supportsLastHitDock(profileWithDsh('0.2.0')), true)
+  assert.equal(supportsLastHitDock(profileWithDsh('1.0.0')), true)
+  // 低于 0.1.7 → 不挂（0.1.5 位置不对，宁可不显示）
+  assert.equal(supportsLastHitDock(profileWithDsh('0.1.5-rc.3')), false)
+  assert.equal(supportsLastHitDock(profileWithDsh('0.1.6-alpha.2')), false)
+  assert.equal(supportsLastHitDock(profileWithDsh('0.1.4')), false)
+})
+
+test('isHost017Plus 与徽章支持位同源（三处兼容分叉共用一个判据）', () => {
+  for (const v of ['0.1.7-alpha.2', '0.1.7', '0.2.0', '1.0.0']) {
+    assert.equal(isHost017Plus(profileWithDsh(v)), true, v)
+    assert.equal(supportsLastHitDock(profileWithDsh(v)), true, v)
+  }
+  for (const v of ['0.1.5-rc.3', '0.1.6-alpha.2', '0.1.4']) {
+    assert.equal(isHost017Plus(profileWithDsh(v)), false, v)
+    assert.equal(supportsLastHitDock(profileWithDsh(v)), false, v)
+  }
+})
+
+test('读不到版本 → 一律当不支持（不抛、宁可不显示）', () => {
+  assert.equal(detectHostVersion(profileWithDsh(null)), undefined)
+  assert.equal(supportsLastHitDock(profileWithDsh(null)), false)
+  // 垃圾版本号
+  assert.equal(supportsLastHitDock(profileWithDsh('not-a-version')), false)
+  // baseUrl 缺失（冷启动/单测）→ 回落 ~/.dsh/profiles/web，不抛
+  assert.doesNotThrow(() => supportsLastHitDock(undefined))
+})

package/src/host-version.ts

@@ -0,0 +1,101 @@
+/**
+ * 宿主 DSH 版本探测 —— **0.1.5 / 0.1.7 兼容分叉的唯一判据来源**。
+ *
+ * 原先三处兼容都靠「能力检测」（看方法/属性在不在），语义上是同一个问题
+ * ——「这是 0.1.7 还是更老」——却各检各的、还容易误判（插件自己 node_modules
+ * 里的依赖版本与宿主实际加载的版本并不一致：实测插件解析到 schemastery 3.18.4，
+ * profile 里却是 3.18.3、全局是 3.18.2）。所以统一改成**读宿主版本号**判定：
+ *
+ *   1. 「最近命中」徽章：composer.dock 在 0.1.5 渲染位置不对 → >= 0.1.7 才挂。
+ *   2. 设置命名空间：0.1.5 用 `settings.installSection` 注册；0.1.7 改由导出的
+ *      Config 驱动（无此方法）→ 按版本走对应注册路径。
+ *   3. adapter 的 tool-result 消息形态：0.1.5/0.1.6 = user 里的 'tool-result'
+ *      块；0.1.7+ = 独立 role:'tool' 消息。
+ *
+ * 读法：宿主把 profile 目录挂在 `ctx.baseUrl`（见 data-dir.ts）。本插件跑在宿主
+ * 进程内，`require.resolve('@deepseek-ai/dsh/package.json', { paths: [profile] })`
+ * 会沿 profile 的 node_modules 向上解析到全局安装根（实测命中 bun 全局目录）。
+ * 拿不到就回落直接拼路径，再不行就返回 undefined（按「不支持/老版本」处理，不抛）。
+ *
+ * 注意：**只能在 `apply(ctx)` 里用**（那时才有 baseUrl）。模块顶层（如 Config 导出）
+ * 解析到的是插件自己的依赖，不能代表宿主——那处保留能力检测，见 index.ts 注释。
+ */
+import { readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { join } from 'node:path'
+import { profileDirOf } from './data-dir.ts'
+
+/** 各兼容分叉的版本门槛。 */
+/** composer.dock 徽章 / 独立 role:'tool' 消息形态：0.1.7 起。 */
+const V0_1_7: readonly number[] = [0, 1, 7]
+
+/**
+ * 解析并比较 semver（只取前导数字段，预发布标识忽略）。
+ * `0.1.7-alpha.2` → [0,1,7]，`0.1.5-rc.3` → [0,1,5]。
+ * 返回负数/0/正数，语义同 `<`/`==`/`>`。
+ */
+function compareVersion(a: readonly number[], b: readonly number[]): number {
+  for (let i = 0; i < Math.max(a.length, b.length); i++) {
+    const x = a[i] ?? 0
+    const y = b[i] ?? 0
+    if (x !== y) return x - y
+  }
+  return 0
+}
+
+/** `0.1.7-alpha.2` → [0,1,7]；解析失败返回 null。 */
+function parseVersion(raw: string): number[] | null {
+  const m = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(raw.trim())
+  if (m === null) return null
+  return [Number(m[1]), Number(m[2] ?? 0), Number(m[3] ?? 0)]
+}
+
+/**
+ * 探测 profile 里安装的 DSH 宿主版本。
+ * @param baseUrl 宿主注入的 profile 锚点（`ctx.baseUrl`）
+ * @returns 形如 `0.1.7-alpha.2`；读不到返回 undefined（调用方按「不支持」处理）
+ */
+export function detectHostVersion(baseUrl?: string): string | undefined {
+  const profile = profileDirOf(baseUrl)
+  // 先走模块解析（能沿 node_modules 向上找到全局安装根），再回落直接拼路径。
+  const candidates: string[] = []
+  try {
+    candidates.push(createRequire(join(profile, 'noop.js')).resolve('@deepseek-ai/dsh/package.json'))
+  } catch {
+    // 解析不到就走下面的直接路径
+  }
+  candidates.push(join(profile, 'node_modules', '@deepseek-ai', 'dsh', 'package.json'))
+  for (const file of candidates) {
+    try {
+      const parsed = JSON.parse(readFileSync(file, 'utf8')) as { version?: unknown }
+      if (typeof parsed.version === 'string' && parsed.version !== '') return parsed.version
+    } catch {
+      // 换下一个候选
+    }
+  }
+  return undefined
+}
+
+/** 宿主版本是否 >= 门槛。读不到版本 → false（按老版本处理）。 */
+function atLeast(baseUrl: string | undefined, min: readonly number[]): boolean {
+  const v = detectHostVersion(baseUrl)
+  if (v === undefined) return false
+  const parsed = parseVersion(v)
+  if (parsed === null) return false
+  return compareVersion(parsed, min) >= 0
+}
+
+/**
+ * 宿主是否 >= 0.1.7。三处兼容分叉共用这一个判据：
+ *   - 「最近命中」徽章（composer.dock 位置正确）
+ *   - 设置命名空间（Config 驱动而非 installSection）
+ *   - adapter 的独立 role:'tool' 消息形态
+ */
+export function isHost017Plus(baseUrl?: string): boolean {
+  return atLeast(baseUrl, V0_1_7)
+}
+
+/** 「最近命中」徽章是否可用（= 宿主 >= 0.1.7）。 */
+export function supportsLastHitDock(baseUrl?: string): boolean {
+  return isHost017Plus(baseUrl)
+}

package/src/index.ts

@@ -42,6 +42,7 @@ 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'
+import { detectHostVersion, isHost017Plus, supportsLastHitDock } from './host-version.ts'
 import { ExtStore } from './ext/store.ts'
 import type { ExtInfo, ExtStoreService, RouterExt, RouterExtService } from './ext/contract.ts'
 
@@ -54,6 +55,34 @@ export const name = 'dsh-router-core'
 /** Services required before mounting: the webserver (routes) + llm (设置-模型). */
 export const inject = ['webServer', 'llm']
 
+/**
+ * `Config` 导出：让 Router 卡片进 0.1.7 的设置镜像。
+ *
+ * **这处刻意保留能力检测，不用宿主版本号** —— 与另两处兼容点（installSection /
+ * adapter 消息形态）不同。原因（已实测）：这是**模块顶层导出**，loader 一 import
+ * 就求值；而 schemastery 是本插件的**普通依赖**（`^3.18.4`，见 package.json），
+ * 解析到的是**插件自己 node_modules 里那一份**，跟宿主实际加载的版本无关
+ * （实测：插件解析到 3.18.4，而 profile 里是 3.18.3、全局是 3.18.2）。既然这里
+ * 拿不到宿主版本，就只剩「这份 Schema 实例到底有没有 `.volatile`」这个真问题 ——
+ * 能力检测恰好就是**对**的判据。
+ *
+ * 定位说明（非兼容分叉）：`.volatile()` 是 schemastery 3.18.4 才有的原型方法；
+ * 老版本上直写 `Schema.object({}).volatile()` 会 `.volatile` 为 undefined →
+ * 抛 TypeError → **整个插件加载失败**（不只是卡片，是 dsh-router 完全挂掉）。
+ *   - 有 volatile：走 volatile，空 object 不被 volatileForm 过滤 → 卡片进镜像；
+ *   - 无 volatile：回落普通空 schema，不抛；此时宿主必是 0.1.5，本就靠
+ *     installSection 出卡片（见下方按版本分流的注册），这个 Config 无副作用。
+ */
+const emptySchema = Schema.object({})
+const hasVolatile = typeof (emptySchema as { volatile?: unknown }).volatile === 'function'
+
+/**
+ * 0.1.7 的设置镜像只认「插件导出的 Config + 配置树行 id」这条收录链，且空 object
+ * 会被 volatileForm 过滤掉 —— 顶层 `.volatile()` 才能让 Router 卡片出现在设置-模型。
+ * Router 的真配置在自己的 state.json（路由系统面板），这里故意不暴露任何字段。
+ */
+export const Config = hasVolatile ? emptySchema.volatile() : emptySchema
+
 /** Minimal shape of the webServer service face used here. */
 interface WebServerRoute {
   kind: 'prefix' | 'exact'
@@ -96,12 +125,12 @@ interface Llm {
 }
 
 /**
- * 设置服务（`ctx.settings`，dsh-settings）的最小切面：本插件只用 `installSection`
- * 注册一个命名空间，让设置-模型页能列出 Router provider 卡片。dsh-settings 是
- * 宿主注入的 peer service，这里不深绑它的类型，只声明用到的这一个方法。
+ * 设置服务（`ctx.settings`，dsh-settings）的最小切面。0.1.5 用 `installSection`
+ * 注册命名空间；0.1.7 已移除该方法、改由插件导出的 Config 驱动 —— 故声明为可选，
+ * 调用处做能力检测（不是版本分支）。dsh-settings 是宿主注入的 peer service，不深绑类型。
  */
 interface SettingsServiceFace {
-  installSection: (
+  installSection?: (
     owner: CordisContext,
     ns: string,
     schema: unknown,
@@ -156,6 +185,8 @@ 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
+    /** cordis-plugin-loader 挂在 fiber 上的配置树锚点（tests 等环境可能没有）。 */
+    fiber?: { entry?: { options?: { id?: string } } }
     /** 配置树锚点 = profile 目录（宿主注入），用来把数据钉在 profile 里。 */
     baseUrl?: string
   }
@@ -166,6 +197,12 @@ export function apply(rawContext: unknown): void {
   const dataDir = dataDirOf(ctx.baseUrl)
   const stateFile = join(dataDir, 'state.json')
   log(`data dir: ${dataDir}`)
+  // 宿主版本探测：三处 0.1.5/0.1.7 兼容分叉共用这一个判据（徽章 / 设置命名空间 /
+  // adapter 的 tool-result 消息形态）。探测失败按老版本处理，不影响其它功能。
+  const hostVersion = detectHostVersion(ctx.baseUrl)
+  const host017Plus = isHost017Plus(ctx.baseUrl)
+  const lastHitDock = supportsLastHitDock(ctx.baseUrl)
+  log(`host version: ${hostVersion ?? '未知'} (>=0.1.7: ${host017Plus ? 'yes' : 'no'}, last-hit dock: ${lastHitDock ? 'on' : 'off'})`)
   const store = new SupplierConfigStore(stateFile)
   const credentials = new CredentialStore(join(dataDir, 'auths'))
   const router = new Router(stateFile, store, log)
@@ -323,8 +360,17 @@ export function apply(rawContext: unknown): void {
     const lv = typeof peek.reasoning_effort === 'string' && peek.reasoning_effort !== ''
       ? peek.reasoning_effort
       : 'auto'
+    // 宿主会话身份（adapter 从 GenerateOptions.sessionId 转来的内部头）；外部客户端没有。
+    const sessionRaw = req.headers['x-dsh-router-session']
+    const session = typeof sessionRaw === 'string' && sessionRaw !== '' ? sessionRaw : undefined
     await router.chatCompletions(
-      { rawBody: body, stream: !!peek.stream, model: typeof peek.model === 'string' ? peek.model : '', lv },
+      {
+        rawBody: body,
+        stream: !!peek.stream,
+        model: typeof peek.model === 'string' ? peek.model : '',
+        lv,
+        ...(session === undefined ? {} : { session }),
+      },
       res,
     )
   }))
@@ -335,6 +381,10 @@ export function apply(rawContext: unknown): void {
     const { suppliers } = router.status()
     writeJson(res, 200, {
       ok: true,
+      // 宿主版本 + 徽章支持位：客户端据此决定是否挂「最近命中」控件
+      // （composer.dock 在 0.1.5 渲染位置不对，只有 >= 0.1.7 才挂）。
+      hostVersion: hostVersion ?? '',
+      lastHitDock: lastHitDock,
       suppliers: suppliers.map((s) => {
         const loaded = loadedSuppliers.find((l) => l.supplier.id === s.id)
         return {
@@ -374,6 +424,38 @@ export function apply(rawContext: unknown): void {
     writeJson(res, 200, { ok: true })
   })
 
+  route(`${ROUTER_API_BASE}/last-hit`, (req, res) => {
+    // 最近一次被服务的请求：给输入框旁的小指示器用。
+    // `?session=` 给定时只在该会话内找（当前会话视角）；不给则退回全局最近。
+    // 附上连接显示别名与积分 —— 前端只读这一个端点，不打 status（重）。
+    const session = new URL(req.url ?? '/', 'http://localhost').searchParams.get('session') ?? undefined
+    const last = router.usage.lastHit(session)
+    if (last === undefined) {
+      writeJson(res, 200, { ok: true, hit: null })
+      return
+    }
+    const { suppliers } = router.status()
+    const owner = suppliers.find((s) => s.id === last.supplier)
+    const acct = owner?.accounts.find((a) => a.uid === last.uid)
+    // 连接名：**优先直接查 accountNames**（面板里配的显示别名），不依赖
+    // status 列表里有没有这个号 —— 号未上报/未加载时 status 里就没有它，
+    // 只靠 acct 会回落成 uid（显示成 cb-12 而不是 k8661）。
+    const named = last.uid === undefined || last.uid === '' ? undefined : store.getAccountName(last.supplier, last.uid)
+    writeJson(res, 200, {
+      ok: true,
+      hit: {
+        supplier: last.supplier,
+        model: last.model,
+        requested: last.requested,
+        uid: last.uid,
+        account: named ?? acct?.nickname ?? (last.uid === undefined || last.uid === '' ? undefined : last.uid),
+        credits: acct?.credits,
+        ok: last.ok,
+        ts: last.ts,
+      },
+    })
+  })
+
   route(`${ROUTER_API_BASE}/models`, async (_req, res) => {
     try {
       const models = await router.listModels()
@@ -392,26 +474,26 @@ export function apply(rawContext: unknown): void {
   })
 
   route(`${ROUTER_API_BASE}/combos/create`, async (req, res) => {
-    let body: { name?: string; strategy?: string; models?: string[] }
+    let body: { name?: string; models?: string[] }
     try {
-      body = JSON.parse(await readBody(req, 64 << 10)) as { name?: string; strategy?: string; models?: string[] }
+      body = JSON.parse(await readBody(req, 64 << 10)) as { name?: string; models?: string[] }
     } catch {
       writeJson(res, 400, { ok: false, error: 'invalid JSON body' })
       return
     }
-    const result = router.createCombo(body.name ?? '', body.strategy ?? 'fallback', body.models ?? [])
+    const result = router.createCombo(body.name ?? '', body.models ?? [])
     writeJson(res, result.ok ? 200 : 400, result)
   })
 
   route(`${ROUTER_API_BASE}/combos/update`, async (req, res) => {
-    let body: { id?: string; name?: string; strategy?: string; models?: string[] }
+    let body: { id?: string; name?: string; models?: string[] }
     try {
-      body = JSON.parse(await readBody(req, 64 << 10)) as { id?: string; name?: string; strategy?: string; models?: string[] }
+      body = JSON.parse(await readBody(req, 64 << 10)) as { id?: string; name?: string; models?: string[] }
     } catch {
       writeJson(res, 400, { ok: false, error: 'invalid JSON body' })
       return
     }
-    const result = router.updateCombo(body.id ?? '', body.name ?? '', body.strategy ?? 'fallback', body.models ?? [])
+    const result = router.updateCombo(body.id ?? '', body.name ?? '', body.models ?? [])
     writeJson(res, result.ok ? 200 : 400, result)
   })
 
@@ -535,34 +617,6 @@ export function apply(rawContext: unknown): void {
     writeJson(res, 200, { ok: true, enhancers: list })
   })
 
-  // ---- 扩展通用 API 转发：/router/api/ext/{id}/{subpath} → 该扩展器的 api() ----
-  // watch 这类自定义扩展用它暴露自己的面板接口（如 processes）。分开的 exact 路由
-  // `/ext`（上方）管开关列表；这里必须是 **prefix** 路由兜子路径（`route()` 是 exact,
-  // 匹配不了 `/ext/watch/processes`——用 exact 会造成 404 空 body → 前端 res.json() 崩）。
-  // 核心不知道子路径长什么样——是否处理、怎么处理全由扩展器自己裁决（执行面），核心只转发。
-  const extDispatch = ctx.webServer.register({
-    kind: 'prefix',
-    path: `${ROUTER_API_BASE}/ext/`,
-    handler: async (req, res) => {
-      const pathname = new URL(req.url ?? '/', 'http://localhost').pathname
-      const mount = `${ROUTER_API_BASE}/ext/`
-      const rest = pathname.startsWith(mount) ? pathname.slice(mount.length) : ''
-      const slash = rest.indexOf('/')
-      const extId = slash < 0 ? rest : rest.slice(0, slash)
-      const subpath = slash < 0 ? '' : rest.slice(slash + 1)
-      if (extId === '') {
-        writeJson(res, 404, { ok: false, error: 'extension not found' })
-        return
-      }
-      const ext = (exts[extId] as RouterExt | undefined)
-      if (ext !== undefined && typeof ext.api === 'function' && (await ext.api(subpath, req, res))) {
-        return // 扩展器已处理并写出响应
-      }
-      writeJson(res, 404, { ok: false, error: 'extension api not found' })
-    },
-  })
-  disposers.push(extDispatch)
-
   // ---- 概览看板：用量统计 ----
 
   /** 解析并校验周期参数（不接受任意字符串）。 */
@@ -590,7 +644,14 @@ export function apply(rawContext: unknown): void {
       bySupplier: s.bySupplier,
       byModel: s.byModel,
       byRequested: s.byRequested,
-      recent: router.usage.recentList(20),
+      // 「最近请求」的「连接」列要显示连接名（uid → 显示别名）。后端一次解析，
+      // 前端不必再拉 /status。无 uid（失败/未服务）→ 返回空串，前端显示「—」。
+      recent: router.usage.recentList(20).map((r) => ({
+        ...r,
+        connection: r.uid === undefined || r.uid === ''
+          ? ''
+          : store.getAccountName(r.supplier, r.uid) ?? r.uid,
+      })),
     })
   })
 
@@ -610,42 +671,55 @@ export function apply(rawContext: unknown): void {
 
   // ---- 设置-模型：Router 提供方（固定卡片，插件注册，不可删）+ 模型目录（= 组合） ----
 
+  // settings ns = 配置树行 id（cordis.patch.yml insert 的 id）—— 0.1.7 设置镜像按
+  // entry.options.id 收录；loader 未挂 entry 时回落到同一默认值，两版一个 ns。
+  const settingsNs = ctx.fiber?.entry?.options?.id ?? 'dsh-router'
+
   // llm 缺失时（如测试环境）跳过，不影响 /v1 核心。
   if (ctx.llm !== undefined) {
-    const LLM_NS = 'llm-dsh-router'
     try {
       const providerReg = ctx.llm.registerConfigurableProviders([
         {
           provider: 'router',
           displayName: 'Router',
-          settingsNs: LLM_NS,
+          settingsNs,
           settingsPath: [],
         },
       ])
       disposers.push(providerReg)
-      disposers.push(ctx.llm.registerModelDiscovery(LLM_NS, async () => {
+      disposers.push(ctx.llm.registerModelDiscovery(settingsNs, async () => {
         const combos = await router.combos()
         return combos.map((c) => ({ id: c.name }))
       }))
       // Router 的配置（组合/密钥/签到）存在 core 自己的 state.json，走插件自己的
-      // 「路由系统」面板；设置-模型 这边**仍必须注册 `llm-dsh-router` 命名空间**。
-      // 原因：设置-模型 的 provider 列表只渲染 settingsNs 能在设置镜像里解析出来的
-      // 行（见 dsh-client-ui-settings-models 的 configurable 过滤）。只调
-      // registerConfigurableProviders 而不注册 section，Router 卡片**不会出现**。
+      // 「路由系统」面板；设置-模型 这边必须让 settingsNs 在设置镜像里能解析出来
+      // （见 dsh-client-ui-settings-models 的 configurable 过滤），否则卡片不出现。
+      // 按宿主版本分流（不再靠 installSection 能力检测）：
+      //   0.1.7+：镜像行来自顶部导出的 volatile Config（ns = 行 id），无需注册；
+      //   0.1.5 ：镜像行来自 settings.installSection。
       // 空 schema = 卡片是入口/占位（该布局下不可提交），真正的配置在路由系统面板。
       const routerSettingsSchema = Schema.object({})
-      ctx.inject(['settings'], (sctx: unknown) => {
-        const settings = (sctx as { settings?: SettingsServiceFace }).settings
-        if (settings === undefined) {
-          log('settings service absent — skip Router settings-section registration')
-          return
-        }
-        settings.installSection(rawContext as CordisContext, LLM_NS, routerSettingsSchema, {}, {
-          setSource: () => {},
-          onChange: () => {},
+      if (isHost017Plus(ctx.baseUrl)) {
+        log(`settings section driven by exported Config (${settingsNs})`)
+      } else {
+        ctx.inject(['settings'], (sctx: unknown) => {
+          const settings = (sctx as { settings?: SettingsServiceFace }).settings
+          if (settings === undefined) {
+            log('settings service absent — skip Router settings-section registration')
+            return
+          }
+          if (settings.installSection === undefined) {
+            // 版本说该走 installSection 但它不在（异常宿主）：只记日志，不抛。
+            log(`settings.installSection absent despite 0.1.5 host (${settingsNs})`)
+            return
+          }
+          settings.installSection(rawContext as CordisContext, settingsNs, routerSettingsSchema, {}, {
+            setSource: () => {},
+            onChange: () => {},
+          })
+          log(`Router settings section registered (${settingsNs})`)
         })
-        log(`Router settings section registered (${LLM_NS})`)
-      })
+      }
       // adapter：模型目录自动带出组合；对话转发到本插件 /v1（组合路由在 /v1 内完成）。
       // 带上组合的上下文窗口：没有它 dsh 的自动压缩算不出阈值、会静默关闭。
       // 图片序列化需要读附件字节：把 ctx.attachments 传给 adapter（dsh-attachment
@@ -708,7 +782,7 @@ export function apply(rawContext: unknown): void {
       directory,
       registeredProviders,
       settingsNamespaces,
-      routerNamespaceRegistered: Array.isArray(settingsNamespaces) && settingsNamespaces.includes('llm-dsh-router'),
+      routerNamespaceRegistered: Array.isArray(settingsNamespaces) && settingsNamespaces.includes(settingsNs),
     })
   })
 

package/src/llm/adapter.test.ts

@@ -11,7 +11,7 @@
  */
 import { test } from 'node:test'
 import assert from 'node:assert/strict'
-import { EMPTY_RESPONSE_CODE } from '@deepseek-ai/dsh-llm'
+import { AssistantStreamAccumulator, EMPTY_RESPONSE_CODE } from '@deepseek-ai/dsh-llm'
 import { toTokenUsage } from '../router/usage-tokens.ts'
 import { RouterAdapter, translateSse } from './adapter.ts'
 
@@ -191,6 +191,59 @@ async function toolCallsOf(...payloads: string[]): Promise<Array<{ name?: string
   return out
 }
 
+test('工具调用：后续 delta 把 id/name 重发成 null 时，不能冲掉首帧也不许发 null', async () => {
+  // 真实事故（2026-09-22，OpenCode/Zen）：上游首帧给 id+name，后续分片帧把
+  // 它们**显式重发成 null**（不是省略、不是空串）。用对象构造、交给 frame() 序列化，
+  // 免得在字符串字面量里跟引号打架。
+  const tcDelta = (tc: unknown): string => frame({ choices: [{ delta: { tool_calls: [tc] } }] })
+  const payloads = [
+    tcDelta({ index: 0, id: 'call_abc', type: 'function', function: { name: 'bash', arguments: '' } }),
+    tcDelta({ index: 0, id: null, type: 'function', function: { name: null, arguments: '{' } }),
+    tcDelta({ index: 0, id: null, type: 'function', function: { name: null, arguments: '"command": "ls"}' } }),
+    frame({ choices: [{ delta: {}, finish_reason: 'tool_calls' }] }),
+    '[DONE]',
+  ]
+
+  // 旧判据是 `!== undefined`，null 通不过它却被当成真值：既把 "bash" 冲成 null，
+  // 又把 `name: null` 发进 StreamChunk。而真实运行路径
+  // （dsh-llm 的 AssistantStreamAccumulator.push）判据是
+  // `Object.hasOwn(chunk,'name') && typeof chunk.name !== 'string'` → 抛
+  // `TypeError: tool-call-delta name must be a string`（用户看到的
+  // 「本轮运行失败 tool-call-delta name must be a string」）。
+  //
+  // 用**真实的那个累加器**验收，而不是自己复述规则：它就是运行时会抛的那一段。
+  const acc = new AssistantStreamAccumulator()
+  let n = 0
+  for await (const chunk of translateSse(payloads)) {
+    acc.push({ time: n++, chunk }) // 这里就是线上抛错的那一步
+  }
+
+  // 逐条再按原判据过一遍，失败时能直接指向违规的那条 delta
+  for await (const chunk of translateSse(payloads)) {
+    if (chunk.type !== 'tool-call-delta') continue
+    if (Object.hasOwn(chunk, 'name')) assert.equal(typeof chunk.name, 'string', 'name 一旦出现就必须是字符串')
+    assert.equal(typeof chunk.id, 'string', 'id 必须是字符串')
+    assert.equal(typeof chunk.argumentsDelta, 'string', 'argumentsDelta 必须是字符串')
+  }
+
+  // 首帧给的 name/id 必须在后续 null 帧里**保持**
+  const deltas: Array<Record<string, unknown>> = []
+  for await (const chunk of translateSse(payloads)) {
+    if (chunk.type === 'tool-call-delta') deltas.push(chunk as unknown as Record<string, unknown>)
+  }
+  assert.ok(deltas.length >= 3, '三个分片帧都该产出 delta')
+  for (const d of deltas) {
+    assert.equal(d.name, 'bash', 'name 被后续 null 帧冲掉了（工具名会变成空）')
+    assert.equal(d.id, 'call_abc', 'id 被后续 null 帧冲掉了')
+  }
+
+  // 收尾后的完整调用也要正确
+  const calls = await toolCallsOf(...payloads)
+  assert.equal(calls.length, 1)
+  assert.equal(calls[0]?.name, 'bash', '工具名必须保住')
+  assert.equal(calls[0]?.arguments, '{"command": "ls"}')
+})
+
 test('工具调用：参数分片发完才收尾，完整 JSON 原样保留', async () => {
   const calls = await toolCallsOf(
     frame({ choices: [{ delta: { tool_calls: [{ index: 0, id: 'c1', function: { name: 'bash', arguments: '' } }] } }] }),
@@ -426,6 +479,80 @@ test('wire：空工具结果发空串，不伪造 (no output) 字面量', async
   assert.equal(tool?.content, '', '空结果就该是空串')
 })
 
+// 0.1.7+ 消息模型：tool 结果是**独立 role:"tool" 消息**、toolCallId 挂消息级，
+// ContentBlockMap 已无 'tool-result' 块。必须原样发 role:"tool"，否则工具结果被
+// 序列化成 role:"user"、夹在 assistant(tool_calls) 与 tool 之间，上游判定失配 → 400
+// code=11148。下面几条锁死新分支；老的 'tool-result' 块路径（≤0.1.6）仍有各自的用例。
+test('wire：0.1.7+ 独立 role:"tool" 消息序列化为 role:"tool"，正确带 tool_call_id', async () => {
+  const body = await captureBody({
+    messages: [
+      { role: 'assistant', content: [{ type: 'text', text: '' }, { type: 'tool-call', id: 'c1', name: 'bash', arguments: '{}' }] },
+      { role: 'tool', toolCallId: 'c1', content: [{ type: 'text', text: 'out' }] },
+    ],
+  })
+  const messages = body.messages as Array<{ role: string; tool_call_id?: string; content: unknown }>
+  const tool = messages.find((m) => m.role === 'tool')
+  assert.ok(tool, '0.1.7 tool 消息必须原样发 role:"tool"')
+  assert.equal(tool.tool_call_id, 'c1', 'tool_call_id 取自消息级 toolCallId')
+  assert.equal(tool.content, 'out', '纯文本重组为字符串')
+  assert.equal(messages.filter((m) => m.role === 'user').length, 0, '不容许被误序列化成 user 消息')
+})
+
+test('wire：0.1.7+ 独立 role:"tool" 消息不带图时不在其后插 user(图)', async () => {
+  // 图片才攒批补 user(图)；纯文本 tool 后面绝不能冒出 user，配对接续必须完整。
+  const body = await captureBody({
+    messages: [
+      { role: 'assistant', content: [{ type: 'text', text: '' }, { type: 'tool-call', id: 'a', name: 'bash', arguments: '{}' }] },
+      { role: 'tool', toolCallId: 'a', content: [{ type: 'text', text: 'x' }] },
+      { role: 'assistant', content: [{ type: 'text', text: 'done' }] },
+    ],
+  })
+  const messages = body.messages as Array<{ role: string }>
+  // 没有任何位置允许 user 夹在 tool 与下一 assistant 之间。
+  for (let i = 1; i < messages.length; i++) {
+    const m = messages[i]
+    assert.ok(m, `第 ${i} 条缺失`)
+    assert.notEqual(m.role, 'user', `第 ${i} 条不应该是 user（tool 配对接续被插断）`)
+  }
+})
+
+test('wire：0.1.7+ 空 tool 结果发空串（不伪造字面量）', async () => {
+  const body = await captureBody({
+    messages: [{ role: 'tool', toolCallId: 'c2', content: [] }],
+  })
+  const tool = (body.messages as Array<{ role: string; content: string }>).find((m) => m.role === 'tool')
+  assert.equal(tool?.content, '', '空结果该是空串')
+})
+
+/**
+ * tool 结果的两种形态**都必须序列化成 role:'tool'**，且分派只看消息形状、与宿主版本无关。
+ *
+ * 背景（实测）：同一宿主内两种形态都合法 —— 0.1.7 loop-built 走新形态
+ * （独立 role:'tool' 消息），而老会话历史经 session-format 迁移/重放时仍是旧形态
+ * （user 消息里的 'tool-result' 块）。所以 adapter 不能按版本号判形态对错，
+ * 只能按形状分派；这条锁死两种形状在**同一份 adapter**下产物一致。
+ */
+test('wire：tool-result 新/旧两种形态都序列化为 role:"tool"（按形状分派，与版本无关）', async () => {
+  const newShapeMsgs = [
+    { role: 'assistant', content: [{ type: 'text', text: '' }, { type: 'tool-call', id: 'c1', name: 'bash', arguments: '{}' }] },
+    { role: 'tool', toolCallId: 'c1', content: [{ type: 'text', text: 'out' }] },
+  ]
+  const oldShapeMsgs = [
+    { role: 'assistant', content: [{ type: 'text', text: '' }, { type: 'tool-call', id: 'c1', name: 'bash', arguments: '{}' }] },
+    { role: 'user', content: [{ type: 'tool-result', toolCallId: 'c1', content: [{ type: 'text', text: 'out' }] }] },
+  ]
+  // 新形态：原样发 role:'tool'
+  const n = await captureBody({ messages: newShapeMsgs })
+  const nt = (n.messages as Array<{ role: string; tool_call_id?: string }>).find((m) => m.role === 'tool')
+  assert.ok(nt, '新形态应发 role:"tool"')
+  assert.equal(nt.tool_call_id, 'c1')
+  // 旧形态：由 'tool-result' 块转出 role:'tool'（同样带 tool_call_id）
+  const o = await captureBody({ messages: oldShapeMsgs })
+  const ot = (o.messages as Array<{ role: string; tool_call_id?: string }>).find((m) => m.role === 'tool')
+  assert.ok(ot, '旧形态也应转出 role:"tool"')
+  assert.equal(ot.tool_call_id, 'c1')
+})
+
 /**
  * 为什么要有这一条：只不发 `block-end` **并不能**拦住残缺调用。
  *