dsh-plugin-effort-declare 0.1.4 → 0.1.5

package/CONTRIBUTING.en.md

@@ -45,7 +45,8 @@ pnpm build
 
 - Host and client must use separate `tsconfig` files (their Context merges cannot share one TypeScript program)
 - The client bundle must not inline `@deepseek-ai/*` except platform modules in the shell’s frozen table. Collaborate through Cordis services; do not value-import the official Models page
-- Source: [src/README.md](./src/README.md); domain logic: [src/core/README.md](./src/core/README.md); settings UI: [src/client/README.md](./src/client/README.md); tests: [tests/README.md](./tests/README.md)
+- Client calls go through `ctx.remote.llm` / `ctx.remote.settings` (`listConfigurableProviders`, `settings.mutate`). Do not use `connection.api`. `@deepseek-ai/dsh-client-runtime` is not published for 0.1.2-alpha.2; do not add it back as a peer or a `dsh.client.inject` entry
+- Source: [src/README.en.md](./src/README.en.md); domain logic: [src/core/README.en.md](./src/core/README.en.md); settings UI: [src/client/README.en.md](./src/client/README.en.md); tests: [tests/README.en.md](./tests/README.en.md)
 
 Before sending a change, say whether it is a bug fix, a feature, 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.
 

package/CONTRIBUTING.md

@@ -45,6 +45,7 @@ pnpm build
 
 - Host 与 client 必须分 `tsconfig`（两边 Context merge 不能共一个 TypeScript Program）
 - 客户端 bundle 禁止把 `@deepseek-ai/*` 打进包内（shell 冻结模块表里的平台模块除外）。跨插件协作走 Cordis 服务，不要 value-import 官方模型页
+- 客户端经 `ctx.remote.llm` / `ctx.remote.settings` 调用（`listConfigurableProviders`、`settings.mutate`）。不要再用 `connection.api`。`@deepseek-ai/dsh-client-runtime` 在 0.1.2-alpha.2 未发布，不要加回 peer 或 `dsh.client.inject`
 - 源码：[src/README.md](./src/README.md)；领域逻辑：[src/core/README.md](./src/core/README.md)；设置页：[src/client/README.md](./src/client/README.md)；测试：[tests/README.md](./tests/README.md)
 
 提交前请说明改动是缺陷修复、功能增强，还是对齐新的 DSH / pi-ai schema。中英文档一并更新。根 README 与 [INSTALL.md](./INSTALL.md) 面向使用者；本文件与 `src/`、`tests/` 下的 README 面向改代码的人。

package/INSTALL.en.md

@@ -7,7 +7,7 @@
   </samp>
 </p>
 
-Back to the [README](./README.en.md). Requires DeepSeek Harness **0.1.0-rc.8** or later. Do not use `npm install`; use `dsh plugin` below.
+Back to the [README](./README.en.md). Requires DeepSeek Harness **0.1.2-alpha.2**. Earlier client APIs, including 0.1.0-rc.8, are not supported. Do not use `npm install`; use `dsh plugin` below.
 
 ## Third-party distributions: set DSH_HOME first
 
@@ -83,7 +83,7 @@ dsh plugin --profile web add file:/absolute/path/to/dsh-plugin-effort-declare
 
 ## After install
 
-Restart DSH. Open **Settings → Reasoning efforts**, declare reasoning levels per model, and check **Accepts image input** for vision models. The footer is the installed version (for example `0.1.4 © 2026 Stardust`). Bumping `package.json` version only appears after you rebuild and reinstall. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
+Restart DSH. Open **Settings → Reasoning efforts**, declare reasoning levels per model, and check **Accepts image input** for vision models. The footer is the installed version (for example `0.1.5 © 2026 Stardust`). Bumping `package.json` version only appears after you rebuild and reinstall. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
 
 ## Uninstall
 

package/INSTALL.md

@@ -7,7 +7,7 @@
   </samp>
 </p>
 
