@chaoset/adaptive-perf 0.7.0 → 0.7.2

package/client/index.tsx

@@ -0,0 +1,477 @@
+import * as React from "react";
+import type { TypertRemoteContribution } from "@deepseek-ai/dsh-typert-protocol";
+
+    // ── 样式（注入 style 标签，模仿官方卡片外观）──────────────────────────
+    var css = ".ap_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;min-width:0;overflow:hidden}.ap_card[data-open=true]{border-color:var(--dsw-alias-border-l1);box-shadow:var(--dsw-shadow-lv1)}.ap_header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:10px;align-items:center;gap:12px;padding:12px 14px;display:flex}.ap_header:hover,.ap_card[data-open=true]>.ap_header{background:var(--dsw-alias-interactive-bg-hover)}.ap_title{flex:1;min-width:0;font-size:14px;font-weight:600;line-height:20px}.ap_badge{white-space:nowrap;background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 10%,transparent);color:var(--dsw-alias-state-success-primary);border-radius:999px;padding:1px 8px;font-size:11px;font-weight:500;line-height:16px}.ap_body{border-top:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);padding:10px 14px 12px}.ap_field{flex-direction:column;gap:4px;padding:8px 0;display:flex}.ap_label{font-size:12px;font-weight:500;line-height:18px}.ap_input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:32px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:6px;padding:0 10px;font-size:13px;line-height:20px}.ap_textarea{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);font:inherit;color:var(--dsw-alias-label-primary);border-radius:6px;padding:6px 10px;font-size:12px;line-height:18px;resize:vertical;min-height:120px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.ap_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:11px;line-height:16px}.ap_footer{border-top:1px solid var(--dsw-alias-border-l2);justify-content:flex-end;align-items:center;gap:8px;padding:8px 0 2px;display:flex}.ap_save{font:inherit;cursor:pointer;border:1px solid transparent;border-radius:6px;padding:4px 14px;font-size:12px;line-height:18px;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}.ap_discard{font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l2);border-radius:6px;padding:4px 14px;font-size:12px;line-height:18px;background:0 0;color:inherit}.ap_status{font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary);flex:1}.ap_status.ap_error{color:var(--dsw-alias-state-danger-primary)}";
+    var tagId = "@chaoset/adaptive-perf/client.css";
+    if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=\"" + tagId + "\"]") === null) {
+      var tag = document.createElement("style");
+      tag.dataset.plugin = "@chaoset/adaptive-perf";
+      tag.dataset.pluginCss = tagId;
+      tag.textContent = css;
+      document.head.appendChild(tag);
+    }
+
+    // ── 字典 ─────────────────────────────────────────────────────────────
+    const NS = "settings.plugins.adaptivePerf";
+    const zh = {
+      title: "极简性能自适应（adaptive-perf）",
+      hint: "让标准模式 / PTC 模式达到极简模式级别的高性能：抑制运行时上下文快照，启动即精简工具目录，按需求信号自动放行工具族。",
+      unsaved: "有未保存的修改",
+      discard: "放弃修改",
+      saving: "保存中…",
+      save: "保存",
+      saveFailed: "保存失败",
+      saved: "已保存，热生效（新会话立即生效）",
+      loadFailed: "读取配置失败",
+      invalidFamilies: "families 必须是合法 JSON 对象",
+      enabled: "启用插件",
+      presets: "目标 preset",
+      fieldPresets: "逗号分隔的 preset id（如 standard, code）",
+      suppressRuntimeContext: "抑制运行时上下文快照",
+      fieldSuppressRuntimeContext: "等同极简模式的 includeRuntimeContext: false，每次请求省掉快照文本（零功能损失）",
+      leanByDefault: "启动即精简工具目录",
+      fieldLeanByDefault: "默认隐藏编排类工具族（子代理/工作流/ralph/goal），核心编码工具保留",
+      escalateOnKeyword: "关键词自动放行",
+      fieldEscalateOnKeyword: "用户消息命中工具族触发词（如“子代理”）时，该会话放行对应工具族",
+      escalateOnUnknownTool: "失败自动放行",
+      fieldEscalateOnUnknownTool: "PTC 程序调用被隐藏工具报 UNKNOWN_TOOL 时自动放行对应族",
+      suppressInjectedContext: "常驻抑制注入上下文",
+      fieldSuppressInjectedContext: "整个会话剥离技能目录提醒（skill-catalog）与 AGENTS.md 摘要（agent-instructions），不再在晋升后恢复——替代品是 skill_search/skill_load 按需发现与一次性 instruction-hint（参照 dsh-anchored-standard：注入在场即使后置也扰动轨迹）",
+      families: "工具族（高级）",
+      fieldFamilies: "JSON：{ 族名: { enabled, tools: [工具名], keywords: [触发词] } }。保存后热生效。",
+      coreTools: "核心工具（永不隐藏）",
+      fieldCoreTools: "展示用：这些工具不进入任何限制族。未列入任何族的工具也默认保留。",
+      bootstrapEnabled: "首轮锚定（bootstrap）",
+      fieldBootstrapEnabled: "请求 #1 只暴露 Minimal 真实工具对并剥离自动注入上下文，首个持久信号（promoteOn）后恢复——让首轮轨迹锚定极简（参照 dsh-anchored-standard 实测：工具 schema + 注入提醒决定轨迹）",
+      bootstrapRealPair: "挂载真实 Minimal 工具对",
+      fieldBootstrapRealPair: "把官方 minimal preset 同款插件（持久 PTY bash + str_replace_editor）挂进会话作用域，按名阴影 standard 的 sandboxed bash——schema 与 Minimal 逐字相同才能锚定（issue #11：任何 standard 系 schema 11/11 落入 standard-like）；依赖官方插件包，缺失时自动降级",
+      bootstrapTools: "首轮工具",
+      fieldBootstrapTools: "请求 #1 可见的工具（真实 Minimal 对：bash, str_replace_editor）。逗号分隔。",
+      bootstrapPromoteOn: "晋升触发",
+      fieldBootstrapPromoteOn: "either（默认）：首个 tool/call 或 assistant/message 先到者晋升；tool-call / assistant-message 可单独指定",
+      bootstrapSuppressed: "剥离的注入上下文",
+      bootstrapDiscovery: "常驻发现工具（晋升后）",
+      fieldBootstrapSuppressed: "请求 #1 剥离的自动注入 source.kind（技能目录提醒 skill-catalog、AGENTS.md 摘要 agent-instructions）；逗号分隔，留空=不剥离",
+      fieldBootstrapDiscovery: "晋升后常驻目录的发现工具（dev_tool_search 搜索完整目录并按名解锁；skill_search / skill_load 按需加载技能）；逗号分隔",
+      bootstrapMaxTokens: "首轮输出预算封顶（token）",
+      fieldBootstrapMaxTokens: "请求 #1 的 maxTokens 封顶，晋升后自动剥离；0 = 不封顶（opt-in）",
+      minimalPromptEnabled: "极简提示词层（语域锚定）",
+      fieldMinimalPromptEnabled: "把系统提示拉回极简语域：屏蔽全局引导段 + 替换 persona。参考实现的完整锚定条件——仅收窄工具不足以翻转思维链风格（let me → let's/i'll/i need）",
+      minimalPromptPersona: "persona 文本",
+      fieldMinimalPromptPersona: "按名替换 deployment:persona；默认与极简模式逐字相同。留空 = 不替换（保留原 persona）",
+      minimalPromptSuppressSections: "屏蔽全局引导段",
+      fieldMinimalPromptSuppressSections: "屏蔽 harness:identity / harness:source / app:web-surface 三个全局段（等同极简 complete persona 的效果；plan-mode 与 PTC 的 SDK 段不受影响）"
+    };
+    const en = {
+      title: "Adaptive performance (adaptive-perf)",
+      hint: "Bring standard / PTC presets to minimal-mode-level performance: suppress the runtime-context snapshot, start with a lean tool catalog, and re-enable tool families on demand.",
+      unsaved: "Unsaved changes",
+      discard: "Discard",
+      saving: "Saving…",
+      save: "Save",
+      saveFailed: "Save failed",
+      saved: "Saved; hot-applied (new sessions take effect immediately)",
+      loadFailed: "Failed to load config",
+      invalidFamilies: "families must be valid JSON object",
+      enabled: "Enable plugin",
+      presets: "Target presets",
+      fieldPresets: "Comma-separated preset ids (e.g. standard, code)",
+      suppressRuntimeContext: "Suppress runtime-context snapshot",
+      fieldSuppressRuntimeContext: "Same as minimal's includeRuntimeContext: false; drops the snapshot text from every request (zero feature loss)",
+      leanByDefault: "Lean tool catalog at session start",
+      fieldLeanByDefault: "Hide orchestration families (subagent/workflow/ralph/goal) by default; core coding tools stay",
+      escalateOnKeyword: "Keyword escalation",
+      fieldEscalateOnKeyword: "A user message matching a family's trigger words re-enables that family for the session",
+      escalateOnUnknownTool: "Failure escalation",
+      fieldEscalateOnUnknownTool: "A PTC program calling a hidden tool (UNKNOWN_TOOL) re-enables that family",
+      suppressInjectedContext: "Always suppress injected context",
+      fieldSuppressInjectedContext: "Strip the skill-catalog reminder and the AGENTS.md digest from every request, not just request #1 — replaced by on-demand skill_search/skill_load and a one-shot instruction hint (per dsh-anchored-standard: the injections perturb the trajectory even after promotion)",
+      families: "Tool families (advanced)",
+      fieldFamilies: "JSON: { familyId: { enabled, tools: [names], keywords: [triggers] } }. Hot-applied on save.",
+      coreTools: "Core tools (never hidden)",
+      fieldCoreTools: "Informational: these never enter any restriction family. Tools not listed in any family stay visible too.",
+      bootstrapEnabled: "First-request bootstrap",
+      fieldBootstrapEnabled: "Request #1 exposes only the real Minimal tool pair and drops auto-injected context; the first durable signal (promoteOn) restores the catalog — anchors the first-request trajectory to minimal (per dsh-anchored-standard measurements)",
+      bootstrapRealPair: "Mount the real Minimal tool pair",
+      fieldBootstrapRealPair: "Mount the official minimal-preset plugins (persistent PTY bash + str_replace_editor) into the session scope, shadowing the standard sandboxed bash by name — only byte-identical schemas anchor (issue #11: every standard-family schema fell standard-like 11/11); degrades gracefully when the official packages are missing",
+      bootstrapTools: "Bootstrap tools",
+      fieldBootstrapTools: "Tools visible on request #1 (the real Minimal pair: bash, str_replace_editor). Comma-separated.",
+      bootstrapPromoteOn: "Promotion trigger",
+      fieldBootstrapPromoteOn: "either (default): first tool/call or assistant/message promotes; tool-call / assistant-message select one",
+      bootstrapSuppressed: "Suppressed injected context",
+      bootstrapDiscovery: "Resident discovery tools (post-promotion)",
+      fieldBootstrapSuppressed: "Auto-injected source.kinds stripped on request #1 (skill-catalog reminder, agent-instructions digest); comma-separated, empty = strip nothing",
+      fieldBootstrapDiscovery: "Resident discovery tools after promotion (dev_tool_search searches the full catalog and unlocks by name; skill_search / skill_load load skills on demand); comma-separated",
+      bootstrapMaxTokens: "First-request output cap (tokens)",
+      fieldBootstrapMaxTokens: "maxTokens cap for request #1, stripped after promotion; 0 = no cap (opt-in)",
+      minimalPromptEnabled: "Minimal prompt layer (register anchor)",
+      fieldMinimalPromptEnabled: "Pull the system prompt back to the minimal register: suppress the global orientation sections and replace the persona. The reference's full anchoring condition — tool narrowing alone does not flip the thinking style (let me → let's/i'll/i need)",
+      minimalPromptPersona: "Persona text",
+      fieldMinimalPromptPersona: "Shadows deployment:persona by name; defaults to the exact minimal-mode text. Empty = keep the original persona",
+      minimalPromptSuppressSections: "Suppress global orientation sections",
+      fieldMinimalPromptSuppressSections: "Shadow harness:identity / harness:source / app:web-surface to empty (same effect as minimal's complete persona; plan-mode and the PTC SDK sections are unaffected)"
+    };
+
+    // ── 表单字段 ─────────────────────────────────────────────────────────
+    function Field(props: any) {
+      return React.createElement(
+        "label",
+        { className: "ap_field" },
+        React.createElement("span", { className: "ap_label" }, props.label),
+        props.children,
+        props.hint !== void 0 ? React.createElement("p", { className: "ap_hint" }, props.hint) : null
+      );
+    }
+    function TextField(props: any) {
+      return React.createElement(Field, { label: props.label, hint: props.hint },
+        React.createElement("input", {
+          className: "ap_input",
+          value: props.value,
+          onChange: (e: any) => props.onChange(e.target.value),
+          disabled: props.disabled === true
+        })
+      );
+    }
+    function BoolField(props: any) {
+      return React.createElement(Field, { label: props.label, hint: props.hint },
+        React.createElement("input", {
+          type: "checkbox",
+          checked: props.value === true,
+          onChange: (e: any) => props.onChange(e.target.checked),
+          disabled: props.disabled === true
+        })
+      );
+    }
+    function familiesToText(families: any) {
+      return JSON.stringify(families, null, 2);
+    }
+    function textToFamilies(text: any) {
+      const parsed = JSON.parse(text);
+      if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new TypeError("families must be a JSON object");
+      }
+      for (const [id, fam] of Object.entries(parsed as Record<string, any>)) {
+        if (fam === null || typeof fam !== "object" || Array.isArray(fam)) {
+          throw new TypeError("family \"" + id + "\" must be an object");
+        }
+        if (fam.enabled !== void 0 && typeof fam.enabled !== "boolean") {
+          throw new TypeError("family \"" + id + "\".enabled must be a boolean");
+        }
+        for (const key of ["tools", "keywords"]) {
+          if (fam[key] !== void 0 && !(Array.isArray(fam[key]) && fam[key].every((v) => typeof v === "string"))) {
+            throw new TypeError("family \"" + id + "\"." + key + " must be an array of strings");
+          }
+        }
+      }
+      return parsed;
+    }
+
+    // ── 配置卡片 ─────────────────────────────────────────────────────────
+    function AdaptivePerfCard(props: any) {
+      const t = props.t;
+      const [open, setOpen] = React.useState(false);
+      const [cfg, setCfg] = React.useState<any>(null);
+      const [draft, setDraft] = React.useState<any>(null);
+      const [familiesText, setFamiliesText] = React.useState("");
+      const [saving, setSaving] = React.useState(false);
+      const [status, setStatus] = React.useState<any>(null);
+
+      React.useEffect(() => {
+        let cancelled = false;
+        props.getConfig().then((value: any) => {
+          if (cancelled) return;
+          setCfg(value);
+          setDraft(value);
+          setFamiliesText(familiesToText(value.families));
+        }).catch((error: any) => {
+          if (!cancelled) setStatus({ kind: "error", text: t("loadFailed") + ": " + (error && error.message || error) });
+        });
+        return () => { cancelled = true; };
+      }, []);
+
+      let familiesInvalid = false;
+      let familiesError = null;
+      if (draft !== null) {
+        try {
+          textToFamilies(familiesText);
+        } catch (error) {
+          familiesInvalid = true;
+          familiesError = (error as Error)?.message ?? String(error);
+        }
+      }
+      const dirty = draft !== null && (JSON.stringify(draft) !== JSON.stringify(cfg) || familiesInvalid === false && familiesToText(draft.families) !== familiesText);
+      const invalid = draft !== null && familiesInvalid;
+      const discard = () => {
+        setDraft(cfg);
+        setFamiliesText(cfg === null ? "" : familiesToText(cfg.families));
+        setStatus(null);
+      };
+      const save = () => {
+        if (draft === null || familiesInvalid) return;
+        let next = draft;
+        try {
+          next = { ...draft, families: textToFamilies(familiesText) };
+        } catch (error) {
+          setStatus({ kind: "error", text: t("invalidFamilies") + ": " + ((error as Error)?.message ?? String(error)) });
+          return;
+        }
+        setSaving(true);
+        setStatus(null);
+        props.setConfig(next).then(() => {
+          setCfg(next);
+          setDraft(next);
+          setFamiliesText(familiesToText(next.families));
+          setStatus({ kind: "ok", text: t("saved") });
+        }).catch((error: any) => {
+          setStatus({ kind: "error", text: t("saveFailed") + ": " + (error && error.message || error) });
+        }).finally(() => setSaving(false));
+      };
+
+      return React.createElement(
+        "li",
+        { className: "ap_card", "data-open": open },
+        React.createElement(
+          "button",
+          {
+            className: "ap_header",
+            type: "button",
+            onClick: () => setOpen(!open),
+            "aria-expanded": open
+          },
+          React.createElement("span", { className: "ap_title" }, t("title")),
+          dirty ? React.createElement("span", { className: "ap_badge" }, t("unsaved")) : null,
+          React.createElement("span", null, open ? "▲" : "▼")
+        ),
+        open ? React.createElement(
+          "div",
+          { className: "ap_body" },
+          React.createElement("p", { className: "ap_hint" }, t("hint")),
+          React.createElement(BoolField, {
+            label: t("enabled"),
+            value: draft === null ? true : draft.enabled,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, enabled: v })
+          }),
+          React.createElement(TextField, {
+            label: t("presets"),
+            hint: t("fieldPresets"),
+            value: draft === null ? "standard, code, cordis" : (draft.presets || []).join(", "),
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, presets: v.split(/[,，\s]+/).filter((x: any) => x.length > 0) })
+          }),
+          React.createElement(BoolField, {
+            label: t("suppressRuntimeContext"),
+            hint: t("fieldSuppressRuntimeContext"),
+            value: draft === null ? true : draft.suppressRuntimeContext,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, suppressRuntimeContext: v })
+          }),
+          React.createElement(BoolField, {
+            label: t("leanByDefault"),
+            hint: t("fieldLeanByDefault"),
+            value: draft === null ? false : draft.leanByDefault,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, leanByDefault: v })
+          }),
+          React.createElement(BoolField, {
+            label: t("escalateOnKeyword"),
+            hint: t("fieldEscalateOnKeyword"),
+            value: draft === null ? true : draft.escalateOnKeyword,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, escalateOnKeyword: v })
+          }),
+          React.createElement(BoolField, {
+            label: t("escalateOnUnknownTool"),
+            hint: t("fieldEscalateOnUnknownTool"),
+            value: draft === null ? true : draft.escalateOnUnknownTool,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, escalateOnUnknownTool: v })
+          }),
+          React.createElement(BoolField, {
+            label: t("suppressInjectedContext"),
+            hint: t("fieldSuppressInjectedContext"),
+            value: draft === null ? false : draft.suppressInjectedContext,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, suppressInjectedContext: v })
+          }),
+          React.createElement(BoolField, {
+            label: t("bootstrapEnabled"),
+            hint: t("fieldBootstrapEnabled"),
+            value: draft === null ? true : !!draft.bootstrap && draft.bootstrap.enabled,
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), enabled: v } })
+          }),
+          React.createElement(BoolField, {
+            label: t("bootstrapRealPair"),
+            hint: t("fieldBootstrapRealPair"),
+            value: draft === null ? true : !!draft.bootstrap && draft.bootstrap.realPair,
+            disabled: draft === null || (draft.bootstrap && draft.bootstrap.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), realPair: v } })
+          }),
+          React.createElement(TextField, {
+            label: t("bootstrapTools"),
+            hint: t("fieldBootstrapTools"),
+            value: draft === null ? "" : ((draft.bootstrap && draft.bootstrap.tools) || []).join(", "),
+            disabled: draft === null || (draft.bootstrap && draft.bootstrap.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), tools: v.split(/[,，\s]+/).filter((x: any) => x.length > 0) } })
+          }),
+          React.createElement(TextField, {
+            label: t("bootstrapPromoteOn"),
+            hint: t("fieldBootstrapPromoteOn"),
+            value: draft === null ? "" : (draft.bootstrap && draft.bootstrap.promoteOn) || "either",
+            disabled: draft === null || (draft.bootstrap && draft.bootstrap.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), promoteOn: (v.trim() || "either") } })
+          }),
+          React.createElement(TextField, {
+            label: t("bootstrapSuppressed"),
+            hint: t("fieldBootstrapSuppressed"),
+            value: draft === null ? "" : ((draft.bootstrap && draft.bootstrap.suppressedContextSources) || []).join(", "),
+            disabled: draft === null || (draft.bootstrap && draft.bootstrap.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), suppressedContextSources: v.split(/[,，\s]+/).filter((x: any) => x.length > 0) } })
+          }),
+          React.createElement(TextField, {
+            label: t("bootstrapDiscovery"),
+            hint: t("fieldBootstrapDiscovery"),
+            value: draft === null ? "" : ((draft.bootstrap && draft.bootstrap.discoveryTools) || []).join(", "),
+            disabled: draft === null || (draft.bootstrap && draft.bootstrap.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), discoveryTools: v.split(/[,，\s]+/).filter((x: any) => x.length > 0) } })
+          }),
+          React.createElement(TextField, {
+            label: t("bootstrapMaxTokens"),
+            hint: t("fieldBootstrapMaxTokens"),
+            value: draft === null ? "" : String((draft.bootstrap && draft.bootstrap.maxTokens) || 0),
+            disabled: draft === null || (draft.bootstrap && draft.bootstrap.enabled === false),
+            onChange: (v: any) => {
+              const n = Number(v.trim());
+              setDraft({ ...draft, bootstrap: { ...(draft.bootstrap || {}), maxTokens: Number.isSafeInteger(n) && n > 0 ? n : 0 } });
+            }
+          }),
+          React.createElement(BoolField, {
+            label: t("minimalPromptEnabled"),
+            hint: t("fieldMinimalPromptEnabled"),
+            value: draft === null ? true : (draft.minimalPrompt && draft.minimalPrompt.enabled === true),
+            disabled: draft === null,
+            onChange: (v: any) => setDraft({ ...draft, minimalPrompt: { ...(draft.minimalPrompt || {}), enabled: v } })
+          }),
+          React.createElement(BoolField, {
+            label: t("minimalPromptSuppressSections"),
+            hint: t("fieldMinimalPromptSuppressSections"),
+            value: draft === null ? true : (draft.minimalPrompt && draft.minimalPrompt.suppressSections === true),
+            disabled: draft === null || (draft.minimalPrompt && draft.minimalPrompt.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, minimalPrompt: { ...(draft.minimalPrompt || {}), suppressSections: v } })
+          }),
+          React.createElement(TextField, {
+            label: t("minimalPromptPersona"),
+            hint: t("fieldMinimalPromptPersona"),
+            value: draft === null ? "" : ((draft.minimalPrompt && draft.minimalPrompt.persona) || ""),
+            disabled: draft === null || (draft.minimalPrompt && draft.minimalPrompt.enabled === false),
+            onChange: (v: any) => setDraft({ ...draft, minimalPrompt: { ...(draft.minimalPrompt || {}), persona: v } })
+          }),
+          React.createElement(Field, {
+            label: t("families"),
+            hint: familiesInvalid ? t("invalidFamilies") + (familiesError !== null ? " — " + familiesError : "") : t("fieldFamilies")
+          },
+            React.createElement("textarea", {
+              className: "ap_textarea",
+              value: familiesText,
+              disabled: draft === null,
+              spellCheck: false,
+              onChange: (e: any) => setFamiliesText(e.target.value)
+            })
+          ),
+          React.createElement(Field, {
+            label: t("coreTools"),
+            hint: t("fieldCoreTools")
+          },
+            React.createElement("p", { className: "ap_hint" }, draft === null ? "" : (draft.coreTools || []).join(", "))
+          ),
+          React.createElement(
+            "div",
+            { className: "ap_footer" },
+            React.createElement(
+              "span",
+              { className: "ap_status" + (status !== null && status.kind === "error" ? " ap_error" : ""), role: "status" },
+              status !== null ? status.text : ""
+            ),
+            React.createElement(
+              "button",
+              { className: "ap_discard", type: "button", disabled: saving || draft === null || !dirty, onClick: discard },
+              t("discard")
+            ),
+            React.createElement(
+              "button",
+              { className: "ap_save", type: "button", disabled: saving || draft === null || invalid || !dirty, onClick: save },
+              saving ? t("saving") : t("save")
+            )
+          )
+        ) : null
+      );
+    }
+
+    // ── 插件 apply ───────────────────────────────────────────────────────
+    // DSH 客户端的 remote.<ns> 服务不会自动生成：必须由客户端代码用
+    // ctx.remote.$mount(contribution) 显式挂载（官方 dsh-api-remotes 即如此）。
+    // 若只把 remote.adaptivePerfConfig 写进 inject 而不挂载，命名空间永远
+    // 不存在，客户端插件会一直 pending，web boot 报 "did not activate"。
+    // 因此本插件先挂载自己的命名空间，再注册设置卡片。
+    const inject: any[] = ["slots", "locale", "remote"];
+    const passthroughSchema = { parse: (value: any) => value };
+    const REMOTE_CONTRIBUTION: TypertRemoteContribution = {
+      package: "@chaoset/adaptive-perf",
+      descriptors: [
+        {
+          id: "@chaoset/adaptive-perf#adaptivePerfConfig/get",
+          service: "adaptivePerfConfig",
+          namespace: "adaptivePerfConfig",
+          method: "get",
+          invocation: { kind: "direct" },
+          parameters: [],
+          result: { mode: "strict", typeSymbol: "adaptivePerfConfig/get:result", schema: passthroughSchema }
+        },
+        {
+          id: "@chaoset/adaptive-perf#adaptivePerfConfig/set",
+          service: "adaptivePerfConfig",
+          namespace: "adaptivePerfConfig",
+          method: "set",
+          invocation: { kind: "direct" },
+          parameters: [{
+            name: "partial",
+            wire: "partial",
+            source: "json",
+            codec: { mode: "strict", typeSymbol: "adaptivePerfConfig/set:partial", schema: passthroughSchema }
+          }],
+          result: { mode: "strict", typeSymbol: "adaptivePerfConfig/set:result", schema: passthroughSchema }
+        }
+      ]
+    };
+    async function apply(ctx: any) {
+      const t = ctx.locale.bind(NS);
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), "adaptive-perf: dictionaries");
+      // 先挂载命名空间，再用 ctx.get 取回服务：cordis 的属性访问（ctx.remote.X）
+      // 要求 X 出现在 inject 里，而本插件的命名空间由自己挂载，若写进 inject
+      // 会和自己等待的服务形成死锁，因此用 ctx.get（对未声明的服务合法）。
+      await ctx.remote.$mount(REMOTE_CONTRIBUTION);
+      const configService = ctx.get("remote.adaptivePerfConfig");
+      if (configService === void 0) throw new Error("adaptive-perf: remote.adaptivePerfConfig did not materialize after mount");
+      const getConfig = () => configService.get().then((result: any) => {
+        if (!result.ok) throw new Error("adaptivePerfConfig.get failed: " + result.error.code + ": " + result.error.message);
+        return result.value.config;
+      });
+      const setConfig = (partial: any) => configService.set(partial).then((result: any) => {
+        if (!result.ok) throw new Error("adaptivePerfConfig.set failed: " + result.error.code + ": " + result.error.message);
+        return result.value;
+      });
+      ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
+        name: "settings.plugin.item",
+        // keyed slot：key 为卡片编辑的设置 namespace（与 host 侧 serviceKey 一致），
+        // 设置页按 key 与宿主服务的 namespace 配对 dispatch。
+        key: "adaptivePerfConfig",
+        id: "adaptive-perf",
+        order: 40,
+        locale: NS,
+        inject: () => ({ getConfig, setConfig })
+      }, AdaptivePerfCard));
+    }
+
+    export { apply, inject };

