@chbo297/infoflow 2026.2.24 → 2026.2.28

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat: add assistant watchMentions, followUp, replyMode and actions support\n\n- Add watchMentions config for assistant-style replies when watched users are @mentioned\n- Add @mention detection and resolution in group messages \\(user and agent\\)\n- Add followUp window for automatic follow-up replies after bot interaction\n- Add 5 replyMode options: ignore, record, mention-only, mention-and-watch, proactive\n- Add ChannelMessageActionAdapter for LLM-initiated message sends\n- Refactor logging: unified logVerbose\\(\\) and formatInfoflowError\\(\\)\n- Update openclaw.plugin.json config schema with new group config format \\(breaking change\\)\n- Add CHANGELOG.md\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(npm publish:*)"
+    ]
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+## 2026.2.28
+
+### 新功能
+
+#### 助手模式与 @mention 能力
+
+- 支持 `watchMentions` 配置：当群内有人 @了 watchMentions 列表中的用户时，机器人作为该用户的助手自动判断是否代为回复
+- 支持识别群消息中的 @mention（人类用户和机器人），并在回复中正确生成 @mention 内容
+- 新增 `at-agent` 消息类型，支持在回复中 @其他机器人
+
+#### Follow-Up 跟进回复
+
+- 支持 `followUp` 配置（默认开启）：机器人回复后，在 `followUpWindow`（默认 300 秒）时间窗口内，即使未被 @，也会判断后续消息是否是对之前话题的延续并决定是否回复
+- 通过内存 Map 跟踪每个群的最后回复时间
+
+#### 回复模式系统（replyMode）
+
+新增 5 种群聊回复模式，支持按群独立配置：
+
+| 模式 | 行为 |
+| --- | --- |
+| `ignore` | 直接丢弃，不记录、不思考、不回复 |
+| `record` | 仅记录到会话，不思考、不回复 |
+| `mention-only` | 仅在机器人被直接 @ 时回复 |
+| `mention-and-watch`（默认） | 机器人被 @、或 watchMentions 中的用户被 @、或处于 follow-up 窗口内时回复 |
+| `proactive` | 始终思考并判断是否回复 |
+
+#### 消息动作（Actions）
+
+- 新增 `ChannelMessageActionAdapter` 实现，支持 LLM Agent 通过 `send` action 主动发送消息
+- 支持 `atAll`、`mentionUserIds`、`media` 等参数
+
+---
+
+### 重构
+
+#### 日志系统统一
+
+- 移除 `logInfoflowApiError`，新增统一的 `logVerbose()` 函数
+- 全项目统一使用 `logVerbose()` 替代分散的 verbose 日志判断逻辑
+- 统一使用 `formatInfoflowError()` 格式化错误信息
+- 改进多处错误日志的上下文信息
+
+---
+
+### ⚠️ 不兼容变更
+
+#### openclaw.plugin.json 配置格式变更
+
+群聊配置部分有较大变更，**不兼容以前的格式**。主要变更：
+
+- 新增顶层 `replyMode`、`followUp`、`followUpWindow`、`watchMentions` 字段
+- 新增 `groups` 对象，支持按群 ID 独立配置（`replyMode`、`watchMentions`、`followUp`、`followUpWindow`、`systemPrompt`）
+- 新增 `defaultAccount` 字段
+- `accounts` 下每个账号也可嵌套独自的 `groups` 配置
+- 配置解析优先级：群级别 → 账号级别 → 顶层默认值
+
+旧的 `requireMention` 字段仍可用（内部自动映射到新的 replyMode），但建议迁移到新的 `replyMode` 配置。
+
+新配置示例：
+
+```json5
+{
+  channels: {
+    infoflow: {
+      replyMode: "mention-and-watch",
+      followUp: true,
+      followUpWindow: 300,
+      watchMentions: ["alice01", "bob02"],
+      groups: {
+        "12345": {
+          replyMode: "proactive",
+          systemPrompt: "你是项目 X 的专家...",
+          watchMentions: ["alice01"],
+        },
+      },
+    },
+  },
+}
+```

package/openclaw.plugin.json

@@ -4,6 +4,90 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "properties": {}
+    "properties": {
+      "apiHost": { "type": "string" },
+      "enabled": { "type": "boolean" },
+      "name": { "type": "string" },
+      "checkToken": { "type": "string" },
+      "encodingAESKey": { "type": "string" },
+      "appKey": { "type": "string" },
+      "appSecret": { "type": "string" },
+      "robotName": { "type": "string" },
+      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"] },
+      "allowFrom": { "type": "array", "items": { "type": "string" } },
+      "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+      "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+      "requireMention": { "type": "boolean" },
+      "replyMode": {
+        "type": "string",
+        "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"],
+        "default": "mention-and-watch"
+      },
+      "followUp": { "type": "boolean", "default": true },
+      "followUpWindow": { "type": "number", "default": 300 },
+      "watchMentions": { "type": "array", "items": { "type": "string" } },
+      "groups": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "replyMode": {
+              "type": "string",
+              "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+            },
+            "watchMentions": { "type": "array", "items": { "type": "string" } },
+            "followUp": { "type": "boolean" },
+            "followUpWindow": { "type": "number" },
+            "systemPrompt": { "type": "string" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "name": { "type": "string" },
+            "checkToken": { "type": "string" },
+            "encodingAESKey": { "type": "string" },
+            "appKey": { "type": "string" },
+            "appSecret": { "type": "string" },
+            "robotName": { "type": "string" },
+            "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"] },
+            "allowFrom": { "type": "array", "items": { "type": "string" } },
+            "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+            "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+            "requireMention": { "type": "boolean" },
+            "replyMode": {
+              "type": "string",
+              "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+            },
+            "followUp": { "type": "boolean" },
+            "followUpWindow": { "type": "number" },
+            "watchMentions": { "type": "array", "items": { "type": "string" } },
+            "groups": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "replyMode": {
+                    "type": "string",
+                    "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+                  },
+                  "watchMentions": { "type": "array", "items": { "type": "string" } },
+                  "followUp": { "type": "boolean" },
+                  "followUpWindow": { "type": "number" },
+                  "systemPrompt": { "type": "string" }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      },
+      "defaultAccount": { "type": "string" }
+    }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chbo297/infoflow",
-  "version": "2026.2.24",
+  "version": "2026.2.28",
   "description": "OpenClaw Infoflow (如流) channel plugin for Baidu enterprise messaging",
   "type": "module",
   "main": "index.ts",