-回到 [README](./README.md)。需要 DeepSeek Harness **0.1.0-rc.8** 或更高版本。不要使用 `npm install`，必须使用下面的 `dsh plugin` 命令。
+回到 [README](./README.md)。需要 DeepSeek Harness **0.1.2-alpha.2**；更早的客户端 API（含 0.1.0-rc.8）不再支持。不要使用 `npm install`，必须使用下面的 `dsh plugin` 命令。
 
 ## 第三方发行版：先设置 DSH_HOME
 
@@ -83,7 +83,7 @@ dsh plugin --profile web add file:/绝对路径/dsh-plugin-effort-declare
 
 ## 安装之后
 
-重启 DSH。打开 **设置 → 推理档位**，按模型声明推理档位；视觉模型再勾选 **支持图片输入**。页脚为当前安装版本（例如 `0.1.4 © 2026 Stardust`）。修改 `package.json` 的 version 后须重新打包并安装才会更新页脚。请先在「模型」页添加第三方提供方，本页才会出现可编辑条目。
+重启 DSH。打开 **设置 → 推理档位**，按模型声明推理档位；视觉模型再勾选 **支持图片输入**。页脚为当前安装版本（例如 `0.1.5 © 2026 Stardust`）。修改 `package.json` 的 version 后须重新打包并安装才会更新页脚。请先在「模型」页添加第三方提供方，本页才会出现可编辑条目。
 
 ## 卸载
 

package/README.en.md

@@ -13,11 +13,13 @@
   <a href="https://github.com/zimodzh/dsh-plugin-effort-declare" target="_blank" rel="noopener noreferrer"><img alt="repo size" src="https://img.shields.io/github/repo-size/zimodzh/dsh-plugin-effort-declare"></a>
   <a href="./LICENSE" target="_blank" rel="noopener noreferrer"><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" target="_blank" rel="noopener noreferrer"><img alt="Agent" src="https://img.shields.io/badge/Agent-Deepseek%20Harness-000000"></a>
+  <a href="https://www.dsh.so/artifact/dsh-plugin-effort-declare/" target="_blank" rel="noopener noreferrer"><img alt="dsh.so risk" src="https://www.dsh.so/badge/dsh-plugin-effort-declare.svg"></a>
+  <a href="https://www.dsh.so/artifact/dsh-plugin-effort-declare/" target="_blank" rel="noopener noreferrer"><img alt="dsh.so install" src="https://www.dsh.so/badge/install/dsh-plugin-effort-declare.svg"></a>
 </p>
 
-A settings plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). It declares reasoning levels and image input for hand-added OpenAI-compatible models. After a declaration, the composer shows the Effort row and accepts image attachments; undeclared models are treated as text-only.
+A settings plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). It declares reasoning levels and image input for hand-added OpenAI-compatible models. After a declaration, the conversation input shows the Effort row and accepts image attachments; undeclared models are treated as text-only.
 
-> A community-maintained third-party DSH plugin. It is not an official DeepSeek project and is not endorsed by DeepSeek. Requires **DeepSeek Harness 0.1.0-rc.8** or later. Earlier versions have not been tested.
+> A community-maintained third-party DSH plugin. It is not an official DeepSeek project and is not endorsed by DeepSeek. Requires **DeepSeek Harness 0.1.2-alpha.2**. Earlier client APIs are no longer supported, including 0.1.0-rc.8 which this plugin previously targeted.
 
 ## Purpose
 

package/README.md

@@ -13,11 +13,13 @@
   <a href="https://github.com/zimodzh/dsh-plugin-effort-declare" target="_blank" rel="noopener noreferrer"><img alt="repo size" src="https://img.shields.io/github/repo-size/zimodzh/dsh-plugin-effort-declare"></a>
   <a href="./LICENSE" target="_blank" rel="noopener noreferrer"><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" target="_blank" rel="noopener noreferrer"><img alt="Agent" src="https://img.shields.io/badge/Agent-Deepseek%20Harness-000000"></a>
