koishi-plugin-kkk 1.0.0

package/lib/karin/module/utils/build-metadata.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBuildTime = exports.getBuildMetadata = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = require("node:path");
+const node_karin_1 = require("../../../compat/node-karin.js");
+const root_1 = require("../../root");
+let cachedMetadata = null;
+/**
+ * 获取构建元数据
+ * @returns 构建元数据对象，如果读取失败则返回 null
+ */
+const getBuildMetadata = () => {
+    if (cachedMetadata) {
+        return cachedMetadata;
+    }
+    try {
+        // 使用插件路径 + lib/build-metadata.json
+        // Root.pluginPath 指向插件根目录，构建后的元数据在 lib 目录下
+        const metadataPath = (0, node_path_1.resolve)(root_1.Root.pluginPath, 'lib/build-metadata.json');
+        if (node_fs_1.default.existsSync(metadataPath)) {
+            const content = node_fs_1.default.readFileSync(metadataPath, 'utf-8');
+            cachedMetadata = JSON.parse(content);
+            return cachedMetadata;
+        }
+    }
+    catch (error) {
+        node_karin_1.logger.error('无法读取构建元数据:', error);
+    }
+    return null;
+};
+exports.getBuildMetadata = getBuildMetadata;
+/**
+ * 格式化构建时间为可读格式
+ * @param isoString ISO 格式的时间字符串
+ * @returns 格式化后的时间字符串，格式：2025年11月02日 17:30
+ */
+const formatBuildTime = (isoString) => {
+    const date = new Date(isoString);
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hour = String(date.getHours()).padStart(2, '0');
+    const minute = String(date.getMinutes()).padStart(2, '0');
+    return `${year}年${month}月${day}日 ${hour}:${minute}`;
+};
+exports.formatBuildTime = formatBuildTime;

