@wecom/wecom-openclaw-plugin 2026.3.30 → 2026.3.31-beta.1

package/dist/src/types/account.d.ts

@@ -0,0 +1,29 @@
+/**
+ * WeCom 账号类型定义
+ */
+import type { WecomAgentConfig, WecomNetworkConfig } from "./config.js";
+/**
+ * 解析后的 Agent 账号
+ */
+export type ResolvedAgentAccount = {
+    /** 账号 ID */
+    accountId: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 是否配置完整 */
+    configured: boolean;
+    /** 企业 ID */
+    corpId: string;
+    /** 应用 Secret */
+    corpSecret: string;
+    /** 应用 ID (数字，可选) */
+    agentId?: number;
+    /** 回调 Token */
+    token: string;
+    /** 回调加密密钥 */
+    encodingAESKey: string;
+    /** 原始配置 */
+    config: WecomAgentConfig;
+    /** 网络配置（来自 channels.wecom.network） */
+    network?: WecomNetworkConfig;
+};

package/dist/src/types/account.js

@@ -0,0 +1,4 @@
+/**
+ * WeCom 账号类型定义
+ */
+export {};

package/dist/src/types/config.d.ts

@@ -0,0 +1,100 @@
+/**
+ * WeCom 子模块配置类型定义
+ *
+ * 注意：顶层配置类型 WeComConfig 定义在 src/utils.ts 中，以平铺结构为准。
+ * 本文件仅定义 Agent/Bot/DM/Network/Media 等子模块的配置类型。
+ */
+/** 媒体处理配置 */
+export type WecomMediaConfig = {
+    tempDir?: string;
+    retentionHours?: number;
+    cleanupOnStart?: boolean;
+    maxBytes?: number;
+};
+/** 网络配置 */
+export type WecomNetworkConfig = {
+    timeoutMs?: number;
+    retries?: number;
+    retryDelayMs?: number;
+    /**
+     * 出口代理（用于企业可信 IP 固定出口场景）。
+     * 示例: "http://proxy.company.local:3128"
+     */
+    egressProxyUrl?: string;
+};
+/**
+ * Bot 模式配置 (智能体)
+ * 用于接收 JSON 格式回调 + 流式回复
+ */
+export type WecomBotConfig = {
+    /** 智能机器人 ID（用于 Matrix 模式二次身份确认，webhook 模式） */
+    aibotid?: string;
+    /** 回调 Token (企微后台生成，webhook 模式必填) */
+    token?: string;
+    /** 回调加密密钥 (企微后台生成，webhook 模式必填) */
+    encodingAESKey?: string;
+    /**
+     * BotId 列表（可选，用于审计与告警）。
+     * - 回调路由优先由 URL + 签名决定；botIds 不参与强制拦截。
+     * - 当解密后的 aibotid 不在 botIds 中时，仅记录告警日志。
+     */
+    botIds?: string[];
+    /** 接收者 ID (可选，用于解密校验) */
+    receiveId?: string;
+    /** 流式消息占位符 */
+    streamPlaceholderContent?: string;
+    /** 欢迎语 */
+    welcomeText?: string;
+    /** DM 策略: 'open' 允许所有人, 'pairing' 需要配对, 'allowlist' 仅允许列表, 'disabled' 禁用 */
+    dmPolicy?: 'open' | 'pairing' | 'allowlist' | 'disabled';
+    /** 允许的用户列表，为空表示允许所有人 */
+    allowFrom?: Array<string | number>;
+    /** 连接模式：webhook（默认）或 websocket */
+    connectionMode?: 'webhook' | 'websocket';
+    /** 机器人 BotID（websocket 模式必填，企微后台获取） */
+    botId?: string;
+    /** 机器人 Secret（websocket 模式必填，企微后台获取） */
+    secret?: string;
+};
+/**
+ * Agent 模式配置 (自建应用)
+ * 用于接收 XML 格式回调 + API 主动发送
+ */
+export type WecomAgentConfig = {
+    /** 企业 ID */
+    corpId: string;
+    /** 应用 Secret */
+    corpSecret: string;
+    /** 应用 ID（可选；不填时可接收回调，但主动发送需具备该字段） */
+    agentId?: number | string;
+    /** 回调 Token (企微后台「设置API接收」) */
+    token: string;
+    /** 回调加密密钥 (企微后台「设置API接收」) */
+    encodingAESKey: string;
+    /** 欢迎语 */
+    welcomeText?: string;
+    /** DM 策略: 'open' 允许所有人, 'pairing' 需要配对, 'allowlist' 仅允许列表, 'disabled' 禁用 */
+    dmPolicy?: 'open' | 'pairing' | 'allowlist' | 'disabled';
+    /** 允许的用户列表，为空表示允许所有人 */
+    allowFrom?: Array<string | number>;
+};
+/** 路由行为配置 */
+export type WecomRoutingConfig = {
+    /**
+     * 当路由未命中 bindings（matchedBy=default）时是否拒绝继续处理。
+     * - true: fail-closed（推荐于多账号）
+     * - false: 允许回退默认 agent（历史兼容）
+     */
+    failClosedOnDefaultRoute?: boolean;
+};
+/** 动态 Agent 配置 */
+export type WecomDynamicAgentsConfig = {
+    /** 是否启用动态 Agent */
+    enabled?: boolean;
+    /** 私聊：是否为每个用户创建独立 Agent */
+    dmCreateAgent?: boolean;
+    /** 群聊：是否启用动态 Agent */
+    groupEnabled?: boolean;
+    /** 管理员列表（绕过动态路由，使用主 Agent） */
+    adminUsers?: string[];
+};