+  <a href="https://www.dsh.so/artifact/dsh-plugin-effort-declare/" target="_blank" rel="noopener noreferrer"><img alt="dsh.so risk" src="https://www.dsh.so/badge/dsh-plugin-effort-declare.svg"></a>
+  <a href="https://www.dsh.so/artifact/dsh-plugin-effort-declare/" target="_blank" rel="noopener noreferrer"><img alt="dsh.so install" src="https://www.dsh.so/badge/install/dsh-plugin-effort-declare.svg"></a>
 </p>
 
 这是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）的设置插件：为手工添加的 OpenAI 兼容模型声明推理档位与图片输入。声明之后，对话输入框才会出现 Effort 行，并允许附加图片；未声明则按纯文本模型处理。
 
-> 社区维护的第三方 DSH 插件，并非 DeepSeek 官方项目，亦未经官方背书。要求 **DeepSeek Harness 0.1.0-rc.8** 或更高版本；更早版本未经测试。
+> 社区维护的第三方 DSH 插件，并非 DeepSeek 官方项目，亦未经官方背书。要求 **DeepSeek Harness 0.1.2-alpha.2**；更早的客户端 API（含此前对接的 0.1.0-rc.8）不再支持。
 
 ## 作用
 

package/lib/client.js

@@ -11,7 +11,7 @@ window.__ModuleLoader__.load({
 		* Canonical thinking levels and openai-completions thinkingFormat names.
 		*
 		* Levels match `@deepseek-ai/dsh-llm-pi-ai` catalog.ts `THINKING_LEVELS`.
-		* Formats match `SUPPORTED_THINKING_FORMATS` in the same file (rc.8).
+		* Formats match `SUPPORTED_THINKING_FORMATS` in the same file (0.1.2-alpha.2).
 		* Tests pin these lists against a checked-in schema fixture
 		* (`tests/fixtures/pi-ai-thinking-format-union.ts`) and the local level
 		* whitelist. The settings page never offers the handwritten thinkingFormat
@@ -616,7 +616,7 @@ window.__ModuleLoader__.load({
 		* package.json at DSH startup — host apply is empty and the settings page
 		* runs in the browser.
 		*/
-		const PLUGIN_FOOTER_TEXT = formatAttribution("0.1.4", COPYRIGHT_FROM, 2026);
+		const PLUGIN_FOOTER_TEXT = formatAttribution("0.1.5", COPYRIGHT_FROM, 2026);
 		//#endregion
 		//#region src/client/load-drafts.ts
 		function schemaDefaultString(node) {
@@ -689,7 +689,7 @@ window.__ModuleLoader__.load({
 				return current !== void 0 && current !== previous;
 			}, signal) ? "changed" : "aborted";
 		}
-		async function assembleDrafts(api, describe, schema) {
+		async function assembleDrafts(llm, describe, schema) {
 			const mirrored = describe.getSnapshot();
 			if (mirrored.view === void 0) return {
 				writable: false,
@@ -697,12 +697,12 @@ window.__ModuleLoader__.load({
 				drafts: [],
 				error: mirrored.error ?? void 0
 			};
-			const providersResponse = await api.llm.providers({});
-			if (!providersResponse.result.ok) return {
+			const providersResponse = await llm.listConfigurableProviders();
+			if (!providersResponse.ok) return {
 				writable: mirrored.view.writable,
 				formats: [],
 				drafts: [],
-				error: providersResponse.result.error.message
+				error: providersResponse.error.message
 			};
 			const pi = new Map(mirrored.view.namespaces.map((view) => [view.ns, view])).get(LLM_PI_AI_NS);
 			let formats = [];
@@ -723,7 +723,7 @@ window.__ModuleLoader__.load({
 				]));
 			} catch {}
 			const drafts = [];
-			for (const entry of providersResponse.result.value.providers) {
+			for (const entry of providersResponse.value) {
 				const settingsPath = entry.settingsPath !== void 0 && entry.settingsPath.length > 0 ? [...entry.settingsPath] : ["providers", entry.provider];
 				if (!classifyRoute(entry, profileAt(pi?.value, settingsPath, entry.provider), schemaDefaultApi).editable) continue;
 				drafts.push(routeDraftFromUserProfile({
@@ -744,9 +744,9 @@ window.__ModuleLoader__.load({
 		* `ensure`: first paint / idle recovery (official ensure only reads from idle).
 		* `snapshot`: refresh after the mirror revision already moved — do not ensure.
 		*/
-		async function loadDrafts(api, describe, schema, mode = "ensure") {
+		async function loadDrafts(llm, describe, schema, mode = "ensure") {
 			if (mode === "ensure") await describe.ensure();
-			return assembleDrafts(api, describe, schema);
+			return assembleDrafts(llm, describe, schema);
 		}
 		//#endregion
 		//#region src/client/schema-ops.ts
@@ -1160,7 +1160,8 @@ window.__ModuleLoader__.load({
 		}
 		function EffortDeclareSection(props) {
 			const t = props.t;
-			const api = props.api;
+			const llm = props.llm;
+			const settings = props.settings;
 			const describe = props.describe;
 			const schema = props.schema;
 			const [status, setStatus] = (0, react.useState)("loading");
@@ -1219,17 +1220,17 @@ window.__ModuleLoader__.load({
 				setStatus("ready");
 			};
 			const loadSnapshotThenSettle = async (generation, preserveDirty) => {
-				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				if (llm === void 0 || typeof llm.listConfigurableProviders !== "function" || describe === void 0 || schema === void 0) return;
 				if (!generationIsCurrent(generationRef, generation)) return;
 				try {
-					const result = await loadDrafts(api, describe, schema, "snapshot");
+					const result = await loadDrafts(llm, describe, schema, "snapshot");
 					settleReload(generation, preserveDirty, result);
 				} catch (failure) {
 					failGeneration(generation, failure);
 				}
 			};
 			const reload = (0, react.useCallback)((preserveDirty, mode = "ensure") => {
-				if (api === void 0 || describe === void 0 || schema === void 0) {
+				if (llm === void 0 || typeof llm.listConfigurableProviders !== "function" || describe === void 0 || schema === void 0) {
 					setStatus("error");
 					setError(t("loadError"));
 					return;
@@ -1237,19 +1238,19 @@ window.__ModuleLoader__.load({
 				const { generation } = beginGeneration();
 				if (draftsRef.current.length === 0) setStatus("loading");
 				setError("");
-				loadDrafts(api, describe, schema, mode).then((result) => {
+				loadDrafts(llm, describe, schema, mode).then((result) => {
 					settleReload(generation, preserveDirty, result);
 				}, (failure) => {
 					failGeneration(generation, failure);
 				});
 			}, [
-				api,
+				llm,
 				describe,
 				schema,
 				t
 			]);
 			const refreshAtRevision = (0, react.useCallback)((revision, preserveDirty) => {
-				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				if (llm === void 0 || typeof llm.listConfigurableProviders !== "function" || describe === void 0 || schema === void 0) return;
 				const { generation, signal } = beginGeneration();
 				if (draftsRef.current.length === 0) setStatus("loading");
 				setError("");
@@ -1260,7 +1261,7 @@ window.__ModuleLoader__.load({
 					failGeneration(generation, failure);
 				});
 			}, [
-				api,
+				llm,
 				describe,
 				schema,
 				t
@@ -1314,7 +1315,7 @@ window.__ModuleLoader__.load({
 				});
 			};
 			const save = async (draft) => {
-				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				if (settings === void 0 || typeof settings.mutate !== "function" || describe === void 0 || schema === void 0) return;
 				if (status === "loading" || busyRouteRef.current !== null) {
 					patchNotice(draft.provider, {
 						kind: "error",
@@ -1365,16 +1366,12 @@ window.__ModuleLoader__.load({
 							}
 						}
 					}
-					const response = await api.settings.mutate({
-						ns: LLM_PI_AI_NS,
-						ops,
-						expectedRevision: draft.revision
-					});
-					if (!response.result.ok) {
-						const conflict = response.result.error.code === "settings-conflict";
+					const response = await settings.mutate(LLM_PI_AI_NS, ops, draft.revision);
+					if (!response.ok) {
+						const conflict = response.error.code === "settings/conflict";
 						patchNotice(draft.provider, {
 							kind: conflict ? "conflict" : "error",
-							text: conflict ? t("conflict") : response.result.error.message
+							text: conflict ? t("conflict") : response.error.message
 						});
 						if (conflict) {
 							const { generation, signal } = beginGeneration();
@@ -1387,7 +1384,7 @@ window.__ModuleLoader__.load({
 						}
 						return;
 					}
-					const view = response.result.value;
+					const view = response.value;
 					echoedRevisionRef.current = view.revision;
 					describe.acceptView(view);
 					applyDrafts(applySaveSuccess(draftsRef.current, draft.provider, {
@@ -1494,7 +1491,7 @@ window.__ModuleLoader__.load({
 			title: "推理档位声明",
 			intro: "声明手工模型可提供的推理档位，以及是否接受图片输入。未声明则不显示 Effort 行，图片附件也会被拒绝。档位仍在输入框菜单中选择；密钥、目录与当前选中项不在本页修改。",
 			empty: "没有可编辑的手工 openai-completions 路由。",
-			emptyHint: "请先到「模型」页添加提供方（llm-pi-ai 手工路由）。官方 DeepSeek 与 catalog 路由不在本页编辑。需要 DSH ≥ 0.1.0-rc.8（providers.declared）。",
+			emptyHint: "请先到「模型」页添加提供方（llm-pi-ai 手工路由）。官方 DeepSeek 与 catalog 路由不在本页编辑。需要 DSH ≥ 0.1.2-alpha.2。",
 			loadError: "无法加载提供方或设置。",
 			loading: "正在加载…",
 			readOnly: "当前设置为只读，无法保存。",
@@ -1540,7 +1537,7 @@ window.__ModuleLoader__.load({
 			title: "Reasoning effort declarations",
 			intro: "Declare reasoning levels and image input for hand-added models. Undeclared models omit the Effort row and refuse image attachments. Effort is still chosen in the composer menu; keys, catalogs, and the current selection are not modified here.",
 			empty: "No editable hand-declared openai-completions routes.",
-			emptyHint: "Add a provider on the Models page first (an llm-pi-ai hand-declared route). Official DeepSeek and catalog routes are not edited here. Requires DSH ≥ 0.1.0-rc.8 (providers.declared).",
+			emptyHint: "Add a provider on the Models page first (an llm-pi-ai hand-declared route). Official DeepSeek and catalog routes are not edited here. Requires DSH ≥ 0.1.2-alpha.2.",
 			loadError: "Could not load providers or settings.",
 			loading: "Loading…",
 			readOnly: "Settings are read-only; saving is disabled.",
@@ -1586,8 +1583,9 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"connection",
 			"remote",
+			"remote.llm",
+			"remote.settings",
 			"settingsScope",
 			"settingsSchema"
 		];
@@ -1613,7 +1611,6 @@ window.__ModuleLoader__.load({
 				en
 			}), `${PLUGIN_ID}: dictionaries`);
 			ctx.effect(() => mountPluginCss(), `${PLUGIN_ID}: css`);
-			const connection = ctx.get("connection");
 			const settingsSchema = ctx.settingsSchema;
 			const schema = bindSchema({
 				rehydrate: (serialized) => settingsSchema.rehydrate(serialized),
@@ -1664,7 +1661,8 @@ window.__ModuleLoader__.load({
 				label: () => t("nav"),
 				locale: NS,
 				inject: () => ({
-					api: connection.api,
+					llm: ctx.remote.llm,
+					settings: ctx.remote.settings,
 					describe,
 					schema,
 					subscribeInvalidate