dsh-router-core 0.3.21 → 0.4.1

package/src/client/supplier-visibility.test.ts

@@ -0,0 +1,57 @@
+/**
+ * 面板供应商可见性判据测试 —— 锁住三件事：
+ *   1. 关掉的卡片不出现（与扩展页同一形状）
+ *   2. 缺 `enabled` 按开着读（老核心没这个字段，不能让它们集体消失）
+ *   3. 空状态分「没装」与「全关掉」两种（装了却说暂无 = 说假话）
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { supplierVisibility, type SupplierSummary } from './supplier-visibility.ts'
+
+const s = (id: string, source: SupplierSummary['source'], enabled?: boolean): SupplierSummary => ({
+  id,
+  name: id,
+  ...(source === undefined ? {} : { source }),
+  ...(enabled === undefined ? {} : { enabled }),
+})
+
+test('关掉的供应商不出现在面板（卡片不出现）', () => {
+  const v = supplierVisibility([
+    s('codebuddy', 'external', true),
+    s('traework', 'external', false),
+    s('opencode', 'builtin', false),
+  ])
+  assert.deepEqual(v.external.map((x) => x.id), ['codebuddy'])
+  assert.deepEqual(v.builtin, [])
+  assert.equal(v.hidden, 2)
+})
+
+test('缺 enabled 按开着读 —— 老核心没有这个字段，不能让供应商集体消失', () => {
+  const v = supplierVisibility([s('codebuddy', 'external'), s('opencode', 'builtin')])
+  assert.deepEqual(v.external.map((x) => x.id), ['codebuddy'])
+  assert.deepEqual(v.builtin.map((x) => x.id), ['opencode'])
+  assert.equal(v.hidden, 0)
+  assert.equal(v.empty, undefined, '有卡片可列时不该有空状态')
+})
+
+test('按来源分组不串（内置 / 插件两组互不吞）', () => {
+  const v = supplierVisibility([
+    s('opencode', 'builtin', true),
+    s('codebuddy', 'external', true),
+    s('nvidia', 'builtin', true),
+  ])
+  assert.deepEqual(v.builtin.map((x) => x.id), ['opencode', 'nvidia'])
+  assert.deepEqual(v.external.map((x) => x.id), ['codebuddy'])
+})
+
+test('全关掉 ≠ 暂无：空状态必须说清去哪开回来', () => {
+  const v = supplierVisibility([s('codebuddy', 'external', false)])
+  assert.equal(v.empty?.reason, 'disabled')
+  assert.match(v.empty?.desc ?? '', /设置 → 插件 → dsh-router-core/,
+    '空状态要把用户指到开关所在处，否则用户以为插件坏了')
+})
+
+test('一个都没装才是「暂无供应商」', () => {
+  assert.equal(supplierVisibility([]).empty?.reason, 'none')
+  assert.equal(supplierVisibility([s('x', 'external', false), s('y', 'builtin', false)]).empty?.reason, 'disabled')
+})

package/src/client/supplier-visibility.ts

@@ -0,0 +1,63 @@
+/**
+ * 面板「供应商」页的可见性规则 —— 纯函数，不碰 React。
+ *
+ * 形状与插件页**刻意相反**：
+ *   - 面板（设置 → 路由 → 供应商）= **在用什么**的工作面，只列**开着**的；
+ *     关掉的卡片不出现（与「扩展」页同一形状）。
+ *   - 插件页（设置 → 插件 → dsh-router-core → 路由组件）= **控制面**，供应商组
+ *     列全部（含关掉的），否则关掉之后就再没有可点的开关能开回来。
+ *
+ * 为什么空状态要分两种：「暂无供应商」说的是**一个都没装**，而「都关掉了」是
+ * 装了但用户自己关的。两者共用一句「暂无供应商」就是说假话 —— 用户进面板发现
+ * 自己装的东西不见了，而真正的原因（开关在另一个页面关着）无处可寻。
+ *
+ * 抽出来是为了让「哪些卡片该出现」这条判据能被单测钉住：它一行就能写错，
+ * 而写错的表现是「面板说关了、请求照样打过去」或者「用户以为没装」。
+ */
+import type { RouterHealthResponse } from '../shared.ts'
+
+/** `/health` 里的一条供应商摘要（就地取型，不另抄一份形状）。 */
+export type SupplierSummary = NonNullable<RouterHealthResponse['suppliers']>[number]
+
+/** 面板要渲染的分组。 */
+export interface SupplierVisibility {
+  /** 随核心分发、且开着的。 */
+  builtin: SupplierSummary[]
+  /** 独立安装、且开着的。 */
+  external: SupplierSummary[]
+  /** 装过但被开关关掉的个数（不列卡片，但空状态要用它说明去哪开回来）。 */
+  hidden: number
+  /**
+   * 空状态文案。`undefined` = 不该显示空状态（有卡片可列）。
+   * `reason: 'none'` 是一个都没装；`reason: 'disabled'` 是装了但全被关掉。
+   */
+  empty?: { reason: 'none' | 'disabled'; title: string; desc: string }
+}
+
+/** 开关在插件页的固定位置 —— 空状态要把用户指过去，不然就断在这里了。 */
+const SWITCH_HOME = '设置 → 插件 → dsh-router-core'
+
+/**
+ * 按「开着与否 + 来源」把供应商分成面板要渲染的两组，并给出空状态该说什么。
+ *
+ * `enabled` 缺省按**开着**读（老核心没有这个字段）；只有明确的 `false` 才算关。
+ */
+export function supplierVisibility(suppliers: readonly SupplierSummary[]): SupplierVisibility {
+  const on = suppliers.filter((s) => s.enabled !== false)
+  const builtin = on.filter((s) => s.source !== 'external')
+  const external = on.filter((s) => s.source === 'external')
+  const hidden = suppliers.length - on.length
+  if (on.length > 0) return { builtin, external, hidden }
+  return {
+    builtin,
+    external,
+    hidden,
+    empty: hidden > 0
+      ? {
+        reason: 'disabled',
+        title: '供应商都已关闭',
+        desc: `开关在 ${SWITCH_HOME} 的「路由组件」一节；打开后会重新参与路由`,
+      }
+      : { reason: 'none', title: '暂无供应商', desc: '' },
+  }
+}

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
@@ -56,14 +55,17 @@ export interface RouterExt {
   readonly description?: string
   /** 卡片/详情图标的 logo URL（可选；缺省用默认图标）。 */
   readonly icon?: string
-  /** 当前运行时状态（ready + 不就绪时的说明）。 */
-  getState(): ExtState
   /**
-   * 通用扩展 API 点（可选）：核心把 `/router/api/ext/{id}/{subpath}` 兜底路由派发进来，
-   * 由扩展器自己裁决/处理（如 watch 的 `processes`/`kill`）。返回 true 表示已处理；
-   * false / 未实现 → 核心回 404。这样扩展的执行面逻辑进插件，核心只加一条通用转发。
+   * 这个扩展是**随核心分发**（`builtin`）还是**独立安装的插件**（不标 = plugin）。
+   *
+   * 为什么需要这个标记：随核心分发的扩展同时是插件页原生「包含的组件」里的**一行**
+   * （自带宿主管的开关），独立安装的扩展是各自 bundle 的行。插件页那个自绘的
+   * 「路由组件」节只该列后者 —— 与内置供应商的处理完全一样：已经有原生行的东西，
+   * 再在下面列一遍就是同一个东西显示两处。
    */
-  api?(subpath: string, req: IncomingMessage, res: ServerResponse): boolean | Promise<boolean>
+  readonly source?: 'builtin'
+  /** 当前运行时状态（ready + 不就绪时的说明）。 */
+  getState(): ExtState
   /** 卸载清理（表删除时由 dsh-router 调用，可选）。 */
   dispose?(): void
 }

