@wenaixi/dsh-ponytail 5.0.0 → 5.1.0

package/lib/client.js

@@ -10,10 +10,10 @@ window.__ModuleLoader__.load({
     let e = React.createElement;
 
     // 官方 locale 接入：注册 ponytail 命名空间双语字典（真源 locale/*.json，构建期内嵌）
-    // 技能描述不翻译（用户边界）：由 server/frontmatter 下发，字典不含技能描述键
+    // 技能描述不翻译（用户边界）：由 configForms 快照与快照通道下发，字典不含技能描述键
     var NS = "ponytail";
-    var ZH = {"meta.title":"懒人模式（ponytail）","meta.description":"DietrichGebert/ponytail 的 DSH 完整移植：常驻懒人 senior 模式与七阶梯子（YAGNI 到最小实现），6 个中文原生技能（本体、评审、审计、债务、收益、帮助），零 tool 注册。","panel.title":"懒人模式配置","mode.title":"运行强度等级","mode.hint":"控制梯子提示词的注入强度，改动即时生效并写入配置文件，对所有会话生效。","mode.lockedHint":"当前有更高优先级的配置在生效，此处的修改不会改变实际运行等级。","mode.off":"关闭","mode.lite":"轻量","mode.full":"标准","mode.ultra":"激进","skills.title":"原生技能开关","skills.hint":"关闭后该技能不会出现在斜杠菜单，也不会被模型加载。","skills.toggleOn":"启用 {name}","skills.enabledToast":"技能 {name} 已启用","skills.hiddenToast":"技能 {name} 已隐藏","chain.hit":"生效中","chain.shadowed":"被覆盖","chain.unset":"未设置","chain.valueUnset":"(未设置)","priority.title":"配置优先级","priority.unavailable":"诊断信息不可用，请确认宿主版本已包含优先级诊断接口。","priority.intro":"运行等级按下列顺序取第一个有效值；被更高优先级压制的项，在界面上修改不会生效。当前生效：","state.loading":"读取中…","state.saved":"配置保存在 DSH 数据目录的 ponytail/config.json","error.operation":"操作失败：","confirm.reset":"确定恢复默认配置吗？等级回到标准（full），并重新启用全部 6 个技能。","button.reset":"恢复默认配置","toast.modeChanged":"运行等级已切为「{name}」","toast.resetDone":"已恢复默认配置","level.env":"环境变量","level.patch":"Profile 补丁","level.config":"用户配置文件","level.fallback":"内置兜底","problem.env":"值无效，已忽略","problem.patch":"值无效，已忽略","problem.config":"文件损坏或字段缺失"};
-    var EN = {"meta.title":"Ponytail (lazy senior mode)","meta.description":"A full DSH port of DietrichGebert/ponytail: the always-on lazy senior developer mode and its seven-rung ladder (YAGNI down to the minimum implementation), with six native Chinese skills (core, review, audit, debt, gain, help) and zero tool registrations.","panel.title":"Ponytail Config","mode.title":"Intensity Level","mode.hint":"Controls how strongly the ladder prompt is injected. Changes apply immediately and are written to the config file for all sessions.","mode.lockedHint":"A higher-priority configuration is in effect; changes here will not affect the actual runtime level.","mode.off":"Off","mode.lite":"Lite","mode.full":"Standard","mode.ultra":"Ultra","skills.title":"Native Skills","skills.hint":"Disabled skills disappear from the slash menu and are not loaded by the model.","skills.toggleOn":"Enable {name}","skills.enabledToast":"Skill {name} enabled","skills.hiddenToast":"Skill {name} hidden","chain.hit":"In effect","chain.shadowed":"Shadowed","chain.unset":"Unset","chain.valueUnset":"(unset)","priority.title":"Config Priority","priority.unavailable":"Diagnostics unavailable. Please confirm the host version ships the priority diagnostics endpoint.","priority.intro":"The runtime level takes the first valid value in the following order; items shadowed by a higher-priority source cannot be changed from the UI. Current: ","state.loading":"Loading…","state.saved":"Config is stored in ponytail/config.json under the DSH data directory","error.operation":"Operation failed: ","confirm.reset":"Restore default config? Level returns to Standard (full) and all 6 skills are re-enabled.","button.reset":"Restore defaults","toast.modeChanged":"Level switched to {name}","toast.resetDone":"Defaults restored","level.env":"Environment variable","level.patch":"Profile patch","level.config":"User config file","level.fallback":"Built-in fallback","problem.env":"Invalid value, ignored","problem.patch":"Invalid value, ignored","problem.config":"File corrupted or field missing"};
+    var ZH = {"button.reset":"恢复默认配置","chain.hit":"生效中","chain.shadowed":"被覆盖","chain.unset":"未设置","chain.valueUnset":"(未设置)","confirm.reset":"确定恢复默认配置吗？等级回到标准（full），并重新启用全部 6 个技能。","error.operation":"操作失败：","error.rejected":"本部署没有接受这次修改，值已保留供你核对。","level.env":"环境变量","level.fallback":"内置兜底","level.patch":"Profile 补丁","meta":{"title":"懒人模式","description":"常驻懒人资深开发者模式与七阶梯子（YAGNI 到最小实现），6 个中文原生技能（本体、评审、审计、债务、收益、帮助），零 Tool 注册。"},"meta.description":"DietrichGebert/ponytail 的 DSH 完整移植：常驻懒人 senior 模式与七阶梯子（YAGNI 到最小实现），6 个中文原生技能（本体、评审、审计、债务、收益、帮助），零 tool 注册。","meta.title":"懒人模式（ponytail）","mode.full":"标准","mode.hint":"控制梯子提示词的注入强度，改动即时生效并写入配置文件，对所有会话生效。","mode.lite":"轻量","mode.lockedHint":"当前有更高优先级的配置在生效，此处的修改不会改变实际运行等级。","mode.off":"关闭","mode.title":"运行强度等级","mode.ultra":"激进","panel.title":"懒人模式配置","priority.intro":"运行等级按下列顺序取第一个有效值；被更高优先级压制的项，在界面上修改不会生效。当前生效：","priority.title":"配置优先级","priority.unavailable":"诊断信息不可用，请确认宿主版本已包含优先级诊断接口。","problem.env":"值无效，已忽略","problem.patch":"值无效，已忽略","skills.enabledToast":"技能 {name} 已启用","skills.hiddenToast":"技能 {name} 已隐藏","skills.hint":"关闭后该技能不会出现在斜杠菜单，也不会被模型加载。","skills.title":"原生技能开关","skills.toggleOn":"启用 {name}","state.loading":"读取中…","state.readOnly":"本部署的设置为只读。","state.saved":"配置保存在当前 profile 的 ponytail 目录","toast.modeChanged":"运行等级已切为「{name}」","toast.resetDone":"已恢复默认配置"};
+    var EN = {"button.reset":"Restore defaults","chain.hit":"In effect","chain.shadowed":"Shadowed","chain.unset":"Unset","chain.valueUnset":"(unset)","confirm.reset":"Restore default config? Level returns to Standard (full) and all 6 skills are re-enabled.","error.operation":"Operation failed: ","error.rejected":"This deployment did not accept the change; your value was kept for you to review.","level.env":"Environment variable","level.fallback":"Built-in fallback","level.patch":"Profile patch","meta":{"title":"Lazy Senior Dev Mode","description":"Persistent lazy senior developer mode with a seven-rung ladder (YAGNI down to the smallest implementation), six native skills, and zero tool registration."},"meta.description":"A full DSH port of DietrichGebert/ponytail: the always-on lazy senior developer mode and its seven-rung ladder (YAGNI down to the minimum implementation), with six native Chinese skills (core, review, audit, debt, gain, help) and zero tool registrations.","meta.title":"Ponytail (lazy senior mode)","mode.full":"Standard","mode.hint":"Controls how strongly the ladder prompt is injected. Changes apply immediately and are written to the config file for all sessions.","mode.lite":"Lite","mode.lockedHint":"A higher-priority configuration is in effect; changes here will not affect the actual runtime level.","mode.off":"Off","mode.title":"Intensity Level","mode.ultra":"Ultra","panel.title":"Lazy Senior Dev Mode settings","priority.intro":"The runtime level takes the first valid value in the following order; items shadowed by a higher-priority source cannot be changed from the UI. Current: ","priority.title":"Config Priority","priority.unavailable":"Diagnostics unavailable. Please confirm the host version ships the priority diagnostics endpoint.","problem.env":"Invalid value, ignored","problem.patch":"Invalid value, ignored","skills.enabledToast":"Skill {name} enabled","skills.hiddenToast":"Skill {name} hidden","skills.hint":"Disabled skills disappear from the slash menu and are not loaded by the model.","skills.title":"Native Skills","skills.toggleOn":"Enable {name}","state.loading":"Loading…","state.readOnly":"This deployment stores settings read-only.","state.saved":"Config is stored in the ponytail directory of the current profile","toast.modeChanged":"Level switched to {name}","toast.resetDone":"Defaults restored"};
     // t 在 apply 时经 ctx.locale.bind 赋值；组件读取 factory 级变量（不接收 ctx，铁律）
     var localeCtx = null;
     var t = function (key, params) {
@@ -63,8 +63,8 @@ window.__ModuleLoader__.load({
         display: "flex",
         flexDirection: "column",
         gap: "2px",
-        minWidth: "0",
-        flex: "1",
+        minWidth: 0,
+        flex: 1,
       },
       chainName: {
         fontSize: "13px",
@@ -87,8 +87,8 @@ window.__ModuleLoader__.load({
         display: "flex",
         flexDirection: "column",
         gap: "2px",
-        minWidth: "0",
-        flex: "1",
+        minWidth: 0,
+        flex: 1,
       },
       rowName: {
         fontSize: "13px",
@@ -110,27 +110,20 @@ window.__ModuleLoader__.load({
       },
     };
 
-    const MODE_OPTIONS = [
-      { value: "off", label: t("mode.off") },
-      { value: "lite", label: t("mode.lite") },
-      { value: "full", label: t("mode.full") },
-      { value: "ultra", label: t("mode.ultra") },
-    ];
-
+    // 档位标签在 apply 时才绑定 locale（t 是 factory 级可变变量），因此按需取值而不是模块级求值
+    function modeOptions() {
+      return [
+        { value: "off", label: t("mode.off") },
+        { value: "lite", label: t("mode.lite") },
+        { value: "full", label: t("mode.full") },
+        { value: "ultra", label: t("mode.ultra") },
+      ];
+    }
 
-    // 技能元数据从 SKILL.md frontmatter 构建期提取（唯一真源，与宿侧 readSkillMeta 同源）
+    // 技能元数据从 SKILL.md frontmatter 构建期提取（唯一真源，与宿侧 readSkillMeta 同源）。
+    // 「是否启用」不再随服务端下发：它就是 configForms 快照里的 disabledSkills 取反。
     const SKILL_META = [{"id":"ponytail","description":"强制使用最懒但可用的解法，追求最简、最短、最精。像一位见过一切的老手：先质疑需求是否该存在（YAGNI），优先复用标准库、平台原生能力，一行能解决就不用五十行。支持 lite/full（默认）/ultra 三档强度。适用于任何编码任务：编写、新增、重构、修复、评审、设计代码，以及选型依赖。触发词：ponytail / 偷懒 / 懒人模式 / 最简解法 / 最小解法 / yagni / 少做一点 / 最短路径 / 讨厌过度设计、臃肿、样板代码、没必要的依赖时也请使用。非编码请求（常识、文案、翻译、总结、菜谱）请勿使用。\n"},{"id":"ponytail-audit","description":"全仓过度设计审计，类似 ponytail-review，但扫描的是整个代码库而非 diff：按可删行数排序，列出能删、能简化、能用标准库/原生替代的地方。触发词：审计代码库 / 审计过度设计 / 这个仓库能删什么 / 找臃肿 / ponytail-audit / /ponytail-audit。一次性报告，不直接改代码。\n"},{"id":"ponytail-debt","description":"把代码库中所有 `ponytail:` 注释收割为债务台账，让 ponytail 有意留下的捷径和延期不会悄悄烂成「以后再说就是永远不做」。触发词：ponytail debt / /ponytail-debt / ponytail 延期了什么 / 列出捷径 / ponytail 台账 / 标记了什么待做。一次性报告，不改代码。\n"},{"id":"ponytail-gain","description":"以精简看板展示 ponytail 的实测收益：更少代码、更低成本、更快速度，数据来自 benchmark 中位数。一次性展示，非持久模式，也非本仓实时统计。触发词：/ponytail-gain / ponytail gain / ponytail 能省多少 / 展示 ponytail 收益 / ponytail 看板。\n"},{"id":"ponytail-help","description":"ponytail 全量模式、技能与命令的速查卡，一次性展示，非持久模式。触发词：/ponytail-help / ponytail help / ponytail 有哪些命令 / 怎么用 ponytail。\n"},{"id":"ponytail-review","description":"专挑过度设计的代码评审，只找能删的东西：重复造的标准库、没必要的依赖、臆想的抽象、闲置的灵活性。每条发现一行写完：位置、该删什么、用什么替代。触发词：过度设计评审 / 能删什么 / 是否过度设计 / 简化评审 / ponytail-review / /ponytail-review。配合面向正确性的评审使用，本技能只猎复杂度。\n"}];
 
-    const EMPTY_CONFIG = {
-      currentMode: "full",
-      defaultMode: "full",
-      disabledSkills: [],
-      skills: SKILL_META.map(function (s) {
-        return { id: s.id, name: s.id, description: s.description, enabled: true };
-      }),
-      priority: null,
-    };
-
     // 诊断链一行的状态语义：生效 / 被覆盖 / 未设置 / 有问题
     function chainRowState(source) {
       if (source.problem) {
@@ -192,83 +185,166 @@ window.__ModuleLoader__.load({
       );
     }
 
-    function PonytailConfigPanel() {
-      const [state, setState] = React.useState({
-        loading: true,
-        saving: false,
-        error: null,
-        toast: null,
-        config: EMPTY_CONFIG,
-      });
+    /**
+     * 只读快照的最小 store：{ status, value }，够 React 的 useSyncExternalStore 订阅。
+     * 不引第三方 store 库——快照就一个对象，一个 Set 监听者 + 一个 getSnapshot 足够。
+     */
+    function createStore(initial) {
+      var listeners = new Set();
+      var current = initial;
+      return {
+        getSnapshot: function () { return current; },
+        subscribe: function (listener) {
+          listeners.add(listener);
+          return function () { listeners.delete(listener); };
+        },
+        set: function (next) {
+          current = next;
+          listeners.forEach(function (listener) { listener(); });
+        },
+      };
+    }
 
-      const applyResult = React.useCallback(function (data, message) {
-        setState(function (prev) {
-          return Object.assign({}, prev, {
-            loading: false,
-            saving: false,
-            error: null,
-            config: data && Array.isArray(data.skills) ? data : prev.config,
-            toast: message,
-          });
-        });
-        if (message) {
-          setTimeout(function () {
-            setState(function (prev) {
-              return Object.assign({}, prev, { toast: null });
-            });
-          }, 2600);
+    /**
+     * 本插件在浏览器侧向官方网关声明的 Remote 贡献。
+     *
+     * 为什么必须显式声明：网关的命名空间不是按需自动开通的。浏览器侧装配时
+     * dsh-api-remotes 只遍历一份编译期写死的官方贡献清单并逐个 ctx.remote.$mount()
+     *（dsh-api-remotes/lib/client.js:13512-13538，25 项，不含本插件）。
+     * 宿主侧 TypertRemoteService 只负责把端点暴露出去；客户端不 $mount，
+     * remote.ponytail 就永远不会出现——面板因此永久停在「诊断信息不可用」，
+     * 而宿主完全正常。写法参照官方第三方插件 dsh-experimental-client-ui-voice-input。
+     *
+     * result.create 是网关不校验的钩子（requireStrictCodec 只看 mode === "strict"，
+     * 见 dsh-api-gateway/lib/client.js:2073），解码走 result.decode，缺省即原样透传
+     * （同文件 1801 行）。因此返回恒等函数即可把服务端 JSON 原样送进面板，
+     * 不必为此引入 zod。
+     */
+    var PONYTAIL_REMOTE = {
+      package: "@wenaixi/dsh-ponytail",
+      descriptors: [
+        {
+          id: "@wenaixi/dsh-ponytail#ponytailRemote/snapshot",
+          service: "ponytailRemote",
+          namespace: "ponytail",
+          method: "snapshot",
+          invocation: { kind: "direct" },
+          parameters: [],
+          result: {
+            mode: "strict",
+            typeSymbol: "@wenaixi/dsh-ponytail/types#PonytailSnapshot",
+            create: function (value) { return value; },
+          },
+          sourceLocation: {
+            file: "src/ponytail-remote.ts",
+            line: 1,
+            column: 1,
+          },
+        },
+      ],
+    };
+    /** 挂载失败时的快照 store：面板按 status 降级为不显示该段。 */
+    function createUnavailableStore() {
+      var store = createStore({ status: "unavailable", value: null });
+      store.reload = function () {};
+      store.dispose = function () {};
+      return store;
+    }
+
+    /**
+     * 读取本插件已 $mount 的命名空间 snapshot，作为只读推导值的来源。
+     *
+     * 不再有轮询：命名空间由本文件下方的 PONYTAIL_REMOTE 经 ctx.remote.$mount() 挂载，
+     * $mount 返回的 disposer 之前挂载一定已经完成（它内部 await fiber，
+     * dsh-api-gateway/lib/client.js:1636-1646），因此同步问一次即可。
+     * 挂载失败（精简宿主没有 remote 服务）时立即降级为不显示，不再空转——
+     * 上一版的 40×50ms 轮询掩盖的是「压根没挂载」这个事实，而不只是时序。
+     */
+    function createRemoteStore(ctx, namespace) {
+      var store = createStore({ status: "loading", value: null });
+      var method = "snapshot";
+
+      var fail = function () {
+        store.set({ status: "unavailable", value: null });
+      };
+
+      var load = function () {
+        var ns = ctx.get("remote." + namespace);
+        if (ns === undefined || ns === null || typeof ns[method] !== "function") {
+          fail();
+          return;
         }
-      }, []);
+        Promise.resolve(ns[method]()).then(function (response) {
+          if (response && response.ok === true) store.set({ status: "ready", value: response.value });
+          else fail();
+        }).catch(fail);
+      };
+      load();
+      // 配置表单写入成功后由面板调用：重新拉一次服务端真值（当前等级可能已变）
+      store.reload = load;
+      store.dispose = function () {};
+      return store;
+    }
 
-      const load = React.useCallback(function () {
-        fetch("/api/plugins/ponytail/config")
-          .then(function (res) {
-            if (!res.ok) throw new Error("HTTP " + res.status);
-            return res.json();
-          })
-          .then(function (data) {
-            applyResult(data, null);
-          })
-          .catch(function (err) {
-            setState(function (prev) {
-              return Object.assign({}, prev, { loading: false, error: String(err) });
-            });
-          });
-      }, [applyResult]);
+    function PonytailConfigPanel(props) {
+      // 官方配置表单的快照：status / value / base / user / revision / writable
+      // （dsh-client-ui-settings 的 ConfigFormController，lib/client.js:1117-1131）。
+      const snapshot = props.usePonytailConfig(function (s) { return s; });
+      const [busy, setBusy] = React.useState(false);
+      const [note, setNote] = React.useState(null);
+
+      // 只读推导值来自远程命名空间；服务端不可用时降级为 null（不显示该段）
+      const snapshotRemote = props.usePonytailSnapshot(function (s) { return s; });
+      const remote = snapshotRemote.value;
 
-      React.useEffect(function () {
-        load();
-        // 语言切换后重取（官方 LocaleFace subscribe 语义：字典注册 bump revision）
-        var off = localeCtx ? localeCtx.subscribe(function () { load(); }) : null;
-        return function () { if (off) off(); };
-      }, [load]);
+      const writable = snapshot.writable === true && snapshot.status === "ready";
 
-      const post = function (body, message) {
-        setState(function (prev) {
-          return Object.assign({}, prev, { saving: true, error: null, toast: null });
+      // 写入：全部经官方 settings 通道，携带 revision 做冲突检测。
+      // 服务端拒绝时 mutate 返回 false，此时以服务端读回的下一份快照为准，
+      // 不做本地乐观改值——面板显示的必须是真值。
+      const applyOps = React.useCallback(function (ops, message) {
+        setBusy(true);
+        setNote(null);
+        // 写入经 face 注入的官方表单控制器（renderable 的 inject 面会把 hooks 绑成
+        // use<Name>，其余键原样作为 props）。此前这里读 props.scope，而 scope 是 apply
+        // 闭包里的变量、从未放进 face——点击即 TypeError，界面表现为「改了没反应且卡住」。
+        props.mutate(ops, snapshot.revision).then(function (landed) {
+          setBusy(false);
+          setNote(landed ? message : t("error.rejected"));
+          // 档位写入后重新拉一次服务端真值：当前生效等级可能随之改变，
+          // 而它不在 configForms 快照里（那是持久化配置，不是运行时推导值）。
+          if (landed && props.reloadRemote) props.reloadRemote();
         });
-        fetch("/api/plugins/ponytail/config", {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(body),
-        })
-          .then(function (res) {
-            return res.json();
-          })
-          .then(function (data) {
-            applyResult(data, message);
-          })
-          .catch(function (err) {
-            setState(function (prev) {
-              return Object.assign({}, prev, { saving: false, error: String(err) });
-            });
-          });
-      };
+      }, [props.mutate, snapshot.revision]);
+
+      const setMode = React.useCallback(function (mode) {
+        applyOps([{ op: "set", path: ["defaultMode"], value: mode }], t("toast.modeChanged", { name: mode }));
+      }, [applyOps]);
 
-      const config = state.config;
-      // 配置被更高优先级压制时，等级选择器整体禁用，避免用户做无效操作
-      const levelLocked = Boolean(config.priority && config.priority.chain && config.priority.chain.some(function (s) {
-        return s.level !== "config" && s.hit && s.level !== "fallback";
+      // 技能开关：disabledSkills 是覆盖式数组，每次写入都带上「目标技能的最终启用态」
+      const disabled = snapshot.value && Array.isArray(snapshot.value.disabledSkills)
+        ? snapshot.value.disabledSkills
+        : [];
+      const toggleSkill = React.useCallback(function (name, enabled) {
+        const next = enabled ? disabled.filter(function (item) { return item !== name; }) : disabled.concat([name]);
+        applyOps([{ op: "set", path: ["disabledSkills"], value: next }],
+          enabled ? t("skills.enabledToast", { name: name }) : t("skills.hiddenToast", { name: name }));
+      }, [applyOps, disabled]);
+
+      const resetAll = React.useCallback(function () {
+        applyOps([
+          { op: "unset", path: ["defaultMode"] },
+          { op: "unset", path: ["disabledSkills"] },
+        ], t("toast.resetDone"));
+      }, [applyOps]);
+
+      const config = snapshot.value || {};
+      const defaultMode = typeof config.defaultMode === "string" ? config.defaultMode : null;
+      // 只有环境变量命中才锁：env 压过一切，此时改 patch 确实无效。
+      // fallback 命中必须放行——那是「补丁与 env 都没写」的兜底，不是更高优先级的配置，
+      // 用户改 patch 立刻生效（此前把 fallback 也当压制源，提示文案在说谎）。
+      const levelLocked = Boolean(remote && Array.isArray(remote.priority && remote.priority.chain) && remote.priority.chain.some(function (s) {
+        return s.level === "env" && s.hit;
       }));
 
       return e(
@@ -276,57 +352,51 @@ window.__ModuleLoader__.load({
         { style: { display: "flex", flexDirection: "column", gap: "16px", maxWidth: "720px" } },
         e("h3", { style: { fontSize: "15px", fontWeight: "600", margin: "0", color: "var(--dsw-alias-label-primary)" } },
           t("panel.title")),
-        e(PrioritySection, { priority: config.priority }),
+        e(PrioritySection, { priority: remote ? remote.priority : null }),
         e(
           "div",
           { style: L.section },
           e("h4", { style: L.title }, t("mode.title")),
-          e("p", { style: L.hint },
-            t("mode.hint")),
+          e("p", { style: L.hint }, t("mode.hint")),
           e(P.SegmentedControl, {
             id: "ponytail-mode",
             label: t("mode.title"),
-            value: config.defaultMode,
-            options: MODE_OPTIONS,
-            disabled: state.saving || levelLocked,
-            onChange: function (next) {
-              post({ mode: next }, t("toast.modeChanged", { name: next }));
-            },
+            value: defaultMode === null ? remote && remote.priority ? remote.priority.effective : "full" : defaultMode,
+            options: modeOptions(),
+            disabled: busy || !writable || levelLocked,
+            onChange: setMode,
           }),
           levelLocked
-            ? e("p", { style: Object.assign({}, L.hint, { color: "var(--dsw-alias-state-warn-primary)" }) },
-                t("mode.lockedHint"))
+            ? e("p", { style: Object.assign({}, L.hint, { color: "var(--dsw-alias-state-warn-primary)" }) }, t("mode.lockedHint"))
+            : null,
+          !writable && snapshot.status === "ready"
+            ? e("p", { style: Object.assign({}, L.hint, { color: "var(--dsw-alias-state-warn-primary)" }) }, t("state.readOnly"))
             : null
         ),
         e(
           "div",
           { style: L.section },
           e("h4", { style: L.title }, t("skills.title")),
-          e("p", { style: L.hint },
-            t("skills.hint")),
+          e("p", { style: L.hint }, t("skills.hint")),
           e(
             "div",
             { style: { display: "flex", flexDirection: "column", gap: "6px" } },
-            config.skills.map(function (skill) {
+            SKILL_META.map(function (skill) {
+              const enabled = disabled.indexOf(skill.id) < 0;
               return e(
                 "div",
                 { key: skill.id, style: L.row },
                 e(
                   "div",
                   { style: L.rowText },
-                  e("span", { style: L.rowName }, "/" + skill.name),
+                  e("span", { style: L.rowName }, "/" + skill.id),
                   e("span", { style: L.rowDesc }, skill.description)
                 ),
                 e(P.Switch, {
-                  checked: skill.enabled,
-                  disabled: state.saving,
-                  label: t("skills.toggleOn", { name: skill.name }),
-                  onChange: function (next) {
-                    post(
-                      { toggleSkill: { name: skill.id, enabled: next } },
-                      t(next ? "skills.enabledToast" : "skills.hiddenToast", { name: skill.name })
-                    );
-                  },
+                  checked: enabled,
+                  disabled: busy || !writable,
+                  label: t("skills.toggleOn", { name: skill.id }),
+                  onChange: function (next) { toggleSkill(skill.id, next); },
                 })
               );
             })
@@ -336,27 +406,40 @@ window.__ModuleLoader__.load({
           "div",
           { style: Object.assign({}, L.footer, L.last) },
           e("span", { style: L.hint },
-            state.error
-              ? t("error.operation") + state.error
-              : state.toast
-                ? state.toast
-                : state.loading
-                  ? t("state.loading")
-                  : t("state.saved")),
+            note !== null
+              ? note
+              : snapshot.status === "loading"
+                ? t("state.loading")
+                : t("state.saved")),
           e(P.Button, {
             variant: "outline",
             size: "sm",
-            disabled: state.saving,
+            disabled: busy || !writable,
             onClick: function () {
               if (!confirm(t("confirm.reset"))) return;
-              post({ action: "reset" }, t("toast.resetDone"));
+              resetAll();
             },
           }, t("button.reset"))
         )
       );
     }
 
-    function apply(ctx) {
+    async function apply(ctx) {
+      // 先把只读推导值的端点挂到官方网关上：命名空间不会自动出现，
+      // 必须由客户端显式声明并 $mount。$mount 返回的 disposer 即 effect 的清理函数。
+      // 挂载失败（部署没有 remote 服务）不阻断其余能力，卡片照常出现，只是优先级段不显示。
+      var mounted = null;
+      try {
+        mounted = await ctx.remote.$mount(PONYTAIL_REMOTE);
+      } catch (error) {
+        if (ctx.logger) ctx.logger.warn("[ponytail] remote 贡献挂载失败（优先级诊断段将不显示）: " + String(error));
+      }
+      ctx.effect(function () {
+        return function () {
+          if (mounted) void mounted();
+        };
+      }, "ponytail: remote contribution");
+
       // 官方 locale：注册 ponytail 命名空间双语字典并绑定 t（真源 locale/*.json 构建期内嵌）
       ctx.effect(function () {
         return ctx.locale.register(NS, { zh: ZH, en: EN });
@@ -364,17 +447,55 @@ window.__ModuleLoader__.load({
       localeCtx = ctx.locale;
       t = ctx.locale.bind(NS);
 
-      // 插件卡片详情页：内联配置面板（keyed by 包名，已核实宿主 listBundles 的 name 即包名）
-      ctx.slots.inject("plugins.bundle.config", function () {
-        return ctx.slots.register(
-          { name: "plugins.bundle.config", key: "@wenaixi/dsh-ponytail" },
-          PonytailConfigPanel
-        );
-      });
+      // 官方配置表单：宿主 settings 服务投影出的 ponytail 命名空间
+      var scope = ctx.configForms.get("ponytail");
+
+      // 只读推导值：官方 Typert 通道（ctx.remote.ponytail.snapshot()）。
+      // 远程方法返回的是 { ok, value } / { ok:false, error } 信封（网关 client 侧 lib/client.js:1795-1802），
+      // 这里自己拆包并折成一个最小快照 store：命名空间不可用或调用失败时停在 unavailable，
+      // 优先级段降级为不显示，不影响其余控件。此处已在上面的 $mount 完成后才读，无需重试。
+      var remoteStore = mounted === null
+      ? createUnavailableStore()
+      : createRemoteStore(ctx, "ponytail");
+
+      // 插槽注册沿用 whileServed：命名空间没被宿主服务时卡片整体不出现，
+      // 部署若从未组合 settings 服务，页面上不留本插件的痕迹
+      // （与官方 dsh-client-ui-settings-shell 同一生命周期协议，ui-settings-shell/lib/client.js:182）。
+      //
+      // 数据面经 inject 提供：组件只从 props 消费，不触碰 ctx（渲染器铁律）。
+      // usePonytailConfig 读官方配置表单快照；usePonytailSnapshot 读远程快照；
+      // reloadRemote 在写入后让面板重新拉服务端真值。
+      var formStore = {
+        getSnapshot: function () { return scope.getSnapshot(); },
+        subscribe: function (listener) { return scope.subscribe(listener); },
+      };
+      var face = function () {
+        return {
+          hooks: {
+            ponytailConfig: formStore,
+            ponytailSnapshot: remoteStore,
+          },
+          // 直接透传官方表单控制器的方法：它自带写队列串行化、revision 冲突恢复
+          // 与镜像折入（dsh-client-ui-settings 的 ConfigFormController.mutate，lib/client.js:1177-1194）
+          mutate: function (ops, revision) { return scope.mutate(ops, revision); },
+          reloadRemote: function () { remoteStore.reload(); },
+        };
+      };
+
+      ctx.effect(function () {
+        return ctx.configForms.whileServed(["ponytail"], function () {
+          return ctx.slots.inject("plugins.bundle.config", function () {
+            return ctx.slots.register(
+              { name: "plugins.bundle.config", key: "@wenaixi/dsh-ponytail", locale: NS, inject: face },
+              PonytailConfigPanel
+            );
+          });
+        });
+      }, "ponytail: config card");
     }
 
     exports.apply = apply;
-    exports.inject = ["slots", "locale"];
+    exports.inject = ["slots", "locale", "configForms", "remote"];
     return module.exports;
   }
 });

package/lib/ponytail-config.d.ts

@@ -36,49 +36,66 @@ export declare function resolveDshHome(configured?: string, env?: Record<string,
  * 配置目录：DSH 数据根下的 ponytail 子目录。
  * 平台无关——路径分隔符一律由 node:path 生成，不含任何平台判断。
  */
-export declare function getConfigDir(): string;
-export declare function getConfigPath(): string;
+export declare function getConfigDir(profileDir?: string): string;
+export declare function getConfigPath(profileDir?: string): string;
 /**
- * 迁移前的旧配置路径（4.10.0-dsh.4 及以前使用的宿主平台约定位置）。
+ * 全局共享的旧配置路径（ADR-0005 时代的位置，被所有实例共享）。
  *
- * 仅用于一次性兼容读取：老用户升级后，新位置尚未生成时回退读取旧配置，
- * 避免已自定义的等级/技能开关静默丢失。写入永远只写新位置，
- * 旧目录不删除也不改写，数据所有权保持清晰。
- * ponytail: 兼容读取保留至下一个大版本（5.x 首发）后移除，届时可整段删除。
+ * 只在迁移窗口内被读：实例在「全局文件存在且 profile 内尚未生成」时导入，
+ * 导入后把全局文件改名标记为已迁，使后续实例从干净状态启动。
+ * 正常读写一律经 getConfigDir()，此路径不参与优先级链。
  */
-export declare function getLegacyConfigDir(): string | null;
-export declare function getLegacyConfigPath(): string | null;
+export declare function getSharedConfigPath(): string;
 /**
  * 读取配置文件原文：新位置优先，缺失时一次性回退旧位置。
  * 返回 null 表示两处都不存在或均不可读。
  */
-export declare function readConfigFileText(): string | null;
-export declare function getDefaultMode(): RuntimeMode;
+export declare function readConfigFileText(profileDir?: string): string | null;
+export declare function getDefaultMode(profileDir?: string): RuntimeMode;
 export interface FullConfigData {
     defaultMode: RuntimeMode;
     disabledSkills: string[];
 }
-export declare function readFullConfig(): FullConfigData;
+export declare function readFullConfig(profileDir?: string): FullConfigData;
 /**
  * 字段级 merge 写盘：保留 config.json 中用户手写的未知字段（不再重建为两键对象），
  * defaultMode 经 normalizeMode 校验——非法值拒绝返回 null 不写盘（writeDefaultMode 语义统一）。
  * 失败契约：写盘异常返回 null（与 resetFullConfig/writeDefaultMode 一致）。
  */
-export declare function writeFullConfig(patch: Partial<FullConfigData>): FullConfigData | null;
-export declare function resetFullConfig(): FullConfigData | null;
-export declare function writeDefaultMode(mode: string): RuntimeMode | null;
+export declare function writeFullConfig(patch: Partial<FullConfigData>, profileDir?: string): FullConfigData | null;
+export declare function resetFullConfig(profileDir?: string): FullConfigData | null;
+export declare function writeDefaultMode(mode: string, profileDir?: string): RuntimeMode | null;
+/**
+ * volatile 配置引用：宿主在 `.volatile()` 字段上放的活值容器（cosmokit/lib/index.js:102-108）。
+ * 写入经 settings 落到 profile 补丁；进程内由 loader 就地更新，无需重挂载插件。
+ */
+export interface VolatileRef<T> {
+    get(): T;
+}
 /**
  * 插件配置（entry 与 skill provider 共享，避免 ponytail-skills 反向导入 entry 造成循环依赖）
  * 默认值写 schema（Schemastery），review 不可作默认（#377）
+ *
+ * 迁移到官方配置组合后，两个可持久化字段声明为 volatile：解析结果是 VolatileRef 而非裸值，
+ * 读侧一律经 readVolatile()。未配置时引用内部是 undefined（不是缺字段），让位 resolvePriority。
  */
 export interface PonytailConfig {
-    /** 禁用的技能名称列表 */
-    disabledSkills?: string[];
+    /** 禁用的技能名称列表（volatile 引用） */
+    disabledSkills?: VolatileRef<string[]>;
     /** 注册到 ctx.skills 的 provider 名称 */
     providerName?: string;
     /** skill 目录绝对路径，默认取包内 skills/ */
     skillDir?: string;
-    /** 默认强度，off 则不自动激活 */
-    defaultMode?: 'off' | 'lite' | 'full' | 'ultra';
+    /** 默认强度，off 则不自动激活（volatile 引用） */
+    defaultMode?: VolatileRef<'off' | 'lite' | 'full' | 'ultra'>;
 }
+/**
+ * 读一个可能是 volatile 引用、可能是裸值、也可能读到 undefined 的字段。
+ *
+ * 为什么必须容这三态：schemastery 对 `.volatile()` 字段无条件造出引用（其值取 schema 默认值，
+ * schemastery/lib/index.mjs:480），没有默认值时也是「引用包着 undefined」；
+ * 而直接构造 config 对象的测试路径拿到的是裸值。两者必须读出同一业务值，
+ * 否则同一字段在不同入口会给出不同结果。
+ */
+export declare function readVolatile<T>(field: VolatileRef<T> | T | undefined): T | undefined;
 //# sourceMappingURL=ponytail-config.d.ts.map

package/lib/ponytail-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ponytail-config.d.ts","sourceRoot":"","sources":["../src/ponytail-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,eAAO,MAAM,YAAY,SAAS,CAAA;AAClC,eAAO,MAAM,aAAa,2CAA4C,CAAA;AAEtE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI9D;AAID,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9C;AAMD,mEAAmE;AACnE,eAAO,MAAM,YAAY,aAAa,CAAA;AAetC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAKjH;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAQlD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAGnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAWlD;AAED,wBAAgB,cAAc,IAAI,WAAW,CAiB5C;AAGD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AA0BD,wBAAgB,cAAc,IAAI,cAAc,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,GAAG,IAAI,CA8BrF;AAED,wBAAgB,eAAe,IAAI,cAAc,GAAG,IAAI,CAKvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMjE;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAChD"}
+{"version":3,"file":"ponytail-config.d.ts","sourceRoot":"","sources":["../src/ponytail-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,eAAO,MAAM,YAAY,SAAS,CAAA;AAClC,eAAO,MAAM,aAAa,2CAA4C,CAAA;AAEtE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI9D;AAID,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9C;AAMD,mEAAmE;AACnE,eAAO,MAAM,YAAY,aAAa,CAAA;AAetC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAKjH;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrE;AAED,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAiB/D;AAGD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AA0BD,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAElE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA8B1G;AAED,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAK1E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMtF;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,GAAG,IAAI,CAAC,CAAA;CACT;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IACtC,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CAC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAMpF"}