@downcity/plugins 1.0.216 → 1.0.236

package/src/chat/channels/qq/QQ.ts

@@ -9,7 +9,7 @@
  */
 
 import { BaseChatChannel } from "@/chat/channels/BaseChatChannel.js";
-import { parseChatMessageMarkup } from "@downcity/agent";
+import { parse_chat_message_markup } from "@downcity/agent";
 import { QqInboundDedupeStore } from "./QQInboundDedupe.js";
 import { getQqEventCaptureConfig } from "./QQEventCapture.js";
 import { QQGatewayClient } from "./QQGatewayClient.js";
@@ -28,7 +28,7 @@ import type {
   ChannelChatKeyParams,
   ChannelSendTextParams,
 } from "@/chat/channels/BaseChatChannel.js";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject } from "@downcity/agent";
 import type { ChatChannelTestResult } from "@/chat/types/ChannelStatus.js";
 import type { QQConfig, QQMessageData } from "@/chat/channels/qq/types/QqChannel.js";
@@ -48,7 +48,7 @@ export class QQBot extends BaseChatChannel {
   private botDisplayName = "";
 
   constructor(
-    context: AgentContext,
+    context: PluginContext,
     appId: string,
     appSecret: string,
     useSandbox: boolean = false,
@@ -90,26 +90,26 @@ export class QQBot extends BaseChatChannel {
   protected async sendTextToPlatform(
     params: ChannelSendTextParams,
   ): Promise<void> {
-    const parsedMessage = parseChatMessageMarkup(String(params.text ?? ""));
+    const parsedMessage = parse_chat_message_markup(String(params.text ?? ""));
     if (parsedMessage.files.length > 0) {
       throw new Error("QQ outbound attachment is not supported yet.");
     }
 
     const chatType = typeof params.chatType === "string" ? params.chatType : "";
-    const messageId =
-      typeof params.messageId === "string" ? params.messageId : "";
-    if (!chatType || !messageId) {
-      throw new Error("QQ requires chatType + messageId to send a reply");
+    const message_id =
+      typeof params.message_id === "string" ? params.message_id : "";
+    if (!chatType || !message_id) {
+      throw new Error("QQ requires chatType + message_id to send a reply");
     }
 
-    const key = `${chatType}:${params.chatId}:${messageId}`;
+    const key = `${chatType}:${params.chatId}:${message_id}`;
     const nextSeq = (this.msgSeqByMessageKey.get(key) ?? 0) + 1;
     this.msgSeqByMessageKey.set(key, nextSeq);
     await this.gateway.sendMessage(
       params.chatId,
       chatType,
-      messageId,
-      parsedMessage.bodyText,
+      message_id,
+      parsedMessage.body_text,
       nextSeq,
     );
   }
@@ -278,8 +278,8 @@ export class QQBot extends BaseChatChannel {
       },
       buildAccessBlockedText: (params) =>
         this.buildAccessBlockedText(params),
-      shouldSkipDuplicatedInboundMessage: async (eventType, messageId) =>
-        await this.shouldSkipDuplicatedInboundMessage(eventType, messageId),
+      shouldSkipDuplicatedInboundMessage: async (eventType, message_id) =>
+        await this.shouldSkipDuplicatedInboundMessage(eventType, message_id),
       enqueueAuditMessage: async (params) => {
         await this.enqueueAuditMessage(params);
       },
@@ -287,7 +287,7 @@ export class QQBot extends BaseChatChannel {
         await this.handleCommand(
           params.chatId,
           params.chatType,
-          params.messageId,
+          params.message_id,
           params.command,
         );
       },
@@ -295,7 +295,7 @@ export class QQBot extends BaseChatChannel {
         await this.executeAndReply(
           params.chatId,
           params.chatType,
-          params.messageId,
+          params.message_id,
           params.instructions,
           params.actor,
           params.chatTitle,
@@ -310,19 +310,19 @@ export class QQBot extends BaseChatChannel {
    */
   private async shouldSkipDuplicatedInboundMessage(
     eventType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
   ): Promise<boolean> {
-    const id = typeof messageId === "string" ? messageId.trim() : "";
+    const id = typeof message_id === "string" ? message_id.trim() : "";
     if (!id) return false;
     const duplicated = await this.inboundDedupeStore.markAndCheckDuplicate({
       eventType,
-      messageId: id,
+      message_id: id,
     });
     if (!duplicated) return false;
 
     this.logger.info("忽略重复入站消息", {
       eventType,
-      messageId: id,
+      message_id: id,
     });
     return true;
   }
@@ -333,7 +333,7 @@ export class QQBot extends BaseChatChannel {
   private async handleCommand(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     command: string,
   ): Promise<void> {
     this.logger.info(`收到命令: ${command}`);
@@ -344,7 +344,7 @@ export class QQBot extends BaseChatChannel {
         chatType,
       });
     }
-    await this.gateway.sendMessage(chatId, chatType, messageId, action.responseText);
+    await this.gateway.sendMessage(chatId, chatType, message_id, action.responseText);
   }
 
   /**
@@ -353,7 +353,7 @@ export class QQBot extends BaseChatChannel {
   private async executeAndReply(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     instructions: string,
     actor?: QqMessageActor,
     chatTitle?: string,
@@ -363,8 +363,8 @@ export class QQBot extends BaseChatChannel {
         chatId,
         text: instructions,
         chatType,
-        messageId,
-        ...(actor?.userId ? { userId: actor.userId } : {}),
+        message_id,
+        ...(actor?.user_id ? { user_id: actor.user_id } : {}),
         ...(actor?.username ? { username: actor.username } : {}),
         ...(chatTitle ? { chatTitle } : {}),
       });
@@ -372,7 +372,7 @@ export class QQBot extends BaseChatChannel {
       await this.gateway.sendMessage(
         chatId,
         chatType,
-        messageId,
+        message_id,
         `❌ 执行错误: ${String(error)}`,
         1,
       );
@@ -385,7 +385,7 @@ export class QQBot extends BaseChatChannel {
  */
 export async function createQQBot(
   config: QQConfig,
-  context: AgentContext,
+  context: PluginContext,
 ): Promise<QQBot | null> {
   if (!config.enabled || !config.appId || !config.appSecret) {
     return null;

package/src/chat/channels/qq/QQEventCapture.ts

@@ -14,7 +14,7 @@ import type { QQEventCaptureConfig, QQEventCaptureMode, QQGatewayPayload } from
 /**
  * 读取 QQ 原始事件捕获配置。
  */
-export function getQqEventCaptureConfig(projectRoot: string): QQEventCaptureConfig {
+export function getQqEventCaptureConfig(project_root: string): QQEventCaptureConfig {
   const raw = String(process.env.SHIP_QQ_CAPTURE_EVENTS ?? "")
     .trim()
     .toLowerCase();
@@ -22,7 +22,7 @@ export function getQqEventCaptureConfig(projectRoot: string): QQEventCaptureConf
     return {
       enabled: false,
       mode: "dispatch",
-      dir: join(projectRoot, ".downcity", ".debug", "qq-events"),
+      dir: join(project_root, ".downcity", ".debug", "qq-events"),
     };
   }
 
@@ -32,7 +32,7 @@ export function getQqEventCaptureConfig(projectRoot: string): QQEventCaptureConf
     typeof process.env.SHIP_QQ_CAPTURE_DIR === "string" &&
     process.env.SHIP_QQ_CAPTURE_DIR.trim()
       ? process.env.SHIP_QQ_CAPTURE_DIR.trim()
-      : join(projectRoot, ".downcity", ".debug", "qq-events");
+      : join(project_root, ".downcity", ".debug", "qq-events");
 
   return {
     enabled: true,

package/src/chat/channels/qq/QQGatewayAuth.ts

@@ -107,7 +107,7 @@ export interface TestQqGatewayConnectionParams {
   /**
    * 当探活发现异常时触发重连的回调。
    */
-  requestReconnect: (reason: string, delayMs?: number) => void;
+  requestReconnect: (reason: string, delay_ms?: number) => void;
 }
 
 /**

package/src/chat/channels/qq/QQGatewayClient.ts

@@ -162,8 +162,8 @@ export class QQGatewayClient {
       apiBase: this.getApiBase(),
       getAuthToken: () => this.getAuthToken(),
       getExecutorStatus: () => this.getExecutorStatus(),
-      requestReconnect: (reason, delayMs) => {
-        this.requestReconnect(reason, delayMs);
+      requestReconnect: (reason, delay_ms) => {
+        this.requestReconnect(reason, delay_ms);
       },
     });
   }
@@ -203,8 +203,8 @@ export class QQGatewayClient {
   /**
    * 请求一次重连。
    */
-  requestReconnect(reason: string, delayMs?: number): void {
-    this.scheduleReconnect(reason, delayMs);
+  requestReconnect(reason: string, delay_ms?: number): void {
+    this.scheduleReconnect(reason, delay_ms);
   }
 
   /**
@@ -213,7 +213,7 @@ export class QQGatewayClient {
   async sendMessage(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     text: string,
     msgSeq: number = 1,
   ): Promise<void> {
@@ -223,7 +223,7 @@ export class QQGatewayClient {
         apiBase: this.getApiBase(),
         chatId,
         chatType,
-        messageId,
+        message_id,
         text,
         msgSeq,
         maxAttempts: this.sendMaxAttempts,
@@ -231,7 +231,7 @@ export class QQGatewayClient {
         getAuthToken: () => this.getAuthToken(),
         clearAccessTokenCache: () => this.clearAccessTokenCache(),
         closeSocketForRecovery: (reason) => this.closeSocketForRecovery(reason),
-        scheduleReconnect: (reason, delayMs) => this.scheduleReconnect(reason, delayMs),
+        scheduleReconnect: (reason, delay_ms) => this.scheduleReconnect(reason, delay_ms),
       });
     } catch (error) {
       this.logger.error("发送 QQ 消息失败", { error: String(error) });
@@ -297,7 +297,7 @@ export class QQGatewayClient {
   /**
    * 计划一次重连。
    */
-  private scheduleReconnect(reason: string, delayMs?: number): void {
+  private scheduleReconnect(reason: string, delay_ms?: number): void {
     if (!this.isRunning) return;
     if (this.reconnectAttempts >= this.maxReconnectAttempts) {
       this.logger.error("QQ 重连次数已达上限，停止自动重连", {
@@ -309,8 +309,8 @@ export class QQGatewayClient {
     }
 
     const delay =
-      typeof delayMs === "number" && Number.isFinite(delayMs)
-        ? Math.max(0, Math.trunc(delayMs))
+      typeof delay_ms === "number" && Number.isFinite(delay_ms)
+        ? Math.max(0, Math.trunc(delay_ms))
         : 5000 * (this.reconnectAttempts + 1);
 
     if (this.reconnectTimer) {
@@ -376,8 +376,8 @@ export class QQGatewayClient {
       resetReconnectAttempts: () => {
         this.reconnectAttempts = 0;
       },
-      scheduleReconnect: (reason, delayMs) =>
-        this.scheduleReconnect(reason, delayMs),
+      scheduleReconnect: (reason, delay_ms) =>
+        this.scheduleReconnect(reason, delay_ms),
       handlePayload: async (payload) => {
         await handleQqGatewayPayload({
           logger: this.logger,

package/src/chat/channels/qq/QQGatewayConnection.ts

@@ -59,7 +59,7 @@ export interface ConnectQqGatewayWebSocketParams {
   /**
    * 计划重连。
    */
-  scheduleReconnect(reason: string, delayMs?: number): void;
+  scheduleReconnect(reason: string, delay_ms?: number): void;
   /**
    * 处理已解析的 Gateway payload。
    */

package/src/chat/channels/qq/QQGatewaySend.ts

@@ -51,7 +51,7 @@ export interface SendQqMessageWithRetryParams {
   /**
    * 原始消息 ID。
    */
-  messageId: string;
+  message_id: string;
   /**
    * 文本内容。
    */
@@ -83,7 +83,7 @@ export interface SendQqMessageWithRetryParams {
   /**
    * 发送失败后触发重连的回调。
    */
-  scheduleReconnect: (reason: string, delayMs?: number) => void;
+  scheduleReconnect: (reason: string, delay_ms?: number) => void;
 }
 
 function buildQqSendRequest(params: {
@@ -102,7 +102,7 @@ function buildQqSendRequest(params: {
   /**
    * 原始消息 ID。
    */
-  messageId: string;
+  message_id: string;
   /**
    * 文本内容。
    */
@@ -116,7 +116,7 @@ function buildQqSendRequest(params: {
   const body: QQSendMessageBody = {
     content: params.text,
     msg_type: 0,
-    msg_id: params.messageId,
+    msg_id: params.message_id,
     msg_seq: params.msgSeq,
   };
 
@@ -209,7 +209,7 @@ export async function sendQqMessageWithRetry(
     apiBase: params.apiBase,
     chatId: params.chatId,
     chatType: params.chatType,
-    messageId: params.messageId,
+    message_id: params.message_id,
     text: params.text,
     msgSeq: params.msgSeq,
   });
@@ -244,7 +244,7 @@ export async function sendQqMessageWithRetry(
         maxAttempts: params.maxAttempts,
         chatType: params.chatType,
         chatId: params.chatId,
-        messageId: params.messageId,
+        message_id: params.message_id,
         error: errorText,
       });
       params.clearAccessTokenCache();

package/src/chat/channels/qq/QQInbound.ts

@@ -144,21 +144,21 @@ export function extractQqAuthorIdentity(
     author?.user?.name,
     rawAuthor.nick,
     rawAuthor.display_name,
-    rawAuthor.displayName,
+    rawAuthor.display_name,
     rawAuthor.member_nick,
     rawAuthor.memberNick,
     rawAuthor.card,
     rawAuthor.remark,
     rawAuthorUser.nick,
     rawAuthorUser.display_name,
-    rawAuthorUser.displayName,
+    rawAuthorUser.display_name,
     rawData.nickname,
     rawData.username,
     rawData.nick,
     rawData.user_name,
     rawData.userName,
     rawData.display_name,
-    rawData.displayName,
+    rawData.display_name,
     rawSender.nickname,
     rawSender.username,
     rawSender.nick,
@@ -171,7 +171,7 @@ export function extractQqAuthorIdentity(
     rawMember.card,
   ];
 
-  const userId = userIdCandidates
+  const user_id = userIdCandidates
     .map((value) => (typeof value === "string" ? value.trim() : ""))
     .find(Boolean);
   const username = usernameCandidates
@@ -179,7 +179,7 @@ export function extractQqAuthorIdentity(
     .find(Boolean);
 
   return {
-    ...(userId ? { userId } : {}),
+    ...(user_id ? { user_id } : {}),
     ...(username ? { username } : {}),
   };
 }

package/src/chat/channels/qq/QQInboundDedupe.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 解决 QQ 网关在重连 / 重启后可能重复投递历史消息的问题。
- * - 去重 key 采用 `eventType:messageId`，避免跨事件类型冲突。
+ * - 去重 key 采用 `eventType:message_id`，避免跨事件类型冲突。
  * - 使用本地文件持久化，保证“重启后”仍可去重（best-effort）。
  */
 
@@ -78,14 +78,14 @@ export class QqInboundDedupeStore {
    */
   async markAndCheckDuplicate(params: {
     eventType: string;
-    messageId: string;
+    message_id: string;
   }): Promise<boolean> {
     await this.load();
     const eventType = String(params.eventType || "").trim();
-    const messageId = String(params.messageId || "").trim();
-    if (!eventType || !messageId) return false;
+    const message_id = String(params.message_id || "").trim();
+    if (!eventType || !message_id) return false;
 
-    const dedupeKey = `${eventType}:${messageId}`;
+    const dedupeKey = `${eventType}:${message_id}`;
     if (this.ids.has(dedupeKey)) return true;
 
     this.ids.add(dedupeKey);
@@ -113,7 +113,7 @@ export class QqInboundDedupeStore {
       await fs.ensureDir(path.dirname(this.filePath));
       const payload: QqInboundDedupeSnapshotV1 = {
         v: 1,
-        updatedAt: Date.now(),
+        updated_at: Date.now(),
         ids: Array.from(this.ids),
       };
       await fs.writeJson(this.filePath, payload, { spaces: 2 });