dsh-plugin-effort-declare 0.1.0 → 0.1.1

package/CONTRIBUTING.en.md

@@ -38,7 +38,7 @@ pnpm build
 
 Before sending a change, say whether it is a bugfix, UI improvement, or an alignment with a newer DSH / pi-ai schema. Update zh and en docs together. The root README and [INSTALL.en.md](./INSTALL.en.md) are for users; this file and the READMEs under `src/` and `tests/` are for people changing code.
 
-Canonical level names and `thinkingFormat` enums come from the installed `llm-pi-ai` schema / catalog. The repo keeps a fallback whitelist pinned by tests; if the schema drifts, update the tests first, then the UI.
+Canonical level names and `thinkingFormat` enums come from the installed `llm-pi-ai` schema / catalog. The repo keeps a whitelist pinned by tests; if the schema drifts, update the tests first, then UI copy. Do not offer that list as writable dropdown choices.
 
 ## Publishing to npm
 
@@ -52,6 +52,8 @@ pnpm publish
 
 `pnpm publish` fails on an unclean Git tree. Commit first (and preferably push). Do not pass `--no-git-checks`.
 
+After publish, users update with `dsh plugin --profile web update dsh-plugin-effort-declare` or `add dsh-plugin-effort-declare@latest`. Authors do not implement an update command; official `dsh plugin` forwards the rest of the line to pnpm.
+
 ## Security
 
 Do not paste API keys or `.credentials.yaml` values into logs, screenshots, docs, or issues.

package/CONTRIBUTING.md

@@ -38,7 +38,7 @@ pnpm build
 
 提交前请说明改动是修 bug、增强 UI，还是对齐新的 DSH / pi-ai schema。中英文档一起改。根 README 和 [INSTALL.md](./INSTALL.md) 面向使用者；本文件与 `src/`、`tests/` 的 README 面向改代码的人。
 
-上游档位名与 `thinkingFormat` 枚举以 DSH 安装里 `llm-pi-ai` 的 schema / catalog 为准。仓库内有一份回退白名单，并由测试钉住；schema 漂移时应先改测试再改 UI。
+上游档位名与 `thinkingFormat` 枚举以 DSH 安装里 `llm-pi-ai` 的 schema / catalog 为准。仓库内有一份测试钉白名单；schema 漂移时应先改测试再改 UI 文案。不要把这份名单当作可写入下拉选项。
 
 ## 发布到 npm
 
@@ -52,6 +52,8 @@ pnpm publish
 
 `pnpm publish` 在 Git 有未提交改动时会失败。应先 commit（建议再 push），不要用 `--no-git-checks` 绕过。
 
+发布后用户用 `dsh plugin --profile web update dsh-plugin-effort-declare` 或 `add dsh-plugin-effort-declare@latest` 更新。作者无需在插件里实现更新命令；官方 `dsh plugin` 会把参数转给 pnpm。
+
 ## 安全
 
 不要在日志、截图、文档或 issue 中粘贴 API 密钥或 `.credentials.yaml` 的值。

package/INSTALL.en.md

@@ -9,14 +9,18 @@
 
 Back to the [README](./README.en.md). Requires DeepSeek Harness **0.1.0-rc.8 or newer**. Do not use `npm install`; use `dsh plugin` below.
 
-## Desktop users: do this first
+## Third-party DSH: set DSH_HOME first
 
-`dsh plugin` installs into the **current** `DSH_HOME`. If unset, that is `.dsh` in your user folder — **not** Desktop’s data directory.
+`dsh plugin` installs into the **current** `DSH_HOME`. If unset, that is `.dsh` in your user folder. Third-party distributions often use a different home; point it at the home your DSH actually uses.
 
-PowerShell:
+```bash
+# Linux / macOS
+export DSH_HOME=/path/to/your/dsh-home
+```
 
 ```powershell
-$env:DSH_HOME = "$env:APPDATA\io.github.hairyf.deepseek-harness-desktop\data\dsh"
+# Windows PowerShell
+$env:DSH_HOME = "X:\path\to\your\dsh-home"
 ```
 
 Set this before the install command. The profile name is usually `web`.
@@ -35,6 +39,32 @@ dsh --profile web --dump-config
 
 The output should mention `dsh-plugin-effort-declare`.
 
