@aiwayds/dsh-llm-proxy 0.5.0 → 0.6.0

package/README.md

@@ -29,7 +29,7 @@ dsh plugin add @aiwayds/dsh-llm-proxy   # 或在 settings.yaml 的 plugins 里
 #     name: '@aiwayds/dsh-llm-proxy'
 ```
 
-> **要求 dsh >= 0.1.5-rc.2** — 本插件只跟随 dsh RC/stable 线（CI 与发版在运行时解析 latest/next 中更新的 dist-tag）。**不再支持 alpha 线。**
+> **要求 dsh >= 0.1.7-rc.1** — 本插件只跟随 dsh RC/stable 线（CI 与发版在运行时解析 latest/next 中更新的 dist-tag）。**不再支持 alpha 线。**
 
 > ⚠️ 最低宿主要求：0.2.0 起本插件声明 `inject: ['skills']`，要求宿主 dsh 提供 skills
 > 服务（`@deepseek-ai/dsh-skill` 0.1.1-rc 系列+）。无该服务的旧宿主上，本插件（含代理
@@ -81,36 +81,42 @@ rm -r ~/.agents/skills/dsh-llm-proxy-config   # npx skills add 装出的条目
 （devDependencies 保留供本地构建）。请勿把它们挪进 dependencies——那会装出第二份
 cordis 闭包，导致双实例崩溃（详见 dsh 生态 link-dsh-closure 机制）。
 
-## 配置入口（settings.yaml 命名空间段）
+## 配置入口（插件 entry config / 设置页）
 
-dsh 插件的用户配置唯一入口是 **settings.yaml 里按插件 id 命名的命名空间段**。本插件通过
-`@deepseek-ai/dsh-settings`（要求 `>=0.1.5-rc.2`）settings provider 的
-`installSection` 注册了 `dsh-llm-proxy` 命名空间
-（与 harness 内置插件 `llm-deepseek` 的 `llm-deepseek:` 段同机制），所以请在
-`~/.dsh/settings.yaml` 写：
+dsh 0.1.7 起，插件配置 = **插件声明的 static Config schema**（声明即注册）：本插件为
+entry `dsh-llm-proxy` 声明了 `enabled` / `systemMode` / `llmProxy` 三个字段且全部
+`.volatile()`，宿主据此在设置页生成表单，用户值落在 profile patch 里该 entry 的
+`config:` 段；设置页改动**免重启热生效**（volatile-only 写入不重挂插件，本插件原地
+重建 router，值未变的写入自动跳过重建）。
 
 ```yaml
-dsh-llm-proxy:
-  enabled: true                    # 总开关，默认 true；false 时完全不动全局
-  systemMode: env                  # 'env'（默认，读环境变量）| 'off'（全部直连，仅 llmProxy 生效）
-  llmProxy:                        # 匹配列表，按顺序首条命中生效
-    - match: "api.deepseek.org"    # 域名精确匹配（含任意端口）
-      proxy: "http://127.0.0.1:7890"
-    - match: "*.volces.com"        # 通配：volces.com 本身 + 任意子域
-      proxy: "http://127.0.0.1:7891"
-    - match: "https://api.openai.com"  # 完整 origin 精确匹配（大小写不敏感）
-      proxy: "http://127.0.0.1:7892"
+# profile 的 cordis.patch.yml（设置页写入也落在这里）：
+- id: dsh-llm-proxy
+  config:
+    enabled: true                    # 总开关，默认 true；false 时完全不动全局
+    systemMode: env                  # 'env'（默认，读环境变量）| 'off'（全部直连，仅 llmProxy 生效）
+    llmProxy:                        # 匹配列表，按顺序首条命中生效
+      - match: "api.deepseek.org"    # 域名精确匹配（含任意端口）
+        proxy: "http://127.0.0.1:7890"
+      - match: "*.volces.com"        # 通配：volces.com 本身 + 任意子域
+        proxy: "http://127.0.0.1:7891"
+      - match: "https://api.openai.com"  # 完整 origin 精确匹配（大小写不敏感）
+        proxy: "http://127.0.0.1:7892"
 ```
 
 要点：
 
-- **顶层键必须是 `dsh-llm-proxy:`**（与插件 id 一致）。写其他键（如 `llm-proxy:`）不会
-  被读到，静默失效。
-- 编辑 settings.yaml **热生效**：settings provider 发布变更后，插件会拆掉旧 router、按新
-  配置重建，无需重启。
+- **旧 `settings.yaml` 的 `dsh-llm-proxy:` 段自动迁移**：0.1.7 宿主启动时把旧
+  settings.yaml 各段按「段名 = entry id」一次性导入 profile patch。本插件旧段名与
+  entry id 同为 `dsh-llm-proxy`、三个键都在 volatile Config 里，存量用户值零手工迁移
+  （导入后旧文件被宿主改名为 `settings.yaml.imported`）。
+- **entry id 必须是 `dsh-llm-proxy`**（bundle patch insert 的 id）。旧 settings.yaml 段名
+  写成其他键（如 `llm-proxy:`）不会被导入，静默失效。
+- 编辑 **热生效**：volatile-only 改动不重挂插件，插件拆掉旧 router、按新配置原地重建，
+  无需重启。
 - bundle entry config（`cordis.patch.yml` insert 行的 `config:`）作为 base 层仍然有效；
-  settings.yaml 段覆盖其上的同名键。
-- 未挂载 settings 服务的宿主自动回退到 entry config，插件照常工作。
+  profile patch/设置页值覆盖其上的同名键。
+- 未挂载 settings 服务的宿主上，事件订阅自动休眠，entry config 照常生效。
 
 ### match 规则
 
@@ -159,7 +165,7 @@ undici `ProxyAgent` 只支持 **http:// 与 https://** 上游代理。
 ```bash
 # 1. 配一个本地回显代理（如 clash/mihomo 的 mixed-port 7890）
 export HTTPS_PROXY=http://127.0.0.1:7890
-# 2. settings.yaml 配 dsh-llm-proxy 段，把某个 API 域名指到另一端口
+# 2. 给 dsh-llm-proxy entry 配 llmProxy（设置页/profile patch），把某个 API 域名指到另一端口
 # 3. 启动 dsh 后发起对话，观察代理访问日志：
 #    - llmProxy 命中域名的请求出现在该条代理日志里
 #    - 其他外网请求出现在 7890 日志里

package/icon.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg">
+  <path d="M12 3.5 20.5 12 12 20.5 3.5 12Z"/>
+  <path d="M1.5 12h2M20.5 12h2"/>
+  <circle cx="12" cy="12" r="1.2"/>
+</svg>

package/lib/index.d.ts

@@ -14,13 +14,16 @@
  * apply() also registers a bundled skill (skills/dsh-llm-proxy-config/SKILL.md) that
  * carries the plugin's configuration and troubleshooting guide.
  *
