@tencent-connect/openclaw-qqbot 1.7.1 → 2.0.0

package/src/stt.ts

@@ -1,86 +0,0 @@
-/**
- * 通用 OpenAI 兼容 STT（语音转文字）
- *
- * 为什么在插件侧做 STT 而不走框架管道？
- * 框架的 applyMediaUnderstanding 同时执行 runCapability("audio") 和 extractFileBlocks。
- * 后者会把 WAV 文件的 PCM 二进制当文本注入 Body（looksLikeUtf8Text 误判），导致 context 爆炸。
- * 在插件侧完成 STT 后不把 WAV 放入 MediaPaths，即可规避此框架 bug。
- *
- * 配置解析策略（与 TTS 统一的两级回退）：
- * 1. 优先 channels.qqbot.stt（插件专属配置）
- * 2. 回退 tools.media.audio.models[0]（框架级配置）
- * 3. 再从 models.providers.[provider] 继承 apiKey/baseUrl
- * 4. 支持任何 OpenAI 兼容的 STT 服务
- */
-
-import * as fs from "node:fs";
-import path from "node:path";
-import { sanitizeFileName } from "./utils/platform.js";
-
-export interface STTConfig {
-  baseUrl: string;
-  apiKey: string;
-  model: string;
-}
-
-export function resolveSTTConfig(cfg: Record<string, unknown>): STTConfig | null {
-  const c = cfg as any;
-
-  // 优先使用 channels.qqbot.stt（插件专属配置）
-  const channelStt = c?.channels?.qqbot?.stt;
-  if (channelStt && channelStt.enabled !== false) {
-    const providerId: string = channelStt?.provider || "openai";
-    const providerCfg = c?.models?.providers?.[providerId];
-    const baseUrl: string | undefined = channelStt?.baseUrl || providerCfg?.baseUrl;
-    const apiKey: string | undefined = channelStt?.apiKey || providerCfg?.apiKey;
-    const model: string = channelStt?.model || "whisper-1";
-    if (baseUrl && apiKey) {
-      return { baseUrl: baseUrl.replace(/\/+$/, ""), apiKey, model };
-    }
-  }
-
-  // 回退到 tools.media.audio.models[0]（框架级配置）
-  const audioModelEntry = c?.tools?.media?.audio?.models?.[0];
-  if (audioModelEntry) {
-    const providerId: string = audioModelEntry?.provider || "openai";
-    const providerCfg = c?.models?.providers?.[providerId];
-    const baseUrl: string | undefined = audioModelEntry?.baseUrl || providerCfg?.baseUrl;
-    const apiKey: string | undefined = audioModelEntry?.apiKey || providerCfg?.apiKey;
-    const model: string = audioModelEntry?.model || "whisper-1";
-    if (baseUrl && apiKey) {
-      return { baseUrl: baseUrl.replace(/\/+$/, ""), apiKey, model };
-    }
-  }
-
-  return null;
-}
-
-export async function transcribeAudio(audioPath: string, cfg: Record<string, unknown>): Promise<string | null> {
-  const sttCfg = resolveSTTConfig(cfg);
-  if (!sttCfg) return null;
-
-  const fileBuffer = fs.readFileSync(audioPath);
-  const fileName = sanitizeFileName(path.basename(audioPath));
-  const mime = fileName.endsWith(".wav") ? "audio/wav"
-    : fileName.endsWith(".mp3") ? "audio/mpeg"
-    : fileName.endsWith(".ogg") ? "audio/ogg"
-    : "application/octet-stream";
-
-  const form = new FormData();
-  form.append("file", new Blob([fileBuffer], { type: mime }), fileName);
-  form.append("model", sttCfg.model);
-
-  const resp = await fetch(`${sttCfg.baseUrl}/audio/transcriptions`, {
-    method: "POST",
-    headers: { "Authorization": `Bearer ${sttCfg.apiKey}` },
-    body: form,
-  });
-
-  if (!resp.ok) {
-    const detail = await resp.text().catch(() => "");
-    throw new Error(`STT failed (HTTP ${resp.status}): ${detail.slice(0, 300)}`);
-  }
-
-  const result = await resp.json() as { text?: string };
-  return result.text?.trim() || null;
-}