package/src/ext-test/ext-test.test.ts

@@ -0,0 +1,60 @@
+/**
+ * 插件自检扩展（`router.ext` 侧）测试 —— 锁住三件事：
+ *   1. 登记进 `router.ext` 表，带上可显示的身份（名字/说明/就绪）；
+ *   2. **幂等**：同一个 id 已在表里就不顶掉别人的登记；
+ *   3. 恒为就绪 —— 自检能力不依赖外部二进制，不该提前否决（真跑一次才知道）。
+ *
+ * 为什么测这个：扩展的「卡片出现与否」完全取决于它在不在这张表里，而表是核心
+ * provide 的**同一个 live 对象**。登记没发生的话，面板与插件页都看不到它，且不报错。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { createTestExt, EXT_TEST_ID } from './plugin.ts'
+import { apply, name as CORDIS_NAME } from './index.ts'
+import type { RouterExtService } from '../ext/contract.ts'
+
+test('扩展器带上面板要用的身份，且恒为就绪', () => {
+  const ext = createTestExt()
+  assert.equal(ext.id, EXT_TEST_ID)
+  assert.equal(ext.name, '插件自检')
+  assert.ok((ext.description ?? '').length > 0, '没有说明，插件页那一行就没有副标题')
+  assert.equal(ext.getState().ready, true, '自检不依赖本机二进制，不该报未就绪')
+})
+
+test('cordis 身份是行 id（与 patch 里声明的逐字相同，否则 loader 认不出）', () => {
+  assert.equal(CORDIS_NAME, 'dsh-router-ext-test')
+})
+
+/** 最小 ctx：inject 立刻回调、emit 记下来。 */
+function fakeCtx(table: RouterExtService): {
+  ctx: Parameters<typeof apply>[0]
+  events: string[]
+} {
+  const events: string[] = []
+  return {
+    events,
+    ctx: {
+      inject: (deps: string[], cb: (sctx: unknown) => void) => {
+        cb({ get: (key: string) => (key === 'router.ext' ? table : undefined) })
+      },
+      emit: (event: string) => { events.push(event) },
+    } as unknown as Parameters<typeof apply>[0],
+  }
+}
+
+test('apply 把扩展登记进 router.ext 表（这张表就是「卡片出现」的唯一依据）', () => {
+  const table: RouterExtService = {}
+  const { ctx, events } = fakeCtx(table)
+  apply(ctx)
+  assert.equal(table[EXT_TEST_ID]?.name, '插件自检')
+  assert.deepEqual(events, [], '核心持有同一个 live 对象且每次请求现读，不需要广播事件')
+})
+
+test('幂等：同一个 id 已在表里时不顶掉别人的登记', () => {
+  const table: RouterExtService = {}
+  const { ctx } = fakeCtx(table)
+  apply(ctx)
+  const first = table[EXT_TEST_ID]
+  apply(ctx)
+  assert.equal(table[EXT_TEST_ID], first, '重复登记不该换成一个新对象')
+})

