dsh-messager 0.1.4

package/lib/config-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-shared.js","sourceRoot":"","sources":["../src/config-shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAA"}

package/lib/config.d.ts

@@ -0,0 +1,82 @@
+/**
+ * dsh-messager 配置模型。
+ *
+ * 本 schema 同时承担两个角色：
+ * - host 端的 Loader config（cordis.yml 中该插件行的 `config:`，成为 settings 命名空间的 base 层）；
+ * - `ctx.settings.register('messager', Config, { base })` 的命名空间 schema，
+ *   因此 Web 设置页会自动渲染配置表单，用户层可覆盖 base。
+ *
+ * 有效值优先级：schema 默认值 → base（cordis.yml）→ 用户层（设置页）。
+ */
+import Schema from '@deepseek-ai/schemastery';
+/** 通知内容繁复度。 */
+export type Verbosity = 'minimal' | 'normal' | 'detailed';
+/** 触发时机开关（需求 1：什么时候通知）。 */
+export interface TriggerConfig {
+    /** 会话需要交互（审批 / 提问 / 计划待审）时通知。 */
+    interaction: boolean;
+    /** 任务执行完毕时通知。 */
+    completed: boolean;
+    /** 任务出错时通知。 */
+    error: boolean;
+}
+/** 系统通知通道（OS 级 toast，host 端由 node-notifier 投递）。 */
+export interface SystemChannelConfig {
+    enabled: boolean;
+    /** 图标：绝对路径（或包内 assets/icon.png 的绝对路径）。 */
+    icon?: string;
+    verbosity: Verbosity;
+}
+/** 浏览器通知通道（Web Notification API，client 端投递）。 */
+export interface BrowserChannelConfig {
+    enabled: boolean;
+    /** 图标：URL 或 data URL。 */
+    icon?: string;
+    /** 仅当页面隐藏/未聚焦时才弹通知，避免看着界面还被打扰。 */
+    onlyWhenHidden: boolean;
+    verbosity: Verbosity;
+}
+/** 飞书机器人通道（webhook 版，即自定义机器人 webhook，host 端投递）。 */
+export interface FeishuChannelConfig {
+    enabled: boolean;
+    /** 飞书自定义机器人 webhook 地址。 */
+    webhookUrl?: string;
+    /** 签名密钥（飞书机器人 webhook“安全设置-签名校验”），配置后按 HMAC-SHA256 签名。 */
+    secret?: string;
+    /** 单次请求超时（ms）。 */
+    timeoutMs: number;
+    verbosity: Verbosity;
+}
+/** 去重 / 节流配置。 */
+export interface DedupConfig {
+    /** 同一会话同一类触发的冷却时间（ms）。 */
+    interactionCooldownMs: number;
+    /** 完成通知防抖窗口（ms）：等待 turn/end 事件以丰富内容并合并边界抖动。 */
+    completedDebounceMs: number;
+    /** 每通道每分钟通知上限（防止第三方通道限流/刷屏）。 */
+    perChannelPerMinute: number;
+}
+/** 消息内容配置。 */
+export interface MessageConfig {
+    /** 标题前缀，例如 "[DSH]"。 */
+    titlePrefix?: string;
+    /** 正文是否附带会话标题。 */
+    includeSessionTitle: boolean;
+    /** GUI 地址，用于通知中的“打开”链接/按钮。 */
+    guiUrl: string;
+}
+export interface Config {
+    triggers: TriggerConfig;
+    system: SystemChannelConfig;
+    browser: BrowserChannelConfig;
+    feishu: FeishuChannelConfig;
+    dedup: DedupConfig;
+    message: MessageConfig;
+}
+export declare const Config: Schema<Config>;
+/**
+ * 用 schema 默认值解析一份配置（输入可省略任意字段）。
+ * 与 cordis Loader 的校验同源，保证“默认值 → base → 用户层”的解析一致。
+ */
+export declare function resolveConfig(input?: Partial<Config>): Config;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C,eAAe;AACf,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEzD,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe;IACf,KAAK,EAAE,OAAO,CAAA;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB;IAClB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,MAAM,EAAE,mBAAmB,CAAA;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,aAAa,CAAA;CACvB;AAID,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAsChC,CAAA;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,OAAO,CAAC,MAAM,CAAM,GAAG,MAAM,CAEjE"}