package/src/tools/channel.ts

@@ -1,281 +0,0 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { resolveQQBotAccount } from "../config.js";
-import { listQQBotAccountIds } from "../config.js";
-import { getAccessToken } from "../api.js";
-
-// ========== 常量 ==========
-
-const API_BASE = "https://api.sgroup.qq.com";
-
-const DEFAULT_TIMEOUT_MS = 30000;
-
-// ========== 类型定义 ==========
-
-interface ChannelApiParams {
-  method: string;
-  path: string;
-  body?: Record<string, unknown>;
-  query?: Record<string, string>;
-}
-
-// ========== JSON Schema ==========
-
-const ChannelApiSchema = {
-  type: "object",
-  properties: {
-    method: {
-      type: "string",
-      description:
-        "HTTP 请求方法。可选值：GET, POST, PUT, PATCH, DELETE",
-      enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
-    },
-    path: {
-      type: "string",
-      description:
-        "API 路径（不含域名），占位符需替换为实际值。" +
-        "示例：/users/@me/guilds, /guilds/{guild_id}/channels, /channels/{channel_id}",
-    },
-    body: {
-      type: "object",
-      description:
-        "请求体（JSON），用于 POST/PUT/PATCH 请求。" +
-        "GET/DELETE 请求不需要此参数。",
-    },
-    query: {
-      type: "object",
-      description:
-        "URL 查询参数（键值对），会拼接到路径后面。" +
-        "如 { \"limit\": \"100\", \"after\": \"0\" } 会拼接为 ?limit=100&after=0",
-      additionalProperties: { type: "string" },
-    },
-  },
-  required: ["method", "path"],
-} as const;
-
-// ========== 工具函数 ==========
-
-function json(data: unknown) {
-  return {
-    content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }],
-    details: data,
-  };
-}
-
-/**
- * 构建完整的请求 URL
- */
-function buildUrl(path: string, query?: Record<string, string>): string {
-  let url = `${API_BASE}${path}`;
-  if (query && Object.keys(query).length > 0) {
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(query)) {
-      if (value !== undefined && value !== null && value !== "") {
-        params.set(key, value);
-      }
-    }
-    const qs = params.toString();
-    if (qs) {
-      url += `?${qs}`;
-    }
-  }
-  return url;
-}
-
-/**
- * 校验 path 防止 SSRF
- */
-function validatePath(path: string): string | null {
-  if (!path.startsWith("/")) {
-    return "path 必须以 / 开头";
-  }
-  if (path.includes("..") || path.includes("//")) {
-    return "path 不允许包含 .. 或 //";
-  }
-  // 只允许合法的 URL path 字符
-  if (!/^\/[a-zA-Z0-9\-._~:@!$&'()*+,;=/%]+$/.test(path) && path !== "/") {
-    return "path 包含非法字符";
-  }
-  return null;
-}
-
-// ========== 注册入口 ==========
-
-/**
- * 注册 QQ 频道 API 代理工具。
- *
- * 该工具作为 QQ 开放平台频道 API 的 HTTP 代理，自动处理 Token 鉴权。
- * AI 通过 skill 文档了解各接口的路径、方法和参数，构造请求后由此工具代理发送。
- *
- * 支持的能力：
- * - 频道管理（Guild）
- * - 子频道管理（Channel）
- * - 成员管理（Member）
- * - 公告管理（Announces）
- * - 论坛管理（Forum Thread）
- * - 日程管理（Schedule）
- */
-export function registerChannelTool(api: OpenClawPluginApi): void {
-  const cfg = api.config;
-  if (!cfg) {
-    console.log("[qqbot-channel-api] No config available, skipping");
-    return;
-  }
-
-  const accountIds = listQQBotAccountIds(cfg);
-  if (accountIds.length === 0) {
-    console.log("[qqbot-channel-api] No QQBot accounts configured, skipping");
-    return;
-  }
-
-  const firstAccountId = accountIds[0];
-  const account = resolveQQBotAccount(cfg, firstAccountId);
-
-  if (!account.appId || !account.clientSecret) {
-    console.log("[qqbot-channel-api] Account not fully configured, skipping");
-    return;
-  }
-
-  api.registerTool(
-    {
-      name: "qqbot_channel_api",
-      label: "QQBot Channel API",
-      description:
-        "QQ 开放平台频道 API HTTP 代理，自动填充鉴权 Token。" +
-        "常用接口速查：" +
-        "频道列表 GET /users/@me/guilds | " +
-        "子频道列表 GET /guilds/{guild_id}/channels | " +
-        "子频道详情 GET /channels/{channel_id} | " +
-        "创建子频道 POST /guilds/{guild_id}/channels | " +
-        "成员列表 GET /guilds/{guild_id}/members?after=0&limit=100 | " +
-        "成员详情 GET /guilds/{guild_id}/members/{user_id} | " +
-        "帖子列表 GET /channels/{channel_id}/threads | " +
-        "发帖 PUT /channels/{channel_id}/threads | " +
-        "创建公告 POST /guilds/{guild_id}/announces | " +
-        "创建日程 POST /channels/{channel_id}/schedules。" +
-        "更多接口和参数详情请阅读 qqbot-channel skill。",
-      parameters: ChannelApiSchema,
-      async execute(_toolCallId, params) {
-        const p = params as ChannelApiParams;
-
-        // 参数校验
-        if (!p.method) {
-          return json({ error: "method 为必填参数" });
-        }
-        if (!p.path) {
-          return json({ error: "path 为必填参数" });
-        }
-
-        const method = p.method.toUpperCase();
-        if (!["GET", "POST", "PUT", "PATCH", "DELETE"].includes(method)) {
-          return json({ error: `不支持的 HTTP 方法: ${method}，可选值：GET, POST, PUT, PATCH, DELETE` });
-        }
-
-        // 路径安全校验
-        const pathError = validatePath(p.path);
-        if (pathError) {
-          return json({ error: pathError });
-        }
-
-        // GET/DELETE 不应有 body
-        if ((method === "GET" || method === "DELETE") && p.body && Object.keys(p.body).length > 0) {
-          console.log(`[qqbot-channel-api] ${method} request with body, body will be ignored`);
-        }
-
-        try {
-          // 获取鉴权 Token
-          const accessToken = await getAccessToken(account.appId, account.clientSecret);
-
-          // 构建请求
-          const url = buildUrl(p.path, p.query);
-          const headers: Record<string, string> = {
-            Authorization: `QQBot ${accessToken}`,
-            "Content-Type": "application/json",
-          };
-
-          const controller = new AbortController();
-          const timeoutId = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
-
-          const fetchOptions: RequestInit = {
-            method,
-            headers,
-            signal: controller.signal,
-          };
-
-          // POST/PUT/PATCH 才发送 body
-          if (p.body && ["POST", "PUT", "PATCH"].includes(method)) {
-            fetchOptions.body = JSON.stringify(p.body);
-          }
-
-          console.log(`[qqbot-channel-api] >>> ${method} ${url} (timeout: ${DEFAULT_TIMEOUT_MS}ms)`);
-
-          let res: Response;
-          try {
-            res = await fetch(url, fetchOptions);
-          } catch (err) {
-            clearTimeout(timeoutId);
-            if (err instanceof Error && err.name === "AbortError") {
-              console.error(`[qqbot-channel-api] <<< Request timeout after ${DEFAULT_TIMEOUT_MS}ms`);
-              return json({ error: `请求超时（${DEFAULT_TIMEOUT_MS}ms）`, path: p.path });
-            }
-            console.error(`[qqbot-channel-api] <<< Network error:`, err);
-            return json({
-              error: `网络错误: ${err instanceof Error ? err.message : String(err)}`,
-              path: p.path,
-            });
-          } finally {
-            clearTimeout(timeoutId);
-          }
-
-          console.log(`[qqbot-channel-api] <<< Status: ${res.status} ${res.statusText}`);
-
-          // 解析响应
-          const rawBody = await res.text();
-
-          // 空响应（如 DELETE 204）
-          if (!rawBody || rawBody.trim() === "") {
-            if (res.ok) {
-              return json({ success: true, status: res.status, path: p.path });
-            }
-            return json({
-              error: `API 返回 ${res.status} ${res.statusText}`,
-              status: res.status,
-              path: p.path,
-            });
-          }
-
-          let data: unknown;
-          try {
-            data = JSON.parse(rawBody);
-          } catch {
-            return json({
-              error: "响应解析失败",
-              status: res.status,
-              raw: rawBody.slice(0, 500),
-              path: p.path,
-            });
-          }
-
-          if (!res.ok) {
-            const errData = data as { message?: string; code?: number };
-            return json({
-              error: errData.message ?? `API 错误 (HTTP ${res.status})`,
-              code: errData.code,
-              status: res.status,
-              path: p.path,
-              detail: data,
-            });
-          }
-
-          return json(data);
-        } catch (err) {
-          const errMsg = err instanceof Error ? err.message : String(err);
-          console.error(`[qqbot-channel-api] Error [${method} ${p.path}]: ${errMsg}`);
-          return json({ error: errMsg, path: p.path });
-        }
-      },
-    },
-    { name: "qqbot_channel_api" },
-  );
-
-  console.log("[qqbot-channel-api] Registered QQ channel API proxy tool");
-}

package/src/typing-keepalive.ts

@@ -1,59 +0,0 @@
-/**
- * 输入状态自动续期
- * 在消息处理期间定时续发 "正在输入" 状态通知，确保用户持续看到 bot 在处理中。
- * 仅 C2C 私聊有效（QQ 群聊 API 不支持输入状态通知）。
- */
-
-import { sendC2CInputNotify } from "./api.js";
-
-// 每 50 秒续发一次（QQ API input_second=60，留 10s 余量）
-export const TYPING_INTERVAL_MS = 50_000;
-export const TYPING_INPUT_SECOND = 60;
-
-export class TypingKeepAlive {
-  private timer: ReturnType<typeof setInterval> | null = null;
-  private stopped = false;
-
-  constructor(
-    private readonly getToken: () => Promise<string>,
-    private readonly clearCache: () => void,
-    private readonly openid: string,
-    private readonly msgId: string | undefined,
-    private readonly log?: { info: (msg: string) => void; error: (msg: string) => void; debug?: (msg: string) => void },
-    private readonly logPrefix = "[qqbot]",
-  ) {}
-
-  /** 启动定时续期（首次发送由调用方自行处理，这里只负责后续续期） */
-  start(): void {
-    if (this.stopped) return;
-    this.timer = setInterval(() => {
-      if (this.stopped) { this.stop(); return; }
-      this.send().catch(() => {});
-    }, TYPING_INTERVAL_MS);
-  }
-
-  /** 停止续期 */
-  stop(): void {
-    this.stopped = true;
-    if (this.timer) {
-      clearInterval(this.timer);
-      this.timer = null;
-    }
-  }
-
-  private async send(): Promise<void> {
-    try {
-      const token = await this.getToken();
-      await sendC2CInputNotify(token, this.openid, this.msgId, TYPING_INPUT_SECOND);
-      this.log?.debug?.(`${this.logPrefix} Typing keep-alive sent to ${this.openid}`);
-    } catch (err) {
-      try {
-        this.clearCache();
-        const token = await this.getToken();
-        await sendC2CInputNotify(token, this.openid, this.msgId, TYPING_INPUT_SECOND);
-      } catch {
-        this.log?.debug?.(`${this.logPrefix} Typing keep-alive failed for ${this.openid}: ${err}`);
-      }
-    }
-  }
-}