package/dist/src/types/config.js

@@ -0,0 +1,7 @@
+/**
+ * WeCom 子模块配置类型定义
+ *
+ * 注意：顶层配置类型 WeComConfig 定义在 src/utils.ts 中，以平铺结构为准。
+ * 本文件仅定义 Agent/Bot/DM/Network/Media 等子模块的配置类型。
+ */
+export {};

package/dist/src/types/constants.d.ts

@@ -0,0 +1,42 @@
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+export declare const WEBHOOK_PATHS: {
+    /** Bot 模式历史兼容路径（不再维护） */
+    readonly BOT: "/wecom";
+    /** Bot 模式历史备用兼容路径（不再维护） */
+    readonly BOT_ALT: "/wecom/bot";
+    /** Agent 模式历史兼容路径（不再维护） */
+    readonly AGENT: "/wecom/agent";
+    /** Bot 模式推荐路径前缀 */
+    readonly BOT_PLUGIN: "/plugins/wecom/bot";
+    /** Agent 模式推荐路径前缀 */
+    readonly AGENT_PLUGIN: "/plugins/wecom/agent";
+};
+/** 企业微信 API 端点 */
+export declare const API_ENDPOINTS: {
+    readonly GET_TOKEN: "https://qyapi.weixin.qq.com/cgi-bin/gettoken";
+    readonly SEND_MESSAGE: "https://qyapi.weixin.qq.com/cgi-bin/message/send";
+    readonly SEND_APPCHAT: "https://qyapi.weixin.qq.com/cgi-bin/appchat/send";
+    readonly UPLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/upload";
+    readonly DOWNLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/get";
+};
+/** 各类限制常量 */
+export declare const LIMITS: {
+    /** 文本消息最大字节数 */
+    readonly TEXT_MAX_BYTES: 2048;
+    /** Token 刷新缓冲时间 (提前刷新) */
+    readonly TOKEN_REFRESH_BUFFER_MS: 60000;
+    /** HTTP 请求超时 */
+    readonly REQUEST_TIMEOUT_MS: 15000;
+    /** 最大请求体大小 */
+    readonly MAX_REQUEST_BODY_SIZE: number;
+};
+/** AES 加密常量 */
+export declare const CRYPTO: {
+    /** PKCS#7 块大小 */
+    readonly PKCS7_BLOCK_SIZE: 32;
+    /** AES Key 长度 */
+    readonly AES_KEY_LENGTH: 32;
+};