package/src/accounts.ts

@@ -70,6 +70,7 @@ function mergeInfoflowAccountConfig(
   name?: string;
   robotName?: string;
   requireMention?: boolean;
+  watchMentions?: string[];
 } {
   const raw = getChannelSection(cfg) ?? {};
   const { accounts: _ignored, defaultAccount: _ignored2, ...base } = raw;
@@ -84,6 +85,7 @@ function mergeInfoflowAccountConfig(
     name?: string;
     robotName?: string;
     requireMention?: boolean;
+    watchMentions?: string[];
   };
 }
 
@@ -126,6 +128,7 @@ export function resolveInfoflowAccount(params: {
       appSecret,
       robotName: merged.robotName?.trim() || undefined,
       requireMention: merged.requireMention,
+      watchMentions: merged.watchMentions,
     },
   };
 }

package/src/actions.ts

@@ -0,0 +1,108 @@
+/**
+ * Infoflow channel message actions adapter.
+ * Intercepts the "send" action from the message tool to support
+ * @all and @user mentions in group messages.
+ */
+
+import type { ChannelMessageActionAdapter, ChannelMessageActionName } from "openclaw/plugin-sdk";
+import { extractToolSend, jsonResult, readStringParam } from "openclaw/plugin-sdk";
+import { resolveInfoflowAccount } from "./accounts.js";
+import { logVerbose } from "./logging.js";
+import { sendInfoflowMessage } from "./send.js";
+import { normalizeInfoflowTarget } from "./targets.js";
+import type { InfoflowMessageContentItem } from "./types.js";
+
+export const infoflowMessageActions: ChannelMessageActionAdapter = {
+  listActions: (): ChannelMessageActionName[] => ["send"],
+
+  extractToolSend: ({ args }) => extractToolSend(args, "sendMessage"),
+
+  handleAction: async ({ action, params, cfg, accountId }) => {
+    if (action !== "send") {
+      throw new Error(`Action "${action}" is not supported for Infoflow.`);
+    }
+
+    const account = resolveInfoflowAccount({ cfg, accountId: accountId ?? undefined });
+    if (!account.config.appKey || !account.config.appSecret) {
+      throw new Error("Infoflow appKey/appSecret not configured.");
+    }
+
+    const rawTo = readStringParam(params, "to", { required: true });
+    if (!rawTo) {
+      throw new Error("send requires a target (to).");
+    }
+    const to = normalizeInfoflowTarget(rawTo) ?? rawTo;
+    const message = readStringParam(params, "message", { required: false, allowEmpty: true }) ?? "";
+    const mediaUrl = readStringParam(params, "media", { trim: false });
+
+    // Infoflow-specific mention params
+    const atAll = params.atAll === true || params.atAll === "true";
+    const mentionUserIdsRaw = readStringParam(params, "mentionUserIds");
+
+    const isGroup = /^group:\d+$/i.test(to);
+    const contents: InfoflowMessageContentItem[] = [];
+
+    // Build AT content nodes (group messages only)
+    if (isGroup) {
+      if (atAll) {
+        contents.push({ type: "at", content: "all" });
+      } else if (mentionUserIdsRaw) {
+        const userIds = mentionUserIdsRaw
+          .split(",")
+          .map((s) => s.trim())
+          .filter(Boolean);
+        if (userIds.length > 0) {
+          contents.push({ type: "at", content: userIds.join(",") });
+        }
+      }
+    }
+
+    // Prepend @all/@user prefix to display text (same pattern as reply-dispatcher.ts)
+    let messageText = message;
+    if (isGroup) {
+      if (atAll) {
+        messageText = `@all ${message}`;
+      } else if (mentionUserIdsRaw) {
+        const userIds = mentionUserIdsRaw
+          .split(",")
+          .map((s) => s.trim())
+          .filter(Boolean);
+        if (userIds.length > 0) {
+          const prefix = userIds.map((id) => `@${id}`).join(" ");
+          messageText = `${prefix} ${message}`;
+        }
+      }
+    }
+
+    if (messageText.trim()) {
+      contents.push({ type: "markdown", content: messageText });
+    }
+
+    if (mediaUrl) {
+      contents.push({ type: "link", content: mediaUrl });
+    }
+
+    if (contents.length === 0) {
+      throw new Error("send requires text or media");
+    }
+
+    logVerbose(
+      `[infoflow:action:send] to=${to}, atAll=${atAll}, mentionUserIds=${mentionUserIdsRaw ?? "none"}`,
+    );
+
+    const result = await sendInfoflowMessage({
+      cfg,
+      to,
+      contents,
+      accountId: accountId ?? undefined,
+    });
+
+    return jsonResult({
+      ok: result.ok,
+      channel: "infoflow",
+      to,
+      messageId: result.messageId ?? (result.ok ? "sent" : "failed"),
+      ...(result.error ? { error: result.error } : {}),
+    });
+  },
+};