package/lib/config-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * config-store — 插件配置持久化
+ *
+ * 配置文件位于 $DSH_HOME/plugins/<name>/config.json（默认 ~/.dsh，与
+ * file:// 部署模式共用）。生效顺序（后者覆盖前者）：
+ *   1. 插件内置默认值（DEFAULT_CONFIG）
+ *   2. cordis.patch.yml 传入的 config（安装时生成的默认块）
+ *   3. config.json（设置页 UI 保存，权威）
+ *
+ * 保存后通过 onUpdate 回调立即热更新运行中的配置（包装闭包读共享 state）。
+ * 写入采用随机临时文件 + fsync + rename，权限 0600；损坏 JSON 只告警并回退。
+ */
+export interface ConfigStoreOptions {
+    name: string;
+    defaults: Record<string, any>;
+    patchConfig: Record<string, any>;
+    onUpdate?: (merged: Record<string, any>, next: Record<string, any>) => void;
+    validate?: (partial: Record<string, any>) => void;
+    warn?: (message: string) => void;
+}
+export interface ConfigStore {
+    file: string;
+    effective(): Record<string, any>;
+    set(partial: Record<string, any>): Record<string, any>;
+}
+/**
+ * 创建配置存储。
+ * @param options - { name, defaults, patchConfig, onUpdate,
+ *   validate?: (partial) => void, warn?: (message) => void }
+ */
+export declare function createConfigStore(options: ConfigStoreOptions): ConfigStore;
+//# sourceMappingURL=config-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC5E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAyE1E"}

