@ryantest/openclaw-qqbot 0.0.1

package/dist/src/update-checker.js

@@ -0,0 +1,166 @@
+/**
+ * 版本检查器
+ *
+ * - triggerUpdateCheck(): gateway 启动时调用，后台预热缓存
+ * - getUpdateInfo(): 每次实时查询 npm registry，返回最新结果
+ *
+ * 使用 HTTPS 直接请求 npm registry API（不依赖 npm CLI），
+ * 支持多 registry fallback：npmjs.org → npmmirror.com，解决国内网络问题。
+ */
+import { createRequire } from "node:module";
+import https from "node:https";
+const require = createRequire(import.meta.url);
+const PKG_NAME = "@tencent-connect/openclaw-qqbot";
+const ENCODED_PKG = encodeURIComponent(PKG_NAME);
+const REGISTRIES = [
+    `https://registry.npmjs.org/${ENCODED_PKG}`,
+    `https://registry.npmmirror.com/${ENCODED_PKG}`,
+];
+let CURRENT_VERSION = "unknown";
+try {
+    const pkg = require("../package.json");
+    CURRENT_VERSION = pkg.version ?? "unknown";
+}
+catch {
+    // fallback
+}
+let _log;
+function fetchJson(url, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const req = https.get(url, { timeout: timeoutMs, headers: { Accept: "application/json" } }, (res) => {
+            if (res.statusCode !== 200) {
+                res.resume();
+                reject(new Error(`HTTP ${res.statusCode} from ${url}`));
+                return;
+            }
+            let data = "";
+            res.on("data", (chunk) => { data += chunk; });
+            res.on("end", () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch (e) {
+                    reject(e);
+                }
+            });
+        });
+        req.on("error", reject);
+        req.on("timeout", () => { req.destroy(); reject(new Error(`timeout fetching ${url}`)); });
+    });
+}
+async function fetchDistTags() {
+    for (const url of REGISTRIES) {
+        try {
+            const json = await fetchJson(url, 10_000);
+            const tags = json["dist-tags"];
+            if (tags && typeof tags === "object")
+                return tags;
+        }
+        catch (e) {
+            _log?.debug?.(`[qqbot:update-checker] ${url} failed: ${e.message}`);
+        }
+    }
+    throw new Error("all registries failed");
+}
+function buildUpdateInfo(tags) {
+    const currentIsPrerelease = CURRENT_VERSION.includes("-");
+    const stableTag = tags.latest || null;
+    const alphaTag = tags.alpha || null;
+    // 严格隔离：alpha 只跟 alpha 比，正式版只跟正式版比，不交叉
+    const compareTarget = currentIsPrerelease ? alphaTag : stableTag;
+    const hasUpdate = typeof compareTarget === "string"
+        && compareTarget !== CURRENT_VERSION
+        && compareVersions(compareTarget, CURRENT_VERSION) > 0;
+    return {
+        current: CURRENT_VERSION,
+        latest: compareTarget,
+        stable: stableTag,
+        alpha: alphaTag,
+        hasUpdate,
+        checkedAt: Date.now(),
+    };
+}
+/** gateway 启动时调用，保存 log 引用 */
+export function triggerUpdateCheck(log) {
+    if (log)
+        _log = log;
+    // 预热：fire-and-forget
+    getUpdateInfo().then((info) => {
+        if (info.hasUpdate) {
+            _log?.info?.(`[qqbot:update-checker] new version available: ${info.latest} (current: ${CURRENT_VERSION})`);
+        }
+    }).catch(() => { });
+}
+/** 每次实时查询 npm registry */
+export async function getUpdateInfo() {
+    try {
+        const tags = await fetchDistTags();
+        return buildUpdateInfo(tags);
+    }
+    catch (err) {
+        _log?.debug?.(`[qqbot:update-checker] check failed: ${err.message}`);
+        return { current: CURRENT_VERSION, latest: null, stable: null, alpha: null, hasUpdate: false, checkedAt: Date.now(), error: err.message };
+    }
+}
+/**
+ * 检查指定版本是否存在于 npm registry
+ * 用于 /bot-upgrade --version 的前置校验
+ */
+export async function checkVersionExists(version) {
+    for (const baseUrl of REGISTRIES) {
+        try {
+            const url = `${baseUrl}/${version}`;
+            const json = await fetchJson(url, 10_000);
+            if (json && json.version === version)
+                return true;
+        }
+        catch {
+            // try next registry
+        }
+    }
+    return false;
+}
+function compareVersions(a, b) {
+    const parse = (v) => {
+        const clean = v.replace(/^v/, "");
+        const [main, pre] = clean.split("-", 2);
+        return { parts: main.split(".").map(Number), pre: pre || null };
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    // 先比主版本号
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa.parts[i] || 0) - (pb.parts[i] || 0);
+        if (diff !== 0)
+            return diff;
+    }
+    // 主版本号相同：正式版 > prerelease
+    if (!pa.pre && pb.pre)
+        return 1;
+    if (pa.pre && !pb.pre)
+        return -1;
+    if (!pa.pre && !pb.pre)
+        return 0;
+    // 都是 prerelease：按段逐一比较（alpha.1 vs alpha.2）
+    const aParts = pa.pre.split(".");
+    const bParts = pb.pre.split(".");
+    for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+        const aP = aParts[i] ?? "";
+        const bP = bParts[i] ?? "";
+        const aNum = Number(aP);
+        const bNum = Number(bP);
+        // 都是数字则按数字比较
+        if (!isNaN(aNum) && !isNaN(bNum)) {
+            if (aNum !== bNum)
+                return aNum - bNum;
+        }
+        else {
+            // 字符串比较
+            if (aP < bP)
+                return -1;
+            if (aP > bP)
+                return 1;
+        }
+    }
+    return 0;
+}