+## Update
+
+The plugin is published to npm. Updates also go through `dsh plugin` (the official CLI forwards the rest of the line to pnpm). Do not use `npm update`.
+
+Third-party DSH still needs `DSH_HOME` set first, same as install.
+
+Already installed from npm, upgrade to the newest version in the existing semver range:
+
+```bash
+dsh plugin --profile web update dsh-plugin-effort-declare
+```
+
+Latest release, including rewriting the dependency range:
+
+```bash
+dsh plugin --profile web add dsh-plugin-effort-declare@latest
+```
+
+Then restart DSH. Use `dsh --profile web --dump-config` to confirm the layer is still present.
+
+Installed from GitHub: run `add` again, or pin a commit:
+
+```bash
+dsh plugin --profile web add github:zimodzh/dsh-plugin-effort-declare
+```
+
 ## Other methods
 
 GitHub:
@@ -53,7 +83,7 @@ dsh plugin --profile web add file:/absolute/path/to/dsh-plugin-effort-declare
 
 ## After install
 
-Restart DSH (on Desktop, restart its backend). Open **Settings → Reasoning efforts**. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
+Restart DSH. Open **Settings → Reasoning efforts**. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
 
 ## Uninstall
 

package/INSTALL.md

@@ -9,14 +9,18 @@
 
 回到 [README](./README.md)。需要 DeepSeek Harness **0.1.0-rc.8 或更新**。不要用 `npm install`，必须用下面的 `dsh plugin` 命令。
 
-## Desktop 用户请先做这一步
+## 第三方 DSH：先设置 DSH_HOME
 
-`dsh plugin` 会装进**当前** `DSH_HOME`。没设置时默认是用户目录下的 `.dsh`，**不是** Desktop 自己的数据目录。
+`dsh plugin` 会装进**当前** `DSH_HOME`。没设置时默认是用户目录下的 `.dsh`。第三方发行版的数据目录往往不是这条路径，需要改成你这份 DSH 实际使用的 home。
 
-PowerShell：
+```bash
+# Linux / macOS
+export DSH_HOME=/path/to/your/dsh-home
+```
 
 ```powershell
-$env:DSH_HOME = "$env:APPDATA\io.github.hairyf.deepseek-harness-desktop\data\dsh"
+# Windows PowerShell
+$env:DSH_HOME = "X:\path\to\your\dsh-home"
 ```
 
 设好后再跑安装命令。配置档名称一般是 `web`。
@@ -35,6 +39,32 @@ dsh --profile web --dump-config
 
 输出里应出现 `dsh-plugin-effort-declare`。
 
+## 更新
+
+插件已发布到 npm。更新也走 `dsh plugin`（官方会把参数转给 pnpm），不要用 `npm update`。
+
+第三方 DSH 仍须先设置 `DSH_HOME`，与安装相同。
+
+已从 npm 安装过，升级到 semver 范围内的新版本：
+
+```bash
+dsh plugin --profile web update dsh-plugin-effort-declare
+```
+
+要最新正式版（含改依赖范围）：
+
+```bash
+dsh plugin --profile web add dsh-plugin-effort-declare@latest
+```
+
+然后重启 DSH。可用 `dsh --profile web --dump-config` 确认层还在。
+
+从 GitHub 装的：再执行一次下面的命令，或使用带 commit 的规格：
+
+```bash
+dsh plugin --profile web add github:zimodzh/dsh-plugin-effort-declare
+```
+
 ## 其他方式
 
 GitHub：
@@ -53,7 +83,7 @@ dsh plugin --profile web add file:/绝对路径/dsh-plugin-effort-declare
 
 ## 装完之后
 
-重启 DSH（Desktop 请重启其后端）。打开 **设置 → 推理档位**。先在「模型」页添加第三方提供方，本页才会出现可编辑的条目。
+重启 DSH。打开 **设置 → 推理档位**。先在「模型」页添加第三方提供方，本页才会出现可编辑的条目。
 
 ## 卸载
 

package/README.en.md

