@dsh-plus/llm-pi 0.1.5 → 0.1.7

package/src/compat.ts

@@ -90,7 +90,13 @@ export function compatFieldSpec(api: ProtocolId, field: string): CompatValue | u
   return FIELDS_BY_PROTOCOL[api][field]
 }
 
-function checkValue(api: ProtocolId, field: string, spec: CompatValue, value: unknown, where: string): void {
+function checkValue(
+  _api: ProtocolId,
+  field: string,
+  spec: CompatValue,
+  value: unknown,
+  where: string,
+): void {
   if (spec === 'boolean') {
     if (typeof value !== 'boolean') throw new Error(`${where}: compat.${field} 必须是布尔值`)
     return
@@ -102,7 +108,9 @@ function checkValue(api: ProtocolId, field: string, spec: CompatValue, value: un
     return
   }
   if (typeof value !== 'string' || !spec.includes(value)) {
-    throw new Error(`${where}: compat.${field} 必须是 ${spec.map((v) => JSON.stringify(v)).join(' | ')} 之一`)
+    throw new Error(
+      `${where}: compat.${field} 必须是 ${spec.map((v) => JSON.stringify(v)).join(' | ')} 之一`,
+    )
   }
 }
 
@@ -110,11 +118,17 @@ function checkValue(api: ProtocolId, field: string, spec: CompatValue, value: un
  * 校验一份 compat 字典对指定协议合法：未知协议/未知键拒绝（对比官方的静默丢弃），
  * 已知键校验值类型/枚举。undefined 值视为未设置，跳过（语义同 pi-ai 的 ??）。
  */
-export function validateCompat(api: string, compat: Record<string, unknown> | undefined, where: string): void {
+export function validateCompat(
+  api: string,
+  compat: Record<string, unknown> | undefined,
+  where: string,
+): void {
   if (compat === undefined) return
   const fields = FIELDS_BY_PROTOCOL[api as ProtocolId]
   if (fields === undefined) {
-    throw new Error(`${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（支持：${Object.keys(FIELDS_BY_PROTOCOL).join(', ')}）`)
+    throw new Error(
+      `${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（支持：${Object.keys(FIELDS_BY_PROTOCOL).join(', ')}）`,
+    )
   }
   for (const [key, value] of Object.entries(compat)) {
     const spec = fields[key]

package/src/config.ts

@@ -8,8 +8,9 @@
  * - provider/model 均支持 extends 继承（见 inherit.ts）。
  * @module llm-pi/config
  */
-import z from '@deepseek-ai/schemastery'
+
 import { settingsNamespace } from '@deepseek-ai/dsh-settings'
+import z from '@deepseek-ai/schemastery'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
@@ -17,7 +18,11 @@ import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 export const SETTINGS_NS = settingsNamespace(NS_LITERAL)
 
 /** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
-export const PROTOCOL_IDS = ['openai-completions', 'openai-responses', 'anthropic-messages'] as const
+export const PROTOCOL_IDS = [
+  'openai-completions',
+  'openai-responses',
+  'anthropic-messages',
+] as const
 export type ProtocolId = (typeof PROTOCOL_IDS)[number]
 
 /** pi-ai 思考档位，升级序。 */
@@ -25,6 +30,15 @@ export const THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhig
 
 export const MODALITIES = ['text', 'image'] as const
 
+/** 路由适配器种类：pi = PiAiAdapter（默认）；deepseek = 官方 DeepSeekAdapter（文件通道）。 */
+export const ADAPTER_KINDS = ['pi', 'deepseek'] as const
+export type AdapterKind = (typeof ADAPTER_KINDS)[number]
+
+/** deepseek 路由的思考/推理档位（线协议枚举，对齐官方 llm-deepseek）。 */
+export const DEEPSEEK_THINKING = ['enabled', 'disabled'] as const
+export const DEEPSEEK_REASONING_EFFORTS = ['off', 'low', 'high', 'max'] as const
+export const DEEPSEEK_IMAGE_DETAILS = ['auto', 'low'] as const
+
 export const DEFAULT_CONTEXT_WINDOW = 262144
 export const DEFAULT_MAX_TOKENS = 32768
 export const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000
@@ -51,10 +65,15 @@ export interface ModelEntryConfig {
   input?: Modality[]
   reasoningEfforts?: false | ReasoningEfforts
   compat?: Record<string, unknown>
+  /** 以下仅 adapter: deepseek 的 route 有效（官方 llm-deepseek 目录字段）。 */
+  imagePixelBudget?: number
+  imageMaxBytes?: number
+  imageDetail?: 'auto' | 'low'
 }
 
 /** 单个 provider route 配置（providers 字典的值）。 */
 export interface ProviderProfileConfig {
+  adapter?: AdapterKind
   extends?: string
   displayName?: string
   api?: ProtocolId
@@ -66,7 +85,12 @@ export interface ProviderProfileConfig {
   defaultMaxTokens?: number
   defaultInput?: Modality[]
   reasoning?: ThinkingLevel
-  thinkingBudgets?: { minimal: number; low: number; medium: number; high: number }
+  thinkingBudgets?: {
+    minimal: number
+    low: number
+    medium: number
+    high: number
+  }
   cacheRetention?: 'none' | 'short' | 'long'
   transport?: 'sse' | 'websocket' | 'websocket-cached' | 'auto'
   timeoutMs?: number
@@ -75,6 +99,18 @@ export interface ProviderProfileConfig {
   maxRequestImageBytes?: number
   retryPolicy?: unknown
   models?: ModelEntryConfig[]
+  /** 以下仅 adapter: deepseek 的 route 有效（透传官方 llm-deepseek 同名策略）。 */
+  thinking?: 'enabled' | 'disabled'
+  reasoningEffort?: 'off' | 'low' | 'high' | 'max'
+  maxRequestFilesBytes?: number
+  maxInlineRequestImageBytes?: number
+  maxImagesPerRequest?: number
+  imageOffloadByteQuantum?: number
+  inlineImageOffloadByteQuantum?: number
+  imageOffloadCountQuantum?: number
+  filesApiTimeoutMs?: number
+  fileExpiresAfterSeconds?: number
+  fileRefreshMarginSeconds?: number
 }
 
 /** 插件配置根。 */
@@ -104,28 +140,63 @@ const modelEntry = z.object({
   id: z.string().required().description('模型 id（发送给 provider 的标识）'),
   extends: z
     .string()
-    .description('继承源："provider/model" 或裸 model id（随 provider 级 extends 源）；缺省先查内置目录同名模型'),
+    .description(
+      '继承源："provider/model" 或裸 model id（随 provider 级 extends 源）；缺省先查内置目录同名模型',
+    ),
   name: z.string().description('选择器显示名；缺省继承内置目录名，再退化为 id'),
   contextWindow: z.number().step(1).min(1).description('上下文容量（覆盖继承值）'),
-  maxTokens: z.number().step(1).min(1).description('输出能力上限；显式配置同时成为无 cap 请求的默认 cap'),
-  input: z.array(z.union(MODALITIES)).description('请求模态；缺省继承内置目录，再退化 route defaultInput'),
+  maxTokens: z
+    .number()
+    .step(1)
+    .min(1)
+    .description('输出能力上限；显式配置同时成为无 cap 请求的默认 cap'),
+  input: z
+    .array(z.union(MODALITIES))
+    .description('请求模态；缺省继承内置目录，再退化 route defaultInput'),
   reasoningEfforts: z
     .union([z.const(false), reasoningEfforts])
     .description('可选 reasoning 档位：false=非推理模型；dict=档位→线值映射；缺省继承内置目录能力'),
   compat: compatDict.description('模型级 compat（字段级合并，压过 route 级与继承值）'),
+  imagePixelBudget: z
+    .number()
+    .step(1)
+    .min(1)
+    .description('（仅 adapter: deepseek）单张请求图片的总像素预算；缺省继承官方目录'),
+  imageMaxBytes: z
+    .number()
+    .step(1)
+    .min(1)
+    .description('（仅 adapter: deepseek）单张请求图片的编码字节上限；缺省继承官方目录'),
+  imageDetail: z
+    .union(DEEPSEEK_IMAGE_DETAILS)
+    .description('（仅 adapter: deepseek）图片细节档位；low 使用 512x512 像素预算'),
 })
 
 const providerProfile = z.object({
+  adapter: z
+    .union(ADAPTER_KINDS)
+    .description(
+      '路由适配器：pi=PiAiAdapter（默认，三协议）；deepseek=官方 DeepSeekAdapter（图片走 Files API 文件通道，失败自动降级 base64）',
+    )
+    .default('pi'),
   extends: z
     .string()
-    .description('provider 级继承：内置 provider id，提供 api/baseURL 默认值与模型 extends 的缺省查找源'),
+    .description(
+      'provider 级继承：内置 provider id，提供 api/baseURL 默认值与模型 extends 的缺省查找源',
+    ),
   displayName: z.string().description('选择器显示名；缺省为 route 键'),
-  api: z.union(PROTOCOL_IDS).description('线协议；缺省逐模型取继承值的 api，全部一致时作为 route 协议'),
+  api: z
+    .union(PROTOCOL_IDS)
+    .description('线协议；缺省逐模型取继承值的 api，全部一致时作为 route 协议'),
   baseURL: z.string().description('端点；缺省继承 extends 源 provider 的端点'),
   apiKeyEnv: z.string().role('credential-ref').description('凭据引用名（凭据服务/环境变量）'),
   headers: z.dict(z.string()).description('provider 请求头（Harness 署名头保留名优先）'),
   compat: compatDict.description('route 级 compat 默认（逐模型按字段生效）'),
-  defaultContextWindow: z.number().step(1).min(1).description('模型与继承源都未标注时的上下文容量兜底'),
+  defaultContextWindow: z
+    .number()
+    .step(1)
+    .min(1)
+    .description('模型与继承源都未标注时的上下文容量兜底'),
   defaultMaxTokens: z.number().step(1).min(1).description('模型与继承源都未标注时的输出能力兜底'),
   defaultInput: z
     .array(z.union(MODALITIES))
@@ -146,12 +217,77 @@ const providerProfile = z.object({
     .natural()
     .description('单请求 base64 图片载荷上限字节；缺省 20MiB（rc8 起生效，旧配置免改）'),
   retryPolicy: z.any().description('provider 重试策略（dsh-llm RetryPolicy 形状，构建期校验）'),
-  models: z.array(modelEntry).description('本 route 的模型目录；缺省且 provider 有 extends 时继承该源全部模型'),
+  thinking: z
+    .union(DEEPSEEK_THINKING)
+    .description('（仅 adapter: deepseek）思考模式开关；缺省用提供商默认'),
+  reasoningEffort: z
+    .union(DEEPSEEK_REASONING_EFFORTS)
+    .description('（仅 adapter: deepseek）推理档位；缺省为 high'),
+  maxRequestFilesBytes: z
+    .number()
+    .step(1)
+    .min(1)
+    .description('（仅 adapter: deepseek）单请求文件引用图片累积上限字节；缺省 128MiB'),
+  maxInlineRequestImageBytes: z
+    .number()
+    .step(1)
+    .min(1)
+    .description('（仅 adapter: deepseek）文件通道降级后 base64 图片载荷上限字节；缺省 20MiB'),
+  maxImagesPerRequest: z
+    .number()
+    .step(1)
+    .min(1)
+    .description(
+      '（仅 adapter: deepseek）单请求图片数量上限；缺省 600（调低时需同步调低 imageOffloadCountQuantum）',
+    ),
+  imageOffloadByteQuantum: z
+    .number()
+    .step(1)
+    .min(1)
+    .description(
+      '（仅 adapter: deepseek）文件引用超限后的原始字节削减步长；缺省 64MiB，不可超过 maxRequestFilesBytes',
+    ),
+  inlineImageOffloadByteQuantum: z
+    .number()
+    .step(1)
+    .min(1)
+    .description(
+      '（仅 adapter: deepseek）base64 降级超限后的削减步长；缺省 10MiB，不可超过 maxInlineRequestImageBytes',
+    ),
+  imageOffloadCountQuantum: z
+    .number()
+    .step(1)
+    .min(1)
+    .description(
+      '（仅 adapter: deepseek）图片数量超限后的削减步长；缺省 20，不可超过 maxImagesPerRequest',
+    ),
+  filesApiTimeoutMs: z
+    .number()
+    .min(Number.MIN_VALUE)
+    .max(MAX_TIMER_DELAY_MS)
+    .description('（仅 adapter: deepseek）单次 Files API 图片解析超时毫秒；缺省 60s'),
+  fileExpiresAfterSeconds: z
+    .number()
+    .step(1)
+    .min(3600)
+    .max(2592000)
+    .description('（仅 adapter: deepseek）上传文件的远端存活秒数；缺省 7 天'),
+  fileRefreshMarginSeconds: z
+    .number()
+    .step(1)
+    .min(0)
+    .description('（仅 adapter: deepseek）文件过期前提前重传的余量秒数；缺省 3600'),
+  models: z
+    .array(modelEntry)
+    .description('本 route 的模型目录；缺省且 provider 有 extends 时继承该源全部模型'),
 })
 
 export const Config: z<LlmPiConfig> = z.object({
   enabled: z.boolean().description('总开关（关闭则不注册任何 route）').default(true),
-  catalogUrl: z.string().description('models.dev 目录数据端点').default('https://models.dev/api.json'),
+  catalogUrl: z
+    .string()
+    .description('models.dev 目录数据端点')
+    .default('https://models.dev/api.json'),
   catalogRefreshHours: z
     .number()
     .description('models.dev 自动拉取间隔小时数；0 = 不自动拉取（可手动拉取或读已有缓存）')

package/src/deepseek-routes.ts

@@ -0,0 +1,139 @@
+/**
+ * deepseek 路由注册器：每条 adapter: deepseek 的 route 一个官方
+ * DeepSeekAdapter 实例（baseURL 各异，无法共享实例），注册到独立路由名。
+ *
+ * 与官方 deepseek-official 渠道的隔离：
+ * - 路由名独立（重复名注册冲突时跳过并告警，不互相覆盖）；
+ * - 文件索引作用域 = sha256(baseURL + apiKey)（官方实现），中转与官方天然分池；
+ * - 适配器实例、连接事实、重试策略各自独立。
+ *
+ * 热更新：适配器 options thunk 每次操作重读当前物化产物（连接事实变化下一
+ * 请求生效）；retryPolicy 是注册期捕获事实，变化时 handle.replace 原地重注册
+ * （官方同款模式）；route 移除即 dispose 释放路由名。
+ * @module llm-pi/deepseek-routes
+ */
+import type { Context } from '@deepseek-ai/cordis'
+import type { CredentialRef } from '@deepseek-ai/dsh-credentials'
+import { launchEnvironmentOf } from '@deepseek-ai/dsh-launch-environment'
+import type { AdapterRegistrationHandle } from '@deepseek-ai/dsh-llm'
+import { deepEqualJson } from '@deepseek-ai/dsh-settings'
+
+import type { ResolvedDeepseekRoute } from './profiles-deepseek.ts'
+import type { DshKit } from './resolve-dsh.ts'
+
+interface RouteRegistration {
+  handle: AdapterRegistrationHandle
+  /** 注册期捕获的重试策略（变化才 replace）。 */
+  retryPolicy: unknown
+}
+
+export interface DeepseekRegistrarDeps {
+  ctx: Context
+  kit: DshKit
+  logger: {
+    warn(message: string): void
+    error(message: string | unknown): void
+  }
+  /** 当前物化产物表（service 层按 config identity 备忘）。 */
+  routes: () => Map<string, ResolvedDeepseekRoute>
+}
+
+/** 凭据解析（逐行对齐官方 llm-deepseek resolveApiKey）：凭据服务优先，启动环境兜底。 */
+function makeResolveApiKey(ctx: Context, kit: DshKit) {
+  return async (connection: { apiKeyEnv: unknown }): Promise<string> => {
+    const ref = connection.apiKeyEnv as CredentialRef
+    const credentials = ctx.get('credentials')
+    const hit =
+      credentials !== undefined
+        ? (await credentials.resolve(ref))?.value
+        : launchEnvironmentOf(ctx).get(ref as unknown as string)?.value
+    if (hit !== undefined && hit.length > 0) {
+      return kit.assertUsableApiKey(hit, 'llm-pi', ref as unknown as string)
+    }
+    throw new kit.LlmError(
+      `llm-pi: deepseek route 的凭据引用 ${String(ref)} 未解析到值——` +
+        '请经凭据服务（web Models 页）存放或导出环境变量',
+      'MISSING_CREDENTIAL',
+    )
+  }
+}
+
+export class DeepseekRouteRegistrar {
+  private readonly deps: DeepseekRegistrarDeps
+  private readonly registrations = new Map<string, RouteRegistration>()
+  private readonly resolveApiKey: (connection: { apiKeyEnv: unknown }) => Promise<string>
+  private userId: unknown
+
+  constructor(deps: DeepseekRegistrarDeps) {
+    this.deps = deps
+    this.resolveApiKey = makeResolveApiKey(deps.ctx, deps.kit)
+  }
+
+  /** 同步注册表与目标 route 集：新增注册、移除 dispose、retryPolicy 变化原地 replace。 */
+  sync(target: Map<string, ResolvedDeepseekRoute>): void {
+    for (const [route, registration] of this.registrations) {
+      if (target.has(route)) continue
+      registration.handle()
+      this.registrations.delete(route)
+      this.deps.logger.warn(`llm-pi: deepseek route "${route}" 已随配置移除而注销`)
+    }
+    for (const [route, built] of target) {
+      const existing = this.registrations.get(route)
+      if (existing !== undefined) {
+        this.refreshPolicy(route, built, existing)
+        continue
+      }
+      this.register(route, built)
+    }
+  }
+
+  private refreshPolicy(
+    route: string,
+    built: ResolvedDeepseekRoute,
+    registration: RouteRegistration,
+  ): void {
+    const policy = built.connection.retryPolicy
+    if (deepEqualJson(policy, registration.retryPolicy)) return
+    try {
+      registration.handle.replace([route])
+      registration.retryPolicy = policy
+    } catch (error) {
+      this.deps.logger.error(`llm-pi: deepseek route "${route}" 重试策略更新被拒，保留此前注册`)
+      this.deps.logger.error(error)
+    }
+  }
+
+  /** 匿名用户 id（首次调用时生成并备忘；register 前已确认 kit.deepseek 存在）。 */
+  private resolveUserId(): unknown {
+    if (this.userId === undefined) {
+      this.userId = this.deps.kit.deepseek?.getOrCreateAnonymousUserId()
+    }
+    return this.userId
+  }
+
+  private register(route: string, built: ResolvedDeepseekRoute): void {
+    const { ctx, kit, logger, routes } = this.deps
+    if (kit.deepseek === undefined) return // 构建期已拦截；此处只是类型护栏
+    const adapter = new kit.deepseek.DeepSeekAdapter({
+      options: () => {
+        const current = routes().get(route)
+        if (current === undefined) {
+          throw new kit.LlmError(`llm-pi: deepseek route "${route}" 已注销`, 'INVALID_REQUEST')
+        }
+        return current.connection
+      },
+      resolveApiKey: this.resolveApiKey as never,
+      resolveUserId: () => this.resolveUserId() as never,
+      resolveAttachments: () => ctx.get('attachments') as never,
+    })
+    try {
+      const handle = ctx.llm.registerAdapter([route], adapter as never)
+      this.registrations.set(route, { handle, retryPolicy: built.connection.retryPolicy })
+    } catch (error) {
+      logger.error(
+        `llm-pi: deepseek route "${route}" 注册失败（可能与其他 adapter 重名），该 route 不可用`,
+      )
+      logger.error(error)
+    }
+  }
+}

package/src/discovery.ts

@@ -6,7 +6,8 @@
  * GET {baseURL}/models、4MB 上限、署名头）与官方一致。结果不落盘。
  * @module llm-pi/discovery
  */
-import { hasBuiltinProvider, builtinModelIds } from './catalog/builtin.ts'
+import { builtinModelIds, hasBuiltinProvider } from './catalog/builtin.ts'
+import { officialModelIds } from './catalog/official.ts'
 import type { ProviderProfileConfig } from './config.ts'
 import type { DshKit } from './resolve-dsh.ts'
 
@@ -37,7 +38,8 @@ export interface DiscoveryDeps {
 
 /** 读取有界响应体：声明超长或累计超长都拒绝（对齐官方 readBounded）。 */
 async function readBounded(kit: DshKit, response: Response, url: string): Promise<string> {
-  const oversized = () => new kit.LlmError(`${url} 响应超过 ${MAX_RESPONSE_BYTES} 字节`, 'DISCOVERY_FAILED')
+  const oversized = () =>
+    new kit.LlmError(`${url} 响应超过 ${MAX_RESPONSE_BYTES} 字节`, 'DISCOVERY_FAILED')
   const declared = Number(response.headers.get('content-length') ?? NaN)
   if (Number.isFinite(declared) && declared > MAX_RESPONSE_BYTES) {
     await response.body?.cancel()
@@ -87,7 +89,12 @@ function readListing(kit: DshKit, body: unknown): DiscoveryEntry[] {
       ['max_tokens', 'maxTokens'],
     ] as const) {
       const value = entry[key]
-      if (typeof value === 'number' && Number.isInteger(value) && value > 0 && out[field] === undefined) {
+      if (
+        typeof value === 'number' &&
+        Number.isInteger(value) &&
+        value > 0 &&
+        out[field] === undefined
+      ) {
         out[field] = value
       }
     }
@@ -96,6 +103,32 @@ function readListing(kit: DshKit, body: unknown): DiscoveryEntry[] {
   return models
 }
 
+/** deepseek 路由直答：extends 'deepseek' 给官方目录全量；否则给 route 自配模型。 */
+function deepseekCatalogAnswer(kit: DshKit, route: ProviderProfileConfig): DiscoveryEntry[] {
+  if (kit.deepseek === undefined) {
+    throw new kit.LlmError(
+      '当前运行时套件不含 dsh-llm-deepseek，无法读取官方目录',
+      'DISCOVERY_FAILED',
+    )
+  }
+  if (route.extends === 'deepseek') {
+    return officialModelIds(kit).map((id) => ({ id }))
+  }
+  const models = (route.models ?? []).map((entry) => ({
+    id: entry.id,
+    ...(entry.name === undefined ? {} : { name: entry.name }),
+    ...(entry.contextWindow === undefined ? {} : { contextWindow: entry.contextWindow }),
+    ...(entry.maxTokens === undefined ? {} : { maxTokens: entry.maxTokens }),
+  }))
+  if (models.length === 0) {
+    throw new kit.LlmError(
+      '该 route 未配置 models 且未 extends deepseek；请手工录入模型',
+      'DISCOVERY_FAILED',
+    )
+  }
+  return models
+}
+
 /** 内置目录直答（route 配了 provider 级 extends 时）。 */
 function catalogAnswer(kit: DshKit, source: string): DiscoveryEntry[] {
   return builtinModelIds(kit, source).map((id) => {
@@ -111,13 +144,20 @@ function catalogAnswer(kit: DshKit, source: string): DiscoveryEntry[] {
 }
 
 /**
- * 回答"该 provider 可服务哪些模型"：extends 内置源零网络直答；
- * 否则仅 openai 系协议走 GET {baseURL}/models；其余协议明确不支持。
+ * 回答"该 provider 可服务哪些模型"：deepseek 路由读官方目录/自有配置直答；
+ * extends 内置源零网络直答；否则仅 openai 系协议走 GET {baseURL}/models；
+ * 其余协议明确不支持。
  */
-export async function discoverModels(request: DiscoveryRequest, deps: DiscoveryDeps): Promise<DiscoveryEntry[]> {
+export async function discoverModels(
+  request: DiscoveryRequest,
+  deps: DiscoveryDeps,
+): Promise<DiscoveryEntry[]> {
   const { kit } = deps
   const route: ProviderProfileConfig | undefined =
     request.provider === undefined ? undefined : deps.configProviders()[request.provider]
+  if ((route?.adapter ?? 'pi') === 'deepseek') {
+    return deepseekCatalogAnswer(kit, route)
+  }
   if (route?.extends !== undefined && hasBuiltinProvider(kit, route.extends)) {
     return catalogAnswer(kit, route.extends)
   }
@@ -130,7 +170,10 @@ export async function discoverModels(request: DiscoveryRequest, deps: DiscoveryD
   }
   const api = request.api ?? route?.api ?? 'openai-completions'
   if (!LISTABLE_PROTOCOLS.has(api)) {
-    throw new kit.LlmError(`协议 "${api}" 无可读取的模型清单端点；请手工录入模型`, 'DISCOVERY_UNSUPPORTED')
+    throw new kit.LlmError(
+      `协议 "${api}" 无可读取的模型清单端点；请手工录入模型`,
+      'DISCOVERY_UNSUPPORTED',
+    )
   }
   const url = `${baseURL.replace(/\/+$/, '')}/models`
   const supplied = request.apiKey ?? (await deps.storedApiKey(request.provider))
@@ -139,7 +182,9 @@ export async function discoverModels(request: DiscoveryRequest, deps: DiscoveryD
     const checked = kit.normalizeApiKey(supplied)
     if (!checked.ok) {
       throw new kit.LlmError(
-        checked.reason === 'empty' ? 'API key 为空；请在 Models 页配置或留空以匿名探测' : 'API key 含有 HTTP 头无法携带的字符',
+        checked.reason === 'empty'
+          ? 'API key 为空；请在 Models 页配置或留空以匿名探测'
+          : 'API key 含有 HTTP 头无法携带的字符',
         kit.INVALID_CREDENTIAL_CODE,
       )
     }
@@ -157,8 +202,13 @@ export async function discoverModels(request: DiscoveryRequest, deps: DiscoveryD
       ...(request.signal === undefined ? {} : { signal: request.signal }),
     })
   } catch (error) {
-    if (request.signal?.aborted) throw new kit.LlmError('模型发现被调用方中止', 'ABORTED', { cause: error })
-    throw new kit.LlmError(`无法连接 ${url}`, 'DISCOVERY_FAILED', { cause: error })
+    if (request.signal?.aborted)
+      throw new kit.LlmError('模型发现被调用方中止', 'ABORTED', {
+        cause: error,
+      })
+    throw new kit.LlmError(`无法连接 ${url}`, 'DISCOVERY_FAILED', {
+      cause: error,
+    })
   }
   if (!response.ok) {
     throw new kit.LlmError(
@@ -171,6 +221,8 @@ export async function discoverModels(request: DiscoveryRequest, deps: DiscoveryD
     return readListing(kit, JSON.parse(text))
   } catch (error) {
     if (error instanceof kit.LlmError) throw error
-    throw new kit.LlmError(`${url} 未返回 JSON`, 'DISCOVERY_FAILED', { cause: error })
+    throw new kit.LlmError(`${url} 未返回 JSON`, 'DISCOVERY_FAILED', {
+      cause: error,
+    })
   }
 }

package/src/index.ts

@@ -20,10 +20,13 @@ export const name = 'dsh-plus-llm-pi'
 
 export const inject = ['llm'] as const
 
-export { Config }
-
-export type { LlmPiConfig, ProviderProfileConfig, ModelEntryConfig } from './config.ts'
+export type {
+  LlmPiConfig,
+  ModelEntryConfig,
+  ProviderProfileConfig,
+} from './config.ts'
 export { SETTINGS_NS } from './config.ts'
+export { Config }
 
 export async function apply(ctx: Context, config: LlmPiConfig): Promise<void> {
   const runtime = await startRuntime(ctx, config)

package/src/inherit.ts

@@ -26,13 +26,18 @@ export interface BaseResolution {
 export class ExtendsError extends Error {}
 
 /** 解析 "provider/model" 或裸 "model" 引用。 */
-export function parseExtendsRef(raw: string): { provider?: string; model: string } {
+export function parseExtendsRef(raw: string): {
+  provider?: string
+  model: string
+} {
   const slash = raw.indexOf('/')
   if (slash < 0) return { model: raw }
   const provider = raw.slice(0, slash)
   const model = raw.slice(slash + 1)
   if (provider.length === 0 || model.length === 0 || model.includes('/')) {
-    throw new ExtendsError(`extends 引用 ${JSON.stringify(raw)} 非法：应为 "provider/model" 或 "model"`)
+    throw new ExtendsError(
+      `extends 引用 ${JSON.stringify(raw)} 非法：应为 "provider/model" 或 "model"`,
+    )
   }
   return { provider, model }
 }
@@ -65,7 +70,10 @@ export function resolveModelBase(
   if (entry.extends === undefined) {
     if (profile.extends === undefined) return { base: {}, source: 'none' }
     return (
-      lookup(kit, modelsDev, profile.extends, entry.id) ?? { base: {}, source: 'none' }
+      lookup(kit, modelsDev, profile.extends, entry.id) ?? {
+        base: {},
+        source: 'none',
+      }
     )
   }
   const ref = parseExtendsRef(entry.extends)