koishi-plugin-kkk 3.7.1 → 3.8.0

package/CHANGELOG.md

@@ -1,5 +1,65 @@
 # 更新日志
 
+## 3.8.0
+
+> 抖音解析修好了。抖音那边改了风控规则，**换 cookie 是没用的** —— 问题出在解析用的那个库太旧；
+> 顺带修好快手、小红书的评论区渲染。
+
+### 抖音：解析不了 / 一直提示 Cookie 失效
+
+- **现象**：发抖音链接，机器人回「抖音没有返回这条作品的数据（错误码 500：抖音数据获取失败），
+  常见原因：Cookie 失效、被风控」，可同一个 cookie 换个插件却能正常解析。
+- **原因**：抖音现在要求每个网页接口都带上设备标识（`uifid`）和一套新的签名头
+  （`x-secsdk-web-signature`，由抖音自己的风控 SDK 算出来）。
+  插件用的解析库 6.6.0 里根本没有这套东西，请求直接被抖音拦下
+  （服务器回的是「Blocked by ArgusSecurityPlugin Uifid Not Found」），
+  库再把它包成一句「抖音数据获取失败」—— 看起来就像 cookie 过期，怎么换都没用。
+- **处理**：把解析库升到 7.x（目前是 7.0.0-beta.5；npm 上标着「最新」的 6.6.0 反而是坏的）。
+  升级后实测：作品详情、评论区、弹幕都正常。
+- 更新完**重启一次机器人**即可；手动 `npm i` 更新插件时会自动装上对应版本的解析库。
+
+### 日志更好排查
+
+- 以后再遇到这类失败，日志里会直接写明「**多半是解析库版本过旧**」，
+  不用再照着「换 cookie、换网络」排查半天。
+
+### 修复快手评论渲染
+
+- 快手评论区接口以前未实现，现已实现
+
+### 修复小红书评论渲染
+
+- 小红书评论区接口变更导致失效，现已重新接好，评论能正常显示了
+
+## 3.7.2
+
+> 群里发的图片**统一改走 markdown** 了 —— 普通图片消息会被 QQ 压得发糊，markdown 图片不会；
+> 顺手把互动视频那张**剧情图的字放大**了。
+
+### 图片不再被压糊
+
+- 卡片、评论图、图集、推送里的图……以前都是当「普通图片」发出去的，QQ 会二次压缩，
+  卡片上的小字糊成一团。现在**图片一律按 markdown 图片发**：先传到机器人自己的图床，
+  再用带尺寸的图片写法发出去，字是清楚的。
+- markdown 图片**必须写死尺寸**（`![#宽px #高px](地址)`）—— 不写尺寸的话手机端根本不显示这张图，
+  所以每一张都会先把真实的宽高读出来（JPEG / PNG / GIF / WebP 都认）。
+- **平台不一样，处理不一样**（客户端能力决定的，不是选择）：
+  - QQ 官方机器人：走 markdown 图片；
+  - OneBot 系（NapCat、Lagrange、go-cqhttp、Chronocat 等）：客户端不认 markdown，
+    收到只会显示成一串网址、图片全丢，所以这条链路**照旧发普通图片**；
+  - QQ 频道（qqguild）同理，也不改写。
+- 一条消息里**同时有视频 / 语音 / 文件**时不改写：那种消息会按媒体发出去，markdown 内容会被丢掉。
+- 转发里的图、合并转发收集中的图也不改写，保持原样。
+- 传图床失败（或者宿主没装 assets 服务）时**照旧发普通图片**，不会因为改写不了就把图弄丢。
+- 同一张图反复发（推送封面、面板卡片）不会再反复上传。
+
+### 互动视频：剧情图的字大了
+
+- 剧情图里每个选项 / 结局的**字号调大**了（大约 1/3），手机上看得清多了。
+- 长文字不再按「14 个字」硬切，改成**按这一列还能放多少像素**来截断，
+  字大了也不会压到下一列的圆圈上；最后一列右边本来空着，会多显示几个字。
+- 「已选」「图例」「提示」这些说明文字也跟着放大了一点。
+
 ## 3.7.1
 
 > 修一个 3.7.0 改过头的地方：**视频直接发到群里的那种互动视频，照旧要在群里发带按钮的选择面板**；

