@dingxiang-me/openclaw-wechat 1.7.2 → 2.0.1

package/src/wecom/channel-status-state.js

@@ -0,0 +1,150 @@
+const DEFAULT_ACCOUNT_ID = "default";
+const CHANNEL_CONNECTED_TTL_MS = 10 * 60 * 1000;
+
+const accountInboundState = new Map();
+const accountConnectionState = new Map();
+
+function readString(value) {
+  const trimmed = String(value ?? "").trim();
+  return trimmed || "";
+}
+
+function normalizeAccountId(accountId) {
+  return readString(accountId).toLowerCase() || DEFAULT_ACCOUNT_ID;
+}
+
+function normalizeInboundTimestamp(value) {
+  if (value == null || value === "") return Date.now();
+  const raw = Number(value);
+  if (!Number.isFinite(raw) || raw <= 0) return Date.now();
+  if (raw < 1e12) return Math.floor(raw * 1000);
+  return Math.floor(raw);
+}
+
+function formatIso(ms) {
+  try {
+    return new Date(ms).toISOString();
+  } catch {
+    return null;
+  }
+}
+
+function toConnectedFlag(ms) {
+  if (!Number.isFinite(ms) || ms <= 0) return false;
+  return Date.now() - ms <= CHANNEL_CONNECTED_TTL_MS;
+}
+
+function buildMergedConnectionState(accountId, latestInboundMs = 0) {
+  const connection = accountConnectionState.get(normalizeAccountId(accountId));
+  const inboundConnected = toConnectedFlag(latestInboundMs);
+  if (!connection) {
+    return {
+      connected: inboundConnected,
+      transport: null,
+      connectedAt: null,
+      connectedAtMs: null,
+    };
+  }
+  return {
+    connected: connection.connected === true || inboundConnected,
+    transport: connection.transport || null,
+    connectedAt: connection.connectedAt ?? null,
+    connectedAtMs: Number(connection.connectedAtMs) || null,
+  };
+}
+
+export function markWecomInboundActivity({ accountId, timestamp } = {}) {
+  const normalizedAccountId = normalizeAccountId(accountId);
+  const inboundAtMs = normalizeInboundTimestamp(timestamp);
+  const existing = accountInboundState.get(normalizedAccountId);
+  if (existing && Number(existing.lastInboundAtMs) > inboundAtMs) {
+    return existing;
+  }
+  const next = {
+    accountId: normalizedAccountId,
+    lastInboundAtMs: inboundAtMs,
+    lastInboundAt: formatIso(inboundAtMs),
+  };
+  accountInboundState.set(normalizedAccountId, next);
+  return next;
+}
+
+export function getWecomInboundActivity(accountId) {
+  const entry = accountInboundState.get(normalizeAccountId(accountId));
+  if (!entry) {
+    const connectionState = buildMergedConnectionState(accountId, 0);
+    if (!connectionState.connected && !connectionState.transport) return null;
+    return {
+      accountId: normalizeAccountId(accountId),
+      lastInboundAtMs: null,
+      lastInboundAt: null,
+      ...connectionState,
+    };
+  }
+  const latestMs = Number(entry.lastInboundAtMs ?? 0);
+  return {
+    ...entry,
+    ...buildMergedConnectionState(accountId, latestMs),
+  };
+}
+
+export function getWecomChannelInboundActivity(accountIds = []) {
+  const normalizedIds = Array.isArray(accountIds)
+    ? accountIds.map((item) => normalizeAccountId(item))
+    : [];
+  const targetEntries =
+    normalizedIds.length > 0
+      ? normalizedIds.map((id) => accountInboundState.get(id)).filter(Boolean)
+      : Array.from(accountInboundState.values());
+  if (targetEntries.length === 0) {
+    return {
+      connected: false,
+      lastInboundAt: null,
+      lastInboundAtMs: null,
+    };
+  }
+
+  let latest = targetEntries[0];
+  for (const entry of targetEntries) {
+    if ((entry?.lastInboundAtMs ?? 0) > (latest?.lastInboundAtMs ?? 0)) {
+      latest = entry;
+    }
+  }
+
+  const latestMs = Number(latest?.lastInboundAtMs ?? 0);
+  const connectionEntries =
+    normalizedIds.length > 0
+      ? normalizedIds.map((id) => accountConnectionState.get(id)).filter(Boolean)
+      : Array.from(accountConnectionState.values());
+  const anyConnected = connectionEntries.some((entry) => entry?.connected === true);
+  return {
+    connected: anyConnected || toConnectedFlag(latestMs),
+    lastInboundAt: latest?.lastInboundAt ?? null,
+    lastInboundAtMs: Number.isFinite(latestMs) ? latestMs : null,
+  };
+}
+
+export function setWecomConnectionState({ accountId, connected, transport = "" } = {}) {
+  const normalizedAccountId = normalizeAccountId(accountId);
+  const nextConnected = connected === true;
+  const existing = accountConnectionState.get(normalizedAccountId);
+  const connectedAtMs = nextConnected
+    ? Number(existing?.connectedAtMs) > 0
+      ? Number(existing.connectedAtMs)
+      : Date.now()
+    : null;
+  const next = {
+    accountId: normalizedAccountId,
+    connected: nextConnected,
+    transport: String(transport ?? "").trim() || existing?.transport || null,
+    connectedAtMs,
+    connectedAt: connectedAtMs ? formatIso(connectedAtMs) : null,
+  };
+  accountConnectionState.set(normalizedAccountId, next);
+  return next;
+}
+
+export function __resetWecomInboundActivityForTests() {
+  accountInboundState.clear();
+  accountConnectionState.clear();
+}

