@core-workspace/infoflow-openclaw-plugin 2026.3.9 → 2026.3.27-beta.0

package/src/commands/changelog.ts

@@ -0,0 +1,80 @@
+/**
+ * /infoflow-changelog command
+ *
+ * 读取 CHANGELOG.md，展示最近几次更新内容。
+ *
+ * 用法：
+ *   /infoflow-changelog        — 最近 5 次更新
+ *   /infoflow-changelog all    — 全部更新记录
+ */
+
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
+import { sendInfoflowMessage } from "../channel/outbound.js";
+import { getPluginVersion } from "./version.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CHANGELOG_PATH = resolve(__dirname, "../../CHANGELOG.md");
+const DEFAULT_SHOW = 5;
+
+export async function runChangelogCommand(ctx: {
+  args?: string;
+  config?: OpenClawConfig;
+  to?: string;
+  accountId?: string;
+}): Promise<{ text: string }> {
+  const { args, config, to, accountId } = ctx;
+  const showAll = args?.trim().toLowerCase() === "all";
+
+  if (!existsSync(CHANGELOG_PATH)) {
+    return { text: "**更新日志**\n\n暂无更新记录。" };
+  }
+
+  let content: string;
+  try {
+    content = readFileSync(CHANGELOG_PATH, "utf-8");
+  } catch (err: unknown) {
+    return {
+      text: `**更新日志**\n\n读取更新日志失败：${err instanceof Error ? err.message : String(err)}`,
+    };
+  }
+
+  // 去掉 HTML 注释（开发规范说明，不展示给用户）
+  const stripped = content.replace(/<!--[\s\S]*?-->/g, "").trim();
+  // 按 "## " 版本标题分割，过滤掉文件标题行（# 更新日志）和"开发中"（未发布，不对外展示）
+  const sections = stripped
+    .split(/^## /m)
+    .filter((s) => Boolean(s) && !s.startsWith("# ") && !s.startsWith("开发中"));
+
+  if (sections.length === 0) {
+    return { text: "**Infoflow 更新日志**\n\n暂无更新记录。" };
+  }
+
+  const version = getPluginVersion();
+  const title = `**Infoflow 更新日志**  v${version}`;
+
+  const toShow = showAll ? sections : sections.slice(0, DEFAULT_SHOW);
+  const body = toShow.map((s) => `## ${s.trimEnd()}`).join("\n\n");
+
+  const hint =
+    !showAll && sections.length > DEFAULT_SHOW
+      ? `\n\n> 仅显示最近 ${toShow.length} 次更新，发送 \`/infoflow-changelog all\` 查看全部 ${sections.length} 次更新记录。`
+      : "";
+
+  const reportText = `${title}\n\n${body}${hint}`;
+
+  // 用 markdown 格式直接发送，保证标题/加粗等格式正常渲染
+  if (config && to) {
+    await sendInfoflowMessage({
+      cfg: config,
+      to,
+      contents: [{ type: "markdown", content: reportText }],
+      accountId: accountId ?? undefined,
+    });
+    return { text: "" };
+  }
+
+  return { text: reportText };
+}

package/src/commands/doctor.ts

@@ -0,0 +1,545 @@
+/**
+ * /infoflow-doctor command
+ *
+ * 自检命令：逐项检查 Infoflow 插件的配置和连通性，
+ * 帮助用户快速定位"为什么群聊/私聊收不到回复"的问题。
+ *
+ * 用法：/infoflow-doctor
+ */
+
+import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
+import {
+  DEFAULT_INFOFLOW_API_HOST,
+  DEFAULT_INFOFLOW_WS_GATEWAY,
+  listInfoflowAccountIds,
+  resolveInfoflowAccount,
+} from "../channel/accounts.js";
+import { sendInfoflowImageMessage } from "../channel/media.js";
+import { sendInfoflowMessage } from "../channel/outbound.js";
+import { getOrCreateAdapter } from "../utils/token-adapter.js";
+import { getPluginVersion } from "./version.js";
+
+// 48x48 绿色圆形+白色对勾，用于发图片自检（可视化验证）
+const TEST_IMAGE_BASE64 =
+  "iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAIAAADYYG7QAAAA8klEQVR42u3ZSw6DMAwE0DkUN+kle0vaJRIkGtvx2KmKWAblASH+gLPZgZ8FHe9XJeg7PXOmg0hHRIZsipUFmYY0QalhTFBSGBZKNBPTJiCBZmRCoebRhFrN3aQDTaYYgmTvZTJAAWKWqQ5EfsUPoELNdTD0MasG5AgAiSBfOMoCuYOjFMRfCP5h8nfp3v2pJ2RdlRGNBzQaGU9j/KD74CVJlWFRz+dblXNGQfPy2f15wrRrpVaV5mgv0JjTD0HxD99+urxWCeXUeRp/kr+2NFhTl2VoNqlc/82GTftDHTtoTXuMHbuwHfvUTTv5ff915B0fHgSvRnMJWVsAAAAASUVORK5CYII=";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+type CheckResult = {
+  name: string;
+  ok: boolean;
+  detail: string;
+  skip?: boolean;
+};
+
+// ---------------------------------------------------------------------------
+// Individual checks
+// ---------------------------------------------------------------------------
+
+function checkAccountConfig(cfg: OpenClawConfig): CheckResult[] {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      results.push({
+        name: `${prefix}账号解析`,
+        ok: false,
+        detail: "resolveInfoflowAccount 抛出异常",
+      });
+      continue;
+    }
+
+    const c = account.config;
+
+    results.push({
+      name: `${prefix}appKey`,
+      ok: !!c.appKey,
+      detail: c.appKey ? `已配置 (${c.appKey.slice(0, 8)}...)` : "未配置",
+    });
+    results.push({
+      name: `${prefix}appSecret`,
+      ok: !!c.appSecret,
+      detail: c.appSecret ? "已配置" : "未配置",
+    });
+    results.push({
+      name: `${prefix}apiHost`,
+      ok: !!c.apiHost,
+      detail: c.apiHost ?? "未配置（将使用默认值）",
+    });
+    results.push({
+      name: `${prefix}connectionMode`,
+      ok: true,
+      detail: c.connectionMode ?? "websocket（默认）",
+    });
+    if ((c.connectionMode ?? "websocket") === "websocket") {
+      results.push({
+        name: `${prefix}wsGateway`,
+        ok: true,
+        detail: c.wsGateway ?? "未配置（将使用默认值 infoflow-open-gateway.baidu.com）",
+      });
+    } else {
+      results.push({
+        name: `${prefix}checkToken`,
+        ok: !!c.checkToken,
+        detail: c.checkToken ? "已配置" : "未配置（webhook 签名验证将失败）",
+      });
+      results.push({
+        name: `${prefix}encodingAESKey`,
+        ok: !!c.encodingAESKey,
+        detail: c.encodingAESKey ? "已配置" : "未配置（消息解密将失败）",
+      });
+    }
+    results.push({
+      name: `${prefix}dmPolicy`,
+      ok: true,
+      detail: c.dmPolicy ?? "open（默认）",
+    });
+    // dmPolicy=allowlist 但 allowFrom 为空 → 所有私聊静默拒绝
+    if ((c.dmPolicy ?? "open") === "allowlist") {
+      const allowFrom = c.allowFrom ?? [];
+      results.push({
+        name: `${prefix}allowFrom`,
+        ok: allowFrom.length > 0,
+        detail:
+          allowFrom.length > 0
+            ? `已配置 ${allowFrom.length} 个用户`
+            : "未配置！dmPolicy=allowlist 时必须填写 allowFrom，否则所有私聊都将被拒绝",
+      });
+    }
+    results.push({
+      name: `${prefix}groupPolicy`,
+      ok: true,
+      detail: c.groupPolicy ?? "open（默认）",
+    });
+    if (c.groupPolicy === "disabled") {
+      results.push({
+        name: `${prefix}群聊提醒`,
+        ok: false,
+        detail: "groupPolicy=disabled，群聊消息不会被处理！如需群聊支持请设置为 open 或 allowlist",
+      });
+    }
+    // groupPolicy=allowlist 但 groupAllowFrom 为空 → 所有群静默拒绝
+    if (c.groupPolicy === "allowlist") {
+      const groupAllowFrom = c.groupAllowFrom ?? [];
+      results.push({
+        name: `${prefix}groupAllowFrom`,
+        ok: groupAllowFrom.length > 0,
+        detail:
+          groupAllowFrom.length > 0
+            ? `已配置 ${groupAllowFrom.length} 个群`
+            : "未配置！groupPolicy=allowlist 时必须填写 groupAllowFrom，否则所有群消息都将被拒绝",
+      });
+    }
+    results.push({
+      name: `${prefix}replyMode`,
+      ok: true,
+      detail: c.replyMode ?? "mention-only（默认）",
+    });
+  }
+
+  return results;
+}
+
+async function checkTokenFetch(cfg: OpenClawConfig): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+    if (!account.config.appKey || !account.config.appSecret) {
+      results.push({
+        name: `${prefix}access_token 获取`,
+        ok: false,
+        detail: "appKey/appSecret 未配置，跳过",
+      });
+      continue;
+    }
+
+    try {
+      const adapter = getOrCreateAdapter({
+        appKey: account.config.appKey,
+        appSecret: account.config.appSecret,
+        apiHost: account.config.apiHost ?? DEFAULT_INFOFLOW_API_HOST,
+      });
+      const token = await adapter.getToken();
+      results.push({
+        name: `${prefix}access_token 获取`,
+        ok: !!token,
+        detail: token ? `成功 (${String(token).slice(0, 12)}...)` : "返回为空",
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}access_token 获取`,
+        ok: false,
+        detail: `失败: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+const WS_CONNECT_TIMEOUT_MS = 8000;
+
+async function checkWsConnectivity(cfg: OpenClawConfig): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+
+    const c = account.config;
+    if ((c.connectionMode ?? "websocket") !== "websocket") continue;
+    if (!c.appKey || !c.appSecret) {
+      results.push({
+        name: `${prefix}WebSocket 连通性`,
+        ok: false,
+        detail: "appKey/appSecret 未配置，跳过",
+      });
+      continue;
+    }
+
+    const wsGateway = c.wsGateway ?? DEFAULT_INFOFLOW_WS_GATEWAY;
+
+    try {
+      const { WSClient } = await import("@core-workspace/infoflow-sdk-nodejs");
+      const client = new WSClient({ appId: c.appKey, appSecret: c.appSecret, wsGateway });
+
+      await new Promise<void>((resolve, reject) => {
+        const timer = setTimeout(() => {
+          reject(new Error(`连接超时（>${WS_CONNECT_TIMEOUT_MS}ms），网关: ${wsGateway}`));
+        }, WS_CONNECT_TIMEOUT_MS);
+
+        client.on("connected" as any, () => {
+          clearTimeout(timer);
+          try {
+            (client as any).disconnect?.();
+          } catch {
+            /* ignore */
+          }
+          resolve();
+        });
+        client.on("error" as any, (err: any) => {
+          clearTimeout(timer);
+          reject(new Error(err?.message ?? String(err)));
+        });
+
+        client.connect().catch((err: any) => {
+          clearTimeout(timer);
+          reject(err);
+        });
+      });
+
+      results.push({
+        name: `${prefix}WebSocket 连通性`,
+        ok: true,
+        detail: `已连接，网关: ${wsGateway}`,
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}WebSocket 连通性`,
+        ok: false,
+        detail: `失败: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+async function checkSendMessage(cfg: OpenClawConfig, senderId: string): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  if (!senderId) {
+    results.push({ name: "发消息自检", ok: false, detail: "无法确定发送目标（senderId 为空）" });
+    return results;
+  }
+
+  const accountIds = listInfoflowAccountIds(cfg);
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+    if (!account.config.appKey || !account.config.appSecret) continue;
+
+    try {
+      const result = await sendInfoflowMessage({
+        cfg,
+        to: senderId,
+        contents: [{ type: "text", content: "✅ [infoflow-doctor] 发消息自检通过" }],
+        accountId: account.accountId,
+      });
+      results.push({
+        name: `${prefix}发消息到 ${senderId}`,
+        ok: result.ok,
+        detail: result.ok
+          ? `成功 (messageId: ${result.messageId ?? "N/A"})`
+          : `失败: ${result.error ?? "unknown"}`,
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}发消息到 ${senderId}`,
+        ok: false,
+        detail: `异常: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+async function checkSendImage(cfg: OpenClawConfig, to: string): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+    if (!account.config.appKey || !account.config.appSecret) continue;
+
+    const isGroup = to.includes(":group:");
+    const target = to.replace(/^.*?:group:/, "group:");
+    const label = isGroup ? `群 ${target}` : to;
+
+    try {
+      const result = await sendInfoflowImageMessage({
+        cfg,
+        to: target,
+        base64Image: TEST_IMAGE_BASE64,
+        accountId: account.accountId,
+      });
+      results.push({
+        name: `${prefix}发图片到 ${label}`,
+        ok: result.ok,
+        detail: result.ok
+          ? `成功 (messageId: ${result.messageId ?? "N/A"})`
+          : `失败: ${result.error ?? "unknown"}`,
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}发图片到 ${label}`,
+        ok: false,
+        detail: `异常: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+// ---------------------------------------------------------------------------
+// Format output
+// ---------------------------------------------------------------------------
+
+// 将技术字段名映射为用户友好的中文描述
+const FIELD_LABELS: Record<string, string> = {
+  appKey: "应用 Key",
+  appSecret: "应用密钥",
+  apiHost: "API 地址",
+  connectionMode: "连接方式",
+  wsGateway: "WebSocket 网关地址",
+  checkToken: "Webhook 验签 Token",
+  encodingAESKey: "消息加密密钥",
+  dmPolicy: "私聊权限策略",
+  allowFrom: "私聊白名单",
+  groupPolicy: "群聊权限策略",
+  groupAllowFrom: "群聊白名单",
+  replyMode: "群聊回复模式",
+  群聊提醒: "群聊权限警告",
+  账号解析: "账号配置读取",
+  "access_token 获取": "API 登录验证",
+  "WebSocket 连通性": "WebSocket 连通性",
+  发消息自检: "发消息测试",
+};
+
+function friendlyName(name: string): string {
+  // 处理带账号前缀的名字，如 "[main] appKey"
+  const match = name.match(/^(\[.+?\] )(.+)$/);
+  if (match) {
+    const prefix = match[1];
+    const field = match[2];
+    return `${prefix}${FIELD_LABELS[field] ?? field}`;
+  }
+  // 处理 "发消息到 xxx" / "发图片到 xxx"
+  if (name.startsWith("发消息到 ") || name.startsWith("发图片到 ")) return name;
+  return FIELD_LABELS[name] ?? name;
+}
+
+function friendlyDetail(name: string, detail: string): string {
+  // 连接方式特殊处理
+  if (name.endsWith("connectionMode")) {
+    if (detail.includes("websocket")) return "WebSocket 长连接（无需公网域名）";
+    return "Webhook 回调（需配置公网地址）";
+  }
+  // dmPolicy
+  if (name.endsWith("dmPolicy")) {
+    if (detail.includes("open")) return "开放（任何人可私聊）";
+    if (detail.includes("allowlist")) return "白名单（仅允许名单内用户）";
+    if (detail.includes("pairing")) return "配对授权";
+    return detail;
+  }
+  // groupPolicy
+  if (name.endsWith("groupPolicy")) {
+    if (detail.includes("disabled")) return "已关闭群聊（所有群消息不处理）";
+    if (detail.includes("allowlist")) return "白名单（仅允许名单内的群）";
+    if (detail.includes("open")) return "开放（所有群可触发）";
+    return detail;
+  }
+  // replyMode
+  if (name.endsWith("replyMode")) {
+    if (detail.includes("mention-only")) return "仅响应 @机器人（默认）";
+    if (detail.includes("mention-and-watch")) return "响应 @机器人 + 关键词监听";
+    if (detail.includes("proactive")) return "主动响应所有群消息";
+    if (detail.includes("record")) return "仅记录，不回复";
+    if (detail.includes("ignore")) return "完全忽略群消息";
+    return detail;
+  }
+  // wsGateway 默认值
+  if (detail.includes("infoflow-open-gateway.baidu.com")) {
+    return detail.includes("未配置") ? "使用默认网关" : detail;
+  }
+  // apiHost 默认值
+  if (detail.includes("将使用默认值")) return "使用默认地址";
+  // groupPolicy=disabled 警告
+  if (detail.includes("groupPolicy=disabled")) {
+    return "群聊功能已关闭，机器人不会响应任何群消息。如需开启，请将 groupPolicy 设置为 open";
+  }
+  return detail;
+}
+
+function formatResults(results: CheckResult[]): string {
+  const lines: string[] = [`**如流机器人自检报告**  v${getPluginVersion()}`, ""];
+
+  const failed = results.filter((r) => !r.ok && !r.skip);
+  const checked = results.filter((r) => !r.skip);
+
+  for (const r of results) {
+    const icon = r.skip ? "⏭️" : r.ok ? "✅" : "❌";
+    const label = friendlyName(r.name);
+    const detail = friendlyDetail(r.name, r.detail);
+    lines.push(`${icon} **${label}**：${detail}`);
+  }
+
+  lines.push("");
+  lines.push("---");
+
+  if (failed.length === 0) {
+    lines.push(`✅ 自检全部通过（共 ${checked.length} 项），机器人运行正常！`);
+  } else {
+    lines.push(`⚠️ 发现 ${failed.length} 个问题，请根据上方提示修复后重试`);
+  }
+
+  lines.push("");
+  lines.push("📋 **排查工具**");
+  lines.push("- `/infoflow-logs` — 查看最近 50 条收发消息日志");
+  lines.push("- `/infoflow-logs 100` — 查看最近 100 条");
+  lines.push("- `/infoflow-logs error` — 只看错误日志");
+  lines.push("- `/infoflow-logs warn 100` — 最近 100 条警告及以上");
+  lines.push("- `/infoflow-changelog` — 查看插件更新记录");
+
+  return lines.join("\n");
+}
+
+// ---------------------------------------------------------------------------
+// Command handler
+// ---------------------------------------------------------------------------
+
+export async function runDoctorCommand(ctx: {
+  config: OpenClawConfig;
+  senderId?: string;
+  /** 消息目标：群聊时为 "group:<groupId>"，私聊时与 senderId 相同 */
+  to?: string;
+  /** 账号 ID，用于多账号模式下选择发送账号 */
+  accountId?: string;
+  /** 命令参数，支持 /infoflow-doctor <userId> 指定发送目标 */
+  args?: string;
+}): Promise<{ text: string }> {
+  const { config, senderId, to, accountId, args } = ctx;
+  const results: CheckResult[] = [];
+
+  // 1. 配置检查（同步）
+  results.push(...checkAccountConfig(config));
+
+  // 2. Token 获取（异步）
+  results.push(...(await checkTokenFetch(config)));
+
+  // 3. WebSocket 连通性（仅 websocket 模式）
+  results.push(...(await checkWsConnectivity(config)));
+
+  // 网页 UI 触发时 senderId 为系统账号，无法发消息，除非通过参数指定了目标
+  const isWebUI =
+    !senderId || senderId === "openclaw-control-ui" || senderId.startsWith("openclaw-");
+  const argTarget = args?.trim() || undefined;
+  const realSenderId = isWebUI ? argTarget : senderId;
+
+  if (isWebUI && !argTarget) {
+    results.push({
+      name: "发消息自检",
+      ok: true,
+      skip: true,
+      detail: "网页 UI 触发，跳过发送自检（可用 /infoflow-doctor <userId> 指定接收人）",
+    });
+  }
+
+  // 3. 发私聊消息自检（发给触发命令的用户）
+  if (realSenderId) {
+    results.push(...(await checkSendMessage(config, realSenderId)));
+  }
+
+  // 4. 发群消息自检（仅群聊中执行命令时）
+  const groupTo = to?.includes(":group:") ? to.replace(/^.*?:group:/, "group:") : undefined;
+  if (groupTo) {
+    results.push(...(await checkSendMessage(config, groupTo)));
+  }
+
+  // 5. 发图片自检（群聊发到群，私聊发给用户）
+  const imageTarget = groupTo ?? realSenderId;
+  if (imageTarget) {
+    results.push(...(await checkSendImage(config, imageTarget)));
+  }
+
+  const reportText = formatResults(results);
+
+  // 自检报告用 markdown 格式直接发送，保证加粗/表情符号等格式正常渲染
+  const replyTarget = groupTo ?? realSenderId;
+  if (replyTarget) {
+    await sendInfoflowMessage({
+      cfg: config,
+      to: replyTarget,
+      contents: [{ type: "markdown", content: reportText }],
+      accountId: accountId ?? undefined,
+    });
+    // 报告已自行发出，返回空 text 避免框架重复发送
+    return { text: "" };
+  }
+
+  // 无法确定发送目标（Web UI 场景），降级为纯文本回传给框架
+  return { text: reportText };
+}