koishi-plugin-kkk 3.7.0 → 3.7.2

package/lib/karin/platform/bilibili/interactive-story.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.interactiveChart = exports.renderInteractiveChart = exports.forgetChoiceMessage = exports.toCardGraph = exports.findNode = exports.runInteractiveStory = exports.sendStoryTip = exports.sendInteractiveChoices = exports.buildChoiceMessage = exports.RENDER_CHART_COMMAND = exports.CHOICE_WAIT_SECONDS = void 0;
+exports.interactiveChart = exports.renderInteractiveChart = exports.forgetChoiceMessage = exports.toCardGraph = exports.findNode = exports.runInteractiveStory = exports.sendStoryTip = exports.sendInteractiveChoices = exports.buildChoiceMessage = exports.rememberStoryVideo = exports.RENDER_CHART_COMMAND = exports.CHOICE_WAIT_SECONDS = void 0;
 /**
  * 互动视频的「发选项 → 等选择 → 播下一段」这一段流程。
  *
@@ -60,6 +60,43 @@ exports.CHOICE_WAIT_SECONDS = 180;
 exports.RENDER_CHART_COMMAND = '渲染流程图';
 /** 每个频道最近一条「选项消息」，用于发下一条之前撤回 */
 const lastChoiceMessages = new Map();
+/**
+ * 每个频道最近一条「剧情视频」的消息 ID。
+ *
+ * 用户要求：点一下选项，**上一段视频也要撤回** —— 不然玩几段之后群里躺着一串视频。
+ * 视频是解析链路发的（不是这里发的），所以由那边把它发出去的消息 ID 记进来。
+ */
+const lastStoryVideos = new Map();
+/** 记下刚发出去的剧情视频（由解析链路在上传成功时调用） */
+const rememberStoryVideo = (e, messageId) => {
+    if (!messageId)
+        return;
+    lastStoryVideos.set(sessionKeyOf(e), String(messageId));
+};
+exports.rememberStoryVideo = rememberStoryVideo;
+/**
+ * 取出并清掉「上一条剧情视频」的消息 ID。
+ *
+ * 取出来就删：这条只该被撤回一次，撤回失败也不能反复去点。
+ */
+const takeStoryVideo = (e) => {
+    const key = sessionKeyOf(e);
+    const messageId = lastStoryVideos.get(key);
+    if (messageId)
+        lastStoryVideos.delete(key);
+    return messageId;
+};
+/** 撤回某条消息（失败只记日志，绝不影响剧情） */
+const recallMessage = async (e, messageId) => {
+    if (!messageId)
+        return;
+    try {
+        await e.bot?.recallMsg?.(messageId, channelOf(e));
+    }
+    catch (error) {
+        node_karin_1.logger.debug('[互动视频] 撤回消息失败: ' + String(error?.message ?? error));
+    }
+};
 const platformOf = (e) => String(e?.bot?.bot?.platform ?? e?.bot?.platform ?? e?.platform ?? '');
 const channelOf = (e) => String(e?.contact?.peer ?? e?.guildId ?? '');
 /** 剧情会话 key（和 InteractiveVideo 里的口径一致） */
@@ -315,12 +352,20 @@ const runInteractiveStory = async (options) => {
         entry = { fromCid: currentCid, edgeId: choice.edgeId };
         currentCid = choice.cid;
         if (play) {
+            /**
+             * 用户要求：点一下选项，**上一段视频也要撤回**（群里只留当前这一段）。
+             *
+             * 顺序是「发新的 → 撤旧的」：先取走旧 ID（新的那条发出去时会被重新记上），
+             * 新的发完再撤旧的 —— 中间不会出现「一段视频都没有」的空档。
+             */
+            const previousVideo = takeStoryVideo(target);
             try {
                 await play(currentCid, target);
             }
             catch (error) {
                 node_karin_1.logger.warn('[互动视频] 播放下一段失败（cid=' + currentCid + '）: ' + String(error?.message ?? error));
             }
+            await recallMessage(target, previousVideo);
         }
         node = { ...next, cid: currentCid };
     }

package/lib/ktr/template/bilibili/interactive/components/interactive.js

