dsh-plugin-effort-declare 0.1.2 → 0.1.4

package/src/client/README.md

@@ -7,7 +7,7 @@
   </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` 清理。
 
@@ -17,10 +17,12 @@
 
 | 文件 | 说明 |
 | --- | --- |
-| [`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`）、`llm/adapters-updated`、`connection/reset`。`locale: NS` 由框架注入 `t`，inject 只传 `api` / `describe` / `schema` / `subscribeInvalidate`。 |
-| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | 路由卡片、预设、Off 三态、高级协议开关、保存与取消。保存互斥到整个 `llm-pi-ai` namespace；`busy` 只给正在 mutate 的卡显示「保存中」，其它卡 `saveLocked`。自己写入成功走 `acceptView` + `applySaveSuccess`，不再全量 reload。 |
-| [`load-drafts.ts`](./load-drafts.ts) | 从 `llm.providers` + 镜像组装草稿；草稿取自 `user`，协议分类可用 `value`。`thinkingFormat` 可选项只来自现场 schema union。 |
-| [`locales.ts`](./locales.ts) | 文案 namespace `plugin-effort-declare`。 |
+| [`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`。保存前用 `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`（含档位、图片输入与校验错误）。 |
 | [`effort-declare.module.css`](./effort-declare.module.css) | 仅使用 `--dsw-alias-*` 设计令牌，保证暗色主题正确。 |
 | [`schema-ops.ts`](./schema-ops.ts) | 将 `settingsSchema` 收成普通回调（含 `validate`），避免把服务身份带进 React。 |
 

package/src/client/build-info.ts

@@ -0,0 +1,12 @@
+/**
+ * Footer line frozen into the client bundle. Do not read the clock or
+ * package.json at DSH startup — host apply is empty and the settings page
+ * runs in the browser.
+ */
+import { COPYRIGHT_FROM, formatAttribution } from '../core/attribution.ts'
+
+export const PLUGIN_FOOTER_TEXT = formatAttribution(
+  __PLUGIN_VERSION__,
+  COPYRIGHT_FROM,
+  __COPYRIGHT_TO__,
+)

package/src/client/effort-declare.module.css

@@ -276,3 +276,11 @@
   font-size: 12px;
   line-height: 18px;
 }
+
+.footer {
+  margin: 16px 0 0;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-tertiary);
+  opacity: 0.7;
+}

package/src/client/globals.d.ts

@@ -0,0 +1,5 @@
+/** `package.json` version, substituted by tsdown `define` at pack time. */
+declare const __PLUGIN_VERSION__: string
+
+/** UTC full year at pack time, substituted by tsdown `define`. */
+declare const __COPYRIGHT_TO__: number

package/src/client/index.ts

@@ -8,7 +8,7 @@ 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 { EffortDeclareSection } from './EffortDeclareSection.tsx'
-import type { EffortDeclareSectionInjected, InvalidationSource } from './EffortDeclareSection.tsx'
+import type { EffortDeclareSectionInjected, Invalidation } from './EffortDeclareSection.tsx'
 import { bindSchema } from './schema-ops.ts'
 import { LLM_PI_AI_NS } from '../core/catalog.ts'
 import { NS, en, zh, type EffortDeclareKey } from './locales.ts'
@@ -60,23 +60,25 @@ export function apply(ctx: ClientContext): void {
   })
   const t = ctx.locale.bind(NS)
   const describe = ctx.settingsScope.describe()
-  const invalidation = new Set<(source: InvalidationSource) => void>()
+  const invalidation = new Set<(event: Invalidation) => void>()
 
   ctx.effect(() => {
-    const emit = (source: InvalidationSource) => {
-      for (const listener of invalidation) listener(source)
+    const emit = (event: Invalidation) => {
+      for (const listener of invalidation) listener(event)
     }
     // Mirror subscribe fires on every namespace (theme, locale, own acceptView).
-    // Only fold writable from that; llm-pi-ai document changes come from the
-    // Host event below so a dirty card is not treated as a conflict.
+    // Only fold writable from that. llm-pi-ai document changes come from
+    // settings/document-updated; the section waits until the mirror revision
+    // has caught up instead of calling ensure(), and skips the echo of its
+    // own mutate. connection/reset uses ensure() so an in-flight load is awaited.
     const disposers = [
-      describe.subscribe(() => { emit('writable') }),
-      ctx.remote.$on('settings/document-updated', (ns: string) => {
+      describe.subscribe(() => { emit({ source: 'writable' }) }),
+      ctx.remote.$on('settings/document-updated', (ns: string, revision: number) => {
         if (ns !== LLM_PI_AI_NS) return
-        emit('settings')
+        emit({ source: 'settings', revision })
       }),
-      ctx.remote.$on('llm/adapters-updated', () => { emit('directory') }),
-      ctx.on('connection/reset', () => { emit('directory') }),
+      ctx.remote.$on('llm/adapters-updated', () => { emit({ source: 'directory' }) }),
+      ctx.on('connection/reset', () => { emit({ source: 'reset' }) }),
     ]
     return () => {
       for (const dispose of disposers) dispose()

package/src/client/load-drafts.ts

@@ -1,6 +1,12 @@
 /**
  * Load editable route drafts from llm.providers + 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()`:
+ * wait until the mirror subscribe shows a namespace revision at least as new
+ * as the Host event, then `getSnapshot()`. Own mutate echoes are identified
+ * 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'
@@ -25,19 +31,115 @@ export interface LoadDraftsResult {
   error?: string
 }
 
+export type LoadDraftsMode = 'ensure' | 'snapshot'
+
+type MirrorSnapshot = ReturnType<SettingsDescribeFace['getSnapshot']>
+type MirrorDescribe = Pick<SettingsDescribeFace, 'getSnapshot' | 'subscribe'>
+
+/** Namespace revision on a describe snapshot, if that row exists. */
+export function namespaceRevision(snapshot: MirrorSnapshot, ns: string): number | undefined {
+  return snapshot.view?.namespaces.find(view => view.ns === ns)?.revision
+}
+
 /**
- * First paint: `ensure()` (reads only from idle). Never treat ensure as refresh.
- * Callers that must not apply a stale settlement compare generation themselves.
- *
- * `formats` is the live schema union only. Empty means the dropdown has no
- * writable choices (stored values stay visible via `thinkingFormatChoices`).
+ * True when `incoming` is the Host echo of a mutate this page already folded,
+ * or an older revision the snapshot has already passed. `echoed` is undefined
+ * until the first successful write.
  */