package/src/ext-test/index.ts

@@ -0,0 +1,35 @@
+/**
+ * 插件自检扩展的 **cordis 行** —— 官方插件页（设置 → 插件 → dsh-router-core）详情页
+ * 原生「包含的组件」里的那一行。
+ *
+ * 壳存在的理由与内置供应商那三层一样：`plugin.ts` 已经把 `name` 用作**面板显示名**
+ * （扩展契约的字段，所有扩展都这么写），而 cordis 的插件身份也要一个 `name`，两者抢
+ * 同一个名字。所以行 = 这一层壳（cordis 身份 + 登记），实现 = `plugin.ts`。
+ *
+ * **默认关闭**（patch 里 `disabled: true`）：行关闭时 loader 根本不 import 这个模块，
+ * 扩展也就没进 `router.ext` 表 —— 所以「打开才出现这张卡片」是天然的，不需要额外的
+ * 状态位。用户在这一行打开后，卡片出现在插件页的「路由组件 → 扩展」组与面板的
+ * 「扩展」页。
+ *
+ * 登记时把扩展开关置为开：本扩展**没有独立的运行期开关**，它的开关就是这一行
+ * （宿主管的那个）。不置上的话，用户开了行还要再点一次，两级开关说同一件事。
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import { currentExts, currentExtStore } from '../ext/contract.ts'
+import { createTestExt, EXT_TEST_ID } from './plugin.ts'
+
+/** cordis 插件身份（配置树里这一行的技术名；显示名走同目录的 locale）。 */
+export const name = 'dsh-router-ext-test'
+
+/** 登记本扩展。幂等：同一个 id 已在表里就直接返回，不顶掉别人的登记。 */
+export function apply(ctx: Context): void {
+  ctx.inject(['router.ext'], (sctx) => {
+    const table = currentExts(sctx)
+    if (table === undefined) return
+    if (table[EXT_TEST_ID] !== undefined) return
+    table[EXT_TEST_ID] = createTestExt()
+    currentExtStore(sctx)?.setEnabled(EXT_TEST_ID, true)
+    // 核心持有的是**同一个 live 对象**（它 provide 的空表），且 `/ext` 每次请求都
+    // 现读这张表 —— 所以往里 append 就够了，不需要（也不存在）广播事件。
+  })
+}