- * User configuration arrives exclusively through the `dsh-llm-proxy`
- * settings.yaml namespace (registered via the settings provider's
- * installSection, the same seam harness core plugins use); the bundle entry
- * config is the base layer.
- * Edits to the settings section hot-publish: the router is rebuilt in place,
- * unless the resolved values are unchanged, in which case the rebuild is
- * skipped (the settings attach itself fires one redundant onChange).
+ * User configuration is declared as the plugin's static Config schema
+ * (`apply.Config`, the dsh >= 0.1.7-rc.1 settings system): every field is
+ * `.volatile()`, so the settings page can edit all of them and volatile-only
+ * writes swap the live references in place without remounting the plugin. The
+ * host's `settings/document-updated` event for this entry triggers a rejudge
+ * that rebuilds the router in place — unless the resolved values are
+ * unchanged, in which case the rebuild is skipped. Legacy `settings.yaml`
+ * sections are imported once by the host at startup (the old namespace equals
+ * the bundle entry id `dsh-llm-proxy`, so existing user values carry over);
+ * the bundle entry config remains the base layer under profile patches.
  *
  * Environment variables are only read, never written: mutating
  * process.env.HTTP_PROXY in an already-started process has no effect on
@@ -28,7 +31,7 @@
  *
  * @module @aiwayds/dsh-llm-proxy
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { Context, Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import * as undici from 'undici';
 import { type LlmProxyEntry } from './router.ts';
@@ -37,8 +40,29 @@ export { createProxyRouterDispatcher, resolveRoute, type LlmProxyEntry, type Rou
 export declare const name = "dsh-llm-proxy";
 /** Service required by the bundled skill provider. */
 export declare const inject: string[];
-/** Plugin configuration. */
+/**
+ * Runtime plugin configuration as injected into {@link apply}: every field is
+ * a live volatile reference declared in the static {@link Config} schema. The
+ * host swaps the references in place on settings-page edits (no plugin
+ * remount); `.get()` returns a deep-frozen snapshot of the current values.
+ */
 export interface Config {
+    /** Master switch; `false` leaves globals untouched (default `true`). */
+    enabled: Volatile<boolean>;
+    /**
+     * Fallback mode for requests no llmProxy entry matches (default `env`):
+     * `env` applies HTTPS_PROXY / HTTP_PROXY / ALL_PROXY / NO_PROXY from the
+     * startup environment; `off` connects directly.
+     */
+    systemMode: Volatile<'env' | 'off'>;
+    /** Ordered LLM proxy list; the first entry whose match hits wins. */
+    llmProxy: Volatile<Array<{
+        match: string;
+        proxy: string;
+    }>>;
+}
+/** Plain (unwrapped) plugin configuration values, e.g. from an entry patch. */
+export interface ConfigInput {
     /** Master switch; `false` leaves globals untouched (default `true`). */
     enabled?: boolean;
     /**
@@ -48,13 +72,42 @@ export interface Config {
      */
     systemMode?: 'env' | 'off';
     /** Ordered LLM proxy list; the first entry whose match hits wins. */
-    llmProxy?: Array<{
+    llmProxy?: ReadonlyArray<{
         match: string;
         proxy: string;
     }>;
 }
-/** Runtime schema for {@link Config}. */
-export declare const Config: z<Config>;
+/**
+ * Static config schema for the plugin: declaration is registration in the
+ * 0.1.7 settings system — the host projects this schema into the entry's
+ * settings form (keyed by the entry id {@link ENTRY_ID}) and resolves entry
+ * configs through it. All three fields are user-adjustable proxy policy and
+ * are marked `.volatile()` so the settings page offers them with hot reload:
+ * volatile-only edits never remount the plugin, and {@link apply} rebuilds
+ * the router in place when the values actually change. Every field carries a
+ * `.default()` so an unconfigured entry still resolves fully populated.
+ */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    enabled: z<boolean, boolean, "volatile-defined">;
+    systemMode: z<"env" | "off", "env" | "off", "volatile-defined">;
+    llmProxy: z<NoInfer<({
+        match?: string | null | undefined;
+        proxy?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict)[]>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        match: z<string, string, "plain">;
+        proxy: z<string, string, "plain">;
+    }>>[]>, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    enabled: z<boolean, boolean, "volatile-defined">;
+    systemMode: z<"env" | "off", "env" | "off", "volatile-defined">;
+    llmProxy: z<NoInfer<({
+        match?: string | null | undefined;
+        proxy?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict)[]>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        match: z<string, string, "plain">;
+        proxy: z<string, string, "plain">;
+    }>>[]>, "volatile-defined">;
+}>>, "plain">;
 /**
  * Mask the userinfo part of a proxy URL ("user:pass@host") so log lines and
  * error messages never carry credentials.
@@ -68,9 +121,9 @@ export interface ResolvedConfig {
 }
 /**
  * Validate, default, and freeze the plugin configuration.
- * @param config - optional plugin configuration; omission selects defaults.
+ * @param config - optional plain configuration values; omission selects defaults.
  */
-export declare function resolveConfig(config: Config | undefined): ResolvedConfig;
+export declare function resolveConfig(config: ConfigInput | undefined): ResolvedConfig;
 /** Injectable seams for tests; production defaults build real undici agents. */
 export interface ApplyInternals {
     /**
@@ -93,11 +146,35 @@ export interface ApplyInternals {
  */
 export declare function stripFrontmatter(raw: string): string;
 /**
- * Install the global routing dispatcher, wire the `dsh-llm-proxy` settings
- * namespace, register the bundled skill provider, and register teardown.
+ * Install the global routing dispatcher, subscribe to this entry's settings
+ * updates, register the bundled skill provider, and register teardown.
  * @param ctx - plugin context owning the dispose effect.
- * @param config - composition entry config; the base layer under the
- *   settings.yaml `dsh-llm-proxy` section.
+ * @param config - live volatile references resolved from the entry config
+ *   through the static {@link Config} schema (the base layer under the
+ *   user's profile patch / imported settings section); omission selects the
+ *   schema defaults.
  * @param internals - injectable dispatcher factories for tests.
  */
-export declare function apply(ctx: Context, config?: Config, internals?: ApplyInternals): void;
+export declare const apply: ((ctx: Context, config?: Config, internals?: ApplyInternals) => void) & {
+    Config: z<Schemastery.ObjectS<NoInfer<{
+        enabled: z<boolean, boolean, "volatile-defined">;
+        systemMode: z<"env" | "off", "env" | "off", "volatile-defined">;
+        llmProxy: z<NoInfer<({
+            match?: string | null | undefined;
+            proxy?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict)[]>, NoInfer<Schemastery.ObjectT<NoInfer<{
+            match: z<string, string, "plain">;
+            proxy: z<string, string, "plain">;
+        }>>[]>, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: z<boolean, boolean, "volatile-defined">;
+        systemMode: z<"env" | "off", "env" | "off", "volatile-defined">;
+        llmProxy: z<NoInfer<({
+            match?: string | null | undefined;
+            proxy?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict)[]>, NoInfer<Schemastery.ObjectT<NoInfer<{
+            match: z<string, string, "plain">;
+            proxy: z<string, string, "plain">;
+        }>>[]>, "volatile-defined">;
+    }>>, "plain">;
+};

package/lib/index.js

@@ -14,13 +14,16 @@
  * apply() also registers a bundled skill (skills/dsh-llm-proxy-config/SKILL.md) that
  * carries the plugin's configuration and troubleshooting guide.
  *
- * User configuration arrives exclusively through the `dsh-llm-proxy`
- * settings.yaml namespace (registered via the settings provider's
- * installSection, the same seam harness core plugins use); the bundle entry
- * config is the base layer.
- * Edits to the settings section hot-publish: the router is rebuilt in place,
- * unless the resolved values are unchanged, in which case the rebuild is
- * skipped (the settings attach itself fires one redundant onChange).
+ * User configuration is declared as the plugin's static Config schema
+ * (`apply.Config`, the dsh >= 0.1.7-rc.1 settings system): every field is
+ * `.volatile()`, so the settings page can edit all of them and volatile-only
+ * writes swap the live references in place without remounting the plugin. The
+ * host's `settings/document-updated` event for this entry triggers a rejudge
+ * that rebuilds the router in place — unless the resolved values are
+ * unchanged, in which case the rebuild is skipped. Legacy `settings.yaml`
+ * sections are imported once by the host at startup (the old namespace equals
+ * the bundle entry id `dsh-llm-proxy`, so existing user values carry over);
+ * the bundle entry config remains the base layer under profile patches.
  *
  * Environment variables are only read, never written: mutating
  * process.env.HTTP_PROXY in an already-started process has no effect on
@@ -41,25 +44,30 @@ export const name = 'dsh-llm-proxy';
 /** Service required by the bundled skill provider. */
 export const inject = ['skills'];
 /**
- * The settings.yaml namespace this plugin owns. dsh feeds user configuration
- * to plugins only through registered settings namespaces; the document
- * section key that reaches this plugin is exactly this string.
- *
- * A plain literal is the supported spelling since dsh-settings
- * 0.1.2-alpha.3: `register`/`installSection` brand-check the namespace at the
- * type level (`SettingsNamespaceInput`) and validate the same pattern at
- * runtime (`parseSettingsNamespace`), replacing the removed
- * `settingsNamespace()` helper.
+ * The bundle entry id this plugin mounts under (the `cordis.patch.yml`
+ * insert). In the 0.1.7 settings system the entry id doubles as the settings
+ * document namespace: `settings/document-updated` events for this id concern
+ * this plugin's form. It equals the pre-0.1.7 settings.yaml namespace, so
+ * legacy user sections are imported by the host into this entry unchanged.
+ */
+const ENTRY_ID = 'dsh-llm-proxy';
+/**
+ * Static config schema for the plugin: declaration is registration in the
+ * 0.1.7 settings system — the host projects this schema into the entry's
+ * settings form (keyed by the entry id {@link ENTRY_ID}) and resolves entry
+ * configs through it. All three fields are user-adjustable proxy policy and
+ * are marked `.volatile()` so the settings page offers them with hot reload:
+ * volatile-only edits never remount the plugin, and {@link apply} rebuilds
+ * the router in place when the values actually change. Every field carries a
+ * `.default()` so an unconfigured entry still resolves fully populated.
  */
-const SETTINGS_NAMESPACE = 'dsh-llm-proxy';
-/** Runtime schema for {@link Config}. */
 export const Config = z.object({
-    enabled: z.boolean().default(true),
-    systemMode: z.union([z.const('env'), z.const('off')]).default('env'),
+    enabled: z.boolean().default(true).volatile(),
+    systemMode: z.union([z.const('env'), z.const('off')]).default('env').volatile(),
     llmProxy: z.array(z.object({
         match: z.string(),
         proxy: z.string(),
-    })),
+    })).default([]).volatile(),
 });
 const CONFIG_KEYS = new Set(['enabled', 'systemMode', 'llmProxy']);
 /**
@@ -96,7 +104,7 @@ function validateProxyUrl(proxy, index) {
 }
 /**
  * Validate, default, and freeze the plugin configuration.
- * @param config - optional plugin configuration; omission selects defaults.
+ * @param config - optional plain configuration values; omission selects defaults.
  */
 export function resolveConfig(config) {
     if (config !== undefined) {
@@ -183,7 +191,7 @@ const SKILL_RESOURCE_BASE = {
 };
 const SKILL_INVOCATION = { modelInvocable: true, userInvocable: true };
 /** Routing description; must stay identical to the SKILL.md frontmatter (asserted in tests). */
-const SKILL_DESCRIPTION = 'dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使用指南。凡给 dsh 插件配置 HTTP 代理、LLM 出站分流，或排查代理网络问题时先读本指南：settings.yaml 顶层 `dsh-llm-proxy:` 段（enabled/systemMode/llmProxy）、llmProxy match 规则、代理 407、CONNECT 挂起、socks5 报错（SOCKS 不支持）、NODE_USE_ENV_PROXY 等价替代。触发词：dsh 代理、HTTP 代理、LLM 分流、llmProxy、llm-proxy、407、CONNECT 挂起、SOCKS、HTTPS_PROXY、NO_PROXY、出站代理、NODE_USE_ENV_PROXY。';
+const SKILL_DESCRIPTION = 'dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使用指南。凡给 dsh 插件配置 HTTP 代理、LLM 出站分流，或排查代理网络问题时先读本指南：`dsh-llm-proxy` 插件配置（enabled/systemMode/llmProxy，设置页可改、免重启热更；旧 settings.yaml `dsh-llm-proxy:` 段启动时自动导入）、llmProxy match 规则、代理 407、CONNECT 挂起、socks5 报错（SOCKS 不支持）、NODE_USE_ENV_PROXY 等价替代。触发词：dsh 代理、HTTP 代理、LLM 分流、llmProxy、llm-proxy、407、CONNECT 挂起、SOCKS、HTTPS_PROXY、NO_PROXY、出站代理、NODE_USE_ENV_PROXY。';
 const SKILL_CANDIDATE = {
     name: SKILL_PROVIDER_NAME,
     description: SKILL_DESCRIPTION,
@@ -237,23 +245,23 @@ export function stripFrontmatter(raw) {
     return raw;
 }
 /**
- * Install the global routing dispatcher, wire the `dsh-llm-proxy` settings
- * namespace, register the bundled skill provider, and register teardown.
+ * Install the global routing dispatcher, subscribe to this entry's settings
+ * updates, register the bundled skill provider, and register teardown.
  * @param ctx - plugin context owning the dispose effect.
- * @param config - composition entry config; the base layer under the
- *   settings.yaml `dsh-llm-proxy` section.
+ * @param config - live volatile references resolved from the entry config
+ *   through the static {@link Config} schema (the base layer under the
+ *   user's profile patch / imported settings section); omission selects the
+ *   schema defaults.
  * @param internals - injectable dispatcher factories for tests.
  */
-export function apply(ctx, config = {}, internals = {}) {
+export const apply = Object.assign(function apply(ctx, config = Config({}), internals = {}) {
     // `inject = ['skills']` guarantees the service exists on every real host;
     // register unconditionally so a missing service fails loud instead of
     // silently dropping the bundled skill.
     ctx.skills.registerProvider(() => skillProvider);
-    // Current authoritative config source: the entry until a settings scope
-    // layers the user's settings.yaml section on top (and back to the entry if
-    // the settings provider detaches). The seam hands over a thunk so every
-    // rejudge reads the live layered value instead of a stale snapshot.
-    let getSource = () => config;
+    // The volatile references above ARE the authoritative config source: the
+    // host swaps them in place on volatile-only settings edits, so every
+    // rejudge reads the current layered value directly through `.get()`.
     let active;
     let activePolicy;
     let effectRegistered = false;
@@ -289,7 +297,11 @@ export function apply(ctx, config = {}, internals = {}) {
     const rejudge = (failFast) => {
         let policy;
         try {
-            policy = resolveConfig(getSource());
+            policy = resolveConfig({
+                enabled: config.enabled.get(),
+                systemMode: config.systemMode.get(),
+                llmProxy: config.llmProxy.get(),
+            });
         }
         catch (error) {
             if (failFast)
@@ -297,10 +309,9 @@ export function apply(ctx, config = {}, internals = {}) {
             ctx.logger?.error('dsh-llm-proxy: ignoring invalid settings update, keeping current routing: %s', error instanceof Error ? error.message : String(error));
             return;
         }
-        // Attaching the settings scope fires onChange unconditionally, even when
-        // the layered section resolves to the same values as the entry base
-        // layer; rebuilding then would tear down and reinstall an identical
-        // router for nothing. Skip when no resolved value changed.
+        // Settings events can announce writes whose resolved policy is identical
+        // to the live one; rebuilding then would tear down and reinstall an
+        // identical router for nothing. Skip when no resolved value changed.
         if (activePolicy !== undefined && deepEqualJson(policy, activePolicy))
             return;
         if (!policy.enabled) {
@@ -328,24 +339,24 @@ export function apply(ctx, config = {}, internals = {}) {
         if (previous)
             teardownLayer(previous);
     };
-    // Start immediately with the entry config so the plugin works even on hosts
-    // that never mount a settings service; when the service appears, the
-    // layered section takes over and subsequent edits hot-publish here.
+    // Start immediately with the resolved entry config so the plugin works even
+    // on hosts that never mount a settings service; when the service is
+    // present, settings edits arrive as in-place reference swaps announced by
+    // the document-updated event, and subsequent edits hot-publish here.
     rejudge(true);
-    // Optional-settings consumer wiring. The rc.2 module-level
-    // installSettingsSection() helper was removed in dsh-settings
-    // 0.1.2-alpha.3; the attach / detach-fallback / watch body moved behind the
-    // provider as SettingsProvider.installSection (identical semantics — the
-    // entry config stays the fallback source when the provider detaches).
-    // ctx.inject keeps the whole wiring dormant on hosts that never mount a
-    // settings service.
+    // Optional-settings consumer wiring. dsh-settings 0.1.7 deleted
+    // SettingsProvider/installSection: the plugin's static Config schema
+    // (attached to this function below) is the declaration, volatile-only
+    // edits land in the references without a remount, and the settings service
+    // announces them per entry id. The ctx.inject keeps the listener dormant on
+    // hosts that never mount a settings service; mixed (volatile+ordinary)
+    // edits remount the plugin instead, rerunning apply() from the top.
     ctx.inject(['settings'], (sctx) => {
-        sctx.settings.installSection(ctx, SETTINGS_NAMESPACE, Config, config, {
-            setSource: (current) => {
-                getSource = current;
-            },
-            onChange: () => rejudge(false),
+        sctx.on('settings/document-updated', (ns) => {
+            if (ns !== ENTRY_ID)
+                return;
+            rejudge(false);
         });
     });
-}
+}, { Config });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AASxC,OAAO,EACL,kBAAkB,GAInB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAsB,MAAM,aAAa,CAAA;AAEtG,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAA0C,MAAM,aAAa,CAAA;AAE/G,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAA;AAEnC,sDAAsD;AACtD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAA;AAEhC;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,eAAe,CAAA;AAmChC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC/E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAA;AAEF,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAA;AAEvF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,OAAO,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAA;IAC3D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAA;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAA;IAC3D,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;AACzF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,KAAa;IACpD,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,gCAAgC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClH,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,uCAAuC;cAC5E,uCAAuC,MAAM,CAAC,QAAQ,6BAA6B,CACtF,CAAA;IACH,CAAC;AACH,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,GAAG,CAAC,CAAA;QAC3F,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,CAAA;IACvC,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,KAAK,CAAA;IAC9C,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAiB,EAAE;QAC3E,IAAI,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,oCAAoC,CAAC,CAAA;QAC9F,CAAC;QACD,IAAI,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,oCAAoC,CAAC,CAAA;QAC9F,CAAC;QACD,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACpC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAA;IACjE,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AACjF,CAAC;AAsBD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAE5D,SAAS,YAAY;IACnB,MAAM,IAAI,GAAG,UAAqC,CAAA;IAClD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK;QAC5B,kBAAkB,EAAE,SAAS;QAC7B,aAAa,EAAE,SAAS;QACxB,MAAM,EAAE,EAAE;KACX,CAAiB,CAAA;AACpB,CAAC;AAOD;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAAyB;IAChD,MAAM,KAAK,GAAG,YAAY,EAAE,CAAA;IAC5B,KAAK,CAAC,kBAAkB,KAAK,MAAM,CAAC,mBAAmB,EAAE,CAAA;IACzD,KAAK,CAAC,aAAa,KAAK,UAAU,CAAC,KAAK,CAAA;IAExC,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACnD,IAAI,KAA4C,CAAA;IAChD,IAAI,UAAU,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,OAAO,EAAE,EAAE,CAAA;QAClB,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC/B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAElC,OAAO;QACL,OAAO;YACL,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;YAC7C,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YAC/C,mEAAmE;YACnE,sEAAsE;YACtE,qEAAqE;YACrE,qDAAqD;YACrD,IAAI,MAAM,CAAC,mBAAmB,EAAE,KAAK,MAAM,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBACnD,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,CAAC,kBAAmB,CAAC,CAAA;YACxE,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBACtD,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;gBAC5F,UAAU,CAAC,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,aAAc,CAAA;YACzD,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAmBD,gFAAgF;AAEhF,mEAAmE;AACnE,MAAM,mBAAmB,GAAG,sBAAsB,CAAA;AAElD,8FAA8F;AAC9F,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,yCAAyC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE1F,yEAAyE;AACzE,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,iCAAiC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CACxE,CAAA;AAEV,MAAM,gBAAgB,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAW,CAAA;AAE/E,gGAAgG;AAChG,MAAM,iBAAiB,GAAG,uYAAuY,CAAA;AAEja,MAAM,eAAe,GAAmB;IACtC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,iBAAiB;IAC9B,UAAU,EAAE,gBAAgB;IAC5B,QAAQ,EAAE,mBAAmB;IAC7B,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,mBAAmB;IACjC,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,cAAc;CACxB,CAAA;AAED,MAAM,aAAa,GAAkB;IACnC,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC;IAC9C,KAAK,CAAC,GAAG,CAAC,UAAU;QAClB,OAAO;YACL,IAAI,EAAE,eAAe,CAAC,IAAI;YAC1B,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,UAAU,EAAE,eAAe,CAAC,UAAU;YACtC,QAAQ,EAAE,eAAe,CAAC,QAAQ;YAClC,MAAM,EAAE,eAAe,CAAC,MAAM;YAC9B,YAAY,EAAE,mBAAmB;YACjC,OAAO,EAAE,gBAAgB,CAAC,MAAM,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;SAClE,CAAA;IACH,CAAC;CACF,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,YAAY,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK;QAAE,OAAO,GAAG,CAAA;IAC3F,IAAI,SAAS,GAAG,YAAY,GAAG,CAAC,CAAA;IAChC,OAAO,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAChD,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAA;QAC1D,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/D,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACzE,CAAC;QACD,IAAI,WAAW,GAAG,CAAC;YAAE,OAAO,GAAG,CAAA;QAC/B,SAAS,GAAG,WAAW,GAAG,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAChC,SAAS,KAAK,CAAC,GAAY,EAAE,SAAiB,MAAM,CAAC,EAAE,CAAC,EAAE,YAA4B,EAAE;IACtF,0EAA0E;IAC1E,sEAAsE;IACtE,uCAAuC;IACvC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAA;IAChD,yEAAyE;IACzE,qEAAqE;IACrE,qEAAqE;IACrE,IAAI,MAA+B,CAAA;IACnC,IAAI,YAAwC,CAAA;IAC5C,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAE9B,SAAS,YAAY,CAAC,MAAsB;QAC1C,MAAM,gBAAgB,GACpB,SAAS,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;eAClD,uBAAuB,CACxB,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAClF,CAAA;QACH,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC1D,gBAAgB;YAChB,YAAY,EAAE,SAAS,CAAC,qBAAqB;mBACxC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC9E,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAA;IACrD,CAAC;IAED,SAAS,aAAa,CAAC,KAAkB;QACvC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QACvB,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,wEAAwE;QACxE,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,mBAAmB,GAAG,GAAS,EAAE;QACrC,IAAI,gBAAgB;YAAE,OAAM;QAC5B,gBAAgB,GAAG,IAAI,CAAA;QACvB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,OAAO,GAAG,MAAM,CAAA;YACtB,MAAM,GAAG,SAAS,CAAA;YAClB,IAAI,OAAO;gBAAE,aAAa,CAAC,OAAO,CAAC,CAAA;QACrC,CAAC,EAAE,kEAAkE,CAAC,CAAA;IACxE,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CAAC,QAAiB,EAAQ,EAAE;QAC1C,IAAI,MAAsB,CAAA;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,aAAa,CAAC;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;aAChC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ;gBAAE,MAAM,KAAK,CAAA;YACzB,GAAG,CAAC,MAAM,EAAE,KAAK,CACf,8EAA8E,EAC9E,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAA;YACD,OAAM;QACR,CAAC;QACD,yEAAyE;QACzE,oEAAoE;QACpE,qEAAqE;QACrE,IAAI,YAAY,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC;YAAE,OAAM;QAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,CAAA;YACtB,MAAM,GAAG,SAAS,CAAA;YAClB,YAAY,GAAG,MAAM,CAAA;YACrB,IAAI,OAAO;gBAAE,aAAa,CAAC,OAAO,CAAC,CAAA;YACnC,OAAM;QACR,CAAC;QACD,IAAI,IAAiB,CAAA;QACrB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ;gBAAE,MAAM,KAAK,CAAA;YACzB,GAAG,CAAC,MAAM,EAAE,KAAK,CACf,uEAAuE,EACvE,KAAK,CACN,CAAA;YACD,OAAM;QACR,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAA;QACvB,MAAM,GAAG,IAAI,CAAA;QACb,YAAY,GAAG,MAAM,CAAA;QACrB,mBAAmB,EAAE,CAAA;QACrB,IAAI,QAAQ;YAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC,CAAA;IAED,4EAA4E;IAC5E,oEAAoE;IACpE,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO,CAAC,IAAI,CAAC,CAAA;IACb,gEAAgE;IAChE,qEAAqE;IACrE,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,uEAAuE;IACvE,oEAAoE;IACpE,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,IAAI,CAAC,EAAE,CAAC,2BAA2B,EAAE,CAAC,EAAE,EAAE,EAAE;YAC1C,IAAI,EAAE,KAAK,QAAQ;gBAAE,OAAM;YAC3B,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA"}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-llm-proxy",
+    "description": "System proxy (env) plus LLM traffic-splitting proxy via a process-global undici routing dispatcher."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-llm-proxy",
+    "description": "系统代理（env）与基于进程级 undici 路由 dispatcher 的 LLM 流量分流代理。"
+  }
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@aiwayds/dsh-llm-proxy",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "dsh plugin: SYSTEM proxy (env) + LLM traffic-splitting proxy via a process-global undici routing dispatcher",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
+  "icon": "./icon.svg",
   "license": "MIT",
   "keywords": [
     "dsh",
@@ -27,7 +28,9 @@
     "lib",
     "cordis.patch.yml",
     "src",
-    "skills"
+    "skills",
+    "icon.svg",
+    "locale/*.json"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
@@ -35,16 +38,17 @@
     "pretest": "npm run build",
     "prepare": "npm run build",
     "test": "node --test test/match.test.mjs test/router.test.mjs test/config.test.mjs test/skill.test.mjs test/dispose.test.mjs test/e2e.test.mjs",
-    "smoke": "node scripts/smoke-boot.mjs"
+    "smoke": "node scripts/smoke-boot.mjs",
+    "postinstall": "node scripts/link-dsh-closure.mjs"
   },
   "dependencies": {
     "undici": "8.9.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/schemastery": "3.18.2",
-    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": ">=0.1.5-rc.2"
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.1.7-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -58,10 +62,10 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/schemastery": "3.18.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "0.1.5-rc.2",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": "0.1.7-rc.1",
     "@types/node": "^24.0.0",
     "typescript": "^5.9.0"
   },

package/skills/dsh-llm-proxy-config/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dsh-llm-proxy-config
-description: "dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使用指南。凡给 dsh 插件配置 HTTP 代理、LLM 出站分流，或排查代理网络问题时先读本指南：settings.yaml 顶层 `dsh-llm-proxy:` 段（enabled/systemMode/llmProxy）、llmProxy match 规则、代理 407、CONNECT 挂起、socks5 报错（SOCKS 不支持）、NODE_USE_ENV_PROXY 等价替代。触发词：dsh 代理、HTTP 代理、LLM 分流、llmProxy、llm-proxy、407、CONNECT 挂起、SOCKS、HTTPS_PROXY、NO_PROXY、出站代理、NODE_USE_ENV_PROXY。"
+description: "dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使用指南。凡给 dsh 插件配置 HTTP 代理、LLM 出站分流，或排查代理网络问题时先读本指南：`dsh-llm-proxy` 插件配置（enabled/systemMode/llmProxy，设置页可改、免重启热更；旧 settings.yaml `dsh-llm-proxy:` 段启动时自动导入）、llmProxy match 规则、代理 407、CONNECT 挂起、socks5 报错（SOCKS 不支持）、NODE_USE_ENV_PROXY 等价替代。触发词：dsh 代理、HTTP 代理、LLM 分流、llmProxy、llm-proxy、407、CONNECT 挂起、SOCKS、HTTPS_PROXY、NO_PROXY、出站代理、NODE_USE_ENV_PROXY。"
 ---
 
 # dsh-llm-proxy 使用指南（LLM 分流代理）
@@ -8,29 +8,33 @@ description: "dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使
 > dsh 插件：**SYSTEM proxy + LLM 分流代理**。进程级 undici 路由 Dispatcher 把 LLM 流量
 > 按配置列表分流到指定代理，其余流量走系统代理（启动环境变量），都没配则直连。
 
-## 配置入口（settings.yaml 顶层命名空间段）
+## 配置入口（entry config / 设置页）
 
-在 `~/.dsh/settings.yaml` 写**顶层 `dsh-llm-proxy:` 段**（与插件 id 一致，同 harness 内置
-插件 `llm-deepseek:` 段机制）：
+0.1.7 起配置=插件 entry `dsh-llm-proxy` 的 config（static Config schema 声明，三字段全部
+volatile）：设置页表单可改、免重启热生效；用户值落在 profile patch 里该 entry 的 `config:` 段：
 
 ```yaml
-dsh-llm-proxy:
-  enabled: true                    # 总开关，默认 true；false 时完全不动全局
-  systemMode: env                  # 'env'（默认，读环境变量）| 'off'（全部直连，仅 llmProxy 生效）
-  llmProxy:                        # 匹配列表，按顺序首条命中生效
-    - match: "api.deepseek.org"    # host 精确匹配（含任意端口）
-      proxy: "http://127.0.0.1:7890"
-    - match: "*.volces.com"        # 通配：volces.com 本身 + 任意子域
-      proxy: "http://127.0.0.1:7891"
-    - match: "https://api.openai.com"  # 完整 origin 精确匹配（大小写不敏感）
-      proxy: "http://127.0.0.1:7892"
+- id: dsh-llm-proxy
+  config:
+    enabled: true                    # 总开关，默认 true；false 时完全不动全局
+    systemMode: env                  # 'env'（默认，读环境变量）| 'off'（全部直连，仅 llmProxy 生效）
+    llmProxy:                        # 匹配列表，按顺序首条命中生效
+      - match: "api.deepseek.org"    # host 精确匹配（含任意端口）
+        proxy: "http://127.0.0.1:7890"
+      - match: "*.volces.com"        # 通配：volces.com 本身 + 任意子域
+        proxy: "http://127.0.0.1:7891"
+      - match: "https://api.openai.com"  # 完整 origin 精确匹配（大小写不敏感）
+        proxy: "http://127.0.0.1:7892"
 ```
 
 要点：
 
-- 编辑 **热生效**：无需重启，插件拆旧 router 按新配置重建。
-- bundle entry config（cordis.patch.yml 的 `config:`）是 base 层；settings.yaml 段覆盖其上
-  同名键。未挂载 settings 服务的宿主自动回退 entry config，插件照常工作。
+- **旧 `settings.yaml` 的 `dsh-llm-proxy:` 段自动迁移**：0.1.7 宿主启动时按
+  「段名 = entry id」一次性导入（段内三键均为 volatile，可干净导入），旧文件改名为
+  `settings.yaml.imported`。
+- 编辑 **热生效**：无需重启，插件拆旧 router 按新配置原地重建（volatile-only 不重挂插件）。
+- bundle entry config（cordis.patch.yml 的 `config:`）是 base 层；profile patch/设置页值
+  覆盖其上同名键。未挂载 settings 服务的宿主上 entry config 照常生效。
 
 ## 优先级语义
 
@@ -62,8 +66,8 @@ LLM 列表命中 > SYSTEM proxy（env 语义）> 直连
 
 ## 排障清单
 
-1. **完全不生效** → 先查顶层键名：必须是 `dsh-llm-proxy:`；写成 `llm-proxy:` 等其他键
-   不会被读到，**静默失效**。
+1. **完全不生效** → 先查 entry id/旧段名：必须是 `dsh-llm-proxy`；写成 `llm-proxy:` 等
+   其他键不会被读到，**静默失效**。
 2. **启动即报错** → proxy 用了 `socks5://` 等不支持的 schema；换 http(s) 代理。
 3. **走了代理但目标返回 407** → 代理自身认证问题，检查代理凭证；本插件日志/error
    message 中 proxy URL 的 userinfo 一律脱敏为 `***@host`。

package/src/index.ts

@@ -14,13 +14,16 @@
  * apply() also registers a bundled skill (skills/dsh-llm-proxy-config/SKILL.md) that
  * carries the plugin's configuration and troubleshooting guide.
  *
- * User configuration arrives exclusively through the `dsh-llm-proxy`
- * settings.yaml namespace (registered via the settings provider's
- * installSection, the same seam harness core plugins use); the bundle entry
- * config is the base layer.
- * Edits to the settings section hot-publish: the router is rebuilt in place,
- * unless the resolved values are unchanged, in which case the rebuild is
- * skipped (the settings attach itself fires one redundant onChange).
+ * User configuration is declared as the plugin's static Config schema
+ * (`apply.Config`, the dsh >= 0.1.7-rc.1 settings system): every field is
+ * `.volatile()`, so the settings page can edit all of them and volatile-only
+ * writes swap the live references in place without remounting the plugin. The
+ * host's `settings/document-updated` event for this entry triggers a rejudge
+ * that rebuilds the router in place — unless the resolved values are
+ * unchanged, in which case the rebuild is skipped. Legacy `settings.yaml`
+ * sections are imported once by the host at startup (the old namespace equals
+ * the bundle entry id `dsh-llm-proxy`, so existing user values carry over);
+ * the bundle entry config remains the base layer under profile patches.
  *
  * Environment variables are only read, never written: mutating
  * process.env.HTTP_PROXY in an already-started process has no effect on
@@ -31,14 +34,13 @@
 
 import { readFile } from 'node:fs/promises'
 import { fileURLToPath } from 'node:url'
-import type { Context } from '@deepseek-ai/cordis'
+import type { Context, Volatile } from '@deepseek-ai/cordis'
 // Type-only side-effect import: loads dsh-settings' `declare module
-// '@deepseek-ai/cordis'` augmentation, which is what puts `ctx.settings` on
-// the Context type. There is no runtime import — the host provides the
-// settings service; alpha.3 removed the module-level settingsNamespace(),
-// installSettingsSection(), and deepEqualJson() helpers this plugin used to
-// import (see SETTINGS_NAMESPACE below, the installSection call in apply(),
-// and ./deep-equal.ts for their replacements).
+// '@deepseek-ai/cordis'` augmentations, which put `ctx.settings` on the
+// Context type and type the `settings/document-updated` event. There is no
+// runtime import — the host provides the settings service; 0.1.7 replaced the
+// old SettingsProvider/installSection seam with the plugin's static Config
+// schema plus volatile fields (see apply.Config below).
 import type {} from '@deepseek-ai/dsh-settings'
 import {
   BUNDLED_SKILL_RANK,
@@ -60,20 +62,35 @@ export const name = 'dsh-llm-proxy'
 export const inject = ['skills']
 
 /**
- * The settings.yaml namespace this plugin owns. dsh feeds user configuration
- * to plugins only through registered settings namespaces; the document
- * section key that reaches this plugin is exactly this string.
- *
- * A plain literal is the supported spelling since dsh-settings
- * 0.1.2-alpha.3: `register`/`installSection` brand-check the namespace at the
- * type level (`SettingsNamespaceInput`) and validate the same pattern at
- * runtime (`parseSettingsNamespace`), replacing the removed
- * `settingsNamespace()` helper.
+ * The bundle entry id this plugin mounts under (the `cordis.patch.yml`
+ * insert). In the 0.1.7 settings system the entry id doubles as the settings
+ * document namespace: `settings/document-updated` events for this id concern
+ * this plugin's form. It equals the pre-0.1.7 settings.yaml namespace, so
+ * legacy user sections are imported by the host into this entry unchanged.
  */
-const SETTINGS_NAMESPACE = 'dsh-llm-proxy'
+const ENTRY_ID = 'dsh-llm-proxy'
 
-/** Plugin configuration. */
+/**
+ * Runtime plugin configuration as injected into {@link apply}: every field is
+ * a live volatile reference declared in the static {@link Config} schema. The
+ * host swaps the references in place on settings-page edits (no plugin
+ * remount); `.get()` returns a deep-frozen snapshot of the current values.
+ */
 export interface Config {
+  /** Master switch; `false` leaves globals untouched (default `true`). */
+  enabled: Volatile<boolean>
+  /**
+   * Fallback mode for requests no llmProxy entry matches (default `env`):
+   * `env` applies HTTPS_PROXY / HTTP_PROXY / ALL_PROXY / NO_PROXY from the
+   * startup environment; `off` connects directly.
+   */
+  systemMode: Volatile<'env' | 'off'>
+  /** Ordered LLM proxy list; the first entry whose match hits wins. */
+  llmProxy: Volatile<Array<{ match: string; proxy: string }>>
+}
+
+/** Plain (unwrapped) plugin configuration values, e.g. from an entry patch. */
+export interface ConfigInput {
   /** Master switch; `false` leaves globals untouched (default `true`). */
   enabled?: boolean
   /**
@@ -83,18 +100,27 @@ export interface Config {
    */
   systemMode?: 'env' | 'off'
   /** Ordered LLM proxy list; the first entry whose match hits wins. */
-  llmProxy?: Array<{ match: string; proxy: string }>
+  llmProxy?: ReadonlyArray<{ match: string; proxy: string }>
 }
 
-/** Runtime schema for {@link Config}. */
+/**
+ * Static config schema for the plugin: declaration is registration in the
+ * 0.1.7 settings system — the host projects this schema into the entry's
+ * settings form (keyed by the entry id {@link ENTRY_ID}) and resolves entry
+ * configs through it. All three fields are user-adjustable proxy policy and
+ * are marked `.volatile()` so the settings page offers them with hot reload:
+ * volatile-only edits never remount the plugin, and {@link apply} rebuilds
+ * the router in place when the values actually change. Every field carries a
+ * `.default()` so an unconfigured entry still resolves fully populated.
+ */
 export const Config = z.object({
-  enabled: z.boolean().default(true),
-  systemMode: z.union([z.const('env'), z.const('off')]).default('env'),
+  enabled: z.boolean().default(true).volatile(),
+  systemMode: z.union([z.const('env'), z.const('off')]).default('env').volatile(),
   llmProxy: z.array(z.object({
     match: z.string(),
     proxy: z.string(),
-  })),
-}) as unknown as z<Config>
+  })).default([]).volatile(),
+})
 
 const CONFIG_KEYS: ReadonlySet<string> = new Set(['enabled', 'systemMode', 'llmProxy'])
 
@@ -140,9 +166,9 @@ export interface ResolvedConfig {
 
 /**
  * Validate, default, and freeze the plugin configuration.
- * @param config - optional plugin configuration; omission selects defaults.
+ * @param config - optional plain configuration values; omission selects defaults.
  */
-export function resolveConfig(config: Config | undefined): ResolvedConfig {
+export function resolveConfig(config: ConfigInput | undefined): ResolvedConfig {
   if (config !== undefined) {
     for (const key of Object.keys(config)) {
       if (!CONFIG_KEYS.has(key)) throw new Error(`dsh-llm-proxy: config: unknown key "${key}"`)
@@ -279,7 +305,7 @@ const SKILL_RESOURCE_BASE = {
 const SKILL_INVOCATION = { modelInvocable: true, userInvocable: true } as const
 
 /** Routing description; must stay identical to the SKILL.md frontmatter (asserted in tests). */
-const SKILL_DESCRIPTION = 'dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使用指南。凡给 dsh 插件配置 HTTP 代理、LLM 出站分流，或排查代理网络问题时先读本指南：settings.yaml 顶层 `dsh-llm-proxy:` 段（enabled/systemMode/llmProxy）、llmProxy match 规则、代理 407、CONNECT 挂起、socks5 报错（SOCKS 不支持）、NODE_USE_ENV_PROXY 等价替代。触发词：dsh 代理、HTTP 代理、LLM 分流、llmProxy、llm-proxy、407、CONNECT 挂起、SOCKS、HTTPS_PROXY、NO_PROXY、出站代理、NODE_USE_ENV_PROXY。'
+const SKILL_DESCRIPTION = 'dsh 出站代理 / LLM 分流插件（@aiwayds/dsh-llm-proxy）使用指南。凡给 dsh 插件配置 HTTP 代理、LLM 出站分流，或排查代理网络问题时先读本指南：`dsh-llm-proxy` 插件配置（enabled/systemMode/llmProxy，设置页可改、免重启热更；旧 settings.yaml `dsh-llm-proxy:` 段启动时自动导入）、llmProxy match 规则、代理 407、CONNECT 挂起、socks5 报错（SOCKS 不支持）、NODE_USE_ENV_PROXY 等价替代。触发词：dsh 代理、HTTP 代理、LLM 分流、llmProxy、llm-proxy、407、CONNECT 挂起、SOCKS、HTTPS_PROXY、NO_PROXY、出站代理、NODE_USE_ENV_PROXY。'
 
 const SKILL_CANDIDATE: SkillCandidate = {
   name: SKILL_PROVIDER_NAME,
@@ -335,26 +361,27 @@ export function stripFrontmatter(raw: string): string {
 }
 
 /**
- * Install the global routing dispatcher, wire the `dsh-llm-proxy` settings
- * namespace, register the bundled skill provider, and register teardown.
+ * Install the global routing dispatcher, subscribe to this entry's settings
+ * updates, register the bundled skill provider, and register teardown.
  * @param ctx - plugin context owning the dispose effect.
- * @param config - composition entry config; the base layer under the
- *   settings.yaml `dsh-llm-proxy` section.
+ * @param config - live volatile references resolved from the entry config
+ *   through the static {@link Config} schema (the base layer under the
+ *   user's profile patch / imported settings section); omission selects the
+ *   schema defaults.
  * @param internals - injectable dispatcher factories for tests.
  */
-export function apply(ctx: Context, config: Config = {}, internals: ApplyInternals = {}): void {
-  // `inject = ['skills']` guarantees the service exists on every real host;
-  // register unconditionally so a missing service fails loud instead of
-  // silently dropping the bundled skill.
-  ctx.skills.registerProvider(() => skillProvider)
-  // Current authoritative config source: the entry until a settings scope
-  // layers the user's settings.yaml section on top (and back to the entry if
-  // the settings provider detaches). The seam hands over a thunk so every
-  // rejudge reads the live layered value instead of a stale snapshot.
-  let getSource: () => Config = () => config
-  let active: ActiveLayer | undefined
-  let activePolicy: ResolvedConfig | undefined
-  let effectRegistered = false
+export const apply = Object.assign(
+  function apply(ctx: Context, config: Config = Config({}), internals: ApplyInternals = {}): void {
+    // `inject = ['skills']` guarantees the service exists on every real host;
+    // register unconditionally so a missing service fails loud instead of
+    // silently dropping the bundled skill.
+    ctx.skills.registerProvider(() => skillProvider)
+    // The volatile references above ARE the authoritative config source: the
+    // host swaps them in place on volatile-only settings edits, so every
+    // rejudge reads the current layered value directly through `.get()`.
+    let active: ActiveLayer | undefined
+    let activePolicy: ResolvedConfig | undefined
+    let effectRegistered = false
 
   function installLayer(policy: ResolvedConfig): ActiveLayer {
     const systemDispatcher =
@@ -392,7 +419,11 @@ export function apply(ctx: Context, config: Config = {}, internals: ApplyInterna
   const rejudge = (failFast: boolean): void => {
     let policy: ResolvedConfig
     try {
-      policy = resolveConfig(getSource())
+      policy = resolveConfig({
+        enabled: config.enabled.get(),
+        systemMode: config.systemMode.get(),
+        llmProxy: config.llmProxy.get(),
+      })
     } catch (error) {
       if (failFast) throw error
       ctx.logger?.error(
@@ -401,10 +432,9 @@ export function apply(ctx: Context, config: Config = {}, internals: ApplyInterna
       )
       return
     }
-    // Attaching the settings scope fires onChange unconditionally, even when
-    // the layered section resolves to the same values as the entry base
-    // layer; rebuilding then would tear down and reinstall an identical
-    // router for nothing. Skip when no resolved value changed.
+    // Settings events can announce writes whose resolved policy is identical
+    // to the live one; rebuilding then would tear down and reinstall an
+    // identical router for nothing. Skip when no resolved value changed.
     if (activePolicy !== undefined && deepEqualJson(policy, activePolicy)) return
     if (!policy.enabled) {
       const current = active
@@ -431,23 +461,22 @@ export function apply(ctx: Context, config: Config = {}, internals: ApplyInterna
     if (previous) teardownLayer(previous)
   }
 
-  // Start immediately with the entry config so the plugin works even on hosts
-  // that never mount a settings service; when the service appears, the
-  // layered section takes over and subsequent edits hot-publish here.
+  // Start immediately with the resolved entry config so the plugin works even
+  // on hosts that never mount a settings service; when the service is
+  // present, settings edits arrive as in-place reference swaps announced by
+  // the document-updated event, and subsequent edits hot-publish here.
   rejudge(true)
-  // Optional-settings consumer wiring. The rc.2 module-level
-  // installSettingsSection() helper was removed in dsh-settings
-  // 0.1.2-alpha.3; the attach / detach-fallback / watch body moved behind the
-  // provider as SettingsProvider.installSection (identical semantics — the
-  // entry config stays the fallback source when the provider detaches).
-  // ctx.inject keeps the whole wiring dormant on hosts that never mount a
-  // settings service.
+  // Optional-settings consumer wiring. dsh-settings 0.1.7 deleted
+  // SettingsProvider/installSection: the plugin's static Config schema
+  // (attached to this function below) is the declaration, volatile-only
+  // edits land in the references without a remount, and the settings service
+  // announces them per entry id. The ctx.inject keeps the listener dormant on
+  // hosts that never mount a settings service; mixed (volatile+ordinary)
+  // edits remount the plugin instead, rerunning apply() from the top.
   ctx.inject(['settings'], (sctx) => {
-    sctx.settings.installSection(ctx, SETTINGS_NAMESPACE, Config, config, {
-      setSource: (current) => {
-        getSource = current
-      },
-      onChange: () => rejudge(false),
+    sctx.on('settings/document-updated', (ns) => {
+      if (ns !== ENTRY_ID) return
+      rejudge(false)
     })
   })
-}
+}, { Config })