@dsh-plus/llm-pi 0.1.26 → 0.1.27

package/lib/client.js

@@ -168,7 +168,10 @@ window.__ModuleLoader__.load({
 			confirm: "Confirm",
 			cancel: "Cancel"
 		};
-		/** own 覆盖同键合并（返回新对象，入参不可变）。 */
+		/**
+		* own 覆盖同键合并（返回新对象，入参不可变）。
+		* 返回类型保留两侧键集合，调用方据此派生 DictKey。
+		*/
 		function mergeDict(base, own) {
 			return {
 				...base,

package/lib/index.d.ts

@@ -4,13 +4,13 @@ import { Context } from "@deepseek-ai/cordis";
 /** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 declare const SETTINGS_NS = "dsh-plus-llm-pi";
 /** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
-declare const PROTOCOL_IDS: readonly ["openai-completions", "openai-responses", "anthropic-messages"];
+declare const PROTOCOL_IDS: readonly ['openai-completions', 'openai-responses', 'anthropic-messages'];
 type ProtocolId = (typeof PROTOCOL_IDS)[number];
 /** pi-ai 思考档位，升级序。 */
-declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
-declare const MODALITIES: readonly ["text", "image"];
+declare const THINKING_LEVELS: readonly ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+declare const MODALITIES: readonly ['text', 'image'];
 /** 路由适配器种类：pi = PiAiAdapter（默认）；deepseek = 官方 DeepSeekAdapter（文件通道）。 */
-declare const ADAPTER_KINDS: readonly ["pi", "deepseek"];
+declare const ADAPTER_KINDS: readonly ['pi', 'deepseek'];
 type AdapterKind = (typeof ADAPTER_KINDS)[number];
 type ThinkingLevel = (typeof THINKING_LEVELS)[number];
 type Modality = (typeof MODALITIES)[number];
@@ -35,6 +35,13 @@ interface ProviderProfileConfig {
   extends?: string;
   displayName?: string;
   api?: ProtocolId;
+  /**
+   * 端点；缺省继承 extends 源 provider 的端点。
+   *
+   * 不并 `| undefined`：schemastery 的输入契约用 null 表示「显式置空」，省略即未设置；
+   * 消费方按 `baseURL ?? 默认值` 处理。并上 undefined 会与 ObjectS 的 `string | null`
+   * 冲突（exactOptionalPropertyTypes 下二者不可互赋）。
+   */
   baseURL?: string;
   apiKeyEnv?: string;
   headers?: Record<string, string>;
@@ -89,7 +96,7 @@ declare const Config: z<LlmPiConfigInput, LlmPiConfig>;
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-llm-pi";
-declare const inject: readonly ["credentials", "llm"];
+declare const inject: readonly ['credentials', 'llm'];
 declare function apply(ctx: Context, config: LlmPiConfig): Promise<void>;
 //#endregion
 export { Config, type LlmPiConfig, type ModelEntryConfig, type ProviderProfileConfig, SETTINGS_NS, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/llm-pi",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "dsh-plus service+ui plugin: 基于 PiAiAdapter 的自定义 LLM 路由（全量 compat、模型继承、models.dev 目录兜底）",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "https-proxy-agent": "^9.1.0",
-    "@dsh-plus/shared": "0.1.15"
+    "@dsh-plus/shared": "0.1.16"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/src/client/card.tsx

@@ -26,15 +26,16 @@ import {
   type ProviderDraft,
   toPatch,
 } from './draft.ts'
+import type { Translate } from './i18n.ts'
 import { ProvidersSection } from './views/providers.tsx'
 
 export interface CardProps {
-  t(key: string): string
+  t: Translate
   scope: Scope
   api: NamespaceSettingsApi
 }
 
-function modelsDevText(status: WireModelsDevStatus | null, t: (key: string) => string): string {
+function modelsDevText(status: WireModelsDevStatus | null, t: Translate): string {
   if (status === null) return t('modelsDevEmpty')
   if (status.error !== null) return `${t('modelsDevError')}${status.error}`
   if (status.fetchedAt === null) return t('modelsDevEmpty')

package/src/client/client.ts

@@ -18,11 +18,11 @@ import type { Context } from '@deepseek-ai/cordis'
 import {
   createNamespaceApi,
   createSettingsScope,
-  type SettingsRemoteFace,
+  type PluginClientContext,
 } from '@dsh-plus/shared/client'
 import { SETTINGS_NS } from '../ns.ts'
 import { LlmPiCard } from './card.tsx'
-import { en, NS, zh } from './i18n.ts'
+import { type DictKey, en, NS, zh } from './i18n.ts'
 import { injectStyle } from './styles.ts'
 
 export const name = 'dsh-plus-llm-pi'
@@ -30,28 +30,8 @@ export const name = 'dsh-plus-llm-pi'
 /** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
 export const inject = ['slots', 'locale', 'remote', 'remote.settings'] as const
 
-interface SlotsLike {
-  inject(key: string, callback: () => unknown): unknown
-  register(options: Record<string, unknown>, component: unknown): () => void
-}
-
-interface LocaleLike {
-  register(ns: string, dict: { zh: Record<string, string>; en: Record<string, string> }): () => void
-  bind(ns: string): (key: string) => string
-}
-
-interface RemoteLike {
-  settings: SettingsRemoteFace
-  $on(event: string, listener: (payload?: unknown) => void): () => void
-}
-
-interface ClientContext {
-  slots: SlotsLike
-  locale: LocaleLike
-  get(key: 'remote'): RemoteLike
-  on(event: string, listener: () => void): () => void
-  effect(execute: () => () => void, label?: string): unknown
-}
+/** 宿主窄面收编在 @dsh-plus/shared/client；TKey 传入本包 DictKey 使键名受检。 */
+type ClientContext = PluginClientContext<DictKey>
 
 export function apply(ctx: Context): void {
   const c = ctx as unknown as ClientContext

package/src/client/i18n.ts

@@ -7,7 +7,7 @@ import { commonEn, commonZh, mergeDict } from '@dsh-plus/shared/client'
 
 export const NS = 'dsh-plus-llm-pi'
 
-const ownZh: Record<string, string> = {
+const ownZh = {
   title: 'LLM 路由（llm-pi）',
   description: '自定义 LLM 路由：协议、compat、模型目录与 models.dev 目录兜底。',
   enabled: '启用插件',
@@ -86,9 +86,9 @@ const ownZh: Record<string, string> = {
   catalogFailed: '目录加载失败。',
   saveOk: '已保存。',
   saveFailed: '保存失败：',
-}
+} as const
 
-const ownEn: Record<string, string> = {
+const ownEn = {
   title: 'LLM routes (llm-pi)',
   description: 'Custom LLM routes: protocol, compat, model catalog and models.dev fallback.',
   enabled: 'Enable plugin',
@@ -169,7 +169,13 @@ const ownEn: Record<string, string> = {
   catalogFailed: 'Failed to load catalog.',
   saveOk: 'Saved.',
   saveFailed: 'Save failed: ',
-}
+} as const
 
-export const zh: Record<string, string> = mergeDict(commonZh, ownZh)
-export const en: Record<string, string> = mergeDict(commonEn, ownEn)
+export type DictKey = keyof typeof commonZh | keyof typeof ownZh
+
+/** 卡片/面板共用的翻译函数类型（slot 注入的 bind 结果按此消费）。 */
+export type Translate = (key: DictKey) => string
+
+// 标注为 Record<DictKey, string>：en 缺任一键即编译期报错（中英强制对齐）。
+export const zh: Record<DictKey, string> = mergeDict(commonZh, ownZh)
+export const en: Record<DictKey, string> = mergeDict(commonEn, ownEn)

package/src/client/views/compat.tsx

@@ -9,6 +9,7 @@ import type { ReactElement } from 'react'
 
 import { COMPAT_FALLBACK_API, compatFieldSpec, compatFieldsOf } from '../constants.ts'
 import { CollapseSection, JsonField, SelectField } from '../fields.tsx'
+import type { Translate } from '../i18n.ts'
 
 /** api 变更后裁剪 compat：只保留新渲染组的字段，避免保存时被后端拒绝。 */
 export function pruneCompatForApi(
@@ -31,7 +32,7 @@ export interface CompatEditorProps {
   epoch: number
   disabled?: boolean
   wide?: boolean
-  t(key: string): string
+  t: Translate
   onEdit(next: Record<string, unknown>): void
 }
 

package/src/client/views/models.tsx

@@ -11,11 +11,12 @@ import { fetchCatalog, type WireModelsDevStatus } from '../api.ts'
 import { MODALITIES, THINKING_LEVELS } from '../constants.ts'
 import { emptyModelDraft, type ModelDraft, type ReasoningDraft } from '../draft.ts'
 import { TextField } from '../fields.tsx'
+import type { Translate } from '../i18n.ts'
 import { CompatEditor } from './compat.tsx'
 
 type CatalogSource = 'builtin' | 'models-dev'
 
-function catalogNote(status: WireModelsDevStatus | undefined, t: (key: string) => string): string {
+function catalogNote(status: WireModelsDevStatus | undefined, t: Translate): string {
   if (status === undefined) return ''
   if (status.error !== null) return `${t('modelsDevError')}${status.error}`
   return `${t('modelsDevStatusLine')}：${status.providers} 个 provider，快照 ${status.fetchedAt ?? '-'}`
@@ -29,7 +30,7 @@ export interface ModelsTableProps {
   models: ModelDraft[]
   epoch: number
   disabled?: boolean
-  t(key: string): string
+  t: Translate
   onModels(next: ModelDraft[]): void
 }
 
@@ -158,7 +159,7 @@ export interface ModelRowProps {
   listId: string
   epoch: number
   disabled?: boolean
-  t(key: string): string
+  t: Translate
   onPatch(patch: Partial<ModelDraft>): void
   onRemove(): void
 }
@@ -268,7 +269,7 @@ export interface ReasoningEditorProps {
   idPrefix: string
   value: ReasoningDraft
   disabled?: boolean
-  t(key: string): string
+  t: Translate
   onEdit(next: ReasoningDraft): void
 }
 

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

@@ -17,13 +17,14 @@ import {
 } from '../constants.ts'
 import type { ProviderDraft } from '../draft.ts'
 import { SelectField, TextField } from '../fields.tsx'
+import type { Translate } from '../i18n.ts'
 import { pruneCompatForApi } from './compat.tsx'
 
 export interface ProviderScalarFieldsProps {
   id: string
   draft: ProviderDraft
   disabled?: boolean
-  t(key: string): string
+  t: Translate
   onPatch(patch: Partial<ProviderDraft>): void
 }
 

package/src/client/views/providers.tsx

@@ -10,6 +10,7 @@ import { type ReactElement, useState } from 'react'
 
 import type { ProviderDraft } from '../draft.ts'
 import { CollapseSection, JsonField, KeyValueEditor } from '../fields.tsx'
+import type { Translate } from '../i18n.ts'
 import { CompatEditor } from './compat.tsx'
 import { ModelsTable } from './models.tsx'
 import { ProviderScalarFields, ProviderSelectFields } from './provider-fields.tsx'
@@ -18,7 +19,7 @@ export interface ProvidersSectionProps {
   providers: Record<string, ProviderDraft>
   epoch: number
   disabled?: boolean
-  t(key: string): string
+  t: Translate
   onAddRoute(key: string): void
   onRemoveRoute(route: string): void
   onPatchProvider(route: string, patch: Partial<ProviderDraft>): void
@@ -86,7 +87,7 @@ export interface ProviderSectionProps {
   draft: ProviderDraft
   epoch: number
   disabled?: boolean
-  t(key: string): string
+  t: Translate
   onRemove(): void
   onPatch(patch: Partial<ProviderDraft>): void
 }

package/src/config.ts

@@ -90,6 +90,13 @@ export interface ProviderProfileConfig {
   extends?: string
   displayName?: string
   api?: ProtocolId
+  /**
+   * 端点；缺省继承 extends 源 provider 的端点。
+   *
+   * 不并 `| undefined`：schemastery 的输入契约用 null 表示「显式置空」，省略即未设置；
+   * 消费方按 `baseURL ?? 默认值` 处理。并上 undefined 会与 ObjectS 的 `string | null`
+   * 冲突（exactOptionalPropertyTypes 下二者不可互赋）。
+   */
   baseURL?: string
   apiKeyEnv?: string
   headers?: Record<string, string>