@dsh-plus/llm-pi 0.1.42 → 0.1.44

package/src/client/views/provider-fields.tsx

@@ -11,7 +11,7 @@ import {
   BUDGET_KEYS,
   CACHE_RETENTION_OPTIONS,
   MODALITIES,
-  PROTOCOL_IDS,
+  protocolOptions,
   THINKING_LEVELS,
   TRANSPORT_OPTIONS,
 } from '../constants.ts'
@@ -158,7 +158,7 @@ export function ProviderSelectFields(props: ProviderScalarFieldsProps): ReactEle
         id={`${props.id}-api`}
         label={t('api')}
         value={draft.api}
-        options={PROTOCOL_IDS}
+        options={protocolOptions()}
         unsetLabel={t('compatUnset')}
         disabled={props.disabled === true}
         onEdit={(value) =>

package/src/client/views/providers.tsx

@@ -1,7 +1,8 @@
 /**
- * Provider 路由编辑：每个 route 一张可折叠小节（键名 + 标量字段 +
- * headers 键值对 + retryPolicy JSON + compat + 模型目录）。
- * 支持新增 route（输入键名）与删除 route。
+ * Provider 路由编辑：每个 route 一张**受控**折叠小节（展开态由卡片持有，
+ * 以便「从内置目录添加」后自动展开目标 route、以及卡片级"全部收起"）。
+ * 小节内容：基础字段 + 请求头 + 高级设置（其余字段 / retryPolicy / compat）
+ * + 模型目录（行默认折叠，见 views/models.tsx）。
  * @module llm-pi/client/views/providers
  */
 
@@ -18,17 +19,25 @@ import { ProviderScalarFields, ProviderSelectFields } from './provider-fields.ts
 
 export interface ProvidersSectionProps {
   providers: Record<string, ProviderDraft>
+  /** route → 展开态（卡片持有；缺失即收起）。 */
+  openRoutes: Record<string, boolean>
   epoch: number
   disabled?: boolean
   t: Translate
   onAddRoute(key: string): void
   onRemoveRoute(route: string): void
   onPatchProvider(route: string, patch: Partial<ProviderDraft>): void
+  onToggleRoute(route: string, open: boolean): void
+  onCollapseAll(): void
+  onExpandAll(): void
+  /** 打开「内置模型目录」并把该 route 设为添加目标。 */
+  onAddFromCatalog(route: string): void
 }
 
 export function ProvidersSection(props: ProvidersSectionProps): ReactElement {
   const [newRoute, setNewRoute] = useState('')
   const [routeError, setRouteError] = useState('')
+  const routes = Object.keys(props.providers)
   const submitAdd = (): void => {
     const key = newRoute.trim()
     if (key === '') {
@@ -45,7 +54,29 @@ export function ProvidersSection(props: ProvidersSectionProps): ReactElement {
   }
   return (
     <div className="lpc-section">
-      <p className="lpc-groupLabel">{props.t('providersGroup')}</p>
+      <div className="lpc-modelHead">
+        <span className="lpc-modelTitle">{props.t('providersGroup')}</span>
+        {routes.length > 1 ? (
+          <>
+            <button
+              type="button"
+              className="lpc-btn lpc-btnGhost lpc-btnSmall"
+              disabled={props.disabled === true}
+              onClick={props.onCollapseAll}
+            >
+              {props.t('providersCollapseAll')}
+            </button>
+            <button
+              type="button"
+              className="lpc-btn lpc-btnGhost lpc-btnSmall"
+              disabled={props.disabled === true}
+              onClick={props.onExpandAll}
+            >
+              {props.t('providersExpandAll')}
+            </button>
+          </>
+        ) : null}
+      </div>
       <div className="lpc-addRoute">
         <input
           className={`lpc-input${routeError !== '' ? ' lpc-inputInvalid' : ''}`}
@@ -72,11 +103,14 @@ export function ProvidersSection(props: ProvidersSectionProps): ReactElement {
           key={route}
           route={route}
           draft={draft}
+          open={props.openRoutes[route] === true}
           epoch={props.epoch}
           disabled={props.disabled === true}
           t={props.t}
+          onToggle={() => props.onToggleRoute(route, props.openRoutes[route] !== true)}
           onRemove={() => props.onRemoveRoute(route)}
           onPatch={(patch) => props.onPatchProvider(route, patch)}
+          onAddFromCatalog={() => props.onAddFromCatalog(route)}
         />
       ))}
     </div>
@@ -86,19 +120,24 @@ export function ProvidersSection(props: ProvidersSectionProps): ReactElement {
 export interface ProviderSectionProps {
   route: string
   draft: ProviderDraft
+  open: boolean
   epoch: number
   disabled?: boolean
   t: Translate
+  onToggle(): void
   onRemove(): void
   onPatch(patch: Partial<ProviderDraft>): void
+  onAddFromCatalog(): void
 }
 
 export function ProviderSection(props: ProviderSectionProps): ReactElement {
-  const [open, setOpen] = useState(false)
   const { route, draft, t } = props
   const id = route.replace(/[^a-zA-Z0-9_-]/g, '_')
+  const adapter = typeof draft.extra['adapter'] === 'string' ? draft.extra['adapter'] : 'pi'
   const summary =
-    draft.api !== '' ? draft.api : draft.extends !== '' ? `extends ${draft.extends}` : ''
+    draft.api !== '' ? draft.api : draft.extends !== '' ? `extends ${draft.extends}` : adapter
+  const modelCount = draft.models.length
+  const meta = modelCount > 0 ? `${modelCount}` : ''
   const fieldProps = {
     id,
     draft,
@@ -112,12 +151,13 @@ export function ProviderSection(props: ProviderSectionProps): ReactElement {
         <button
           type="button"
           className="lpc-routeToggle"
-          aria-expanded={open}
-          onClick={() => setOpen(!open)}
+          aria-expanded={props.open}
+          onClick={props.onToggle}
         >
-          <ChevronDownIcon className={`lpc-chevron${open ? ' lpc-chevronOpen' : ''}`} />
+          <ChevronDownIcon className={`lpc-chevron${props.open ? ' lpc-chevronOpen' : ''}`} />
           <span className="lpc-routeKey">{route}</span>
           {summary !== '' ? <span className="lpc-routeApi">{summary}</span> : null}
+          {meta !== '' ? <span className="lpc-collapseMeta">{meta}</span> : null}
         </button>
         <button
           type="button"
@@ -128,7 +168,7 @@ export function ProviderSection(props: ProviderSectionProps): ReactElement {
           {t('deleteRoute')}
         </button>
       </div>
-      {open ? (
+      {props.open ? (
         <div className="lpc-routeBody">
           <p className="lpc-groupLabel">{t('providerFields')}</p>
           <ProviderScalarFields {...fieldProps} />
@@ -186,12 +226,12 @@ export function ProviderSection(props: ProviderSectionProps): ReactElement {
           <ModelsTable
             route={route}
             api={draft.api}
-            defaultProvider={draft.extends}
             models={draft.models}
             epoch={props.epoch}
             disabled={props.disabled === true}
             t={t}
             onModels={(models) => props.onPatch({ models })}
+            onAddFromCatalog={props.onAddFromCatalog}
           />
         </div>
       ) : null}

package/src/compat.ts

@@ -1,26 +1,27 @@
 /**
  * 逐协议 compat 校验：门控表与取值约束**从官方 dsh-llm-pi-ai 安装副本自动继承**
- * （见 compat-gates.ts），不再手抄镜像。
+ * （见 official-surface.ts），不再手抄镜像。
  *
- * 语义：官方门控表是 compat 可配性的唯一事实源——按协议分型（offer/withhold），
- * withhold 字段（官方内置目录已为对应厂商设置，如 openRouterRouting/zaiToolStream/
- * sendSessionAffinityHeaders/supportsToolSearch/supportsMidConvoEffort 等）写时
- * 拒绝并提示以目录 provider 名为 route；未知键拒绝；无值键（null/undefined）拒绝
- * （对齐官方 assertOfferedCompatFields："写了但没生效"的表面状态不允许）。
- *
- * 历史：本表曾是手抄镜像，0.1.5-rc.1 官方扩容 offer 字段而旧表漏收，导致官方可配
- * 字段被本插件**误拒**（静默功能缺失、无任何报错）。现改为现场推导：官方新增字段
- * 即自动可用，`tests/compat-gates.test.ts` 直读官方 bundle 守门推导正确性。
+ * 语义分两档，取决于门控表当时来自哪里：
+ * - **official（现场推导成功）**：官方门控表是兼容性的唯一事实源——按协议分型
+ *   （offer/withhold），withhold 字段（官方内置目录已为对应厂商设置，如
+ *   openRouterRouting/zaiToolStream/sendSessionAffinityHeaders 等）写时拒绝并提示以
+ *   目录 provider 名为 route；未知键拒绝；无值键（null/undefined）拒绝（对齐官方
+ *   assertOfferedCompatFields："写了但没生效"的表面状态不允许）。
+ * - **fallback（推导失败，用最后已知快照）**：只拒绝快照中明确 withhold 的键，
+ *   **未知键放行**交给官方适配器自身校验——表落后时"误拒官方新字段"比"多放一个键"
+ *   严重得多（0.1.5-rc.1 教训：静默功能缺失、无任何报错）。
  *
  * pi-ai 侧消费语义：getCompat 逐字段 `??` 覆盖 detectCompat 的 baseURL/名称猜测；
  * undefined 视为未设置（无法显式清空检测值）。
  * @module llm-pi/compat
  */
-import type { CompatDisposition, CompatTable, CompatValue } from './compat-gates.ts'
-import { FALLBACK_TABLE } from './compat-gates.ts'
+
 import type { ProtocolId } from './config.ts'
+import type { CompatDisposition, CompatTable, CompatValue } from './official-surface.ts'
+import { FALLBACK_TABLE } from './official-surface.ts'
 
-export type { CompatDisposition, CompatValue } from './compat-gates.ts'
+export type { CompatDisposition, CompatValue } from './official-surface.ts'
 
 /**
  * 生效门控表：由 resolve-dsh 的套件加载流程经 {@link installCompatTable} 注入
@@ -55,6 +56,23 @@ export function compatFieldsOf(api: ProtocolId | string): readonly string[] {
   )
 }
 
+/**
+ * 生效表里出现过的协议键（运行期协议列表为空时的渲染兜底：
+ * 套件异常也要让表单能画出来）。
+ */
+export function compatProtocols(): string[] {
+  return Object.keys(active.gates)
+}
+
+/** 某协议被官方 withhold 的字段（内置目录已为对应厂商设置，写时拒绝）。 */
+export function compatWithholdFieldsOf(api: ProtocolId | string): readonly string[] {
+  const gate = active.gates[api]
+  if (gate === undefined) return []
+  return Object.entries(gate).flatMap(([field, disposition]) =>
+    disposition === 'withhold' ? [field] : [],
+  )
+}
+
 /** 某协议某 offer 字段的取值约束（UI 渲染开关/下拉用）。 */
 export function compatFieldSpec(api: string, field: string): CompatValue | undefined {
   return active.gates[api]?.[field] === 'offer' ? active.specs[field] : undefined
@@ -114,13 +132,17 @@ export function validateCompat(
   where: string,
 ): void {
   if (compat === undefined) return
-  const gate = active.gates[api]
+  const table = active
+  const gate = table.gates[api]
   if (gate === undefined) {
     throw new Error(
-      `${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（支持：${Object.keys(active.gates).join(', ')}）`,
+      `${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（可配协议：${Object.keys(table.gates).join(', ')}）`,
     )
   }
   const offered = compatFieldsOf(api)
+  // 回退快照可能落后于官方：未知键放行给官方适配器自身校验，只拦快照里明确的
+  // withhold（详见文件头"语义分两档"）。
+  const permissive = table.source === 'fallback'
   for (const [key, value] of Object.entries(compat)) {
     const disposition = gate[key]
     if (disposition !== 'offer') {
@@ -130,10 +152,12 @@ export function validateCompat(
             '请以目录 provider 名作为 route 名（继承目录值），或移除该字段',
         )
       }
-      throw new Error(
-        `${where}: compat.${key} 不是 ${api} 协议的合法字段（可配置字段：${offered.join(', ')}；` +
-          `官方全部可配字段：${allOfferedFields().join(', ')}）`,
-      )
+      if (!permissive) {
+        throw new Error(
+          `${where}: compat.${key} 不是 ${api} 协议的合法字段（可配置字段：${offered.join(', ')}；` +
+            `官方全部可配字段：${allOfferedFields().join(', ')}）`,
+        )
+      }
     }
     if (value === undefined || value === null) {
       throw new Error(`${where}: compat.${key} 未设置值；给出值或移除该键（留空不会生效）`)

package/src/config-api.ts

@@ -1,7 +1,12 @@
 /**
- * 自定义端点 HTTP 通道：配置读写已迁移到官方 remote.settings 直连
- * （0.1.2-alpha.1 起第三方命名空间全量开放），这里只保留官方传输没有的
- * 「模型目录」端点（含 kitSource / models-dev 运行期诊断，供卡片状态行展示）。
+ * 自定义端点 HTTP 通道：配置读写走官方 remote.settings 直连
+ * （0.1.2-alpha.1 起第三方命名空间全量开放），这里只提供浏览器半拿不到的两样东西：
+ * - 运行期套件事实（生效版本、协议集合、目录规模、逐项降级诊断）；
+ * - pi-ai 内置目录的搜索/筛选/分页（浏览器半读不到 pi-ai 包）。
+ *
+ * 两个端点同前缀、单次注册（按 pathname 分派，避免前缀互相遮蔽）：
+ * - `GET  /dsh-plus/llm-pi/catalog`        运行期事实 + provider/协议索引 + compat 字段表；
+ * - `GET  /dsh-plus/llm-pi/catalog/models` 目录搜索（q/provider/api/能力/分页）。
  * 仅监听 dsh web 同源（webserver 默认 127.0.0.1），与 GUI 其余面同等暴露面。
  * @module llm-pi/config-api
  */
@@ -10,24 +15,40 @@ import type { IncomingMessage, ServerResponse } from 'node:http'
 import type { Context } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-host-webserver'
 
-import { builtinModelIds } from './catalog/builtin.ts'
-import { compatFieldSpec, compatFieldsOf, compatTableInfo } from './compat.ts'
-import { PROTOCOL_IDS } from './config.ts'
+import { browseModels } from './catalog/browse.ts'
+import { compatFieldSpec, compatFieldsOf, compatProtocols, compatTableInfo } from './compat.ts'
 import type { LlmPiRuntime } from './service.ts'
 
 const ROUTE_CATALOG = '/dsh-plus/llm-pi/catalog'
+const ROUTE_MODELS = `${ROUTE_CATALOG}/models`
+
+/** 查询参数里的布尔开关：'1'/'true' 为真。 */
+function boolParam(value: string | null, fallback: boolean): boolean {
+  if (value === null) return fallback
+  return value === '1' || value === 'true'
+}
+
+/** 查询参数里的整数；缺失/非法返回 undefined（由消费方取默认）。 */
+function intParam(value: string | null): number | undefined {
+  if (value === null || value.trim() === '') return undefined
+  const parsed = Number(value)
+  return Number.isFinite(parsed) ? parsed : undefined
+}
 
 /**
  * 服务端推导的 compat 字段表（协议 → 字段 → 取值约束）。浏览器半读不到官方包，
  * 由本端点下发，UI 渲染与服务端校验同源（不再各存一份手抄镜像表）。
+ * 协议列表取运行期生效集合（不能服务的协议不渲染控件）；运行期列表为空时退回
+ * 生效表自身的协议键，保证套件异常时表单仍可编辑。
  */
-function compatTablePayload(): {
+function compatTablePayload(protocols: readonly string[]): {
   fields: Record<string, Record<string, unknown>>
   source: string
   problem?: string
 } {
+  const list = protocols.length > 0 ? [...protocols] : compatProtocols()
   const fields: Record<string, Record<string, unknown>> = {}
-  for (const api of PROTOCOL_IDS) {
+  for (const api of list) {
     const perField: Record<string, unknown> = {}
     for (const field of compatFieldsOf(api)) {
       const spec = compatFieldSpec(api, field)
@@ -46,38 +67,34 @@ function sendJson(res: ServerResponse, status: number, body: unknown): void {
   res.end(JSON.stringify(body))
 }
 
-/** 目录查询/手动拉取：GET ?provider=&source= → 该源模型 id 列表；POST /refresh → 立即拉取。 */
-function handleCatalog(runtime: LlmPiRuntime, req: IncomingMessage, res: ServerResponse): void {
-  const kitSource = runtime.kitInfo().source
-  if (req.method === 'POST' && req.url?.endsWith('/refresh')) {
-    void runtime.modelsDev.refresh().then(() => {
-      sendJson(res, 200, { status: runtime.modelsDev.status() })
-    })
-    return
-  }
-  const url = new URL(req.url ?? '', 'http://localhost')
-  const provider = url.searchParams.get('provider') ?? ''
-  const source = url.searchParams.get('source') ?? 'builtin'
-  const compat = compatTablePayload()
-  if (source === 'models-dev') {
-    sendJson(res, 200, {
-      providers: runtime.modelsDev.providerIds(),
-      models: provider.length > 0 ? runtime.modelsDev.modelIds(provider) : [],
-      status: runtime.modelsDev.status(),
-      kitSource,
-      compat,
-    })
-    return
-  }
+/** 运行期事实 + 目录索引（卡片挂载时拉一次：版本、协议、目录规模、compat 字段表）。 */
+function handleMeta(runtime: LlmPiRuntime, res: ServerResponse): void {
+  const kit = runtime.kitInfo()
   sendJson(res, 200, {
-    providers: runtime.kit.getBuiltinProviders(),
-    models: provider.length > 0 ? builtinModelIds(runtime.kit, provider) : [],
-    kitSource,
-    compat,
+    kit,
+    providers: runtime.providerEntries(),
+    apis: runtime.apiIndex(),
+    compat: compatTablePayload(kit.protocols),
   })
 }
 
-/** 注册目录路由（webServer 缺失时由调用方保证不调用）。 */
+/** 目录搜索：q（模糊）/provider/api/reasoning/image/servable/offset/limit。 */
+function handleModels(runtime: LlmPiRuntime, url: URL, res: ServerResponse): void {
+  const limit = intParam(url.searchParams.get('limit'))
+  const result = browseModels(runtime.kit, {
+    q: url.searchParams.get('q') ?? '',
+    provider: url.searchParams.get('provider') ?? '',
+    api: url.searchParams.get('api') ?? '',
+    reasoning: boolParam(url.searchParams.get('reasoning'), false),
+    image: boolParam(url.searchParams.get('image'), false),
+    servableOnly: boolParam(url.searchParams.get('servable'), true),
+    offset: intParam(url.searchParams.get('offset')) ?? 0,
+    ...(limit === undefined ? {} : { limit }),
+  })
+  sendJson(res, 200, result)
+}
+
+/** 目录路由（webServer 缺失时由调用方保证不调用）。 */
 export function registerCatalogApi(ctx: Context, runtime: LlmPiRuntime): void {
   const logger = ctx.logger('llm-pi')
   const guard = (handler: (req: IncomingMessage, res: ServerResponse) => Promise<void> | void) => {
@@ -95,6 +112,17 @@ export function registerCatalogApi(ctx: Context, runtime: LlmPiRuntime): void {
   ctx.webServer.register({
     kind: 'prefix',
     path: ROUTE_CATALOG,
-    handler: guard((req, res) => handleCatalog(runtime, req, res)),
+    handler: guard((req, res) => {
+      const url = new URL(req.url ?? '', 'http://localhost')
+      if (url.pathname === ROUTE_MODELS) {
+        handleModels(runtime, url, res)
+        return
+      }
+      if (url.pathname !== ROUTE_CATALOG) {
+        sendJson(res, 404, { error: `未知端点 ${url.pathname}` })
+        return
+      }
+      handleMeta(runtime, res)
+    }),
   })
 }

package/src/config.ts

@@ -5,7 +5,10 @@
  *
  * 与官方 llm-pi-ai 的差异：
  * - compat 是开放 dict，物化时按协议校验（见 compat.ts），写入即拒绝未知键；
- * - provider/model 均支持 extends 继承（见 inherit.ts）。
+ * - provider/model 均支持 extends 继承（见 inherit.ts），继承源只有 pi-ai 内置目录；
+ * - `api` 不在 schema 里钉死枚举：合法协议集合由已安装官方适配器现场推导
+ *   （见 official-surface/resolve-dsh），写时由 profiles.ts 以明确错误拒绝不支持者，
+ *   官方将来新增协议无需改本插件。
  * @module llm-pi/config
  */
 
@@ -17,13 +20,18 @@ import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 /** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 export const SETTINGS_NS = NS_LITERAL
 
-/** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
-export const PROTOCOL_IDS = [
+/**
+ * 官方适配器不可用/推导失败时的协议兜底三元组（自 0.1.2-alpha 线以来的稳定集）。
+ * 运行期生效集合来自已安装官方包的 `supportedProtocols()`（见 resolve-dsh.ts），
+ * 本常量只用于 schema 描述、浏览器半首帧兜底与推导失败回退。
+ */
+export const FALLBACK_PROTOCOLS = [
   'openai-completions',
   'openai-responses',
   'anthropic-messages',
 ] as const
-export type ProtocolId = (typeof PROTOCOL_IDS)[number]
+/** 线协议标识；合法集合运行期推导，故此处是开放字符串而非字面量联合。 */
+export type ProtocolId = string
 
 /** pi-ai 思考档位，升级序。 */
 export const THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'] as const
@@ -136,18 +144,15 @@ export interface ProviderProfileConfig {
   fileRefreshMarginSeconds?: number
 }
 
-/** 插件配置根。 */
+/** 插件配置根（模型目录唯一来自 pi-ai 内置目录，故无任何目录端点字段）。 */
 export interface LlmPiConfig {
   enabled: boolean
-  catalogUrl: string
-  catalogRefreshHours: number
-  catalogProxy: string
   providers: Record<string, ProviderProfileConfig>
 }
 
 /**
  * schema 的宽松输入面：cordis 行级 config 与 settings 用户层都可能只给部分键
- * （5 个根字段均有 schema 默认值），解析输出仍是完整的 {@link LlmPiConfig}。
+ * （2 个根字段均有 schema 默认值），解析输出仍是完整的 {@link LlmPiConfig}。
  */
 export type LlmPiConfigInput = Partial<LlmPiConfig>
 
@@ -208,18 +213,20 @@ const providerProfile = z.object({
   adapter: z
     .union(ADAPTER_KINDS)
     .description(
-      '路由适配器：pi=PiAiAdapter（默认，三协议）；deepseek=官方 DeepSeekAdapter（图片走 Files API 文件通道，失败自动降级 base64）',
+      '路由适配器：pi=PiAiAdapter（默认，协议集合随已装官方适配器推导）；deepseek=官方 DeepSeekAdapter（图片走 Files API 文件通道，失败自动降级 base64）',
     )
     .default('pi'),
   extends: z
     .string()
     .description(
-      'provider 级继承：内置 provider id，提供 api/baseURL 默认值与模型 extends 的缺省查找源',
+      'provider 级继承：pi-ai 内置 provider id，提供 api/baseURL 默认值与模型 extends 的缺省查找源',
     ),
   displayName: z.string().description('选择器显示名；缺省为 route 键'),
   api: z
-    .union(PROTOCOL_IDS)
-    .description('线协议；缺省逐模型取继承值的 api，全部一致时作为 route 协议'),
+    .string()
+    .description(
+      '线协议（合法集合由已装官方适配器运行期推导，见配置页「内置模型目录」状态行）；缺省逐模型取继承值的 api，全部一致时作为 route 协议',
+    ),
   baseURL: z.string().description('端点；缺省继承 extends 源 provider 的端点'),
   apiKeyEnv: z.string().role('credential-ref').description('凭据引用名（凭据服务/环境变量）'),
   headers: z.dict(z.string()).description('provider 请求头（Harness 署名头保留名优先）'),
@@ -334,21 +341,6 @@ export type LlmPiConfigFields = VolatileFields<LlmPiConfig>
 
 export const Config: z<LlmPiConfigInput, LlmPiConfigFields> = z.object({
   enabled: z.boolean().description('总开关（关闭则不注册任何 route）').default(true).volatile(),
-  catalogUrl: z
-    .string()
-    .description('models.dev 目录数据端点')
-    .default('https://models.dev/api.json')
-    .volatile(),
-  catalogRefreshHours: z
-    .number()
-    .description('models.dev 自动拉取间隔小时数；0 = 不自动拉取（可手动拉取或读已有缓存）')
-    .default(0)
-    .volatile(),
-  catalogProxy: z
-    .string()
-    .description('拉取 models.dev 目录时的 HTTP 代理地址（如 http://127.0.0.1:7890）；留空直连')
-    .default('')
-    .volatile(),
   providers: z
     .dict(providerProfile)
     .description('provider 路由表，键即 route 名')

package/src/inherit.ts

@@ -1,24 +1,23 @@
 /**
  * extends 继承解析：把 provider/model 条目上的继承引用解析为继承 base。
  *
- * 数据源优先级（三级）：
- * 1. pi-ai 内置目录（含官方校正，最可信）；
- * 2. models.dev 快照（仅内置未收录的新模型，字段保守）；
- * 3. 都未命中 → 手写模型（无 base，必填字段由配置/兜底给出）。
+ * 数据源只有一个：**pi-ai 内置目录**（随已装 dsh 的 pi-ai 版本自动跟随，
+ * 含官方校正的 compat/thinkingLevelMap/模态）。未命中即「手写条目」，
+ * 必填字段由 route 级配置或兜底给出。models.dev 兜底源已随 0.1.43 移除——
+ * 版本漂移靠「现场推导 + 状态行显示生效版本」处理，不引入第二份可能过期的目录。
  *
- * 引用语法：`"provider/model"` 显式跨源；裸 `"model"` 随 route 级 extends 源；
+ * 引用语法：`"provider/model"` 显式引用；裸 `"model"` 随 route 级 extends 源；
  * 条目缺省 extends 时以 route extends 源下的同名模型为 base。
  * @module llm-pi/inherit
  */
 import type { ModelBase } from './catalog/builtin.ts'
 import { builtinModelBase } from './catalog/builtin.ts'
-import type { ModelsDevSource } from './catalog/models-dev.ts'
 import type { ModelEntryConfig, ProviderProfileConfig } from './config.ts'
 import type { DshKit } from './resolve-dsh.ts'
 
 export interface BaseResolution {
   base: ModelBase
-  source: 'builtin' | 'models-dev' | 'none'
+  source: 'builtin' | 'none'
   /** 实际命中的继承源 provider（诊断/错误消息用）。 */
   sourceProvider?: string
 }
@@ -42,19 +41,6 @@ export function parseExtendsRef(raw: string): {
   return { provider, model }
 }
 
-function lookup(
-  kit: DshKit,
-  modelsDev: ModelsDevSource | undefined,
-  provider: string,
-  model: string,
-): BaseResolution | undefined {
-  const builtin = builtinModelBase(kit, provider, model)
-  if (builtin !== undefined) return { base: builtin, source: 'builtin', sourceProvider: provider }
-  const dev = modelsDev?.lookup(provider, model)
-  if (dev !== undefined) return { base: dev, source: 'models-dev', sourceProvider: provider }
-  return undefined
-}
-
 /**
  * 解析一个模型条目的继承 base。
  * @throws ExtendsError 显式 extends 引用不存在（写入时拒绝，指明引用名）。
@@ -64,17 +50,14 @@ export function resolveModelBase(
   profile: ProviderProfileConfig,
   entry: ModelEntryConfig,
   kit: DshKit,
-  modelsDev: ModelsDevSource | undefined,
 ): BaseResolution {
   const where = `provider "${route}" model "${entry.id}"`
   if (entry.extends === undefined) {
     if (profile.extends === undefined) return { base: {}, source: 'none' }
-    return (
-      lookup(kit, modelsDev, profile.extends, entry.id) ?? {
-        base: {},
-        source: 'none',
-      }
-    )
+    const base = builtinModelBase(kit, profile.extends, entry.id)
+    return base === undefined
+      ? { base: {}, source: 'none' }
+      : { base, source: 'builtin', sourceProvider: profile.extends }
   }
   const ref = parseExtendsRef(entry.extends)
   const provider = ref.provider ?? profile.extends
@@ -83,11 +66,12 @@ export function resolveModelBase(
       `${where}: extends ${JSON.stringify(entry.extends)} 是裸模型 id，但本 route 未配置 provider 级 extends 查找源`,
     )
   }
-  const hit = lookup(kit, modelsDev, provider, ref.model)
-  if (hit === undefined) {
+  const base = builtinModelBase(kit, provider, ref.model)
+  if (base === undefined) {
     throw new ExtendsError(
-      `${where}: extends 引用 "${provider}/${ref.model}" 在内置目录与 models.dev 快照中都不存在`,
+      `${where}: extends 引用 "${provider}/${ref.model}" 不在 pi-ai ${kit.versions.piAi ?? '?'} 的内置目录中` +
+        `（可继承的 provider/模型见配置页「内置模型目录」，或用裸 model id 配合 route 级 extends）`,
     )
   }
-  return hit
+  return { base, source: 'builtin', sourceProvider: provider }
 }