koishi-plugin-kkk 3.4.2 → 3.5.0

package/lib/ktr/template/other/handlerError/components/handlerError.js

@@ -379,7 +379,7 @@ const handlerError = (props) => {
                                 }, children: (0, jsx_runtime_1.jsx)("pre", { className: "text-2xl leading-relaxed whitespace-pre-wrap break-all font-mono", style: { color: dark ? 'rgba(255,255,255,0.85)' : 'rgba(127,29,29,0.9)' }, dangerouslySetInnerHTML: { __html: stackHtml } }) })] }), data.error?.dump && ((0, jsx_runtime_1.jsxs)("div", { className: "mb-14", children: [(0, jsx_runtime_1.jsx)(SectionTitle, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.Braces, { size: 36, style: { color: mutedColor } }), en: "Object Dump", zh: "\u5BF9\u8C61\u8F6C\u50A8", color: mutedColor }), (0, jsx_runtime_1.jsx)("div", { className: "p-10 rounded-[36px]", style: { backgroundColor: dark ? 'rgba(0,0,0,0.2)' : 'rgba(255,255,255,0.5)' }, children: (0, jsx_runtime_1.jsx)("pre", { className: "text-2xl leading-relaxed whitespace-pre-wrap break-all font-mono", style: { color: dark ? 'rgba(255,255,255,0.85)' : 'rgba(127,29,29,0.9)' }, dangerouslySetInnerHTML: { __html: convertAnsiToHtml(data.error.dump) } }) })] })), data.logs && data.logs.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "mb-14", children: [(0, jsx_runtime_1.jsx)(SectionTitle, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.FileText, { size: 36, style: { color: mutedColor } }), en: "Execution Logs", zh: "\u6267\u884C\u65E5\u5FD7", color: mutedColor }), (0, jsx_runtime_1.jsx)("div", { className: "space-y-6", children: data.logs.map((log, index) => {
                                     const theme = getLogLevelTheme(log.level, dark);
                                     return ((0, jsx_runtime_1.jsxs)("fieldset", { className: `relative rounded-3xl ${theme.bgClass} border-2 ${theme.borderClass} p-6`, children: [(0, jsx_runtime_1.jsxs)("legend", { className: "flex items-center gap-2 ml-4", children: [(0, jsx_runtime_1.jsx)("span", { className: `w-2 h-6 rounded-full -mr-1.5 ${theme.dotClass}` }), (0, jsx_runtime_1.jsxs)("span", { className: "flex items-center gap-2 px-3", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Clock, { size: 18, className: theme.iconClass }), (0, jsx_runtime_1.jsx)("span", { className: `text-xl font-mono font-medium ${theme.textClass}`, children: log.timestamp })] }), (0, jsx_runtime_1.jsx)("span", { className: `w-2 h-6 rounded-full -ml-1.5 ${theme.dotClass}` })] }), (0, jsx_runtime_1.jsx)("div", { className: "absolute bottom-2 right-6 pointer-events-none", children: (0, jsx_runtime_1.jsxs)("span", { className: `text-6xl font-black uppercase leading-none tracking-tight ${theme.levelClass}`, children: [log.level, "\u300D"] }) }), (0, jsx_runtime_1.jsx)("div", { className: "relative z-1 text-2xl font-mono whitespace-pre-wrap break-all leading-relaxed", style: { color: dark ? 'rgba(255,255,255,0.88)' : 'rgba(0,0,0,0.82)' }, dangerouslySetInnerHTML: { __html: convertAnsiToHtml(log.message) } })] }, index));
-                                }) })] })), (0, jsx_runtime_1.jsxs)("div", { className: "mt-auto pt-12", style: { borderTop: `2px solid ${dark ? 'rgba(248,113,113,0.15)' : 'rgba(252,165,165,0.3)'}` }, children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center flex-wrap gap-x-16 gap-y-6 mb-12", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-6", children: [(0, jsx_runtime_1.jsx)("img", { src: data.frameworkLogo ?? '/image/frame-logo.png', className: "h-16 w-auto", alt: "Framework" }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: mutedColor }, children: "Framework / \u6846\u67B6\u7248\u672C" }), (0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-bold", style: { color: accentColor }, children: data.frameworkVersion })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-6", children: [(0, jsx_runtime_1.jsxs)("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 230 221", className: "h-16 w-auto", style: { color: accentColor }, children: [(0, jsx_runtime_1.jsx)("path", { d: "M132.75,87.37l-53.72-53.37c-4.66-4.63-1.38-12.58,5.18-12.58h115.13c6.57,0,9.84,7.95,5.18,12.58l-53.72,53.37c-4.99,4.96-13.06,4.96-18.05,0Z", fill: "currentColor" }), (0, jsx_runtime_1.jsx)("path", { d: "M28.49,186.89l.03-51.42c-.02-6.57,7.92-9.87,12.56-5.23l57.02,57.02c4.64,4.64,1.34,12.41-5.23,12.39h-51.42c-7.04-.02-12.94-5.72-12.96-12.76Z", fill: "currentColor" }), (0, jsx_runtime_1.jsx)("path", { d: "M41.54,23.68l163.04,163.05c4.78,4.78,1.39,12.95-5.36,12.94h-47.88c-9.69,0-18.99-3.86-25.84-10.71L39.3,102.75c-6.85-6.85-10.7-16.15-10.7-25.84V29.04c0-6.76,8.16-10.14,12.94-5.36Z", fill: "currentColor" })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: mutedColor }, children: "Plugin / \u63D2\u4EF6\u7248\u672C" }), (0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-bold", style: { color: accentColor }, children: data.pluginVersion })] })] }), data.adapterInfo && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-6", children: [getAdapterLogo(data.adapterInfo.name), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: mutedColor }, children: "Adapter / \u9002\u914D\u5668" }), (0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-bold truncate", style: { color: accentColor }, children: data.adapterInfo.name })] })] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-10 text-xl mb-12", style: { color: mutedColor }, children: [data.buildTime && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3", children: [(0, jsx_runtime_1.jsx)(md_1.MdSchedule, { size: 24 }), (0, jsx_runtime_1.jsxs)("span", { children: ["Built Time: ", data.buildTime, " \u4E8E", ' ', (0, date_fns_1.formatDistanceToNow)((0, date_fns_1.parse)(data.buildTime, 'yyyy年MM月dd日 HH:mm', new Date()), { locale: locale_1.zhCN }), "\u524D"] })] })), data.commitHash && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.GitBranch, { size: 24 }), (0, jsx_runtime_1.jsxs)("span", { children: ["Commit Hash: ", data.commitHash] })] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "p-10 rounded-[36px]", style: { backgroundColor: dark ? 'rgba(0,0,0,0.2)' : 'rgba(255,255,255,0.5)' }, children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-end justify-between mb-6", children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-semibold mb-2", style: { color: accentColor }, children: "Need Help? / \u9700\u8981\u5E2E\u52A9\uFF1F" }), (0, jsx_runtime_1.jsx)("p", { className: "text-2xl", style: { color: secondaryColor }, children: data.report
+                                }) })] })), (0, jsx_runtime_1.jsxs)("div", { className: "mt-auto pt-12", style: { borderTop: `2px solid ${dark ? 'rgba(248,113,113,0.15)' : 'rgba(252,165,165,0.3)'}` }, children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center flex-wrap gap-x-16 gap-y-6 mb-12", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-6", children: [(0, jsx_runtime_1.jsx)("img", { src: data.frameworkLogo ?? '/image/frame-logo.png', className: "h-16 w-auto", alt: "Framework" }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: mutedColor }, children: "Framework / \u6846\u67B6\u7248\u672C" }), (0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-bold", style: { color: accentColor }, children: data.frameworkVersion })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-6", children: [(0, jsx_runtime_1.jsxs)("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 230 221", className: "h-16 w-auto", style: { color: accentColor }, children: [(0, jsx_runtime_1.jsx)("path", { d: "M132.75,87.37l-53.72-53.37c-4.66-4.63-1.38-12.58,5.18-12.58h115.13c6.57,0,9.84,7.95,5.18,12.58l-53.72,53.37c-4.99,4.96-13.06,4.96-18.05,0Z", fill: "currentColor" }), (0, jsx_runtime_1.jsx)("path", { d: "M28.49,186.89l.03-51.42c-.02-6.57,7.92-9.87,12.56-5.23l57.02,57.02c4.64,4.64,1.34,12.41-5.23,12.39h-51.42c-7.04-.02-12.94-5.72-12.96-12.76Z", fill: "currentColor" }), (0, jsx_runtime_1.jsx)("path", { d: "M41.54,23.68l163.04,163.05c4.78,4.78,1.39,12.95-5.36,12.94h-47.88c-9.69,0-18.99-3.86-25.84-10.71L39.3,102.75c-6.85-6.85-10.7-16.15-10.7-25.84V29.04c0-6.76,8.16-10.14,12.94-5.36Z", fill: "currentColor" })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: mutedColor }, children: "Plugin / \u63D2\u4EF6\u7248\u672C" }), (0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-bold", style: { color: accentColor }, children: data.pluginVersion })] })] }), data.adapterInfo && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-6", children: [getAdapterLogo(data.adapterInfo.name), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: mutedColor }, children: "Adapter / \u9002\u914D\u5668" }), (0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-bold truncate", style: { color: accentColor }, children: data.adapterInfo.name }), data.adapterInfo.version && ((0, jsx_runtime_1.jsxs)("p", { className: "text-2xl font-bold truncate", style: { color: mutedColor }, children: ["v", data.adapterInfo.version] }))] })] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-10 text-xl mb-12", style: { color: mutedColor }, children: [data.buildTime && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3", children: [(0, jsx_runtime_1.jsx)(md_1.MdSchedule, { size: 24 }), (0, jsx_runtime_1.jsxs)("span", { children: ["Built Time: ", data.buildTime, " \u4E8E", ' ', (0, date_fns_1.formatDistanceToNow)((0, date_fns_1.parse)(data.buildTime, 'yyyy年MM月dd日 HH:mm', new Date()), { locale: locale_1.zhCN }), "\u524D"] })] })), data.commitHash && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.GitBranch, { size: 24 }), (0, jsx_runtime_1.jsxs)("span", { children: ["Commit Hash: ", data.commitHash] })] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "p-10 rounded-[36px]", style: { backgroundColor: dark ? 'rgba(0,0,0,0.2)' : 'rgba(255,255,255,0.5)' }, children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-end justify-between mb-6", children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "text-3xl font-semibold mb-2", style: { color: accentColor }, children: "Need Help? / \u9700\u8981\u5E2E\u52A9\uFF1F" }), (0, jsx_runtime_1.jsx)("p", { className: "text-2xl", style: { color: secondaryColor }, children: data.report
                                                             ? '错误信息已上传，进群发送下面的上报编号或这张图片即可。'
                                                             : '提交问题时请附上完整报错截图、复现步骤和环境版本信息。' })] }), (0, jsx_runtime_1.jsx)("span", { className: "text-xs font-black tracking-[0.2em] uppercase px-3 py-1 rounded-full", style: {
                                                     color: primaryColor,

package/lib/webui.js

@@ -303,6 +303,27 @@ function registerWebUi({ ctx, config, rawConfig, logger, pluginRoot }) {
         const match = new RegExp(COOKIE_NAME + '=([0-9a-f]+)').exec(cookie);
         return !!(match && tokens.has(match[1]));
     };
+    /**
+     * 请求有没有带**控制台发的面板令牌**。
+     *
+     * 这是「只能从控制台 iframe 进面板」的唯一凭据：令牌由 RPC \`kkk/panel-token\` 下发，
+     * 那个 RPC 走控制台登录态（authority 4），没登录控制台根本调不到 → 也就拿不到令牌。
+     * 这里**不看 webUiAuth，也不依赖宿主装没装 auth 插件**，所以任何部署下都堵得住。
+     */
+    const panelTokenOk = (request) => {
+        const panelCookie = new RegExp(COOKIE_NAME + '_panel=([0-9a-f]+)').exec(String(request?.headers?.cookie || ''));
+        if (panelCookie && panelTokenValid(panelCookie[1]))
+            return true;
+        const header = String(request?.headers?.authorization || request?.headers?.['x-access-token'] || '');
+        if (header && panelTokenValid(header.replace(/^Bearer\\s+/i, '')))
+            return true;
+        const url = String(request?.url || '');
+        const panel = /[?&]panel=([0-9a-f]+)/.exec(url);
+        if (panel && panelTokenValid(panel[1]))
+            return true;
+        const token = /[?&]token=([0-9a-f]+)/.exec(url);
+        return !!(token && panelTokenValid(token[1]));
+    };
     const ok = (response, data = null, message = '') => {
         response.type = 'application/json; charset=utf-8';
         response.body = JSON.stringify({ code: 200, data, message });
@@ -601,11 +622,16 @@ function registerWebUi({ ctx, config, rawConfig, logger, pluginRoot }) {
      * 这样未登录状态下连 SPA 的静态资源和 /kkk/assets/config 这种前端路由也拿不到。
      */
     const pageDenied = async (response) => {
+        /**
+         * 鉴权就用控制台登录态：装了 auth 插件（且 webUiAuth 开着）时认控制台 cookie，
+         * 没登录给 404。**额外加令牌校验会把控制台 iframe 也挡掉**（实测面板直接打不开），
+         * 按用户要求不做那层校验。
+         */
         if (!authRequired())
             return false;
-        if (await consoleAuthed(response))
+        if (await consoleAuthed(response.request))
             return false;
-        // 直接当成「没有这个页面」：面板只从控制台侧边栏进，独立 URL 不给任何提示
+        logger.warn('[kkk] 拒绝访问面板：需要先登录 Koishi 控制台');
         response.status = 404;
         response.type = 'text/plain; charset=utf-8';
         response.body = 'Not Found';
@@ -658,31 +684,27 @@ function registerWebUi({ ctx, config, rawConfig, logger, pluginRoot }) {
         response.set('Cache-Control', 'no-store, no-cache, must-revalidate, max-age=0');
         response.body = file;
     });
-    for (const route of ['/kkk', '/kkk/', '/kkk/login']) {
+    /**
+     * 面板页面：**只从控制台 iframe 进**（见 pageDenied 的说明）。
+     * 原来还有一条独立的 \`/kkk/login\` 兜底入口，按用户要求一并去掉 —— 它就是「单独放出来」的那条路。
+     */
+    for (const route of ['/kkk', '/kkk/']) {
         server.get(route, async (response) => {
             if (await pageDenied(response))
                 return;
             rememberPanelToken(response);
+            // 只允许同源 iframe 嵌套：别人把面板嵌到自己站里也用不了
+            response.set('Content-Security-Policy', "frame-ancestors 'self'");
+            response.set('X-Frame-Options', 'SAMEORIGIN');
             response.type = 'text/html; charset=utf-8';
             response.body = indexHtml();
         });
     }
     /* ---------------- 简易编辑页（改插件配置） ---------------- */
-    server.get('/kkk/edit', async (response) => {
-        if (await pageDenied(response))
-            return;
-        let body;
-        try {
-            body = node_fs_1.default.readFileSync(node_path_1.default.join(pluginRoot, 'assets', 'webui.html'), 'utf-8');
-        }
-        catch {
-            body = '<h1>kkk 配置</h1><p>assets/webui.html 缺失</p>';
-        }
-        const token = issueToken();
-        response.set('Set-Cookie', COOKIE_NAME + '=' + token.accessToken + '; Path=/; HttpOnly; Max-Age=' + Math.floor(TOKEN_TTL / 1000));
-        response.type = 'text/html; charset=utf-8';
-        response.body = body;
-    });
+    /**
+     * 原来的 `/kkk/edit` 是一个**独立的 HTML 配置编辑页**（assets/webui.html），
+     * 它绕开控制台、把配置表单单独放出来 —— 用户要求删掉，配置只从控制台里改。
+     */
     server.get('/kkk/api/config', (response) => {
         if (!authed(response))
             return fail(response, 401, '未登录');

package/package.json

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

package/scripts/build.mjs

@@ -8,6 +8,7 @@
  *    - @kkk/richtext    → 内置 richtext
  *    - node-karin[/sub] → 兼容层实现（这样产物自带兼容层，不依赖 node_modules 里的转发包）
  */
+import { execFileSync } from 'node:child_process'
 import { readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
@@ -118,7 +119,41 @@ const checkImportMeta = (dir) => {
   return offenders
 }
 
+/**
+ * 写入构建元数据。
+ *
+ * 卡片上的「Built Time / Commit Hash」以前一直是空的：插件读的是 lib/build-metadata.json，
+ * 但没有任何地方生成它。构建时顺手写一份，随 lib 一起部署（也会被打进 npm 包里）。
+ */
+const writeBuildMetadata = () => {
+  const pkg = JSON.parse(readFileSync(path.join(root, 'package.json'), 'utf8'))
+  let commitHash = ''
+  try {
+    commitHash = execFileSync('git', ['rev-parse', 'HEAD'], {
+      cwd: root,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore']
+    }).trim()
+  } catch {
+    // 没装 git（或不在仓库里）：CI 上通常给了 GITHUB_SHA
+    commitHash = String(process.env.GITHUB_SHA ?? '').trim()
+  }
+  const metadata = {
+    version: String(pkg.version ?? ''),
+    buildTime: new Date().toISOString(),
+    buildTimestamp: Date.now(),
+    name: String(pkg.name ?? ''),
+    description: String(pkg.description ?? ''),
+    homepage: String(pkg.homepage ?? ''),
+    commitHash,
+    shortCommitHash: commitHash.slice(0, 7)
+  }
+  writeFileSync(path.join(outDir, 'build-metadata.json'), JSON.stringify(metadata, null, 2) + '\n')
+  return metadata
+}
+
 mkdirSync(outDir, { recursive: true })
+const buildMetadata = writeBuildMetadata()
 const rewritten = rewriteAliases(outDir)
 const offenders = checkImportMeta(outDir)
 if (offenders.length) {
@@ -127,3 +162,4 @@ if (offenders.length) {
   process.exit(1)
 }
 console.log('构建完成：输出到 ' + path.relative(root, outDir) + '，重写别名文件 ' + rewritten + ' 个')
+console.log('构建信息：v' + buildMetadata.version + ' · ' + (buildMetadata.shortCommitHash || '无 commit') + ' · ' + buildMetadata.buildTime)

package/scripts/patch-webui.mjs

@@ -146,42 +146,16 @@ const RENDERER_START = '/*KKK-RENDERER-START*/'
 const RENDERER_END = '/*KKK-RENDERER-END*/'
 
 /**
- * 「优先渲染器」这一项挂在「通用」分类下，**作为「渲染设置」的兄弟分组**插在它后面。
+ * 清理老版本注入过的「通用设置 → 优先渲染器」块。
  *
- * 存储位置是上游配置的 `app.renderer`（和 renderScale 同一个段），取值 'shotkit' | 'puppeteer'。
- * 面板里用下拉框（i = 该分类的选项渲染器），默认值放在上游 config.json / app.yaml 里，
- * 这里只负责把控件画出来。
- *
- * 文案里那句 https 的提醒是实测结论，不是猜测：预编译内核在 Windows 上拉不到 https 资源，
- * 而卡片里的封面、头像基本都是 https，选内核会缺图 —— 用户看到选项说明就知道该选哪个。
+ * 3.5.0 起插件只用浏览器渲染（不再支持 shotkit 内核），这个选项没有意义了 ——
+ * 注入代码删掉，但**保留这段清理**：已经装过的部署里那个块还躺在各自的前端包里，
+ * 不摘掉的话面板上会一直挂着一个早就失效的下拉框（改它也不会有任何效果）。
+ * 可反复执行（按标记切）。
  */
-const RENDERER_FIELD = 'i(' + arr(['app', 'renderer']) + ',' + q('优先渲染器') + ',' + q(
-  '卡片优先用哪个渲染器渲染。两个渲染服务都在时会按这里选的走，缺一个就自动用另一个；',
-) + ',['
-  + '{label:' + q('shotkit 内核（默认）') + ',value:' + q('shotkit') + ',description:' + q(
-    '不依赖浏览器，单张几十毫秒、内存低。注意：当前预编译内核在 Windows 上加载不了 https 资源，卡片里的远程封面、头像会缺图。',
-  ) + '}'
-  + ',{label:' + q('浏览器（Chrome / Edge）') + ',value:' + q('puppeteer') + ',description:' + q(
-    '完整渲染、远程资源正常，单张通常 1 秒以上，需要浏览器渲染服务（koishi-plugin-puppeteer 或同类）。',
-  ) + '}'
-  + '],e=>e)'
-
-const RENDERER_CODE = 'o(' + q('通用设置') + ',(0,U.jsxs)(U.Fragment,{children:[' + RENDERER_FIELD + ']}))'
-
-/** 插到「渲染设置」这个分组后面（兄弟节点）。可重复执行：先按标记删上次插的，再插一次。 */
-function patchRendererSetting (text, name) {
-  let out = stripMarkedWithComma(text, RENDERER_START, RENDERER_END)
-  const at = out.indexOf('`渲染设置`')
-  if (at < 0) return out
-  let open = -1
-  for (let i = at - 1; i >= 0 && i > at - 40; i--) {
-    if (out[i] === '(') { open = i; break }
-  }
-  if (open < 0) return out
-  const close = matchParen(out, open)
-  if (close < 0) return out
-  out = out.slice(0, close + 1) + ',' + RENDERER_START + RENDERER_CODE + RENDERER_END + out.slice(close + 1)
-  console.log('[kkk] 「通用设置 → 优先渲染器」已注入到「渲染设置」之后: ' + name)
+function stripLegacyRendererSetting (text, name) {
+  const out = stripMarkedWithComma(text, RENDERER_START, RENDERER_END)
+  if (out !== text) console.log('[kkk] 已摘掉面板里过期的「优先渲染器」分组: ' + name)
   return out
 }
 
@@ -784,12 +758,23 @@ function applyTextReplacements (text, name) {
 const FORWARD_START = '/*KKK-FORWARD-START*/'
 const FORWARD_END = '/*KKK-FORWARD-END*/'
 
+const forwardOption = ([value, label]) => '{value:' + q(value) + ',label:' + q(label) + '}'
 const FORWARD_OPTIONS = '[' + [['text', '文字'], ['image', '图片'], ['video', '视频'], ['file', '文件']]
-  .map(([value, label]) => '{value:' + q(value) + ',label:' + q(label) + '}').join(',') + ']'
+  .map(forwardOption).join(',') + ']'
+/**
+ * 「流程图」只有 B站互动视频有（它是剧情图，本身是图片但可以单独控制），
+ * 所以只补在 **B站** 和 **通用（全局）** 这两处候选里：抖音 / 快手 / 小红书 加了也是永远匹配不到的假选项，
+ * 跟当初删掉「语音 / markdown」是同一个理由（见 ParseForward 的说明）。
+ */
+const FORWARD_OPTIONS_CHART = '[' + [['text', '文字'], ['image', '图片'], ['video', '视频'], ['file', '文件'], ['chart', '流程图']]
+  .map(forwardOption).join(',') + ']'
 
 const FORWARD_SWITCH_DESC = '本平台单独打开合并转发。注意全局优先：通用里的「解析结果合并转发」打开时所有平台都会合并，这个开关开不开都一样；只有全局关着时它才起作用。默认关闭。'
 const FORWARD_CONTENT_DESC = '合并转发里放哪些内容：没勾的会单独发出去、不进聊天记录。留空表示用通用里那份全局设置。视频体积大时有些适配器（比如 NapCat）会拒绝整条聊天记录，这时会自动改成单独发送，不会丢内容。'
-const FORWARD_GLOBAL_CONTENT_DESC = '全局合并转发里放哪些内容（通用页那个开关打开时生效，所有平台共用）：没勾的单独发。视频建议先不勾，聊天记录太大时适配器会整条拒绝。语音和 markdown 不在候选里：QQ 的聊天记录不支持语音气泡，markdown 只有官方 bot 认、而官方适配器没有合并转发能力。'
+const FORWARD_GLOBAL_CONTENT_DESC = '全局合并转发里放哪些内容（通用页那个开关打开时生效，所有平台共用）：没勾的单独发。视频建议先不勾，聊天记录太大时适配器会整条拒绝。语音和 markdown 不在候选里：QQ 的聊天记录不支持语音气泡，markdown 只有官方 bot 认、而官方适配器没有合并转发能力。「流程图」是 B站互动视频的剧情图，勾上才会进聊天记录。'
+
+/** B站那一栏多说一句：流程图只有 B站有（别的平台页里连候选项都没有） */
+const FORWARD_CONTENT_DESC_BILIBILI = FORWARD_CONTENT_DESC + '「流程图」是互动视频的剧情图：勾上就进聊天记录，不勾就单独发出去。'
 
 /** 平台页的锚点：紧跟在「解析开关」那一项之后插入 */
 const FORWARD_TABS = [
@@ -812,10 +797,13 @@ function insertAfterCall (text, needle, code) {
 
 /** 平台页里那一段：小标题 + 本平台开关 + 本平台内容多选 */
 function forwardSectionCode (platform, label) {
+  /** B站那一栏多一个「流程图」候选（只有它有互动视频剧情图） */
+  const options = platform === 'bilibili' ? FORWARD_OPTIONS_CHART : FORWARD_OPTIONS
+  const description = platform === 'bilibili' ? FORWARD_CONTENT_DESC_BILIBILI : FORWARD_CONTENT_DESC
   return 't.renderSubSection(' + q('合并转发') + ',(0,U.jsxs)(U.Fragment,{children:['
     // 分类名已经写着平台名了（哔哩哔哩页里再写一遍「合并转发（哔哩哔哩）」是重复）
     + 't.renderSwitch(' + arr([platform, 'forward']) + ',' + q('合并转发') + ',' + q(FORWARD_SWITCH_DESC) + ')'
-    + ',t.renderCheckboxGroup(' + arr([platform, 'forwardContent']) + ',' + q('合并转发内容') + ',' + q(FORWARD_CONTENT_DESC) + ',' + FORWARD_OPTIONS + ')'
+    + ',t.renderCheckboxGroup(' + arr([platform, 'forwardContent']) + ',' + q('合并转发内容') + ',' + q(description) + ',' + options + ')'
     + ']}))'
 }
 
@@ -827,7 +815,7 @@ function patchForwardFields (text, name) {
   // ① 通用页：全局合并内容（开关本身是原版就有的 app.fakeForward）
   out = insertAfterCall(out, arr(['app', 'fakeForward']) + ',' + q('解析结果合并转发'),
     FORWARD_START + 't.renderCheckboxGroup(' + arr(['app', 'forwardContent']) + ',' + q('合并转发内容（全局）')
-    + ',' + q(FORWARD_GLOBAL_CONTENT_DESC) + ',' + FORWARD_OPTIONS + ')' + FORWARD_END)
+    + ',' + q(FORWARD_GLOBAL_CONTENT_DESC) + ',' + FORWARD_OPTIONS_CHART + ')' + FORWARD_END)
 
   // ② 平台页：本平台开关 + 本平台内容
   for (const [platform, label, anchor] of FORWARD_TABS) {
@@ -887,9 +875,11 @@ for (const file of files) {
   // 必须在 patchPermFields 之后：那个函数会先剥掉旧的 APP 标记块再重写「交互设置」里的字段，
   // 我们的分组要插在「交互设置」**之后**，顺序反了会插到它里面去（就是这次要修的样式问题）
   text = patchAppSections(text, name)
-  // 同样必须晚于 patchPermFields / patchAppSections：它锚定的是「渲染设置」的收尾括号
-  text = patchRendererSetting(text, name)
+  // 老版本在这里注入过「优先渲染器」分组：3.5.0 起不再支持 shotkit 内核，只剩摘除
+  text = stripLegacyRendererSetting(text, name)
   text = patchForwardFields(text, name)
+  text = patchChartOption(text, name)
+  text = patchChartOptionList(text, name)
   text = patchDescriptions(text, name)
   text = applyTextReplacements(text, name)
 
@@ -897,4 +887,100 @@ for (const file of files) {
   if (text.length !== before || before !== fs.statSync(file).size || !isBundle) console.log('[kkk] 已处理: ' + name + '（' + before + ' → ' + text.length + ' 字节）')
 }
 
+
+/* ---------------- 解析时发送的内容：补上「流程图」勾选项 ---------------- */
+
+/**
+ * 面板里「解析时发送的内容」的候选项是**面板自己写死的一份列表**（打包进前端包里了），
+ * 不是按配置里的数组值渲染的 —— 所以新加的 `chart` 对一个已经存在的安装永远不会自己冒出来，
+ * 必须把选项塞进控件本身。
+ *
+ * ⚠️ 这份列表在四个平台页之间是**共用变量**（ `jL` = 信息 / 评论图 / 视频 / 图片 ），
+ * B站那一栏是 `jL.filter(e=>e.value!==\`image\`)` 过滤出来的。上一版补丁按
+ * 「B站 sendContent 后面那个 `[` 开头的选项数组」去找，命中的却是**另一处**同名路径
+ * （判定表 / 补全表里的字符串数组），检查不通过就静默 return —— 于是面板里一直**没有**
+ * 「流程图」这个勾选项（控制台那边有，因为它读的是 YAML 注释）。
+ *
+ * 现在改成按「B站那一栏自己的渲染调用」定位：路径 + 标题「解析时发送的内容」，
+ * 再把它的第 4 个参数（选项数组）追加一项。
+ * 幂等：带上 /*KKK-CHART*\/ 标记，补过一次就不再补；万一找不到控件，**大声报警**而不是静默跳过。
+ */
+/** 按「顶层逗号」切分一段参数列表（字符串与括号里的逗号不算） */
+function splitTopLevel (code) {
+  const out = []
+  let current = ''
+  let depth = 0
+  let quote = ''
+  for (let i = 0; i < code.length; i++) {
+    const ch = code[i]
+    if (quote) {
+      current += ch
+      if (ch === '\\') { current += code[++i] ?? ''; continue }
+      if (ch === quote) quote = ''
+      continue
+    }
+    if (ch === BT || ch === '"' || ch === "'") { quote = ch; current += ch; continue }
+    if (ch === '(' || ch === '[' || ch === '{') depth++
+    else if (ch === ')' || ch === ']' || ch === '}') depth--
+    if (ch === ',' && depth === 0) { out.push(current); current = ''; continue }
+    current += ch
+  }
+  if (current.trim()) out.push(current)
+  return out
+}
+
+function patchChartOption (text, name) {
+  /**
+   * 补丁标记写在这里而不是模块顶层：主循环在本文件靠前的位置就跑完了，
+   * 顶层 `const` 那时候还在时间死区（TDZ）里 —— 函数声明倒是已经提升好了。
+   */
+  const CHART_MARK = '/*KKK-CHART*/'
+  if (text.includes(CHART_MARK)) return text
+  const option = '{value:' + q('chart') + ',label:' + q('流程图') + '}'
+  /** 锚点 = B站那一栏的渲染调用（第一个参数是路径，第二个是标题） */
+  const anchor = arr(['bilibili', 'sendContent']) + ',' + q('解析时发送的内容')
+  const at = text.indexOf(anchor)
+  if (at < 0) {
+    // 只有主包才该有这个控件：布局 / 主题 / index.html 里没有是正常的，别刷屏
+    if (text.includes('sendContent')) console.warn('[kkk] ' + name + '：没找到 B站「解析时发送的内容」控件，流程图勾选项没补上（前端包可能换版本了）')
+    return text
+  }
+  const open = text.lastIndexOf('(', at)
+  if (open < 0) return text
+  const close = matchParen(text, open)
+  if (close < 0) return text
+  const args = splitTopLevel(text.slice(open + 1, close))
+  // 参数顺序：路径 / 标题 / 说明 / 选项数组 / 是否禁用
+  if (args.length < 4) return text
+  const options = args[3]
+  /**
+   * 认一下：这个参数确实是「候选项数组」。
+   * 两种写法都要认：写死的数组（老版本包，里面有 info / video 这些字面量），
+   * 或者**过滤共用列表**（当前版本：\`jL.filter(e=>e.value!==\`image\`)\` —— 里面一个候选项名都没有，
+   * 上一版就是死在这一步：守着字面量、认不出表达式，于是又静默跳过了）。
+   */
+  if (!options.startsWith('[') && !/\b\w+\s*\.\s*filter\s*\(/.test(options)) return text
+  if (/chart/.test(options)) return text
+  args[3] = options.startsWith('[')
+    // 选项数组写死在这一处（老版本包）→ 直接补在数组里
+    ? options.slice(0, -1) + ',' + CHART_MARK + option + ']'
+    // 共用列表过滤出来的（当前版本：jL.filter(…)）→ 追加一项
+    : options + '.concat([' + CHART_MARK + option + '])'
+  console.log('[kkk] 「解析时发送的内容」已补上「流程图」勾选项: ' + name)
+  return text.slice(0, open) + '(' + args.join(',') + ')' + text.slice(close + 1)
+}
+
+/**
+ * 面板还有一份**值白名单**（补全表）：`{path:["bilibili","sendContent"],options:[…]}`。
+ * 保存前面板会拿它把配置里的数组洗一遍 —— **不在表里的值会被丢掉**。
+ * 所以 `chart` 也必须补进这张表，否则勾上「流程图」一保存就被面板自己清掉了。
+ */
+function patchChartOptionList (text, name) {
+  const B = String.fromCharCode(96)
+  const before = '{path:[' + B + 'bilibili' + B + ',' + B + 'sendContent' + B + '],options:[' + B + 'info' + B + ',' + B + 'comment' + B + ',' + B + 'video' + B + ',' + B + 'image' + B + ']}'
+  const after = '{path:[' + B + 'bilibili' + B + ',' + B + 'sendContent' + B + '],options:[' + B + 'info' + B + ',' + B + 'comment' + B + ',' + B + 'video' + B + ',' + B + 'image' + B + ',' + B + 'chart' + B + ']}'
+  if (!text.includes(before)) return text
+  console.log('[kkk] 「解析时发送的内容」候选项已补上 chart: ' + name)
+  return text.split(before).join(after)
+}
 console.log('[kkk] 完成，共处理 ' + files.length + ' 个文件')

package/scripts/probe-edge-cookie.cjs

@@ -0,0 +1,50 @@
+const fs = require('node:fs')
+const path = require('node:path')
+const pluginRoot = path.resolve(__dirname, '..')
+const libRoot = path.join(pluginRoot, 'lib')
+const runtime = require(path.join(libRoot, 'compat', 'runtime.js'))
+const noop = () => {}
+runtime.bindRuntime({ ctx: { get: () => undefined, logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }), bots: [], registry: new Map(), on: noop, middleware: noop }, config: { app: {} }, dataRoot: path.join(pluginRoot, 'data-probe-node'), pluginRoot, master: () => [] })
+const { Networks } = require(path.join(libRoot, 'karin', 'module', 'utils', 'Network', 'index.js'))
+const cfgPath = 'C:\\sj\\koishi\\data\\koishi-plugin-kkk\\config\\config.json'
+const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'))
+const cookie = String(cfg.amagi?.cookies?.bilibili ?? '')
+console.log('生产 Cookie: ' + (cookie ? '有（长度 ' + cookie.length + '，含 SESSDATA=' + /SESSDATA=/.test(cookie) + '）' : '无'))
+const bvid = 'BV1xDgL6SEzk'
+const rootCid = 41156151510
+const edgeId = 47666682
+const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120 Safari/537.36'
+const baseHeaders = (withCookie) => ({ 'User-Agent': UA, Referer: 'https://www.bilibili.com/', ...(withCookie && cookie ? { Cookie: cookie } : {}) })
+const urls = {
+  player: 'https://api.bilibili.com/x/player/wbi/v2?bvid=' + bvid + '&cid=' + rootCid,
+  edge: 'https://api.bilibili.com/x/stein/edgeinfo_v2?bvid=' + bvid + '&graph_version=1722536&cid=' + rootCid + '&edge_id=' + edgeId,
+  edgeNoEdge: 'https://api.bilibili.com/x/stein/edgeinfo_v2?bvid=' + bvid + '&graph_version=1722536&cid=' + rootCid
+}
+const summarize = (payload) => {
+  if (payload === false) return 'Networks 返回 false（请求本身失败）'
+  if (payload === null) return 'Networks 返回 null'
+  if (typeof payload !== 'object') return '类型 ' + typeof payload
+  const data = payload.data ?? {}
+  const questions = data.edges?.questions ?? []
+  return 'code=' + payload.code + ' message=' + JSON.stringify(payload.message) + ' 有 data=' + !!payload.data + ' 题目数=' + questions.length
+}
+const main = async () => {
+  for (const withCookie of [true, false]) {
+    console.log('')
+    console.log('=== ' + (withCookie ? '带生产 Cookie' : '匿名（不带 Cookie）') + ' ===')
+    for (const [name, url] of Object.entries(urls)) {
+      try {
+        const payload = await new Networks({ url, headers: baseHeaders(withCookie), timeout: 15000 }).getData()
+        console.log('Networks ' + name + ': ' + summarize(payload))
+      } catch (error) { console.log('Networks ' + name + ' 抛错: ' + String(error?.message ?? error)) }
+      try {
+        const response = await fetch(url, { headers: baseHeaders(withCookie) })
+        const text = await response.text()
+        let parsed = null
+        try { parsed = JSON.parse(text) } catch {}
+        console.log('fetch    ' + name + ': HTTP ' + response.status + ' ' + (parsed ? 'code=' + parsed.code + ' message=' + JSON.stringify(parsed.message) : '非 JSON: ' + text.slice(0, 80)))
+      } catch (error) { console.log('fetch    ' + name + ' 抛错: ' + String(error?.message ?? error)) }
+    }
+  }
+}
+main().catch((error) => { console.log('探针失败: ' + (error && error.stack ? error.stack : error)); process.exit(1) })

package/scripts/probe-panel-options.cjs

@@ -0,0 +1,15 @@
+const fs = require('fs')
+const file = process.argv[2]
+const text = fs.readFileSync(file, 'utf8')
+const keys = ['评论图', '解析时发送的内容', 'sendContent']
+for (const key of keys) {
+  let from = 0, count = 0
+  while (count < 4) {
+    const at = text.indexOf(key, from)
+    if (at < 0) break
+    console.log('--- ' + key + ' @' + at + ' ---')
+    console.log(text.slice(Math.max(0, at - 240), at + 240).replace(/\n/g, ' '))
+    from = at + key.length
+    count++
+  }
+}

package/scripts/probe-schema-options.cjs

@@ -0,0 +1,12 @@
+const fs = require('fs')
+const text = fs.readFileSync(process.argv[2], 'utf8')
+for (const key of ['sendContent', 'default_config', 'yaml', 'YAML', 'extractOptions(']) {
+  let from = 0, n = 0
+  while (n < 3) {
+    const at = text.indexOf(key, from)
+    if (at < 0) break
+    console.log('--- ' + key + ' @' + at + ' ---')
+    console.log(text.slice(Math.max(0, at - 200), at + 200).replace(/\n/g, ' '))
+    from = at + key.length; n++
+  }
+}

package/scripts/smoke-adapter-info.cjs

@@ -0,0 +1,149 @@
+/**
+ * 适配器信息 / 构建信息冒烟测试。
+ *
+ * 两件线上被用户发现的事：
+ *   1. 卡片上「当前适配器」永远是一个空的 v —— Koishi 的 Bot 根本没有 version 字段，
+ *      以前读 bot.adapter.version 只会得到空串。
+ *   2. 卡片上的「Built Time / Commit Hash」一直空着 —— 没有任何地方生成 lib/build-metadata.json。
+ *
+ * 这个测试直接跑编译产物：造一个真的（临时）适配器包，验证构造函数反查、包名兜底、
+ * 实现端版本查询和构建元数据读取这几条链路。
+ *
+ * 用法：node scripts/smoke-adapter-info.cjs
+ */
+const fs = require('node:fs')
+const os = require('node:os')
+const path = require('node:path')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const libRoot = path.join(pluginRoot, 'lib')
+
+const failures = []
+let passed = 0
+const check = (name, condition, detail) => {
+  if (condition) {
+    passed++
+    console.log('  ✓ ' + name)
+  } else {
+    failures.push(name + (detail ? ' → ' + detail : ''))
+    console.log('  ✗ ' + name + (detail ? ' → ' + detail : ''))
+  }
+}
+
+const noop = () => {}
+/** 有些模块顶层会读运行时（配置 / 日志），先绑一个最小实现 */
+const runtime = require(path.join(libRoot, 'compat', 'runtime.js'))
+runtime.bindRuntime({
+  ctx: {
+    get: () => undefined,
+    logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }),
+    bots: [],
+    registry: new Map(),
+    on: noop,
+    middleware: noop
+  },
+  config: { app: {} },
+  dataRoot: path.join(pluginRoot, 'data-smoke-adapter-info'),
+  pluginRoot,
+  master: () => []
+})
+
+/** 造一个假适配器包，require 之后它自然就进了 require.cache —— 正是反查要靠的东西 */
+const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'kkk-adapter-info-'))
+const fakeDir = path.join(tmpRoot, 'node_modules', 'koishi-plugin-adapter-smoke')
+fs.mkdirSync(path.join(fakeDir, 'lib'), { recursive: true })
+fs.writeFileSync(path.join(fakeDir, 'package.json'), JSON.stringify({ name: 'koishi-plugin-adapter-smoke', version: '9.9.9' }))
+fs.writeFileSync(path.join(fakeDir, 'lib', 'index.js'), 'class SmokeAdapter {}\nmodule.exports = { Adapter: SmokeAdapter, SmokeAdapter }\n')
+const fake = require(path.join(fakeDir, 'lib', 'index.js'))
+
+const adapterInfo = require(path.join(libRoot, 'compat', 'adapter-info.js'))
+const { resolveAdapterInfo, queryAdapterImplementation, cachedAdapterImplementation } = adapterInfo
+
+console.log('== 适配器信息 ==')
+const bot = {
+  platform: 'smoke',
+  selfId: '10001',
+  status: 1,
+  config: { protocol: 'ws' },
+  adapter: { constructor: fake.SmokeAdapter },
+  internal: {}
+}
+const info = resolveAdapterInfo(bot)
+check('按 Adapter 构造函数反查到适配器插件版本', info.version === '9.9.9', 'version=' + info.version)
+check('带上适配器包名', info.packageName === 'koishi-plugin-adapter-smoke', info.packageName)
+check('通信方式按协议翻译（ws → WebSocket）', info.communication === 'WebSocket', info.communication)
+check('记录机器人上线时间（connectTime > 0）', info.connectTime > 0, String(info.connectTime))
+check('身份字段保持原样（name = 平台名）', info.name === 'smoke' && info.protocol === 'smoke' && info.standard === 'smoke', info.name + '/' + info.protocol)
+check('友好名单独放在 displayName', info.displayName === 'smoke', info.displayName)
+check('结果被缓存，重复调用不重复扫目录', resolveAdapterInfo(bot).version === '9.9.9')
+check('没有实现端信息时不编造名字', cachedAdapterImplementation(bot) === undefined, String(cachedAdapterImplementation(bot)))
+
+console.log('== 平台兜底 ==')
+const onebot = resolveAdapterInfo({ platform: 'onebot', selfId: '10002', status: 1, adapter: {}, config: { protocol: 'http' } })
+check('OneBot 的友好名是 OneBot', onebot.displayName === 'OneBot', onebot.displayName)
+check('OneBot 的身份字段仍然是平台名（面板/合并转发靠它判断）', onebot.name === 'onebot' && onebot.protocol === 'onebot', onebot.name + '/' + onebot.protocol)
+const qqguild = resolveAdapterInfo({ platform: 'qqguild', selfId: '10007', status: 1, adapter: {}, config: {} })
+check('QQ 频道这类平台名不会被改成中文（includes 判断必须继续生效）', qqguild.name === 'qqguild', qqguild.name)
+check('中文友好名只出现在 displayName', qqguild.displayName === 'QQ 频道', qqguild.displayName)
+check('HTTP 协议翻译', onebot.communication === 'HTTP', onebot.communication)
+if (onebot.version === '未知') {
+  console.log('  · 跳过：这台机器没装 koishi-plugin-adapter-onebot，包名兜底无从验证')
+} else {
+  check('按平台名兜底找到适配器包版本', /^\d+\.\d+\.\d+/.test(onebot.version), onebot.version)
+  check('兜底也能拿到包名', onebot.packageName === 'koishi-plugin-adapter-onebot', onebot.packageName)
+}
+
+console.log('== 离线机器人 ==')
+const offline = resolveAdapterInfo({ platform: 'onebot', selfId: '10003', status: 0, adapter: {}, config: {} })
+check('离线时 connectTime 是 0（不编造上线时间）', offline.connectTime === 0, String(offline.connectTime))
+
+console.log('== 构建信息 ==')
+const buildMetadata = require(path.join(libRoot, 'karin', 'module', 'utils', 'build-metadata.js'))
+const pkg = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'package.json'), 'utf8'))
+const meta = buildMetadata.getBuildMetadata()
+check('lib/build-metadata.json 存在', fs.existsSync(path.join(libRoot, 'build-metadata.json')))
+check('构建信息不为空（旧安装包也会退回 package.json）', !!meta)
+check('构建信息版本与 package.json 一致', meta.version === pkg.version, meta.version + ' vs ' + pkg.version)
+check('构建信息带 commit', /^[0-9a-f]{7,}$/.test(meta.shortCommitHash), meta.shortCommitHash)
+check('构建时间能格式化', buildMetadata.formatBuildTime(meta.buildTime).length > 0, buildMetadata.formatBuildTime(meta.buildTime))
+check('空构建时间不会被格式化成 NaN', buildMetadata.formatBuildTime('') === '', buildMetadata.formatBuildTime(''))
+
+const main = async () => {
+  console.log('== 实现端版本（OneBot get_version_info）==')
+  const napcat = await queryAdapterImplementation({
+    platform: 'onebot',
+    selfId: '10004',
+    internal: { get_version_info: async () => ({ app_name: 'NapCat', app_version: '4.8.1', protocol_version: 'v11' }) }
+  })
+  check('问到实现端名字与版本', napcat && napcat.name === 'NapCat' && napcat.version === '4.8.1', JSON.stringify(napcat))
+  const enriched = resolveAdapterInfo({
+    platform: 'onebot',
+    selfId: '10004',
+    status: 1,
+    adapter: {},
+    config: {}
+  })
+  check('实现端信息优先展示在卡片上（displayName）', enriched.displayName === 'NapCat' && enriched.version === '4.8.1', enriched.displayName + ' v' + enriched.version)
+  check('实现端信息不覆盖平台身份字段', enriched.name === 'onebot', enriched.name)
+  const noApi = await queryAdapterImplementation({ platform: 'x', selfId: '10005', internal: {} })
+  check('适配器没实现该接口时安静返回 null', noApi === null, String(noApi))
+  const broken = await queryAdapterImplementation({
+    platform: 'x',
+    selfId: '10006',
+    internal: { get_version_info: async () => { throw new Error('nope') } }
+  })
+  check('接口报错时安静返回 null', broken === null, String(broken))
+
+  console.log('')
+  console.log('通过 ' + passed + ' 项，失败 ' + failures.length + ' 项')
+  if (failures.length === 0) {
+    console.log('=== 通过：适配器版本与构建信息都能拿到 ===')
+    process.exit(0)
+  } else {
+    for (const item of failures) console.log('  ❌ ' + item)
+    console.log('=== 失败 ===')
+    process.exit(1)
+  }
+}
+
+main()