@wecom/wecom-openclaw-plugin 2026.3.31-beta.0 → 2026.4.1-beta.1

package/dist/src/version.js

@@ -1,24 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-/**
- * 从当前文件位置向上逐级查找 package.json
- * - ts 源码直接运行时（tsx/ts-node）：src/version.ts → 向上 1 级
- * - tsc 编译后运行时：dist/src/version.js → 向上 2 级
- */
-const findPackageJson = () => {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    while (true) {
-        const candidate = resolve(dir, "package.json");
-        if (existsSync(candidate))
-            return candidate;
-        const parent = dirname(dir);
-        if (parent === dir)
-            break; // 已到文件系统根目录
-        dir = parent;
-    }
-    throw new Error("找不到 package.json");
-};
-const pkg = JSON.parse(readFileSync(findPackageJson(), "utf-8"));
-/** 插件版本号，运行时从 package.json 读取 */
-export const PLUGIN_VERSION = pkg.version ?? "";

package/dist/src/webhook/command-auth.d.ts

@@ -1,47 +0,0 @@
-/**
- * 命令授权（Command Authorization）
- *
- * 从 lh 版 shared/command-auth.ts 迁移。
- * 适配新版 WeComConfig（dmPolicy / allowFrom 扁平化在顶层）。
- */
-import type { OpenClawConfig, PluginRuntime } from "openclaw/plugin-sdk";
-import type { WeComConfig } from "../utils.js";
-/** 命令授权结果 */
-export interface WecomCommandAuthResult {
-    /** 当前消息是否是需要鉴权的命令 */
-    shouldComputeAuth: boolean;
-    /** 账号配置的私信策略 */
-    dmPolicy: "pairing" | "allowlist" | "open" | "disabled";
-    /** 当前发送者是否在白名单中 */
-    senderAllowed: boolean;
-    /** 是否配置了授权器 */
-    authorizerConfigured: boolean;
-    /** 最终授权结果：true=放行，false=拒绝，undefined=不需要鉴权 */
-    commandAuthorized: boolean | undefined;
-    /** 生效的白名单列表 */
-    effectiveAllowFrom: string[];
-}
-/**
- * 解析命令授权状态
- *
- * 适配新版 WeComConfig 的扁平化字段：
- * - dmPolicy → accountConfig.dmPolicy
- * - allowFrom → accountConfig.allowFrom
- */
-export declare function resolveWecomCommandAuthorization(params: {
-    core: PluginRuntime;
-    cfg: OpenClawConfig;
-    accountConfig: WeComConfig;
-    rawBody: string;
-    senderUserId: string;
-}): Promise<WecomCommandAuthResult>;
-/**
- * 构建未授权命令的中文提示文案
- *
- * @param scope - "bot"（智能机器人）或 "agent"（自建应用）
- */
-export declare function buildWecomUnauthorizedCommandPrompt(params: {
-    senderUserId: string;
-    dmPolicy: "pairing" | "allowlist" | "open" | "disabled";
-    scope: "bot" | "agent";
-}): string;

package/dist/src/webhook/command-auth.js