-export async function loadDrafts(
+export function isOwnDocumentEcho(echoed: number | undefined, incoming: number): boolean {
+  return echoed !== undefined && incoming <= echoed
+}
+
+/**
+ * After a preserve-dirty reload: conflicted cards get a conflict notice;
+ * live cards drop leftover conflict/error; saved notices stay; gone cards drop.
+ */
+export function foldReloadNotices<T extends { kind: string }>(
+  current: Record<string, T>,
+  args: {
+    conflicted: readonly string[]
+    conflictNotice: T
+    liveProviders: readonly string[]
+  },
+): Record<string, T> {
+  const live = new Set(args.liveProviders)
+  const conflicted = new Set(args.conflicted)
+  const next: Record<string, T> = {}
+  for (const [provider, notice] of Object.entries(current)) {
+    if (!live.has(provider)) continue
+    if (conflicted.has(provider)) continue
+    if (notice.kind === 'conflict' || notice.kind === 'error') continue
+    next[provider] = notice
+  }
+  for (const provider of args.conflicted) {
+    next[provider] = args.conflictNotice
+  }
+  return next
+}
+
+function waitUntil(
+  describe: MirrorDescribe,
+  predicate: () => boolean,
+  signal?: AbortSignal,
+): Promise<boolean> {
+  if (signal?.aborted) return Promise.resolve(false)
+  if (predicate()) return Promise.resolve(true)
+  return new Promise((resolve) => {
+    let settled = false
+    const finish = (ok: boolean) => {
+      if (settled) return
+      settled = true
+      stop()
+      signal?.removeEventListener('abort', onAbort)
+      resolve(ok)
+    }
+    const onAbort = () => { finish(false) }
+    const stop = describe.subscribe(() => {
+      if (predicate()) finish(true)
+    })
+    signal?.addEventListener('abort', onAbort)
+    if (predicate()) finish(true)
+    else if (signal?.aborted) finish(false)
+  })
+}
+
+/** Resolve when the mirror's namespace revision is at least `revision`, or abort. */
+export async function waitForNamespaceRevision(
+  describe: MirrorDescribe,
+  ns: string,
+  revision: number,
+  signal?: AbortSignal,
+): Promise<'matched' | 'aborted'> {
+  const matched = await waitUntil(
+    describe,
+    () => {
+      const current = namespaceRevision(describe.getSnapshot(), ns)
+      return current !== undefined && current >= revision
+    },
+    signal,
+  )
+  return matched ? 'matched' : 'aborted'
+}
+
+/** Resolve when the namespace revision differs from `previous`, or abort. */
+export async function waitForNamespaceRevisionChange(
+  describe: MirrorDescribe,
+  ns: string,
+  previous: number,
+  signal?: AbortSignal,
+): Promise<'changed' | 'aborted'> {
+  const changed = await waitUntil(describe, () => {
+    const current = namespaceRevision(describe.getSnapshot(), ns)
+    return current !== undefined && current !== previous
+  }, signal)
+  return changed ? 'changed' : 'aborted'
+}
+
+async function assembleDrafts(
   api: Pick<IApiClient, 'llm'>,
-  describe: Pick<SettingsDescribeFace, 'ensure' | 'getSnapshot'>,
+  describe: Pick<SettingsDescribeFace, 'getSnapshot'>,
   schema: SchemaOps,
 ): Promise<LoadDraftsResult> {
-  await describe.ensure()
   const mirrored = describe.getSnapshot()
   if (mirrored.view === undefined) {
     return { writable: false, formats: [], drafts: [], error: mirrored.error ?? undefined }
@@ -83,3 +185,17 @@ export async function loadDrafts(
   }
   return { writable: mirrored.view.writable, formats, drafts }
 }
+
+/**
+ * `ensure`: first paint / idle recovery (official ensure only reads from idle).
+ * `snapshot`: refresh after the mirror revision already moved — do not ensure.
+ */
+export async function loadDrafts(
+  api: Pick<IApiClient, 'llm'>,
+  describe: Pick<SettingsDescribeFace, 'ensure' | 'getSnapshot'>,
+  schema: SchemaOps,
+  mode: LoadDraftsMode = 'ensure',
+): Promise<LoadDraftsResult> {
+  if (mode === 'ensure') await describe.ensure()
+  return assembleDrafts(api, describe, schema)
+}

package/src/client/locales.ts

@@ -44,13 +44,16 @@ 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）。',
   loadError: '无法加载提供方或设置。',
@@ -60,7 +63,7 @@ export const zh: Record<EffortDeclareKey, string> = {
   saving: '保存中…',
   saveBusy: '另有路由正在保存，请稍候。',
   cancel: '取消',
-  saved: '已保存。对话选择器会按新的能力声明显示 Effort 行。',
+  saved: '已保存。对话会按新的能力声明更新 Effort 行和是否允许贴图。',
   conflict: '设置已被其他地方改过，请重新加载后再保存。',
   dirtyConflict: '此路由有未保存修改，设置已在其他地方更新。保存会写到最新文档上，或先取消再改。',
   presets: '预设',
@@ -89,12 +92,15 @@ 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).',
   loadError: 'Could not load providers or settings.',
@@ -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/core/README.en.md

@@ -7,21 +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.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. 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. |
-| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` read/write, Off tri-state, 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`. |
+| [`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). |
+| [`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,21 +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.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。`models[].input` 的可写模态为 `text` 与 `image`，与官方 schema 一致。
 
 ## 这个目录里有什么
 
 | 文件 | 说明 |
 | --- | --- |
-| [`catalog.ts`](./catalog.ts) | 规范档位顺序、`thinkingFormat` 回退列表、`llm-pi-ai` / DeepSeek 相关常量。 |
-| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` 读写、Off 三态、校验（空对象 / 只开 Off / 未知键返回错误码，不抛异常）。 |
-| [`presets.ts`](./presets.ts) | DeepSeek、OpenAI、仅开/关三套预设；每套对三个方言键都表态；spread 到已有模型行与路由 `compat`。 |
+| [`catalog.ts`](./catalog.ts) | 规范档位顺序、`thinkingFormat` 回退列表、请求模态（`INPUT_MODALITIES` / `IMAGE_CAPABLE_INPUT`）、`llm-pi-ai` / DeepSeek 相关常量。 |
+| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` 读写、Off 三态（value 模式写入 `trim()` 后的字符串）、校验（空对象 / 只开 Off / 未知键返回错误码，不抛异常）。 |
+| [`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/attribution.ts

@@ -0,0 +1,24 @@
+/**
+ * Plugin footer attribution. Version and end-year are frozen into the client
+ * bundle at pack time; this module only formats the line.
+ */
+
+/** First publication year (LICENSE). Not the user's wall clock. */
+export const COPYRIGHT_FROM = 2026
+
+export const COPYRIGHT_HOLDER = 'Stardust'
+
+/**
+ * `0.1.2 © 2026 Stardust` or `0.1.2 © 2026–2027 Stardust`.
+ * Throws if version is empty or `to < from` — a bad stamp must not render.
+ */
+export function formatAttribution(version: string, from: number, to: number): string {
+  if (version.trim() === '') {
+    throw new Error('plugin version must be a non-empty string')
+  }
+  if (!Number.isInteger(from) || !Number.isInteger(to) || to < from) {
+    throw new Error(`invalid copyright range: ${String(from)}\u2013${String(to)}`)
+  }
+  const years = to === from ? String(from) : `${String(from)}\u2013${String(to)}`
+  return `${version} \u00a9 ${years} ${COPYRIGHT_HOLDER}`
+}

package/src/core/catalog.ts

@@ -61,3 +61,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

@@ -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/efforts.ts

@@ -26,7 +26,10 @@ export function writeOff(
   const next: ReasoningEfforts = { ...efforts }
   delete next.off
   if (mode === 'empty') next.off = null
-  else if (mode === 'value') next.off = value.trim().length > 0 ? value : 'none'
+  else if (mode === 'value') {
+    const trimmed = value.trim()
+    next.off = trimmed.length > 0 ? trimmed : 'none'
+  }
   return next
 }
 

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/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)
+}