package/dist/src/types/constants.js

@@ -0,0 +1,42 @@
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+export const WEBHOOK_PATHS = {
+    /** Bot 模式历史兼容路径（不再维护） */
+    BOT: "/wecom",
+    /** Bot 模式历史备用兼容路径（不再维护） */
+    BOT_ALT: "/wecom/bot",
+    /** Agent 模式历史兼容路径（不再维护） */
+    AGENT: "/wecom/agent",
+    /** Bot 模式推荐路径前缀 */
+    BOT_PLUGIN: "/plugins/wecom/bot",
+    /** Agent 模式推荐路径前缀 */
+    AGENT_PLUGIN: "/plugins/wecom/agent",
+};
+/** 企业微信 API 端点 */
+export const API_ENDPOINTS = {
+    GET_TOKEN: "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
+    SEND_MESSAGE: "https://qyapi.weixin.qq.com/cgi-bin/message/send",
+    SEND_APPCHAT: "https://qyapi.weixin.qq.com/cgi-bin/appchat/send",
+    UPLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/upload",
+    DOWNLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/get",
+};
+/** 各类限制常量 */
+export const LIMITS = {
+    /** 文本消息最大字节数 */
+    TEXT_MAX_BYTES: 2048,
+    /** Token 刷新缓冲时间 (提前刷新) */
+    TOKEN_REFRESH_BUFFER_MS: 60_000,
+    /** HTTP 请求超时 */
+    REQUEST_TIMEOUT_MS: 15_000,
+    /** 最大请求体大小 */
+    MAX_REQUEST_BODY_SIZE: 1024 * 1024,
+};
+/** AES 加密常量 */
+export const CRYPTO = {
+    /** PKCS#7 块大小 */
+    PKCS7_BLOCK_SIZE: 32,
+    /** AES Key 长度 */
+    AES_KEY_LENGTH: 32,
+};

package/dist/src/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * WeCom 类型统一导出
+ */
+export * from "./constants.js";
+export type { WecomMediaConfig, WecomNetworkConfig, WecomBotConfig, WecomAgentConfig, } from "./config.js";
+export type { ResolvedAgentAccount, } from "./account.js";
+export type { WecomBotInboundBase, WecomBotInboundText, WecomBotInboundVoice, WecomBotInboundVideo, WecomBotInboundStreamRefresh, WecomBotInboundEvent, WecomBotInboundMessage, WecomAgentInboundMessage, WecomInboundQuote, WecomTemplateCard, WecomOutboundMessage, } from "./message.js";

package/dist/src/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * WeCom 类型统一导出
+ */
+// 常量
+export * from "./constants.js";

package/dist/src/types/message.d.ts

