dsh-plugin-effort-declare 0.1.3 → 0.1.5

package/src/client/README.md

@@ -7,22 +7,23 @@
   </samp>
 </p>
 
-浏览器半区：在 Web UI 的设置面板注册「推理档位」，并经官方 settings RPC 写入 `llm-pi-ai`。
+浏览器半区：在 Web UI 的设置面板注册「推理档位」，并经官方 settings RPC 向 `llm-pi-ai` 写入每模型的 `reasoningEfforts` 与 `input`。
 
-`apply` 接线失败会抛出，与官方模型页相同；不要整段 `try/catch` 吞掉。卸载时 locale、CSS 与事件订阅随 `ctx.effect` 清理。
+缺失的 inject 服务会让插件停在 PENDING，`apply` 不会跑到。不要给 `apply` 套整段 `try/catch`（与官方模型页相同）。RPC 方法缺失时设置页显示加载错误，不要用空列表冒充成功。卸载时 locale、CSS 与事件订阅随 `ctx.effect` 清理。
 
-跨插件协作只使用 Cordis 服务（`connection`、`settingsScope`、`settingsSchema`、`slots`、`locale`、`remote`）。不要 value-import `@deepseek-ai/dsh-client-ui-settings-models`：client bundle 的 purity 规则禁止把其它 `@deepseek-ai/*` 打进包内（shell 冻结模块表里的平台模块除外）。
+跨插件协作只使用 Cordis 服务（`remote` / `remote.llm` / `remote.settings`、`settingsScope`、`settingsSchema`、`slots`、`locale`）。不要 value-import `@deepseek-ai/dsh-client-ui-settings-models`：client bundle 的 purity 规则禁止把其它 `@deepseek-ai/*` 打进包内（shell 冻结模块表里的平台模块除外）。
 
 ## 这个目录里有什么
 
 | 文件 | 说明 |
 | --- | --- |
-| [`index.ts`](./index.ts) | 注册 zh/en 文案、CSS（`ctx.effect` 插入/移除）与 `settings.section`（id `effort-declare`，order 12）。`describe.subscribe` 只同步 `writable`（任意 namespace 都会触发，含自己的 `acceptView`）。`settings/document-updated`（仅 `llm-pi-ai`）带上 Host 的 revision；设置页跳过自己这次 mutate 的回声，等镜像 revision **追上**后再 `getSnapshot()`，不把 `ensure()` 当刷新。提供方目录来自 `llm/adapters-updated`；`connection/reset` 走 `ensure()` 以便等待官方镜像的 in-flight `load()`。`locale: NS` 由框架注入 `t`，inject 只传 `api` / `describe` / `schema` / `subscribeInvalidate`。 |
-| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | 路由卡片、预设、Off 三态、高级协议开关、保存与取消。保存互斥到整个 `llm-pi-ai` namespace（以 ref 防连点）；`busy` 只给正在 mutate 的卡显示「保存中」，其它卡 `saveLocked`。自己写入成功立刻同步 `draftsRef` 并走 `acceptView` + `applySaveSuccess`。保存过程中到达的外部 `document-updated` 会在结束后补刷。无冲突的 reload 清掉该卡 conflict/error notice。页脚显示打包时冻结的版本与版权年。 |
+| [`index.ts`](./index.ts) | 注册 zh/en 文案、CSS（`ctx.effect` 插入/移除）与 `settings.section`（id `effort-declare`，order 12）。`describe.subscribe` 只同步 `writable`（任意 namespace 都会触发，含自己的 `acceptView`）。`settings/document-updated`（仅 `llm-pi-ai`）带上 Host 的 revision；设置页跳过自己这次 mutate 的回声，等镜像 revision **追上**后再 `getSnapshot()`，不把 `ensure()` 当刷新。提供方目录来自 `llm/adapters-updated`；`connection/reset` 走 `ensure()` 以便等待官方镜像的 in-flight `load()`。`locale: NS` 由框架注入 `t`；slot 的 `inject()` 只返回 `llm` / `settings` / `describe` / `schema` / `subscribeInvalidate`。 |
+| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | 路由卡片、预设、Off 三态、每模型「支持图片输入」、高级协议开关、保存与取消。保存互斥到整个 `llm-pi-ai` namespace（以 ref 防连点）；`busy` 只给正在 mutate 的卡显示「保存中」，其它卡 `saveLocked`。保存前用 `modelRowError` 拦截空档位、只开 Off 与非法 `input`。自己写入成功立刻同步 `draftsRef` 并走 `acceptView` + `applySaveSuccess`。保存过程中到达的外部 `document-updated` 会在结束后补刷。无冲突的 reload 清掉该卡 conflict/error notice。页脚显示打包时冻结的版本与版权年。 |
 | [`build-info.ts`](./build-info.ts) | 读取 tsdown `define` 注入的 `package.json` version 与 UTC 打包年，拼出页脚文案。 |
 | [`globals.d.ts`](./globals.d.ts) | `__PLUGIN_VERSION__` / `__COPYRIGHT_TO__` 的类型声明。 |