@@ -7,13 +7,21 @@
   </samp>
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-plugin-effort-declare"><img alt="npm" src="https://img.shields.io/npm/v/dsh-plugin-effort-declare"></a>
+  <a href="https://github.com/zimodzh/dsh-plugin-effort-declare/commits/master"><img alt="last commit" src="https://img.shields.io/github/last-commit/zimodzh/dsh-plugin-effort-declare"></a>
+  <a href="https://github.com/zimodzh/dsh-plugin-effort-declare"><img alt="repo size" src="https://img.shields.io/github/repo-size/zimodzh/dsh-plugin-effort-declare"></a>
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/github/license/zimodzh/dsh-plugin-effort-declare"></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="Agent" src="https://img.shields.io/badge/Agent-Deepseek%20Harness-000000"></a>
+</p>
+
 Add reasoning-effort options to OpenAI-compatible models you added yourself, so the Effort row shows up in the composer.
 
-This is a community plugin. It is not an official DeepSeek project and is not endorsed by DeepSeek. Requires DeepSeek Harness **0.1.0-rc.8 or newer**.
+> This is a community plugin. It is not an official DeepSeek project and is not endorsed by DeepSeek. Requires DeepSeek Harness **0.1.0-rc.8 or later**.
 
 ## Why
 
-Custom providers you add on the Models page usually have no reasoning levels, so the composer hides Effort. This plugin adds a **Reasoning efforts** page in Settings: you pick which levels a model can offer. The per-turn choice and the HTTP request still go through DSH. This plugin only writes settings, not API keys.
+Hand-added third-party providers on the Models page need a reasoning-level declaration before Effort appears in the composer. They usually do not declare it. This plugin therefore adds a **Reasoning efforts** page in Settings: you pick which levels a model can offer. The per-turn choice and the HTTP request still go through DSH. This plugin only writes settings, not API keys.
 
 - Does not change models you have not saved
 - Does not change the current or default effort
@@ -35,7 +43,13 @@ Do not use `npm install`. In a terminal:
 dsh plugin --profile web add dsh-plugin-effort-declare
 ```
 
-If you use **DeepSeek Harness Desktop**, set `DSH_HOME` first or the package lands in the wrong folder. See the [install guide](./INSTALL.en.md).
+If you use third-party DSH, you must set `DSH_HOME` first, or the package lands in another directory. See the [install guide](./INSTALL.en.md). To update an npm install:
+
+```bash
+dsh plugin --profile web update dsh-plugin-effort-declare
+```
+
+Or `add dsh-plugin-effort-declare@latest`. Details: [install guide](./INSTALL.en.md) **Update**.
 
 Restart DSH, then open **Settings → Reasoning efforts**. Add a custom provider on the Models page first. GitHub, local folder, and uninstall: [install guide](./INSTALL.en.md).
 

package/README.md

@@ -7,13 +7,21 @@
   </samp>
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-plugin-effort-declare"><img alt="npm" src="https://img.shields.io/npm/v/dsh-plugin-effort-declare"></a>
+  <a href="https://github.com/zimodzh/dsh-plugin-effort-declare/commits/master"><img alt="last commit" src="https://img.shields.io/github/last-commit/zimodzh/dsh-plugin-effort-declare"></a>
+  <a href="https://github.com/zimodzh/dsh-plugin-effort-declare"><img alt="repo size" src="https://img.shields.io/github/repo-size/zimodzh/dsh-plugin-effort-declare"></a>
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/github/license/zimodzh/dsh-plugin-effort-declare"></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="Agent" src="https://img.shields.io/badge/Agent-Deepseek%20Harness-000000"></a>
+</p>
+
 给自己添加的 OpenAI 兼容模型补上「推理强度」选项，对话里的 Effort 行就会出现。
 
-这是社区插件，不是 DeepSeek 官方项目，也未获官方背书。需要 DeepSeek Harness **0.1.0-rc.8 或更新**。
+> 这是社区插件，不是 DeepSeek 官方项目，也未获官方背书。需要 DeepSeek Harness **0.1.0-rc.8 及以上**。
 
 ## 它解决什么
 
-你在「模型」页手工加的第三方接口，通常没有推理档位，所以对话里看不到 Effort。装上本插件后，设置里会多一页 **推理档位**：勾选这个模型能提供哪些档。对话里怎么选、请求怎么发给接口，仍由 DSH 处理。本插件只改设置，不改密钥。
+在「模型」页手工加的第三方供应商，需要先声明能选哪些推理档，对话里才会出现 Effort。但通常它们不会声明。所以本插件在设置里加一页 **推理档位**：勾选这个模型能提供哪些档位。对话里怎么选、请求怎么发给接口，仍由 DSH 处理。本插件只改设置，不改密钥。
 
 - 不会自动改你没保存过的模型
 - 不会改你当前选中的档位，也不会改默认档位
@@ -35,7 +43,13 @@
 dsh plugin --profile web add dsh-plugin-effort-declare
 ```
 