@@ -1,96 +0,0 @@
-/**
- * 命令授权（Command Authorization）
- *
- * 从 lh 版 shared/command-auth.ts 迁移。
- * 适配新版 WeComConfig（dmPolicy / allowFrom 扁平化在顶层）。
- */
-// ============================================================================
-// 内部工具函数
-// ============================================================================
-/** 归一化白名单条目：去除空格、统一小写、去掉 wecom:/user:/userid: 前缀 */
-function normalizeWecomAllowFromEntry(raw) {
-    return raw
-        .trim()
-        .toLowerCase()
-        .replace(/^wecom:/, "")
-        .replace(/^user:/, "")
-        .replace(/^userid:/, "");
-}
-/** 判断发送者是否在白名单中 */
-function isWecomSenderAllowed(senderUserId, allowFrom) {
-    const list = allowFrom.map((entry) => normalizeWecomAllowFromEntry(entry)).filter(Boolean);
-    if (list.includes("*"))
-        return true;
-    const normalizedSender = normalizeWecomAllowFromEntry(senderUserId);
-    if (!normalizedSender)
-        return false;
-    return list.includes(normalizedSender);
-}
-/**
- * 解析命令授权状态
- *
- * 适配新版 WeComConfig 的扁平化字段：
- * - dmPolicy → accountConfig.dmPolicy
- * - allowFrom → accountConfig.allowFrom
- */
-export async function resolveWecomCommandAuthorization(params) {
-    const { core, cfg, accountConfig, rawBody, senderUserId } = params;
-    const dmPolicy = (accountConfig.dmPolicy ?? "pairing");
-    const configAllowFrom = (accountConfig.allowFrom ?? []).map((v) => String(v));
-    const shouldComputeAuth = core.channel.commands.shouldComputeCommandAuthorized(rawBody, cfg);
-    // WeCom channel 不支持 pairing CLI（"Channel wecom does not support pairing"），
-    // 因此 pairing 策略等同于 allowlist。
-    // Policy 语义：
-    // - open: 命令对所有人放行（除非更高层级的 access-groups 拒绝）
-    // - allowlist: 命令需要 allowFrom 白名单
-    // - pairing: 等同 allowlist（因 WeCom 不支持 pairing CLI）
-    const effectiveAllowFrom = dmPolicy === "open" ? ["*"] : configAllowFrom;
-    const senderAllowed = isWecomSenderAllowed(senderUserId, effectiveAllowFrom);
-    const allowAllConfigured = effectiveAllowFrom.some((entry) => normalizeWecomAllowFromEntry(entry) === "*");
-    const authorizerConfigured = allowAllConfigured || effectiveAllowFrom.length > 0;
-    const useAccessGroups = cfg.commands?.useAccessGroups !== false;
-    const commandAuthorized = shouldComputeAuth
-        ? core.channel.commands.resolveCommandAuthorizedFromAuthorizers({
-            useAccessGroups,
-            authorizers: [{ configured: authorizerConfigured, allowed: senderAllowed }],
-        })
-        : undefined;
-    return {
-        shouldComputeAuth,
-        dmPolicy,
-        senderAllowed,
-        authorizerConfigured,
-        commandAuthorized,
-        effectiveAllowFrom,
-    };
-}
-// ============================================================================
-// 未授权提示文案构建
-// ============================================================================
-/**
- * 构建未授权命令的中文提示文案
- *
- * @param scope - "bot"（智能机器人）或 "agent"（自建应用）
- */
-export function buildWecomUnauthorizedCommandPrompt(params) {
-    const user = params.senderUserId || "unknown";
-    const policy = params.dmPolicy;
-    const scopeLabel = params.scope === "bot" ? "Bot（智能机器人）" : "Agent（自建应用）";
-    const dmPrefix = params.scope === "bot" ? "channels.wecom.bot" : "channels.wecom.agent";
-    const allowCmd = (value) => `openclaw config set ${dmPrefix}.allowFrom '${value}'`;
-    const policyCmd = (value) => `openclaw config set ${dmPrefix}.dmPolicy "${value}"`;
-    if (policy === "disabled") {
-        return [
-            `无权限执行命令（${scopeLabel} 已禁用：dmPolicy=disabled）`,
-            `触发者：${user}`,
-            `管理员：${policyCmd("open")}（全放开）或 ${policyCmd("allowlist")}（白名单）`,
-        ].join("\n");
-    }
-    return [
-        `无权限执行命令（入口：${scopeLabel}，userid：${user}）`,
-        `管理员全放开：${policyCmd("open")}`,
-        `管理员放行该用户：${policyCmd("allowlist")}`,
-        `然后设置白名单：${allowCmd(JSON.stringify([user]))}`,
-        `如果仍被拦截：检查 commands.useAccessGroups/访问组`,
-    ].join("\n");
-}

package/dist/src/webhook/gateway.d.ts

