@sliverp/qqbot 1.4.2 → 1.4.4

package/src/utils/audio-convert.ts

@@ -0,0 +1,138 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { decode, isSilk } from "silk-wasm";
+
+/**
+ * 检查文件是否为 SILK 格式（QQ/微信语音常用格式）
+ * QQ 语音文件通常以 .amr 扩展名保存，但实际编码可能是 SILK v3
+ * SILK 文件头部标识: 0x02 "#!SILK_V3"
+ */
+function isSilkFile(filePath: string): boolean {
+  try {
+    const buf = fs.readFileSync(filePath);
+    return isSilk(new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 将 PCM (s16le) 数据封装为 WAV 文件格式
+ * WAV = 44 字节 RIFF 头 + PCM 原始数据
+ */
+function pcmToWav(pcmData: Uint8Array, sampleRate: number, channels: number = 1, bitsPerSample: number = 16): Buffer {
+  const byteRate = sampleRate * channels * (bitsPerSample / 8);
+  const blockAlign = channels * (bitsPerSample / 8);
+  const dataSize = pcmData.length;
+  const headerSize = 44;
+  const fileSize = headerSize + dataSize;
+
+  const buffer = Buffer.alloc(fileSize);
+
+  // RIFF header
+  buffer.write("RIFF", 0);
+  buffer.writeUInt32LE(fileSize - 8, 4);
+  buffer.write("WAVE", 8);
+
+  // fmt sub-chunk
+  buffer.write("fmt ", 12);
+  buffer.writeUInt32LE(16, 16);         // sub-chunk size
+  buffer.writeUInt16LE(1, 20);          // PCM format
+  buffer.writeUInt16LE(channels, 22);
+  buffer.writeUInt32LE(sampleRate, 24);
+  buffer.writeUInt32LE(byteRate, 28);
+  buffer.writeUInt16LE(blockAlign, 32);
+  buffer.writeUInt16LE(bitsPerSample, 34);
+
+  // data sub-chunk
+  buffer.write("data", 36);
+  buffer.writeUInt32LE(dataSize, 40);
+  Buffer.from(pcmData.buffer, pcmData.byteOffset, pcmData.byteLength).copy(buffer, headerSize);
+
+  return buffer;
+}
+
+/**
+ * 去除 QQ 语音文件的 AMR 头（如果存在）
+ * QQ 的 .amr 文件可能在 SILK 数据前有 "#!AMR\n" 头（6 字节）
+ * 需要去除后才能被 silk-wasm 正确解码
+ */
+function stripAmrHeader(buf: Buffer): Buffer {
+  const AMR_HEADER = Buffer.from("#!AMR\n");
+  if (buf.length > 6 && buf.subarray(0, 6).equals(AMR_HEADER)) {
+    return buf.subarray(6);
+  }
+  return buf;
+}
+
+/**
+ * 将 SILK/AMR 语音文件转换为 WAV 格式
+ *
+ * @param inputPath 输入文件路径（.amr / .silk / .slk）
+ * @param outputDir 输出目录（默认与输入文件同目录）
+ * @returns 转换后的 WAV 文件路径，失败返回 null
+ */
+export async function convertSilkToWav(
+  inputPath: string,
+  outputDir?: string,
+): Promise<{ wavPath: string; duration: number } | null> {
+  if (!fs.existsSync(inputPath)) {
+    return null;
+  }
+
+  const fileBuf = fs.readFileSync(inputPath);
+
+  // 去除可能的 AMR 头
+  const strippedBuf = stripAmrHeader(fileBuf);
+
+  // 转为 Uint8Array 以兼容 silk-wasm 类型要求
+  const rawData = new Uint8Array(strippedBuf.buffer, strippedBuf.byteOffset, strippedBuf.byteLength);
+
+  // 验证是否为 SILK 格式
+  if (!isSilk(rawData)) {
+    return null;
+  }
+
+  // SILK 解码为 PCM (s16le)
+  // QQ 语音通常采样率为 24000Hz
+  const sampleRate = 24000;
+  const result = await decode(rawData, sampleRate);
+
+  // PCM → WAV
+  const wavBuffer = pcmToWav(result.data, sampleRate);
+
+  // 写入 WAV 文件
+  const dir = outputDir || path.dirname(inputPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const baseName = path.basename(inputPath, path.extname(inputPath));
+  const wavPath = path.join(dir, `${baseName}.wav`);
+  fs.writeFileSync(wavPath, wavBuffer);
+
+  return { wavPath, duration: result.duration };
+}
+
+/**
+ * 判断是否为语音附件（根据 content_type 或文件扩展名）
+ */
+export function isVoiceAttachment(att: { content_type?: string; filename?: string }): boolean {
+  if (att.content_type === "voice" || att.content_type?.startsWith("audio/")) {
+    return true;
+  }
+  const ext = att.filename ? path.extname(att.filename).toLowerCase() : "";
+  return [".amr", ".silk", ".slk"].includes(ext);
+}
+
+/**
+ * 格式化语音时长为可读字符串
+ */
+export function formatDuration(durationMs: number): string {
+  const seconds = Math.round(durationMs / 1000);
+  if (seconds < 60) {
+    return `${seconds}秒`;
+  }
+  const minutes = Math.floor(seconds / 60);
+  const remainSeconds = seconds % 60;
+  return remainSeconds > 0 ? `${minutes}分${remainSeconds}秒` : `${minutes}分钟`;
+}

package/dist/index.d.ts

@@ -1,17 +0,0 @@
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-declare const plugin: {
-    id: string;
-    name: string;
-    description: string;
-    configSchema: unknown;
-    register(api: OpenClawPluginApi): void;
-};
-export default plugin;
-export { qqbotPlugin } from "./src/channel.js";
-export { setQQBotRuntime, getQQBotRuntime } from "./src/runtime.js";
-export { qqbotOnboardingAdapter } from "./src/onboarding.js";
-export * from "./src/types.js";
-export * from "./src/api.js";
-export * from "./src/config.js";
-export * from "./src/gateway.js";
-export * from "./src/outbound.js";

package/dist/index.js

@@ -1,22 +0,0 @@
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
-import { qqbotPlugin } from "./src/channel.js";
-import { setQQBotRuntime } from "./src/runtime.js";
-const plugin = {
-    id: "qqbot",
-    name: "QQ Bot",
-    description: "QQ Bot channel plugin",
-    configSchema: emptyPluginConfigSchema(),
-    register(api) {
-        setQQBotRuntime(api.runtime);
-        api.registerChannel({ plugin: qqbotPlugin });
-    },
-};
-export default plugin;
-export { qqbotPlugin } from "./src/channel.js";
-export { setQQBotRuntime, getQQBotRuntime } from "./src/runtime.js";
-export { qqbotOnboardingAdapter } from "./src/onboarding.js";
-export * from "./src/types.js";
-export * from "./src/api.js";
-export * from "./src/config.js";
-export * from "./src/gateway.js";
-export * from "./src/outbound.js";

package/dist/src/api.d.ts

@@ -1,194 +0,0 @@
-/**
- * QQ Bot API 鉴权和请求封装
- */
-/**
- * 初始化 API 配置
- * @param options.markdownSupport - 是否支持 markdown 消息（默认 false，需要机器人具备该权限才能启用）
- */
-export declare function initApiConfig(options: {
-    markdownSupport?: boolean;
-}): void;
-/**
- * 获取当前是否支持 markdown
- */
-export declare function isMarkdownSupport(): boolean;
-/**
- * 获取 AccessToken（带缓存 + singleflight 并发安全）
- *
- * 使用 singleflight 模式：当多个请求同时发现 Token 过期时，
- * 只有第一个请求会真正去获取新 Token，其他请求复用同一个 Promise。
- */
-export declare function getAccessToken(appId: string, clientSecret: string): Promise<string>;
-/**
- * 清除 Token 缓存
- */
-export declare function clearTokenCache(): void;
-/**
- * 获取 Token 缓存状态（用于监控）
- */
-export declare function getTokenStatus(): {
-    status: "valid" | "expired" | "refreshing" | "none";
-    expiresAt: number | null;
-};
-/**
- * 获取并递增消息序号
- * 返回的 seq 会基于时间戳，避免进程重启后重复
- */
-export declare function getNextMsgSeq(msgId: string): number;
-/**
- * API 请求封装
- */
-export declare function apiRequest<T = unknown>(accessToken: string, method: string, path: string, body?: unknown): Promise<T>;
-/**
- * 获取 WebSocket Gateway URL
- */
-export declare function getGatewayUrl(accessToken: string): Promise<string>;
-/**
- * 消息响应
- */
-export interface MessageResponse {
-    id: string;
-    timestamp: number | string;
-}
-/**
- * 发送 C2C 单聊消息
- */
-export declare function sendC2CMessage(accessToken: string, openid: string, content: string, msgId?: string): Promise<MessageResponse>;
-/**
- * 发送 C2C 输入状态提示（告知用户机器人正在输入）
- */
-export declare function sendC2CInputNotify(accessToken: string, openid: string, msgId?: string, inputSecond?: number): Promise<void>;
-/**
- * 发送频道消息（不支持流式）
- */
-export declare function sendChannelMessage(accessToken: string, channelId: string, content: string, msgId?: string): Promise<{
-    id: string;
-    timestamp: string;
-}>;
-/**
- * 发送群聊消息
- */
-export declare function sendGroupMessage(accessToken: string, groupOpenid: string, content: string, msgId?: string): Promise<MessageResponse>;
-/**
- * 主动发送 C2C 单聊消息（不需要 msg_id，每月限 4 条/用户）
- *
- * 注意：
- * 1. 内容不能为空（对应 markdown.content 字段）
- * 2. 不支持流式发送
- */
-export declare function sendProactiveC2CMessage(accessToken: string, openid: string, content: string): Promise<{
-    id: string;
-    timestamp: number;
-}>;
-/**
- * 主动发送群聊消息（不需要 msg_id，每月限 4 条/群）
- *
- * 注意：
- * 1. 内容不能为空（对应 markdown.content 字段）
- * 2. 不支持流式发送
- */
-export declare function sendProactiveGroupMessage(accessToken: string, groupOpenid: string, content: string): Promise<{
-    id: string;
-    timestamp: string;
-}>;
-/**
- * 媒体文件类型
- */
-export declare enum MediaFileType {
-    IMAGE = 1,
-    VIDEO = 2,
-    VOICE = 3,
-    FILE = 4
-}
-/**
- * 上传富媒体文件的响应
- */
-export interface UploadMediaResponse {
-    file_uuid: string;
-    file_info: string;
-    ttl: number;
-    id?: string;
-}
-/**
- * 上传富媒体文件到 C2C 单聊
- * @param url - 公网可访问的图片 URL（与 fileData 二选一）
- * @param fileData - Base64 编码的文件内容（与 url 二选一）
- */
-export declare function uploadC2CMedia(accessToken: string, openid: string, fileType: MediaFileType, url?: string, fileData?: string, srvSendMsg?: boolean): Promise<UploadMediaResponse>;
-/**
- * 上传富媒体文件到群聊
- * @param url - 公网可访问的图片 URL（与 fileData 二选一）
- * @param fileData - Base64 编码的文件内容（与 url 二选一）
- */
-export declare function uploadGroupMedia(accessToken: string, groupOpenid: string, fileType: MediaFileType, url?: string, fileData?: string, srvSendMsg?: boolean): Promise<UploadMediaResponse>;
-/**
- * 发送 C2C 单聊富媒体消息
- */
-export declare function sendC2CMediaMessage(accessToken: string, openid: string, fileInfo: string, msgId?: string, content?: string): Promise<{
-    id: string;
-    timestamp: number;
-}>;
-/**
- * 发送群聊富媒体消息
- */
-export declare function sendGroupMediaMessage(accessToken: string, groupOpenid: string, fileInfo: string, msgId?: string, content?: string): Promise<{
-    id: string;
-    timestamp: string;
-}>;
-/**
- * 发送带图片的 C2C 单聊消息（封装上传+发送）
- * @param imageUrl - 图片来源，支持：
- *   - 公网 URL: https://example.com/image.png
- *   - Base64 Data URL: data:image/png;base64,xxxxx
- */
-export declare function sendC2CImageMessage(accessToken: string, openid: string, imageUrl: string, msgId?: string, content?: string): Promise<{
-    id: string;
-    timestamp: number;
-}>;
-/**
- * 发送带图片的群聊消息（封装上传+发送）
- * @param imageUrl - 图片来源，支持：
- *   - 公网 URL: https://example.com/image.png
- *   - Base64 Data URL: data:image/png;base64,xxxxx
- */
-export declare function sendGroupImageMessage(accessToken: string, groupOpenid: string, imageUrl: string, msgId?: string, content?: string): Promise<{
-    id: string;
-    timestamp: string;
-}>;
-/**
- * 后台 Token 刷新配置
- */
-interface BackgroundTokenRefreshOptions {
-    /** 提前刷新时间（毫秒，默认 5 分钟） */
-    refreshAheadMs?: number;
-    /** 随机偏移范围（毫秒，默认 0-30 秒） */
-    randomOffsetMs?: number;
-    /** 最小刷新间隔（毫秒，默认 1 分钟） */
-    minRefreshIntervalMs?: number;
-    /** 失败后重试间隔（毫秒，默认 5 秒） */
-    retryDelayMs?: number;
-    /** 日志函数 */
-    log?: {
-        info: (msg: string) => void;
-        error: (msg: string) => void;
-        debug?: (msg: string) => void;
-    };
-}
-/**
- * 启动后台 Token 刷新
- * 在后台定时刷新 Token，避免请求时才发现过期
- *
- * @param appId 应用 ID
- * @param clientSecret 应用密钥
- * @param options 配置选项
- */
-export declare function startBackgroundTokenRefresh(appId: string, clientSecret: string, options?: BackgroundTokenRefreshOptions): void;
-/**
- * 停止后台 Token 刷新
- */
-export declare function stopBackgroundTokenRefresh(): void;
-/**
- * 检查后台 Token 刷新是否正在运行
- */
-export declare function isBackgroundTokenRefreshRunning(): boolean;
-export {};