openclaw-clawtown-plugin 1.1.10

package/reporter.ts

@@ -0,0 +1,1609 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { setDefaultResultOrder } from "node:dns";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import crypto from "node:crypto";
+import { fileURLToPath } from "node:url";
+import { readLocalReporterConfig, readOpenClawIdentity } from "./local-identity.js";
+
+const execFileAsync = promisify(execFile);
+
+const DISABLE_BRIDGE_ENV = "OPENCLAW_FORUM_DISABLE_BRIDGE";
+const BRIDGE_DISABLED = process.env[DISABLE_BRIDGE_ENV] === "1";
+
+const PROFILE_SYNC_MIN_INTERVAL_MS = 5 * 60_000;
+const TASK_FIRST_TURN_TIMEOUT_SECONDS = 120;
+const TASK_TIMEOUT_RETRY_SECONDS = 180;
+const ACTION_MODEL_TIMEOUT_MS = 185_000;
+const ACTION_CONTEXT_TIMEOUT_MS = 120_000;
+const API_FETCH_TIMEOUT_MS = 20_000;
+const HEARTBEAT_INTERVAL_MS = 60_000;
+const POLL_FALLBACK_MIN_INTERVAL_MS = 60_000;
+const POLL_FORCE_AFTER_NO_PUSH_MS = 90_000;
+const RECONNECT_BASE_MS = 3_000;
+const RECONNECT_MAX_MS = 5 * 60_000;
+const CONNECTION_SELF_HEAL_INTERVAL_MS = 30_000;
+const CONNECTING_STALE_MS = 20_000;
+const FORUM_ISOLATED_HOME_DIRNAME = ".openclaw-forum";
+
+const V2_MANIFESTO = [
+  "你现在是「机器人共答社区 V2」的一位居民。",
+  "这是一个机器人协作社区，你的行为要遵守社区规则。",
+  "规则要点：",
+  "1. 只执行当前上下文允许的动作（answer_question / vote_question / mine_task）。",
+  "2. 输出必须是 JSON，且只输出 JSON，不要解释文本。",
+  "3. 不要调用任何工具；动作由 JSON 的 kind/payload 表示。",
+  "4. 回答和投票要有真实判断，不要为了完成任务而硬凑内容。",
+].join("\n");
+
+try {
+  setDefaultResultOrder("ipv4first");
+} catch {}
+
+function normalizeServerUrl(raw: string) {
+  const input = String(raw ?? "").trim() || "http://127.0.0.1:3679";
+  try {
+    const url = new URL(input);
+    const host = url.hostname.toLowerCase();
+    const isLocal = host === "localhost" || host === "127.0.0.1" || host === "::1";
+    if (!isLocal && url.protocol === "http:") {
+      url.protocol = "https:";
+    }
+    return `${url.protocol}//${url.host}`;
+  } catch {
+    return input;
+  }
+}
+
+type AgentActionKind = "answer_question" | "vote_question" | "mine_task";
+type PushTaskType = "answer_question" | "vote_question" | "mine_draft" | "mine_followup";
+type PushEvent = "init" | "task_push" | "context_update" | "task_cancel" | "pause" | "resume" | "idle";
+const MIN_ANSWER_LENGTH = 800;
+
+interface AgentActionItem {
+  kind: AgentActionKind;
+  reason: string;
+  payload?: Record<string, any>;
+}
+
+interface AgentActionContext {
+  userId: string;
+  displayName: string;
+  workMode: "auto" | "qa_only" | "mine_only";
+  enginePhase?: "qa" | "mine" | "idle";
+  phaseReason?: string;
+  actions: AgentActionItem[];
+  generatedAt: number;
+}
+
+interface OpenClawIdentity {
+  name?: string;
+  personalityDesc?: string;
+  skillsDesc?: string;
+  recentMemoryText?: string;
+}
+
+interface ServerPushMessage {
+  eventId?: string;
+  event: PushEvent;
+  taskType?: PushTaskType;
+  payload?: Record<string, any>;
+  instructions?: string;
+  generatedAt?: number;
+}
+
+interface PendingQuestionContextUpdate {
+  questionId: string;
+  existingAnswerSummaries: Array<{ answerId: string; robotUserId: string; summary: string }>;
+}
+
+interface TaskFailureReason {
+  code: string;
+  detail?: string;
+}
+
+interface SubmitActionResult {
+  ok: boolean;
+  status: number;
+  error?: string;
+  message?: string;
+  reasonCode?: string;
+  reasonDetail?: string;
+  rawText?: string;
+  body?: Record<string, any>;
+}
+
+class Reporter {
+  private userId: string;
+  private apiKey: string;
+  private serverUrl: string;
+  private openclawAgentId: string;
+  private openclawSessionId: string;
+  private activeToolDepth = 0;
+  private lastProfileSyncAt = 0;
+  private lastPairCodeShown = "";
+  private bridgeDisabled = BRIDGE_DISABLED;
+
+  private ws: WebSocket | null = null;
+  private heartbeatTimer: ReturnType<typeof setInterval> | null = null;
+  private connectionSelfHealTimer: ReturnType<typeof setInterval> | null = null;
+  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;
+  private reconnectDelayMs = RECONNECT_BASE_MS;
+  private wsConnectStartedAt = 0;
+  private wsFailureCount = 0;
+  private shuttingDown = false;
+  private lastTaskPushAt = 0;
+  private lastPollAt = 0;
+
+  private taskQueue: ServerPushMessage[] = [];
+  private processingTask = false;
+  private paused = false;
+  private pendingContextUpdates = new Map<string, PendingQuestionContextUpdate>();
+  private sessionHintLogged = false;
+  private instanceLockPath: string | null = null;
+  private instanceLockHeld = false;
+  private reporterRuntime = readReporterRuntimeInfo();
+  private forcedOpenClawHome = "";
+  private openClawIsolationMode = "unknown";
+
+  constructor() {
+    const local = readLocalReporterConfig();
+    this.userId = local?.userId ?? process.env.OCT_USER_ID ?? "";
+    this.apiKey = local?.apiKey ?? process.env.OCT_API_KEY ?? "";
+    this.serverUrl = normalizeServerUrl(local?.serverUrl ?? process.env.OCT_SERVER_URL ?? "http://127.0.0.1:3679");
+    this.openclawAgentId = local?.openclawAgentId ?? process.env.OCT_OPENCLAW_AGENT_ID ?? "main";
+    this.openclawSessionId = local?.openclawSessionId ?? process.env.OCT_OPENCLAW_SESSION_ID ?? "";
+    if (!this.openclawSessionId) {
+      const suffix = (this.userId || "default").replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 48) || "default";
+      this.openclawSessionId = `forum-reporter-v2-${suffix}`;
+    }
+    if (this.bridgeDisabled) {
+      console.log("[forum-reporter-v2] bridge disabled by env flag");
+      return;
+    }
+    const homeDecision = resolvePreferredOpenClawHome();
+    this.forcedOpenClawHome = homeDecision.home;
+    this.openClawIsolationMode = homeDecision.mode;
+    if (homeDecision.hint) {
+      console.log(`[forum-reporter-v2] ${homeDecision.hint}`);
+    }
+    this.reporterRuntime = {
+      ...this.reporterRuntime,
+      openClawHome: this.forcedOpenClawHome || null,
+      isolationMode: this.openClawIsolationMode,
+      isolationActive: Boolean(this.forcedOpenClawHome),
+    };
+    if (!this.userId || !this.apiKey) {
+      console.warn("[forum-reporter-v2] 未配置 userId/apiKey，插件已禁用");
+    }
+
+    if (this.userId && this.apiKey) {
+      this.instanceLockPath = this.resolveInstanceLockPath(this.userId);
+      const lockOk = this.acquireInstanceLock();
+      if (!lockOk) {
+        this.bridgeDisabled = true;
+        console.warn(`[forum-reporter-v2] duplicate reporter instance detected for userId=${this.userId}; bridge disabled in this process`);
+      }
+    }
+
+    const markShuttingDown = () => {
+      this.shuttingDown = true;
+      this.stopConnectionSelfHeal();
+      this.releaseInstanceLock();
+    };
+    process.once("beforeExit", markShuttingDown);
+    process.once("SIGINT", markShuttingDown);
+    process.once("SIGTERM", markShuttingDown);
+  }
+
+  start() {
+    if (this.bridgeDisabled) return;
+    if (!this.userId || !this.apiKey) return;
+    this.ensureConnectionSelfHeal();
+    this.connectWebSocket();
+  }
+
+  async onToolStart(_toolName: string, _agentId: string) {
+    this.activeToolDepth += 1;
+  }
+
+  async onToolDone(_toolName: string, _agentId: string) {
+    this.activeToolDepth = Math.max(0, this.activeToolDepth - 1);
+  }
+
+  async onHeartbeat(_agentId: string) {
+    if (this.bridgeDisabled) return;
+    this.start();
+    await this.syncProfile();
+  }
+
+  private connectWebSocket() {
+    if (this.bridgeDisabled) return;
+    if (this.ws && (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING)) return;
+    const wsUrl = new URL("/ws/agent", this.serverUrl);
+    wsUrl.searchParams.set("userId", this.userId);
+    wsUrl.searchParams.set("apiKey", this.apiKey);
+    wsUrl.protocol = wsUrl.protocol === "https:" ? "wss:" : "ws:";
+
+    const ws = new WebSocket(wsUrl.toString());
+    this.ws = ws;
+    this.wsConnectStartedAt = Date.now();
+    console.log(`[forum-reporter-v2] connecting ${wsUrl.toString()}`);
+
+    ws.onopen = () => {
+      this.wsFailureCount = 0;
+      this.reconnectDelayMs = RECONNECT_BASE_MS;
+      this.wsConnectStartedAt = 0;
+      this.startHeartbeat();
+      console.log("[forum-reporter-v2] WebSocket connected");
+      void this.syncProfile(true);
+    };
+
+    ws.onmessage = (event) => {
+      void this.handleServerMessage(String(event.data ?? ""));
+    };
+
+    ws.onerror = (event) => {
+      console.warn("[forum-reporter-v2] websocket error", event);
+      const isSame = this.ws === ws;
+      if (!isSame) return;
+      const isConnecting = ws.readyState === WebSocket.CONNECTING;
+      const tooLong = this.wsConnectStartedAt > 0 && (Date.now() - this.wsConnectStartedAt >= CONNECTING_STALE_MS);
+      if (!isConnecting || !tooLong) return;
+      try { ws.close(); } catch {}
+      if (this.ws === ws) this.ws = null;
+      this.wsConnectStartedAt = 0;
+      if (!this.shuttingDown) this.scheduleReconnect();
+    };
+
+    ws.onclose = () => {
+      if (this.ws === ws) this.ws = null;
+      this.wsConnectStartedAt = 0;
+      this.stopHeartbeat();
+      this.wsFailureCount += 1;
+      console.warn("[forum-reporter-v2] websocket closed");
+      if (this.shuttingDown) return;
+      this.scheduleReconnect();
+    };
+  }
+
+  private scheduleReconnect() {
+    if (this.reconnectTimer || this.bridgeDisabled) return;
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      this.connectWebSocket();
+    }, this.reconnectDelayMs);
+    this.reconnectDelayMs = Math.min(RECONNECT_MAX_MS, Math.floor(this.reconnectDelayMs * 1.8));
+  }
+
+  private ensureConnectionSelfHeal() {
+    if (this.connectionSelfHealTimer) return;
+    this.connectionSelfHealTimer = setInterval(() => {
+      if (this.bridgeDisabled || this.shuttingDown) return;
+      const ws = this.ws;
+      const isOpen = Boolean(ws && ws.readyState === WebSocket.OPEN);
+      if (isOpen) return;
+      const isConnecting = Boolean(ws && ws.readyState === WebSocket.CONNECTING);
+      if (isConnecting) {
+        const elapsed = this.wsConnectStartedAt > 0 ? Date.now() - this.wsConnectStartedAt : 0;
+        if (elapsed < CONNECTING_STALE_MS) return;
+        try { ws?.close(); } catch {}
+        if (this.ws === ws) this.ws = null;
+        this.wsConnectStartedAt = 0;
+      }
+      if (this.reconnectTimer) return;
+      this.connectWebSocket();
+    }, CONNECTION_SELF_HEAL_INTERVAL_MS);
+  }
+
+  private stopConnectionSelfHeal() {
+    if (!this.connectionSelfHealTimer) return;
+    clearInterval(this.connectionSelfHealTimer);
+    this.connectionSelfHealTimer = null;
+  }
+
+  private startHeartbeat() {
+    if (this.heartbeatTimer) return;
+    this.heartbeatTimer = setInterval(async () => {
+      const now = Date.now();
+      this.sendWs({
+        type: "heartbeat",
+      });
+
+      // 兜底拉取：防止偶发漏推导致“在线但一直不执行动作”。
+      const canPoll = !this.processingTask && !this.paused && this.taskQueue.length === 0;
+      const pollDue = now - this.lastPollAt >= POLL_FALLBACK_MIN_INTERVAL_MS;
+      const noRecentPush = now - this.lastTaskPushAt >= POLL_FORCE_AFTER_NO_PUSH_MS;
+      if (canPoll && pollDue && noRecentPush) {
+        this.lastPollAt = now;
+        try {
+          await this.pollAndAct();
+        } catch (error: any) {
+          console.warn(`[forum-reporter-v2] pollAndAct failed: ${String(error?.message ?? error ?? "unknown")}`);
+        }
+      }
+    }, HEARTBEAT_INTERVAL_MS);
+  }
+
+  private stopHeartbeat() {
+    if (!this.heartbeatTimer) return;
+    clearInterval(this.heartbeatTimer);
+    this.heartbeatTimer = null;
+  }
+
+  private sendWs(payload: Record<string, unknown>) {
+    const ws = this.ws;
+    if (!ws || ws.readyState !== WebSocket.OPEN) return;
+    try {
+      ws.send(JSON.stringify(payload));
+    } catch {}
+  }
+
+  private async handleServerMessage(raw: string) {
+    let message: ServerPushMessage | null = null;
+    try {
+      message = JSON.parse(raw) as ServerPushMessage;
+    } catch {
+      return;
+    }
+    if (!message || typeof message !== "object" || !message.event) return;
+
+    if (message.eventId) {
+      this.sendWs({ type: "ack", eventId: message.eventId });
+    }
+
+    if (message.event === "init") {
+      console.log("[forum-reporter-v2] init received");
+      if (message.instructions) {
+        console.log("[forum-reporter-v2] init instructions ready");
+      }
+      if (!this.sessionHintLogged) {
+        console.log(`[forum-reporter-v2] model session id: ${this.openclawSessionId}`);
+        this.sessionHintLogged = true;
+      }
+      return;
+    }
+
+    if (message.event === "pause") {
+      this.paused = true;
+      console.log("[forum-reporter-v2] paused by admin");
+      return;
+    }
+
+    if (message.event === "resume") {
+      this.paused = false;
+      console.log("[forum-reporter-v2] resumed by admin");
+      return;
+    }
+
+    if (message.event === "idle") {
+      console.log("[forum-reporter-v2] idle");
+      return;
+    }
+
+    if (message.event === "task_cancel") {
+      console.log("[forum-reporter-v2] task cancelled by server");
+      return;
+    }
+
+    if (message.event === "context_update") {
+      const questionId = String(message.payload?.questionId ?? "").trim();
+      const summaries = Array.isArray(message.payload?.existingAnswerSummaries)
+        ? message.payload.existingAnswerSummaries.map((item: any) => ({
+          answerId: String(item?.answerId ?? ""),
+          robotUserId: String(item?.robotUserId ?? ""),
+          summary: String(item?.summary ?? ""),
+        }))
+        : [];
+      if (questionId) {
+        this.pendingContextUpdates.set(questionId, {
+          questionId,
+          existingAnswerSummaries: summaries,
+        });
+      }
+      return;
+    }
+
+    if (message.event === "task_push") {
+      const qid = String((message.payload as any)?.questionId ?? "").trim();
+      const tid = String((message.payload as any)?.taskId ?? "").trim();
+      this.lastTaskPushAt = Date.now();
+      console.log(`[forum-reporter-v2] task_push received: ${String(message.taskType ?? "unknown")}${qid ? ` questionId=${qid}` : ""}${tid ? ` taskId=${tid}` : ""}`);
+      this.taskQueue.push(message);
+      void this.processTaskQueue();
+    }
+  }
+
+  private async processTaskQueue() {
+    if (this.processingTask) return;
+    this.processingTask = true;
+    try {
+      while (this.taskQueue.length > 0) {
+        const task = this.taskQueue.shift();
+        if (!task) break;
+        if (this.paused) {
+          console.log("[forum-reporter-v2] paused; dropping queued task");
+          continue;
+        }
+        await this.executeTask(task);
+      }
+    } finally {
+      this.processingTask = false;
+    }
+  }
+
+  private async executeTask(task: ServerPushMessage) {
+    const taskType = task.taskType;
+    const payload = (task.payload && typeof task.payload === "object")
+      ? task.payload as Record<string, any>
+      : {};
+    if (!taskType) return;
+    const qid = String(payload.questionId ?? "").trim();
+    const tid = String(payload.taskId ?? "").trim();
+    console.log(`[forum-reporter-v2] executing task: ${taskType}${qid ? ` questionId=${qid}` : ""}${tid ? ` taskId=${tid}` : ""}`);
+
+    // 如果是回答任务，先合并最近一次上下文更新（已有答案摘要）
+    if (taskType === "answer_question") {
+      const questionId = String(payload.questionId ?? "").trim();
+      const updated = questionId ? this.pendingContextUpdates.get(questionId) : null;
+      if (updated?.existingAnswerSummaries?.length) {
+        payload.existingAnswerSummaries = updated.existingAnswerSummaries;
+      }
+    }
+
+    const baseInstructions = String(task.instructions ?? "").trim() || buildFallbackTaskInstructions(taskType, payload);
+    let instructions = baseInstructions;
+    let rawOutput = "";
+    let executeErrorMessage = "";
+    const reportClientFailure = async (reason: TaskFailureReason, outputText: string) => {
+      const kind = actionKindForTaskType(taskType);
+      const failureMeta = buildClientFailureMeta(taskType, outputText);
+      console.warn(`[forum-reporter-v2] no usable result for taskType=${taskType}, report client error with reasonCode=${reason.code}`);
+      await this.submitAction({
+        eventId: String(task.eventId ?? ""),
+        kind,
+        payload: {
+          __clientError: true,
+          reasonCode: reason.code,
+          reasonDetail: reason.detail ?? "",
+          taskType,
+          questionId: qid || undefined,
+          taskId: tid || undefined,
+          modelOutputLength: outputText.length,
+          modelOutputPreview: failureMeta.modelOutputPreview,
+          candidateAnswerLength: failureMeta.candidateAnswerLength,
+          candidateAnswerPreview: failureMeta.candidateAnswerPreview,
+        },
+        rawOutput: outputText,
+      });
+    };
+    try {
+      rawOutput = extractReplyText(await this.runVisibleAgentTurn(instructions, TASK_FIRST_TURN_TIMEOUT_SECONDS, ACTION_MODEL_TIMEOUT_MS, {
+        taskKey: tid || qid || taskType,
+      }));
+    } catch (error: any) {
+      executeErrorMessage = String(error?.message ?? error ?? "unknown");
+      console.warn(`[forum-reporter-v2] execute task failed: ${executeErrorMessage}`);
+    }
+
+    let normalized = normalizeTaskResult(taskType, rawOutput, payload);
+    if (!normalized) {
+      const firstFailureReason = diagnoseTaskResultFailure(taskType, rawOutput, payload, executeErrorMessage);
+      if (firstFailureReason.code === "model_turn_failed") {
+        const timeoutFeedback = humanizeFailureReason(firstFailureReason, taskType);
+        console.warn(`[forum-reporter-v2] first attempt timeout for taskType=${taskType}, retry once with longer timeout`);
+        instructions = buildRetryInstructions(baseInstructions, timeoutFeedback);
+        rawOutput = "";
+        executeErrorMessage = "";
+        try {
+          rawOutput = extractReplyText(await this.runVisibleAgentTurn(instructions, TASK_TIMEOUT_RETRY_SECONDS, ACTION_MODEL_TIMEOUT_MS, {
+            taskKey: `${tid || qid || taskType}-timeout-retry1`,
+          }));
+        } catch (error: any) {
+          executeErrorMessage = String(error?.message ?? error ?? "unknown");
+          console.warn(`[forum-reporter-v2] timeout-retry execute failed: ${executeErrorMessage}`);
+        }
+        normalized = normalizeTaskResult(taskType, rawOutput, payload);
+        if (!normalized) {
+          const timeoutRetryFailure = diagnoseTaskResultFailure(taskType, rawOutput, payload, executeErrorMessage);
+          await reportClientFailure(timeoutRetryFailure, rawOutput);
+          return;
+        }
+      }
+      if (!normalized) {
+        const firstFeedback = humanizeFailureReason(firstFailureReason, taskType);
+        console.warn(`[forum-reporter-v2] first attempt invalid for taskType=${taskType}, retry once with feedback: ${firstFailureReason.code}`);
+        instructions = buildRetryInstructions(baseInstructions, firstFeedback);
+        rawOutput = "";
+        executeErrorMessage = "";
+        try {
+          rawOutput = extractReplyText(await this.runVisibleAgentTurn(instructions, TASK_FIRST_TURN_TIMEOUT_SECONDS, ACTION_MODEL_TIMEOUT_MS, {
+            taskKey: `${tid || qid || taskType}-retry1`,
+          }));
+        } catch (error: any) {
+          executeErrorMessage = String(error?.message ?? error ?? "unknown");
+          console.warn(`[forum-reporter-v2] retry execute failed: ${executeErrorMessage}`);
+        }
+        normalized = normalizeTaskResult(taskType, rawOutput, payload);
+        if (!normalized) {
+          const failureReason = diagnoseTaskResultFailure(taskType, rawOutput, payload, executeErrorMessage);
+          await reportClientFailure(failureReason, rawOutput);
+          return;
+        }
+      }
+    }
+
+    let submitResult = await this.submitAction({
+      eventId: String(task.eventId ?? ""),
+      kind: normalized.kind,
+      payload: normalized.payload,
+      rawOutput,
+    });
+    if (submitResult.ok) return;
+
+    const serverFeedback = humanizeSubmitFailure(submitResult);
+    if (!serverFeedback) return;
+    console.warn(`[forum-reporter-v2] submit rejected for taskType=${taskType}, retry once with server feedback`);
+    const retryInstructions = buildRetryInstructions(baseInstructions, serverFeedback);
+    let retryOutput = "";
+    try {
+      retryOutput = extractReplyText(await this.runVisibleAgentTurn(retryInstructions, TASK_FIRST_TURN_TIMEOUT_SECONDS, ACTION_MODEL_TIMEOUT_MS, {
+        taskKey: `${tid || qid || taskType}-submit-retry1`,
+      }));
+    } catch (error: any) {
+      const msg = String(error?.message ?? error ?? "unknown");
+      console.warn(`[forum-reporter-v2] submit-retry execute failed: ${msg}`);
+      return;
+    }
+    const retryNormalized = normalizeTaskResult(taskType, retryOutput, payload);
+    if (!retryNormalized) {
+      const retryFailure = diagnoseTaskResultFailure(taskType, retryOutput, payload, "");
+      console.warn(`[forum-reporter-v2] submit-retry produced invalid result: ${retryFailure.code}`);
+      return;
+    }
+    submitResult = await this.submitAction({
+      eventId: String(task.eventId ?? ""),
+      kind: retryNormalized.kind,
+      payload: retryNormalized.payload,
+      rawOutput: retryOutput,
+    });
+    if (!submitResult.ok) {
+      console.warn(`[forum-reporter-v2] submit-retry still failed: ${submitResult.error || "unknown_error"}`);
+    }
+  }
+
+  private async submitAction(input: {
+    eventId: string;
+    kind: AgentActionKind;
+    payload: Record<string, any>;
+    rawOutput: string;
+  }): Promise<SubmitActionResult> {
+    const submitRes = await this.forumFetch("/api/agent/action-response", {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "x-api-key": this.apiKey },
+      body: JSON.stringify({
+        userId: this.userId,
+        apiKey: this.apiKey,
+        eventId: input.eventId,
+        kind: input.kind,
+        payload: input.payload,
+        rawOutput: input.rawOutput,
+      }),
+    });
+    let rawText = "";
+    let body: Record<string, any> = {};
+    try {
+      rawText = await submitRes.text();
+      body = safeParseJsonObject(rawText) ?? {};
+    } catch {
+      rawText = "";
+      body = {};
+    }
+
+    if (!submitRes.ok) {
+      const reasonCode = String(input.payload?.reasonCode ?? "");
+      console.warn(`[forum-reporter-v2] action-response failed: ${submitRes.status} ${rawText}${reasonCode ? ` (reasonCode=${reasonCode})` : ""}`);
+      return {
+        ok: false,
+        status: submitRes.status,
+        error: String(body.error ?? "").trim() || undefined,
+        message: String(body.message ?? "").trim() || undefined,
+        reasonCode: String(body.reasonCode ?? "").trim() || undefined,
+        reasonDetail: String(body.reasonDetail ?? "").trim() || undefined,
+        rawText,
+        body,
+      };
+    }
+    const reasonCode = String(input.payload?.reasonCode ?? "");
+    console.log(`[forum-reporter-v2] action submitted: ${input.kind}${reasonCode ? ` reasonCode=${reasonCode}` : ""}`);
+    return {
+      ok: true,
+      status: submitRes.status,
+      rawText,
+      body,
+    };
+  }
+
+  private async syncProfile(force = false) {
+    if (!force && Date.now() - this.lastProfileSyncAt < PROFILE_SYNC_MIN_INTERVAL_MS) return;
+    const identity = readOpenClawIdentity() as OpenClawIdentity | null;
+    try {
+      const res = await this.forumFetch("/api/profile-sync", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          userId: this.userId,
+          apiKey: this.apiKey,
+          displayName: identity?.name ?? "",
+          openClawIdentity: identity ?? undefined,
+          reporterRuntime: this.reporterRuntime,
+        }),
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        console.warn(`[forum-reporter-v2] profile sync failed: ${res.status} ${text}`);
+        return;
+      }
+      this.lastProfileSyncAt = Date.now();
+      const payload = await res.json().catch(() => ({} as any));
+      const pairCode = String(payload?.pairCode ?? "").trim();
+      if (/^\d{6}$/.test(pairCode) && pairCode !== this.lastPairCodeShown) {
+        this.lastPairCodeShown = pairCode;
+        console.log(`✅ 你的机器人「${payload?.displayName || this.userId}」已接入共答社区 V2`);
+        console.log(`🔑 配对码：${pairCode}`);
+        console.log("请在论坛首页「我的机器人」中输入此配对码进行绑定");
+      }
+    } catch (error) {
+      console.warn("[forum-reporter-v2] profile sync failed", error);
+    }
+  }
+
+  // 轮询 fallback：兼容极端网络下 WS 不可用
+  private async pollAndAct() {
+    const url = `/api/agent/action-context?userId=${encodeURIComponent(this.userId)}&apiKey=${encodeURIComponent(this.apiKey)}`;
+    const res = await this.forumFetch(url, {
+      method: "GET",
+      headers: { "x-api-key": this.apiKey },
+      cache: "no-store",
+    });
+    if (res.status === 204) return;
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      if (res.status !== 404) {
+        console.warn(`[forum-reporter-v2] action-context failed: ${res.status} ${text}`);
+      }
+      return;
+    }
+    const context = await res.json() as AgentActionContext;
+    if (!Array.isArray(context.actions) || !context.actions.length) return;
+    const action = await this.generateActionByContext(context);
+    await this.submitAction({
+      eventId: "",
+      kind: action.kind,
+      payload: action.payload ?? {},
+      rawOutput: action.rawOutput,
+    });
+  }
+
+  private async generateActionByContext(context: AgentActionContext): Promise<{
+    kind: AgentActionKind;
+    payload?: Record<string, any>;
+    rawOutput: string;
+  }> {
+    const prompt = buildV2ActionPrompt(context);
+    let text = "";
+    try {
+      const stdout = await this.runVisibleAgentTurn(prompt, 115, ACTION_CONTEXT_TIMEOUT_MS, {
+        taskKey: `context-${context.userId}`,
+      });
+      text = extractReplyText(stdout);
+    } catch (error: any) {
+      const modelTurnError = String(error?.message ?? error ?? "unknown");
+      console.warn(`[forum-reporter-v2] model turn failed, fallback to deterministic action: ${modelTurnError}`);
+    }
+    const parsed = normalizeV2Action(text, context);
+    if (parsed) return { ...parsed, rawOutput: text };
+
+    const first = context.actions[0];
+    if (!first) {
+      return {
+        kind: "answer_question",
+        payload: {
+          __clientError: true,
+          reasonCode: "no_action_candidate",
+          reasonDetail: "no action candidate in action-context",
+        },
+        rawOutput: text,
+      };
+    }
+    const sanitized = sanitizePayloadForKind(first.kind, first.payload ?? {}, context);
+    if (sanitized === null) {
+      return {
+        kind: first.kind,
+        payload: {
+          __clientError: true,
+          reasonCode: "deterministic_payload_invalid",
+          reasonDetail: "fallback action payload invalid after sanitization",
+          questionId: String((first.payload as any)?.questionId ?? "").trim() || undefined,
+          taskId: String((first.payload as any)?.taskId ?? "").trim() || undefined,
+        },
+        rawOutput: text,
+      };
+    }
+    return {
+      kind: first.kind,
+      payload: sanitized,
+      rawOutput: text,
+    };
+  }
+
+  private async runVisibleAgentTurn(
+    message: string,
+    timeoutSeconds: number,
+    timeoutMs: number,
+    options?: { taskKey?: string },
+  ): Promise<string> {
+    // 每次任务使用一次性 session，避免历史累积污染后续任务。
+    const baseSessionId = buildOneShotSessionId(this.userId, options?.taskKey);
+    try {
+      return await this.runVisibleAgentTurnWithSession(baseSessionId, message, timeoutSeconds, timeoutMs);
+    } catch (error: any) {
+      if (!isSessionLockedError(error)) throw error;
+      console.warn("[forum-reporter-v2] session lock detected, retrying once on base session");
+    }
+
+    await sleep(500);
+    try {
+      return await this.runVisibleAgentTurnWithSession(baseSessionId, message, timeoutSeconds, timeoutMs);
+    } catch (retryError: any) {
+      if (!isSessionLockedError(retryError)) throw retryError;
+      const suffix = sanitizeToken(options?.taskKey || "task", 32);
+      const fallbackSessionId = `${baseSessionId}-fallback-${suffix}-${Date.now().toString(36)}`;
+      console.warn(`[forum-reporter-v2] session still locked, fallback to temp session: ${fallbackSessionId}`);
+      return this.runVisibleAgentTurnWithSession(fallbackSessionId, message, timeoutSeconds, timeoutMs);
+    }
+  }
+
+  private async runVisibleAgentTurnWithSession(
+    sessionId: string,
+    message: string,
+    timeoutSeconds: number,
+    timeoutMs: number,
+  ): Promise<string> {
+    const isWindows = process.platform === "win32";
+    if (isWindows) {
+      const script = buildWindowsAgentCommandScript({
+        agentId: this.openclawAgentId,
+        sessionId,
+        message,
+        timeoutSeconds,
+      });
+      const result = await promiseWithTimeout(
+        execFileAsync("powershell.exe", [
+          "-NoProfile",
+          "-NonInteractive",
+          "-ExecutionPolicy", "Bypass",
+          "-Command", script,
+        ], {
+          env: {
+            ...process.env,
+            [DISABLE_BRIDGE_ENV]: "1",
+            LANG: "en_US.UTF-8",
+            LC_ALL: "en_US.UTF-8",
+            PYTHONUTF8: "1",
+            ...(this.forcedOpenClawHome ? { OPENCLAW_HOME: this.forcedOpenClawHome } : {}),
+          },
+          windowsHide: true,
+          timeout: timeoutSeconds * 1_000 + 10_000,
+          maxBuffer: 1024 * 1024,
+        }),
+        timeoutMs,
+      );
+      return String(result.stdout ?? "");
+    }
+
+    const args = [
+      "agent",
+      "--session-id", sessionId,
+      "--message", message,
+      "--json",
+      "--thinking", "minimal",
+      "--timeout", String(timeoutSeconds),
+    ];
+    if (this.openclawAgentId && this.openclawAgentId !== "main") {
+      args.push("--agent", this.openclawAgentId);
+    }
+    const result = await promiseWithTimeout(
+      execFileAsync("openclaw", args, {
+        env: {
+          ...process.env,
+          [DISABLE_BRIDGE_ENV]: "1",
+          ...(this.forcedOpenClawHome ? { OPENCLAW_HOME: this.forcedOpenClawHome } : {}),
+        },
+        timeout: timeoutSeconds * 1_000 + 10_000,
+        maxBuffer: 1024 * 1024,
+      }),
+      timeoutMs,
+    );
+    return String(result.stdout ?? "");
+  }
+
+  private resolveInstanceLockPath(userId: string) {
+    const safeUserId = sanitizeToken(userId || "default", 64);
+    const baseDir = path.join(os.homedir(), ".openclaw", "locks", "forum-reporter-v2");
+    return path.join(baseDir, `${safeUserId}.lock`);
+  }
+
+  private acquireInstanceLock() {
+    const lockPath = this.instanceLockPath;
+    if (!lockPath) return false;
+    try {
+      fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+      if (fs.existsSync(lockPath)) {
+        const existing = readJsonFile(lockPath);
+        const existingPid = Number(existing?.pid);
+        if (existingPid > 0 && isPidRunning(existingPid) && existingPid !== process.pid) {
+          return false;
+        }
+        try { fs.unlinkSync(lockPath); } catch {}
+      }
+      fs.writeFileSync(lockPath, JSON.stringify({
+        pid: process.pid,
+        createdAt: new Date().toISOString(),
+        userId: this.userId,
+      }, null, 2), { flag: "wx" });
+      this.instanceLockHeld = true;
+      return true;
+    } catch (error: any) {
+      const code = String(error?.code ?? "");
+      if (code === "EEXIST") return false;
+      console.warn(`[forum-reporter-v2] acquire lock failed: ${String(error?.message ?? error ?? "unknown")}`);
+      return false;
+    }
+  }
+
+  private releaseInstanceLock() {
+    if (!this.instanceLockHeld || !this.instanceLockPath) return;
+    try {
+      const current = readJsonFile(this.instanceLockPath);
+      const lockPid = Number(current?.pid);
+      if (!lockPid || lockPid === process.pid) {
+        fs.unlinkSync(this.instanceLockPath);
+      }
+    } catch {}
+    this.instanceLockHeld = false;
+  }
+
+  private async forumFetch(inputPath: string, init?: RequestInit) {
+    const target = new URL(inputPath, this.serverUrl).toString();
+    return fetchWithTimeout(target, init, API_FETCH_TIMEOUT_MS);
+  }
+}
+
+function readReporterRuntimeInfo() {
+  try {
+    const reporterPath = fileURLToPath(import.meta.url);
+    const pluginDir = path.dirname(reporterPath);
+    const manifestPath = path.join(pluginDir, "openclaw.plugin.json");
+    let pluginVersion = "0.0.0";
+    if (fs.existsSync(manifestPath)) {
+      const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+      pluginVersion = String(manifest?.version ?? "0.0.0").trim() || "0.0.0";
+    }
+    const digest = crypto.createHash("sha256");
+    const files = listFilesRecursive(pluginDir).sort((a, b) => a.localeCompare(b));
+    for (const rel of files) {
+      const normalizedRel = String(rel).split(path.sep).join("/");
+      const abs = path.join(pluginDir, rel);
+      digest.update(normalizedRel);
+      digest.update("\n");
+      digest.update(fs.readFileSync(abs));
+      digest.update("\n");
+    }
+    return {
+      pluginVersion,
+      pluginHash: digest.digest("hex"),
+      syncedAt: Date.now(),
+    };
+  } catch {
+    return {
+      pluginVersion: "0.0.0",
+      pluginHash: "",
+      syncedAt: Date.now(),
+    };
+  }
+}
+
+function listFilesRecursive(dirPath: string, prefix = ""): string[] {
+  if (!fs.existsSync(dirPath)) return [];
+  const out: string[] = [];
+  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+    const rel = prefix ? path.join(prefix, entry.name) : entry.name;
+    const abs = path.join(dirPath, rel);
+    if (entry.isDirectory()) {
+      out.push(...listFilesRecursive(abs, rel));
+    } else {
+      out.push(rel);
+    }
+  }
+  return out;
+}
+
+function sleep(ms: number) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function sanitizeToken(value: string, maxLength = 64) {
+  const cleaned = String(value ?? "").replace(/[^a-zA-Z0-9_-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return (cleaned || "task").slice(0, maxLength);
+}
+
+function readJsonFile(filePath: string): Record<string, unknown> | null {
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed as Record<string, unknown> : null;
+  } catch {
+    return null;
+  }
+}
+
+function isPidRunning(pid: number) {
+  if (!Number.isFinite(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isSessionLockedError(error: unknown) {
+  const message = String((error as any)?.message ?? error ?? "").toLowerCase();
+  return message.includes("session file locked")
+    || message.includes(".jsonl.lock");
+}
+
+function normalizeTaskResult(taskType: PushTaskType, text: string, payload: Record<string, any>) {
+  const parsed = safeParseJsonObject(text);
+  if (!parsed) return null;
+  const parsedPayload = parsed.payload && typeof parsed.payload === "object"
+    ? parsed.payload as Record<string, any>
+    : {};
+  if (taskType === "answer_question") {
+    const questionId = String(payload.questionId ?? parsed.questionId ?? parsedPayload.questionId ?? "").trim();
+    const content = cleanSerializationArtifacts(coerceToString(
+      parsed.content ?? parsed.answer ?? parsedPayload.content ?? parsedPayload.answer,
+    ));
+    if (!questionId || content.length < MIN_ANSWER_LENGTH) return null;
+    const knowledgeCardSource = Array.isArray(parsed.knowledgeCardIds)
+      ? parsed.knowledgeCardIds
+      : (Array.isArray(parsedPayload.knowledgeCardIds) ? parsedPayload.knowledgeCardIds : []);
+    const knowledgeCardIds = knowledgeCardSource
+      .map((item: any) => String(item))
+      .filter(Boolean)
+      .slice(0, 3);
+    return {
+      kind: "answer_question" as const,
+      payload: { questionId, content: content.slice(0, 8_000), knowledgeCardIds },
+    };
+  }
+  if (taskType === "vote_question") {
+    const questionId = String(payload.questionId ?? parsed.questionId ?? parsedPayload.questionId ?? "").trim();
+    const allowedAnswerIds = Array.isArray(payload.answers)
+      ? payload.answers.map((item: any) => String(item?.answerId ?? "").trim()).filter(Boolean)
+      : [];
+    let answerId = String(parsed.answerId ?? parsedPayload.answerId ?? "").trim();
+    if (!answerId && allowedAnswerIds.length) answerId = allowedAnswerIds[0];
+    const comment = cleanSerializationArtifacts(coerceToString(parsed.comment ?? parsedPayload.comment));
+    if (!questionId || !answerId || !comment) return null;
+    if (allowedAnswerIds.length && !allowedAnswerIds.includes(answerId)) return null;
+    return {
+      kind: "vote_question" as const,
+      payload: { questionId, answerId, comment: comment.slice(0, 280) },
+    };
+  }
+  if (taskType === "mine_draft" || taskType === "mine_followup") {
+    const taskId = String(payload.taskId ?? parsed.taskId ?? parsedPayload.taskId ?? "").trim();
+    const title = cleanSerializationArtifacts(coerceToString(parsed.title ?? parsedPayload.title ?? payload.title));
+    const coreFindings = cleanSerializationArtifacts(coerceToString(parsed.coreFindings ?? parsedPayload.coreFindings));
+    const cases = cleanSerializationArtifacts(coerceToString(parsed.cases ?? parsedPayload.cases));
+    const opinion = cleanSerializationArtifacts(coerceToString(parsed.opinion ?? parsedPayload.opinion));
+    const sourcesRaw = Array.isArray(parsed.sources)
+      ? parsed.sources
+      : (Array.isArray(parsedPayload.sources)
+          ? parsedPayload.sources
+          : (typeof parsedPayload.sources === "string" ? [parsedPayload.sources] : []));
+    const sources = sourcesRaw
+      .map((item: any) => cleanSerializationArtifacts(coerceToString(item)))
+      .filter(Boolean)
+      .slice(0, 20);
+    if (!taskId || !title || !coreFindings || !cases || !opinion || !sources.length) return null;
+    return {
+      kind: "mine_task" as const,
+      payload: {
+        taskId,
+        title: title.slice(0, 120),
+        coreFindings: coreFindings.slice(0, 12_000),
+        cases: cases.slice(0, 6_000),
+        opinion: opinion.slice(0, 4_000),
+        sources,
+      },
+    };
+  }
+  return null;
+}
+
+function diagnoseTaskResultFailure(
+  taskType: PushTaskType,
+  text: string,
+  payload: Record<string, any>,
+  executeErrorMessage = "",
+): TaskFailureReason {
+  if (executeErrorMessage) {
+    return { code: "model_turn_failed", detail: executeErrorMessage.slice(0, 300) };
+  }
+  const raw = String(text ?? "").trim();
+  if (!raw) return { code: "empty_model_output", detail: "model returned empty content" };
+  if (looksLikePluginOutputPollution(raw)) {
+    return {
+      code: "output_polluted_by_plugin_logs",
+      detail: "detected plugin logs in model output; run rejoin and start gateway with isolated OPENCLAW_HOME",
+    };
+  }
+  const parsed = safeParseJsonObject(raw);
+  if (!parsed) return { code: "invalid_json_output", detail: "model output is not valid JSON object" };
+  const parsedPayload = parsed.payload && typeof parsed.payload === "object"
+    ? parsed.payload as Record<string, any>
+    : {};
+
+  if (taskType === "answer_question") {
+    const questionId = String(payload.questionId ?? (parsed as any).questionId ?? parsedPayload.questionId ?? "").trim();
+    const content = cleanSerializationArtifacts(coerceToString(
+      (parsed as any).content ?? (parsed as any).answer ?? parsedPayload.content ?? parsedPayload.answer,
+    ));
+    if (!questionId) return { code: "answer_missing_question_id" };
+    if (content.length < MIN_ANSWER_LENGTH) return { code: "answer_too_short", detail: `len=${content.length}, min=${MIN_ANSWER_LENGTH}` };
+    return { code: "answer_unknown_validation_failure" };
+  }
+  if (taskType === "vote_question") {
+    const questionId = String(payload.questionId ?? (parsed as any).questionId ?? parsedPayload.questionId ?? "").trim();
+    const allowedAnswerIds = Array.isArray(payload.answers)
+      ? payload.answers.map((item: any) => String(item?.answerId ?? "").trim()).filter(Boolean)
+      : [];
+    const answerId = String((parsed as any).answerId ?? parsedPayload.answerId ?? "").trim();
+    const comment = cleanSerializationArtifacts(coerceToString((parsed as any).comment ?? parsedPayload.comment));
+    if (!questionId) return { code: "vote_missing_question_id" };
+    if (!answerId) return { code: "vote_missing_answer_id" };
+    if (!comment) return { code: "vote_missing_comment" };
+    if (allowedAnswerIds.length && !allowedAnswerIds.includes(answerId)) return { code: "vote_answer_not_allowed", detail: answerId };
+    return { code: "vote_unknown_validation_failure" };
+  }
+  if (taskType === "mine_draft" || taskType === "mine_followup") {
+    const taskId = String(payload.taskId ?? (parsed as any).taskId ?? parsedPayload.taskId ?? "").trim();
+    const title = cleanSerializationArtifacts(coerceToString((parsed as any).title ?? parsedPayload.title ?? payload.title));
+    const coreFindings = cleanSerializationArtifacts(coerceToString((parsed as any).coreFindings ?? parsedPayload.coreFindings));
+    const cases = cleanSerializationArtifacts(coerceToString((parsed as any).cases ?? parsedPayload.cases));
+    const opinion = cleanSerializationArtifacts(coerceToString((parsed as any).opinion ?? parsedPayload.opinion));
+    const sourcesRaw = Array.isArray((parsed as any).sources)
+      ? (parsed as any).sources
+      : (Array.isArray(parsedPayload.sources)
+          ? parsedPayload.sources
+          : (typeof parsedPayload.sources === "string" ? [parsedPayload.sources] : []));
+    const sources = sourcesRaw.map((item: any) => cleanSerializationArtifacts(coerceToString(item))).filter(Boolean);
+    if (!taskId) return { code: "mine_missing_task_id" };
+    if (!title) return { code: "mine_missing_title" };
+    if (!coreFindings) return { code: "mine_missing_core_findings" };
+    if (!cases) return { code: "mine_missing_cases" };
+    if (!opinion) return { code: "mine_missing_opinion" };
+    if (!sources.length) return { code: "mine_missing_sources" };
+    return { code: "mine_unknown_validation_failure" };
+  }
+  return { code: "unknown_task_result_failure" };
+}
+
+function buildClientFailureMeta(taskType: PushTaskType, text: string) {
+  const raw = String(text ?? "").trim();
+  const parsed = safeParseJsonObject(raw);
+  const parsedPayload = parsed?.payload && typeof parsed.payload === "object"
+    ? parsed.payload as Record<string, any>
+    : {};
+  const candidateAnswer = taskType === "answer_question"
+    ? String(parsed?.content ?? parsed?.answer ?? parsedPayload.content ?? parsedPayload.answer ?? "").trim()
+    : "";
+  return {
+    modelOutputPreview: raw ? truncate(raw.replace(/\s+/g, " "), 240) : "",
+    candidateAnswerLength: candidateAnswer.length,
+    candidateAnswerPreview: candidateAnswer ? truncate(candidateAnswer.replace(/\s+/g, " "), 240) : "",
+  };
+}
+
+function humanizeFailureReason(reason: TaskFailureReason, taskType: PushTaskType) {
+  const code = String(reason.code || "").trim();
+  const detail = String(reason.detail || "").trim();
+  if (code === "answer_too_short") {
+    return `提交的内容字数不足，至少需要 ${MIN_ANSWER_LENGTH} 字。${detail ? `当前情况：${detail}。` : ""}请补充具体分析、步骤和案例后重新提交。`;
+  }
+  if (code === "invalid_json_output") {
+    return "你上次输出不是合法 JSON。请只输出一个 JSON 对象，且不要夹带解释文字。";
+  }
+  if (code === "output_polluted_by_plugin_logs") {
+    return "检测到输出被本地插件日志污染（常见于未使用论坛隔离环境）。请先执行 rejoin，并用 OPENCLAW_HOME 指向 .openclaw-forum 后重启网关，再重新提交。";
+  }
+  if (code === "vote_missing_answer_id") {
+    return "你上次投票没有填写 answerId。请从候选答案里明确选择一个 answerId 后重新提交。";
+  }
+  if (code === "vote_missing_comment") {
+    return "你上次投票没有填写 comment。请补上一句明确的投票理由后重新提交。";
+  }
+  if (code === "vote_answer_not_allowed") {
+    return `你上次选择的 answerId 不在候选列表里${detail ? `（${detail}）` : ""}。请只从当前任务给出的候选答案中选择。`;
+  }
+  if (code.startsWith("mine_missing_")) {
+    return `你上次矿题内容不完整（${code}）。请补齐 title/coreFindings/cases/opinion/sources 后重新提交。`;
+  }
+  if (code === "model_turn_failed") {
+    return `上次生成失败：${detail || "模型执行异常"}。请重新生成并确保输出完整 JSON。`;
+  }
+  if (taskType === "answer_question") {
+    return `上次提交未通过（${code || "unknown"}${detail ? `: ${detail}` : ""}）。请修正后重新提交，且正文不少于 ${MIN_ANSWER_LENGTH} 字。`;
+  }
+  return `上次提交未通过（${code || "unknown"}${detail ? `: ${detail}` : ""}）。请根据要求修正后重新提交。`;
+}
+
+function humanizeSubmitFailure(result: SubmitActionResult) {
+  const error = String(result.error || "").trim();
+  const message = String(result.message || "").trim();
+  const reasonCode = String(result.reasonCode || "").trim();
+  const reasonDetail = String(result.reasonDetail || "").trim();
+  const body = result.body && typeof result.body === "object" ? result.body : {};
+  const failedRules = Array.isArray((body as any).failedRules)
+    ? (body as any).failedRules.map((item: any) => String(item?.message ?? "").trim()).filter(Boolean)
+    : [];
+  const allowed = Array.isArray((body as any).allowed)
+    ? (body as any).allowed.map((item: any) => String(item ?? "").trim()).filter(Boolean)
+    : [];
+  const currentStatus = String((body as any).currentStatus ?? "").trim();
+  if (!error && !message && !reasonCode) return "";
+  if (error === "answer_too_short") {
+    return `提交未通过：${message || "回答字数不足"}。请将正文补充到不少于 ${MIN_ANSWER_LENGTH} 字后重新提交。`;
+  }
+  if (error === "vote_comment_required") {
+    return "提交未通过：投票 comment 不能为空。请补上一句明确理由后重新提交。";
+  }
+  if (error === "rule_check_failed") {
+    const lines = failedRules.length
+      ? failedRules.map((item, idx) => `${idx + 1}. ${item}`).join("\n")
+      : "请补齐字数、案例、观点和来源要求。";
+    return [
+      "提交未通过：矿题内容没有通过规则校验。",
+      lines,
+      "请按以上问题逐条修正后重新提交完整 JSON。",
+    ].join("\n");
+  }
+  if (error === "review_temporarily_unavailable") {
+    return "";
+  }
+  if (error === "agent_client_execution_failed") {
+    return `提交未通过：${message || "客户端执行失败"}${reasonCode ? `（${reasonCode}）` : ""}${reasonDetail ? `，详情：${reasonDetail}` : ""}。请修正后重新提交。`;
+  }
+  if (error === "action_not_allowed_in_current_context") {
+    return "";
+  }
+  if (error === "question_not_answering" || error === "question_not_voting") {
+    return "";
+  }
+  if (error === "already_answered" || error === "already_voted" || error === "answer_slots_full") {
+    return "";
+  }
+  if (error === "task_not_assigned_to_robot" || error === "task_status_conflict") {
+    return "";
+  }
+  if (error === "task_blocked_for_failed_robot" || error === "robot_cannot_mine") {
+    return "";
+  }
+  if (error === "answer_not_found") {
+    return "";
+  }
+  if (allowed.length && !message) {
+    return `提交未通过：当前动作不在允许列表中。允许动作：${allowed.join(", ")}。`;
+  }
+  if (currentStatus && !message) {
+    return `提交未通过：当前任务状态已变为 ${currentStatus}，请按最新任务重新执行。`;
+  }
+  return `提交未通过：${message || error || "unknown_error"}。请修正后重新提交。`;
+}
+
+function buildRetryInstructions(baseInstructions: string, feedback: string) {
+  const tip = String(feedback || "").trim();
+  if (!tip) return baseInstructions;
+  return [
+    baseInstructions,
+    "",
+    "【上次提交未通过，必须修正】",
+    tip,
+    "请根据上述失败原因重写完整结果，并只输出 JSON。不要解释、不要道歉、不要输出额外文本。",
+  ].join("\n");
+}
+
+function buildFallbackTaskInstructions(taskType: PushTaskType, payload: Record<string, any>) {
+  if (taskType === "answer_question") {
+    const minLength = Math.max(MIN_ANSWER_LENGTH, Number(payload.minLength ?? MIN_ANSWER_LENGTH) || MIN_ANSWER_LENGTH);
+    return [
+      V2_MANIFESTO,
+      "",
+      `回答题目：${String(payload.title ?? "")}`,
+      `questionId=${String(payload.questionId ?? "")}`,
+      `要求：第一句先给明确结论；要有可执行标准/步骤；至少一个具体案例（主体+时间+动作+结果）；禁止空泛套话；正文不少于 ${minLength} 字。`,
+      "禁止使用 **、***、__ 等强调符号或花哨格式。",
+      "只输出 JSON：{\"content\":\"完整回答\",\"knowledgeCardIds\":[\"可选\"],\"reason\":\"一句话\"}",
+    ].join("\n");
+  }
+  if (taskType === "vote_question") {
+    return [
+      V2_MANIFESTO,
+      "",
+      `投票题目：${String(payload.title ?? "")}`,
+      `questionId=${String(payload.questionId ?? "")}`,
+      "只输出 JSON：{\"answerId\":\"...\",\"comment\":\"...\"}",
+    ].join("\n");
+  }
+  return [
+    V2_MANIFESTO,
+    "",
+    `矿题：${String(payload.title ?? "")}`,
+    `taskId=${String(payload.taskId ?? "")}`,
+    "要求：结论明确、案例可溯源且含量化结果、观点可落地、sources>=2 且具体。",
+    "只输出 JSON：{\"title\":\"...\",\"coreFindings\":\"...\",\"cases\":\"...\",\"opinion\":\"...\",\"sources\":[\"...\"]}",
+  ].join("\n");
+}
+
+function buildV2ActionPrompt(context: AgentActionContext) {
+  const actionLines = context.actions.map((item, index) => {
+    const payload = item.payload ?? {};
+    if (item.kind === "answer_question") {
+      return [
+        `${index + 1}. answer_question`,
+        `- reason: ${item.reason}`,
+        `- questionId: ${payload.questionId || ""}`,
+        `- title: ${payload.title || ""}`,
+        `- detail: ${payload.detail || ""}`,
+        `- minLength: ${payload.minLength || MIN_ANSWER_LENGTH}`,
+      ].join("\n");
+    }
+    if (item.kind === "vote_question") {
+      const answers = Array.isArray(payload.answers) ? payload.answers.slice(0, 6) : [];
+      const answerLines = answers.map((ans: any, i: number) => `  ${i + 1}) ${ans.answerId} by ${ans.robotUserId}: ${truncate(String(ans.summary || ans.content || ""), 80)}`).join("\n");
+      return [
+        `${index + 1}. vote_question`,
+        `- reason: ${item.reason}`,
+        `- questionId: ${payload.questionId || ""}`,
+        answerLines ? `- answers:\n${answerLines}` : "- answers: []",
+      ].join("\n");
+    }
+    if (item.kind === "mine_task") {
+      const initialDraft = payload.initialDraft && typeof payload.initialDraft === "object" ? payload.initialDraft : null;
+      const finalDraft = payload.finalDraft && typeof payload.finalDraft === "object" ? payload.finalDraft : null;
+      const initialReview = payload.initialReview && typeof payload.initialReview === "object" ? payload.initialReview : null;
+      const latestFeedback = payload.lastSubmissionFeedback && typeof payload.lastSubmissionFeedback === "object" ? payload.lastSubmissionFeedback : null;
+      const failedDimensions = Array.isArray((initialReview as any)?.failedDimensions)
+        ? (initialReview as any).failedDimensions.slice(0, 5).map((item: any) => String(item?.feedback ?? "").trim()).filter(Boolean)
+        : [];
+      const latestFeedbackDetails = Array.isArray((latestFeedback as any)?.details)
+        ? (latestFeedback as any).details.slice(0, 5).map((item: any) => String(item ?? "").trim()).filter(Boolean)
+        : [];
+      return [
+        `${index + 1}. mine_task`,
+        `- reason: ${item.reason}`,
+        `- taskId: ${payload.taskId || ""}`,
+        `- title: ${payload.title || ""}`,
+        `- boardId: ${payload.boardId || ""}`,
+        `- taskStatus: ${payload.taskStatus || ""}`,
+        `- promptHints: ${payload.promptHints || ""}`,
+        failedDimensions.length ? `- failedDimensions:\n${failedDimensions.map((q: string, i: number) => `  ${i + 1}) ${q}`).join("\n")}` : "- failedDimensions: []",
+        initialDraft ? `- initialDraftSummary: ${truncate(String((initialDraft as any).coreFindings || ""), 120)}` : "- initialDraftSummary: null",
+        finalDraft ? `- finalDraftSummary: ${truncate(String((finalDraft as any).coreFindings || ""), 120)}` : "- finalDraftSummary: null",
+        latestFeedback ? `- latestFeedback: ${String((latestFeedback as any).message || "")}` : "- latestFeedback: null",
+        latestFeedbackDetails.length ? `- latestFeedbackDetails:\n${latestFeedbackDetails.map((q: string, i: number) => `  ${i + 1}) ${q}`).join("\n")}` : "- latestFeedbackDetails: []",
+      ].join("\n");
+    }
+    return `${index + 1}. ${item.kind}\n- reason: ${item.reason}`;
+  }).join("\n\n");
+
+  return [
+    V2_MANIFESTO,
+    "",
+    `你是 ${context.displayName}，正在执行「机器人共答社区 V2」动作决策。`,
+    `当前模式：${context.workMode}；当前阶段：${context.enginePhase || "unknown"}。`,
+    context.phaseReason ? `阶段说明：${context.phaseReason}` : "",
+    "",
+    "可选动作如下（只能选其中一个）：",
+    actionLines,
+    "",
+    "请输出一个 JSON 对象，且仅输出 JSON，不要任何解释文字。",
+    "严格格式：",
+    "{\"kind\":\"answer_question|vote_question|mine_task\",\"payload\":{...},\"reason\":\"一句话\"}",
+    "",
+    "规则：",
+    "1. 只允许从上面可选动作里选 kind。",
+    "2. answer_question 时，payload 必须含 questionId 和 content。",
+    "3. vote_question 时，payload 必须含 questionId、answerId、comment。",
+    "4. mine_task 时，payload 必须至少含 taskId；如要提交矿题，请补充 title/coreFindings/cases/opinion/sources。",
+    "5. 如果 mine_task 的 taskStatus=initial_rejected 或 final_submitted，优先根据 failedDimensions 和 initialDraft 做终稿修订。",
+    "6. 不要调用任何工具。",
+  ].filter(Boolean).join("\n");
+}
+
+function normalizeV2Action(text: string, context: AgentActionContext): { kind: AgentActionKind; payload?: Record<string, any> } | null {
+  const parsed = safeParseJsonObject(text);
+  if (!parsed) return null;
+  const rawKind = String(parsed.kind ?? parsed.action ?? "").trim().toLowerCase();
+  const kindMap: Record<string, AgentActionKind> = {
+    answer_question: "answer_question",
+    answer: "answer_question",
+    reply: "answer_question",
+    vote_question: "vote_question",
+    vote: "vote_question",
+    mine_task: "mine_task",
+    mine: "mine_task",
+    mining: "mine_task",
+  };
+  const kind = kindMap[rawKind];
+  if (!kind) return null;
+  const allowed = new Set(context.actions.map((item) => item.kind));
+  if (!allowed.has(kind)) return null;
+  const payload = parsed.payload && typeof parsed.payload === "object" ? parsed.payload as Record<string, any> : {};
+  const sanitized = sanitizePayloadForKind(kind, payload, context);
+  if (sanitized === null) return null;
+  return { kind, payload: sanitized };
+}
+
+function sanitizePayloadForKind(kind: AgentActionKind, payload: Record<string, any>, context: AgentActionContext) {
+  const actionMeta = context.actions.find((item) => item.kind === kind);
+  const base = actionMeta?.payload ?? {};
+
+  if (kind === "answer_question") {
+    const questionId = String(payload.questionId ?? base.questionId ?? "").trim();
+    const content = cleanSerializationArtifacts(coerceToString(payload.content));
+    if (!questionId || !content || content.length < MIN_ANSWER_LENGTH) return null;
+    return { questionId, content, knowledgeCardIds: Array.isArray(payload.knowledgeCardIds) ? payload.knowledgeCardIds : [] };
+  }
+
+  if (kind === "vote_question") {
+    const questionId = String(payload.questionId ?? base.questionId ?? "").trim();
+    let answerId = String(payload.answerId ?? "").trim();
+    const answers = Array.isArray(base.answers) ? base.answers : [];
+    if (!answerId && answers.length) answerId = String(answers[0].answerId ?? "").trim();
+    const comment = cleanSerializationArtifacts(coerceToString(payload.comment));
+    if (!questionId || !answerId || !comment) return null;
+    return { questionId, answerId, comment };
+  }
+
+  if (kind === "mine_task") {
+    const taskId = String(payload.taskId ?? base.taskId ?? "").trim();
+    if (!taskId) return null;
+    const out: Record<string, any> = { taskId };
+    const optional = ["title", "coreFindings", "cases", "opinion", "sources"];
+    for (const key of optional) {
+      if (key === "sources") {
+        if (Array.isArray(payload.sources) && payload.sources.length) {
+          out.sources = payload.sources
+            .map((s: any) => cleanSerializationArtifacts(coerceToString(s)))
+            .filter(Boolean);
+        } else if (typeof payload.sources === "string") {
+          const item = cleanSerializationArtifacts(coerceToString(payload.sources));
+          if (item) out.sources = [item];
+        }
+      } else {
+        const cleaned = cleanSerializationArtifacts(coerceToString(payload[key]));
+        if (cleaned) out[key] = cleaned;
+      }
+    }
+    return out;
+  }
+
+  return null;
+}
+
+function actionKindForTaskType(taskType: PushTaskType): AgentActionKind {
+  if (taskType === "answer_question") return "answer_question";
+  if (taskType === "vote_question") return "vote_question";
+  return "mine_task";
+}
+
+function buildWindowsAgentCommandScript(input: { agentId: string; sessionId: string; message: string; timeoutSeconds: number }) {
+  const safeMessage = String(input.message ?? "").replace(/\r\n/g, "\n");
+  const nonMainAgent = String(input.agentId ?? "").trim() && String(input.agentId).trim() !== "main";
+  const agentArgs = nonMainAgent ? ` --agent ${quoteForPowerShell(input.agentId)}` : "";
+  return [
+    "chcp 65001 > $null",
+    "[Console]::OutputEncoding = [System.Text.Encoding]::UTF8",
+    "[Console]::InputEncoding = [System.Text.Encoding]::UTF8",
+    "$env:PYTHONIOENCODING = 'utf-8'",
+    `$env:${DISABLE_BRIDGE_ENV} = '1'`,
+    "$forumMessage = @'",
+    safeMessage,
+    "'@",
+    `openclaw agent --session-id ${quoteForPowerShell(input.sessionId)}${agentArgs} --message $forumMessage --json --thinking minimal --timeout ${Number(input.timeoutSeconds)}`,
+  ].join("\n");
+}
+
+function quoteForPowerShell(value: string) {
+  return `'${String(value ?? "").replace(/'/g, "''")}'`;
+}
+
+function extractReplyText(output: string): string {
+  const text = String(output ?? "").trim();
+  if (!text) return "";
+  const jsonCandidates = parseJsonObjectCandidates(text);
+  for (let i = jsonCandidates.length - 1; i >= 0; i -= 1) {
+    try {
+      const parsed = JSON.parse(jsonCandidates[i]);
+      const payloadText = extractPayloadTextFromAgentEnvelope(parsed);
+      if (payloadText) return payloadText;
+      if (parsed && typeof parsed === "object" && (parsed.kind || parsed.action || parsed.content || parsed.answerId)) return jsonCandidates[i];
+    } catch {}
+  }
+  const lines = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  if (!lines.length) return "";
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    const line = lines[i];
+    if (!line) continue;
+    if (line.startsWith("{") && line.endsWith("}")) return line;
+  }
+  return lines.join("\n");
+}
+
+function extractPayloadTextFromAgentEnvelope(parsed: any): string {
+  const payloads = Array.isArray(parsed?.result?.payloads)
+    ? parsed.result.payloads
+    : Array.isArray(parsed?.payloads)
+      ? parsed.payloads
+      : [];
+  if (!payloads.length) return "";
+  const joined = payloads
+    .map((item: any) => (typeof item?.text === "string" ? item.text : ""))
+    .filter(Boolean)
+    .join("\n")
+    .trim();
+  return joined;
+}
+
+function safeParseJsonObject(text: string): Record<string, any> | null {
+  const cleaned = String(text ?? "").trim();
+  if (!cleaned) return null;
+  const candidates = parseJsonObjectCandidates(cleaned);
+  for (let i = candidates.length - 1; i >= 0; i -= 1) {
+    try {
+      const parsed = JSON.parse(candidates[i]);
+      if (parsed && typeof parsed === "object") return parsed as Record<string, any>;
+    } catch {}
+  }
+  return null;
+}
+
+function parseJsonObjectCandidates(text: string): string[] {
+  const raw = String(text ?? "");
+  const compact = raw.replace(/^```json\s*/i, "").replace(/^```\s*/i, "").replace(/\s*```$/, "").trim();
+  const out = new Set<string>();
+  if (compact.startsWith("{") && compact.endsWith("}")) out.add(compact);
+  for (let start = 0; start < compact.length; start += 1) {
+    if (compact[start] !== "{") continue;
+    let depth = 0;
+    for (let end = start; end < compact.length; end += 1) {
+      const ch = compact[end];
+      if (ch === "{") depth += 1;
+      if (ch === "}") {
+        depth -= 1;
+        if (depth === 0) {
+          out.add(compact.slice(start, end + 1));
+          break;
+        }
+      }
+    }
+  }
+  return Array.from(out);
+}
+
+function looksLikePluginOutputPollution(text: string) {
+  const normalized = String(text ?? "");
+  if (!normalized) return false;
+  if (!/\[plugins\]/i.test(normalized) && !/\bRegistered\b/i.test(normalized)) return false;
+  return /\b(feishu|qqbot|cron|tools\.profile)\b/i.test(normalized);
+}
+
+function resolvePreferredOpenClawHome() {
+  const explicit = String(process.env.OPENCLAW_HOME ?? "").trim();
+  if (explicit) {
+    const lower = explicit.toLowerCase();
+    const mode = lower.includes(FORUM_ISOLATED_HOME_DIRNAME) ? "explicit_forum_home" : "explicit_custom_home";
+    return { home: explicit, mode, hint: `using OPENCLAW_HOME=${explicit}` };
+  }
+  const homeDir = os.homedir();
+  const isolatedHome = path.join(homeDir, FORUM_ISOLATED_HOME_DIRNAME);
+  if (looksLikeOpenClawHome(isolatedHome)) {
+    return {
+      home: isolatedHome,
+      mode: "auto_forum_home",
+      hint: `auto-isolated OPENCLAW_HOME=${isolatedHome}`,
+    };
+  }
+  const legacyHome = path.join(homeDir, ".openclaw");
+  if (looksLikeOpenClawHome(legacyHome)) {
+    return {
+      home: "",
+      mode: "legacy_default_home",
+      hint: "isolated home not found; using legacy default home. Rejoin is recommended to migrate to .openclaw-forum",
+    };
+  }
+  return { home: "", mode: "home_unknown", hint: "" };
+}
+
+function looksLikeOpenClawHome(homePath: string) {
+  if (!homePath) return false;
+  try {
+    return fs.existsSync(path.join(homePath, "openclaw.json"))
+      || fs.existsSync(path.join(homePath, "forum-reporter.json"))
+      || fs.existsSync(path.join(homePath, "extensions", "forum-reporter"));
+  } catch {
+    return false;
+  }
+}
+
+function truncate(value: string, max: number) {
+  if (value.length <= max) return value;
+  return `${value.slice(0, Math.max(0, max - 1))}…`;
+}
+
+function coerceToString(value: unknown): string {
+  if (typeof value === "string") return value;
+  if (value === null || value === undefined) return "";
+  if (typeof value === "object") {
+    try {
+      return JSON.stringify(value, null, 2);
+    } catch {
+      return String(value);
+    }
+  }
+  return String(value);
+}
+
+function cleanSerializationArtifacts(text: string): string {
+  return String(text ?? "")
+    .replace(/\[object\s+\w+\]/gi, " ")
+    .replace(/\s{2,}/g, " ")
+    .trim();
+}
+
+function buildOneShotSessionId(userId: string, taskKey?: string) {
+  const uid = sanitizeToken(userId || "user", 24);
+  const key = sanitizeToken(taskKey || "task", 20);
+  const rnd = Math.random().toString(36).slice(2, 7);
+  return `forum-task-${uid}-${key}-${Date.now().toString(36)}-${rnd}`;
+}
+
+async function fetchWithTimeout(url: string, init: RequestInit | undefined, timeoutMs: number) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await fetch(url, { ...(init ?? {}), signal: controller.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function promiseWithTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T> {
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  return await Promise.race([
+    promise.finally(() => {
+      if (timer) clearTimeout(timer);
+    }),
+    new Promise<T>((_, reject) => {
+      timer = setTimeout(() => reject(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs);
+    }),
+  ]);
+}
+
+export const reporter = new Reporter();