@@ -0,0 +1,238 @@
+/**
+ * WeCom 消息类型定义
+ * Bot 和 Agent 模式共用
+ */
+/**
+ * Bot 模式入站消息基础结构 (JSON)
+ */
+/**
+ * **WecomBotInboundBase (Bot 入站消息基类)**
+ *
+ * Bot 模式下 JSON 格式回调的基础字段。
+ * @property msgid 消息 ID
+ * @property aibotid 机器人 ID
+ * @property chattype 会话类型: "single" | "group"
+ * @property chatid 群聊 ID (仅群组时存在)
+ * @property response_url 下行回复 URL (用于被动响应转主动推送)
+ * @property from 发送者信息
+ */
+export type WecomBotInboundBase = {
+    msgid?: string;
+    aibotid?: string;
+    chattype?: "single" | "group";
+    chatid?: string;
+    response_url?: string;
+    from?: {
+        userid?: string;
+        corpid?: string;
+    };
+    msgtype?: string;
+    /** 附件数量 (部分消息存在) */
+    attachment_count?: number;
+};
+export type WecomBotInboundText = WecomBotInboundBase & {
+    msgtype: "text";
+    text?: {
+        content?: string;
+    };
+    quote?: WecomInboundQuote;
+};
+export type WecomBotInboundVoice = WecomBotInboundBase & {
+    msgtype: "voice";
+    voice?: {
+        content?: string;
+    };
+    quote?: WecomInboundQuote;
+};
+export type WecomBotInboundVideo = WecomBotInboundBase & {
+    msgtype: "video";
+    video?: {
+        url?: string;
+        aeskey?: string;
+    };
+    quote?: WecomInboundQuote;
+};
+export type WecomBotInboundStreamRefresh = WecomBotInboundBase & {
+    msgtype: "stream";
+    stream?: {
+        id?: string;
+    };
+};
+export type WecomBotInboundEvent = WecomBotInboundBase & {
+    msgtype: "event";
+    create_time?: number;
+    event?: {
+        eventtype?: string;
+        [key: string]: unknown;
+    };
+};
+/**
+ * **WecomInboundQuote (引用消息)**
+ *
+ * 消息中引用的原始内容（如回复某条消息）。
+ * 支持引用文本、图片、混合类型、语音、文件等。
+ */
+export type WecomInboundQuote = {
+    msgtype?: "text" | "image" | "mixed" | "voice" | "file" | "video";
+    /** 引用文本内容 */
+    text?: {
+        content?: string;
+    };
+    /** 引用图片 URL */
+    image?: {
+        url?: string;
+    };
+    /** 引用混合消息 (图文) */
+    mixed?: {
+        msg_item?: Array<{
+            msgtype: "text" | "image";
+            text?: {
+                content?: string;
+            };
+            image?: {
+                url?: string;
+            };
+        }>;
+    };
+    /** 引用语音 */
+    voice?: {
+        content?: string;
+    };
+    /** 引用文件 */
+    file?: {
+        url?: string;
+    };
+    /** 引用视频 */
+    video?: {
+        url?: string;
+    };
+};
+export type WecomBotInboundMessage = WecomBotInboundText | WecomBotInboundVoice | WecomBotInboundVideo | WecomBotInboundStreamRefresh | WecomBotInboundEvent | (WecomBotInboundBase & {
+    quote?: WecomInboundQuote;
+} & Record<string, unknown>);
+/**
+ * Agent 模式入站消息结构 (解析自 XML)
+ */
+/**
+ * **WecomAgentInboundMessage (Agent 入站消息)**
+ *
+ * Agent 模式下解析自 XML 的扁平化消息结构。
+ * 键名保持 PascalCase (如 `ToUserName`)。
+ */
+export type WecomAgentInboundMessage = {
+    ToUserName?: string;
+    FromUserName?: string;
+    CreateTime?: number;
+    MsgType?: string;
+    MsgId?: string;
+    AgentID?: number;
+    Content?: string;
+    PicUrl?: string;
+    MediaId?: string;
+    FileName?: string;
+    Format?: string;
+    Recognition?: string;
+    ThumbMediaId?: string;
+    Location_X?: number;
+    Location_Y?: number;
+    Scale?: number;
+    Label?: string;
+    Title?: string;
+    Description?: string;
+    Url?: string;
+    Event?: string;
+    EventKey?: string;
+    ChatId?: string;
+};
+/**
+ * 模板卡片类型
+ */
+/**
+ * **WecomTemplateCard (模板卡片)**
+ *
+ * 复杂的交互式卡片结构。
+ * @property card_type 卡片类型: "text_notice" | "news_notice" | "button_interaction" ...
+ * @property source 来源信息
+ * @property main_title 主标题
+ * @property sub_title_text 副标题
+ * @property horizontal_content_list 水平排列的键值列表
+ * @property button_list 按钮列表
+ */
+export type WecomTemplateCard = {
+    card_type: "text_notice" | "news_notice" | "button_interaction" | "vote_interaction" | "multiple_interaction";
+    source?: {
+        icon_url?: string;
+        desc?: string;
+        desc_color?: number;
+    };
+    main_title?: {
+        title?: string;
+        desc?: string;
+    };
+    task_id?: string;
+    button_list?: Array<{
+        text: string;
+        style?: number;
+        key: string;
+    }>;
+    sub_title_text?: string;
+    horizontal_content_list?: Array<{
+        keyname: string;
+        value?: string;
+        type?: number;
+        url?: string;
+        userid?: string;
+    }>;
+    card_action?: {
+        type: number;
+        url?: string;
+        appid?: string;
+        pagepath?: string;
+    };
+    action_menu?: {
+        desc: string;
+        action_list: Array<{
+            text: string;
+            key: string;
+        }>;
+    };
+    select_list?: Array<{
+        question_key: string;
+        title?: string;
+        selected_id?: string;
+        option_list: Array<{
+            id: string;
+            text: string;
+        }>;
+    }>;
+    submit_button?: {
+        text: string;
+        key: string;
+    };
+    checkbox?: {
+        question_key: string;
+        option_list: Array<{
+            id: string;
+            text: string;
+            is_checked?: boolean;
+        }>;
+        mode?: number;
+    };
+};
+/**
+ * 出站消息类型
+ */
+export type WecomOutboundMessage = {
+    msgtype: "text";
+    text: {
+        content: string;
+    };
+} | {
+    msgtype: "markdown";
+    markdown: {
+        content: string;
+    };
+} | {
+    msgtype: "template_card";
+    template_card: WecomTemplateCard;
+};

