dsh-plugin-effort-declare 0.1.2 → 0.1.3

package/lib/types/client/load-drafts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-drafts.d.ts","sourceRoot":"","sources":["../../../src/client/load-drafts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,qCAAqC,CAAA;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAA;AAKtF,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC5B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,aAAa,CAAC,EAC9D,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,gBAAgB,CAAC,CA8C3B"}
+{"version":3,"file":"load-drafts.d.ts","sourceRoot":"","sources":["../../../src/client/load-drafts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,qCAAqC,CAAA;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAA;AAKtF,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAA;AAElD,KAAK,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAA;AACrE,KAAK,cAAc,GAAG,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,WAAW,CAAC,CAAA;AAE7E,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAC1B,IAAI,EAAE;IACJ,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,cAAc,EAAE,CAAC,CAAA;IACjB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC,GACA,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAcnB;AA4BD,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAUhC;AAED,6EAA6E;AAC7E,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAMhC;AAqDD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC5B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,aAAa,CAAC,EAC9D,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE,cAAyB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAG3B"}

package/lib/types/core/attribution.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 declare const COPYRIGHT_FROM = 2026;
+export declare 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 declare function formatAttribution(version: string, from: number, to: number): string;
+//# sourceMappingURL=attribution.d.ts.map

package/lib/types/core/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../../src/core/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CASnF"}

package/lib/types/core/efforts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"efforts.d.ts","sourceRoot":"","sources":["../../../src/core/efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5E,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;AAExE,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAMlB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAKlB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAwBxG;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAKtF;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}
+{"version":3,"file":"efforts.d.ts","sourceRoot":"","sources":["../../../src/core/efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5E,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;AAExE,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,gBAAgB,CASlB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAKlB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAwBxG;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAKtF;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-effort-declare",
   "description": "Settings page to declare per-model reasoningEfforts and openai-completions compat on hand-declared llm-pi-ai routes. Writes the official namespace; does not intercept llm/stream or replace the Models page.",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
   "license": "MIT",
   "repository": {

package/src/README.en.md

@@ -16,7 +16,7 @@ Install: [INSTALL.en.md](../INSTALL.en.md). Usage: root [README.en.md](../README
 | Path | Role |
 | --- | --- |
 | [`index.ts`](./index.ts) | Host entry. Exports `name` and `apply`. v1 registers no host services or adapters; the bundle still needs this entry so `dsh plugin add` can load the package. |
-| [`core/`](./core/) | UI-free pure functions: efforts, presets, save ops, draft merge, route filtering. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
+| [`core/`](./core/) | UI-free pure functions: efforts, presets, save ops, draft merge, route filtering, footer attribution. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
 | [`client/`](./client/) | Browser half: locale, settings page, `settings.mutate` against `llm-pi-ai`. |
 | [`css-modules.d.ts`](./css-modules.d.ts) | Types for `*.module.css` (class map plus `cssText` / `cssTagId`). |
 

package/src/README.md

@@ -16,7 +16,7 @@
 | 路径 | 说明 |
 | --- | --- |
 | [`index.ts`](./index.ts) | Host 入口。导出 `name` 与 `apply`。v1 不注册 host 服务、不挂适配器；组合包仍需要这一入口才能被 `dsh plugin add` 加载。 |
-| [`core/`](./core/) | 与 UI 无关的纯函数：档位、预设、保存 ops、草稿合并、路由过滤。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
+| [`core/`](./core/) | 与 UI 无关的纯函数：档位、预设、保存 ops、草稿合并、路由过滤、页脚归因格式。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
 | [`client/`](./client/) | 浏览器半区：locale、设置页、对 `llm-pi-ai` 的 `settings.mutate`。 |
 | [`css-modules.d.ts`](./css-modules.d.ts) | `*.module.css` 模块类型（class map + `cssText` / `cssTagId`）。 |
 

package/src/client/EffortDeclareSection.tsx

@@ -30,18 +30,32 @@ import { applyPresetCompat, applyPresetEfforts, PRESETS, type PresetId } from '.
 import { buildSaveOps } from '../core/path-ops.ts'
 import { cloneModels, cloneObject } from '../core/paths.ts'
 import { modelEffortError } from '../core/validate.ts'
-import { loadDrafts } from './load-drafts.ts'
+import { PLUGIN_FOOTER_TEXT } from './build-info.ts'
+import {
+  foldReloadNotices,
+  isOwnDocumentEcho,
+  loadDrafts,
+  waitForNamespaceRevision,
+  waitForNamespaceRevisionChange,
+  type LoadDraftsMode,
+} from './load-drafts.ts'
 import { validateSaveDraft, type SchemaOps } from './schema-ops.ts'
 import type { EffortDeclareKey } from './locales.ts'
 import css from './effort-declare.module.css'
 
-export type InvalidationSource = 'settings' | 'directory' | 'writable'
+export type InvalidationSource = 'settings' | 'directory' | 'reset' | 'writable'
+
+export type Invalidation =
+  | { source: 'writable' }
+  | { source: 'directory' }
+  | { source: 'reset' }
+  | { source: 'settings'; revision: number }
 
 export interface EffortDeclareSectionInjected {
   api: Pick<IApiClient, 'settings' | 'llm'>
   describe: SettingsDescribeFace
   schema: SchemaOps
-  subscribeInvalidate: (listener: (source: InvalidationSource) => void) => () => void
+  subscribeInvalidate: (listener: (event: Invalidation) => void) => () => void
 }
 
 export interface EffortDeclareSectionProps extends Partial<EffortDeclareSectionInjected> {
@@ -328,58 +342,133 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
   const [notices, setNotices] = useState<Record<string, CardNotice>>({})
   const generationRef = useRef(0)
   const draftsRef = useRef(drafts)
+  const echoedRevisionRef = useRef<number | undefined>(undefined)
+  const pendingRevisionRef = useRef<number | undefined>(undefined)
+  const busyRouteRef = useRef<string | null>(null)
+  const abortRef = useRef<AbortController | null>(null)
   draftsRef.current = drafts
 
-  const reload = useCallback((preserveDirty: boolean): void => {
+  const applyDrafts = (next: RouteDraft[] | ((current: RouteDraft[]) => RouteDraft[])): void => {
+    const resolved = typeof next === 'function' ? next(draftsRef.current) : next
+    draftsRef.current = resolved
+    setDrafts(resolved)
+  }
+
+  const snapshotMode = (): LoadDraftsMode => (
+    describe === undefined || describe.getSnapshot().status === 'idle' ? 'ensure' : 'snapshot'
+  )
+
+  const beginGeneration = (): { generation: number; signal: AbortSignal } => {
+    abortRef.current?.abort()
+    const abort = new AbortController()
+    abortRef.current = abort
+    return { generation: nextGeneration(generationRef), signal: abort.signal }
+  }
+
+  const failGeneration = (generation: number, failure: unknown): void => {
+    if (!generationIsCurrent(generationRef, generation)) return
+    setStatus('error')
+    setError(failure instanceof Error ? failure.message : t('loadError'))
+  }
+
+  const settleReload = (
+    generation: number,
+    preserveDirty: boolean,
+    result: Awaited<ReturnType<typeof loadDrafts>>,
+  ): void => {
+    if (!generationIsCurrent(generationRef, generation)) return
+    setWritable(result.writable)
+    setFormats(result.formats)
+    if (result.error !== undefined) {
+      setStatus('error')
+      setError(result.error)
+      return
+    }
+    const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty })
+    applyDrafts(merged.drafts)
+    setNotices(current => foldReloadNotices(current, {
+      conflicted: merged.conflicted,
+      conflictNotice: { kind: 'conflict', text: t('dirtyConflict') },
+      liveProviders: merged.drafts.map(draft => draft.provider),
+    }))
+    setStatus('ready')
+  }
+
+  const loadSnapshotThenSettle = async (generation: number, preserveDirty: boolean): Promise<void> => {
+    if (api === undefined || describe === undefined || schema === undefined) return
+    if (!generationIsCurrent(generationRef, generation)) return
+    try {
+      const result = await loadDrafts(api, describe, schema, 'snapshot')
+      settleReload(generation, preserveDirty, result)
+    } catch (failure) {
+      failGeneration(generation, failure)
+    }
+  }
+
+  const reload = useCallback((preserveDirty: boolean, mode: LoadDraftsMode = 'ensure'): void => {
     if (api === undefined || describe === undefined || schema === undefined) {
       setStatus('error')
       setError(t('loadError'))
       return
     }
-    const generation = nextGeneration(generationRef)
+    const { generation } = beginGeneration()
     if (draftsRef.current.length === 0) setStatus('loading')
     setError('')
-    void loadDrafts(api, describe, schema).then((result) => {
-      if (!generationIsCurrent(generationRef, generation)) return
-      setWritable(result.writable)
-      setFormats(result.formats)
-      if (result.error !== undefined) {
-        setStatus('error')
-        setError(result.error)
-        return
-      }
-      const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty })
-      setDrafts(merged.drafts)
-      if (merged.conflicted.length > 0) {
-        setNotices(current => {
-          const next = { ...current }
-          for (const provider of merged.conflicted) {
-            next[provider] = { kind: 'conflict', text: t('dirtyConflict') }
-          }
-          return next
-        })
-      }
-      setStatus('ready')
+    void loadDrafts(api, describe, schema, mode).then((result) => {
+      settleReload(generation, preserveDirty, result)
     }, (failure: unknown) => {
-      if (!generationIsCurrent(generationRef, generation)) return
-      setStatus('error')
-      setError(failure instanceof Error ? failure.message : t('loadError'))
+      failGeneration(generation, failure)
+    })
+  }, [api, describe, schema, t])
+
+  const refreshAtRevision = useCallback((revision: number, preserveDirty: boolean): void => {
+    if (api === undefined || describe === undefined || schema === undefined) return
+    const { generation, signal } = beginGeneration()
+    if (draftsRef.current.length === 0) setStatus('loading')
+    setError('')
+    void waitForNamespaceRevision(describe, LLM_PI_AI_NS, revision, signal).then((outcome) => {
+      if (outcome === 'aborted' || !generationIsCurrent(generationRef, generation)) return
+      return loadSnapshotThenSettle(generation, preserveDirty)
+    }, (failure: unknown) => {
+      failGeneration(generation, failure)
     })
   }, [api, describe, schema, t])
 
-  useEffect(() => { reload(false) }, [reload])
+  const flushPendingSettings = (refresh: (revision: number, preserveDirty: boolean) => void): void => {
+    const pending = pendingRevisionRef.current
+    pendingRevisionRef.current = undefined
+    if (pending === undefined) return
+    if (isOwnDocumentEcho(echoedRevisionRef.current, pending)) return
+    refresh(pending, true)
+  }
+
+  useEffect(() => { reload(false, 'ensure') }, [reload])
+  useEffect(() => () => {
+    abortRef.current?.abort()
+    nextGeneration(generationRef)
+  }, [])
 
   useEffect(() => {
     if (props.subscribeInvalidate === undefined) return undefined
-    return props.subscribeInvalidate((source) => {
-      if (source === 'writable') {
+    return props.subscribeInvalidate((event) => {
+      if (event.source === 'writable') {
         const view = describe?.getSnapshot().view
         if (view !== undefined) setWritable(view.writable)
         return
       }
-      if (source === 'settings' || source === 'directory') reload(true)
+      if (event.source === 'settings') {
+        if (busyRouteRef.current !== null) {
+          pendingRevisionRef.current = event.revision
+          return
+        }
+        if (isOwnDocumentEcho(echoedRevisionRef.current, event.revision)) return
+        refreshAtRevision(event.revision, true)
+        return
+      }
+      if (event.source === 'directory') reload(true, snapshotMode())
+      if (event.source === 'reset') reload(true, 'ensure')
     })
-  }, [describe, props.subscribeInvalidate, reload])
+  }, [describe, props.subscribeInvalidate, refreshAtRevision, reload])
 
   const patchNotice = (provider: string, notice: CardNotice | undefined): void => {
     setNotices(current => {
@@ -392,7 +481,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
 
   const save = async (draft: RouteDraft): Promise<void> => {
     if (api === undefined || describe === undefined || schema === undefined) return
-    if (status === 'loading' || busyRoute !== null) {
+    if (status === 'loading' || busyRouteRef.current !== null) {
       patchNotice(draft.provider, { kind: 'error', text: t('saveBusy') })
       return
     }
@@ -403,6 +492,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
       patchNotice(draft.provider, { kind: 'error', text: blocking })
       return
     }
+    busyRouteRef.current = draft.provider
     setBusyRoute(draft.provider)
     patchNotice(draft.provider, undefined)
     try {
@@ -414,7 +504,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
         afterCompat: draft.compat,
       })
       if (ops.length === 0) {
-        setDrafts(current => current.map(row => row.provider === draft.provider ? alignDraft(row) : row))
+        applyDrafts(current => current.map(row => row.provider === draft.provider ? alignDraft(row) : row))
         return
       }
       const willWriteCompat = ops.some(op => (
@@ -454,12 +544,21 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
           kind: conflict ? 'conflict' : 'error',
           text: conflict ? t('conflict') : response.result.error.message,
         })
-        if (conflict) reload(true)
+        if (conflict) {
+          const { generation, signal } = beginGeneration()
+          void waitForNamespaceRevisionChange(describe, LLM_PI_AI_NS, draft.revision, signal).then((outcome) => {
+            if (outcome === 'aborted' || !generationIsCurrent(generationRef, generation)) return
+            return loadSnapshotThenSettle(generation, true)
+          }, (failure: unknown) => {
+            failGeneration(generation, failure)
+          })
+        }
         return
       }
       const view = response.result.value
+      echoedRevisionRef.current = view.revision
       describe.acceptView(view)
-      setDrafts(current => applySaveSuccess(current, draft.provider, {
+      applyDrafts(applySaveSuccess(draftsRef.current, draft.provider, {
         user: view.user ?? {},
         revision: view.revision,
       }))
@@ -470,7 +569,9 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
         text: failure instanceof Error ? failure.message : t('loadError'),
       })
     } finally {
+      busyRouteRef.current = null
       setBusyRoute(null)
+      flushPendingSettings(refreshAtRevision)
     }
   }
 
@@ -491,7 +592,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
       {status === 'error' ? <p className={css.error}>{error}</p> : null}
       {showReload
         ? (
-          <button type="button" className={css.secondaryButton} onClick={() => { reload(true) }}>{t('reload')}</button>
+          <button type="button" className={css.secondaryButton} onClick={() => { reload(true, snapshotMode()) }}>{t('reload')}</button>
         )
         : null}
       {showEmpty
@@ -517,12 +618,12 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
                 t={t}
                 onChange={(next) => {
                   patchNotice(next.provider, undefined)
-                  setDrafts(current => current.map(row => row.provider === next.provider ? next : row))
+                  applyDrafts(current => current.map(row => row.provider === next.provider ? next : row))
                 }}
                 onSave={(next) => { void save(next) }}
                 onCancel={(next) => {
                   patchNotice(next.provider, undefined)
-                  setDrafts(current => current.map(row => row.provider === next.provider
+                  applyDrafts(current => current.map(row => row.provider === next.provider
                     ? {
                         ...row,
                         models: cloneModels(row.originalModels),
@@ -535,6 +636,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
           </ul>
         )
         : null}
+      <p className={css.footer}>{PLUGIN_FOOTER_TEXT}</p>
     </div>
   )
 }

package/src/client/README.en.md

@@ -17,9 +17,11 @@ Cross-plugin work uses Cordis services only (`connection`, `settingsScope`, `set
 
 | File | Role |
 | --- | --- |
-| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 12). `describe.subscribe` only syncs `writable` (it fires for every namespace, including this page’s own `acceptView`). Full reloads come from `settings/document-updated` (`llm-pi-ai` only), `llm/adapters-updated`, and `connection/reset`. `locale: NS` lets the framework inject `t`; `inject` only returns `api` / `describe` / `schema` / `subscribeInvalidate`. |
-| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, advanced protocol switches, save and cancel. Save is exclusive for the whole `llm-pi-ai` namespace; `busy` is “Saving…” on the in-flight card, `saveLocked` disables the others. A successful write folds `acceptView` + `applySaveSuccess` and does not full-reload. |
-| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. `thinkingFormat` choices come only from the live schema union. |
+| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 12). `describe.subscribe` only syncs `writable` (it fires for every namespace, including this page’s own `acceptView`). `settings/document-updated` (`llm-pi-ai` only) carries the Host revision; the section skips its own mutate echo, waits until the mirror revision has **caught up**, then `getSnapshot()` — it does not use `ensure()` as refresh. Provider directory changes come from `llm/adapters-updated`; `connection/reset` uses `ensure()` so an in-flight official `load()` is awaited. `locale: NS` lets the framework inject `t`; `inject` only returns `api` / `describe` / `schema` / `subscribeInvalidate`. |
+| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, advanced protocol switches, save and cancel. Save is exclusive for the whole `llm-pi-ai` namespace (ref-guarded against double-click); `busy` is “Saving…” on the in-flight card, `saveLocked` disables the others. A successful write syncs `draftsRef` immediately and folds `acceptView` + `applySaveSuccess`. External `document-updated` events that arrive during save are replayed afterwards. A reload with no conflict clears that card’s conflict/error notice. Footer shows the version and copyright years frozen at pack time. |
+| [`build-info.ts`](./build-info.ts) | Reads `package.json` version and UTC pack year injected by tsdown `define`, and formats the footer line. |
+| [`globals.d.ts`](./globals.d.ts) | Types for `__PLUGIN_VERSION__` and `__COPYRIGHT_TO__`. |
+| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. `thinkingFormat` choices come only from the live schema union. First paint uses `ensure()`; refresh reads `getSnapshot()` only, with helpers that wait for the namespace revision. |
 | [`locales.ts`](./locales.ts) | Copy namespace `plugin-effort-declare`. |
 | [`effort-declare.module.css`](./effort-declare.module.css) | `--dsw-alias-*` tokens only, so dark theme stays correct. |
 | [`schema-ops.ts`](./schema-ops.ts) | Binds `settingsSchema` as plain callbacks (including `validate`) so the service identity is not passed into React. |

package/src/client/README.md

@@ -17,9 +17,11 @@
 
 | 文件 | 说明 |
 | --- | --- |
-| [`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。 |
+| [`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。页脚显示打包时冻结的版本与版权年。 |
+| [`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)
+}