@@ -1,36 +0,0 @@
-/**
- * Webhook Gateway 生命周期管理
- *
- * 从 @mocrane/wecom gateway-monitor.ts 部分迁移（仅 Webhook 部分）。
- * 负责：初始化状态、注册 Target、启停管理。
- *
- * 关键设计：
- * - MonitorState 是全局单例（monitorState），所有账号共享同一个 StreamStore 和 ActiveReplyStore
- * - Target 注册/注销不影响 monitorState 生命周期，只控制 pruneTimer 的启停
- * - 每个账号注册多条路径（兼容历史路径 + 推荐路径 + 多账号路径）
- * - 按 accountId 管理各自的 unregister，stop 时只注销该账号的 Target
- */
-import type { WebhookGatewayContext } from "./types.js";
-import { WebhookMonitorState } from "./state.js";
-/**
- * 获取当前的 MonitorState 实例（全局单例）
- *
- * 供 monitor.ts 等内部模块调用以访问 StreamStore 和 ActiveReplyStore。
- */
-export declare function getMonitorState(): WebhookMonitorState;
-/**
- * 启动 Webhook Gateway
- *
- * 1. 验证 Webhook 配置
- * 2. 确保 pruneTimer 启动
- * 3. 设置 FlushHandler（仅首次）
- * 4. 解析并注册多条 Webhook 路径
- */
-export declare function startWebhookGateway(ctx: WebhookGatewayContext): void;
-/**
- * 停止 Webhook Gateway
- *
- * 1. 注销该账号的 Target（不影响其他账号）
- * 2. 如果没有任何活跃 Target，停止清理定时器
- */
-export declare function stopWebhookGateway(ctx: WebhookGatewayContext): void;

package/dist/src/webhook/gateway.js

