dsh-messager 0.3.1 → 0.3.3

package/lib/config-route.d.ts

@@ -16,8 +16,15 @@ import type { IncomingMessage } from 'node:http';
 import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
 import type { SettingsPathOp } from '@deepseek-ai/dsh-settings';
 import type { ConfigView, ConfigWriteBody } from './config-shared.js';
-/** 命名空间（与 host 注册一致）。 */
-export declare const CONFIG_NAMESPACE: "messager";
+/**
+ * 命名空间（= 本插件在 profile 中的条目 id）。
+ *
+ * ⚠️ 0.1.7 起 settings 命名空间就是 profile 条目 id，**不是**固定字符串。
+ * 不同装载方式（bundle 的 cordis.patch.yml / dev 的 cordis.yml / marketplace）
+ * 可能给出不同的 id，因此默认值只作兜底，真实值由调用方经
+ * `resolveNamespace(ctx)` 反查后传入。
+ */
+export declare const CONFIG_NAMESPACE = "messager";
 export type { ConfigView, ConfigWriteBody } from './config-shared.js';
 /** 路由依赖的 settings 服务窄接口（便于测试替身）。 */
 export interface SettingsServiceLike {
@@ -38,7 +45,7 @@ export interface WebServerLike {
     register(route: WebRoute): () => void;
 }
 /** 把 settings 描述符映射为 client 视图；命名空间缺失 → unavailable。 */
-export declare function configViewOf(settings: SettingsServiceLike): ConfigView;
+export declare function configViewOf(settings: SettingsServiceLike, namespace?: string): ConfigView;
 /** 校验并规范化写请求体；非法 → undefined。 */
 export declare function parseConfigWriteBody(raw: unknown): ConfigWriteBody | undefined;
 /**
@@ -48,7 +55,10 @@ export declare function parseConfigWriteBody(raw: unknown): ConfigWriteBody | un
 export declare function sameOrigin(request: IncomingMessage, requireOrigin: boolean): boolean;
 /**
  * 挂载配置路由（webServer 服务可用时调用）。
+ * @param webServer - webServer 服务（窄接口）。
+ * @param settings - settings 服务（窄接口）。
+ * @param namespace - 本插件在 profile 中的条目 id（settings 命名空间）。
  * @returns 卸载函数。
  */
-export declare function mountConfigRoutes(webServer: WebServerLike, settings: SettingsServiceLike): () => void;
+export declare function mountConfigRoutes(webServer: WebServerLike, settings: SettingsServiceLike, namespace?: string): () => void;
 //# sourceMappingURL=config-route.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config-route.d.ts","sourceRoot":"","sources":["../src/config-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAErE,yBAAyB;AACzB,eAAO,MAAM,gBAAgB,EAAG,UAAmB,CAAA;AAEnD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAErE,oCAAoC;AACpC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC;QAC7D,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,OAAO,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,cAAc,EAAE,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7F;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAA;CACtC;AAID,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,UAAU,CActE;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAwB9E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAWpF;AAiED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAsBrG"}
+{"version":3,"file":"config-route.d.ts","sourceRoot":"","sources":["../src/config-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGrE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,aAAoB,CAAA;AAEjD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAErE,oCAAoC;AACpC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC;QAC7D,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,OAAO,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,cAAc,EAAE,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7F;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAA;CACtC;AAID,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,GAAE,MAAyB,GACnC,UAAU,CAcZ;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAwB9E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAWpF;AAkED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,GAAE,MAAyB,GACnC,MAAM,IAAI,CAsBZ"}

package/lib/config-route.js

@@ -12,12 +12,20 @@
  * 跨站 JS 无法读取；GET 只读无副作用。
  * 密钥：describe({ redactSecrets: true }) 自动脱敏，写入方向与设置页一致。
  */
-/** 命名空间（与 host 注册一致）。 */
-export const CONFIG_NAMESPACE = 'messager';
+import { FALLBACK_ENTRY_ID } from './settings.js';
+/**
+ * 命名空间（= 本插件在 profile 中的条目 id）。
+ *
+ * ⚠️ 0.1.7 起 settings 命名空间就是 profile 条目 id，**不是**固定字符串。
+ * 不同装载方式（bundle 的 cordis.patch.yml / dev 的 cordis.yml / marketplace）
+ * 可能给出不同的 id，因此默认值只作兜底，真实值由调用方经
+ * `resolveNamespace(ctx)` 反查后传入。
+ */
+export const CONFIG_NAMESPACE = FALLBACK_ENTRY_ID;
 // ---- 纯逻辑（可单测） ----
 /** 把 settings 描述符映射为 client 视图；命名空间缺失 → unavailable。 */
-export function configViewOf(settings) {
-    const descriptor = settings.describe({ redactSecrets: true }).find(candidate => candidate.ns === CONFIG_NAMESPACE);
+export function configViewOf(settings, namespace = CONFIG_NAMESPACE) {
+    const descriptor = settings.describe({ redactSecrets: true }).find(candidate => candidate.ns === namespace);
     if (descriptor === undefined) {
         return { status: 'unavailable', value: undefined, user: undefined, base: undefined, writable: settings.writable, mode: 'host' };
     }
@@ -106,10 +114,10 @@ function readBody(request, limit = 64 * 1024) {
         request.on('error', reject);
     });
 }
-function handleGet(settings, res) {
-    sendJson(res, 200, configViewOf(settings));
+function handleGet(settings, res, namespace) {
+    sendJson(res, 200, configViewOf(settings, namespace));
 }
-async function handlePost(settings, request, res) {
+async function handlePost(settings, request, res, namespace) {
     if (!sameOrigin(request, true)) {
         sendJson(res, 403, { ok: false, error: 'untrusted origin' });
         return;
@@ -128,7 +136,7 @@ async function handlePost(settings, request, res) {
         return;
     }
     try {
-        await settings.mutate(CONFIG_NAMESPACE, body.ops, body.expectedRevision);
+        await settings.mutate(namespace, body.ops, body.expectedRevision);
         sendJson(res, 200, { ok: true });
     }
     catch (error) {
@@ -140,20 +148,23 @@ async function handlePost(settings, request, res) {
 }
 /**
  * 挂载配置路由（webServer 服务可用时调用）。
+ * @param webServer - webServer 服务（窄接口）。
+ * @param settings - settings 服务（窄接口）。
+ * @param namespace - 本插件在 profile 中的条目 id（settings 命名空间）。
  * @returns 卸载函数。
  */
-export function mountConfigRoutes(webServer, settings) {
+export function mountConfigRoutes(webServer, settings, namespace = CONFIG_NAMESPACE) {
     const routes = [
         {
             kind: 'exact',
             path: '/dsh-messager/config',
             handler: (request, response) => {
                 if (request.method === 'GET') {
-                    handleGet(settings, response);
+                    handleGet(settings, response, namespace);
                     return;
                 }
                 if (request.method === 'POST') {
-                    return handlePost(settings, request, response);
+                    return handlePost(settings, request, response, namespace);
                 }
                 response.writeHead(405, { allow: 'GET, POST' });
                 response.end();

package/lib/config-route.js.map

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

package/lib/config.d.ts

@@ -1,14 +1,21 @@
 /**
  * dsh-messager 配置模型。
  *
- * 本 schema 同时承担两个角色：
- * - host 端的 Loader config（cordis.yml 中该插件行的 `config:`，成为 settings 命名空间的 base 层）；
- * - `ctx.settings.register('messager', Config, { base })` 的命名空间 schema，
- *   因此 Web 设置页会自动渲染配置表单，用户层可覆盖 base。
+ * DSH 0.1.7 起，本 schema 由 **Loader 自动接管**：插件模块导出的 `Config` 即
+ * settings 表单的 schema，命名空间 = profile 中该插件条目的 id（本仓库的
+ * `cordis.patch.yml` / `cordis.yml` 都声明为 `messager`）。
+ * 因此**不再有** `ctx.settings.register(...)` 这一步。
  *
- * 有效值优先级：schema 默认值 → base（cordis.yml）→ 用户层（设置页）。
+ * ⚠️ 所有可编辑字段必须标记 `.volatile()`：DSH 用 `isVolatilePath` 门控写入，
+ * 非 volatile 路径一律被 `settings.mutate` 拒绝（"Config field ... is not volatile"），
+ * 且没有任何 volatile 字段时整个命名空间会被 `volatileForm` 判为不可配置
+ * （"Plugin entry ... has no volatile fields"），设置页直接报废。
+ * 这是 0.1.7 的硬契约，不是可选项。
+ *
+ * 有效值优先级：schema 默认值 → base（Loader config）→ 用户层（设置页）。
  */
 import Schema from '@deepseek-ai/schemastery';
+import { type Volatile } from '@deepseek-ai/cosmokit';
 /** 通知内容繁复度。 */
 export type Verbosity = 'minimal' | 'normal' | 'detailed';
 /** 触发时机开关（需求 1：什么时候通知）。 */
@@ -119,10 +126,246 @@ export interface Config {
     dedup: DedupConfig;
     message: MessageConfig;
 }
-export declare const Config: Schema<Config>;
+export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
+    triggers: Schema<Schemastery.ObjectS<NoInfer<{
+        interaction: Schema<boolean, boolean, "volatile-defined">;
+        completed: Schema<boolean, boolean, "volatile-defined">;
+        error: Schema<boolean, boolean, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        interaction: Schema<boolean, boolean, "volatile-defined">;
+        completed: Schema<boolean, boolean, "volatile-defined">;
+        error: Schema<boolean, boolean, "volatile-defined">;
+    }>>, "plain">;
+    system: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    browser: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        onlyWhenHidden: Schema<boolean, boolean, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        onlyWhenHidden: Schema<boolean, boolean, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    feishu: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    wecom: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    discord: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    dingtalk: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    telegram: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        botToken: Schema<string, string, "volatile">;
+        chatId: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        botToken: Schema<string, string, "volatile">;
+        chatId: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    dedup: Schema<Schemastery.ObjectS<NoInfer<{
+        interactionCooldownMs: Schema<number, number, "volatile-defined">;
+        completedDebounceMs: Schema<number, number, "volatile-defined">;
+        perChannelPerMinute: Schema<number, number, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        interactionCooldownMs: Schema<number, number, "volatile-defined">;
+        completedDebounceMs: Schema<number, number, "volatile-defined">;
+        perChannelPerMinute: Schema<number, number, "volatile-defined">;
+    }>>, "plain">;
+    message: Schema<Schemastery.ObjectS<NoInfer<{
+        titlePrefix: Schema<string, string, "volatile">;
+        includeSessionTitle: Schema<boolean, boolean, "volatile-defined">;
+        guiUrl: Schema<string, string, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        titlePrefix: Schema<string, string, "volatile">;
+        includeSessionTitle: Schema<boolean, boolean, "volatile-defined">;
+        guiUrl: Schema<string, string, "volatile-defined">;
+    }>>, "plain">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    triggers: Schema<Schemastery.ObjectS<NoInfer<{
+        interaction: Schema<boolean, boolean, "volatile-defined">;
+        completed: Schema<boolean, boolean, "volatile-defined">;
+        error: Schema<boolean, boolean, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        interaction: Schema<boolean, boolean, "volatile-defined">;
+        completed: Schema<boolean, boolean, "volatile-defined">;
+        error: Schema<boolean, boolean, "volatile-defined">;
+    }>>, "plain">;
+    system: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    browser: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        onlyWhenHidden: Schema<boolean, boolean, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        icon: Schema<string, string, "volatile">;
+        onlyWhenHidden: Schema<boolean, boolean, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    feishu: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    wecom: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    discord: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    dingtalk: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        webhookUrl: Schema<string, string, "volatile">;
+        secret: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    telegram: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        botToken: Schema<string, string, "volatile">;
+        chatId: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "volatile-defined">;
+        botToken: Schema<string, string, "volatile">;
+        chatId: Schema<string, string, "volatile">;
+        timeoutMs: Schema<number, number, "volatile-defined">;
+        verbosity: Schema<"minimal" | "normal" | "detailed", "minimal" | "normal" | "detailed", "volatile-defined">;
+    }>>, "plain">;
+    dedup: Schema<Schemastery.ObjectS<NoInfer<{
+        interactionCooldownMs: Schema<number, number, "volatile-defined">;
+        completedDebounceMs: Schema<number, number, "volatile-defined">;
+        perChannelPerMinute: Schema<number, number, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        interactionCooldownMs: Schema<number, number, "volatile-defined">;
+        completedDebounceMs: Schema<number, number, "volatile-defined">;
+        perChannelPerMinute: Schema<number, number, "volatile-defined">;
+    }>>, "plain">;
+    message: Schema<Schemastery.ObjectS<NoInfer<{
+        titlePrefix: Schema<string, string, "volatile">;
+        includeSessionTitle: Schema<boolean, boolean, "volatile-defined">;
+        guiUrl: Schema<string, string, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        titlePrefix: Schema<string, string, "volatile">;
+        includeSessionTitle: Schema<boolean, boolean, "volatile-defined">;
+        guiUrl: Schema<string, string, "volatile-defined">;
+    }>>, "plain">;
+}>>, "plain">;
+/**
+ * 递归把纯值形态映射为 volatile 引用形态。
+ *
+ * `.volatile()` 只标在**叶子**上（分组对象本身不标），因此推导结果与
+ * schemastery 的实际输出一致：分组是普通对象，叶子是 `Volatile<T>` 引用。
+ * 这就是 Loader 传给 `apply(ctx, config)` 的运行时配置形态。
+ */
+export type VolatileShape<T> = {
+    [K in keyof T]: T[K] extends object ? VolatileShape<T[K]> : Volatile<T[K]>;
+};
+/** Loader 传入 `apply()` 的运行时配置（可编辑字段是 volatile 引用）。 */
+export type RuntimeConfig = VolatileShape<Config>;
 /**
  * 用 schema 默认值解析一份配置（输入可省略任意字段）。
- * 与 cordis Loader 的校验同源，保证“默认值 → base → 用户层”的解析一致。
+ *
+ * 输入既可以是纯值（Loader config / settings 视图），也可以是 Loader 传入的
+ * volatile 形态 —— 两者都先解包再校验，保证「默认值 → base → 用户层」解析一致。
  */
-export declare function resolveConfig(input?: Partial<Config>): Config;
+export declare function resolveConfig(input?: unknown): Config;
 //# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

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

package/lib/config.js

@@ -1,86 +1,117 @@
 /**
  * dsh-messager 配置模型。
  *
- * 本 schema 同时承担两个角色：
- * - host 端的 Loader config（cordis.yml 中该插件行的 `config:`，成为 settings 命名空间的 base 层）；
- * - `ctx.settings.register('messager', Config, { base })` 的命名空间 schema，
- *   因此 Web 设置页会自动渲染配置表单，用户层可覆盖 base。
+ * DSH 0.1.7 起，本 schema 由 **Loader 自动接管**：插件模块导出的 `Config` 即
+ * settings 表单的 schema，命名空间 = profile 中该插件条目的 id（本仓库的
+ * `cordis.patch.yml` / `cordis.yml` 都声明为 `messager`）。
+ * 因此**不再有** `ctx.settings.register(...)` 这一步。
  *
- * 有效值优先级：schema 默认值 → base（cordis.yml）→ 用户层（设置页）。
+ * ⚠️ 所有可编辑字段必须标记 `.volatile()`：DSH 用 `isVolatilePath` 门控写入，
+ * 非 volatile 路径一律被 `settings.mutate` 拒绝（"Config field ... is not volatile"），
+ * 且没有任何 volatile 字段时整个命名空间会被 `volatileForm` 判为不可配置
+ * （"Plugin entry ... has no volatile fields"），设置页直接报废。
+ * 这是 0.1.7 的硬契约，不是可选项。
+ *
+ * 有效值优先级：schema 默认值 → base（Loader config）→ 用户层（设置页）。
  */
 import Schema from '@deepseek-ai/schemastery';
+import { isVolatile } from '@deepseek-ai/cosmokit';
 const verbosity = Schema.union(['minimal', 'normal', 'detailed']);
+// 全部叶子字段 .volatile() —— 见文件头说明，0.1.7 用 volatile 门控设置页写入。
+//
+// 这里**不写** `: Schema<Config>` 标注（DSH 官方插件同样不标注）：`.volatile()`
+// 让 schema 的输出形态变成 `RuntimeConfig`，而 `Schema<T>` 的 `meta.default` 用的是
+// *输入*（纯值）形态，两种标注都对不上，交给 schemastery 推导即可。
 export const Config = Schema.object({
     triggers: Schema.object({
-        interaction: Schema.boolean().default(true),
-        completed: Schema.boolean().default(true),
-        error: Schema.boolean().default(true),
+        interaction: Schema.boolean().default(true).volatile(),
+        completed: Schema.boolean().default(true).volatile(),
+        error: Schema.boolean().default(true).volatile(),
     }),
     system: Schema.object({
-        enabled: Schema.boolean().default(true),
+        enabled: Schema.boolean().default(true).volatile(),
         // 无 default 的字段即可选（undefined 允许）
         // 注意：node-notifier 需要文件路径且该文件必须存在；Linux（notify-send）与
         // macOS（terminal-notifier）对缺失路径可能直接失败而非像 Windows 那样降级，
         // 通道层虽已做存在性校验，仍建议配置有效的绝对路径。
-        icon: Schema.string(),
-        verbosity: verbosity.default('normal'),
+        icon: Schema.string().volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     browser: Schema.object({
-        enabled: Schema.boolean().default(true),
-        icon: Schema.string(),
-        onlyWhenHidden: Schema.boolean().default(true),
-        verbosity: verbosity.default('normal'),
+        enabled: Schema.boolean().default(true).volatile(),
+        icon: Schema.string().volatile(),
+        onlyWhenHidden: Schema.boolean().default(true).volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     feishu: Schema.object({
-        enabled: Schema.boolean().default(false),
-        webhookUrl: Schema.string(),
-        secret: Schema.string().role('secret'),
-        timeoutMs: Schema.number().default(5000),
-        verbosity: verbosity.default('normal'),
+        enabled: Schema.boolean().default(false).volatile(),
+        webhookUrl: Schema.string().volatile(),
+        secret: Schema.string().role('secret').volatile(),
+        timeoutMs: Schema.number().default(5000).volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     wecom: Schema.object({
-        enabled: Schema.boolean().default(false),
-        webhookUrl: Schema.string(),
-        secret: Schema.string().role('secret'),
-        timeoutMs: Schema.number().default(5000),
-        verbosity: verbosity.default('normal'),
+        enabled: Schema.boolean().default(false).volatile(),
+        webhookUrl: Schema.string().volatile(),
+        secret: Schema.string().role('secret').volatile(),
+        timeoutMs: Schema.number().default(5000).volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     discord: Schema.object({
-        enabled: Schema.boolean().default(false),
-        webhookUrl: Schema.string(),
-        timeoutMs: Schema.number().default(5000),
-        verbosity: verbosity.default('normal'),
+        enabled: Schema.boolean().default(false).volatile(),
+        webhookUrl: Schema.string().volatile(),
+        timeoutMs: Schema.number().default(5000).volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     dingtalk: Schema.object({
-        enabled: Schema.boolean().default(false),
-        webhookUrl: Schema.string(),
-        secret: Schema.string().role('secret'),
-        timeoutMs: Schema.number().default(5000),
-        verbosity: verbosity.default('normal'),
+        enabled: Schema.boolean().default(false).volatile(),
+        webhookUrl: Schema.string().volatile(),
+        secret: Schema.string().role('secret').volatile(),
+        timeoutMs: Schema.number().default(5000).volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     telegram: Schema.object({
-        enabled: Schema.boolean().default(false),
-        botToken: Schema.string().role('secret'),
-        chatId: Schema.string(),
-        timeoutMs: Schema.number().default(5000),
-        verbosity: verbosity.default('normal'),
+        enabled: Schema.boolean().default(false).volatile(),
+        botToken: Schema.string().role('secret').volatile(),
+        chatId: Schema.string().volatile(),
+        timeoutMs: Schema.number().default(5000).volatile(),
+        verbosity: verbosity.default('normal').volatile(),
     }),
     dedup: Schema.object({
-        interactionCooldownMs: Schema.number().default(10000),
-        completedDebounceMs: Schema.number().default(1000),
-        perChannelPerMinute: Schema.number().default(20),
+        interactionCooldownMs: Schema.number().default(10000).volatile(),
+        completedDebounceMs: Schema.number().default(1000).volatile(),
+        perChannelPerMinute: Schema.number().default(20).volatile(),
     }),
     message: Schema.object({
-        titlePrefix: Schema.string(),
-        includeSessionTitle: Schema.boolean().default(true),
-        guiUrl: Schema.string().default('http://127.0.0.1:3080'),
+        titlePrefix: Schema.string().volatile(),
+        includeSessionTitle: Schema.boolean().default(true).volatile(),
+        guiUrl: Schema.string().default('http://127.0.0.1:3080').volatile(),
     }),
 });
+/**
+ * 递归解开 volatile 引用，得到纯值。
+ *
+ * volatile 引用在配置热更新时**原地变更**（这正是无需重挂载的原因），
+ * 所以引用本身要保留；本插件的内部逻辑（通道构建/调度/模板）只需要某一时刻的
+ * 纯值，因此在边界处统一取值。
+ */
+function unwrapVolatile(value) {
+    if (isVolatile(value))
+        return unwrapVolatile(value.get());
+    if (Array.isArray(value))
+        return value.map(unwrapVolatile);
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, unwrapVolatile(child)]));
+    }
+    return value;
+}
 /**
  * 用 schema 默认值解析一份配置（输入可省略任意字段）。
- * 与 cordis Loader 的校验同源，保证“默认值 → base → 用户层”的解析一致。
+ *
+ * 输入既可以是纯值（Loader config / settings 视图），也可以是 Loader 传入的
+ * volatile 形态 —— 两者都先解包再校验，保证「默认值 → base → 用户层」解析一致。
  */
 export function resolveConfig(input = {}) {
-    return Config(input);
+    return unwrapVolatile(Config(unwrapVolatile(input)));
 }
 //# sourceMappingURL=config.js.map