package/lib/config.js

@@ -0,0 +1,59 @@
+/**
+ * dsh-messager 配置模型。
+ *
+ * 本 schema 同时承担两个角色：
+ * - host 端的 Loader config（cordis.yml 中该插件行的 `config:`，成为 settings 命名空间的 base 层）；
+ * - `ctx.settings.register('messager', Config, { base })` 的命名空间 schema，
+ *   因此 Web 设置页会自动渲染配置表单，用户层可覆盖 base。
+ *
+ * 有效值优先级：schema 默认值 → base（cordis.yml）→ 用户层（设置页）。
+ */
+import Schema from '@deepseek-ai/schemastery';
+const verbosity = Schema.union(['minimal', 'normal', 'detailed']);
+export const Config = Schema.object({
+    triggers: Schema.object({
+        interaction: Schema.boolean().default(true),
+        completed: Schema.boolean().default(true),
+        error: Schema.boolean().default(true),
+    }),
+    system: Schema.object({
+        enabled: Schema.boolean().default(true),
+        // 无 default 的字段即可选（undefined 允许）
+        // 注意：node-notifier 需要文件路径且该文件必须存在；Linux（notify-send）与
+        // macOS（terminal-notifier）对缺失路径可能直接失败而非像 Windows 那样降级，
+        // 通道层虽已做存在性校验，仍建议配置有效的绝对路径。
+        icon: Schema.string(),
+        verbosity: verbosity.default('normal'),
+    }),
+    browser: Schema.object({
+        enabled: Schema.boolean().default(true),
+        icon: Schema.string(),
+        onlyWhenHidden: Schema.boolean().default(true),
+        verbosity: verbosity.default('normal'),
+    }),
+    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'),
+    }),
+    dedup: Schema.object({
+        interactionCooldownMs: Schema.number().default(10000),
+        completedDebounceMs: Schema.number().default(1000),
+        perChannelPerMinute: Schema.number().default(20),
+    }),
+    message: Schema.object({
+        titlePrefix: Schema.string(),
+        includeSessionTitle: Schema.boolean().default(true),
+        guiUrl: Schema.string().default('http://127.0.0.1:3080'),
+    }),
+});
+/**
+ * 用 schema 默认值解析一份配置（输入可省略任意字段）。
+ * 与 cordis Loader 的校验同源，保证“默认值 → base → 用户层”的解析一致。
+ */
+export function resolveConfig(input = {}) {
+    return Config(input);
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AA0E7C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC,CAAA;AAE1E,MAAM,CAAC,MAAM,MAAM,GAAmB,MAAM,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3C,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACzC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACtC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,iCAAiC;QACjC,sDAAsD;QACtD,uDAAuD;QACvD,4BAA4B;QAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvC,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;QACrB,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9C,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvC,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACrD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAClD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACjD,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAC5B,mBAAmB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;KACzD,CAAC;CACH,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAyB,EAAE;IACvD,OAAO,MAAM,CAAC,KAAe,CAAC,CAAA;AAChC,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * dsh-messager —— DeepSeek Harness 通知插件（服务端 host 端）。
+ *
+ * 功能：会话需要交互（审批/提问/计划待审）、任务完成、任务出错时，
+ * 通过系统通知（node-notifier）、飞书机器人（webhook）推送提醒；
+ * 浏览器通知由浏览器 client 端（src/client/index.ts）投递。
+ *
+ * 配置：Loader config（cordis.yml）注册为 settings 命名空间 `messager`
+ * 的 base 层，设置页可覆盖；两者变更均热生效。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type Config } from './config.js';
+export declare const name = "dsh-messager";
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAQxD,eAAO,MAAM,IAAI,iBAAiB,CAAA;AAqDlC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAqFjD"}

package/lib/index.js