package/lib/config-store.js

@@ -0,0 +1,107 @@
+/**
+ * config-store — 插件配置持久化
+ *
+ * 配置文件位于 $DSH_HOME/plugins/<name>/config.json（默认 ~/.dsh，与
+ * file:// 部署模式共用）。生效顺序（后者覆盖前者）：
+ *   1. 插件内置默认值（DEFAULT_CONFIG）
+ *   2. cordis.patch.yml 传入的 config（安装时生成的默认块）
+ *   3. config.json（设置页 UI 保存，权威）
+ *
+ * 保存后通过 onUpdate 回调立即热更新运行中的配置（包装闭包读共享 state）。
+ * 写入采用随机临时文件 + fsync + rename，权限 0600；损坏 JSON 只告警并回退。
+ */
+import { randomUUID } from "node:crypto";
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+/**
+ * 创建配置存储。
+ * @param options - { name, defaults, patchConfig, onUpdate,
+ *   validate?: (partial) => void, warn?: (message) => void }
+ */
+export function createConfigStore(options) {
+    // 与 harness 的 DSH_HOME 约定保持一致：默认 ~/.dsh，可用 $DSH_HOME 覆盖。
+    const dshHome = process.env.DSH_HOME?.trim() ? resolve(process.env.DSH_HOME) : join(homedir(), ".dsh");
+    const file = join(dshHome, "plugins", options.name, "config.json");
+    const warn = options.warn ?? (() => { });
+    let readWarningShown = false;
+    function readJson() {
+        try {
+            if (!existsSync(file))
+                return {};
+            const parsed = JSON.parse(readFileSync(file, "utf8"));
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                readWarningShown = false;
+                return parsed;
+            }
+            if (!readWarningShown) {
+                readWarningShown = true;
+                warn(`config file ${file} must contain a JSON object; using empty config`);
+            }
+            return {};
+        }
+        catch (error) {
+            if (!readWarningShown) {
+                readWarningShown = true;
+                warn(`failed to read config file ${file}: ${error?.message ?? String(error)}; using empty config`);
+            }
+            return {};
+        }
+    }
+    /** 当前生效配置（默认 + patch + json 合并）。 */
+    function effective() {
+        return { ...options.defaults, ...options.patchConfig, ...readJson() };
+    }
+    /** 保存部分配置到 config.json 并触发热更新，返回新的生效配置。 */
+    function set(partial) {
+        if (partial === null || typeof partial !== "object" || Array.isArray(partial)) {
+            throw new TypeError("set expects a plain config object");
+        }
+        options.validate?.(partial);
+        const merged = { ...readJson(), ...partial };
+        mkdirSync(dirname(file), { recursive: true });
+        const tmp = `${file}.${process.pid}.${randomUUID()}.tmp`;
+        let fd;
+        try {
+            fd = openSync(tmp, "w", 0o600);
+            writeFileSync(fd, JSON.stringify(merged, null, 2) + "\n", "utf8");
+            fsyncSync(fd);
+            closeSync(fd);
+            fd = void 0;
+            renameSync(tmp, file);
+            // POSIX 目录项持久化（Windows 上目录句柄不可打开时忽略）。
+            try {
+                const dir = openSync(dirname(file), "r");
+                try {
+                    fsyncSync(dir);
+                }
+                finally {
+                    closeSync(dir);
+                }
+            }
+            catch { }
+        }
+        catch (error) {
+            if (fd !== void 0)
+                try {
+                    closeSync(fd);
+                }
+                catch { }
+            try {
+                unlinkSync(tmp);
+            }
+            catch { }
+            throw error;
+        }
+        const next = { ...options.defaults, ...options.patchConfig, ...merged };
+        try {
+            options.onUpdate?.(merged, next);
+        }
+        catch (error) {
+            warn(`onUpdate failed after config save: ${error?.message ?? String(error)}`);
+        }
+        return next;
+    }
+    return { file, effective, set };
+}
+//# sourceMappingURL=config-store.js.map

package/lib/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"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"}