dsh-patch-edit-plus 0.3.1 → 0.4.0

package/lib/client.js

@@ -0,0 +1,213 @@
+window.__ModuleLoader__.load({
+	id: "dsh-patch-edit-plus",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/index.tsx
+		/**
+		* dsh-patch-edit-plus — 浏览器 half（0.2.0 新增）。
+		*
+		* 单一职责：在 Plugins 页 bundle 详情页的 `plugins.bundle.config` 席位
+		* （key = 包名）下注册一张配置卡，暴露两个补丁风格开关——
+		* - `allowUnifiedDiff`（Git/unified diff，默认开）
+		* - `allowCodexPatch`（Codex apply_patch，默认关）
+		*
+		* 字段全部是 host 侧 `Config` 的 `.volatile()` 字段：卡片经
+		* `configForms.get('dsh-patch-edit-plus')` 自绑本插件 entry（entry id 与
+		* 包名一致，无错位），写入走 `form.set(field, !cur)`，提交后宿主经
+		* `loader/volatile-update` 原地重注册工具（见 src/index.ts 的 rejudge）。
+		*
+		* 构建：tsdown → lib/client.js（__ModuleLoader__.load 闭包工厂，id = 包名）。
+		* react 是唯一 value-import（平台 external）；slots/configForms 经 cordis
+		* 服务消费，configForms 缺席时（理论上仅剩极老宿主）卡片整卡隐藏，不阻塞
+		* 客户端半。文案内联双语字典（zh/en），不建 locale 文件。
+		*/
+		/** 客户端所需服务：slots 全世代都有，准声明；configForms 是 0.1.7+ 服务，
+		* **不准**进顶层 inject——在老宿主上声明缺失服务会把 client entry 永久挂起
+		* （web boot 拒渲染整树，「1 entry did not activate」家族教训）。configForms
+		* 走软读（strict proxy 直读 throw → try/catch 落 ctx.get），缺席时整卡隐藏。 */
+		const inject = ["slots"];
+		/** 内联双语字典（zh/en；按 document.documentElement.lang → navigator.language 兜底）。 */
+		const STRINGS = {
+			zh: {
+				cardName: "补丁风格",
+				cardDesc: "apply_patch 接受的补丁语法",
+				unifiedTitle: "Git 风格补丁",
+				unifiedDesc: "接受 Git/unified diff 补丁语法(默认开)",
+				codexTitle: "Codex 风格补丁",
+				codexDesc: "接受 Codex apply_patch 语法(默认关)",
+				readonlyHint: "当前只读，无法修改。"
+			},
+			en: {
+				cardName: "Patch style",
+				cardDesc: "Patch syntax accepted by apply_patch",
+				unifiedTitle: "Git-style patches",
+				unifiedDesc: "Accept Git/unified diff patch syntax (default on)",
+				codexTitle: "Codex-style patches",
+				codexDesc: "Accept Codex apply_patch syntax (default off)",
+				readonlyHint: "Read-only right now; changes are not allowed."
+			}
+		};
+		/** 解析当前语言：document.documentElement.lang 优先，navigator.language 兜底，再退 zh。 */
+		function pickLang() {
+			try {
+				const docLang = typeof document !== "undefined" ? document.documentElement.lang : "";
+				const navLang = typeof navigator !== "undefined" ? navigator.language : "";
+				for (const tag of [docLang, navLang]) {
+					if (typeof tag === "string" && /^zh/i.test(tag)) return "zh";
+					if (typeof tag === "string" && /^en/i.test(tag)) return "en";
+				}
+			} catch {}
+			return "zh";
+		}
+		/** 卡片样式，注入一次（保持 bundle CSS-free；变量与 session-guard 卡同源）。 */
+		const CARD_CSS = `
+.ppeCard{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;padding:4px 16px 8px}
+.ppeCardName{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4;margin:10px 0 2px}
+.ppeCardDesc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5;margin:0 0 4px}
+.ppeRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:14px 0;display:flex}
+.ppeRow:last-of-type{border-bottom:0}
+.ppeRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}
+.ppeTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}
+.ppeDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}
+.ppeSwitch{appearance:none;position:relative;width:40px;height:22px;flex:none;cursor:pointer;background:transparent;border:0;padding:0}
+.ppeSwitch:disabled{cursor:not-allowed}
+.ppeSwitchTrack{position:absolute;inset:0;border-radius:22px;background:var(--dsw-alias-interactive-bg-hover);transition:background .16s}
+.ppeSwitch-on>.ppeSwitchTrack{background:var(--dsw-alias-button-primary-fill)}
+.ppeSwitchThumb{position:absolute;top:2px;left:2px;width:18px;height:18px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.25);transition:transform .16s}
+.ppeSwitch-on>.ppeSwitchThumb{transform:translateX(18px)}
+.ppeSwitch:disabled>.ppeSwitchTrack{opacity:.5}
+.ppeReadonly{color:var(--dsw-alias-label-tertiary);font-size:12px;margin:8px 0 4px}
+`;
+		/** 注入一次卡片样式。 */
+		function injectCss() {
+			if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=\"patch-edit-plus-card\"]") === null) {
+				const tag = document.createElement("style");
+				tag.dataset.plugin = "dsh-patch-edit-plus";
+				tag.dataset.pluginCss = "patch-edit-plus-card";
+				tag.textContent = CARD_CSS;
+				document.head.appendChild(tag);
+			}
+		}
+		const NOOP_SNAPSHOT = {
+			status: "unavailable",
+			value: void 0,
+			writable: false
+		};
+		const unsubscribeNoop = () => {};
+		/** 一行 role="switch" 开关（aria-checked + data-* 便于测试选择器）。 */
+		function SwitchRow(props) {
+			const { field, title, description, checked, disabled, onToggle } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "ppeRow",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "ppeRowText",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "ppeTitle",
+						children: title
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "ppeDesc",
+						children: description
+					})]
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					role: "switch",
+					"aria-checked": checked,
+					"data-plugin": "dsh-patch-edit-plus",
+					"data-field": field,
+					"data-checked": checked ? "true" : "false",
+					className: "ppeSwitch" + (checked ? " ppeSwitch-on" : ""),
+					disabled,
+					onClick: () => onToggle(field, checked),
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "ppeSwitchTrack" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "ppeSwitchThumb" })]
+				})]
+			});
+		}
+		/**
+		* 插件页配置卡主体：两行补丁风格开关。
+		* - status === 'unavailable'（无 configForms / entry 未装配）→ 整卡隐藏（null）；
+		* - status === 'loading' → 开关禁用；
+		* - 仅 snapshot.writable 时可写（写路径 `form.set(field, !cur)`）。
+		*/
+		function PatchStyleCard(props) {
+			const form = props.form;
+			const snapshot = (0, react.useSyncExternalStore)(form ? (listener) => form.subscribe(listener) : () => unsubscribeNoop, () => form?.getSnapshot() ?? NOOP_SNAPSHOT);
+			injectCss();
+			if (snapshot.status === "unavailable") return null;
+			const t = STRINGS[pickLang()];
+			const editable = snapshot.status === "ready" && snapshot.writable;
+			const value = snapshot.value ?? {};
+			const toggle = (field, current) => {
+				if (form === void 0 || !editable) return;
+				form.set(field, !current).catch(() => {});
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: "ppeCard",
+				"data-plugin": "dsh-patch-edit-plus",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "ppeCardName",
+						children: t.cardName
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "ppeCardDesc",
+						children: t.cardDesc
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SwitchRow, {
+						field: "allowUnifiedDiff",
+						title: t.unifiedTitle,
+						description: t.unifiedDesc,
+						checked: value.allowUnifiedDiff ?? true,
+						disabled: !editable,
+						onToggle: toggle
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SwitchRow, {
+						field: "allowCodexPatch",
+						title: t.codexTitle,
+						description: t.codexDesc,
+						checked: value.allowCodexPatch ?? false,
+						disabled: !editable,
+						onToggle: toggle
+					}),
+					snapshot.status === "ready" && !snapshot.writable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "ppeReadonly",
+						children: t.readonlyHint
+					})
+				]
+			});
+		}
+		/**
+		* 客户端插件体：在 Plugins 页 bundle 详情页的 keyed 席位（key = 包名）下
+		* 注册配置卡。卡片自绑 `configForms.get('dsh-patch-edit-plus')`——form 在
+		* 渲染期解析（而非 apply 期固化），宿主晚于客户端半开始服务该 entry 时
+		* 也能追上；页面注入的 owner props（`{ view: 'page', form }`）不消费，
+		* 以本插件 entry 的作用域为唯一事实来源。
+		*/
+		function apply(ctx) {
+			let configForms;
+			try {
+				configForms = ctx.configForms ?? (typeof ctx.get === "function" ? ctx.get("configForms") : void 0);
+			} catch {
+				configForms = void 0;
+			}
+			try {
+				ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
+					name: "plugins.bundle.config",
+					key: "dsh-patch-edit-plus"
+				}, () => (0, react.createElement)(PatchStyleCard, { form: configForms?.get?.("dsh-patch-edit-plus") })));
+			} catch (error) {
+				console.warn("[dsh-patch-edit-plus] plugins.bundle.config seat unavailable on this host line:", error);
+			}
+		}
+		//#endregion
+		exports.PatchStyleCard = PatchStyleCard;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useSyncExternalStore","createElement"],"sources":["../src/client/index.tsx"],"sourcesContent":["/**\n * dsh-patch-edit-plus — 浏览器 half（0.2.0 新增）。\n *\n * 单一职责：在 Plugins 页 bundle 详情页的 `plugins.bundle.config` 席位\n * （key = 包名）下注册一张配置卡，暴露两个补丁风格开关——\n * - `allowUnifiedDiff`（Git/unified diff，默认开）\n * - `allowCodexPatch`（Codex apply_patch，默认关）\n *\n * 字段全部是 host 侧 `Config` 的 `.volatile()` 字段：卡片经\n * `configForms.get('dsh-patch-edit-plus')` 自绑本插件 entry（entry id 与\n * 包名一致，无错位），写入走 `form.set(field, !cur)`，提交后宿主经\n * `loader/volatile-update` 原地重注册工具（见 src/index.ts 的 rejudge）。\n *\n * 构建：tsdown → lib/client.js（__ModuleLoader__.load 闭包工厂，id = 包名）。\n * react 是唯一 value-import（平台 external）；slots/configForms 经 cordis\n * 服务消费，configForms 缺席时（理论上仅剩极老宿主）卡片整卡隐藏，不阻塞\n * 客户端半。文案内联双语字典（zh/en），不建 locale 文件。\n */\nimport { createElement, useSyncExternalStore } from 'react'\nimport type { JSX } from 'react'\n\n/** 本插件消费的 configForms 值形状（与 host ResolvedConfig 的易变布尔对齐）。 */\nexport interface PatchEditPlusConfig {\n  allowUnifiedDiff: boolean\n  allowCodexPatch: boolean\n}\n\n/** configForms 作用域面（结构性子集；0.1.7+ 缝，避免硬 peer 类型）。 */\nexport interface PatchFormScope {\n  getSnapshot(): {\n    status: 'loading' | 'ready' | 'unavailable'\n    value: Partial<PatchEditPlusConfig> | undefined\n    writable: boolean\n  }\n  subscribe(listener: () => void): () => void\n  set(field: string, value: unknown): Promise<boolean>\n}\n\n/** configForms 服务面（以 entry id 取句柄）。 */\ninterface ConfigFormsFace {\n  get?(entryId: string): PatchFormScope | undefined\n}\n\n/** 客户端所需服务：slots 全世代都有，准声明；configForms 是 0.1.7+ 服务，\n * **不准**进顶层 inject——在老宿主上声明缺失服务会把 client entry 永久挂起\n * （web boot 拒渲染整树，「1 entry did not activate」家族教训）。configForms\n * 走软读（strict proxy 直读 throw → try/catch 落 ctx.get），缺席时整卡隐藏。 */\nexport const inject = ['slots']\n\n/** 轻量 ctx 类型（仅本客户端用到的方法；构建时类型被剥离）。 */\ninterface SlotsFace {\n  inject: (_name: string, _fn: () => unknown) => () => void\n  register: (_options: Record<string, unknown>, _component: unknown) => () => void\n}\ninterface ClientCtx {\n  slots: SlotsFace\n  get?: (_name: string) => unknown\n}\n\n/** 内联双语字典（zh/en；按 document.documentElement.lang → navigator.language 兜底）。 */\nconst STRINGS = {\n  zh: {\n    cardName: '补丁风格',\n    cardDesc: 'apply_patch 接受的补丁语法',\n    unifiedTitle: 'Git 风格补丁',\n    unifiedDesc: '接受 Git/unified diff 补丁语法(默认开)',\n    codexTitle: 'Codex 风格补丁',\n    codexDesc: '接受 Codex apply_patch 语法(默认关)',\n    readonlyHint: '当前只读，无法修改。',\n  },\n  en: {\n    cardName: 'Patch style',\n    cardDesc: 'Patch syntax accepted by apply_patch',\n    unifiedTitle: 'Git-style patches',\n    unifiedDesc: 'Accept Git/unified diff patch syntax (default on)',\n    codexTitle: 'Codex-style patches',\n    codexDesc: 'Accept Codex apply_patch syntax (default off)',\n    readonlyHint: 'Read-only right now; changes are not allowed.',\n  },\n} as const\n\ntype Lang = keyof typeof STRINGS\n\n/** 解析当前语言：document.documentElement.lang 优先，navigator.language 兜底，再退 zh。 */\nfunction pickLang(): Lang {\n  try {\n    const docLang = typeof document !== 'undefined' ? document.documentElement.lang : ''\n    const navLang = typeof navigator !== 'undefined' ? navigator.language : ''\n    for (const tag of [docLang, navLang]) {\n      if (typeof tag === 'string' && /^zh/i.test(tag)) return 'zh'\n      if (typeof tag === 'string' && /^en/i.test(tag)) return 'en'\n    }\n  } catch {\n    // 非 DOM 环境保底 zh\n  }\n  return 'zh'\n}\n\n/** 卡片样式，注入一次（保持 bundle CSS-free；变量与 session-guard 卡同源）。 */\nconst CARD_CSS = `\n.ppeCard{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;padding:4px 16px 8px}\n.ppeCardName{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4;margin:10px 0 2px}\n.ppeCardDesc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5;margin:0 0 4px}\n.ppeRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:14px 0;display:flex}\n.ppeRow:last-of-type{border-bottom:0}\n.ppeRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}\n.ppeTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}\n.ppeDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}\n.ppeSwitch{appearance:none;position:relative;width:40px;height:22px;flex:none;cursor:pointer;background:transparent;border:0;padding:0}\n.ppeSwitch:disabled{cursor:not-allowed}\n.ppeSwitchTrack{position:absolute;inset:0;border-radius:22px;background:var(--dsw-alias-interactive-bg-hover);transition:background .16s}\n.ppeSwitch-on>.ppeSwitchTrack{background:var(--dsw-alias-button-primary-fill)}\n.ppeSwitchThumb{position:absolute;top:2px;left:2px;width:18px;height:18px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.25);transition:transform .16s}\n.ppeSwitch-on>.ppeSwitchThumb{transform:translateX(18px)}\n.ppeSwitch:disabled>.ppeSwitchTrack{opacity:.5}\n.ppeReadonly{color:var(--dsw-alias-label-tertiary);font-size:12px;margin:8px 0 4px}\n`\n\n/** 注入一次卡片样式。 */\nfunction injectCss(): void {\n  if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css=\"patch-edit-plus-card\"]') === null) {\n    const tag = document.createElement('style')\n    tag.dataset.plugin = 'dsh-patch-edit-plus'\n    tag.dataset.pluginCss = 'patch-edit-plus-card'\n    tag.textContent = CARD_CSS\n    document.head.appendChild(tag)\n  }\n}\n\nconst NOOP_SNAPSHOT = { status: 'unavailable' as const, value: undefined, writable: false }\nconst unsubscribeNoop = (): void => {}\n\n/** 一行 role=\"switch\" 开关（aria-checked + data-* 便于测试选择器）。 */\nfunction SwitchRow(props: {\n  field: 'allowUnifiedDiff' | 'allowCodexPatch'\n  title: string\n  description: string\n  checked: boolean\n  disabled: boolean\n  onToggle: (_field: 'allowUnifiedDiff' | 'allowCodexPatch', _current: boolean) => void\n}): JSX.Element {\n  const { field, title, description, checked, disabled, onToggle } = props\n  return (\n    <div className=\"ppeRow\">\n      <div className=\"ppeRowText\">\n        <div className=\"ppeTitle\">{title}</div>\n        <div className=\"ppeDesc\">{description}</div>\n      </div>\n      <button\n        type=\"button\"\n        role=\"switch\"\n        aria-checked={checked}\n        data-plugin=\"dsh-patch-edit-plus\"\n        data-field={field}\n        data-checked={checked ? 'true' : 'false'}\n        className={'ppeSwitch' + (checked ? ' ppeSwitch-on' : '')}\n        disabled={disabled}\n        onClick={() => onToggle(field, checked)}\n      >\n        <span className=\"ppeSwitchTrack\" />\n        <span className=\"ppeSwitchThumb\" />\n      </button>\n    </div>\n  )\n}\n\n/**\n * 插件页配置卡主体：两行补丁风格开关。\n * - status === 'unavailable'（无 configForms / entry 未装配）→ 整卡隐藏（null）；\n * - status === 'loading' → 开关禁用；\n * - 仅 snapshot.writable 时可写（写路径 `form.set(field, !cur)`）。\n */\nexport function PatchStyleCard(props: { form?: PatchFormScope | undefined }): JSX.Element | null {\n  const form = props.form\n  const snapshot = useSyncExternalStore(\n    form\n      ? (listener) => form.subscribe(listener)\n      : () => unsubscribeNoop,\n    () => form?.getSnapshot() ?? NOOP_SNAPSHOT,\n  )\n\n  injectCss()\n\n  if (snapshot.status === 'unavailable') return null\n  const t = STRINGS[pickLang()]\n  // loading / 只读都归约为「不可写」：开关禁用，仅 ready + writable 时可写。\n  const editable = snapshot.status === 'ready' && snapshot.writable\n  const value = snapshot.value ?? {}\n  const toggle = (field: 'allowUnifiedDiff' | 'allowCodexPatch', current: boolean): void => {\n    if (form === undefined || !editable) return\n    void form.set(field, !current).catch(() => {})\n  }\n  return (\n    <section className=\"ppeCard\" data-plugin=\"dsh-patch-edit-plus\">\n      <div className=\"ppeCardName\">{t.cardName}</div>\n      <p className=\"ppeCardDesc\">{t.cardDesc}</p>\n      <SwitchRow\n        field=\"allowUnifiedDiff\"\n        title={t.unifiedTitle}\n        description={t.unifiedDesc}\n        checked={value.allowUnifiedDiff ?? true}\n        disabled={!editable}\n        onToggle={toggle}\n      />\n      <SwitchRow\n        field=\"allowCodexPatch\"\n        title={t.codexTitle}\n        description={t.codexDesc}\n        checked={value.allowCodexPatch ?? false}\n        disabled={!editable}\n        onToggle={toggle}\n      />\n      {snapshot.status === 'ready' && !snapshot.writable && <p className=\"ppeReadonly\">{t.readonlyHint}</p>}\n    </section>\n  )\n}\n\n/**\n * 客户端插件体：在 Plugins 页 bundle 详情页的 keyed 席位（key = 包名）下\n * 注册配置卡。卡片自绑 `configForms.get('dsh-patch-edit-plus')`——form 在\n * 渲染期解析（而非 apply 期固化），宿主晚于客户端半开始服务该 entry 时\n * 也能追上；页面注入的 owner props（`{ view: 'page', form }`）不消费，\n * 以本插件 entry 的作用域为唯一事实来源。\n */\nexport function apply(ctx: ClientCtx): void {\n  // 软读：strict ctx proxy 对未声明服务的属性直读会 throw（「1 entry did not\n  // activate」家族纪律：按代服务一律软取，绝不进顶层 inject）。\n  let configForms: ConfigFormsFace | undefined\n  try {\n    configForms = ((ctx as unknown as { configForms?: ConfigFormsFace }).configForms\n      ?? (typeof ctx.get === 'function' ? ctx.get('configForms') : undefined)) as ConfigFormsFace | undefined\n  } catch {\n    configForms = undefined\n  }\n  // 老宿主不认识 plugins.bundle.config 席位——激活期 throw 会拖死整个\n  // client entry，包 safeSeat 降级为「本线无配置卡」。\n  try {\n    ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register(\n      { name: 'plugins.bundle.config', key: 'dsh-patch-edit-plus' },\n      () => createElement(PatchStyleCard, { form: configForms?.get?.('dsh-patch-edit-plus') }),\n    ))\n  } catch (error) {\n    console.warn('[dsh-patch-edit-plus] plugins.bundle.config seat unavailable on this host line:', error)\n  }\n}\n"],"mappings":"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"}

package/lib/compat.js

@@ -0,0 +1,101 @@
+/**
+ * Generation-compat seams for the single max-range build (0.1.0-rc.8 → 0.2.0).
+ *
+ * Three old-line traps live here:
+ * 1. `.volatile()` — the schema method only exists on the 0.1.7+ schemastery
+ *    line; calling it blind is a load-time TypeError on older hosts. Condition
+ *    it with {@link maybeVolatile}.
+ * 2. The settings registration API is three generations deep: instance
+ *    `settings.installSection` (0.1.2/0.1.5, real-host verified), the module
+ *    `installSettingsSection` export of `@deepseek-ai/dsh-settings`
+ *    (0.1.0/0.1.1 — verified against the 0.1.0-rc.8 tarball; the
+ *    dsh-client-ui-settings package is a host-side no-op there), and the
+ *    declarative `.volatile()` form on 0.1.7+. {@link installSettingsCompat}
+ *    picks by feature detection, never by version number.
+ * 3. Every cross-generation import must ride a namespace soft-import: a static
+ *    named import of an absent export dies at ESM link time and takes the
+ *    whole loader entry down.
+ * @module dsh-patch-edit-plus/compat
+ */
+/** Wrap a schema field with `.volatile()` only when the host line supports it. */
+export function maybeVolatile(schema) {
+    const candidate = schema;
+    if (typeof candidate?.volatile === 'function') {
+        try {
+            return candidate.volatile();
+        }
+        catch {
+            return schema;
+        }
+    }
+    return schema;
+}
+/**
+ * Register the settings section across host generations. 0.1.7+ declarative
+ * volatile hosts never call this (their schema fields are already volatile and
+ * no registration call is wanted); this is the 0.1.5-and-below path.
+ */
+export function installSettingsCompat(ctx, namespace, schema, entry, hooks) {
+    console.log('[dsh-patch-edit-plus] compat waist mounted');
+    try {
+        ctx.inject(['settings'], (settingsCtx) => {
+            try {
+                const settings = settingsCtx.settings
+                    ?? settingsCtx;
+                if (typeof settings?.installSection === 'function') {
+                    try {
+                        settings.installSection(ctx, namespace, schema, entry, hooks);
+                        console.log('[dsh-patch-edit-plus] settings via installSection (0.1.2/0.1.5 line)');
+                    }
+                    catch (error) {
+                        console.warn('[dsh-patch-edit-plus] settings.installSection unavailable:', error);
+                    }
+                    return;
+                }
+                if (typeof settings?.register === 'function') {
+                    // 0.1.0–0.1.5 imperative register（宿主模块级 installSettingsSection 的
+                    // 内部实现就是这一段）。0.1.7+ 声明式线永远走不到这里——本函数只在组合
+                    // 条目携带普通布尔（非 live ref）时才会被调用。真机注：0.1.0 沙盒根本
+                    // 不发货 @deepseek-ai/dsh-settings 包，模块级 helper 不可解析，实例
+                    // register 是唯一可达面。
+                    try {
+                        const scope = settings.register(namespace, schema, { base: entry });
+                        if (scope !== undefined) {
+                            hooks.setSource(() => scope.get());
+                            scope.watch(() => { hooks.onChange(); });
+                            hooks.onChange();
+                            console.log('[dsh-patch-edit-plus] settings via register (0.1.0-0.1.5 imperative face)');
+                        }
+                    }
+                    catch (error) {
+                        console.warn('[dsh-patch-edit-plus] settings.register unavailable:', error);
+                    }
+                    return;
+                }
+                // 0.1.0/0.1.1: no instance API — the module-level helper wraps
+                // settings.register with the resolved-scope plumbing.
+                import('@deepseek-ai/dsh-settings').then((mod) => {
+                    const m = mod;
+                    const helper = m?.installSettingsSection ?? m?.default?.installSettingsSection;
+                    if (typeof helper === 'function') {
+                        try {
+                            helper(ctx, namespace, schema, entry, hooks);
+                        }
+                        catch (error) {
+                            console.warn('[dsh-patch-edit-plus] installSettingsSection unavailable:', error);
+                        }
+                    }
+                }).catch(() => {
+                    // Module absent on this line — no settings surface, tool still works.
+                });
+            }
+            catch (cbError) {
+                console.warn('[dsh-patch-edit-plus] settings callback threw:', cbError);
+            }
+        });
+    }
+    catch (error) {
+        // Hosts without the sub-inject seam (very old cordis) skip settings entirely.
+        console.warn('[dsh-patch-edit-plus] settings sub-inject unavailable on this host line:', error);
+    }
+}

package/lib/config.js

@@ -6,13 +6,14 @@
  * @module dsh-patch-edit-plus/config
  */
 import z from '@deepseek-ai/schemastery';
+import { maybeVolatile } from './compat.js';
 /** Schemastery schema for Loader defaults and generated configuration docs. */
 export const Config = z.object({
     toolName: z.string().default('apply_patch'),
     conflictPolicy: z.union(['rename', 'skip', 'fail']).default('rename'),
     renameSuffix: z.string().default('_1'),
-    allowUnifiedDiff: z.boolean().default(true),
-    allowCodexPatch: z.boolean().default(false).volatile(),
+    allowUnifiedDiff: maybeVolatile(z.boolean().default(true)),
+    allowCodexPatch: maybeVolatile(z.boolean().default(false)),
     deleteBackend: z.union(['shell', 'none']).default('shell'),
     shellDialect: z.union(['auto', 'posix', 'pwsh']).default('auto'),
     deleteCommand: z.string(),
@@ -38,7 +39,7 @@ export function resolveConfig(config) {
         toolName: typeof c.toolName === 'string' && c.toolName.trim() !== '' ? c.toolName : 'apply_patch',
         conflictPolicy: c.conflictPolicy ?? 'rename',
         renameSuffix: typeof c.renameSuffix === 'string' ? c.renameSuffix : '_1',
-        allowUnifiedDiff: c.allowUnifiedDiff ?? true,
+        allowUnifiedDiff: readVolatileBoolean(c.allowUnifiedDiff, true),
         allowCodexPatch: readVolatileBoolean(c.allowCodexPatch, false),
         deleteBackend: c.deleteBackend ?? 'shell',
         shellDialect: c.shellDialect ?? 'auto',

package/lib/fsops.js

@@ -16,14 +16,33 @@ import { ioError } from './errors.js';
 /**
  * Write one file through the full intent dance. Must stay byte-for-byte the
  * official sequence — the verification script asserts it.
+ * Old lines (0.1.0/0.1.1) may lack the write-intent events or the 5-param
+ * writeText; degrade to a plain 2-param write with a one-time warning — the
+ * read-before-write gate is a hardening, not a hard dependency.
  * @throws {@link PatchError} code `IO` when the backend rejects the write.
  */
+let fsShapeWarned = false;
+function warnFsShapeOnce(detail) {
+    if (fsShapeWarned)
+        return;
+    fsShapeWarned = true;
+    console.warn(`[dsh-patch-edit-plus] falling back to plain fs writes on this host line (${detail}); the read-before-write intent gate is unavailable.`);
+}
 export async function writeFile(ctx, exec, target, content, sandboxPolicy) {
     try {
-        const intent = await ctx.waterfall('fs/write-intent', target, exec, () => undefined);
-        const outcome = await ctx.fs.writeText(target, content, intent, exec.signal, sandboxPolicy);
-        ctx.emit('fs/observed', target, { kind: 'present', version: outcome.version }, exec);
-        return outcome;
+        const writeText = ctx.fs.writeText.bind(ctx.fs);
+        // 5 参意图舞（write-intent + observed 事件）只在实现了它的代上走；判定取等：仅当形参恰为 2（老线签名）才降级直写——stub/新线的
+        // mock length 常为 0，取等避免误伤意图舞。
+        if (writeText.length !== 2 && typeof ctx.waterfall === 'function') {
+            const intent = await ctx.waterfall('fs/write-intent', target, exec, () => undefined);
+            const outcome = await writeText(target, content, intent, exec.signal, sandboxPolicy);
+            if (typeof ctx.emit === 'function') {
+                ctx.emit('fs/observed', target, { kind: 'present', version: outcome.version }, exec);
+            }
+            return outcome;
+        }
+        warnFsShapeOnce('no write-intent arity / no waterfall');
+        return await writeText(target, content);
     }
     catch (error) {
         if (error instanceof Error && error.name === 'PatchError')

package/lib/index.js

@@ -14,6 +14,11 @@
  */
 import { resolveConfig } from './config.js';
 import { registerApplyPatchTool } from './register.js';
+import { installSettingsCompat } from './compat.js';
+import { readVolatileBoolean } from './config.js';
+import { Config } from './config.js';
+/** 设置命名空间（0.1.5 及以下实例/模块注册面用；0.1.7+ 声明式线不消费）。 */
+export const SETTINGS_NAMESPACE = 'patch-edit-plus';
 /** Cordis plugin name used by Loader diagnostics. */
 export const name = 'dsh-patch-edit-plus';
 /**
@@ -43,10 +48,13 @@ export function apply(ctx, config) {
     // 组合条目（0.1.7 起 volatile 字段在其中是 live 引用）：rejudge 每次整体
     // 重解析一次，一次调用内是同一份快照；跨调用的最新值由事件驱动重取。
     const compositionEntry = config ?? {};
+    // 权威来源：设置层挂载时是解析后的 scope（installSection/installSettingsSection
+    // 的 setSource 在 attach 时先于 onChange 调用），否则是组合条目。
+    let readSource = () => compositionEntry;
     let disposer = null;
     let registeredKey = null;
     const rejudge = () => {
-        const next = resolveConfig(compositionEntry);
+        const next = resolveConfig(readSource());
         const key = JSON.stringify(next);
         if (key === registeredKey)
             return;
@@ -62,9 +70,29 @@ export function apply(ctx, config) {
             registeredKey = null;
         };
     });
+    // 三代腰无条件挂载：loader 在每一代都经由 entry schema 传 config——live ref
+    // 连命令式宿主上也在（TL 实证），所以不能用「entry 带对象」判代。世代分流
+    // 全在设置服务面内做：0.1.7+ 服务无 register/installSection → 回调空转；
+    // 0.1.2/0.1.5 installSection；0.1.0/0.1.1 register。base 用 readVolatile 展平。
+    const plainBase = {
+        ...compositionEntry,
+        allowUnifiedDiff: readVolatileBoolean(compositionEntry.allowUnifiedDiff, true),
+        allowCodexPatch: readVolatileBoolean(compositionEntry.allowCodexPatch, false),
+    };
+    installSettingsCompat(ctx, SETTINGS_NAMESPACE, Config, plainBase, {
+        setSource: (current) => { readSource = current; },
+        onChange: () => { rejudge(); },
+    });
     // 0.1.7+: 只有 volatile 字段变更才走这里（不 remount）；普通字段变更会整体
     // remount 插件，新一次 `apply` 自然读到全部新值。等值变更宿主不通知。
-    ctx.on('loader/volatile-update', () => {
-        rejudge();
-    });
+    // 老宿主不声明该事件——ctx.on 对未知事件名在极老 cordis 上的行为未知，
+    // 包一层 try/catch 让静默无更新成为唯一代价。
+    try {
+        ctx.on('loader/volatile-update', () => {
+            rejudge();
+        });
+    }
+    catch {
+        // pre-0.1.7 host: no volatile updates; normal config edits remount the plugin.
+    }
 }

package/lib/register.js

@@ -43,6 +43,8 @@ export function registerApplyPatchTool(ctx, cfg, logger) {
         resolvedName = found;
     }
     const definition = buildApplyPatchTool(resolvedName, ctx, cfg);
+    if (definition === null)
+        return null;
     try {
         return tools.register(definition);
     }

package/lib/shellops.js

@@ -32,6 +32,16 @@ export function deleteTemplate(cfg) {
 export function moveTemplate(cfg) {
     return cfg.moveCommand ?? (resolveDialect(cfg) === 'pwsh' ? PWSH_MOVE : POSIX_MOVE);
 }
+/** Raw path for shell env vars; old dsh-fs lines lack processPath — fall back to the target's encoded path. */
+function targetPath(ctx, target) {
+    try {
+        if (typeof ctx.fs.processPath === 'function') {
+            return ctx.fs.processPath(target);
+        }
+    }
+    catch { /* strict proxy or absent service */ }
+    return (target.path ?? target.displayPath);
+}
 /** Structurally resolve `ctx.shell` without assuming the service is mounted. */
 export function resolveShell(ctx) {
     try {
@@ -60,7 +70,7 @@ export async function removeFile(ctx, exec, cfg, target, sandboxPolicy) {
     const shell = requireShell(ctx, cfg);
     const request = {
         command: deleteTemplate(cfg),
-        env: { DSH_PATCH_TARGET: ctx.fs.processPath(target) },
+        env: { DSH_PATCH_TARGET: targetPath(ctx, target) },
         signal: exec.signal,
         timeoutMs: SHELL_TIMEOUT_MS,
         sandboxPolicy,
@@ -73,7 +83,7 @@ export async function moveFile(ctx, exec, cfg, source, target, sandboxPolicy) {
     const shell = requireShell(ctx, cfg);
     const request = {
         command: moveTemplate(cfg),
-        env: { DSH_PATCH_SOURCE: ctx.fs.processPath(source), DSH_PATCH_TARGET: ctx.fs.processPath(target) },
+        env: { DSH_PATCH_SOURCE: targetPath(ctx, source), DSH_PATCH_TARGET: targetPath(ctx, target) },
         signal: exec.signal,
         timeoutMs: SHELL_TIMEOUT_MS,
         sandboxPolicy,

package/lib/tool.js

@@ -7,7 +7,7 @@
  * batch edits, creation, deletion and renames.
  * @module dsh-patch-edit-plus/tool
  */
-import { defineTool } from '@deepseek-ai/dsh-tools';
+import * as dshToolsNamespace from '@deepseek-ai/dsh-tools';
 import { PatchError, codexDisabledError, limitError, unifiedDisabledError } from './errors.js';
 import { detectFormat } from './detect.js';
 import { resolveSandboxPolicy } from './policy.js';
@@ -24,15 +24,24 @@ const ROUTING_GUIDE = [
     '- Do not use apply_patch for trivial one-line single-file edits when the native edit tool is available.',
 ].join('\n');
 /**
- * Build the (frozen) tool definition. The tool name is passed in resolved
+/** Build the (frozen) tool definition. The tool name is passed in resolved
  * form so registration-side rename avoidance can mint variant names.
+ * Returns `null` when the host line's dsh-tools lacks `defineTool` — the
+ * caller skips registration instead of failing the loader entry.
  */
 export function buildApplyPatchTool(toolName, ctx, cfg) {
     const styles = [
         cfg.allowUnifiedDiff ? 'git/unified diff (default)' : null,
         cfg.allowCodexPatch ? 'Codex apply_patch syntax' : null,
     ].filter(style => style !== null).join(' and ');
-    const definition = defineTool({
+    const dshToolsSoft = dshToolsNamespace;
+    const defineToolImpl = dshToolsSoft.defineTool
+        ?? dshToolsSoft.default?.defineTool;
+    if (defineToolImpl === undefined) {
+        console.warn('[dsh-patch-edit-plus] @deepseek-ai/dsh-tools has no defineTool export on this host line; the apply_patch tool is not available.');
+        return null;
+    }
+    const definition = defineToolImpl({
         name: toolName,
         description: `Apply a patch-style change to one or more text files, all-or-nothing: every hunk is verified against current file content first, and nothing is written unless the whole patch applies. Accepts ${styles}. `
             + 'Add, update (multi-hunk), delete and move/rename operations are supported. Pass dryRun: true to validate without writing.\n' + ROUTING_GUIDE,

package/lib/types/client/index.d.ts

@@ -0,0 +1,48 @@
+import type { JSX } from 'react';
+/** 本插件消费的 configForms 值形状（与 host ResolvedConfig 的易变布尔对齐）。 */
+export interface PatchEditPlusConfig {
+    allowUnifiedDiff: boolean;
+    allowCodexPatch: boolean;
+}
+/** configForms 作用域面（结构性子集；0.1.7+ 缝，避免硬 peer 类型）。 */
+export interface PatchFormScope {
+    getSnapshot(): {
+        status: 'loading' | 'ready' | 'unavailable';
+        value: Partial<PatchEditPlusConfig> | undefined;
+        writable: boolean;
+    };
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<boolean>;
+}
+/** 客户端所需服务：slots 全世代都有，准声明；configForms 是 0.1.7+ 服务，
+ * **不准**进顶层 inject——在老宿主上声明缺失服务会把 client entry 永久挂起
+ * （web boot 拒渲染整树，「1 entry did not activate」家族教训）。configForms
+ * 走软读（strict proxy 直读 throw → try/catch 落 ctx.get），缺席时整卡隐藏。 */
+export declare const inject: string[];
+/** 轻量 ctx 类型（仅本客户端用到的方法；构建时类型被剥离）。 */
+interface SlotsFace {
+    inject: (_name: string, _fn: () => unknown) => () => void;
+    register: (_options: Record<string, unknown>, _component: unknown) => () => void;
+}
+interface ClientCtx {
+    slots: SlotsFace;
+    get?: (_name: string) => unknown;
+}
+/**
+ * 插件页配置卡主体：两行补丁风格开关。
+ * - status === 'unavailable'（无 configForms / entry 未装配）→ 整卡隐藏（null）；
+ * - status === 'loading' → 开关禁用；
+ * - 仅 snapshot.writable 时可写（写路径 `form.set(field, !cur)`）。
+ */
+export declare function PatchStyleCard(props: {
+    form?: PatchFormScope | undefined;
+}): JSX.Element | null;
+/**
+ * 客户端插件体：在 Plugins 页 bundle 详情页的 keyed 席位（key = 包名）下
+ * 注册配置卡。卡片自绑 `configForms.get('dsh-patch-edit-plus')`——form 在
+ * 渲染期解析（而非 apply 期固化），宿主晚于客户端半开始服务该 entry 时
+ * 也能追上；页面注入的 owner props（`{ view: 'page', form }`）不消费，
+ * 以本插件 entry 的作用域为唯一事实来源。
+ */
+export declare function apply(ctx: ClientCtx): void;
+export {};

package/lib/types/compat.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Generation-compat seams for the single max-range build (0.1.0-rc.8 → 0.2.0).
+ *
+ * Three old-line traps live here:
+ * 1. `.volatile()` — the schema method only exists on the 0.1.7+ schemastery
+ *    line; calling it blind is a load-time TypeError on older hosts. Condition
+ *    it with {@link maybeVolatile}.
+ * 2. The settings registration API is three generations deep: instance
+ *    `settings.installSection` (0.1.2/0.1.5, real-host verified), the module
+ *    `installSettingsSection` export of `@deepseek-ai/dsh-settings`
+ *    (0.1.0/0.1.1 — verified against the 0.1.0-rc.8 tarball; the
+ *    dsh-client-ui-settings package is a host-side no-op there), and the
+ *    declarative `.volatile()` form on 0.1.7+. {@link installSettingsCompat}
+ *    picks by feature detection, never by version number.
+ * 3. Every cross-generation import must ride a namespace soft-import: a static
+ *    named import of an absent export dies at ESM link time and takes the
+ *    whole loader entry down.
+ * @module dsh-patch-edit-plus/compat
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Config as PluginConfig } from './config.js';
+/** Wrap a schema field with `.volatile()` only when the host line supports it. */
+export declare function maybeVolatile<T>(schema: T): T;
+/** Settings service face covering both the 0.1.2+ and legacy registration APIs. */
+export interface SettingsFace {
+    installSection?(owner: unknown, namespace: string, schema: unknown, entry: unknown, hooks: {
+        setSource(current: () => PluginConfig): void;
+        onChange(): void;
+    }): unknown;
+    register?(namespace: string, schema: unknown, options: {
+        base?: unknown;
+    }): {
+        get(): PluginConfig;
+        watch(cb: () => void): void;
+    } | undefined;
+}
+export interface SettingsHooks {
+    setSource(current: () => PluginConfig): void;
+    onChange(): void;
+}
+/**
+ * Register the settings section across host generations. 0.1.7+ declarative
+ * volatile hosts never call this (their schema fields are already volatile and
+ * no registration call is wanted); this is the 0.1.5-and-below path.
+ */
+export declare function installSettingsCompat(ctx: Context, namespace: string, schema: unknown, entry: PluginConfig, hooks: SettingsHooks): void;