@@ -0,0 +1,152 @@
+/**
+ * dsh-messager —— DeepSeek Harness 通知插件（服务端 host 端）。
+ *
+ * 功能：会话需要交互（审批/提问/计划待审）、任务完成、任务出错时，
+ * 通过系统通知（node-notifier）、飞书机器人（webhook）推送提醒；
+ * 浏览器通知由浏览器 client 端（src/client/index.ts）投递。
+ *
+ * 配置：Loader config（cordis.yml）注册为 settings 命名空间 `messager`
+ * 的 base 层，设置页可覆盖；两者变更均热生效。
+ */
+import { resolveConfig } from './config.js';
+import { interactionSignalOf, errorMessageOf, turnEndReasonOf } from './signals.js';
+import { NotificationDispatcher } from './notify.js';
+import { createSystemChannel } from './channels/system.js';
+import { createFeishuChannel } from './channels/feishu.js';
+import { registerMessagerSettings } from './settings.js';
+import { mountConfigRoutes } from './config-route.js';
+export const name = 'dsh-messager';
+/** 按当前配置构建启用的通道。 */
+function buildChannels(config) {
+    const channels = [];
+    if (config.system.enabled) {
+        channels.push(createSystemChannel({
+            ...(config.system.icon === undefined ? {} : { icon: config.system.icon }),
+        }));
+    }
+    if (config.feishu.enabled && config.feishu.webhookUrl !== undefined) {
+        channels.push(createFeishuChannel({
+            webhookUrl: config.feishu.webhookUrl,
+            ...(config.feishu.secret === undefined ? {} : { secret: config.feishu.secret }),
+            timeoutMs: config.feishu.timeoutMs,
+        }));
+    }
+    return channels;
+}
+/**
+ * 从会话事件日志取最近的非空标题。会话日志包含持久化重放的历史事件
+ * （含 session/title），因此进程重启后恢复的会话也能取到标题 ——
+ * 实时 session/event 只在事件发生时投递一次，不会重放历史。
+ */
+function sessionTitleOf(session) {
+    const events = session.events;
+    for (let index = events.length - 1; index >= 0; index--) {
+        const event = events[index];
+        if (event === undefined)
+            continue;
+        if (event.type !== 'session/title')
+            continue;
+        if (event.data.title === '')
+            continue;
+        return event.data.title;
+    }
+    return undefined;
+}
+/** 已扫描过日志且确认无标题的会话（避免对无标题会话反复全量扫描大日志）。 */
+const noTitleSessions = new Set();
+/** 标题兜底：实时 map 缺失时从会话日志补取一次；新标题事件到达时解除负缓存。 */
+function ensureSessionTitle(dispatcher, session) {
+    const sessionId = session.id;
+    if (dispatcher.hasTitle(sessionId))
+        return;
+    if (noTitleSessions.has(sessionId))
+        return;
+    const title = sessionTitleOf(session);
+    if (title === undefined) {
+        noTitleSessions.add(sessionId);
+        return;
+    }
+    dispatcher.noteSessionTitle(sessionId, title);
+}
+export function apply(ctx, config) {
+    // 配置层：settings 服务可能晚于本插件挂载，必须用 ctx.inject 动态接入；
+    // 服务未就绪（如 headless profile）期间回退 Loader config 默认值。
+    const dispatcher = new NotificationDispatcher({
+        config: resolveConfig(config),
+        channels: buildChannels(resolveConfig(config)),
+        hooks: {
+            logWarn: (message) => ctx.logger.warn(`[dsh-messager] ${message}`),
+            logDebug: (message) => ctx.logger.debug(`[dsh-messager] ${message}`),
+        },
+    });
+    // 配置热更新：settings 就绪后注册命名空间（base = Loader config），
+    // 用户层/设置文档变更 → watch 重建通道；命名空间随注入 scope 自动卸载。
+    ctx.inject(['settings'], (settingsCtx) => {
+        const settings = registerMessagerSettings(settingsCtx, config);
+        const effective = settings.get();
+        dispatcher.reconfigure({ config: effective, channels: buildChannels(effective) });
+        settingsCtx.effect(() => settings.watch((next) => {
+            dispatcher.reconfigure({ config: next, channels: buildChannels(next) });
+        }), 'dsh-messager: settings watch');
+    });
+    // 配置读写路由（webServer 通道）：浏览器端经此读写 messager 命名空间，
+    // 不受 Web 设置白名单门控（dsh-market 同款「正门」）。仅 Web 环境挂载；
+    // headless profile 无 webServer 服务时本 inject 不执行，不影响通知功能。
+    ctx.inject(['webServer'], (webCtx) => {
+        webCtx.inject(['settings'], (fullCtx) => {
+            const settingsService = fullCtx.get('settings');
+            if (settingsService === undefined)
+                return;
+            const disposeRoutes = mountConfigRoutes(fullCtx.webServer, settingsService);
+            fullCtx.effect(() => disposeRoutes, 'dsh-messager: config routes');
+        });
+    });
+    // 会话事件：会话标题、交互信号（审批/提问）、turn/end 结束原因。
+    ctx.on('session/event', (session, event) => {
+        if (event.type === 'session/title') {
+            noTitleSessions.delete(session.id); // 新标题到达：解除无标题负缓存
+            dispatcher.noteSessionTitle(session.id, event.data.title);
+            return;
+        }
+        const interaction = interactionSignalOf(session.id, event);
+        if (interaction !== undefined) {
+            ensureSessionTitle(dispatcher, session);
+            dispatcher.onSignal(interaction);
+            return;
+        }
+        const turnEnd = turnEndReasonOf(event);
+        if (turnEnd !== undefined)
+            dispatcher.noteTurnEnd(session.id, turnEnd.reason);
+    });
+    // 运行状态：running → idle 边界触发“任务完成”；仅根会话（排除子代理噪音）。
+    // 注意：子代理判别必须用 origin === 'subagent'，不能用 parentSession ——
+    // 分叉会话（sessions.fork）的 header 也会携带 parentSession（指向源会话），
+    // 但 origin 为空，仍是顶层会话，任务完成后应正常通知。
+    const running = new Map();
+    ctx.on('agent/status', ({ agent, status }) => {
+        const isRunning = status === 'running';
+        const previous = running.get(agent.id);
+        running.set(agent.id, isRunning);
+        if (previous !== true || isRunning)
+            return;
+        if (agent.session.header.origin === 'subagent')
+            return;
+        ensureSessionTitle(dispatcher, agent.session);
+        dispatcher.onSignal({ kind: 'completed', sessionId: agent.id, seq: Date.now() });
+    });
+    // 错误：步骤/回合失败。
+    ctx.on('agent/error', ({ agent, turn, step, error }) => {
+        ensureSessionTitle(dispatcher, agent.session);
+        dispatcher.onSignal({
+            kind: 'error',
+            sessionId: agent.id,
+            message: errorMessageOf(error),
+            turn,
+            step,
+            seq: Date.now(),
+        });
+    });
+    ctx.effect(() => () => dispatcher.dispose(), 'dsh-messager: dispatcher timers');
+    ctx.logger.info('[dsh-messager] plugin loaded');
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/notify.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 规则/调度层：过滤（triggers）、冷却、完成防抖、通道限流，
+ * 并把 Signal 渲染后分发给启用的通道。通道失败只记日志，绝不抛出。
+ */
+import type { Config } from './config.ts';
+import { type NotificationPayload } from './templates.js';
+import type { Signal, TurnEndReason } from './signals.js';
+/** 通知载荷由模板层产出，通道层从此处取类型。 */
+export type { NotificationPayload } from './templates.js';
+/** 通知通道接口：系统（node-notifier）/ 飞书（webhook）/ 浏览器（client 端）皆实现此接口。 */
+export interface NotifyChannel {
+    readonly id: string;
+    send(payload: NotificationPayload): Promise<void>;
+}
+/** 调度器外部钩子（日志）。 */
+export interface DispatcherHooks {
+    logWarn(message: string): void;
+    logDebug?(message: string): void;
+}
+/** 通道配置更新（settings watch 回调时整体替换）。 */
+export interface DispatcherConfig {
+    config: Config;
+    channels: NotifyChannel[];
+}
+/**
+ * 通知调度器：
+ * - `onSignal`：interaction/error 即时投递；completed 进入防抖窗口
+ *   （等待 turn/end 合并结束原因，并折叠窗口内的重复边界）；
+ * - 冷却：同一会话同一触发在 `interactionCooldownMs` 内只投递一次；
+ * - 限流：每通道每分钟不超过 `perChannelPerMinute` 条。
+ */
+export declare class NotificationDispatcher {
+    private config;
+    private readonly channels;
+    private readonly hooks;
+    private readonly now;
+    /** sessionId → 会话标题（来自 session/title 事件）。 */
+    private readonly titles;
+    /** sessionId → 最近一次 turn/end 原因。 */
+    private readonly lastTurnEnd;
+    /** `${sessionId}:${kind}` → 上次投递时间戳。 */
+    private readonly cooldowns;
+    /** sessionId → 防抖中的完成信号与定时器。 */
+    private readonly pendingCompleted;
+    /** channelId → 最近一分钟内的投递时间戳。 */
+    private readonly channelWindows;
+    constructor(options: DispatcherConfig & {
+        hooks: DispatcherHooks;
+        now?: () => number;
+    });
+    /** 配置热更新（settings watch）：替换配置与通道，保留标题/冷却等状态。 */
+    reconfigure(next: DispatcherConfig): void;
+    /** 记录会话标题（session/title 事件）。 */
+    noteSessionTitle(sessionId: string, title: string): void;
+    /** 是否已记录该会话的标题（缺失时插件可从会话事件日志兜底补取）。 */
+    hasTitle(sessionId: string): boolean;
+    /** 记录 turn/end 结束原因，并合并到正在防抖的完成信号上。 */
+    noteTurnEnd(sessionId: string, reason: TurnEndReason): void;
+    /** 信号入口：interaction/error 立即处理；completed 进入防抖。 */
+    onSignal(signal: Signal): void;
+    private triggerEnabled;
+    /** 完成信号防抖：窗口内只保留最新信号，窗口结束才投递。 */
+    private debounceCompleted;
+    /** 防抖窗口结束：投递（若仍满足冷却）。 */
+    flushCompleted(sessionId: string): void;
+    /** 冷却检查 + 逐通道渲染 + 分发。 */
+    private dispatchIfAllowed;
+    /** 每通道每分钟限流。 */
+    private allowChannel;
+    /** 通道 verbosity：system/feishu 各自配置；未知通道取 normal。 */
+    private verbosityFor;
+    /** 清空防抖定时器（插件卸载时调用；订阅与通道本身由 effect 清理）。 */
+    dispose(): void;
+}
+//# sourceMappingURL=notify.d.ts.map

package/lib/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,aAAa,CAAA;AACpD,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAe,aAAa,EAAE,MAAM,cAAc,CAAA;AAEtE,4BAA4B;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED,mBAAmB;AACnB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAOD;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAElC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAC/D,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IACvE,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;gBAEjD,OAAO,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE;IAOtF,gDAAgD;IAChD,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAKzC,gCAAgC;IAChC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpC,uCAAuC;IACvC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAQ3D,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY9B,OAAO,CAAC,cAAc;IAMtB,iCAAiC;IACjC,OAAO,CAAC,iBAAiB;IAiBzB,yBAAyB;IACzB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOvC,yBAAyB;IACzB,OAAO,CAAC,iBAAiB;IA4BzB,gBAAgB;IAChB,OAAO,CAAC,YAAY;IAYpB,oDAAoD;IACpD,OAAO,CAAC,YAAY;IAQpB,2CAA2C;IAC3C,OAAO,IAAI,IAAI;CAIhB"}

package/lib/notify.js

@@ -0,0 +1,157 @@
+/**
+ * 规则/调度层：过滤（triggers）、冷却、完成防抖、通道限流，
+ * 并把 Signal 渲染后分发给启用的通道。通道失败只记日志，绝不抛出。
+ */
+import { renderPayload } from './templates.js';
+/**
+ * 通知调度器：
+ * - `onSignal`：interaction/error 即时投递；completed 进入防抖窗口
+ *   （等待 turn/end 合并结束原因，并折叠窗口内的重复边界）；
+ * - 冷却：同一会话同一触发在 `interactionCooldownMs` 内只投递一次；
+ * - 限流：每通道每分钟不超过 `perChannelPerMinute` 条。
+ */
+export class NotificationDispatcher {
+    config;
+    channels;
+    hooks;
+    now;
+    /** sessionId → 会话标题（来自 session/title 事件）。 */
+    titles = new Map();
+    /** sessionId → 最近一次 turn/end 原因。 */
+    lastTurnEnd = new Map();
+    /** `${sessionId}:${kind}` → 上次投递时间戳。 */
+    cooldowns = new Map();
+    /** sessionId → 防抖中的完成信号与定时器。 */
+    pendingCompleted = new Map();
+    /** channelId → 最近一分钟内的投递时间戳。 */
+    channelWindows = new Map();
+    constructor(options) {
+        this.config = options.config;
+        this.channels = options.channels;
+        this.hooks = options.hooks;
+        this.now = options.now ?? Date.now;
+    }
+    /** 配置热更新（settings watch）：替换配置与通道，保留标题/冷却等状态。 */
+    reconfigure(next) {
+        this.config = next.config;
+        this.channels.splice(0, this.channels.length, ...next.channels);
+    }
+    /** 记录会话标题（session/title 事件）。 */
+    noteSessionTitle(sessionId, title) {
+        if (title === '')
+            return;
+        this.titles.set(sessionId, title);
+    }
+    /** 是否已记录该会话的标题（缺失时插件可从会话事件日志兜底补取）。 */
+    hasTitle(sessionId) {
+        return this.titles.has(sessionId);
+    }
+    /** 记录 turn/end 结束原因，并合并到正在防抖的完成信号上。 */
+    noteTurnEnd(sessionId, reason) {
+        this.lastTurnEnd.set(sessionId, reason);
+        const pending = this.pendingCompleted.get(sessionId);
+        if (pending !== undefined && pending.signal.reason === undefined) {
+            pending.signal = { ...pending.signal, reason };
+        }
+    }
+    /** 信号入口：interaction/error 立即处理；completed 进入防抖。 */
+    onSignal(signal) {
+        if (!this.triggerEnabled(signal.kind)) {
+            this.hooks.logDebug?.(`[dispatcher] trigger disabled: ${signal.kind} ${signal.sessionId}`);
+            return;
+        }
+        if (signal.kind === 'completed') {
+            this.debounceCompleted(signal);
+            return;
+        }
+        this.dispatchIfAllowed(signal);
+    }
+    triggerEnabled(kind) {
+        if (kind === 'interaction')
+            return this.config.triggers.interaction;
+        if (kind === 'completed')
+            return this.config.triggers.completed;
+        return this.config.triggers.error;
+    }
+    /** 完成信号防抖：窗口内只保留最新信号，窗口结束才投递。 */
+    debounceCompleted(signal) {
+        const sessionId = signal.sessionId;
+        const merged = {
+            ...signal,
+            ...(this.lastTurnEnd.get(sessionId) === undefined ? {} : { reason: this.lastTurnEnd.get(sessionId) }),
+        };
+        const existing = this.pendingCompleted.get(sessionId);
+        if (existing !== undefined) {
+            existing.signal = merged;
+            clearTimeout(existing.timer);
+            existing.timer = setTimeout(() => this.flushCompleted(sessionId), this.config.dedup.completedDebounceMs);
+            return;
+        }
+        const timer = setTimeout(() => this.flushCompleted(sessionId), this.config.dedup.completedDebounceMs);
+        this.pendingCompleted.set(sessionId, { signal: merged, timer });
+    }
+    /** 防抖窗口结束：投递（若仍满足冷却）。 */
+    flushCompleted(sessionId) {
+        const pending = this.pendingCompleted.get(sessionId);
+        if (pending === undefined)
+            return;
+        this.pendingCompleted.delete(sessionId);
+        this.dispatchIfAllowed(pending.signal);
+    }
+    /** 冷却检查 + 逐通道渲染 + 分发。 */
+    dispatchIfAllowed(signal) {
+        const now = this.now();
+        const key = `${signal.sessionId}:${signal.kind}`;
+        const last = this.cooldowns.get(key);
+        if (last !== undefined && now - last < this.config.dedup.interactionCooldownMs) {
+            this.hooks.logDebug?.(`[dispatcher] cooldown: skip ${key}`);
+            return;
+        }
+        let dispatched = false;
+        for (const channel of this.channels) {
+            if (!this.allowChannel(channel.id, now)) {
+                this.hooks.logDebug?.(`[dispatcher] rate limited: ${channel.id}`);
+                continue;
+            }
+            dispatched = true;
+            const payload = renderPayload({
+                signal,
+                config: this.config,
+                sessionTitle: this.titles.get(signal.sessionId),
+                verbosity: this.verbosityFor(channel.id),
+            });
+            void channel.send(payload).catch((error) => {
+                this.hooks.logWarn(`channel "${channel.id}" failed: ${error instanceof Error ? error.message : String(error)}`);
+            });
+        }
+        if (dispatched)
+            this.cooldowns.set(key, now);
+    }
+    /** 每通道每分钟限流。 */
+    allowChannel(channelId, now) {
+        const windowStart = now - 60_000;
+        const window = (this.channelWindows.get(channelId) ?? []).filter(timestamp => timestamp >= windowStart);
+        if (window.length >= this.config.dedup.perChannelPerMinute) {
+            this.channelWindows.set(channelId, window);
+            return false;
+        }
+        window.push(now);
+        this.channelWindows.set(channelId, window);
+        return true;
+    }
+    /** 通道 verbosity：system/feishu 各自配置；未知通道取 normal。 */
+    verbosityFor(channelId) {
+        switch (channelId) {
+            case 'system': return this.config.system.verbosity;
+            case 'feishu': return this.config.feishu.verbosity;
+            default: return 'normal';
+        }
+    }
+    /** 清空防抖定时器（插件卸载时调用；订阅与通道本身由 effect 清理）。 */
+    dispose() {
+        for (const pending of this.pendingCompleted.values())
+            clearTimeout(pending.timer);
+        this.pendingCompleted.clear();
+    }
+}
+//# sourceMappingURL=notify.js.map

package/lib/notify.js.map

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

package/lib/settings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 配置层：把 Loader config（cordis.yml）注册为 settings 命名空间 `messager`
+ * 的 base 层，设置页可编辑用户层覆盖。
+ *
+ * 注意：settings 服务可能晚于本插件加载，必须在 `ctx.inject(['settings'], …)`
+ * 回调内调用本模块（见 src/index.ts），不能直接 `ctx.get('settings')`。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type Config as ConfigShape } from './config.js';
+export interface MessagerSettings {
+    /** 当前有效配置（默认值 → base → 用户层）。 */
+    get(): ConfigShape;
+    /** 监听配置变更（提交后按序调用，返回注销函数）。 */
+    watch(callback: (next: ConfigShape, prev: ConfigShape) => void): () => void;
+}
+/**
+ * 在 settings 服务就绪的上下文中注册命名空间。
+ * @param ctx - 已注入 settings 的上下文（inject 回调的 scope）。
+ * @param base - Loader config（cordis.yml 的 config 段）。
+ * @returns 设置句柄（注册本身是 effect，随注入 scope 卸载）。
+ */
+export declare function registerMessagerSettings(ctx: Context, base: ConfigShape): MessagerSettings;
+//# sourceMappingURL=settings.d.ts.map