@@ -19,10 +19,98 @@ const DefaultLayout_1 = require("../../../components/DefaultLayout");
 const BILI_BLUE = '#00aeec';
 /** 顶层分支配色，和思维导图常见做法一致：一条主枝一个颜色 */
 const BRANCH_COLORS = ['#ff7a45', '#3fbf6f', '#22a6b3', '#a259ff', '#f0b429', '#5a8dee', '#e8608d', '#7f8c8d'];
+/**
+ * 版面尺寸。
+ *
+ * **字要大**（用户要求）：这张卡片是 1440px 宽的画布，到了手机聊天框里会被等比缩到
+ * 几百像素宽，图上文字的实际大小 = 字号 / 画布总宽 —— 所以「把字弄大」只能靠
+ * **字号占宽度的比例变大**：
+ *   - 列宽不再跟着字号涨（涨了等于没变），只把字号提上去；
+ *   - 每列能显示几个字 = 列宽 / 字号，字号大了就得少显示几个字，
+ *     标签改成**按像素宽度裁剪**（中文按 1 个字宽算），不让它压到下一列上去。
+ */
 const COL_WIDTH = 260;
-const ROW_HEIGHT = 62;
+const ROW_HEIGHT = 88;
 const PAD_LEFT = 8;
-const PAD_TOP = 20;
+const PAD_TOP = 24;
+/** 节点文字的字号（选项 / 剧情节点） */
+const CHOICE_FONT = 33;
+const NODE_FONT = 34;
+/** 一列文字最多能用到哪里：到下一列的圆圈之前就为止（别压到人家的圆上） */
+const LABEL_WIDTH = COL_WIDTH - 45;
+/**
+ * 一个字符大概占多少个字号宽：中文 / 全角算 1 个，空格 0.3，其余 0.5。
+ * （不用真的去量字体，够用就行 —— 目的是别让文字压到下一列的圆圈上。）
+ */
+const charWidth = (char) => {
+    if (/[\u2e80-\ufffd\ufe30-\ufe4f]/.test(char))
+        return 1;
+    if (char === ' ')
+        return 0.3;
+    return 0.5;
+};
+/** 一段文字排出来大概多宽（像素） */
+const lineWidth = (text, fontSize) => {
+    let total = 0;
+    for (const char of text)
+        total += charWidth(char) * fontSize;
+    return total;
+};
+/**
+ * 把标签排成**最多两行**，两行都装不下才截断加省略号。
+ *
+ * 以前是按「14 个字」裁的：中文一个字差不多一个字号宽，14 个字在 34px 字号下要 470 多个像素，
+ * 而列宽只有 260px —— 标签会直接压到下一列的圆圈上，字挤在一起更看不清。
+ *
+ * 为什么要折行而不是直接截断：字号调大以后一列只能放下六七个字，
+ * 直接砍会把「当前 · 第二题」这种关键信息切掉；折成两行既保住了字大，也保住了内容
+ * （行高已经在 ROW_HEIGHT 里留出来了）。
+ *
+ * @param label 原始文字
+ * @param fontSize 字号（越大能放的字越少）
+ * @param extra 额外可用宽度（最后一列右边没有东西，用它多占一点）
+ * @param suffix 后缀（「（默认）」这种）——**整块跟着最后一行，绝不从中间断开**
+ */
+const wrapLabel = (label, fontSize, extra = 0, suffix = '') => {
+    const budget = LABEL_WIDTH + extra;
+    const lines = [];
+    let current = '';
+    let used = 0;
+    for (const char of label) {
+        const cost = charWidth(char) * fontSize;
+        if (current && used + cost > budget) {
+            lines.push(current);
+            current = '';
+            used = 0;
+            // 两行都满了：把第二行截断加省略号
+            if (lines.length >= 2) {
+                lines[1] = lines[1] + '…';
+                break;
+            }
+        }
+        current += char;
+        used += cost;
+    }
+    if (current) {
+        if (lines.length >= 2)
+            lines[1] = lines[1] + '…';
+        else
+            lines.push(current);
+    }
+    if (!lines.length)
+        lines.push('');
+    /** 后缀单独占一行也行（它很短），实在没地方了就跟在最后一行后面 */
+    if (suffix) {
+        const last = lines[lines.length - 1];
+        if (lineWidth(last + suffix, fontSize) <= budget)
+            lines[lines.length - 1] = last + suffix;
+        else if (lines.length < 2)
+            lines.push(suffix);
+        else
+            lines[lines.length - 1] = last + suffix;
+    }
+    return lines;
+};
 /** 把剧情图摊平成「一行一项」的列表，并算好每个叶子占用的行号 */
 const flatten = (root, path, rootLabel) => {
     const items = [];
@@ -116,7 +204,7 @@ exports.BilibiliInteractive = react_1.default.memo((props) => {
             byId.set(item.id, item);
     const rowY = (row) => PAD_TOP + row * ROW_HEIGHT + ROW_HEIGHT / 2;
     const colX = (item) => PAD_LEFT + item.depth * COL_WIDTH;
-    return ((0, jsx_runtime_1.jsx)(DefaultLayout_1.DefaultLayout, { ...props, children: (0, jsx_runtime_1.jsxs)("div", { style: { position: 'relative', zIndex: 10, padding: '64px 56px 48px' }, children: [(0, jsx_runtime_1.jsxs)("div", { style: { display: 'flex', alignItems: 'center', gap: 24 }, children: [(0, jsx_runtime_1.jsx)("span", { style: { borderRadius: 999, padding: '12px 28px', fontSize: 26, fontWeight: 900, letterSpacing: '0.18em', background: 'rgba(0,174,236,0.14)', color: BILI_BLUE }, children: "\u4E92\u52A8\u89C6\u9891" }), (0, jsx_runtime_1.jsxs)("span", { style: { fontSize: 26, fontWeight: 700, opacity: 0.42 }, children: ["\u7B2C ", data.step, " \u6BB5 \u00B7 \u5168\u90E8\u5267\u60C5\u6D41\u7A0B"] })] }), (0, jsx_runtime_1.jsx)("h1", { style: { margin: '28px 0 0', fontSize: 48, fontWeight: 900, lineHeight: 1.3, wordBreak: 'break-word' }, children: data.title }), path.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { style: { marginTop: 18, fontSize: 27, fontWeight: 600, opacity: 0.5, wordBreak: 'break-word' }, children: ["\u5DF2\u9009\uFF1A", path.join(' → ')] })), flat && ((0, jsx_runtime_1.jsxs)("svg", { viewBox: '0 0 ' + width + ' ' + height, width: '100%', style: { marginTop: 26, display: 'block', overflow: 'visible' }, role: 'img', children: [flat.items.map((item) => {
+    return ((0, jsx_runtime_1.jsx)(DefaultLayout_1.DefaultLayout, { ...props, children: (0, jsx_runtime_1.jsxs)("div", { style: { position: 'relative', zIndex: 10, padding: '64px 56px 48px' }, children: [(0, jsx_runtime_1.jsxs)("div", { style: { display: 'flex', alignItems: 'center', gap: 24 }, children: [(0, jsx_runtime_1.jsx)("span", { style: { borderRadius: 999, padding: '12px 28px', fontSize: 26, fontWeight: 900, letterSpacing: '0.18em', background: 'rgba(0,174,236,0.14)', color: BILI_BLUE }, children: "\u4E92\u52A8\u89C6\u9891" }), (0, jsx_runtime_1.jsxs)("span", { style: { fontSize: 26, fontWeight: 700, opacity: 0.42 }, children: ["\u7B2C ", data.step, " \u6BB5 \u00B7 \u5168\u90E8\u5267\u60C5\u6D41\u7A0B"] })] }), (0, jsx_runtime_1.jsx)("h1", { style: { margin: '28px 0 0', fontSize: 48, fontWeight: 900, lineHeight: 1.3, wordBreak: 'break-word' }, children: data.title }), path.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { style: { marginTop: 18, fontSize: 32, fontWeight: 600, opacity: 0.5, wordBreak: 'break-word' }, children: ["\u5DF2\u9009\uFF1A", path.join(' → ')] })), flat && ((0, jsx_runtime_1.jsxs)("svg", { viewBox: '0 0 ' + width + ' ' + height, width: '100%', style: { marginTop: 26, display: 'block', overflow: 'visible' }, role: 'img', children: [flat.items.map((item) => {
                             if (!item.parent)
                                 return null;
                             const parent = byId.get(item.parent);
@@ -131,7 +219,13 @@ exports.BilibiliInteractive = react_1.default.memo((props) => {
                             const x = colX(item);
                             const y = rowY(item.row);
                             const isChoice = item.kind === 'choice';
-                            return ((0, jsx_runtime_1.jsxs)("g", { children: [(0, jsx_runtime_1.jsx)("circle", { cx: x, cy: y, r: isChoice ? 9 : 13, fill: item.walked || item.kind === 'root' ? item.color : '#ffffff', stroke: item.color, strokeWidth: 4 }), (0, jsx_runtime_1.jsxs)("text", { x: x + (isChoice ? 22 : 26), y: y + 9, fontSize: isChoice ? 27 : 29, fontWeight: item.walked || item.kind === 'root' ? 900 : 600, fill: item.walked ? item.color : 'currentColor', opacity: item.walked || item.kind === 'root' ? 1 : 0.82, children: [item.label.length > 14 ? item.label.slice(0, 14) + '…' : item.label, item.isDefault ? '（默认）' : ''] })] }, 'node-' + item.id));
-                        })] })), !flat && (data.choices ?? []).map((choice, index) => ((0, jsx_runtime_1.jsxs)("div", { style: { marginTop: index === 0 ? 30 : 18, fontSize: 36, fontWeight: 800 }, children: [choice.label, " ", choice.text, choice.isDefault ? '（默认）' : ''] }, choice.label + index))), (data.truncated || graph?.truncated) && ((0, jsx_runtime_1.jsx)("div", { style: { marginTop: 26, fontSize: 25, fontWeight: 600, opacity: 0.55 }, children: "\u5267\u60C5\u592A\u957F\uFF0C\u56FE\u4E0A\u53EA\u753B\u4E86\u524D\u534A\u90E8\u5206\u5206\u652F" })), (0, jsx_runtime_1.jsxs)("div", { style: { marginTop: 22, display: 'flex', alignItems: 'center', gap: 14, fontSize: 25, fontWeight: 600, opacity: 0.52 }, children: [(0, jsx_runtime_1.jsx)("span", { style: { display: 'inline-block', width: 26, height: 5, borderRadius: 999, background: BILI_BLUE } }), "\u9AD8\u4EAE\u7684\u662F\u4F60\u5DF2\u7ECF\u8D70\u8FC7\u7684\u8DEF"] }), data.notice && ((0, jsx_runtime_1.jsx)("div", { style: { marginTop: 18, borderRadius: 20, padding: '16px 28px', fontSize: 25, fontWeight: 600, opacity: 0.62, background: 'rgba(127,127,127,0.12)' }, children: data.notice }))] }) }));
+                            const font = isChoice ? CHOICE_FONT : NODE_FONT;
+                            const textX = x + (isChoice ? 22 : 26);
+                            /** 「（默认）」也算进这一列的可视宽度里，免得它把第二行挤出去 */
+                            const lines = wrapLabel(item.label, font, item.depth >= depth ? 56 : 0, item.isDefault ? '（默认）' : '');
+                            /** 一行时基线和以前一样；两行时整块往上挪一点，让两行都贴着圆圈居中 */
+                            const baseline = lines.length > 1 ? y - font * 0.15 : y + font * 0.35;
+                            return ((0, jsx_runtime_1.jsxs)("g", { children: [(0, jsx_runtime_1.jsx)("circle", { cx: x, cy: y, r: isChoice ? 9 : 13, fill: item.walked || item.kind === 'root' ? item.color : '#ffffff', stroke: item.color, strokeWidth: 4 }), (0, jsx_runtime_1.jsx)("text", { x: textX, y: baseline, fontSize: font, fontWeight: item.walked || item.kind === 'root' ? 900 : 600, fill: item.walked ? item.color : 'currentColor', opacity: item.walked || item.kind === 'root' ? 1 : 0.82, children: lines.map((line, index) => ((0, jsx_runtime_1.jsx)("tspan", { x: textX, dy: index === 0 ? 0 : Math.round(font * 1.05), children: line }, 'line-' + index))) })] }, 'node-' + item.id));
+                        })] })), !flat && (data.choices ?? []).map((choice, index) => ((0, jsx_runtime_1.jsxs)("div", { style: { marginTop: index === 0 ? 30 : 18, fontSize: 36, fontWeight: 800 }, children: [choice.label, " ", choice.text, choice.isDefault ? '（默认）' : ''] }, choice.label + index))), (data.truncated || graph?.truncated) && ((0, jsx_runtime_1.jsx)("div", { style: { marginTop: 26, fontSize: 30, fontWeight: 600, opacity: 0.55 }, children: "\u5267\u60C5\u592A\u957F\uFF0C\u56FE\u4E0A\u53EA\u753B\u4E86\u524D\u534A\u90E8\u5206\u5206\u652F" })), (0, jsx_runtime_1.jsxs)("div", { style: { marginTop: 22, display: 'flex', alignItems: 'center', gap: 14, fontSize: 30, fontWeight: 600, opacity: 0.52 }, children: [(0, jsx_runtime_1.jsx)("span", { style: { display: 'inline-block', width: 30, height: 6, borderRadius: 999, background: BILI_BLUE } }), "\u9AD8\u4EAE\u7684\u662F\u4F60\u5DF2\u7ECF\u8D70\u8FC7\u7684\u8DEF"] }), data.notice && ((0, jsx_runtime_1.jsx)("div", { style: { marginTop: 18, borderRadius: 20, padding: '16px 28px', fontSize: 30, fontWeight: 600, opacity: 0.62, background: 'rgba(127,127,127,0.12)' }, children: data.notice }))] }) }));
 });
 exports.BilibiliInteractive.displayName = 'BilibiliInteractive';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "3.7.0",