@@ -1,227 +0,0 @@
-/**
- * Webhook Gateway 生命周期管理
- *
- * 从 @mocrane/wecom gateway-monitor.ts 部分迁移（仅 Webhook 部分）。
- * 负责：初始化状态、注册 Target、启停管理。
- *
- * 关键设计：
- * - MonitorState 是全局单例（monitorState），所有账号共享同一个 StreamStore 和 ActiveReplyStore
- * - Target 注册/注销不影响 monitorState 生命周期，只控制 pruneTimer 的启停
- * - 每个账号注册多条路径（兼容历史路径 + 推荐路径 + 多账号路径）
- * - 按 accountId 管理各自的 unregister，stop 时只注销该账号的 Target
- */
-import { PRUNE_INTERVAL_MS, WEBHOOK_PATHS } from "./types.js";
-import { monitorState } from "./state.js";
-import { registerWecomWebhookTarget, hasActiveTargets } from "./target.js";
-import { startAgentForStream } from "./monitor.js";
-import { hasMultiAccounts } from "../accounts.js";
-import { getWeComRuntime } from "../runtime.js";
-// ============================================================================
-// 全局状态
-// ============================================================================
-/** 按 accountId 管理各账号的 Target 注销函数 */
-const accountUnregisters = new Map();
-/** FlushHandler 是否已设置（只需设置一次，因为 monitorState 是单例） */
-let flushHandlerInstalled = false;
-// ============================================================================
-// 路径解析
-// ============================================================================
-/**
- * 去除重复路径
- */
-function uniquePaths(paths) {
-    return Array.from(new Set(paths.map((p) => p.trim()).filter(Boolean)));
-}
-/**
- * 解析 Bot Target 注册路径
- *
- * 多账号场景（matrixMode）下：注册带 accountId 后缀的路径 + 兼容老路径
- * 单账号场景下：只注册基础路径
- *
- * 参考 lh 版 resolveBotRegistrationPaths
- */
-function resolveBotRegistrationPaths(params) {
-    if (params.matrixMode) {
-        return uniquePaths([
-            `${WEBHOOK_PATHS.BOT_PLUGIN}/${params.accountId}`,
-            `${WEBHOOK_PATHS.BOT_ALT}/${params.accountId}`,
-            // 兼容老路径：不带 accountId 后缀，签名验证会自动匹配到正确账号
-            WEBHOOK_PATHS.BOT_PLUGIN,
-            WEBHOOK_PATHS.BOT,
-            WEBHOOK_PATHS.BOT_ALT,
-        ]);
-    }
-    return uniquePaths([WEBHOOK_PATHS.BOT_PLUGIN, WEBHOOK_PATHS.BOT, WEBHOOK_PATHS.BOT_ALT]);
-}
-// ============================================================================
-// 公共 API
-// ============================================================================
-/**
- * 获取当前的 MonitorState 实例（全局单例）
- *
- * 供 monitor.ts 等内部模块调用以访问 StreamStore 和 ActiveReplyStore。
- */
-export function getMonitorState() {
-    return monitorState;
-}
-/**
- * 启动 Webhook Gateway
- *
- * 1. 验证 Webhook 配置
- * 2. 确保 pruneTimer 启动
- * 3. 设置 FlushHandler（仅首次）
- * 4. 解析并注册多条 Webhook 路径
- */
-export function startWebhookGateway(ctx) {
-    const { account, config, runtime } = ctx;
-    const log = ctx.log ?? {
-        info: (msg) => runtime.log(msg),
-        error: (msg) => runtime.error(msg),
-    };
-    // 1. 验证必要配置（receiveId 非必填，可为空）
-    if (!account.token || !account.encodingAESKey) {
-        const missing = [];
-        if (!account.token)
-            missing.push("token");
-        if (!account.encodingAESKey)
-            missing.push("encodingAESKey");
-        const errorMsg = `[webhook] Webhook 配置不完整，缺少: ${missing.join(", ")}`;
-        log.error(errorMsg);
-        ctx.setStatus?.({
-            accountId: ctx.accountId,
-            running: false,
-            configured: false,
-            lastError: errorMsg,
-        });
-        return;
-    }
-    log.info(`[webhook] 启动 Webhook Gateway (accountId=${ctx.accountId})`);
-    // 2. 确保 pruneTimer 启动（幂等：如果已在运行，不会重复启动）
-    monitorState.startPruning(PRUNE_INTERVAL_MS);
-    // 3. 设置 FlushHandler（仅首次，因为 monitorState 是全局单例）
-    if (!flushHandlerInstalled) {
-        monitorState.streamStore.setFlushHandler((pending) => void flushPending(pending));
-        flushHandlerInstalled = true;
-    }
-    // 4. 构造 Target 上下文
-    const runtimeEnv = {
-        log: (msg) => runtime.log(msg),
-        error: (msg) => runtime.error(msg),
-    };
-    // 判断是否为多账号模式
-    const matrixMode = hasMultiAccounts(ctx.config);
-    const target = {
-        account,
-        config,
-        runtime: runtimeEnv,
-        core: (ctx.channelRuntime ?? runtime), // PluginRuntime 实例
-        path: `${WEBHOOK_PATHS.BOT_PLUGIN}/${ctx.accountId}`, // 主路径（用于日志和状态显示）
-        statusSink: ctx.setStatus
-            ? (patch) => ctx.setStatus?.({ accountId: ctx.accountId, ...patch })
-            : undefined,
-    };
-    // 5. 解析注册路径
-    const paths = resolveBotRegistrationPaths({
-        accountId: ctx.accountId,
-        matrixMode,
-    });
-    // 6. 注册 Target（返回注销函数）
-    // 如果该账号之前已注册（例如 reload），先注销
-    const existingUnregister = accountUnregisters.get(ctx.accountId);
-    if (existingUnregister) {
-        existingUnregister();
-    }
-    const unregister = registerWecomWebhookTarget(target, paths);
-    accountUnregisters.set(ctx.accountId, unregister);
-    log.info(`[webhook] Webhook Target 已注册 (accountId=${ctx.accountId}, paths=[${paths.join(", ")}])`);
-    // 7. 更新状态
-    ctx.setStatus?.({
-        accountId: ctx.accountId,
-        running: true,
-        configured: true,
-        webhookPath: paths[0],
-        lastStartAt: Date.now(),
-    });
-}
-/**
- * 停止 Webhook Gateway
- *
- * 1. 注销该账号的 Target（不影响其他账号）
- * 2. 如果没有任何活跃 Target，停止清理定时器
- */
-export function stopWebhookGateway(ctx) {
-    const log = ctx.log ?? {
-        info: (msg) => ctx.runtime.log(msg),
-        error: (msg) => ctx.runtime.error(msg),
-    };
-    log.info(`[webhook] 停止 Webhook Gateway (accountId=${ctx.accountId})`);
-    // 1. 注销该账号的 Target
-    const unregister = accountUnregisters.get(ctx.accountId);
-    if (unregister) {
-        unregister();
-        accountUnregisters.delete(ctx.accountId);
-    }
-    // 2. 如果没有任何活跃 Target，停止 pruneTimer
-    if (!hasActiveTargets()) {
-        monitorState.stopPruning();
-    }
-    // 3. 更新状态
-    ctx.setStatus?.({
-        accountId: ctx.accountId,
-        running: false,
-        lastStopAt: Date.now(),
-    });
-}
-// ============================================================================
-// flushPending 中间层（对齐原版 monitor.ts:1151-1192）
-// ============================================================================
-/**
- * **flushPending (刷新待处理消息 / 核心 Agent 触发点)**
- *
- * 当防抖计时器结束时被调用。
- * 核心逻辑：
- * 1. 聚合所有 pending 的消息内容（用于上下文）。
- * 2. 获取 PluginRuntime。
- * 3. 标记 Stream 为 Started。
- * 4. 调用 `startAgentForStream` 启动 Agent 流程。
- * 5. 处理异常并更新 Stream 状态为 Error。
- */
-async function flushPending(pending) {
-    const { streamId, target, msg, contents, msgids, conversationKey, batchKey } = pending;
-    const { streamStore } = monitorState;
-    // Merge all message contents (each is already formatted by buildInboundBody)
-    const mergedContents = contents.filter(c => c.trim()).join("\n").trim();
-    let core = null;
-    try {
-        core = getWeComRuntime();
-    }
-    catch (err) {
-        target.runtime.log?.(`[webhook] flush pending: runtime not ready: ${String(err)}`);
-        streamStore.markFinished(streamId);
-        target.runtime.log?.(`[webhook] queue: runtime not ready，结束批次并推进 streamId=${streamId}`);
-        streamStore.onStreamFinished(streamId);
-        return;
-    }
-    if (core) {
-        streamStore.markStarted(streamId);
-        const enrichedTarget = { ...target, core };
-        target.runtime.log?.(`[webhook] flush pending: start batch streamId=${streamId} batchKey=${batchKey} conversationKey=${conversationKey} mergedCount=${contents.length}`);
-        // Pass the first msg (with its media structure), and mergedContents for multi-message context
-        startAgentForStream({
-            target: enrichedTarget,
-            accountId: target.account.accountId,
-            msg,
-            streamId,
-            mergedContents: contents.length > 1 ? mergedContents : undefined,
-            mergedMsgids: msgids.length > 1 ? msgids : undefined,
-        }).catch((err) => {
-            streamStore.updateStream(streamId, (state) => {
-                state.error = err instanceof Error ? err.message : String(err);
-                state.content = state.content || `Error: ${state.error}`;
-                state.finished = true;
-            });
-            target.runtime.error?.(`[webhook] Agent 处理失败 (streamId=${streamId}): ${String(err)}`);
-            streamStore.onStreamFinished(streamId);
-        });
-    }
-}

package/dist/src/webhook/handler.d.ts

@@ -1,18 +0,0 @@
-/**
- * Webhook HTTP 请求处理
- *
- * 从 @mocrane/wecom monitor.ts handleWecomWebhookRequest 部分迁移 + 重构。
- * 负责：
- * 1. GET/POST 请求分流
- * 2. 签名验证（调用 crypto 模块）
- * 3. 消息解密
- * 4. 按消息类型分发到 monitor 层
- */
-import type { IncomingMessage, ServerResponse } from "node:http";
-/**
- * Webhook HTTP 请求总入口
- *
- * 处理企微 Bot Webhook 的 GET（URL 验证）和 POST（消息回调）请求。
- * 返回 true 表示已处理，false 表示不匹配（交给其他 handler）。
- */
-export declare function handleWecomWebhookRequest(req: IncomingMessage, res: ServerResponse): Promise<boolean>;