package/src/ext-test/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Plugin self-check",
+    "description": "Run a real access test against a supplier/model/connection, or run a contract check over an external supplier plugin (every member: implemented / usable / not executed)"
+  }
+}

package/src/ext-test/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "插件自检",
+    "description": "选供应商、模型与连接跑一次真实访问测试；或对外部供应商插件做契约体检，逐个成员报告实现与可用情况"
+  }
+}

package/src/ext-test/plugin.ts

@@ -0,0 +1,34 @@
+/**
+ * 插件自检扩展（`router.ext` 侧的实现）—— 声明与状态都在这里，**不做任何拦截**。
+ *
+ * 它和 rtk 那类扩展的区别要写清楚：本扩展**不挂任何监听、不改写任何命令**，
+ * 唯一作用是让用户在官方插件页里打开一块自检面板（选供应商 / 模型 / 连接，跑一次
+ * 真实的访问测试并看到底报了什么）。所以它复用 `router.ext` 这条通道只是为了拿到
+ * **发现 + 开关**两件事，而不是为了拦截。
+ *
+ * 面板本身在浏览器侧（`src/client/ExtTestPanel.tsx`），通过原生行的
+ * `plugins.row.config` 座位挂在「包含的组件」里那一行的详情页上；这里只负责让它在
+ * 列表里有个身份、以及报出运行时就绪状态。
+ */
+import type { RouterExt } from '../ext/contract.ts'
+
+/** 扩展开关表里的注册键（也是 URL 面板读它的 id）。 */
+export const EXT_TEST_ID = 'test'
+
+/**
+ * 构造这个扩展器。
+ *
+ * `getState()` 恒为就绪：自检能力不依赖外部二进制（不像 rtk 需要本机装 rtk），
+ * 「能不能测」取决于用户选的供应商/模型/连接，不该由扩展提前否决 —— 真跑一次
+ * 才知道，那时错误信息比一个「未就绪」有用得多。
+ */
+export function createTestExt(): RouterExt {
+  return {
+    id: EXT_TEST_ID,
+    name: '插件自检',
+    description: '选供应商、模型与连接跑一次真实访问测试；或对外部供应商插件做契约体检，逐个成员报告实现与可用情况',
+    // 随核心分发 -> 插件页的原生「包含的组件」里有它一行，自绘节里不再重复列。
+    source: 'builtin' as const,
+    getState: () => ({ ready: true }),
+  }
+}

package/src/ext-test/row.json

@@ -0,0 +1,5 @@
+{
+  "name": "dsh-router-core-ext-test",
+  "type": "module",
+  "description": "插件自检扩展（随 dsh-router 核心分发）"
+}

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)
+}