dsh-router-core 0.4.7 → 0.4.8

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

@@ -722,15 +722,14 @@ test('组合窗口：模型都没报 context_length → undefined', async () =>
  * 面板的「已禁用」列表于是空了。曾想过在核心按配置把缺的 id 补回来，**这是错的**：
  *
  *  1. 那是替有问题的插件擦屁股，插件永远不会被修；
- *  2. 更糟的是**它会把体检的越权检测一起掩盖掉** —— 模型被补全之后，
- *     probe.ts 的 hiddenDisabledIds 找不到「少报的 id」，报告变成 OK，
- *     第三方那个 bug 就再也没人知道了。
+ *  2. 更糟的是**它把症状掩盖掉** —— 模型被补全之后页面上一切正常，那个 bug
+ *     就再也没人发现了。
  *
- * 所以核心只负责：自己不合并不掩饰（插件少报就是少报），并让体检把违约报出来。
+ * 所以核心只负责：自己不合并不掩饰（插件少报就是少报），让症状留在页面上。
  * 下面两条判据钉住这个方向，防止以后有人（我）再犯同样的错。
  */
 
-test('核心不替违约插件补回已禁用的模型（要留着证据给体检）', async () => {
+test('核心不替违约插件补回已禁用的模型（症状要留在页面上）', async () => {
   const router = new Router('')
   const a = supplier('a', [{ id: 'a-1' }, { id: 'a-2' }])
   // 越权实现：listModels 自己过滤掉了已禁用的
@@ -740,7 +739,7 @@ test('核心不替违约插件补回已禁用的模型（要留着证据给体
 
   const models = await router.modelsOf('a')
   assert.deepEqual(models.map((m) => m.id), ['a-1'],
-    '核心不该把插件藏掉的模型补回来 —— 补回来就等于替它兜底，越权检测也会失效')
+    '核心不该把插件藏掉的模型补回来 —— 补回来就等于替它兜底，症状被掩盖就再没人修')
 })
 
 test('正常供应商（listModels 全量返回）：列表内容与启用状态照旧', async () => {

package/src/router/supplier-switch.test.ts

@@ -164,7 +164,7 @@ test('没记录过的供应商默认开着（升级不把全灭变成全开）',
   assert.equal(router.isEnabled('supA'), true)
 })
 
-// ---- 指定连接自检（插件自检面板的连接测试用它） ----
+// ---- 指定连接自检（诊断单个链接到底通不通） ----
 // 面板「供应商」详情里的「测试」按钮走账号池（任选可用号、失败自动换号）；
 // 面板的连接测试可以**钉死一个连接**，用来诊断单个链接到底通不通。关键性质：
 // 指定了连接就**不回退**到别的号，否则「测这个连接」测出来的是另一个号的结果。

package/src/suppliers/registry.ts

@@ -3,7 +3,6 @@
  *
  * 通用能力（dsh-router 核心，所有供应商自动可用，js 无需实现）：
  *   GET    /suppliers/:id/models                  models + alias（listModels 合并启用状态）
- *   POST   /suppliers/:id/probe                  契约体检：逐成员报「实现/可用/不执行」
  *   PATCH  /suppliers/:id/enabled                 {enabled} —— 供应商开关（关掉不参与路由）
  *   POST   /suppliers/:id/models/toggle           {id, enabled}
  *   POST   /suppliers/:id/models/add              {id}
@@ -26,7 +25,6 @@ import type { Router } from '../router/index.ts'
 import type { ModelWithEnabled, SupplierStatus } from '../router/types.ts'
 import type { SupplierConfigStore } from '../supplier-config.ts'
 import type { LoadedSupplier } from './loader.ts'
-import { probeSupplier } from './probe.ts'
 
 /** webServer 路由形状（与 index.ts 的 WebServerRoute 一致）。 */
 export interface WebServerRoute {
@@ -170,75 +168,6 @@ export function supplierRoutes(base: string, loaded: LoadedSupplier, store: Supp
     },
   })
 
-  // ---- 契约体检（只跑只读成员；有副作用的只报存在性）----
-  routes.push({
-    kind: 'exact',
-    path: `${p}/probe`,
-    handler: async (req, res) => {
-      if (req.method !== 'POST') {
-        writeJson(res, 405, { ok: false, error: 'probe requires POST' })
-        return
-      }
-      try {
-        // body 可空；只用来选模型/连接（不选就用第一个可用的）
-        let pick: { model?: string; uid?: string } = {}
-        const raw = (await readBody(req)).trim()
-        if (raw !== '') {
-          const body = JSON.parse(raw) as { model?: unknown; uid?: unknown }
-          pick = {
-            ...(typeof body.model === 'string' ? { model: body.model } : {}),
-            ...(typeof body.uid === 'string' ? { uid: body.uid } : {}),
-          }
-        }
-        // 模型启用状态走 router.modelsOf（核心缓存，不额外打上游）
-        const models = await router.modelsOf(s.id).catch(() => undefined)
-        const report = await probeSupplier(loaded, {
-          models,
-          // **实跑「全部禁用 → 看列表 → 全部启用」，验完还原。**
-          //
-          // 这是体检里唯一能抓出「插件在 listModels 里过滤已禁用模型」越权的路径：
-          // 违规插件把已禁用的藏起来，于是全部禁用之后核心一个模型都看不到，
-          // 用户点「全部启用」也就再也点不回来（没有 id 可传）。
-          // 还原写在 finally —— 体检不该在用户配置上留痕，哪怕中间抛了。
-          runBulkToggleRoundTrip: async () => {
-            const original = [...store.get(s.id).disabled]
-            const before = await router.modelsOf(s.id)
-            const ids = before.map((mm) => mm.id)
-            if (ids.length === 0) return { ok: true, detail: '该供应商没有模型，跳过' }
-            try {
-              store.setAllModelsEnabled(s.id, false, ids)
-              router.invalidateModels(s.id)
-              const after = await router.modelsOf(s.id, true)
-              const hidden = after.filter((mm) => !mm.enabled).length
-              const missing = ids.length - after.length
-              if (hidden !== ids.length || missing !== 0) {
-                return {
-                  ok: false,
-                  // 一句话说完：现象 + 归因。细说留给源码与提交记录，面板上不占地方。
-                  detail: `全部禁用后只剩 ${after.length}/${ids.length} 个 —— 插件在 listModels 里藏了已禁用的模型（启用状态由核心合并）`,
-                }
-              }
-              return { ok: true, detail: `全部禁用后 ${after.length} 个都在，再启用可恢复` }
-            } finally {
-              store.setAllModelsEnabled(s.id, true, ids)
-              for (const id of original) store.setAllModelsEnabled(s.id, false, [id])
-              router.invalidateModels(s.id)
-              await router.modelsOf(s.id, true)
-            }
-          },
-          // chatOnce 真跑一次：账号遍历 / 冷却 / 首字节预算都走真实路径
-          runChatOnce: async (model) => {
-            const r = await router.testModel(s.id, model, pick.uid)
-            return { ok: r.ok, detail: r.ok ? '通了' : (r.error ?? '上游没给原因') }
-          },
-        })
-        writeJson(res, 200, { ok: true, report })
-      } catch (err) {
-        writeJson(res, 500, { ok: false, error: (err as Error).message })
-      }
-    },
-  })
-
   // ---- 通用: alias ----
   routes.push({
     kind: 'exact',

package/lib/contract-D4BWZ7Xe.js

@@ -1,13 +0,0 @@
-//#region src/ext/contract.ts
-/** 读取当前 router.ext 表（同一 live 对象，可追加）——扩展插件用它注册自己。 */
-function currentExts(ctx) {
-	const c = ctx;
-	return c.get?.("router.ext") ?? c.router?.ext;
-}
-/** 读取扩展存储服务——扩展插件用它读开关、读写自己存的数据。 */
-function currentExtStore(ctx) {
-	const c = ctx;
-	return c.get?.("router.extStore") ?? c.router?.extStore;
-}
-//#endregion
-export { currentExts as n, currentExtStore as t };

package/lib/ext-test/index.js

@@ -1,36 +0,0 @@
-import { n as currentExts, t as currentExtStore } from "../contract-D4BWZ7Xe.js";
-//#region src/ext-test/plugin.ts
-/** 扩展开关表里的注册键（也是 URL 面板读它的 id）。 */
-const EXT_TEST_ID = "test";
-/**
-* 构造这个扩展器。
-*
-* `getState()` 恒为就绪：自检能力不依赖外部二进制（不像 rtk 需要本机装 rtk），
-* 「能不能测」取决于用户选的供应商/模型/连接，不该由扩展提前否决 —— 真跑一次
-* 才知道，那时错误信息比一个「未就绪」有用得多。
-*/
-function createTestExt() {
-	return {
-		id: EXT_TEST_ID,
-		name: "插件自检",
-		description: "选供应商、模型与连接跑一次真实访问测试；或对外部供应商插件做契约体检，逐个成员报告实现与可用情况",
-		source: "builtin",
-		getState: () => ({ ready: true })
-	};
-}
-//#endregion
-//#region src/ext-test/index.ts
-/** cordis 插件身份（配置树里这一行的技术名；显示名走同目录的 locale）。 */
-const name = "dsh-router-ext-test";
-/** 登记本扩展。幂等：同一个 id 已在表里就直接返回，不顶掉别人的登记。 */
-function apply(ctx) {
-	ctx.inject(["router.ext"], (sctx) => {
-		const table = currentExts(sctx);
-		if (table === void 0) return;
-		if (table["test"] !== void 0) return;
-		table[EXT_TEST_ID] = createTestExt();
-		currentExtStore(sctx)?.setEnabled(EXT_TEST_ID, true);
-	});
-}
-//#endregion
-export { apply, name };

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

@@ -1,6 +0,0 @@
-{
-  "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/lib/ext-test/locale/zh.json

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

package/lib/ext-test/package.json

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

package/lib/types/ext-test/index.d.ts

@@ -1,21 +0,0 @@
-/**
- * 插件自检扩展的 **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';
-/** cordis 插件身份（配置树里这一行的技术名；显示名走同目录的 locale）。 */
-export declare const name = "dsh-router-ext-test";
-/** 登记本扩展。幂等：同一个 id 已在表里就直接返回，不顶掉别人的登记。 */
-export declare function apply(ctx: Context): void;

package/lib/types/ext-test/plugin.d.ts

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

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

@@ -1,160 +0,0 @@
-import type { LoadedSupplier } from './loader.ts';
-/**
- * 体检只有**一档，全自动**。
- *
- * 前提由使用者保证：连接池里已经有一个可用的 token。所以「每个功能到底通不通」这个问题
- * 是可以被回答的 —— 于是能跑的就都跑掉：
- * - 没有副作用的成员直接实跑；
- * - 有副作用但可以用**无害探针输入**跑通代码路径的也实跑（`removeLink` 传不存在的
- *   uid、`completeLogin` 传无效回调 URL、`generateLoginUrl` 直接调）；
- * - 需要真实账号/真实额度的也实跑（`chatOnce` 走 `router.testModel` 真发一次、
- *   `checkinNow` 对连接池里的真实连接签到）；
- * - 会破坏体检前提的（`dispose` 卸载自己、`addApiKey` 写凭证…）**不进清单** ——
- *   见 `PROBE_EXCLUDED_MEMBERS`，逐个写了不测的理由。
- *
- * 报告的每个成员都标 `executed`：体检的价值全在「哪些是验过的、哪些只是看了一眼」。
- */
-export type ProbeExecuted = 'ran' | 'no';
-/** 这个成员是不是有副作用的（`skip` = 需要特别处理：要么探针实跑，要么只报存在性）。 */
-export type ProbeKind = 'safe' | 'skip';
-/** 一个契约成员的体检条目。 */
-export interface ProbeMember {
-    /** 契约里的成员名（与 `SupplierModule` 逐字一致）。 */
-    key: string;
-    /** 面板显示名。 */
-    label: string;
-    /** 必填成员 / 可选（差异化）成员。 */
-    required: boolean;
-    probe: ProbeKind;
-    /** 不自动执行的原因（`probe: 'skip'` 时必填，面板要显示给用户看）。 */
-    skipReason?: string;
-}
-/**
- * 结果里一条成员的最终状态。
- *
- * `unverified` 与 `fail` 必须分开：**没条件验**（没有 token、没有已启用模型、连接池
- * 为空）不是插件的毛病。压成 fail 会让「用户还没放 token」被出厂结论判成不合格 ——
- * 体检最忌讳把「没测到」说成「测出问题」。
- */
-export type ProbeState = 'ok' | 'fail' | 'absent' | 'unverified';
-export interface ProbeResult {
-    key: string;
-    label: string;
-    required: boolean;
-    present: boolean;
-    state: ProbeState;
-    /** 到底跑没跑。`no` 时 `detail` 写清为什么。 */
-    executed: ProbeExecuted;
-    /** 摘要/失败原因；`executed: 'no'` 时这里是「为什么没跑」。 */
-    detail?: string;
-}
-/** 体检的外部输入：模型启用状态 + 跑一次真实 `chatOnce` 的入口。 */
-export interface ProbeInput {
-    /** 该供应商当前的模型启用状态（调用方用 `router.modelsOf` 取，走核心缓存）。 */
-    models?: ReadonlyArray<{
-        id: string;
-        enabled: boolean;
-    }>;
-    /**
-     * 跑一次真实调用（`router.testModel`：账号遍历 + 冷却 + 首字节预算都生效）。
-     * 调用方决定用哪个模型 / 哪个连接。取不到模型时可以不提供 —— 报告里会写明
-     * 「无法验证」而不是假装通过。
-     */
-    runChatOnce?: (model: string) => Promise<{
-        ok: boolean;
-        detail: string;
-    }>;
-    /**
-     * **真跑一遍「全部禁用 → 全部启用」并还原**。
-     *
-     * 这不是「只报可用性」—— 它就是体检里能测出「插件在 listModels 里过滤已禁用模型」
-     * 越权的那条路径：核心把全部模型标成停用，再拉一次模型列表，**被藏起来的就露馅**
-     * （插件以为该藏，核心却必须还能看见它们，否则面板的「已禁用」列表会空、用户再也
-     * 看不到自己禁用过什么）。
-     *
-     * 由调用方实现，**必须自己还原**（体检不该在用户配置上留痕）。
-     */
-    runBulkToggleRoundTrip?: () => Promise<{
-        ok: boolean;
-        detail: string;
-    }>;
-}
-/**
- * **核心侧**能力：不属于插件契约（插件不实现它们，是核心代劳），所以不在上面的
- * 成员表里 —— 但体检要看它们的状态。模型启用/禁用就是这一类。
- */
-export interface ProbeCoreReport {
-    models: {
-        /** 模型总数；`listModels` 失败时为 null（= 拿不到，不代表 0 个）。 */
-        total: number | null;
-        enabled: number;
-        disabled: number;
-        /** 拿不到总数时的原因。 */
-        note?: string;
-    };
-    /** 核心代劳的操作：**只报可用性，一律不自动执行**（改了就是替用户改配置）。 */
-    /**
-     * 核心代劳的能力区。**「全部启用 / 全部禁用」是实跑的**（并还原）：它既是面板上
-     * 真实存在的操作，也是体检唯一能验出「插件私自过滤已禁用模型」的办法。
-     */
-    operations: Array<{
-        key: string;
-        label: string;
-        ran: boolean;
-        ok?: boolean;
-        detail?: string;
-    }>;
-}
-export interface ProbeReport {
-    supplier: string;
-    name: string;
-    /** 出厂结论：`fail` = 必填成员缺失/实跑失败；`warn` = 可选能力缺或没实跑；`pass` = 全绿。 */
-    members: ProbeResult[];
-    core: ProbeCoreReport;
-    summary: {
-        total: number;
-        implemented: number;
-        ok: number;
-        fail: number;
-        absent: number;
-        /** 实现了但没验（任何输入都会毁掉体检前提）。 */
-        unverified: number;
-        /** 实际实跑过的成员数（`executed !== 'no'`）。 */
-        ran: number;
-        /** 核心区「全部启用/全部禁用」实跑的结果（抓插件越权的那条路）。 */
-        bulk: 'ok' | 'fail' | 'unverified';
-    };
-}
-/**
- * 契约成员清单（体检的唯一事实来源）。
- *
- * `required: false` = 差异化能力，按存在性暴露端点/UI；`probe: 'skip'` 的理由都写在这里，
- * 面板会把 `skipReason` 原样显示 —— 用户能知道「有这个能力，只是体检不替你调」。
- */
-export declare const SUPPLIER_CONTRACT_MEMBERS: readonly ProbeMember[];
-/**
- * **故意不列进体检清单的成员**（不是「不跑」，是**不在报告里出现**）：
- *
- * - `completeLogin`：需要一个真实回调 URL 才跑得通，体检拿不到 —— 跑了也只是验
- *   「无效 URL 会不会抛错」，那不是功能是否可用。
- * - `addApiKey`：需要一个真实 API key，自动造一个只会往凭证库写垃圾。
- * - `removeLink`：用不存在的 uid 去试，它当然返回 false —— 那是**正常响应**，
- *   判成失败是体检自己错判功能有问题（踩过）。真要验它只能删一个真连接。
- * - `pollLogin`：只读一个布尔标记，验它通不通没有意义。
- * - `generateLoginUrl`：可能直接触发设备码 / OAuth 登录流，会在上游留下待处理的会话。
- *
- * 保留在清单里、逐条占行、只为说「没验」，是在用篇幅淹掉真问题。
- * 但**契约里加了新成员，体检要能报出来** —— `probe.test.ts` 有一条判据解析
- * `contract.ts` 断言「除了这份有意排除的名单之外必须全覆盖」。
- */
-export declare const PROBE_EXCLUDED_MEMBERS: Record<string, string>;
-/**
- * 体检一个已装载的供应商。
- *
- * 只跑 `probe: 'safe'` 的成员；`skip` 的只报存在性。绝不代替用户调有副作用的成员。
- *
- * @param models - 该供应商当前的模型启用状态（由调用方用 `router.modelsOf` 取，
- *   走核心缓存不额外打上游）。取不到就传 undefined —— 报告里会如实写「拿不到」，
- *   不能拿 0 冒充「一个模型都没有」。
- */
-export declare function probeSupplier(loaded: LoadedSupplier, input?: ProbeInput): Promise<ProbeReport>;