package/dist/src/types/message.js

@@ -0,0 +1,5 @@
+/**
+ * WeCom 消息类型定义
+ * Bot 和 Agent 模式共用
+ */
+export {};

package/dist/src/utils.d.ts

@@ -2,6 +2,8 @@
  * 企业微信公共工具函数
  */
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { ResolvedAgentAccount } from "./types/account.js";
+import type { WecomAgentConfig, WecomNetworkConfig, WecomMediaConfig } from "./types/config.js";
 /**
  * 企业微信群组配置
  */
@@ -30,7 +32,30 @@ export interface WeComConfig {
     sendThinkingMessage?: boolean;
     /** 额外允许访问的本地媒体路径白名单（支持 ~ 表示 home 目录），如 ["~/Downloads", "~/Documents"] */
     mediaLocalRoots?: string[];
+    /** Agent 模式配置（自建应用） */
+    agent?: WecomAgentConfig;
+    /** 网络配置 */
+    network?: WecomNetworkConfig;
+    /** 媒体处理配置 */
+    media?: WecomMediaConfig;
+    /** 连接模式：webhook | websocket（默认 websocket） */
+    connectionMode?: "webhook" | "websocket";
+    /** Webhook 验证 token */
+    token?: string;
+    /** AES 加密密钥（43 字符 Base64） */
+    encodingAESKey?: string;
+    /** 接收方 ID */
+    receiveId?: string;
+    /** enter_chat 欢迎消息 */
+    welcomeText?: string;
+    /** 流式占位符提示内容 */
+    streamPlaceholderContent?: string;
 }