+  "version": "3.7.2",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/scripts/probe-chart-wrap.cjs

@@ -0,0 +1,33 @@
+/**
+ * 临时探针：把剧情图用一个**很长的题目**渲染一遍，确认标签会折成两行、内容不丢。
+ */
+const path = require('node:path')
+const React = require('react')
+const { renderToStaticMarkup } = require('react-dom/server')
+const pluginRoot = path.resolve(__dirname, '..')
+const runtime = require(path.join(pluginRoot, 'lib/compat/runtime.js'))
+const noop = () => {}
+runtime.bindRuntime({ ctx: { get: () => undefined, logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }), config: {}, pluginRoot, dataRoot: require('node:os').tmpdir() } })
+const template = require(path.join(pluginRoot, 'lib/ktr/template/bilibili/interactive/index.js'))
+const Root = require(path.join(pluginRoot, 'lib/karin/root.js')).Root
+const data = {
+  title: '测试：很长的题目',
+  step: 1,
+  path: ['向左走'],
+  graph: {
+    question: '开场',
+    choices: [
+      { label: 'A', text: '向左走', isDefault: true, children: [{ question: '你要不要现在就跟着她一起上楼去看看那个房间', isLeaf: false, choices: [] }] },
+      { label: 'B', text: '向右挖', children: [{ question: '结局二', isLeaf: true, choices: [] }] }
+    ]
+  }
+}
+const ctx = { theme: 'light', scale: 1, version: { plugin: 'koishi-plugin', pluginName: 'kkk', pluginVersion: Root.pluginVersion, releaseType: 'Stable', poweredBy: 'Koishi', frameworkVersion: Root.karinVersion } }
+const def = template.default ?? template
+const html = renderToStaticMarkup(React.createElement(def.component, { data, ctx }))
+const tspans = html.match(/<tspan[^>]*>[^<]*<\/tspan>/g) || []
+console.log('tspan 数量:', tspans.length)
+console.log('折行的标签:')
+for (const item of tspans.slice(0, 12)) console.log('   ', item.replace(/<[^>]+>/g, ' | '))
+console.log('（默认）完整出现:', html.includes('（默认）'))
+console.log('长题目开头出现:', html.includes('你要不要现在就'))