package/lib/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAU,KAAK,MAAM,IAAI,WAAW,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,GAAG,IAAI,WAAW,CAAA;IAClB,8BAA8B;IAC9B,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,gBAAgB,CAM1F"}

package/lib/settings.js

@@ -0,0 +1,23 @@
+/**
+ * 配置层：把 Loader config（cordis.yml）注册为 settings 命名空间 `messager`
+ * 的 base 层，设置页可编辑用户层覆盖。
+ *
+ * 注意：settings 服务可能晚于本插件加载，必须在 `ctx.inject(['settings'], …)`
+ * 回调内调用本模块（见 src/index.ts），不能直接 `ctx.get('settings')`。
+ */
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+import { Config } from './config.js';
+/**
+ * 在 settings 服务就绪的上下文中注册命名空间。
+ * @param ctx - 已注入 settings 的上下文（inject 回调的 scope）。
+ * @param base - Loader config（cordis.yml 的 config 段）。
+ * @returns 设置句柄（注册本身是 effect，随注入 scope 卸载）。
+ */
+export function registerMessagerSettings(ctx, base) {
+    const scope = ctx.settings.register(settingsNamespace('messager'), Config, { base, applies: 'live' });
+    return {
+        get: () => scope.get(),
+        watch: (callback) => scope.watch(callback),
+    };
+}
+//# sourceMappingURL=settings.js.map

package/lib/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAShE;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY,EAAE,IAAiB;IACtE,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IACrG,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QACtB,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;KAC3C,CAAA;AACH,CAAC"}