-| [`load-drafts.ts`](./load-drafts.ts) | 从 `llm.providers` + 镜像组装草稿；草稿取自 `user`，协议分类可用 `value`。`thinkingFormat` 可选项只来自现场 schema union。首屏 `ensure()`；刷新只读 `getSnapshot()`，并提供等 namespace revision 的 helper。 |
-| [`locales.ts`](./locales.ts) | 文案 namespace `plugin-effort-declare`。 |
+| [`load-drafts.ts`](./load-drafts.ts) | 从 `llm.listConfigurableProviders` + 镜像组装草稿；草稿取自 `user`，协议分类可用 `value`。`thinkingFormat` 可选项只来自现场 schema union。首屏 `ensure()`；刷新只读 `getSnapshot()`，并提供等 namespace revision 的 helper。 |
+| [`remotes.ts`](./remotes.ts) | 本页实际调用的 DSH 0.1.2 Remote 方法：`listConfigurableProviders` 与 `settings.mutate`（成功 `{ ok, value }`，失败 `{ ok: false, error }`，冲突码 `settings/conflict`）。 |
+| [`locales.ts`](./locales.ts) | 文案 namespace `plugin-effort-declare`（含档位、图片输入与校验错误）。 |
 | [`effort-declare.module.css`](./effort-declare.module.css) | 仅使用 `--dsw-alias-*` 设计令牌，保证暗色主题正确。 |
 | [`schema-ops.ts`](./schema-ops.ts) | 将 `settingsSchema` 收成普通回调（含 `validate`），避免把服务身份带进 React。 |
 

package/src/client/index.ts

@@ -2,11 +2,11 @@
  * dsh-plugin-effort-declare — browser half: settings.section for per-model
  * reasoning effort declarations.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
-import type { ConnectionHandle } from '@deepseek-ai/dsh-api-remotes/client'
+import type { Context } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import type {} from '@deepseek-ai/dsh-client-locale/client'
 import type {} from '@deepseek-ai/dsh-api-remotes/client'
+import type { SlotCore } from '@deepseek-ai/dsh-client-ui-slots'
 import { EffortDeclareSection } from './EffortDeclareSection.tsx'
 import type { EffortDeclareSectionInjected, Invalidation } from './EffortDeclareSection.tsx'
 import { bindSchema } from './schema-ops.ts'
@@ -21,7 +21,36 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
   }
 }
 
-export const inject = ['slots', 'locale', 'connection', 'remote', 'settingsScope', 'settingsSchema']
+/**
+ * `slots` and `connection/reset` are provided by the unpublished
+ * dsh-client-runtime wrapper. 0.1.2-alpha.2 did not publish that package;
+ * the shapes match the official models page and SlotCore.
+ */
+declare module '@deepseek-ai/cordis' {
+  interface Events {
+    /**
+     * A connection generation was (re-)established. Wire-derived caches must
+     * treat their state as stale and repull.
+     * @mode emit
+     */
+    'connection/reset'(): void
+  }
+  interface Context {
+    slots: SlotCore & {
+      inject(name: string, factory: () => unknown): unknown
+    }
+  }
+}
+
+export const inject = [
+  'slots',
+  'locale',
+  'remote',
+  'remote.llm',
+  'remote.settings',
+  'settingsScope',
+  'settingsSchema',
+]
 
 const PLUGIN_ID = 'dsh-plugin-effort-declare'
 
@@ -39,11 +68,10 @@ function mountPluginCss(): () => void {
   return () => { tag?.remove() }
 }
 
-export function apply(ctx: ClientContext): void {
+export function apply(ctx: Context): void {
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), `${PLUGIN_ID}: dictionaries`)
   ctx.effect(() => mountPluginCss(), `${PLUGIN_ID}: css`)
 