package/scripts/smoke-interactive-story.cjs

@@ -145,6 +145,33 @@ const main = async () => {
   check('结局时撤回了上一条选项消息', state.recalled.length >= 1, JSON.stringify(state.recalled))
   check('结局有提示', state.replies.some((item) => String(item).includes('结局')), JSON.stringify(state.replies).slice(0, 200))
 
+  console.log('== 点一下选项：上一段视频也要撤回（用户要求）==')
+  {
+    const { e, state } = makeEvent('qqguild')
+    /** 解析链路发第一段视频时记下的消息 ID */
+    story.rememberStoryVideo(e, 'vid-root')
+    const playedVideo = []
+    const r = await runInteractiveStory({
+      e,
+      bvid: 'BV1xDgL6SEzk',
+      graphVersion: 1722536,
+      rootCid: 41156151510,
+      title: '史蒂夫的选择',
+      request: requestFor({ root: rootPayload, 11: leafPayload, 12: middlePayload }),
+      wait: async () => 'A',
+      play: async (cid) => {
+        playedVideo.push(cid)
+        /** 模拟解析链路：新一段视频发出去后把它的消息 ID 记进来 */
+        story.rememberStoryVideo(e, 'vid-' + cid)
+      }
+    })
+    check('选完播了下一段', playedVideo.join(',') === '101', playedVideo.join(','))
+    check('上一段视频被撤回了（群里只留当前这一段）', state.recalled.includes('vid-root'), JSON.stringify(state.recalled))
+    check('刚发出去的那一段没有被误撤', !state.recalled.includes('vid-101'), JSON.stringify(state.recalled))
+    check('同一条只撤一次（取走即清）', state.recalled.filter((id) => id === 'vid-root').length === 1, JSON.stringify(state.recalled))
+    check('剧情照常走完', r.ended === 'leaf', r.ended)
+  }
+
   console.log('== 结局那一段也要给上层画图的机会 ==')
   const endingHook = makeEvent('qqguild')
   const hookCalls = []

package/scripts/smoke-md-image.cjs

@@ -0,0 +1,206 @@
+/**
+ * 冒烟测试：**图片统一改走 markdown**（用户要求）。
+ *
+ * 背景（用户反馈）：
+ *   - 「所有的图片发送都要走 md，不然太模糊了」—— QQ 的普通图片消息会被压糊，md 图片不会；
+ *   - 「![#px大小#px大小]() 必须要 #px，不然手机不会显示」—— md 图片必须写死尺寸。
+ * 所以 compat 的发送出口会把 image 段改写成 `![#宽px #高px](https://…)`（见 compat/imageMarkdown.ts）。
+ *
+ * 这里验四件事：
+ *   1. 尺寸真的读出来了（PNG / JPEG 两种头），并且写进了 md；
+ *   2. **只在认 markdown 的平台上改**（qq 改；onebot / qqguild / 未知平台一律不动）；
+ *   3. 该跳过的都跳过（消息里有视频/语音/文件时不能改，否则 md 内容会被适配器丢掉）；
+ *   4. 改不动就**原样发**（上传失败、没有 assets 服务），绝不把图弄丢；
+ *   5. 走的是真出口：`Message.reply` / `KkkBot.sendMsg` 里就要已经改好了。
+ *
+ * 用法：node scripts/smoke-md-image.cjs
+ */
+const fs = require('node:fs')
+const os = require('node:os')
+const path = require('node:path')
+
+const pluginRoot = path.resolve(__dirname, '..')
+
+let failures = 0
+const check = (name, ok, detail) => {
+  console.log((ok ? '  ✅ ' : '  ❌ ') + name + (detail ? '  —— ' + detail : ''))
+  if (!ok) failures++
+}
+
+const runtime = require(path.join(pluginRoot, 'lib/compat/runtime.js'))
+const segment = require(path.join(pluginRoot, 'lib/compat/segment.js')).segment
+const mdImage = require(path.join(pluginRoot, 'lib/compat/imageMarkdown.js'))
+const nodeKarin = require(path.join(pluginRoot, 'lib/compat/node-karin.js'))
+
+/** 一个「够用」的 PNG：只补到 readImageSize 要读的字段（IHDR 的宽高） */
+const fakePng = (width, height) => {
+  const buffer = Buffer.alloc(32)
+  Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]).copy(buffer, 0)
+  buffer.writeUInt32BE(13, 8)
+  buffer.write('IHDR', 12, 'latin1')
+  buffer.writeUInt32BE(width, 16)
+  buffer.writeUInt32BE(height, 20)
+  return buffer
+}
+
+/** 一个「够用」的 JPEG：SOF0 段里有高宽即可 */
+const fakeJpeg = (width, height) => {
+  const buffer = Buffer.alloc(20)
+  buffer[0] = 0xff
+  buffer[1] = 0xd8
+  buffer[2] = 0xff
+  buffer[3] = 0xc0
+  buffer.writeUInt16BE(17, 4)
+  buffer[6] = 0x08
+  buffer.writeUInt16BE(height, 7)
+  buffer.writeUInt16BE(width, 9)
+  return buffer
+}
+
+const dataUri = (buffer) => 'data:image/png;base64,' + buffer.toString('base64')
+
+let uploads = 0
+let uploadShouldFail = false
+const noop = () => {}
+const ctx = {
+  get: () => undefined,
+  logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }),
+  assets: {
+    upload: async (dataUriText, name) => {
+      uploads++
+      if (uploadShouldFail) throw new Error('assets 挂了')
+      return 'https://assets.example.com/' + String(name)
+    }
+  }
+}
+runtime.bindRuntime({ ctx, config: {}, pluginRoot, dataRoot: os.tmpdir() })
+
+const textOf = (element) => {
+  if (!element) return ''
+  if (element.type === 'text') return element.attrs?.content ?? ''
+  return (element.children ?? []).map(textOf).join('')
+}
+
+const run = async () => {
+  console.log('— 尺寸读得出来 —')
+  mdImage.clearMarkdownImageCache()
+  uploads = 0
+  const pngMd = await mdImage.markdownImageOf(dataUri(fakePng(600, 400)))
+  check('PNG 宽高写进了 md', pngMd === '![#600px #400px](https://assets.example.com/kkk-md.png)', pngMd)
+  check('PNG 按 image/png 上传（扩展名跟着走）', String(pngMd).endsWith('.png)'), pngMd)
+
+  const jpegMd = await mdImage.markdownImageOf(dataUri(fakeJpeg(2880, 1440)))
+  check('JPEG 宽高写进了 md', jpegMd === '![#2880px #1440px](https://assets.example.com/kkk-md.jpg)', jpegMd)
+
+  const base64Md = await mdImage.markdownImageOf('base64://' + fakePng(12, 34).toString('base64'))
+  check('base64:// 也认', base64Md === '![#12px #34px](https://assets.example.com/kkk-md.png)', base64Md)
+
+  const file = path.join(os.tmpdir(), 'kkk-md-smoke-' + Date.now() + '.png')
+  fs.writeFileSync(file, fakePng(8, 9))
+  const fileMd = await mdImage.markdownImageOf(file)
+  check('本地路径也认', fileMd === '![#8px #9px](https://assets.example.com/kkk-md.png)', fileMd)
+  fs.rmSync(file, { force: true })
+
+  console.log('— 同一张图不重复上传 —')
+  mdImage.clearMarkdownImageCache()
+  uploads = 0
+  const again = dataUri(fakePng(100, 50))
+  await mdImage.markdownImageOf(again)
+  await mdImage.markdownImageOf(again)
+  check('第二次走缓存（只上传一次）', uploads === 1, 'uploads=' + uploads)
+
+  console.log('— 只改认 markdown 的平台 —')
+  const image = () => segment.image(dataUri(fakePng(600, 400)))
+  for (const platform of ['onebot', 'napcat', 'lagrange', 'go-cqhttp', 'chronocat', 'mirai', 'qqguild', 'sandbox', '']) {
+    const list = [image()]
+    const out = await mdImage.imagesToMarkdown(list, platform)
+    check(platform + ' 平台保持图片段', out.length === 1 && out[0] === list[0] && out[0].type === 'img')
+  }
+  const qqOut = await mdImage.imagesToMarkdown([image()], 'qq')
+  check('qq 平台改成 markdown', qqOut.length === 1 && qqOut[0].type === 'markdown', qqOut[0]?.type)
+  check('qq 平台的 md 里带 #宽px #高px', /!\[#600px #400px\]\(https:\/\//.test(textOf(qqOut[0])), textOf(qqOut[0]))
+
+  console.log('— 该跳过的都跳过 —')
+  const withVideo = [image(), segment.video('data:video/mp4;base64,AAAA')]
+  const videoOut = await mdImage.imagesToMarkdown(withVideo, 'qq')
+  check('带视频的消息不动（md 会被适配器丢掉）', videoOut[0].type === 'img' && videoOut[1].type === 'video')
+  const withAudio = [image(), segment.audio('data:audio/mpeg;base64,AAAA')]
+  check('带语音的消息不动', (await mdImage.imagesToMarkdown(withAudio, 'qq'))[0].type === 'img')
+  const noImage = [segment.text('只有文字')]
+  const noImageOut = await mdImage.imagesToMarkdown(noImage, 'qq')
+  check('没有图片就不进这套逻辑', noImageOut[0] === noImage[0])
+
+  console.log('— 顺序与合并 —')
+  const mixed = [segment.text('看图：'), image(), segment.text('就这些')]
+  const mixedOut = await mdImage.imagesToMarkdown(mixed, 'qq')
+  check('文字 / md 图片 / 文字 顺序不变',
+    mixedOut.length === 3 && mixedOut[0].type === 'text' && mixedOut[1].type === 'markdown' && mixedOut[2].type === 'text',
+    mixedOut.map((element) => element.type).join(','))
+  const twice = await mdImage.imagesToMarkdown([image(), image(), segment.text('尾')], 'qq')
+  check('连续图片合成一条 markdown（两行）',
+    twice.length === 2 && twice[0].type === 'markdown' && String(textOf(twice[0])).split(String.fromCharCode(10)).length === 2,
+    twice.map((element) => element.type).join(','))
+
+  console.log('— 改不动就原样发，绝不丢图 —')
+  uploadShouldFail = true
+  mdImage.clearMarkdownImageCache()
+  const failedList = [image()]
+  const failedOut = await mdImage.imagesToMarkdown(failedList, 'qq')
+  check('上传失败时退回图片段', failedOut.length === 1 && failedOut[0] === failedList[0] && failedOut[0].type === 'img')
+  uploadShouldFail = false
+
+  const savedCtx = ctx.assets
+  delete ctx.assets
+  mdImage.clearMarkdownImageCache()
+  const noAssetsList = [image()]
+  const noAssetsOut = await mdImage.imagesToMarkdown(noAssetsList, 'qq')
+  check('没有 assets 服务时退回图片段', noAssetsOut[0] === noAssetsList[0] && noAssetsOut[0].type === 'img')
+  ctx.assets = savedCtx
+
+  console.log('— 读不出尺寸的图，宁可发普通图片 —')
+  mdImage.clearMarkdownImageCache()
+  const unknown = Buffer.alloc(64, 0x42)
+  const unknownList = [segment.image('data:application/octet-stream;base64,' + unknown.toString('base64'))]
+  const unknownOut = await mdImage.imagesToMarkdown(unknownList, 'qq')
+  check('认不出格式的图保持图片段（不带尺寸的 md 手机上不显示）',
+    unknownOut.length === 1 && unknownOut[0] === unknownList[0] && unknownOut[0].type === 'img')
+
+  console.log('— 真出口上就已经改好了（Message.reply / KkkBot.sendMsg） —')
+  const sent = []
+  const makeBot = (platform) => new nodeKarin.KkkBot({
+    platform,
+    selfId: '1',
+    sendMessage: async (channelId, elements) => {
+      sent.push({ channelId, elements })
+      return ['mid-1']
+    }
+  })
+
+  const qqMessage = new nodeKarin.Message({ bot: makeBot('qq'), contact: { peer: 'group:1' } })
+  await qqMessage.reply([segment.image(dataUri(fakePng(320, 240)))])
+  check('Message.reply 发出去的是 markdown',
+    sent.length === 1 && sent[0].elements.length === 1 && sent[0].elements[0].type === 'markdown',
+    sent[0]?.elements?.map((element) => element.type).join(','))
+  check('Message.reply 的 md 带尺寸', /!\[#320px #240px\]/.test(textOf(sent[0].elements[0])), textOf(sent[0].elements[0]))
+
+  sent.length = 0
+  const onebotBot = makeBot('onebot')
+  await onebotBot.sendMsg('group:1', [segment.image(dataUri(fakePng(320, 240)))])
+  check('OneBot 的 KkkBot.sendMsg 保持图片段',
+    sent.length === 1 && sent[0].elements[0].type === 'img', sent[0]?.elements?.[0]?.type)
+
+  sent.length = 0
+  const qqBot = makeBot('qq')
+  await qqBot.sendMsg('group:1', [segment.image(dataUri(fakePng(64, 64)))])
+  check('qq 的 KkkBot.sendMsg 也改成了 markdown',
+    sent[0]?.elements?.[0]?.type === 'markdown', sent[0]?.elements?.[0]?.type)
+
+  console.log('')
+  console.log(failures === 0 ? '全部通过' : failures + ' 项失败')
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+run().catch((error) => {
+  console.error(error)
+  process.exit(1)
+})