@dsh-plus/llm-pi 0.1.4 → 0.1.6

package/lib/client.js

@@ -659,11 +659,11 @@ function CompatEditor(props) {
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		className: `lpc-field lpc-wide`,
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollapseSection, {
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CollapseSection, {
 			id: `${props.idPrefix}-collapse`,
 			title: props.t("compatGroup"),
 			defaultOpen: false,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [props.api === "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			children: [props.api === "" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				className: "lpc-hint",
 				children: props.t("compatApiHint")
 			}) : null, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -704,7 +704,7 @@ function CompatEditor(props) {
 						}
 					}, field);
 				})
-			})] })
+			})]
 		})
 	});
 }
@@ -1290,11 +1290,11 @@ function ProviderSection(props) {
 					removeLabel: t("remove"),
 					onEdit: (headers) => props.onPatch({ headers })
 				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollapseSection, {
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CollapseSection, {
 					id: `${id}-advanced`,
 					title: t("advancedGroup"),
 					defaultOpen: false,
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(JsonField, {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(JsonField, {
 						id: `${id}-retry`,
 						label: t("retryPolicy"),
 						hint: t("retryPolicyHint"),
@@ -1313,7 +1313,7 @@ function ProviderSection(props) {
 						wide: true,
 						t,
 						onEdit: (compat) => props.onPatch({ compat })
-					})] })
+					})]
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ModelsTable, {
 					route,

package/lib/index.d.ts

@@ -1,5 +1,5 @@
-import z from "@deepseek-ai/schemastery";
 import * as _deepseek_ai_dsh_settings0 from "@deepseek-ai/dsh-settings";
+import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 
 //#region src/config.d.ts

package/lib/index.js

@@ -1,21 +1,21 @@
-import z from "@deepseek-ai/schemastery";
 import { deepEqualJson, installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import z from "@deepseek-ai/schemastery";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
 import { request } from "node:http";
 import { request as request$1 } from "node:https";
-import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import HttpsProxyAgentModule from "https-proxy-agent";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { pathToFileURL } from "node:url";
+import * as vendoredLlm from "@deepseek-ai/dsh-llm";
+import * as vendoredPiAiAdapter from "@deepseek-ai/dsh-llm-pi-ai";
 import * as vendoredPiAi from "@earendil-works/pi-ai";
-import * as vendoredCatalog from "@earendil-works/pi-ai/providers/all";
 import { anthropicMessagesApi } from "@earendil-works/pi-ai/api/anthropic-messages.lazy";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
-import * as vendoredLlm from "@deepseek-ai/dsh-llm";
-import * as vendoredPiAiAdapter from "@deepseek-ai/dsh-llm-pi-ai";
+import * as vendoredCatalog from "@earendil-works/pi-ai/providers/all";
 
 //#region src/ns.ts
 /**
@@ -572,7 +572,7 @@ const FIELDS_BY_PROTOCOL = {
 	"openai-responses": RESPONSES_FIELDS,
 	"anthropic-messages": ANTHROPIC_FIELDS
 };
-function checkValue(api, field, spec, value, where) {
+function checkValue(_api, field, spec, value, where) {
 	if (spec === "boolean") {
 		if (typeof value !== "boolean") throw new Error(`${where}: compat.${field} 必须是布尔值`);
 		return;
@@ -1112,11 +1112,13 @@ async function startRuntime(ctx, rawConfig) {
 				logger.warn(error);
 			});
 		} else try {
-			registrations[0].handle.replace(routes);
-			for (let i = 1; i < registrations.length; i += 1) registrations[i].handle.replace([]);
+			const [first, ...rest] = registrations;
+			if (first === void 0) throw new Error("registrations 为空（此前整批注册全部失败）");
+			first.handle.replace(routes);
+			for (const group of rest) group.handle.replace([]);
 			registrations = [{
 				routes,
-				handle: registrations[0].handle
+				handle: first.handle
 			}];
 		} catch (error) {
 			logger.error("llm-pi: 更新被拒，保留此前注册的 route");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/llm-pi",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "dsh-plus service+ui plugin: 基于 PiAiAdapter 的自定义 LLM 路由（全量 compat、模型继承、models.dev 目录兜底）",
   "type": "module",
   "main": "lib/index.js",
@@ -32,6 +32,20 @@
     }
   },
   "dependencies": {
+    "https-proxy-agent": "^7.0.6"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm-pi-ai": "^0.1.0-rc.8",
+    "@earendil-works/pi-ai": "^0.82.1"
+  },
+  "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/schemastery": "3.18.1",
     "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
@@ -40,11 +54,8 @@
     "@deepseek-ai/dsh-home-paths": "0.1.0-rc.8",
     "@deepseek-ai/dsh-launch-environment": "0.1.0-rc.8",
     "@deepseek-ai/dsh-llm-pi-ai": "0.1.0-rc.8",
-    "@earendil-works/pi-ai": "0.82.1",
-    "https-proxy-agent": "^7.0.6"
-  },
-  "devDependencies": {
     "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.8",
+    "@earendil-works/pi-ai": "0.82.1",
     "@types/react": "~18.3.1",
     "react": "^18.2.0"
   },

package/src/catalog/builtin.ts

@@ -19,7 +19,12 @@ export interface ModelBase {
   compat?: Record<string, unknown>
   contextWindow?: number
   maxTokens?: number
-  cost?: { input: number; output: number; cacheRead: number; cacheWrite: number }
+  cost?: {
+    input: number
+    output: number
+    cacheRead: number
+    cacheWrite: number
+  }
   headers?: Record<string, string>
 }
 
@@ -40,7 +45,11 @@ export function builtinModelIds(kit: DshKit, provider: string): string[] {
 }
 
 /** 查单个内置模型为继承 base；未命中返回 undefined。 */
-export function builtinModelBase(kit: DshKit, provider: string, modelId: string): ModelBase | undefined {
+export function builtinModelBase(
+  kit: DshKit,
+  provider: string,
+  modelId: string,
+): ModelBase | undefined {
   if (!hasBuiltinProvider(kit, provider)) return undefined
   const model = kit.getBuiltinModels(provider).find((m) => m.id === modelId)
   if (model === undefined) return undefined
@@ -50,8 +59,12 @@ export function builtinModelBase(kit: DshKit, provider: string, modelId: string)
     baseUrl: model.baseUrl,
     input: [...model.input],
     reasoning: model.reasoning,
-    ...(model.thinkingLevelMap === undefined ? {} : { thinkingLevelMap: { ...model.thinkingLevelMap } }),
-    ...(model.compat === undefined ? {} : { compat: { ...(model.compat as Record<string, unknown>) } }),
+    ...(model.thinkingLevelMap === undefined
+      ? {}
+      : { thinkingLevelMap: { ...model.thinkingLevelMap } }),
+    ...(model.compat === undefined
+      ? {}
+      : { compat: { ...(model.compat as Record<string, unknown>) } }),
     contextWindow: model.contextWindow,
     maxTokens: model.maxTokens,
     cost: { ...model.cost },

package/src/catalog/models-dev.ts

@@ -15,9 +15,10 @@
  * 视觉等模态须用户在条目上显式声明（防 over-claiming 导致会话重复失败请求）。
  * @module llm-pi/catalog/models-dev
  */
+
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
 import { request as httpRequest } from 'node:http'
 import { request as httpsRequest } from 'node:https'
-import { mkdirSync, readFileSync, writeFileSync, renameSync } from 'node:fs'
 import { dirname } from 'node:path'
 
 import HttpsProxyAgentModule from 'https-proxy-agent'
@@ -73,7 +74,8 @@ function fetchJson(url: string, proxy: string, timeoutMs: number): Promise<JsonR
   return new Promise((resolve, reject) => {
     const target = new URL(url)
     const request = target.protocol === 'https:' ? httpsRequest : httpRequest
-    const agent = target.protocol === 'https:' && proxy.length > 0 ? new HttpsProxyAgent(proxy) : undefined
+    const agent =
+      target.protocol === 'https:' && proxy.length > 0 ? new HttpsProxyAgent(proxy) : undefined
     const req = request(
       url,
       { agent, timeout: timeoutMs, headers: { accept: 'application/json' } },
@@ -89,7 +91,10 @@ function fetchJson(url: string, proxy: string, timeoutMs: number): Promise<JsonR
           chunks.push(chunk)
         })
         response.on('end', () => {
-          resolve({ status: response.statusCode ?? 0, body: Buffer.concat(chunks).toString('utf8') })
+          resolve({
+            status: response.statusCode ?? 0,
+            body: Buffer.concat(chunks).toString('utf8'),
+          })
         })
       },
     )
@@ -108,7 +113,8 @@ function toModelBase(entry: ModelsDevModelEntry): ModelBase {
   const base: ModelBase = {}
   if (typeof entry.name === 'string' && entry.name.length > 0) base.name = entry.name
   const context = entry.limit?.context
-  if (typeof context === 'number' && Number.isInteger(context) && context > 0) base.contextWindow = context
+  if (typeof context === 'number' && Number.isInteger(context) && context > 0)
+    base.contextWindow = context
   const output = entry.limit?.output
   if (typeof output === 'number' && Number.isInteger(output) && output > 0) base.maxTokens = output
   base.reasoning = entry.reasoning === true
@@ -178,7 +184,7 @@ export class ModelsDevSource {
 
   /** 全部 provider id（UI extends 选择器用）。 */
   providerIds(): string[] {
-  return Object.keys(this.document ?? {})
+    return Object.keys(this.document ?? {})
   }
 
   /** 某 provider 的模型 id 列表（UI extends 选择器用）。 */
@@ -209,7 +215,8 @@ export class ModelsDevSource {
   private loadCache(): void {
     try {
       const raw = JSON.parse(readFileSync(this.cacheFile, 'utf8')) as CacheFile
-      if (!isDocument(raw.data) || typeof raw.fetchedAt !== 'string') throw new Error('缓存形状非法')
+      if (!isDocument(raw.data) || typeof raw.fetchedAt !== 'string')
+        throw new Error('缓存形状非法')
       this.document = raw.data
       this.fetchedAt = raw.fetchedAt
     } catch {

package/src/client/api.ts

@@ -23,7 +23,12 @@ export interface WireProvider {
   defaultMaxTokens?: number
   defaultInput?: string[]
   reasoning?: string
-  thinkingBudgets?: { minimal: number; low: number; medium: number; high: number }
+  thinkingBudgets?: {
+    minimal: number
+    low: number
+    medium: number
+    high: number
+  }
   cacheRetention?: string
   transport?: string
   timeoutMs?: number
@@ -74,14 +79,22 @@ async function parse<T>(res: Response): Promise<T> {
 }
 
 /** 目录查询：provider 为空时只返回该源的 provider 列表。 */
-export async function fetchCatalog(provider: string, source: 'builtin' | 'models-dev'): Promise<CatalogResult> {
+export async function fetchCatalog(
+  provider: string,
+  source: 'builtin' | 'models-dev',
+): Promise<CatalogResult> {
   const url = `${ROUTE_CATALOG}?provider=${encodeURIComponent(provider)}&source=${source}`
   return parse<CatalogResult>(await fetch(url, { credentials: 'same-origin' }))
 }
 
 /** 手动拉取 models.dev 目录：POST /catalog/refresh → 最新快照状态。 */
-export async function refreshCatalog(): Promise<{ status: WireModelsDevStatus }> {
+export async function refreshCatalog(): Promise<{
+  status: WireModelsDevStatus
+}> {
   return parse<{ status: WireModelsDevStatus }>(
-    await fetch(`${ROUTE_CATALOG}/refresh`, { method: 'POST', credentials: 'same-origin' }),
+    await fetch(`${ROUTE_CATALOG}/refresh`, {
+      method: 'POST',
+      credentials: 'same-origin',
+    }),
   )
 }

package/src/client/card.tsx

@@ -7,11 +7,18 @@
  * 交互对齐官方卡片与 notify-email：折叠/展开、staged draft、未保存标记。
  * @module llm-pi/client/card
  */
-import { useEffect, useMemo, useSyncExternalStore, useState, type ReactElement } from 'react'
+import { type ReactElement, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
 
 import { SETTINGS_NS } from '../ns.ts'
-import { fetchCatalog, refreshCatalog, type ConfigValue, type WireModelsDevStatus } from './api.ts'
-import { draftFromValue, emptyProviderDraft, numTextOk, toPatch, type Draft, type ProviderDraft } from './draft.ts'
+import { type ConfigValue, fetchCatalog, refreshCatalog, type WireModelsDevStatus } from './api.ts'
+import {
+  type Draft,
+  draftFromValue,
+  emptyProviderDraft,
+  numTextOk,
+  type ProviderDraft,
+  toPatch,
+} from './draft.ts'
 import { CheckRow, TextField } from './fields.tsx'
 import type { Scope, SettingsApi } from './scope.ts'
 import { ProvidersSection } from './views/providers.tsx'
@@ -75,7 +82,8 @@ export function LlmPiCard(props: CardProps): ReactElement | null {
 
   const dirty = useMemo(
     () =>
-      value !== undefined && draft !== null &&
+      value !== undefined &&
+      draft !== null &&
       JSON.stringify(toPatch(draft)) !== JSON.stringify(toPatch(draftFromValue(value))),
     [value, draft],
   )
@@ -90,16 +98,26 @@ export function LlmPiCard(props: CardProps): ReactElement | null {
   }, [draft])
 
   if (value === undefined || draft === null) {
-    return <li className="lpc-card"><p className="lpc-readOnly">{t('loading')}</p></li>
+    return (
+      <li className="lpc-card">
+        <p className="lpc-readOnly">{t('loading')}</p>
+      </li>
+    )
   }
 
   const setProvider = (route: string, patch: Partial<ProviderDraft>): void => {
     const current = draft.providers[route] ?? emptyProviderDraft()
-    setDraft({ ...draft, providers: { ...draft.providers, [route]: { ...current, ...patch } } })
+    setDraft({
+      ...draft,
+      providers: { ...draft.providers, [route]: { ...current, ...patch } },
+    })
     setStatus(IDLE_STATUS)
   }
   const onAddRoute = (key: string): void => {
-    setDraft({ ...draft, providers: { ...draft.providers, [key]: emptyProviderDraft() } })
+    setDraft({
+      ...draft,
+      providers: { ...draft.providers, [key]: emptyProviderDraft() },
+    })
     setStatus(IDLE_STATUS)
   }
   const onRemoveRoute = (route: string): void => {
@@ -111,11 +129,12 @@ export function LlmPiCard(props: CardProps): ReactElement | null {
   const onSave = (): void => {
     setSaving(true)
     const revision = scope.getSnapshot().revision
-    api.replace({
-      ns: SETTINGS_NS,
-      section: toPatch(draft) as unknown as Record<string, unknown>,
-      ...(revision !== undefined ? { expectedRevision: revision } : {}),
-    })
+    api
+      .replace({
+        ns: SETTINGS_NS,
+        section: toPatch(draft) as unknown as Record<string, unknown>,
+        ...(revision !== undefined ? { expectedRevision: revision } : {}),
+      })
       .then(async (response) => {
         if (!response.result.ok) {
           throw new Error(response.result.error?.message ?? t('saveFailed'))
@@ -170,7 +189,11 @@ export function LlmPiCard(props: CardProps): ReactElement | null {
       </button>
       {open ? (
         <div className="lpc-body">
-          {disabled ? <p className="lpc-readOnly" role="status">{t('readOnly')}</p> : null}
+          {disabled ? (
+            <p className="lpc-readOnly" role="status">
+              {t('readOnly')}
+            </p>
+          ) : null}
           <CheckRow
             id="lpc-enabled"
             label={t('enabled')}
@@ -217,9 +240,13 @@ export function LlmPiCard(props: CardProps): ReactElement | null {
               setStatus(IDLE_STATUS)
             }}
           />
-          <p className="lpc-statusRow">{t('kitSource')}：{kitSource ?? ''}</p>
+          <p className="lpc-statusRow">
+            {t('kitSource')}：{kitSource ?? ''}
+          </p>
           <div className="lpc-statusRow">
-            <span>{t('modelsDevStatus')}：{modelsDevText(modelsDevStatus, t)}</span>
+            <span>
+              {t('modelsDevStatus')}：{modelsDevText(modelsDevStatus, t)}
+            </span>
             <button
               type="button"
               className="lpc-btn lpc-btnGhost lpc-btnSmall lpc-refreshBtn"
@@ -240,17 +267,27 @@ export function LlmPiCard(props: CardProps): ReactElement | null {
           />
           <div className="lpc-footer">
             {status.kind !== 'idle' ? (
-              <p className={`lpc-status${status.kind === 'error' ? ' lpc-statusError' : ''}`} role="status">
+              <p
+                className={`lpc-status${status.kind === 'error' ? ' lpc-statusError' : ''}`}
+                role="status"
+              >
                 {status.text}
               </p>
             ) : null}
-            <button type="button" className="lpc-btn lpc-btnGhost" disabled={!dirty || saving}
-              onClick={onDiscard}>
+            <button
+              type="button"
+              className="lpc-btn lpc-btnGhost"
+              disabled={!dirty || saving}
+              onClick={onDiscard}
+            >
               {t('discard')}
             </button>
-            <button type="button" className="lpc-btn lpc-btnPrimary"
+            <button
+              type="button"
+              className="lpc-btn lpc-btnPrimary"
               disabled={!dirty || invalid || saving || disabled}
-              onClick={onSave}>
+              onClick={onSave}
+            >
               {t(saving ? 'saving' : 'save')}
             </button>
           </div>

package/src/client/client.ts

@@ -64,7 +64,12 @@ interface ClientContext {
  * （loopback 或 tailnet 信任域名）下行为一致。
  */
 function createApiScope(api: SettingsApi, ns: string, c: ClientContext): Scope {
-  let state: ScopeSnapshot = { status: 'loading', value: undefined, revision: undefined, writable: false }
+  let state: ScopeSnapshot = {
+    status: 'loading',
+    value: undefined,
+    revision: undefined,
+    writable: false,
+  }
   const listeners = new Set<() => void>()
   let generation = 0
   const publish = (next: ScopeSnapshot): void => {
@@ -73,7 +78,7 @@ function createApiScope(api: SettingsApi, ns: string, c: ClientContext): Scope {
   }
   const load = async (): Promise<void> => {
     const gen = ++generation
-    let response
+    let response: Awaited<ReturnType<SettingsApi['describe']>>
     try {
       response = await api.describe({})
     } catch {
@@ -83,10 +88,20 @@ function createApiScope(api: SettingsApi, ns: string, c: ClientContext): Scope {
     const writable = response.result.value?.writable ?? false
     const view = response.result.value?.namespaces.find((candidate) => candidate.ns === ns)
     if (view === undefined) {
-      publish({ status: 'unavailable', value: undefined, revision: undefined, writable })
+      publish({
+        status: 'unavailable',
+        value: undefined,
+        revision: undefined,
+        writable,
+      })
       return
     }
-    publish({ status: 'ready', value: view.value, revision: view.revision, writable })
+    publish({
+      status: 'ready',
+      value: view.value,
+      revision: view.revision,
+      writable,
+    })
   }
   const refresh = (namespace?: unknown): void => {
     if (namespace !== undefined && namespace !== ns) return
@@ -118,7 +133,6 @@ function createApiScope(api: SettingsApi, ns: string, c: ClientContext): Scope {
 }
 
 export function apply(ctx: Context): void {
-
   const c = ctx as unknown as ClientContext
   const tag = injectStyle()
   c.effect(
@@ -127,10 +141,7 @@ export function apply(ctx: Context): void {
     },
     'llm-pi: style',
   )
-  c.effect(
-    () => c.locale.register(NS, { zh, en }),
-    'llm-pi: locale',
-  )
+  c.effect(() => c.locale.register(NS, { zh, en }), 'llm-pi: locale')
   const api = c.get('connection').api.settings
   const scope = createApiScope(api, SETTINGS_NS, c)
   c.slots.inject('settings.plugin.item', () =>

package/src/client/constants.ts

@@ -6,7 +6,11 @@
  */
 
 /** 协议枚举（来源：config.ts PROTOCOL_IDS）。 */
-export const PROTOCOL_IDS = ['openai-completions', 'openai-responses', 'anthropic-messages'] as const
+export const PROTOCOL_IDS = [
+  'openai-completions',
+  'openai-responses',
+  'anthropic-messages',
+] as const
 
 /** thinking 档位（来源：config.ts THINKING_LEVELS）。 */
 export const THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'] as const

package/src/client/draft.ts

@@ -100,7 +100,10 @@ export function pairsToHeaders(pairs: HeaderPair[]): Record<string, string> | un
 }
 
 function inputFromWire(list: string[] | undefined): InputDraft {
-  return { text: list?.includes('text') ?? false, image: list?.includes('image') ?? false }
+  return {
+    text: list?.includes('text') ?? false,
+    image: list?.includes('image') ?? false,
+  }
 }
 
 function inputToWire(input: InputDraft): string[] | undefined {
@@ -110,7 +113,9 @@ function inputToWire(input: InputDraft): string[] | undefined {
   return out.length > 0 ? out : undefined
 }
 
-function reasoningFromWire(value: false | Record<string, string | null> | undefined): ReasoningDraft {
+function reasoningFromWire(
+  value: false | Record<string, string | null> | undefined,
+): ReasoningDraft {
   if (value === false) return { nonReasoning: true, levels: {} }
   const levels: Record<string, string> = {}
   for (const [level, line] of Object.entries(value ?? {})) levels[level] = line ?? ''
@@ -126,7 +131,9 @@ function reasoningToWire(value: ReasoningDraft): false | Record<string, string>
   return Object.keys(out).length > 0 ? out : undefined
 }
 
-function budgetFromWire(value: { minimal: number; low: number; medium: number; high: number } | undefined): BudgetDraft {
+function budgetFromWire(
+  value: { minimal: number; low: number; medium: number; high: number } | undefined,
+): BudgetDraft {
   return {
     minimal: numToText(value?.minimal),
     low: numToText(value?.low),
@@ -135,13 +142,17 @@ function budgetFromWire(value: { minimal: number; low: number; medium: number; h
   }
 }
 
-function budgetToWire(value: BudgetDraft): { minimal: number; low: number; medium: number; high: number } | undefined {
+function budgetToWire(
+  value: BudgetDraft,
+): { minimal: number; low: number; medium: number; high: number } | undefined {
   const out: Record<string, number> = {}
   for (const key of ['minimal', 'low', 'medium', 'high'] as const) {
     const num = toNum(value[key])
     if (num !== undefined) out[key] = num
   }
-  return Object.keys(out).length > 0 ? (out as { minimal: number; low: number; medium: number; high: number }) : undefined
+  return Object.keys(out).length > 0
+    ? (out as { minimal: number; low: number; medium: number; high: number })
+    : undefined
 }
 
 /** 剔除空值：undefined / '' / 空数组 / 空对象。 */
@@ -278,7 +289,10 @@ export function draftFromValue(value: ConfigValue): Draft {
     catalogRefreshHours: String(value.catalogRefreshHours),
     catalogProxy: value.catalogProxy,
     providers: Object.fromEntries(
-      Object.entries(value.providers).map(([route, provider]) => [route, providerDraftFromWire(provider)]),
+      Object.entries(value.providers).map(([route, provider]) => [
+        route,
+        providerDraftFromWire(provider),
+      ]),
     ),
   }
 }

package/src/client/fields.tsx

@@ -3,7 +3,7 @@
  * 视觉对齐官方卡片字段（label + hint + 控件纵列），样式类前缀 lpc-。
  * @module llm-pi/client/fields
  */
-import { useEffect, useState, type ReactElement } from 'react'
+import { type ReactElement, useEffect, useState } from 'react'
 
 import type { HeaderPair } from './draft.ts'
 
@@ -170,6 +170,7 @@ export function KeyValueEditor(props: KeyValueEditorProps): ReactElement {
         </label>
       </div>
       {props.pairs.map((pair, index) => (
+        // biome-ignore lint/suspicious/noArrayIndexKey: 可编辑 KV 行无稳定 id，行序即身份（增删行经 onEdit 整体回写）
         <div className="lpc-kvRow" key={index}>
           <input
             id={index === 0 ? props.id : undefined}
@@ -239,6 +240,7 @@ export interface JsonFieldProps {
 
 export function JsonField(props: JsonFieldProps): ReactElement {
   const [text, setText] = useState(() => toJsonText(props.value))
+  // biome-ignore lint/correctness/useExhaustiveDependencies: 仅在 epoch 递增（外部重置语义）时同步文本，避免编辑中被 value 回写打断
   useEffect(() => {
     setText(toJsonText(props.value))
   }, [props.epoch])

package/src/client/i18n.ts

@@ -102,7 +102,8 @@ export const en: Record<string, string> = {
   catalogUrl: 'models.dev catalog endpoint',
   catalogUrlHint: 'Snapshot data source; usually no change needed.',
   catalogRefreshHours: 'Catalog refresh (hours)',
-  catalogRefreshHoursHint: '0 = no auto refresh (manual refresh or existing cache); >0 = refresh every N hours.',
+  catalogRefreshHoursHint:
+    '0 = no auto refresh (manual refresh or existing cache); >0 = refresh every N hours.',
   catalogProxy: 'Fetch proxy',
   catalogProxyHint: 'HTTP proxy (e.g. http://127.0.0.1:7890); leave empty for direct.',
   kitSource: 'Module source',
@@ -151,7 +152,8 @@ export const en: Record<string, string> = {
   retryPolicyHint: 'dsh-llm RetryPolicy shape; invalid JSON is not submitted.',
   invalidJson: 'Invalid JSON (this field will not be submitted).',
   compatGroup: 'Compat overrides',
-  compatApiHint: 'When api is unset, fields render per openai-completions; the backend validates per the effective protocol.',
+  compatApiHint:
+    'When api is unset, fields render per openai-completions; the backend validates per the effective protocol.',
   compatUnset: 'Unset',
   modelsGroup: 'Model catalog',
   addModel: 'Add model',

package/src/client/scope.ts

@@ -31,7 +31,26 @@ export interface Scope {
 
 /** connection api.settings 的 RPC 面（本插件用到的三个方法）。 */
 export interface SettingsApi {
-  describe(payload?: Record<string, never>): Promise<{ result: { ok: boolean; value?: { namespaces: Array<{ ns: string; secrets: Array<{ path: string[]; set: boolean }> }> }; error?: { message?: string } } }>
-  update(request: { ns: string; patch: Record<string, unknown>; expectedRevision?: number }): Promise<{ result: { ok: boolean; error?: { message?: string } } }>
-  replace(request: { ns: string; section: Record<string, unknown>; expectedRevision?: number }): Promise<{ result: { ok: boolean; error?: { message?: string } } }>
+  describe(payload?: Record<string, never>): Promise<{
+    result: {
+      ok: boolean
+      value?: {
+        namespaces: Array<{
+          ns: string
+          secrets: Array<{ path: string[]; set: boolean }>
+        }>
+      }
+      error?: { message?: string }
+    }
+  }>
+  update(request: {
+    ns: string
+    patch: Record<string, unknown>
+    expectedRevision?: number
+  }): Promise<{ result: { ok: boolean; error?: { message?: string } } }>
+  replace(request: {
+    ns: string
+    section: Record<string, unknown>
+    expectedRevision?: number
+  }): Promise<{ result: { ok: boolean; error?: { message?: string } } }>
 }