package/dist/src/user-messages.d.ts

@@ -0,0 +1,8 @@
+export {};
+/**
+ * 用户面向的提示文案 — 已清空
+ *
+ * 设计原则（对齐飞书插件）：
+ * QQBot 插件层不生成额外的用户提示信息。
+ * 所有运行时错误仅写日志，不面向用户展示。
+ */

package/dist/src/user-messages.js

@@ -0,0 +1,8 @@
+export {};
+/**
+ * 用户面向的提示文案 — 已清空
+ *
+ * 设计原则（对齐飞书插件）：
+ * QQBot 插件层不生成额外的用户提示信息。
+ * 所有运行时错误仅写日志，不面向用户展示。
+ */

package/dist/src/utils/audio-convert.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 将 SILK/AMR 语音文件转换为 WAV 格式
+ *
+ * @param inputPath 输入文件路径（.amr / .silk / .slk）
+ * @param outputDir 输出目录（默认与输入文件同目录）
+ * @returns 转换后的 WAV 文件路径，失败返回 null
+ */
+export declare function convertSilkToWav(inputPath: string, outputDir?: string): Promise<{
+    wavPath: string;
+    duration: number;
+} | null>;
+/**
+ * 判断是否为语音附件（根据 content_type 或文件扩展名）
+ */
+export declare function isVoiceAttachment(att: {
+    content_type?: string;
+    filename?: string;
+}): boolean;
+/**
+ * 格式化语音时长为可读字符串
+ */
+export declare function formatDuration(durationMs: number): string;
+export declare function isAudioFile(filePath: string, mimeType?: string): boolean;
+/**
+ * 判断语音是否需要转码（参考企微 wecom-app 的 shouldTranscodeWecomVoice）
+ *
+ * QQ Bot API 原生支持 WAV/MP3/SILK 三种格式，其他格式需要先转码。
+ * 使用 MIME + 扩展名双重判断，避免仅靠扩展名导致误判。
+ *
+ * @param filePath 音频文件路径
+ * @param mimeType 可选的 MIME 类型
+ * @returns true 表示需要转码，false 表示可以直传
+ */
+export declare function shouldTranscodeVoice(filePath: string, mimeType?: string): boolean;
+export interface TTSConfig {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    voice: string;
+    /** Azure OpenAI 风格：使用 api-key header 而非 Bearer token */
+    authStyle?: "bearer" | "api-key";
+    /** 附加在 URL 后的查询参数，如 Azure 的 api-version */
+    queryParams?: Record<string, string>;
+    /** 自定义速度（默认不传） */
+    speed?: number;
+}
+export declare function resolveTTSConfig(cfg: Record<string, unknown>): TTSConfig | null;
+export declare function textToSpeechPCM(text: string, ttsCfg: TTSConfig): Promise<{
+    pcmBuffer: Buffer;
+    sampleRate: number;
+}>;
+export declare function pcmToSilk(pcmBuffer: Buffer, sampleRate: number): Promise<{
+    silkBuffer: Buffer;
+    duration: number;
+}>;
+export declare function textToSilk(text: string, ttsCfg: TTSConfig, outputDir: string): Promise<{
+    silkPath: string;
+    silkBase64: string;
+    duration: number;
+}>;
+/**
+ * 将本地音频文件转换为 QQ Bot 可上传的 Base64
+ *
+ * QQ Bot API 支持直传 WAV、MP3、SILK 三种格式，其他格式仍需转换。
+ * 转换策略（参考 NapCat/go-cqhttp/Discord/Telegram 的做法）：
+ *
+ * 1. WAV / MP3 / SILK → 直传（跳过转换）
+ * 2. 有 ffmpeg → ffmpeg 万能解码为 PCM → silk-wasm 编码
+ *    支持: ogg, opus, aac, flac, wma, m4a, pcm 等所有 ffmpeg 支持的格式
+ * 3. 无 ffmpeg → WASM fallback（仅支持 pcm, wav）
+ *
+ * @param directUploadFormats - 自定义直传格式列表，覆盖默认值。传 undefined 使用 QQ_NATIVE_UPLOAD_FORMATS
+ */
+export declare function audioFileToSilkBase64(filePath: string, directUploadFormats?: string[]): Promise<string | null>;
+/**
+ * 等待文件就绪（轮询直到文件出现且大小稳定）
+ * 用于 TTS 生成后等待文件写入完成
+ *
+ * 优化策略：
+ * - 文件出现后如果持续 0 字节超过 emptyGiveUpMs（默认 10s），快速失败
+ * - 文件未出现超过 noFileGiveUpMs（默认 15s），快速失败
+ * - 整体超时 timeoutMs 作为最终兜底
+ *
+ * @param filePath 文件路径
+ * @param timeoutMs 最大等待时间（默认 30 秒）
+ * @param pollMs 轮询间隔（默认 500ms）
+ * @returns 文件大小（字节），超时或文件始终为空返回 0
+ */
+export declare function waitForFile(filePath: string, timeoutMs?: number, pollMs?: number): Promise<number>;