package/lib/build-metadata.json

@@ -1,10 +1,10 @@
 {
-  "version": "3.7.1",
-  "buildTime": "2026-09-25T18:27:55.201Z",
-  "buildTimestamp": 1790360875202,
+  "version": "3.8.0",
+  "buildTime": "2026-09-26T03:37:45.450Z",
+  "buildTimestamp": 1790393865451,
   "name": "koishi-plugin-kkk",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "homepage": "https://github.com/maimai993/koishi-plugin-kkk#readme",
-  "commitHash": "80c363bd36af99ed42afc894ead313a883b8b44a",
-  "shortCommitHash": "80c363b"
+  "commitHash": "d5bd8abb16c68f3f03575a4f8de736512e55e94b",
+  "shortCommitHash": "d5bd8ab"
 }

package/lib/compat/imageMarkdown.js

@@ -0,0 +1,280 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.imagesToMarkdown = exports.clearMarkdownImageCache = exports.markdownImageOf = void 0;
+/**
+ * 图片段 → markdown 图片（`![#宽px #高px](url)`）。
+ *
+ * 用户反馈两条，这里一起解决：
+ *   1. **「所有的图片发送都要走 md，不然太模糊了」** —— QQ 的普通图片消息（image 段 → 适配器按
+ *      MEDIA 上传）会被客户端二次压缩，卡片上的小字糊成一团；markdown 里的图片不会被压，字是清楚的。
+ *   2. **「![#px大小#px大小]() 必须要 #px，不然手机不会显示」** —— md 图片必须写死尺寸，
+ *      不写尺寸手机端干脆不显示这张图。
+ *
+ * 所以这里在**发送出口**统一改写：compat/node-karin 的 reply / sendMsg / sendMaster 四条路径都过一遍，
+ * 业务代码照旧 e.reply(segment.image(...))，不用一处处改。
+ *
+ * 只在「认 markdown 的平台」上生效（官方 QQ：`qq`）：
+ *   - OneBot 系（NapCat / Lagrange / go-cqhttp / Chronocat…）收到 markdown 只显示成一串文字、
+ *     图片全丢（用户实测），所以那条链路继续发图片段；
+ *   - QQ 频道（`qqguild`）的适配器没有 markdown 分支，md 元素会被当纯文本渲染 → 也排除。
+ *
+ * 另外三种情况**不动**（动了只会更糟）：
+ *   - 消息里还有视频 / 语音 / 文件：适配器遇到附件会把整条消息转成 MEDIA，markdown 内容会被丢掉；
+ *   - 合并转发收集中的消息：转发节点里塞 markdown 客户端不认；
+ *   - 上传拿不到公网地址（没装 assets 服务等）、或者**读不出图片尺寸**：保持原来的图片段。
+ *     读不出尺寸是可以退回普通图片的，但**绝不能发一张不带尺寸的 markdown 图片** ——
+ *     用户实测「必须要 #px，不然手机不会显示」，那种图上手机就是一片空白。
+ */
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_url_1 = require("node:url");
+const logger_1 = require("./logger");
+const runtime_1 = require("./runtime");
+const segment_1 = require("./segment");
+/** OneBot 系：不渲染 markdown（见文件头） */
+const ONEBOT_LIKE = /onebot|napcat|lagrange|go-?cqhttp|chronocat|mirai/i;
+/**
+ * 会渲染 markdown 图片的平台。
+ *
+ * 只认 `qq` 这一个平台名 —— QQ 的 markdown 是**官方机器人**能力，
+ * `qqguild`（频道）走的是另一套编码器，md 元素在那里会被当成纯文本原样发出去。
+ */
+const canUseMarkdownImage = (platform) => {
+    const name = String(platform || '').toLowerCase();
+    if (!name)
+        return false;
+    if (ONEBOT_LIKE.test(name))
+        return false;
+    if (name.startsWith('qqguild'))
+        return false;
+    return name === 'qq' || name.startsWith('qq-') || name.startsWith('qqbot');
+};
+/** 媒体段：md 和附件不能塞进同一条消息（会被适配器吃掉），所以要跳过整条改写 */
+const ATTACHMENT_TYPES = new Set(['video', 'audio', 'record', 'file']);
+const isImageElement = (element) => !!element && typeof element === 'object' && (element.type === 'img' || element.type === 'image');
+const srcOf = (element) => {
+    const attrs = element?.attrs ?? {};
+    const src = attrs.src ?? attrs.url ?? element?.data?.file ?? element?.data?.url;
+    return typeof src === 'string' ? src : '';
+};
+/** 按二进制头认 mime（发给 assets 用；标错会让适配器按错格式处理） */
+const mimeOfBuffer = (buffer) => {
+    if (buffer.length >= 8 && buffer[0] === 0x89 && buffer.toString('latin1', 1, 4) === 'PNG')
+        return 'image/png';
+    if (buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8)
+        return 'image/jpeg';
+    if (buffer.length >= 6 && buffer.toString('latin1', 0, 3) === 'GIF')
+        return 'image/gif';
+    if (buffer.length >= 12 && buffer.toString('latin1', 0, 4) === 'RIFF' && buffer.toString('latin1', 8, 12) === 'WEBP')
+        return 'image/webp';
+    return 'image/jpeg';
+};
+/**
+ * 读出图片的**真实像素尺寸** —— md 里的 `#宽px #高px` 就靠它。
+ *
+ * 不引第三方库：卡片是 JPEG、图集是 JPEG、二维码是 PNG、实况图封面是 WebP，四种头都自己认，
+ * 免得又出现「取不到尺寸 → 正方形拉伸」或「没写尺寸 → 手机不显示」。
+ */
+const readImageSize = (buffer) => {
+    // PNG：IHDR 就在固定偏移
+    if (buffer.length >= 24 && buffer[0] === 0x89 && buffer.toString('latin1', 1, 4) === 'PNG') {
+        return { width: buffer.readUInt32BE(16), height: buffer.readUInt32BE(20) };
+    }
+    // GIF：逻辑屏幕描述符，小端
+    if (buffer.length >= 10 && buffer.toString('latin1', 0, 3) === 'GIF') {
+        return { width: buffer.readUInt16LE(6), height: buffer.readUInt16LE(8) };
+    }
+    // JPEG：扫到 SOF 段（SOF0..SOF15，跳过 DHT/DAC 这些非 SOF 标记）
+    if (buffer.length > 4 && buffer[0] === 0xff && buffer[1] === 0xd8) {
+        let offset = 2;
+        while (offset + 9 < buffer.length) {
+            if (buffer[offset] !== 0xff) {
+                offset++;
+                continue;
+            }
+            const marker = buffer[offset + 1];
+            if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+                return { height: buffer.readUInt16BE(offset + 5), width: buffer.readUInt16BE(offset + 7) };
+            }
+            const length = buffer.readUInt16BE(offset + 2);
+            if (length <= 0)
+                break;
+            offset += 2 + length;
+        }
+    }
+    // WebP：VP8X（扩展）/ VP8L（无损）/ VP8（有损）三种头的写法都不一样
+    if (buffer.length >= 30 && buffer.toString('latin1', 0, 4) === 'RIFF' && buffer.toString('latin1', 8, 12) === 'WEBP') {
+        const format = buffer.toString('latin1', 12, 16);
+        if (format === 'VP8X') {
+            return { width: 1 + buffer.readUIntLE(24, 3), height: 1 + buffer.readUIntLE(27, 3) };
+        }
+        if (format === 'VP8L') {
+            const bits = buffer.readUInt32LE(21);
+            return { width: 1 + (bits & 0x3fff), height: 1 + ((bits >> 14) & 0x3fff) };
+        }
+        if (format === 'VP8 ') {
+            return { width: buffer.readUInt16LE(26) & 0x3fff, height: buffer.readUInt16LE(28) & 0x3fff };
+        }
+    }
+    return { width: 0, height: 0 };
+};
+/** 把各种写法读成 Buffer：data URI / base64:// / file:// / 本地路径 / http(s) */
+const loadImageBuffer = async (src) => {
+    try {
+        if (src.startsWith('base64://'))
+            return Buffer.from(src.slice('base64://'.length), 'base64');
+        if (src.startsWith('data:')) {
+            const comma = src.indexOf(',');
+            if (comma < 0)
+                return null;
+            return Buffer.from(src.slice(comma + 1), 'base64');
+        }
+        const localPath = src.startsWith('file://') ? (0, node_url_1.fileURLToPath)(src) : src;
+        if (!/^https?:\/\//i.test(src)) {
+            if (node_fs_1.default.existsSync(localPath))
+                return node_fs_1.default.readFileSync(localPath);
+            return null;
+        }
+        const response = await fetch(src);
+        if (!response.ok) {
+            logger_1.logger.mark('[图片md] 下载失败 HTTP ' + response.status + ': ' + src.slice(0, 80));
+            return null;
+        }
+        return Buffer.from(await response.arrayBuffer());
+    }
+    catch (error) {
+        logger_1.logger.mark('[图片md] 读取图片失败: ' + String(error?.message ?? error).slice(0, 120));
+        return null;
+    }
+};
+/**
+ * 上传到宿主的 assets，拿到 QQ 能直接取的 https 地址。
+ *
+ * md 里的图片地址**必须是公网 http(s)**：适配器只对 data: 图片做特殊处理
+ * （见 qq-crack 的 renderMarkdownDataImages —— data 图片会被它转回 MEDIA 上传，等于白改），
+ * 相对路径/本地路径手机端也取不到。
+ */
+let warnedNoAssets = false;
+const uploadImage = async (buffer) => {
+    const assets = (0, runtime_1.tryGetRuntime)()?.ctx?.assets;
+    if (!assets?.upload) {
+        /** 没装 assets 服务就整条链路都用不了，提示一次就够，别每张图刷一遍日志 */
+        if (!warnedNoAssets) {
+            warnedNoAssets = true;
+            logger_1.logger.mark('[图片md] 宿主没有 assets 服务（拿不到公网图片地址），图片继续按普通图片段发送');
+        }
+        return null;
+    }
+    const mime = mimeOfBuffer(buffer);
+    const ext = mime === 'image/png' ? '.png' : mime === 'image/gif' ? '.gif' : mime === 'image/webp' ? '.webp' : '.jpg';
+    try {
+        const uploaded = await assets.upload('data:' + mime + ';base64,' + buffer.toString('base64'), 'kkk-md' + ext);
+        const url = typeof uploaded === 'string' ? uploaded : uploaded?.url;
+        return url && /^https?:\/\//i.test(String(url)) ? String(url) : null;
+    }
+    catch (error) {
+        logger_1.logger.mark('[图片md] 上传失败: ' + String(error?.message ?? error).slice(0, 120));
+        return null;
+    }
+};
+/**
+ * 同一张图反复发（推送里的封面、面板卡片…）不用反复上传：
+ * 按图片内容摘要缓存结果，顺带省掉重复的下载与解码。
+ */
+const imageCache = new Map();
+const IMAGE_CACHE_MAX = 200;
+/** 图片段 → md 图片字符串；拿不到尺寸/地址就返回 null（调用方保持原样，别把图弄丢） */
+const markdownImageOf = async (src) => {
+    if (!src)
+        return null;
+    const key = node_crypto_1.default.createHash('md5').update(src).digest('hex');
+    const cached = imageCache.get(key);
+    if (cached)
+        return cached;
+    const buffer = await loadImageBuffer(src);
+    let result = null;
+    if (buffer && buffer.length) {
+        const { width, height } = readImageSize(buffer);
+        /**
+         * **读不出尺寸就不换成 markdown**（退回普通图片段）。
+         *
+         * 用户实测：「必须要 #px，不然手机不会显示」—— 不带尺寸的 md 图片在手机端干脆是空白，
+         * 比糊更糟。所以这里宁可发一张（会被压糊但看得见的）普通图片，
+         * 也不发一张手机上什么都不显示的 markdown 图片。
+         */
+        if (width > 0 && height > 0) {
+            const url = await uploadImage(buffer);
+            if (url)
+                result = '![#' + width + 'px #' + height + 'px](' + url + ')';
+        }
+    }
+    /**
+     * **只缓存成功的结果**：网络 / 图床抖动导致的失败要是也缓存下来，
+     * 这张图之后就一直按普通图片发（糊），得等重启才能恢复。
+     */
+    if (result) {
+        if (imageCache.size >= IMAGE_CACHE_MAX)
+            imageCache.delete(imageCache.keys().next().value);
+        imageCache.set(key, result);
+    }
+    else {
+        logger_1.logger.debug('[图片md] 这张图这次没转成 markdown，按普通图片发送: ' + src.slice(0, 60));
+    }
+    return result;
+};
+exports.markdownImageOf = markdownImageOf;
+/** 清空缓存（测试用） */
+const clearMarkdownImageCache = () => { imageCache.clear(); };
+exports.clearMarkdownImageCache = clearMarkdownImageCache;
+/**
+ * 把一条消息里的图片段改写成 markdown 图片（其它段原样保留、顺序不变）。
+ *
+ * 连续的图片合成**一个** markdown 元素（换行分隔）—— 和官方 QQ 的渲染习惯一致：
+ * 连续图片紧贴显示，视觉上仍是一整张卡片，而不是一张一张孤立的图。
+ *
+ * @param elements 已归一化的消息元素数组
+ * @param platform 适配器平台名（kompat 层从 bot.platform / session.platform 取）
+ * @returns 改写后的数组；不该改或改不动时**原样返回**，绝不让消息发不出去
+ */
+const imagesToMarkdown = async (elements, platform) => {
+    const list = Array.isArray(elements) ? elements : [];
+    if (!list.length)
+        return list;
+    if (!canUseMarkdownImage(platform))
+        return list;
+    if (!list.some(isImageElement))
+        return list;
+    if (list.some((element) => ATTACHMENT_TYPES.has(String(element?.type ?? ''))))
+        return list;
+    const out = [];
+    /** 攒着的连续图片（遇到非图片段就冲出去） */
+    let run = [];
+    const flushRun = () => {
+        // 有图转不动（上传失败等）时 run 里会是空串占位，这里只冲有内容的
+        if (run.length)
+            out.push(segment_1.segment.markdown(run.join(String.fromCharCode(10))));
+        run = [];
+    };
+    for (const element of list) {
+        if (!isImageElement(element)) {
+            flushRun();
+            out.push(element);
+            continue;
+        }
+        const markdown = await (0, exports.markdownImageOf)(srcOf(element));
+        if (markdown) {
+            run.push(markdown);
+        }
+        else {
+            // 转不了就把它自己按图片段发出去，别丢
+            flushRun();
+            out.push(element);
+        }
+    }
+    flushRun();
+    return out;
+};
+exports.imagesToMarkdown = imagesToMarkdown;