-若使用 **DeepSeek Harness Desktop**，必须先设置 `DSH_HOME`，否则会装到另一份目录。步骤见 [安装说明](./INSTALL.md)。
+若使用第三方DSH，必须先设置 `DSH_HOME`，否则会装到另一份目录。步骤见 [安装说明](./INSTALL.md)。更新已安装的 npm 包：
+
+```bash
+dsh plugin --profile web update dsh-plugin-effort-declare
+```
+
+或 `add dsh-plugin-effort-declare@latest`。详见 [安装说明](./INSTALL.md) 的「更新」。
 
 装完后重启 DSH，打开 **设置 → 推理档位**。请先在「模型」页添加过第三方提供方。GitHub、本地文件夹和卸载也在 [安装说明](./INSTALL.md)。
 

package/lib/client.js

@@ -12,9 +12,9 @@ window.__ModuleLoader__.load({
 		*
 		* Levels match `@deepseek-ai/dsh-llm-pi-ai` catalog.ts `THINKING_LEVELS`.
 		* Formats match `SUPPORTED_THINKING_FORMATS` in the same file (rc.8).
-		* Runtime UI prefers the live settings schema union; these lists are the
-		* fallback plus a test pin so a silent drift is a failing test, not a
-		* second hand-maintained copy nobody notices.
+		* Tests pin these lists against llm-pi-ai. The settings page never offers
+		* the handwritten thinkingFormat list as writable choices — only the live
+		* schema union, plus a stored value that the union omitted.
 		*/
 		/** Selectable reasoning levels, in pi-ai escalation order. */
 		const THINKING_LEVELS = [
@@ -28,22 +28,6 @@ window.__ModuleLoader__.load({
 		];
 		/** Thinking levels other than Off; Off has its own tri-state control. */
 		const THINKING_LEVELS_WITHOUT_OFF = THINKING_LEVELS.filter((level) => level !== "off");
-		/**
-		* openai-completions thinkingFormat values from llm-pi-ai catalog.ts rc.8.
-		* Tests pin this list; the settings page prefers schema union choices.
-		*/
-		const FALLBACK_THINKING_FORMATS = [
-			"openai",
-			"deepseek",
-			"openrouter",
-			"together",
-			"zai",
-			"qwen",
-			"chat-template",
-			"qwen-chat-template",
-			"string-thinking",
-			"ant-ling"
-		];
 		/** Wire protocol this plugin's v1 editor supports. */
 		const OPENAI_COMPLETIONS = "openai-completions";
 		/** Settings namespace this plugin writes. */
@@ -434,25 +418,28 @@ window.__ModuleLoader__.load({
 		/**
 		* 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`).
 		*/
 		async function loadDrafts(api, describe, schema) {
 			await describe.ensure();
 			const mirrored = describe.getSnapshot();
 			if (mirrored.view === void 0) return {
 				writable: false,
-				formats: [...FALLBACK_THINKING_FORMATS],
+				formats: [],
 				drafts: [],
 				error: mirrored.error ?? void 0
 			};
 			const providersResponse = await api.llm.providers({});
 			if (!providersResponse.result.ok) return {
 				writable: mirrored.view.writable,
-				formats: [...FALLBACK_THINKING_FORMATS],
+				formats: [],
 				drafts: [],
 				error: providersResponse.result.error.message
 			};
 			const pi = new Map(mirrored.view.namespaces.map((view) => [view.ns, view])).get(LLM_PI_AI_NS);
-			let formats = [...FALLBACK_THINKING_FORMATS];
+			let formats = [];
 			let schemaDefaultApi;
 			if (pi !== void 0) try {
 				const root = schema.rehydrate(pi.schema);
@@ -488,6 +475,36 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/schema-ops.ts
+		/** Wrap a live settingsSchema service as plain callbacks. */
+		function bindSchema(service) {
+			return {
+				rehydrate: (serialized) => service.rehydrate(serialized),
+				nodeAtPath: (root, path) => service.nodeAtPath(root, path),
+				getPath: (value, path) => service.getPath(value, path),
+				hasPath: (value, path) => service.hasPath(value, path),
+				validate: (node, draft) => service.validate(node, draft)
+			};
+		}
+		/**
+		* Pre-mutate schema check used by the settings page.
+		* A returned string means do not call `settings.mutate`.
+		*/
+		function validateSaveDraft(schema, root, settingsPath, afterModels, afterCompat, willWriteCompat) {
+			const modelsNode = schema.nodeAtPath(root, [...settingsPath, "models"]);
+			if (modelsNode !== void 0) {
+				const error = schema.validate(modelsNode, afterModels);
+				if (error !== void 0) return error;
+			}
+			if (willWriteCompat) {
+				const compatNode = schema.nodeAtPath(root, [...settingsPath, "compat"]);
+				if (compatNode !== void 0) {
+					const error = schema.validate(compatNode, afterCompat);
+					if (error !== void 0) return error;
+				}
+			}
+		}
+		//#endregion
 		//#region \0dsh-css:C:\Users\zimo\AppData\Roaming\io.github.hairyf.deepseek-harness-desktop\data\dsh\临时目录\dsh-plugin-effort-declare\src\client\effort-declare.module.css.mjs
 		const cssText = ".hYEBUa_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.hYEBUa_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.hYEBUa_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.hYEBUa_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.hYEBUa_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.hYEBUa_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.hYEBUa_rowHead{align-items:baseline;gap:8px;display:flex}.hYEBUa_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.hYEBUa_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.hYEBUa_compatSummary{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.hYEBUa_presetRow,.hYEBUa_actions{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.hYEBUa_primaryButton,.hYEBUa_secondaryButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.hYEBUa_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border:none}.hYEBUa_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.hYEBUa_secondaryButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.hYEBUa_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.hYEBUa_primaryButton:disabled,.hYEBUa_secondaryButton:disabled,.hYEBUa_linkButton:disabled,.hYEBUa_input:disabled{opacity:.4;cursor:default}.hYEBUa_primaryButton:focus-visible,.hYEBUa_secondaryButton:focus-visible,.hYEBUa_linkButton:focus-visible,.hYEBUa_input:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.hYEBUa_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.hYEBUa_modelEntry{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding:10px 0;display:flex}.hYEBUa_modelHead{flex-wrap:wrap;align-items:baseline;gap:8px;display:flex}.hYEBUa_modelId{font-size:13px;font-weight:500;line-height:20px}.hYEBUa_modelName{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.hYEBUa_levels{flex-wrap:wrap;gap:10px 14px;display:flex}.hYEBUa_level{align-items:center;gap:6px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_wireRow{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_input,.hYEBUa_selectInput{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);height:32px;color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:0 10px;font-size:13px}.hYEBUa_wireInput{width:7em}.hYEBUa_offGroup{flex-direction:column;gap:6px;display:flex}.hYEBUa_advanced{border-top:1px solid var(--dsw-alias-border-l2);padding-top:8px}.hYEBUa_advanced summary{cursor:pointer;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.hYEBUa_advancedBody{flex-direction:column;gap:10px;padding-top:10px;display:flex}.hYEBUa_check{align-items:flex-start;gap:8px;font-size:12px;line-height:18px;display:flex}";
 		const cssTagId = "dsh-plugin-effort-declare/effort-declare.module.css";
@@ -877,7 +894,7 @@ window.__ModuleLoader__.load({
 				loadDrafts(api, describe, schema).then((result) => {
 					if (!generationIsCurrent(generationRef, generation)) return;
 					setWritable(result.writable);
-					if (result.formats.length > 0) setFormats(result.formats);
+					setFormats(result.formats);
 					if (result.error !== void 0) {
 						setStatus("error");
 						setError(result.error);
@@ -885,10 +902,14 @@ window.__ModuleLoader__.load({
 					}
 					const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty });
 					setDrafts(merged.drafts);
-					if (merged.conflicted.length > 0) setNotices(Object.fromEntries(merged.conflicted.map((provider) => [provider, {
-						kind: "conflict",
-						text: t("dirtyConflict")
-					}])));
+					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");
 				}, (failure) => {
 					if (!generationIsCurrent(generationRef, generation)) return;
@@ -906,23 +927,31 @@ window.__ModuleLoader__.load({
 			}, [reload]);
 			(0, react.useEffect)(() => {
 				if (props.subscribeInvalidate === void 0) return void 0;
-				return props.subscribeInvalidate(() => {
-					reload(true);
+				return props.subscribeInvalidate((source) => {
+					if (source === "settings" || source === "directory") reload(true);
 				});
 			}, [props.subscribeInvalidate, reload]);
+			const patchNotice = (provider, notice) => {
+				setNotices((current) => {
+					const copy = { ...current };
+					if (notice === void 0) delete copy[provider];
+					else copy[provider] = notice;
+					return copy;
+				});
+			};
 			const save = async (draft) => {
-				if (api === void 0 || describe === void 0) return;
+				if (api === void 0 || describe === void 0 || schema === void 0) return;
 				if (status === "loading" || busyRoute !== null) return;
 				const blocking = draft.models.map((row) => errorText(modelEffortError(row), t)).find((text) => text !== void 0);
 				if (blocking !== void 0) {
-					setNotices({ [draft.provider]: {
+					patchNotice(draft.provider, {
 						kind: "error",
 						text: blocking
-					} });
+					});
 					return;
 				}
 				setBusyRoute(draft.provider);
-				setNotices({});
+				patchNotice(draft.provider, void 0);
 				try {
 					const ops = buildSaveOps({
 						settingsPath: draft.settingsPath,
@@ -935,16 +964,38 @@ window.__ModuleLoader__.load({
 						setDrafts((current) => current.map((row) => row.provider === draft.provider ? alignDraft(row) : row));
 						return;
 					}
+					const willWriteCompat = ops.some((op) => op.path.length > draft.settingsPath.length && op.path[draft.settingsPath.length] === "compat");
+					const pi = describe.getSnapshot().view?.namespaces.find((view) => view.ns === LLM_PI_AI_NS);
+					if (pi !== void 0) {
+						let root;
+						try {
+							root = schema.rehydrate(pi.schema);
+						} catch {
+							root = void 0;
+						}
+						if (root !== void 0) {
+							const schemaError = validateSaveDraft(schema, root, draft.settingsPath, draft.models, draft.compat, willWriteCompat);
+							if (schemaError !== void 0) {
+								patchNotice(draft.provider, {
+									kind: "error",
+									text: schemaError
+								});
+								return;
+							}
+						}
+					}
 					const response = await api.settings.mutate({
 						ns: LLM_PI_AI_NS,
 						ops,
 						expectedRevision: draft.revision
 					});
 					if (!response.result.ok) {
-						setNotices({ [draft.provider]: {
-							kind: "error",
-							text: response.result.error.code === "settings-conflict" ? t("conflict") : response.result.error.message
-						} });
+						const conflict = response.result.error.code === "settings-conflict";
+						patchNotice(draft.provider, {
+							kind: conflict ? "conflict" : "error",
+							text: conflict ? t("conflict") : response.result.error.message
+						});
+						if (conflict) reload(true);
 						return;
 					}
 					const view = response.result.value;
@@ -953,15 +1004,15 @@ window.__ModuleLoader__.load({
 						user: view.user ?? {},
 						revision: view.revision
 					}));
-					setNotices({ [draft.provider]: {
+					patchNotice(draft.provider, {
 						kind: "saved",
 						text: t("saved")
-					} });
+					});
 				} catch (failure) {
-					setNotices({ [draft.provider]: {
+					patchNotice(draft.provider, {
 						kind: "error",
 						text: failure instanceof Error ? failure.message : t("loadError")
-					} });
+					});
 				} finally {
 					setBusyRoute(null);
 				}
@@ -969,6 +1020,8 @@ window.__ModuleLoader__.load({
 			const showLoading = status === "loading" && drafts.length === 0;
 			const showEmpty = status === "ready" && drafts.length === 0;
 			const showList = drafts.length > 0;
+			const hasCardFailure = Object.values(notices).some((notice) => notice.kind === "conflict" || notice.kind === "error");
+			const showReload = status === "error" || hasCardFailure || showEmpty || !writable || status === "loading" || showList;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: effort_declare_module_css_default.section,
 				children: [
@@ -992,7 +1045,7 @@ window.__ModuleLoader__.load({
 						className: effort_declare_module_css_default.error,
 						children: error
 					}) : null,
-					status === "error" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					showReload ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						className: effort_declare_module_css_default.secondaryButton,
 						onClick: () => {
@@ -1018,22 +1071,14 @@ window.__ModuleLoader__.load({
 							notice: notices[draft.provider],
 							t,
 							onChange: (next) => {
-								setNotices((current) => {
-									const copy = { ...current };
-									delete copy[next.provider];
-									return copy;
-								});
+								patchNotice(next.provider, void 0);
 								setDrafts((current) => current.map((row) => row.provider === next.provider ? next : row));
 							},
 							onSave: (next) => {
 								save(next);
 							},
 							onCancel: (next) => {
-								setNotices((current) => {
-									const copy = { ...current };
-									delete copy[next.provider];
-									return copy;
-								});
+								patchNotice(next.provider, void 0);
 								setDrafts((current) => current.map((row) => row.provider === next.provider ? {
 									...row,
 									models: cloneModels(row.originalModels),
@@ -1046,17 +1091,6 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region src/client/schema-ops.ts
-		/** Wrap a live settingsSchema service as plain callbacks. */
-		function bindSchema(service) {
-			return {
-				rehydrate: (serialized) => service.rehydrate(serialized),
-				nodeAtPath: (root, path) => service.nodeAtPath(root, path),
-				getPath: (value, path) => service.getPath(value, path),
-				hasPath: (value, path) => service.hasPath(value, path)
-			};
-		}
-		//#endregion
 		//#region src/client/locales.ts
 		const NS = "plugin-effort-declare";
 		const zh = {
@@ -1090,7 +1124,7 @@ window.__ModuleLoader__.load({
 			clear: "清除本模型声明",
 			advanced: "高级：协议方言",
 			thinkingFormat: "thinkingFormat",
-			thinkingFormatDefault: "默认（openai）",
+			thinkingFormatDefault: "默认（省略该键）",
 			supportsDeveloperRole: "系统提示走 system 而不是 developer（supportsDeveloperRole: false）",
 			supportsReasoningEffort: "不发 reasoning_effort，只发开关（supportsReasoningEffort: false）",
 			developerTrueHint: "当前文档是 supportsDeveloperRole: true。v1 只能强制 false 或缺席；勾选会写成 false，取消勾选会删除该键。",
@@ -1132,7 +1166,7 @@ window.__ModuleLoader__.load({
 			clear: "Clear this model’s declaration",
 			advanced: "Advanced: protocol dialect",
 			thinkingFormat: "thinkingFormat",
-			thinkingFormatDefault: "Default (openai)",
+			thinkingFormatDefault: "Default (omit the key)",
 			supportsDeveloperRole: "Send system prompts as system, not developer (supportsDeveloperRole: false)",
 			supportsReasoningEffort: "Do not send reasoning_effort; switch only (supportsReasoningEffort: false)",
 			developerTrueHint: "The document has supportsDeveloperRole: true. v1 can only force false or omit the key; checking writes false, unchecking deletes the key.",
@@ -1181,7 +1215,8 @@ window.__ModuleLoader__.load({
 				rehydrate: (serialized) => settingsSchema.rehydrate(serialized),
 				nodeAtPath: (root, path) => settingsSchema.nodeAtPath(root, path),
 				getPath: (value, path) => settingsSchema.getPath(value, path),
-				hasPath: (value, path) => settingsSchema.hasPath(value, path)
+				hasPath: (value, path) => settingsSchema.hasPath(value, path),
+				validate: (node, draft) => settingsSchema.validate(node, draft)
 			});
 			const t = ctx.locale.bind(NS);
 			const describe = ctx.settingsScope.describe();
@@ -1191,6 +1226,9 @@ window.__ModuleLoader__.load({
 					for (const listener of invalidation) listener(source);
 				};
 				const disposers = [
+					describe.subscribe(() => {
+						emit("settings");
+					}),
 					ctx.remote.$on("settings/document-updated", (ns) => {
 						if (ns !== "llm-pi-ai") return;
 						emit("settings");
@@ -1215,14 +1253,13 @@ window.__ModuleLoader__.load({
 			ctx.slots.inject("settings.section", () => ctx.slots.register({
 				name: "settings.section",
 				id: "effort-declare",
-				order: 15,
+				order: 12,
 				label: () => t("nav"),
 				locale: NS,
 				inject: () => ({
 					api: connection.api,
 					describe,
 					schema,
-					t,
 					subscribeInvalidate
 				})
 			}, EffortDeclareSection));