package/lib/karin/module/utils/changelog.js

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChangelogImage = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_karin_1 = require("../../../compat/node-karin.js");
+const axios_1 = __importDefault(require("../../../compat/axios.js"));
+// Koishi 移植：同样是为了断开 utils → changelog → '@/module' → utils 的环（见 coverTheme.ts 的说明）
+const root_1 = require("../../root");
+const constants_1 = require("./Network/constants");
+const Render_1 = require("./Render");
+const build_metadata_1 = require("./build-metadata");
+const semver_1 = require("./semver");
+/**
+ * 规范化为 x.x.x（剔除 v 前缀、预发布、构建标识）
+ * @param v 版本字符串
+ * @returns 核心版本字符串
+ */
+const versionCore = (v) => {
+    v = v.trim();
+    if (v.startsWith('v') || v.startsWith('V'))
+        v = v.slice(1);
+    const [preBuild] = v.split('+', 2);
+    const [core] = preBuild.split('-', 2);
+    return core;
+};
+const getLagVersionCount = (changelog, localVersion, remoteVersion) => {
+    const local = versionCore(localVersion);
+    const remote = versionCore(remoteVersion);
+    if (!local || !remote || !(0, semver_1.isSemverGreater)(remote, local))
+        return 0;
+    const versions = Object.keys((0, node_karin_1.parseChangelog)(changelog)).map(versionCore).filter(Boolean);
+    const uniqueVersions = [...new Set(versions)];
+    return uniqueVersions.filter((version) => {
+        const afterLocal = (0, semver_1.isSemverGreater)(version, local);
+        const notAfterRemote = !(0, semver_1.isSemverGreater)(version, remote);
+        return afterLocal && notAfterRemote;
+    }).length;
+};
+/**
+ * 获取远程构建元数据
+ * @param version 远程版本号
+ * @returns 构建元数据对象，如果获取失败则返回 null
+ */
+const getRemoteBuildMetadata = async (version) => {
+    const urls = [
+        // 国内镜像（优先）
+        `https://jsd.onmicrosoft.cn/npm/${root_1.Root.pluginName}@${version}/lib/build-metadata.json`,
+        `https://npm.onmicrosoft.cn/${root_1.Root.pluginName}@${version}/lib/build-metadata.json`,
+        // 海外源
+        `https://cdn.jsdelivr.net/npm/${root_1.Root.pluginName}@${version}/lib/build-metadata.json`,
+        `https://fastly.jsdelivr.net/npm/${root_1.Root.pluginName}@${version}/lib/build-metadata.json`,
+        `https://unpkg.com/${root_1.Root.pluginName}@${version}/lib/build-metadata.json`
+    ];
+    const requests = urls.map((url) => axios_1.default.get(url, { timeout: 10000, headers: constants_1.baseHeaders }).then((res) => {
+        if (res.data && typeof res.data === 'object') {
+            return res.data;
+        }
+        throw new Error('Invalid metadata');
+    }));
+    try {
+        const metadata = await Promise.any(requests);
+        return metadata;
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * 获取变更日志图片
+ *
+ * @param ctx - 渲染上下文，可传入消息事件或 Bot 实例
+ * @param props - 获取变更日志图片选项
+ * @param props.isRemote - 是否强制获取远程变更日志
+ * @returns 变更日志图片元素数组（base64）
+ */
+const getChangelogImage = async (ctx, props) => {
+    let changelog = '';
+    let buildTime;
+    let lagVersionCount = 0;
+    const event = 'bot' in ctx ? ctx : { bot: ctx };
+    if (props.Tip || props.isRemote) {
+        const urls = [
+            // 国内代理
+            `https://jsd.onmicrosoft.cn/npm/${root_1.Root.pluginName}@${props.remoteVersion}/CHANGELOG.md`,
+            `https://npm.onmicrosoft.cn/${root_1.Root.pluginName}@${props.remoteVersion}/CHANGELOG.md`,
+            // 海外源
+            `https://cdn.jsdelivr.net/npm/${root_1.Root.pluginName}@${props.remoteVersion}/CHANGELOG.md`,
+            `https://fastly.jsdelivr.net/npm/${root_1.Root.pluginName}@${props.remoteVersion}/CHANGELOG.md`,
+            `https://unpkg.com/${root_1.Root.pluginName}@${props.remoteVersion}/CHANGELOG.md`,
+            // GitHub Raw 代理
+            `https://gh.llkk.cc/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://j.1lin.dpdns.org/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://tvv.tw/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://git.yylx.win/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://gitproxy.127731.xyz/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://ghm.078465.xyz/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://ghfile.geekertao.top/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://github.tbedu.top/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://j.1win.ggff.net/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://ghm.078465.xyz/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://ghm.078465.xyz/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`,
+            `https://jiashu.1win.eu.org/https://raw.githubusercontent.com/ikenxuan/koishi-plugin-kkk/v${props.remoteVersion}/packages/core/CHANGELOG.md`
+        ];
+        // 并发竞速获取 CHANGELOG
+        const requests = urls.map((url) => axios_1.default.get(url, { timeout: 10000, headers: constants_1.baseHeaders }).then((res) => {
+            if (typeof res.data === 'string' && res.data.length > 0) {
+                return res.data;
+            }
+            throw new Error('Invalid changelog content');
+        }));
+        try {
+            changelog = await Promise.any(requests);
+        }
+        catch {
+            return null;
+        }
+        if (!changelog)
+            return null;
+        lagVersionCount = getLagVersionCount(changelog, props.localVersion, props.remoteVersion);
+        // 获取远程构建元数据
+        const remoteMeta = await getRemoteBuildMetadata(props.remoteVersion);
+        if (remoteMeta?.buildTime) {
+            buildTime = (0, build_metadata_1.formatBuildTime)(remoteMeta.buildTime);
+        }
+        changelog = (0, node_karin_1.range)({
+            data: changelog,
+            startVersion: props.localVersion,
+            endVersion: versionCore(props.remoteVersion),
+            compare: 'semver'
+        });
+    }
+    else {
+        try {
+            changelog = node_fs_1.default.readFileSync(root_1.Root.pluginPath + '/CHANGELOG.md', 'utf8');
+            lagVersionCount = getLagVersionCount(changelog, props.localVersion, props.remoteVersion);
+            changelog = (0, node_karin_1.range)({
+                data: changelog,
+                startVersion: props.localVersion,
+                endVersion: versionCore(props.remoteVersion),
+                compare: 'semver'
+            });
+        }
+        catch {
+            return null;
+        }
+        // 获取本地构建元数据
+        const localMeta = (0, build_metadata_1.getBuildMetadata)();
+        if (localMeta?.buildTime) {
+            buildTime = (0, build_metadata_1.formatBuildTime)(localMeta.buildTime);
+        }
+    }
+    const img = await (0, Render_1.Render)(event, 'other/changelog', {
+        markdown: changelog,
+        Tip: props.Tip,
+        localVersion: props.localVersion,
+        remoteVersion: props.remoteVersion,
+        lagVersionCount,
+        buildTime,
+        share_url: `https://koishi-plugin-kkk-docs.vercel.app/diff?old=${props.localVersion}&new=latest`
+    });
+    return img || null;
+};
+exports.getChangelogImage = getChangelogImage;

package/lib/karin/module/utils/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../../root"), exports);
+__exportStar(require("./Base"), exports);
+__exportStar(require("./build-metadata"), exports);
+__exportStar(require("./Common"), exports);
+__exportStar(require("./EmojiReaction"), exports);
+__exportStar(require("./FFmpeg"), exports);
+__exportStar(require("./ImageHelper"), exports);
+__exportStar(require("./MotionPhoto"), exports);
+__exportStar(require("./Networks"), exports);
+__exportStar(require("./Render"), exports);

package/lib/karin/module/utils/loginSession.js

@@ -0,0 +1,259 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoginSessionError = void 0;
+exports.mergeSetCookie = mergeSetCookie;
+exports.cookieFromCrossDomainUrl = cookieFromCrossDomainUrl;
+exports.createBilibiliLoginSession = createBilibiliLoginSession;
+exports.createDouyinLoginSession = createDouyinLoginSession;
+/**
+ * 扫码登录会话（Koishi 迁移补充）。
+ *
+ * 上游 koishi-plugin-kkk 依赖 amagi **v7** 的登录会话 API：
+ *   \`client.bilibili.login.qrcode()\` / \`client.douyin.login.qrcode()\` → \`session.watch({ onQrcode, onScanned, onSuccess })\`
+ * 而已发布的 amagi 6.6.0 只提供 fetcher（requestLoginQrcode / checkQrcodeStatus / passport 系列），
+ * client 上没有 \`login\` 命名空间。这里按 v7 的会话契约在本地补一层：
+ * 取码 → 轮询 → 扫码/确认回调 → 领取凭证，使移植后的登录命令可以直接复用。
+ *
+ * 回调语义与 v7 保持一致（上游依赖这一点）：
+ *   - **调用方回调抛错 → watch reject**，由上层登录命令自己 catch 并提示；
+ *   - **中止 / 轮询失败 / 二维码过期 → watch resolve 失败态**，上层按 \`outcome.error\` 分流。
+ */
+const axios_1 = __importDefault(require("../../../compat/axios.js"));
+const node_karin_1 = require("../../../compat/node-karin.js");
+/** 与 AmagiError 结构兼容的登录错误（kind / code / message 会被上层读取） */
+class LoginSessionError extends Error {
+    kind;
+    code;
+    constructor(kind, code, message) {
+        super(message);
+        this.name = 'LoginSessionError';
+        this.kind = kind;
+        this.code = code;
+    }
+}
+exports.LoginSessionError = LoginSessionError;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** 把 set-cookie 数组归一化成 \`name=value; name2=value2\`（丢掉 Path/Domain/Expires 等属性） */
+function mergeSetCookie(setCookie) {
+    if (!setCookie)
+        return '';
+    const list = Array.isArray(setCookie) ? setCookie : [setCookie];
+    const pairs = [];
+    for (const item of list) {
+        const [pair] = String(item).split(';');
+        if (pair && pair.includes('='))
+            pairs.push(pair.trim());
+    }
+    return pairs.join('; ');
+}
+/** 从跨域跳转 URL 的 query 里取登录 cookie（B站扫码成功后的标准做法） */
+function cookieFromCrossDomainUrl(url) {
+    if (!url)
+        return '';
+    try {
+        const parsed = new URL(url);
+        const names = ['SESSDATA', 'bili_jct', 'DedeUserID', 'DedeUserID__ckMd5', 'sid'];
+        const pairs = names
+            .map((name) => {
+            const value = parsed.searchParams.get(name);
+            return value ? name + '=' + decodeURIComponent(value) : '';
+        })
+            .filter(Boolean);
+        return pairs.join('; ');
+    }
+    catch {
+        return '';
+    }
+}
+/** 解开 amagi 信封：\`{success,data:{...}}\` → 内层数据 */
+function unwrap(envelope) {
+    if (!envelope || typeof envelope !== 'object')
+        return envelope;
+    if ('success' in envelope)
+        return envelope.data;
+    return envelope;
+}
+/**
+ * B站扫码登录会话（v7 契约）。
+ * 状态码：86101 未扫码 / 86090 已扫码未确认 / 0 成功 / 86038 已过期。
+ */
+function createBilibiliLoginSession(fetcher) {
+    return {
+        qrcode() {
+            return {
+                async watch(options = {}) {
+                    let qrcodeKey = '';
+                    let qrcodeContent = '';
+                    // 1) 取码：只把网络调用包在 try 里
+                    try {
+                        const body = unwrap(await fetcher.requestLoginQrcode({})) ?? {};
+                        const payload = body?.data ?? body;
+                        qrcodeKey = payload?.qrcode_key ?? '';
+                        qrcodeContent = payload?.url ?? '';
+                    }
+                    catch (error) {
+                        return { ok: false, error: new LoginSessionError('api', 'QRCODE_FAILED', String(error?.message ?? error)) };
+                    }
+                    if (!qrcodeContent) {
+                        return { ok: false, error: new LoginSessionError('api', 'QRCODE_FAILED', 'B站未返回二维码地址') };
+                    }
+                    // 2) 回调：抛错直接向上传播（与 v7 一致）
+                    await options.onQrcode?.({ content: qrcodeContent, expiresInSec: 180, key: qrcodeKey });
+                    // 3) 轮询
+                    const deadline = Date.now() + (options.timeoutMs ?? 180_000);
+                    let scannedNotified = false;
+                    while (Date.now() < deadline) {
+                        if (options.signal?.aborted) {
+                            return { ok: false, error: new LoginSessionError('aborted', 'ABORTED', '登录已取消') };
+                        }
+                        await sleep(2000);
+                        if (options.signal?.aborted) {
+                            return { ok: false, error: new LoginSessionError('aborted', 'ABORTED', '登录已取消') };
+                        }
+                        let pollCode = -1;
+                        let inner = {};
+                        let payload = {};
+                        try {
+                            const body = unwrap(await fetcher.checkQrcodeStatus({ qrcode_key: qrcodeKey })) ?? {};
+                            inner = body?.data ?? {};
+                            payload = inner?.data ?? {};
+                            pollCode = Number(payload?.code ?? body?.code ?? -1);
+                        }
+                        catch (error) {
+                            return { ok: false, error: new LoginSessionError('api', 'POLL_FAILED', String(error?.message ?? error)) };
+                        }
+                        if (pollCode === 86101)
+                            continue;
+                        if (pollCode === 86090) {
+                            if (!scannedNotified) {
+                                scannedNotified = true;
+                                await options.onScanned?.();
+                            }
+                            continue;
+                        }
+                        if (pollCode === 86038) {
+                            return { ok: false, error: new LoginSessionError('api', 'COOKIE_EXPIRED', '二维码已失效') };
+                        }
+                        if (pollCode === 0) {
+                            const cookie = mergeSetCookie(inner?.headers?.['set-cookie'] ?? inner?.headers?.['Set-Cookie'])
+                                || cookieFromCrossDomainUrl(payload?.url ?? '');
+                            if (!cookie) {
+                                return { ok: false, error: new LoginSessionError('api', 'COOKIE_MISSING', '登录成功但未取到 cookie') };
+                            }
+                            await options.onSuccess?.({ cookie, refreshToken: payload?.refresh_token });
+                            return { ok: true };
+                        }
+                    }
+                    return { ok: false, error: new LoginSessionError('timeout', 'TIMEOUT', '登录超时，未完成扫码') };
+                }
+            };
+        }
+    };
+}
+/**
+ * 抖音扫码登录会话（v7 契约的精简版）。
+ *
+ * amagi 6.6.0 的 passport 流程：\`requestPassportQrcode\` 拿码与 session cookie，
+ * \`checkPassportQrcode\` 轮询（new/scanned/confirmed/expired/verify/risk/busy），
+ * confirmed 时需要跟随 \`redirectUrl\` 才能领到最终凭证。
+ * 短信二次验证（verify）暂未实现，触发时以明确错误结束。
+ */
+function createDouyinLoginSession(fetcher) {
+    return {
+        qrcode() {
+            return {
+                async watch(options = {}) {
+                    let sessionCookie = '';
+                    let token = '';
+                    let content = '';
+                    let expiresInSec = 60;
+                    try {
+                        const body = unwrap(await fetcher.requestPassportQrcode({})) ?? {};
+                        const payload = body?.data ?? body;
+                        sessionCookie = payload?.cookie ?? '';
+                        token = payload?.token ?? '';
+                        content = payload?.content ?? payload?.qrcode ?? '';
+                        expiresInSec = payload?.expires_in ?? 60;
+                    }
+                    catch (error) {
+                        return { ok: false, error: new LoginSessionError('api', 'QRCODE_FAILED', String(error?.message ?? error)) };
+                    }
+                    if (!content) {
+                        return { ok: false, error: new LoginSessionError('api', 'QRCODE_FAILED', '抖音未返回二维码内容') };
+                    }
+                    await options.onQrcode?.({ content, expiresInSec, key: token });
+                    const deadline = Date.now() + (options.timeoutMs ?? 180_000);
+                    let scannedNotified = false;
+                    while (Date.now() < deadline) {
+                        if (options.signal?.aborted) {
+                            return { ok: false, error: new LoginSessionError('aborted', 'ABORTED', '登录已取消') };
+                        }
+                        await sleep(2000);
+                        if (options.signal?.aborted) {
+                            return { ok: false, error: new LoginSessionError('aborted', 'ABORTED', '登录已取消') };
+                        }
+                        let payload = {};
+                        try {
+                            const body = unwrap(await fetcher.checkPassportQrcode({ cookie: sessionCookie, token })) ?? {};
+                            payload = body?.data ?? body;
+                        }
+                        catch (error) {
+                            return { ok: false, error: new LoginSessionError('api', 'POLL_FAILED', String(error?.message ?? error)) };
+                        }
+                        if (payload?.cookie)
+                            sessionCookie = payload.cookie;
+                        switch (payload?.status) {
+                            case 'new':
+                            case 'busy':
+                                break;
+                            case 'scanned':
+                                if (!scannedNotified) {
+                                    scannedNotified = true;
+                                    await options.onScanned?.();
+                                }
+                                break;
+                            case 'verify':
+                                return { ok: false, error: new LoginSessionError('unsupported', 'NEED_VERIFY', '抖音触发了短信二次验证，当前暂不支持') };
+                            case 'risk':
+                                return { ok: false, error: new LoginSessionError('risk', 'RISK', payload?.message ?? '登录请求被抖音风控拦截') };
+                            case 'expired':
+                                return { ok: false, error: new LoginSessionError('api', 'COOKIE_EXPIRED', '二维码已失效') };
+                            case 'confirmed': {
+                                const cookie = await followRedirect(payload?.redirectUrl, sessionCookie);
+                                const finalCookie = cookie || payload?.cookie || sessionCookie;
+                                if (!finalCookie) {
+                                    return { ok: false, error: new LoginSessionError('api', 'COOKIE_MISSING', '登录成功但未取到 cookie') };
+                                }
+                                await options.onSuccess?.({ cookie: finalCookie });
+                                return { ok: true };
+                            }
+                            default:
+                                node_karin_1.logger.debug('[抖音登录] 未识别的轮询状态: ' + JSON.stringify(payload).slice(0, 200));
+                        }
+                    }
+                    return { ok: false, error: new LoginSessionError('timeout', 'TIMEOUT', '登录超时，未完成扫码') };
+                }
+            };
+        }
+    };
+}
+/** 跟随 redirectUrl 领取抖音最终登录凭证 */
+async function followRedirect(redirectUrl, sessionCookie) {
+    if (!redirectUrl)
+        return '';
+    try {
+        const response = await axios_1.default.get(redirectUrl, {
+            headers: { Cookie: sessionCookie },
+            maxRedirects: 0,
+            validateStatus: () => true
+        });
+        return mergeSetCookie(response.headers?.['set-cookie']);
+    }
+    catch (error) {
+        node_karin_1.logger.debug('[抖音登录] 跟随 redirect 失败: ' + String(error?.message ?? error));
+        return '';
+    }
+}

package/lib/karin/module/utils/parseTip.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTipSegment = exports.sendParseTip = void 0;
+/**
+ * 解析开始时的提示语。
+ *
+ * **为什么要单独一个文件**：这个函数原来放在 QqPanel 里，而 QqPanel 又依赖平台模块；
+ * 平台模块反过来调用 sendParseTip → 形成循环 import，打包后函数绑定还没初始化，
+ * 调用时直接报 `(0 , module_1.sendParseTip) is not a function`（快手整个解析挂掉就是这个原因）。
+ * 这里只依赖 Config / ParseOverride / 基础段，彻底断开环。
+ */
+const node_karin_1 = require("../../../compat/node-karin.js");
+const ParseOverride_1 = require("./ParseOverride");
+/** 阶段登记用的固定 key（同一时间只可能有一个解析在跑） */
+const STAGE_KEY = 'parse';
+const Config_1 = require("./Config");
+/** 撤回上一条机器人消息（拿不到就忽略） */
+const recallPrevious = async (e, content) => {
+    try {
+        const target = e;
+        const bot = target?.bot?.bot ?? target?.bot;
+        // 尽量撤掉上一条：群里的提示只留最新的一条
+        const last = target?.__kkkLastPanelMessage;
+        if (last && typeof bot?.recallMsg === 'function') {
+            await bot.recallMsg(last, String(target?.contact?.peer ?? target?.channelId ?? ''));
+        }
+    }
+    catch { /* 撤回失败无所谓 */ }
+    await e.reply(content);
+};
+/**
+ * 解析开始时的提示语 —— 两种来源说两句话：
+ *   - **面板按钮点出来的**：画质面板刚发过，这里只回「收到请求，开始下载」
+ *   - 手工发链接的：仍然是「检测到 XX 链接，开始解析」
+ */
+const sendParseTip = async (e, platformName) => {
+    /**
+     * 登记一个「正在获取下载链接」的阶段。
+     * 用户在「收到请求，开始下载」刚出现时点「查询下载进度」，这时还没开始传字节，
+     * 以前只会显示「当前没有正在进行的下载」，很误导 —— 现在能看到真实阶段。
+     * 真正开始下载时 Downloader 会清掉这个阶段条目。
+     */
+    try {
+        const { reportDownloadStage } = await Promise.resolve().then(() => __importStar(require('./Network/Downloader')));
+        reportDownloadStage(STAGE_KEY, platformName + '解析', '正在获取下载链接');
+    }
+    catch { /* 观测失败不影响解析 */ }
+    const fromPanel = (0, ParseOverride_1.getParseOverride)()?.fromPanel === true;
+    if (fromPanel) {
+        await recallPrevious(e, '收到请求，开始下载');
+        return;
+    }
+    if (Config_1.Config.app.parseTip) {
+        await recallPrevious(e, '检测到' + platformName + '链接，开始解析');
+    }
+};
+exports.sendParseTip = sendParseTip;
+/** 兼容：某些地方可能还需要 markdown 段 */
+const parseTipSegment = () => node_karin_1.segment;
+exports.parseTipSegment = parseTipSegment;