+/**
+ * 单个企业微信账号的配置类型（用于 accounts 字段下的每个账号）。
+ * 与 WeComConfig 字段完全一致，账号级字段会覆盖顶层同名字段。
+ */
+export type WeComAccountConfig = Partial<WeComConfig>;
 export declare const DefaultWsUrl = "wss://openws.work.weixin.qq.com";
 export interface ResolvedWeComAccount {
     accountId: string;
@@ -42,6 +67,12 @@ export interface ResolvedWeComAccount {
     /** 是否发送"思考中"消息，默认为 true */
     sendThinkingMessage: boolean;
     config: WeComConfig;
+    /** Agent 模式能力（自建应用） */
+    agent?: ResolvedAgentAccount;
+    /** Webhook 模式配置 */
+    token?: string;
+    encodingAESKey?: string;
+    receiveId?: string;
 }
 /**
  * 解析企业微信账户配置
@@ -51,3 +82,11 @@ export declare function resolveWeComAccount(cfg: OpenClawConfig): ResolvedWeComA
  * 设置企业微信账户配置
  */
 export declare function setWeComAccount(cfg: OpenClawConfig, account: Partial<WeComConfig>): OpenClawConfig;
+/**
+ * 解析出口代理 URL（对齐原版 resolveWecomEgressProxyUrl）
+ *
+ * 优先级：
+ * 1. config.channels.wecom.network.egressProxyUrl
+ * 2. 环境变量：OPENCLAW_WECOM_EGRESS_PROXY_URL → WECOM_EGRESS_PROXY_URL → HTTPS_PROXY → ALL_PROXY → HTTP_PROXY
+ */
+export declare function resolveWecomEgressProxyUrl(cfg: OpenClawConfig): string | undefined;

package/dist/src/utils.js

@@ -0,0 +1,70 @@
+/**
+ * 企业微信公共工具函数
+ */
+import { DEFAULT_ACCOUNT_ID } from "./openclaw-compat.js";
+import { CHANNEL_ID } from "./const.js";
+export const DefaultWsUrl = "wss://openws.work.weixin.qq.com";
+/**
+ * 解析企业微信账户配置
+ */
+export function resolveWeComAccount(cfg) {
+    const wecomConfig = (cfg.channels?.[CHANNEL_ID] ?? {});
+    return {
+        accountId: DEFAULT_ACCOUNT_ID,
+        name: wecomConfig.name ?? "企业微信",
+        enabled: wecomConfig.enabled !== false,
+        websocketUrl: wecomConfig.websocketUrl || DefaultWsUrl,
+        botId: wecomConfig.botId ?? "",
+        secret: wecomConfig.secret ?? "",
+        sendThinkingMessage: wecomConfig.sendThinkingMessage ?? true,
+        config: wecomConfig,
+    };
+}
+/**
+ * 设置企业微信账户配置
+ */
+export function setWeComAccount(cfg, account) {
+    const existing = (cfg.channels?.[CHANNEL_ID] ?? {});
+    const merged = {
+        enabled: account.enabled ?? existing?.enabled ?? true,
+        botId: account.botId ?? existing?.botId ?? "",
+        secret: account.secret ?? existing?.secret ?? "",
+        allowFrom: account.allowFrom ?? existing?.allowFrom,
+        dmPolicy: account.dmPolicy ?? existing?.dmPolicy,
+        // 以下字段仅在已有配置值或显式传入时才写入，onboarding 时不主动生成
+        ...(account.websocketUrl || existing?.websocketUrl
+            ? { websocketUrl: account.websocketUrl ?? existing?.websocketUrl }
+            : {}),
+        ...(account.name || existing?.name
+            ? { name: account.name ?? existing?.name }
+            : {}),
+        ...(account.sendThinkingMessage !== undefined || existing?.sendThinkingMessage !== undefined
+            ? { sendThinkingMessage: account.sendThinkingMessage ?? existing?.sendThinkingMessage }
+            : {}),
+    };
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            [CHANNEL_ID]: merged,
+        },
+    };
+}
+/**
+ * 解析出口代理 URL（对齐原版 resolveWecomEgressProxyUrl）
+ *
+ * 优先级：
+ * 1. config.channels.wecom.network.egressProxyUrl
+ * 2. 环境变量：OPENCLAW_WECOM_EGRESS_PROXY_URL → WECOM_EGRESS_PROXY_URL → HTTPS_PROXY → ALL_PROXY → HTTP_PROXY
+ */
+export function resolveWecomEgressProxyUrl(cfg) {
+    const wecom = (cfg.channels?.[CHANNEL_ID] ?? {});
+    const proxyUrl = wecom.network?.egressProxyUrl ??
+        process.env.OPENCLAW_WECOM_EGRESS_PROXY_URL ??
+        process.env.WECOM_EGRESS_PROXY_URL ??
+        process.env.HTTPS_PROXY ??
+        process.env.ALL_PROXY ??
+        process.env.HTTP_PROXY ??
+        "";
+    return proxyUrl.trim() || undefined;
+}

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-/** 插件版本号，来源于 package.json */
+/** 插件版本号，运行时从 package.json 读取 */
 export declare const PLUGIN_VERSION: string;

package/dist/src/version.js

@@ -0,0 +1,24 @@
+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 ?? "";