-  const connection = ctx.get('connection') as ConnectionHandle
   const settingsSchema = ctx.settingsSchema
   const schema = bindSchema({
     rehydrate: serialized => settingsSchema.rehydrate(serialized),
@@ -97,7 +125,8 @@ export function apply(ctx: ClientContext): void {
     label: () => t('nav'),
     locale: NS,
     inject: (): EffortDeclareSectionInjected => ({
-      api: connection.api,
+      llm: ctx.remote.llm,
+      settings: ctx.remote.settings,
       describe,
       schema,
       subscribeInvalidate,

package/src/client/load-drafts.ts

@@ -1,5 +1,5 @@
 /**
- * Load editable route drafts from llm.providers + the llm-pi-ai namespace.
+ * Load editable route drafts from llm.listConfigurableProviders + the llm-pi-ai namespace.
  * Drafts come from the user layer; route protocol classification may use effective value.
  *
  * First paint uses `ensure()` (idle-only). Refresh never calls `ensure()`:
@@ -8,8 +8,8 @@
  * by revision (including older delayed echoes), not ignored as a generic
  * document-updated.
  */
-import type { IApiClient, SettingsNamespaceView } from '@deepseek-ai/dsh-api-remotes/client'
 import type { SettingsDescribeFace } from '@deepseek-ai/dsh-client-ui-settings/client'
+import type { LlmDirectoryRemote } from './remotes.ts'
 import {
   LLM_PI_AI_NS,
   SCHEMA_PROBE_ROUTE,
@@ -136,7 +136,7 @@ export async function waitForNamespaceRevisionChange(
 }
 
 async function assembleDrafts(
-  api: Pick<IApiClient, 'llm'>,
+  llm: LlmDirectoryRemote,
   describe: Pick<SettingsDescribeFace, 'getSnapshot'>,
   schema: SchemaOps,
 ): Promise<LoadDraftsResult> {
@@ -144,16 +144,16 @@ async function assembleDrafts(
   if (mirrored.view === undefined) {
     return { writable: false, formats: [], drafts: [], error: mirrored.error ?? undefined }
   }
-  const providersResponse = await api.llm.providers({})
-  if (!providersResponse.result.ok) {
+  const providersResponse = await llm.listConfigurableProviders()
+  if (!providersResponse.ok) {
     return {
       writable: mirrored.view.writable,
       formats: [],
       drafts: [],
-      error: providersResponse.result.error.message,
+      error: providersResponse.error.message,
     }
   }
-  const namespaces = new Map(mirrored.view.namespaces.map((view: SettingsNamespaceView) => [view.ns, view]))
+  const namespaces = new Map(mirrored.view.namespaces.map(view => [view.ns, view]))
   const pi = namespaces.get(LLM_PI_AI_NS)
   let formats: string[] = []
   let schemaDefaultApi: string | undefined
@@ -169,7 +169,7 @@ async function assembleDrafts(
     }
   }
   const drafts: RouteDraft[] = []
-  for (const entry of providersResponse.result.value.providers) {
+  for (const entry of providersResponse.value) {
     const settingsPath = entry.settingsPath !== undefined && entry.settingsPath.length > 0
       ? [...entry.settingsPath]
       : ['providers', entry.provider]
@@ -191,11 +191,11 @@ async function assembleDrafts(
  * `snapshot`: refresh after the mirror revision already moved — do not ensure.
  */
 export async function loadDrafts(
-  api: Pick<IApiClient, 'llm'>,
+  llm: LlmDirectoryRemote,
   describe: Pick<SettingsDescribeFace, 'ensure' | 'getSnapshot'>,
   schema: SchemaOps,
   mode: LoadDraftsMode = 'ensure',
 ): Promise<LoadDraftsResult> {
   if (mode === 'ensure') await describe.ensure()
-  return assembleDrafts(api, describe, schema)
+  return assembleDrafts(llm, describe, schema)
 }

package/src/client/locales.ts

@@ -44,15 +44,18 @@ export type EffortDeclareKey =
   | 'errorBadWire'
   | 'noModels'
   | 'reload'
+  | 'imageInput'
+  | 'imageInputHint'
+  | 'errorBadInput'
 
 export const NS = 'plugin-effort-declare'
 
 export const zh: Record<EffortDeclareKey, string> = {
   nav: '推理档位',
   title: '推理档位声明',
-  intro: '本页声明「这模型能选哪些推理档」。对话里的档位选择仍在输入框模型菜单。没声明 = 和现在一样没有 Effort 行。不会改密钥、目录或当次选择。',
+  intro: '声明手工模型可提供的推理档位，以及是否接受图片输入。未声明则不显示 Effort 行，图片附件也会被拒绝。档位仍在输入框菜单中选择；密钥、目录与当前选中项不在本页修改。',
   empty: '没有可编辑的手工 openai-completions 路由。',
-  emptyHint: '请先到「模型」页添加提供方（llm-pi-ai 手工路由）。官方 DeepSeek 与 catalog 路由不在本页编辑。需要 DSH ≥ 0.1.0-rc.8（providers.declared）。',
+  emptyHint: '请先到「模型」页添加提供方（llm-pi-ai 手工路由）。官方 DeepSeek 与 catalog 路由不在本页编辑。需要 DSH ≥ 0.1.2-alpha.2。',
   loadError: '无法加载提供方或设置。',
   loading: '正在加载…',
   readOnly: '当前设置为只读，无法保存。',
@@ -60,7 +63,7 @@ export const zh: Record<EffortDeclareKey, string> = {
   saving: '保存中…',
   saveBusy: '另有路由正在保存，请稍候。',
   cancel: '取消',
-  saved: '已保存。对话选择器会按新的能力声明显示 Effort 行。',
+  saved: '已保存。对话会按新的能力声明更新 Effort 行和是否允许贴图。',
   conflict: '设置已被其他地方改过，请重新加载后再保存。',
   dirtyConflict: '此路由有未保存修改，设置已在其他地方更新。保存会写到最新文档上，或先取消再改。',
   presets: '预设',
@@ -89,14 +92,17 @@ export const zh: Record<EffortDeclareKey, string> = {
   errorBadWire: '思考档必须填写线上拼写；只有 Off 可以留空。不能使用未知档位键。',
   noModels: '这条路由还没有 models 列表。请先到「模型」页添加模型。',
   reload: '重新加载',
+  imageInput: '支持图片输入',
+  imageInputHint: '只在这个模型确实能看图时勾选。勾错了图会进聊天记录，然后被接口打回来。',
+  errorBadInput: 'input 只能是 text / image，必须包含 text，不能重复或留空。不支持图片请清除该键，不要写成空列表。',
 }
 
 export const en: Record<EffortDeclareKey, string> = {
   nav: 'Reasoning efforts',
   title: 'Reasoning effort declarations',
-  intro: 'This page declares which reasoning levels a model can offer. The per-turn choice stays in the composer model menu. Undeclared models keep having no Effort row. Keys, catalogs, and the current selection are not edited here.',
+  intro: 'Declare reasoning levels and image input for hand-added models. Undeclared models omit the Effort row and refuse image attachments. Effort is still chosen in the composer menu; keys, catalogs, and the current selection are not modified here.',
   empty: 'No editable hand-declared openai-completions routes.',
-  emptyHint: 'Add a provider on the Models page first (an llm-pi-ai hand-declared route). Official DeepSeek and catalog routes are not edited here. Requires DSH ≥ 0.1.0-rc.8 (providers.declared).',
+  emptyHint: 'Add a provider on the Models page first (an llm-pi-ai hand-declared route). Official DeepSeek and catalog routes are not edited here. Requires DSH ≥ 0.1.2-alpha.2.',
   loadError: 'Could not load providers or settings.',
   loading: 'Loading…',
   readOnly: 'Settings are read-only; saving is disabled.',
@@ -104,7 +110,7 @@ export const en: Record<EffortDeclareKey, string> = {
   saving: 'Saving…',
   saveBusy: 'Another route is saving. Wait, then save this card.',
   cancel: 'Cancel',
-  saved: 'Saved. The composer Effort row follows this capability declaration.',
+  saved: 'Saved. The composer Effort row and image admission follow this capability declaration.',
   conflict: 'Settings changed elsewhere. Reload, then save again.',
   dirtyConflict: 'This route has unsaved edits and settings changed elsewhere. Save writes onto the latest document, or cancel first.',
   presets: 'Presets',
@@ -133,4 +139,7 @@ export const en: Record<EffortDeclareKey, string> = {
   errorBadWire: 'Thinking levels need a wire spelling; only Off may be empty. Unknown effort keys are rejected.',
   noModels: 'This route has no models list yet. Add models on the Models page first.',
   reload: 'Reload',
+  imageInput: 'Accepts image input',
+  imageInputHint: 'Check only if this model actually sees images. Over-claiming admits a picture into history, then the gateway rejects the turn.',
+  errorBadInput: 'input may only list text and image, must include text, and must not be empty or duplicated. To drop vision, unset the key; do not write [].',
 }

package/src/client/remotes.ts

@@ -0,0 +1,39 @@
+/**
+ * Client Remote faces this page actually calls (DSH 0.1.2).
+ * Shapes match the generated Host descriptors, not the removed IApiClient.
+ */
+import type { SettingsDescribeFace } from '@deepseek-ai/dsh-client-ui-settings/client'
+import type { ProviderDirectoryEntry } from '../core/filter.ts'
+import type { PathOp } from '../core/path-ops.ts'
+
+/** Gateway envelope for a successful Remote call. */
+export type RemoteOk<T> = { ok: true; value: T }
+
+/** Gateway envelope for a failed Remote call. */
+export type RemoteErr = { ok: false; error: { code: string; message: string } }
+
+export type RemoteResult<T> = RemoteOk<T> | RemoteErr
+
+/**
+ * `llm.listConfigurableProviders` — generated
+ * `@deepseek-ai/dsh-llm#llm/listConfigurableProviders`.
+ * `value` is the directory array (no `{ providers }` wrapper).
+ */
+export interface LlmDirectoryRemote {
+  listConfigurableProviders(): Promise<RemoteResult<readonly ProviderDirectoryEntry[]>>
+}
+
+type NamespaceView = Parameters<SettingsDescribeFace['acceptView']>[0]
+
+/**
+ * `settings.mutate` — generated
+ * `@deepseek-ai/dsh-api-settings-controller#settings/mutate`.
+ * Conflict code is `settings/conflict`.
+ */
+export interface SettingsWriteRemote {
+  mutate(
+    ns: string,
+    ops: readonly PathOp[],
+    expectedRevision: number | undefined,
+  ): Promise<RemoteResult<NamespaceView>>
+}

package/src/core/README.en.md

@@ -7,22 +7,23 @@
   </samp>
 </p>
 
-Domain logic for the plugin: no React, no Cordis service instances. The settings page and Vitest both depend on these pure functions, so effort semantics can regress without booting DSH.
+Domain logic for the plugin: no React, no Cordis service instances. The settings page and Vitest both depend on these pure functions, so reasoning-effort and image-input semantics can regress without booting DSH.
 
-Canonical level names and `thinkingFormat` values follow `@deepseek-ai/dsh-llm-pi-ai` (0.1.0-rc.8; 0.1.1-rc.2 uses the same level set). `thinkingFormat` is pinned to the live-schema snapshot in [`tests/fixtures/pi-ai-thinking-format-union.ts`](../../tests/fixtures/pi-ai-thinking-format-union.ts); effort keys stay a locally pinned whitelist. UI choices come only from the live schema union.
+Canonical level names and `thinkingFormat` values follow `@deepseek-ai/dsh-llm-pi-ai` (0.1.2-alpha.2; the level set matches rc.8, and `thinkingFormat` adds `baseten`). `thinkingFormat` is pinned to the live-schema snapshot in [`tests/fixtures/pi-ai-thinking-format-union.ts`](../../tests/fixtures/pi-ai-thinking-format-union.ts); effort keys stay a locally pinned whitelist. UI choices come only from the live schema union. Writable `models[].input` modalities are `text` and `image`, matching the official schema.
 
 ## What's in this directory
 
 | File | Role |
 | --- | --- |
-| [`catalog.ts`](./catalog.ts) | Canonical level order, `thinkingFormat` fallback list, `llm-pi-ai` / DeepSeek constants. |
+| [`catalog.ts`](./catalog.ts) | Canonical level order, `thinkingFormat` fallback list, request modalities (`INPUT_MODALITIES` / `IMAGE_CAPABLE_INPUT`), `llm-pi-ai` / DeepSeek constants. |
 | [`efforts.ts`](./efforts.ts) | `reasoningEfforts` read/write, Off tri-state (value mode stores `trim()`), validation (empty object / Off-only / unknown keys return an error code, never throw). |
-| [`presets.ts`](./presets.ts) | DeepSeek, OpenAI, and on/off presets; each states all three dialect keys; spread onto existing model rows and route `compat`. |
+| [`input.ts`](./input.ts) | Per-model `input`: checking writes `['text', 'image']`, unchecking deletes the key; empty list / image-only / duplicates / unknown modalities return an error code. |
+| [`presets.ts`](./presets.ts) | DeepSeek, OpenAI, and on/off presets; each states all three dialect keys; spread onto existing model rows and route `compat`, leaving existing `input` intact. |
 | [`path-ops.ts`](./path-ops.ts) | Same one-level key diff as the official Models page; `buildSaveOps` uses `settingsPath` and only submits that route’s full `models` table and dirty `compat` keys. |
-| [`drafts.ts`](./drafts.ts) | User-layer drafts, dirty aligned with pathOps, post-save revision. On refresh, latest user-layer model membership wins; unsaved `reasoningEfforts` (including a cleared key) overlay by id; `compat` is a per-key 3-way merge. Conflict only when a locally dirty field also moved in originals (revision-only bumps and sibling-card saves do not warn). |
+| [`drafts.ts`](./drafts.ts) | User-layer drafts, dirty aligned with pathOps, post-save revision. On refresh, latest user-layer model membership wins; unsaved overlay keys (`reasoningEfforts` and `input` independently, including a cleared key) overlay by id; `compat` is a per-key 3-way merge. Conflict only when a locally dirty field also moved in originals (revision-only bumps and sibling-card saves do not warn). |
 | [`paths.ts`](./paths.ts) | Nested reads; clones of objects and model tables (non-object rows skipped). |
 | [`filter.ts`](./filter.ts) | Which routes are editable: hand-declared `llm-pi-ai` + openai-completions; skip catalog and official DeepSeek. |
-| [`validate.ts`](./validate.ts) | Per-row `reasoningEfforts` validation. |
+| [`validate.ts`](./validate.ts) | Per-row validation: `reasoningEfforts` first, then `input`. |
 | [`attribution.ts`](./attribution.ts) | Settings footer line: `version © year Stardust`. Start year is 2026; end year is the UTC year at pack time, not the user’s clock when DSH starts. |
 
-An **absent** field means default-off. Do not encode “undeclared” as `reasoningEfforts: false` — in official semantics `false` strips reasoning from a catalog model.
+An **absent** field means default-off. Do not encode an undeclared effort as `reasoningEfforts: false` — in official semantics `false` strips reasoning from a catalog model. Do not encode “no vision” as `input: []` — the official resolver treats an empty list as absent, but a bad stamp must not be re-saved. Disabling image input must delete the key; do not write `['text']`.

package/src/core/README.md

@@ -7,22 +7,23 @@
   </samp>
 </p>
 
-本插件的领域逻辑：无 React、无 Cordis 服务实例。设置页与 Vitest 都只依赖这些纯函数，因此档位语义可以在不启动 DSH 的情况下回归。
+本插件的领域逻辑：无 React、无 Cordis 服务实例。设置页与 Vitest 都只依赖这些纯函数，因此推理档位与图片输入语义可以在不启动 DSH 的情况下回归。
 
-规范键名与 `thinkingFormat` 取值对齐 `@deepseek-ai/dsh-llm-pi-ai`（0.1.0-rc.8；0.1.1-rc.2 档位集合相同）。`thinkingFormat` 由 [`tests/fixtures/pi-ai-thinking-format-union.ts`](../../tests/fixtures/pi-ai-thinking-format-union.ts) 钉现场 schema；档位键由测试钉本地白名单。UI 可选项只来自现场 schema union。
+规范键名与 `thinkingFormat` 取值对齐 `@deepseek-ai/dsh-llm-pi-ai`（0.1.2-alpha.2；档位集合与 rc.8 相同，`thinkingFormat` 增加 `baseten`）。`thinkingFormat` 由 [`tests/fixtures/pi-ai-thinking-format-union.ts`](../../tests/fixtures/pi-ai-thinking-format-union.ts) 钉现场 schema；档位键由测试钉本地白名单。UI 可选项只来自现场 schema union。`models[].input` 的可写模态为 `text` 与 `image`，与官方 schema 一致。
 
 ## 这个目录里有什么
 
 | 文件 | 说明 |
 | --- | --- |
-| [`catalog.ts`](./catalog.ts) | 规范档位顺序、`thinkingFormat` 回退列表、`llm-pi-ai` / DeepSeek 相关常量。 |
+| [`catalog.ts`](./catalog.ts) | 规范档位顺序、`thinkingFormat` 回退列表、请求模态（`INPUT_MODALITIES` / `IMAGE_CAPABLE_INPUT`）、`llm-pi-ai` / DeepSeek 相关常量。 |
 | [`efforts.ts`](./efforts.ts) | `reasoningEfforts` 读写、Off 三态（value 模式写入 `trim()` 后的字符串）、校验（空对象 / 只开 Off / 未知键返回错误码，不抛异常）。 |
-| [`presets.ts`](./presets.ts) | DeepSeek、OpenAI、仅开/关三套预设；每套对三个方言键都表态；spread 到已有模型行与路由 `compat`。 |
+| [`input.ts`](./input.ts) | 每模型 `input`：勾选写入 `['text', 'image']`，取消删除该键；空列表 / 仅 image / 重复 / 未知模态返回错误码。 |
+| [`presets.ts`](./presets.ts) | DeepSeek、OpenAI、仅开/关三套预设；每套对三个方言键都表态；spread 到已有模型行与路由 `compat`，保留已有 `input`。 |
 | [`path-ops.ts`](./path-ops.ts) | 与官方模型页相同的一层键 diff；`buildSaveOps` 使用 `settingsPath`，只提交该路由的 `models` 整表和有差异的 `compat` 键。 |
-| [`drafts.ts`](./drafts.ts) | 用户层草稿、dirty 与 pathOps 一致、保存后 revision。刷新时以最新用户层模型名单为成员真理，按 id 贴回未保存的 `reasoningEfforts`（含已清除=删键）；`compat` 按键三路合并。冲突仅当本地脏字段的 originals 也变了（只 bump revision 或别的卡保存不报）。 |
+| [`drafts.ts`](./drafts.ts) | 用户层草稿、dirty 与 pathOps 一致、保存后 revision。刷新时以最新用户层模型名单为成员真理，按 id 贴回未保存的 overlay 键（`reasoningEfforts` 与 `input` 独立，含已清除 = 删键）；`compat` 按键三路合并。冲突仅当本地脏字段的 originals 也变了（只 bump revision 或别的卡保存不报）。 |
 | [`paths.ts`](./paths.ts) | 嵌套读取、对象与模型表的 clone（非对象行跳过）。 |
 | [`filter.ts`](./filter.ts) | 哪些路由可编辑：手工 `llm-pi-ai` + openai-completions；排除 catalog 与官方 DeepSeek。 |
-| [`validate.ts`](./validate.ts) | 对单行 `reasoningEfforts` 调用校验。 |
+| [`validate.ts`](./validate.ts) | 对单行先校验 `reasoningEfforts`，再校验 `input`。 |
 | [`attribution.ts`](./attribution.ts) | 设置页页脚：`version © 年 Stardust`。首年写死 2026，结束年由打包时的 UTC 年注入，不是用户打开 DSH 的日期。 |
 
-**缺席字段**表示默认关闭。不要把「未声明」写成 `reasoningEfforts: false`——`false` 在官方语义里是从 catalog 模型上剥掉推理。
+**缺席字段**表示默认关闭。不要把「未声明档位」写成 `reasoningEfforts: false`——`false` 在官方语义里是从 catalog 模型上剥掉推理。不要把「未声明视觉」写成 `input: []`——官方把空列表当成缺席，但坏戳记不应被重新保存。取消图片输入必须删除该键，而不是写成 `['text']`。

package/src/core/catalog.ts

@@ -2,7 +2,7 @@
  * Canonical thinking levels and openai-completions thinkingFormat names.
  *
  * Levels match `@deepseek-ai/dsh-llm-pi-ai` catalog.ts `THINKING_LEVELS`.
- * Formats match `SUPPORTED_THINKING_FORMATS` in the same file (rc.8).
+ * Formats match `SUPPORTED_THINKING_FORMATS` in the same file (0.1.2-alpha.2).
  * Tests pin these lists against a checked-in schema fixture
  * (`tests/fixtures/pi-ai-thinking-format-union.ts`) and the local level
  * whitelist. The settings page never offers the handwritten thinkingFormat
@@ -29,7 +29,7 @@ export const THINKING_LEVELS_WITHOUT_OFF = THINKING_LEVELS.filter(
 )
 
 /**
- * openai-completions thinkingFormat values from llm-pi-ai catalog.ts rc.8.
+ * openai-completions thinkingFormat values from llm-pi-ai catalog.ts 0.1.2-alpha.2.
  * Test pin only — not a writable UI fallback.
  */
 export const FALLBACK_THINKING_FORMATS = [
@@ -37,6 +37,7 @@ export const FALLBACK_THINKING_FORMATS = [
   'deepseek',
   'openrouter',
   'together',
+  'baseten',
   'zai',
   'qwen',
   'chat-template',
@@ -61,3 +62,14 @@ export const DEEPSEEK_OFFICIAL = 'deepseek-official'
 
 /** Any route key walks a dict schema to the same profile node. */
 export const SCHEMA_PROBE_ROUTE = '\u0000probe'
+
+/** Request modalities llm-pi-ai accepts on `models[].input` / `defaultInput`. */
+export const INPUT_MODALITIES = ['text', 'image'] as const
+
+export type InputModality = (typeof INPUT_MODALITIES)[number]
+
+/**
+ * Canonical write for a hand-declared vision model.
+ * Must include `text`; image-only is not a serviceable OpenAI-completions route.
+ */
+export const IMAGE_CAPABLE_INPUT: readonly InputModality[] = ['text', 'image']

package/src/core/drafts.ts

@@ -10,7 +10,7 @@ import { cloneModels, cloneObject, isPlainObject } from './paths.ts'
 export interface RouteDraft {
   provider: string
   displayName: string
-  /** Path inside the llm-pi-ai section (`llm.providers[].settingsPath`). */
+  /** Path inside the llm-pi-ai section (`listConfigurableProviders[].settingsPath`). */
   settingsPath: readonly string[]
   /** Namespace revision (one value for the whole llm-pi-ai document). */
   revision: number
@@ -112,31 +112,42 @@ function indexById(rows: readonly Record<string, unknown>[]): Map<string, Record
   return map
 }
 
-function effortsPresence(row: Record<string, unknown> | undefined): { present: boolean; value: unknown } {
-  if (row === undefined || !Object.hasOwn(row, 'reasoningEfforts')) {
+/** Model-row fields this page edits; other keys follow the Models page. */
+export const MODEL_OVERLAY_KEYS = ['reasoningEfforts', 'input'] as const
+
+export type ModelOverlayKey = (typeof MODEL_OVERLAY_KEYS)[number]
+
+function fieldPresence(
+  row: Record<string, unknown> | undefined,
+  key: ModelOverlayKey,
+): { present: boolean; value: unknown } {
+  if (row === undefined || !Object.hasOwn(row, key)) {
     return { present: false, value: undefined }
   }
-  return { present: true, value: row.reasoningEfforts }
+  return { present: true, value: row[key] }
 }
 
-function effortsEqual(
-  left: { present: boolean; value: unknown },
-  right: { present: boolean; value: unknown },
+function fieldEqual(
+  left: Record<string, unknown> | undefined,
+  right: Record<string, unknown> | undefined,
+  key: ModelOverlayKey,
 ): boolean {
-  if (left.present !== right.present) return false
-  if (!left.present) return true
-  return sliceEqual(left.value, right.value)
+  const a = fieldPresence(left, key)
+  const b = fieldPresence(right, key)
+  if (a.present !== b.present) return false
+  if (!a.present) return true
+  return sliceEqual(a.value, b.value)
 }
 
-function overlayLocalEfforts(
+function overlayLocalFields(
   incomingRow: Record<string, unknown>,
   prevRow: Record<string, unknown>,
+  keys: readonly ModelOverlayKey[],
 ): Record<string, unknown> {
   const next = structuredClone(incomingRow)
-  if (Object.hasOwn(prevRow, 'reasoningEfforts')) {
-    next.reasoningEfforts = structuredClone(prevRow.reasoningEfforts)
-  } else {
-    delete next.reasoningEfforts
+  for (const key of keys) {
+    if (Object.hasOwn(prevRow, key)) next[key] = structuredClone(prevRow[key])
+    else delete next[key]
   }
   return next
 }
@@ -155,7 +166,8 @@ function objectKeyChanged(
 
 /**
  * Membership follows the latest user-layer models list (Models page add/delete).
- * Local unsaved `reasoningEfforts` (including a cleared key) overlay by id.
+ * Local unsaved overlay keys (including a cleared key) overlay by id; other
+ * fields on the row follow incoming.
  */
 export function mergeModelsById(args: {
   prevModels: readonly Record<string, unknown>[]
@@ -174,21 +186,23 @@ export function mergeModelsById(args: {
     const prevRow = prevById.get(id)
     if (prevRow === undefined) return structuredClone(incomingRow)
     const prevOrig = prevOrigById.get(id)
-    const localDirty = !effortsEqual(effortsPresence(prevRow), effortsPresence(prevOrig))
-    if (!localDirty) return structuredClone(incomingRow)
+    const dirtyKeys = MODEL_OVERLAY_KEYS.filter(key => !fieldEqual(prevRow, prevOrig, key))
+    if (dirtyKeys.length === 0) return structuredClone(incomingRow)
     const incomingOrig = incomingOrigById.get(id)
-    if (!effortsEqual(effortsPresence(prevOrig), effortsPresence(incomingOrig))) {
-      conflicted = true
+    for (const key of dirtyKeys) {
+      if (!fieldEqual(prevOrig, incomingOrig, key)) conflicted = true
     }
-    return overlayLocalEfforts(incomingRow, prevRow)
+    return overlayLocalFields(incomingRow, prevRow, dirtyKeys)
   })
 
   for (const [id, prevRow] of prevById) {
     if (incomingIds.has(id)) continue
     const prevOrig = prevOrigById.get(id)
-    if (effortsEqual(effortsPresence(prevRow), effortsPresence(prevOrig))) continue
-    if (!effortsEqual(effortsPresence(prevOrig), effortsPresence(incomingOrigById.get(id)))) {
-      conflicted = true
+    const dirtyKeys = MODEL_OVERLAY_KEYS.filter(key => !fieldEqual(prevRow, prevOrig, key))
+    if (dirtyKeys.length === 0) continue
+    const incomingOrig = incomingOrigById.get(id)
+    for (const key of dirtyKeys) {
+      if (!fieldEqual(prevOrig, incomingOrig, key)) conflicted = true
     }
   }
 
@@ -222,9 +236,9 @@ export function mergeCompat(args: {
 
 /**
  * Apply a freshly loaded table. Membership and metadata follow incoming;
- * unsaved reasoningEfforts / dirty compat keys overlay by id. Conflict only
- * when a locally dirty field also changed in originals (revision-only bumps
- * and sibling-card saves do not warn).
+ * unsaved overlay keys (`reasoningEfforts`, `input`) / dirty compat keys
+ * overlay by id. Conflict only when a locally dirty field also changed in
+ * originals (revision-only bumps and sibling-card saves do not warn).
  */
 export function mergeLoadedDrafts(
   current: readonly RouteDraft[],

package/src/core/filter.ts

@@ -6,7 +6,7 @@ import {
 } from './catalog.ts'
 import { getPath, isPlainObject } from './paths.ts'
 
-/** Directory row from `llm.providers()` (the fields v1 filtering reads). */
+/** Directory row from `llm.listConfigurableProviders()` (the fields v1 filtering reads). */
 export interface ProviderDirectoryEntry {
   provider: string
   displayName?: string

package/src/core/input.ts

@@ -0,0 +1,49 @@
+/**
+ * Per-model `input` modalities as stored in llm-pi-ai settings.
+ * Absence falls through to route `defaultInput` (`[text]`). Empty list is
+ * treated as absent by the official resolver — do not write `[]`.
+ */
+import { IMAGE_CAPABLE_INPUT, INPUT_MODALITIES } from './catalog.ts'
+
+/** Whether the stored `input` list includes image. Absence is false. */
+export function readImageCapable(row: Record<string, unknown>): boolean {
+  const value = row.input
+  return Array.isArray(value) && value.includes('image')
+}
+
+/**
+ * Declare or drop image input on a spread row.
+ * Enabled writes `[text, image]`; disabled unsets the key (not `[]`, not `[text]`).
+ */
+export function writeImageCapable(
+  row: Record<string, unknown>,
+  enabled: boolean,
+): Record<string, unknown> {
+  const next = { ...row }
+  if (enabled) next.input = [...IMAGE_CAPABLE_INPUT]
+  else delete next.input
+  return next
+}
+
+/**
+ * Validate a stored `input` field. Returns an error code; never throws.
+ * Absence is valid. Empty list is rejected so a bad stamp cannot be re-saved.
+ */
+export function validateInput(input: unknown): 'bad-input' | undefined {
+  if (input === undefined) return undefined
+  if (!Array.isArray(input) || input.length === 0) return 'bad-input'
+  const known = new Set<string>(INPUT_MODALITIES)
+  const seen = new Set<string>()
+  for (const item of input) {
+    if (typeof item !== 'string' || !known.has(item) || seen.has(item)) return 'bad-input'
+    seen.add(item)
+  }
+  if (!seen.has('text')) return 'bad-input'
+  return undefined
+}
+
+/** Per-model client-side check used to show errors without throwing. */
+export function modelInputError(row: Record<string, unknown>): 'bad-input' | undefined {
+  if (!('input' in row) || row.input === undefined) return undefined
+  return validateInput(row.input)
+}

package/src/core/path-ops.ts

@@ -33,7 +33,7 @@ export function pathOps(
 }
 
 export interface SaveSlices {
-  /** Profile path from `llm.providers[].settingsPath` (not a hardcoded route id). */
+  /** Profile path from `listConfigurableProviders[].settingsPath` (not a hardcoded route id). */
   settingsPath: readonly string[]
   /** Models array before the edit (user layer). */
   beforeModels: unknown

package/src/core/validate.ts

@@ -1,7 +1,15 @@
 import { validateReasoningEfforts } from './efforts.ts'
+import { modelInputError } from './input.ts'
+
+export type ModelRowError = 'empty' | 'off-only' | 'bad-wire' | 'bad-input'
 
 /** Per-model client-side check used to show errors without throwing. */
 export function modelEffortError(row: Record<string, unknown>): 'empty' | 'off-only' | 'bad-wire' | undefined {
   if (!('reasoningEfforts' in row) || row.reasoningEfforts === undefined) return undefined
   return validateReasoningEfforts(row.reasoningEfforts)
 }
+
+/** First blocking error on a model row (efforts, then input). */
+export function modelRowError(row: Record<string, unknown>): ModelRowError | undefined {
+  return modelEffortError(row) ?? modelInputError(row)
+}