@ryantest/openclaw-qqbot 0.0.3 → 1.6.6-alpha.0

package/src/tools/remind.ts

@@ -1,4 +1,5 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { getRequestTarget } from "../request-context.js";
 
 // ========== 类型定义 ==========
 
@@ -6,7 +7,10 @@ interface RemindParams {
   action: "add" | "list" | "remove";
   /** 提醒内容（action=add 时必填） */
   content?: string;
-  /** 目标地址，格式为上下文中的 to= 值（action=add 时必填） */
+  /**
+   * 投递目标地址（可选，系统会自动从当前会话上下文获取）。
+   * 仅在需要手动指定时填写。
+   */
   to?: string;
   /**
    * 时间描述（action=add 时必填）
@@ -40,8 +44,8 @@ const RemindSchema = {
     to: {
       type: "string",
       description:
-        "投递目标地址，取自上下文中 [QQBot] to= 的值。" +
-        "私聊格式：user_openid，群聊格式：group:group_openid。action=add 时必填。",
+        "投递目标地址（可选）。系统会自动从当前会话获取，通常无需手动填写。" +
+        "私聊格式：qqbot:c2c:user_openid，群聊格式：qqbot:group:group_openid。",
     },
     time: {
       type: "string",
@@ -130,9 +134,8 @@ function generateJobName(content: string): string {
 /**
  * 构建一次性提醒的 cron 工具参数
  */
-function buildOnceJob(params: RemindParams, delayMs: number) {
+function buildOnceJob(params: RemindParams, delayMs: number, to: string) {
   const atMs = Date.now() + delayMs;
-  const to = params.to!;
   const content = params.content!;
   const name = params.name || generateJobName(content);
 
@@ -158,8 +161,7 @@ function buildOnceJob(params: RemindParams, delayMs: number) {
 /**
  * 构建周期提醒的 cron 工具参数
  */
-function buildCronJob(params: RemindParams) {
-  const to = params.to!;
+function buildCronJob(params: RemindParams, to: string) {
   const content = params.content!;
   const name = params.name || generateJobName(content);
   const tz = params.timezone || "Asia/Shanghai";
@@ -249,8 +251,10 @@ export function registerRemindTool(api: OpenClawPluginApi): void {
         if (!p.content) {
           return json({ error: "action=add 时 content（提醒内容）为必填参数" });
         }
-        if (!p.to) {
-          return json({ error: "action=add 时 to（目标地址）为必填参数，取自上下文 [QQBot] to= 的值" });
+        // 优先使用 AI 传入的 to，否则自动从请求级上下文获取（AsyncLocalStorage）
+        const resolvedTo = p.to || getRequestTarget();
+        if (!resolvedTo) {
+          return json({ error: "action=add 时无法确定投递目标地址。请稍后重试。" });
         }
         if (!p.time) {
           return json({ error: "action=add 时 time（时间）为必填参数。示例：\"5m\"、\"1h30m\"、\"0 8 * * *\"" });
@@ -259,7 +263,7 @@ export function registerRemindTool(api: OpenClawPluginApi): void {
         // 判断是 cron 表达式还是相对时间
         if (isCronExpression(p.time)) {
           // 周期提醒
-          const cronJob = buildCronJob(p);
+          const cronJob = buildCronJob(p, resolvedTo);
           return json({
             _instruction: "请立即使用 cron 工具执行以下参数，然后回复用户提醒已设置",
             cronParams: cronJob,
@@ -281,7 +285,7 @@ export function registerRemindTool(api: OpenClawPluginApi): void {
           return json({ error: "提醒时间不能少于 30 秒" });
         }
 
-        const onceJob = buildOnceJob(p, delayMs);
+        const onceJob = buildOnceJob(p, delayMs, resolvedTo);
         return json({
           _instruction: "请立即使用 cron 工具执行以下参数，然后回复用户提醒已设置",
           cronParams: onceJob,

package/src/types.ts

@@ -70,6 +70,46 @@ export interface QQBotAccountConfig {
    * - "hot-reload"：检测到新版本时直接执行 npm 升级脚本进行热更新
    */
   upgradeMode?: "doc" | "hot-reload";
+  /**
+   * 出站消息合并回复（debounce）配置
+   * 当短时间内收到多次 deliver 时，将文本合并为一条消息发送，避免消息轰炸
+   */
+  deliverDebounce?: DeliverDebounceConfig;
+  /**
+   * 是否启用流式消息（默认 false）
+   * 启用后，AI 的回复会以流式形式逐步显示在 QQ 聊天中，
+   * 用户可以看到文字逐字出现的打字机效果。
+   * 设置为 true 可开启流式消息。
+   * 
+   * 注意：仅 C2C（私聊）支持流式消息 API。
+   */
+  streaming?: boolean;
+}
+
+/**
+ * 出站消息合并回复配置
+ */
+export interface DeliverDebounceConfig {
+  /**
+   * 是否启用合并回复（默认 true）
+   */
+  enabled?: boolean;
+  /**
+   * 合并窗口时长（毫秒），在此时间内的连续 deliver 会被合并
+   * 默认 1500ms
+   */
+  windowMs?: number;
+  /**
+   * 最大等待时长（毫秒），从第一条 deliver 开始计算，超过此时间强制发送
+   * 防止持续有新 deliver 导致一直不发送
+   * 默认 8000ms
+   */
+  maxWaitMs?: number;
+  /**
+   * 合并文本之间的分隔符
+   * 默认 "\n\n---\n\n"
+   */
+  separator?: string;
 }
 
 /**
@@ -181,3 +221,74 @@ export interface WSPayload {
   s?: number;
   t?: string;
 }
+
+
+
+// ---- 流式消息常量 ----
+
+/** 流式消息输入模式 */
+export const StreamInputMode = {
+  /** 每次发送的 content_raw 替换整条消息内容 */
+  REPLACE: "replace",
+} as const;
+export type StreamInputMode = (typeof StreamInputMode)[keyof typeof StreamInputMode];
+
+/** 流式消息输入状态 */
+export const StreamInputState = {
+  /** 正文生成中 */
+  GENERATING: 1,
+  /** 正文生成结束（终结状态） */
+  DONE: 10,
+} as const;
+export type StreamInputState = (typeof StreamInputState)[keyof typeof StreamInputState];
+
+/** 流式消息内容类型 */
+export const StreamContentType = {
+  MARKDOWN: "markdown",
+} as const;
+export type StreamContentType = (typeof StreamContentType)[keyof typeof StreamContentType];
+
+/**
+ * 流式消息请求体
+ * 对应 StreamReq proto
+ */
+export interface StreamMessageRequest {
+  /** 输入模式 */
+  input_mode: StreamInputMode;
+  /** 输入状态 */
+  input_state: StreamInputState;
+  /** 内容类型 */
+  content_type: StreamContentType;
+  /** markdown 内容 */
+  content_raw: string;
+  /** 事件 ID */
+  event_id: string;
+  /** 原始消息 ID */
+  msg_id: string;
+  /** 流式消息 ID，首次发送后返回，后续分片需携带 */
+  stream_msg_id?: string;
+  /** 递增序号 */
+  msg_seq: number;
+  /** 同一条流式会话内的发送索引，从 0 开始，每次发送前递增；新流式会话重新从 0 开始 */
+  index: number;
+}
+
+/**
+ * 流式消息响应体
+ * 对应 StreamRsp proto
+ * 
+ * 成功时返回：{ id, timestamp, extInfo }（无 code/message）
+ * 失败时返回：{ code, message }（code > 0）
+ */
+export interface StreamMessageResponse {
+  /** 错误码，仅失败时存在（> 0 表示失败）；成功时不存在 */
+  code?: number;
+  /** 错误信息，仅失败时存在 */
+  message?: string;
+  /** 流式消息 ID */
+  id?: string;
+  /** 时间戳 */
+  timestamp?: string;
+  /** 扩展信息 */
+  extInfo?: Record<string, unknown>;
+}

package/src/update-checker.ts

@@ -10,6 +10,7 @@
 
 import { createRequire } from "node:module";
 import https from "node:https";
+import { getPackageVersion } from "./utils/pkg-version.js";
 
 const require = createRequire(import.meta.url);
 
@@ -21,13 +22,7 @@ const REGISTRIES = [
   `https://registry.npmmirror.com/${ENCODED_PKG}`,
 ];
 
-let CURRENT_VERSION = "unknown";
-try {
-  const pkg = require("../package.json");
-  CURRENT_VERSION = pkg.version ?? "unknown";
-} catch {
-  // fallback
-}
+let CURRENT_VERSION = getPackageVersion(import.meta.url);
 
 export interface UpdateInfo {
   current: string;

package/src/utils/audio-convert.ts

@@ -517,6 +517,62 @@ export async function audioFileToSilkBase64(filePath: string, directUploadFormat
   return null;
 }
 
+/**
+ * 将音频文件转码为 SILK，**输出到临时文件**（供分片上传使用）。
+ *
+ * 如果文件已经是 QQ 原生格式（WAV/MP3/SILK）或已经是 SILK 编码，
+ * 则直接返回原文件路径（不需要转码）。
+ *
+ * @returns 转码后的文件路径，或 null 表示转码失败
+ */
+export async function audioFileToSilkFile(filePath: string, directUploadFormats?: string[]): Promise<string | null> {
+  if (!fs.existsSync(filePath)) return null;
+
+  const buf = fs.readFileSync(filePath);
+  if (buf.length === 0) {
+    console.error(`[audio-convert] file is empty: ${filePath}`);
+    return null;
+  }
+
+  const ext = path.extname(filePath).toLowerCase();
+
+  // 0. 直传格式 → 直接返回原文件
+  const uploadFormats = directUploadFormats ? normalizeFormats(directUploadFormats) : QQ_NATIVE_UPLOAD_FORMATS;
+  if (uploadFormats.includes(ext)) {
+    console.log(`[audio-convert] direct upload (QQ native format): ${ext} (${buf.length} bytes)`);
+    return filePath;
+  }
+
+  // 1. 已经是 SILK 编码 → 直接返回原文件
+  if ([".slk", ".slac"].includes(ext)) {
+    const stripped = stripAmrHeader(buf);
+    const raw = new Uint8Array(stripped.buffer, stripped.byteOffset, stripped.byteLength);
+    if (isSilk(raw)) {
+      console.log(`[audio-convert] SILK file, direct use: ${filePath} (${buf.length} bytes)`);
+      return filePath;
+    }
+  }
+  const rawCheck = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+  const strippedCheck = stripAmrHeader(buf);
+  const strippedRaw = new Uint8Array(strippedCheck.buffer, strippedCheck.byteOffset, strippedCheck.byteLength);
+  if (isSilk(rawCheck) || isSilk(strippedRaw)) {
+    console.log(`[audio-convert] SILK detected by header: ${filePath} (${buf.length} bytes)`);
+    return filePath;
+  }
+
+  // 需要转码 → 调用 audioFileToSilkBase64 获取结果，写入临时文件
+  const silkBase64 = await audioFileToSilkBase64(filePath, directUploadFormats);
+  if (!silkBase64) return null;
+
+  const silkBuffer = Buffer.from(silkBase64, "base64");
+  const os = await import("node:os");
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "voice-silk-"));
+  const tmpFile = path.join(tmpDir, `voice${Date.now()}.silk`);
+  fs.writeFileSync(tmpFile, silkBuffer);
+  console.log(`[audio-convert] SILK written to temp file: ${tmpFile} (${silkBuffer.length} bytes)`);
+  return tmpFile;
+}
+
 /**
  * 等待文件就绪（轮询直到文件出现且大小稳定）
  * 用于 TTS 生成后等待文件写入完成