package/lib/compat/node-karin.js

@@ -34,6 +34,7 @@ const adapter_info_1 = require("./adapter-info");
 const logger_1 = require("./logger");
 Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
 const forward_collect_1 = require("./forward-collect");
+const imageMarkdown_1 = require("./imageMarkdown");
 const sendError_1 = require("./sendError");
 const runtime_1 = require("./runtime");
 const segment_1 = require("./segment");
@@ -240,14 +241,16 @@ class KkkBot {
             logger_1.logger.debug('当前适配器（' + this.bot.platform + '）不支持合并转发，改为直接发送内容');
         }
         // 退化路径：整条发一次；失败再逐个元素发，尽量把内容送出去
+        /** 退化发送 = 直接发消息，所以图片同样要改走 markdown（见 compat/imageMarkdown） */
+        const fallback = await (0, imageMarkdown_1.imagesToMarkdown)(payload.elements, platformOfBot(this.bot));
         try {
-            const ids = await this.bot.sendMessage(channelId, payload.elements);
+            const ids = await this.bot.sendMessage(channelId, fallback);
             return { messageId: ids[ids.length - 1] ?? '' };
         }
         catch (error) {
             logger_1.logger.warn('整条发送失败，改为逐个元素发送: ' + String(error?.message ?? error));
             let lastId = '';
-            for (const item of payload.elements) {
+            for (const item of fallback) {
                 const ids = await this.bot.sendMessage(channelId, [item]);
                 lastId = ids[ids.length - 1] ?? lastId;
             }
@@ -346,11 +349,14 @@ class KkkBot {
     }
     /** 发送消息（karin 的 bot.sendMsg） */
     async sendMsg(contact, content, _options) {
+        const elements = normalizeContent(content);
         /** 解析结果合并转发：正在收集就攒起来（见 compat/forward-collect） */
-        if ((0, forward_collect_1.collectForward)(peerOf(contact), content))
+        if ((0, forward_collect_1.collectForward)(peerOf(contact), elements))
             return { messageId: forward_collect_1.COLLECTED_MESSAGE_ID };
         const channelId = typeof contact === 'string' ? contact : contact.peer;
-        const ids = await this.bot.sendMessage(channelId, normalizeContent(content));
+        /** 图片统一改走 markdown（见 compat/imageMarkdown） */
+        const outgoing = await (0, imageMarkdown_1.imagesToMarkdown)(elements, platformOfBot(this.bot));
+        const ids = await this.bot.sendMessage(channelId, outgoing);
         // 同 reply/uploadFile：**没拿到消息 ID 就是没发出去**，别当成功返回
         const id = ids?.[ids.length - 1] ?? '';
         if (!id) {
@@ -471,13 +477,21 @@ class Message {
      * 这时自动改用**主动消息**（不带引用，直接往频道里发），失败才把原错误抛出去。
      */
     async reply(content, _options) {
-        const elements = normalizeContent(content);
+        const raw = normalizeContent(content);
         /**
          * 解析结果合并转发：正在收集就攒起来，等解析结束发一条转发（见 compat/forward-collect）。
          * 回一个假的消息 ID：调用方普遍只看「有没有拿到 ID」（例如 uploadFile 判断发送成没成功）。
          */
-        if ((0, forward_collect_1.collectForward)(this.contact?.peer ?? '', elements))
+        if ((0, forward_collect_1.collectForward)(this.contact?.peer ?? '', raw))
             return { messageId: forward_collect_1.COLLECTED_MESSAGE_ID };
+        /**
+         * **图片统一改走 markdown**（上传拿公网地址 + 写死 `#宽px #高px`），见 compat/imageMarkdown。
+         *
+         * 放在这里是因为它是**所有回复的唯一出口** —— 业务代码一律 `e.reply(...)`，
+         * 不用一处处改业务代码。转换不成功会退回原来的图片段（绝不把图弄丢）。
+         * 上面的合并转发分支已经返回了，所以转发节点里仍然是普通图片段。
+         */
+        const elements = await (0, imageMarkdown_1.imagesToMarkdown)(raw, platformOfMessage(this));
         /**
          * 没拿到消息 ID 就是**没发出去**（对齐 qq-chat 的判法）。
          *
@@ -570,6 +584,19 @@ function normalizeContent(content) {
 function peerOf(contact) {
     return typeof contact === 'string' ? contact : String(contact?.peer ?? '');
 }
+/**
+ * 适配器平台名。
+ *
+ * 发送出口要用它判断「这个平台认不认 markdown 图片」（见 compat/imageMarkdown）：
+ * KkkBot 包装上直接转发真实 Bot 的 platform，传 KkkBot 或裸 Bot 都能取到。
+ */
+function platformOfBot(bot) {
+    return String(bot?.platform ?? bot?.bot?.platform ?? '');
+}
+/** 同上，从消息事件取（会话上就带 platform，拿不到再问 bot） */
+function platformOfMessage(message) {
+    return String(message.session?.platform ?? platformOfBot(message.bot));
+}
 /**
  * 合并转发的载荷。
  *
@@ -707,18 +734,22 @@ async function sendMsg(selfId, contact, content, _options) {
             + '），这条消息发不出去。等它重新上线后下次推送会正常发出；如果是长期不在线，检查一下适配器连接');
     }
     const channelId = peerOf(contact);
+    const elements = normalizeContent(content);
     /** 解析结果合并转发：这条也走漏斗（karin.sendMsg 是业务代码另一条常用出口） */
-    if ((0, forward_collect_1.collectForward)(channelId, normalizeContent(content))) {
+    if ((0, forward_collect_1.collectForward)(channelId, elements)) {
         return { messageId: forward_collect_1.COLLECTED_MESSAGE_ID, rawData: [] };
     }
-    const ids = await bot.bot.sendMessage(channelId, normalizeContent(content));
+    /** 图片统一改走 markdown（见 compat/imageMarkdown） */
+    const outgoing = await (0, imageMarkdown_1.imagesToMarkdown)(elements, platformOfBot(bot.bot));
+    const ids = await bot.bot.sendMessage(channelId, outgoing);
     return { messageId: ids[ids.length - 1] ?? '', rawData: ids };
 }
 async function sendMaster(botId, master, content, _options) {
     const bot = resolveBot(botId);
     if (!bot)
         throw new Error('[kkk] 没有可用的机器人实例，无法发送消息');
-    const elements = normalizeContent(content);
+    // 图片统一改走 markdown（见 compat/imageMarkdown）：私聊和群里一样，md 图片才不会被压糊
+    const elements = await (0, imageMarkdown_1.imagesToMarkdown)(normalizeContent(content), platformOfBot(bot.bot));
     const target = bot.bot;
     // Satori 的 Bot 有 sendPrivateMessage；个别适配器没有，退化成私聊频道 id
     const ids = typeof target.sendPrivateMessage === 'function'

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

@@ -34,6 +34,19 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.reloadAmagiConfig = exports.getAmagiClient = exports.xiaohongshuFetcher = exports.kuaishouFetcher = exports.douyinFetcher = exports.bilibiliFetcher = exports.registerAmagiReloadListener = exports.isSoftFailure = exports.softFetch = exports.SOFT_ERROR_CODES = exports.AmagiBase = exports.AmagiError = void 0;
+/**
+ * 解析库（`@ikenxuan/amagi`）的版本要求：**必须 ≥ 7**（当前钉在 7.0.0-beta.5）。
+ *
+ * 线上故障（用户反馈「抖音解析改炸了，同一个 cookie 上游代码能正常解析」）：
+ * 抖音现在要求 web 接口带上 `uifid` 与 `x-secsdk-web-signature`（Argus 风控 SDK 的签名），
+ * 而 npm 上的 **latest 6.6.0 完全没有这套东西**，于是每个抖音接口都被拦成
+ * `403 Blocked by ArgusSecurityPlugin Uifid Not Found`。amagi 把这个响应包成
+ * `{code:500,message:"抖音数据获取失败"}`，插件再翻译成一句「Cookie 失效 / 被风控」——
+ * 用户怎么换 cookie 都没用。
+ *
+ * secsdk / uifid 的实现只存在于 7.x（上游 karin-plugin-kkk 也是把这份新 amagi 打进包里的），
+ * 所以这里**故意钉在 beta 上**：latest 反而是坏的。升级解析库时请一并确认抖音能解析。
+ */
 const amagi_1 = __importStar(require("@ikenxuan/amagi"));
 const node_karin_1 = require("../../../compat/node-karin.js");
 const Config_1 = require("./Config");
@@ -133,16 +146,28 @@ const isFailureEnvelope = (value) => {
 };
 /** 判断是不是 thenable，用来只包装异步方法 */
 const isThenable = (value) => !!value && (typeof value === 'object' || typeof value === 'function') && typeof value.then === 'function';
-/**
- * 递归代理一个 fetcher 对象，把失败信封转成 `throw AmagiError`。返回类型与入参同形 ——
- * 「只保留成功分支」是**类型层**由 {@link ThrowingClient} 声明的，这里只管运行时行为。
- */
-const throwOnFailure = (target) => new Proxy(target, {
-    get(obj, prop) {
-        const value = obj[prop];
+const throwOnFailure = (target) => {
+    /**
+     * **摊平成普通对象，而不是再套一层 Proxy。**
+     *
+     * amagi 自己的 fetcher 就是「带 `ownKeys` / `getOwnPropertyDescriptor` trap、方法按需物化」
+     * 的 Proxy。我们再包一层 Proxy 的话，外面只要做一次 `Object.getOwnPropertyDescriptor`
+     * （打桩时最常见的 `client.douyin.fetcher.parseWork = fn` 就会走到）就会进到里层 trap，
+     * 触发 V8 的 Proxy 不变量检查并抛：
+     *
+     *     TypeError: 'getOwnPropertyDescriptor' on proxy: trap returned descriptor for property
+     *     'parseWork' that is incompatible with the existing property in the proxy target
+     *
+     * 结果是所有「用打桩跑一遍链路」的冒烟集体炸掉（2026-09-26 升级 amagi 7 时踩到）。
+     * 摊平成普通对象既没有这个坑，也顺手把每个方法的包装**缓存**了一次，调用少一层代理。
+     */
+    const wrapped = {};
+    for (const key of Reflect.ownKeys(target)) {
+        const value = target[key];
         if (typeof value === 'function') {
-            return (...args) => {
-                const returned = value.apply(obj, args);
+            const fn = value.bind(target);
+            wrapped[key] = (...args) => {
+                const returned = fn(...args);
                 // 同步方法原样放行：包成 async 会把返回值套一层 Promise，破坏语义
                 if (!isThenable(returned))
                     return returned;
@@ -152,14 +177,14 @@ const throwOnFailure = (target) => new Proxy(target, {
                     return result;
                 });
             };
+            continue;
         }
-        if (value && typeof value === 'object' && !Array.isArray(value)) {
-            return throwOnFailure(value);
-        }
-        return value;
+        wrapped[key] = value && typeof value === 'object' && !Array.isArray(value)
+            ? throwOnFailure(value)
+            : value;
     }
-});
-/** 解析库基类 */
+    return wrapped;
+};
 class AmagiBase {
     /**
      * 原始 v7 客户端。

package/lib/karin/platform/douyin/douyin.js

@@ -106,6 +106,16 @@ class DouYin extends utils_1.Base {
                     const code = raw.code ?? raw.data?.code;
                     const message = raw.message ?? raw.msg ?? raw.data?.message ?? raw.data?.msg;
                     node_karin_2.logger.error('[抖音] 接口没有返回作品详情: ' + JSON.stringify({ code, message, 顶层键: Object.keys(raw) }).slice(0, 300));
+                    /**
+                     * amagi 自己的 500 信封 = 抖音那边没给数据。最常见的成因已经**不是** cookie，
+                     * 而是解析库版本太旧（新版抖音要 uifid + secsdk 签名，旧库会被 Argus 拦成空响应）。
+                     * 日志里点出来，免得下一次又照着「换个 cookie」排查半天。
+                     */
+                    if (Number(code) === 500 && /抖音数据获取失败/.test(String(message ?? ''))) {
+                        node_karin_2.logger.mark('[抖音] 这多半是解析库版本过旧：新版抖音要求 uifid + x-secsdk-web-signature，'
+                            + '旧版会被 Argus 风控拦成 403（Blocked by ArgusSecurityPlugin Uifid Not Found）。'
+                            + '本插件依赖 @ikenxuan/amagi 需要 7.x（见 package.json）');
+                    }
                     throw new Error('抖音没有返回这条作品的数据'
                         + (code !== undefined ? '（错误码 ' + String(code) + (message ? '：' + String(message) : '') + '）' : '')
                         + '，常见原因：Cookie 失效、被风控，或者这条链接已经失效 / 作品已删除。');