package/src/wecom/command-handlers.js

@@ -7,6 +7,7 @@ export function createWecomCommandHandlers({
   listWebhookTargetAliases,
   listAllWebhookTargetAliases,
   resolveWecomVoiceTranscriptionConfig,
+  inspectWecomVoiceTranscriptionRuntime = async () => null,
   resolveWecomCommandPolicy,
   resolveWecomAllowFromPolicy,
   resolveWecomDmPolicy,
@@ -38,6 +39,9 @@ export function createWecomCommandHandlers({
   if (typeof resolveWecomVoiceTranscriptionConfig !== "function") {
     throw new Error("createWecomCommandHandlers: resolveWecomVoiceTranscriptionConfig is required");
   }
+  if (typeof inspectWecomVoiceTranscriptionRuntime !== "function") {
+    throw new Error("createWecomCommandHandlers: inspectWecomVoiceTranscriptionRuntime is required");
+  }
   if (typeof resolveWecomCommandPolicy !== "function") {
     throw new Error("createWecomCommandHandlers: resolveWecomCommandPolicy is required");
   }
@@ -96,6 +100,7 @@ export function createWecomCommandHandlers({
     const accountIds = listWecomAccountIds(api);
     const webhookTargetAliases = listWebhookTargetAliases(config);
     const voiceConfig = resolveWecomVoiceTranscriptionConfig(api);
+    const voiceRuntimeInfo = await inspectWecomVoiceTranscriptionRuntime({ api, voiceConfig });
     const commandPolicy = resolveWecomCommandPolicy(api);
     const allowFromPolicy = resolveWecomAllowFromPolicy(api, config?.accountId, config);
     const dmPolicy = resolveWecomDmPolicy(api, config?.accountId, config);
@@ -116,6 +121,7 @@ export function createWecomCommandHandlers({
       webhookTargetAliases,
       pluginVersion,
       voiceConfig,
+      voiceRuntimeInfo,
       commandPolicy,
       allowFromPolicy,
       dmPolicy,

package/src/wecom/command-status-text.js

@@ -54,6 +54,32 @@ function buildObservabilityStatusLines(observabilityMetrics = {}) {
   };
 }
 
+function buildVoiceStatusLine(voiceConfig = {}, voiceRuntimeInfo = null) {
+  if (!voiceConfig?.enabled) {
+    return "⚠️ 语音消息转写回退未启用（仅使用企业微信 Recognition）";
+  }
+
+  const modelLabel = voiceConfig.modelPath || voiceConfig.model || "未配置";
+  const baseLine = `✅ 语音消息转写（本地 ${voiceConfig.provider}，模型: ${modelLabel}）`;
+  if (!voiceRuntimeInfo || typeof voiceRuntimeInfo !== "object") {
+    return baseLine;
+  }
+
+  const commandState = voiceRuntimeInfo.resolvedCommand
+    ? `命令 ${voiceRuntimeInfo.resolvedCommand}`
+    : `命令缺失（检查 ${voiceRuntimeInfo.commandCandidates?.join(" / ") || "未配置"}）`;
+  const ffmpegState = voiceRuntimeInfo.ffmpegEnabled
+    ? voiceRuntimeInfo.ffmpegAvailable
+      ? "ffmpeg 已安装"
+      : "ffmpeg 缺失"
+    : "ffmpeg 未启用";
+  const issueSuffix =
+    Array.isArray(voiceRuntimeInfo.issues) && voiceRuntimeInfo.issues.length > 0
+      ? `；问题：${voiceRuntimeInfo.issues.join("；")}`
+      : "";
+  return `${baseLine}（${commandState}，${ffmpegState}）${issueSuffix}`;
+}
+
 export function buildAgentStatusText({
   fromUser,
   config,
@@ -61,6 +87,7 @@ export function buildAgentStatusText({
   webhookTargetAliases,
   pluginVersion,
   voiceConfig,
+  voiceRuntimeInfo,
   commandPolicy,
   allowFromPolicy,
   dmPolicy,
@@ -75,9 +102,7 @@ export function buildAgentStatusText({
   observabilityMetrics,
 } = {}) {
   const proxyEnabled = Boolean(config?.outboundProxy);
-  const voiceStatusLine = voiceConfig.enabled
-    ? `✅ 语音消息转写（本地 ${voiceConfig.provider}，模型: ${voiceConfig.modelPath || voiceConfig.model}）`
-    : "⚠️ 语音消息转写回退未启用（仅使用企业微信 Recognition）";
+  const voiceStatusLine = buildVoiceStatusLine(voiceConfig, voiceRuntimeInfo);
   const commandPolicyLine = commandPolicy.enabled
     ? `✅ 指令白名单已启用（${commandPolicy.allowlist.length} 条，管理员 ${commandPolicy.adminUsers.length} 人）`
     : "ℹ️ 指令白名单未启用";
@@ -191,6 +216,10 @@ export function buildBotStatusText({
   const webhookBotPolicyLine = webhookBotPolicy.enabled
     ? "✅ Webhook Bot 回包已启用"
     : "ℹ️ Webhook Bot 回包未启用";
+  const longConnectionLine =
+    botConfig?.longConnection?.enabled === true
+      ? `✅ Bot 长连接已启用（BotID=${String(botConfig?.longConnection?.botId ?? "").slice(0, 8) || "n/a"}...）`
+      : "ℹ️ Bot 长连接未启用";
   const webhookTargetsLine = buildWebhookTargetStatusLine({
     aliases: allWebhookTargetAliases,
     scope: "全部账户",