@tencent-connect/openclaw-qqbot 1.7.2 → 2.0.0

package/dist/src/update-checker.js

@@ -1,171 +0,0 @@
-/**
- * 版本检查器
- *
- * - 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";
-import { getPackageVersion } from "./utils/pkg-version.js";
-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 = getPackageVersion(import.meta.url);
-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 的前置校验
- * @param version 要检查的版本号
- * @param pkgName 可选的包名（如 "@ryantest/openclaw-qqbot"），默认使用内置包名
- */
-export async function checkVersionExists(version, pkgName) {
-    const registries = pkgName ? buildRegistries(pkgName) : REGISTRIES;
-    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;
-}
-/** 根据自定义包名构建 registry URL 列表 */
-function buildRegistries(pkgName) {
-    const encoded = encodeURIComponent(pkgName);
-    return [
-        `https://registry.npmjs.org/${encoded}`,
-        `https://registry.npmmirror.com/${encoded}`,
-    ];
-}
-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/utils/audio-convert.d.ts

@@ -1,98 +0,0 @@
-/**
- * 将 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 三种格式，其他格式仍需转换。
- * 转换策略：
- *
- * 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>;
-/**
- * 将音频文件转码为 SILK，**输出到临时文件**（供分片上传使用）。
- *
- * 如果文件已经是 QQ 原生格式（WAV/MP3/SILK）或已经是 SILK 编码，
- * 则直接返回原文件路径（不需要转码）。
- *
- * @returns 转码后的文件路径，或 null 表示转码失败
- */
-export declare function audioFileToSilkFile(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>;