koishi-plugin-kkk 1.0.0

package/scripts/smoke-login.cjs

@@ -0,0 +1,110 @@
+/**
+ * 扫码登录链路冒烟测试：走 Koishi 中间件链路执行 `#B站登录` / `#抖音登录`。
+ *
+ * 验证点：
+ *   - 命令与权限（loginPerm）解析正确
+ *   - amagi 登录会话能拿到二维码（真实接口）
+ *   - 二维码渲染走 Render（无 puppeteer 时降级）+ 回复链路
+ *   - 抖音流程里 `karin.ctx`（等待用户输入）不会卡死进程
+ *
+ * 注意：不会真的完成扫码，脚本在 $WAIT_MS 后退出。
+ *
+ * 用法：node scripts/smoke-login.cjs [等待毫秒数]
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const { Context } = require('koishi')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const dataRoot = path.resolve(pluginRoot, 'data-smoke-login')
+const cfgDir = path.join(dataRoot, 'koishi-plugin-kkk', 'config')
+fs.mkdirSync(cfgDir, { recursive: true })
+
+const config = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'config/default_config/config.json'), 'utf8'))
+config.app.parseTip = false
+config.bilibili.loginPerm = 'master'
+config.douyin.loginPerm = 'master'
+config.pushlist = { douyin: [], bilibili: [] }
+fs.writeFileSync(path.join(cfgDir, 'config.json'), JSON.stringify(config, null, 2))
+
+const plugin = require(path.join(pluginRoot, 'lib/index.js'))
+
+// 沙箱里没有 puppeteer，二维码渲染走兜底会返回空数组；这里把 Render 换成假图片，
+// 以便把「取码 → 渲染 → 发送 → 轮询」整条链路走完（渲染本身由 smoke-render 另行验证）。
+// 注意：\`@/module/utils\` 的 index 用 __exportStar 生成的属性是只读 getter，直接改它无效，
+// 要改真正定义 Render 的模块。
+require(path.join(pluginRoot, 'lib/karin/module/utils/Render/index.js')).Render = async () => [{ type: 'image', file: 'base64://iVBORw0KGgo=' }]
+
+const ctx = new Context()
+const sent = []
+const fakeBot = {
+  selfId: '10000', platform: 'smoke', status: 1, user: { id: '10000', name: 'smoke' }, ctx,
+  sendMessage: async (channel, content) => { sent.push({ channel, content }); return ['msg-1'] },
+  sendPrivateMessage: async (user, content) => { sent.push({ channel: 'private:' + user, content }); return ['msg-1'] },
+  getGuild: async () => ({ name: 'smoke-guild' }),
+  getFriendList: async () => [{ userId: '12345' }]
+}
+Object.defineProperty(ctx, 'bots', { get: () => [fakeBot] })
+
+const middlewares = []
+const originalMiddleware = ctx.middleware.bind(ctx)
+ctx.middleware = (fn, ...rest) => { middlewares.push(fn); return originalMiddleware(fn, ...rest) }
+
+ctx.plugin(plugin, { dataPath: dataRoot, debug: true, masters: ['12345'] })
+
+const makeSession = (content, userId = '12345') => ({
+  content, selfId: '10000', userId, guildId: '', channelId: 'private:' + userId,
+  messageId: 'm1', bot: fakeBot, author: { nick: 'smoke' }, username: 'smoke', event: {},
+  send: async (c) => { sent.push({ channel: 'private:' + userId, content: c }); return ['msg-2'] }
+})
+
+async function dispatch (content, userId) {
+  const session = makeSession(content, userId)
+  let index = 0
+  const run = async () => {
+    while (index < middlewares.length) {
+      const middleware = middlewares[index++]
+      let continued = false
+      await middleware(session, () => { continued = true; return run() })
+      if (!continued) return
+    }
+  }
+  await run()
+}
+
+const waitMs = Number(process.argv[2] || 20000)
+
+setTimeout(async () => {
+  try {
+    console.log('=== #B站登录 ===')
+    const started = Date.now()
+    // 登录流程内部会轮询扫码状态，这里只等一小段时间观察“二维码是否拿到、是否回复”
+    await Promise.race([dispatch('#B站登录'), new Promise((resolve) => setTimeout(resolve, 15000))])
+    console.log('B站登录流程耗时(ms):', Date.now() - started)
+
+    console.log('=== #抖音登录 ===')
+    const douyinStarted = Date.now()
+    await Promise.race([dispatch('#抖音登录'), new Promise((resolve) => setTimeout(resolve, 15000))])
+    console.log('抖音登录流程耗时(ms):', Date.now() - douyinStarted)
+
+    console.log('=== 非 master 执行 #B站登录（应被拒绝） ===')
+    await dispatch('#B站登录', '99999')
+  } catch (error) {
+    console.error('登录冒烟测试失败:', error && error.stack ? error.stack : error)
+    process.exitCode = 1
+  }
+
+  setTimeout(() => {
+    console.log('\n=== 共发出 ' + sent.length + ' 条消息 ===')
+    for (const item of sent) {
+      const list = Array.isArray(item.content) ? item.content : [item.content]
+      console.log('→ ' + item.channel + ': ' + list.map((el) => {
+        if (typeof el === 'string') return el.slice(0, 200)
+        const type = el && el.type ? el.type : typeof el
+        const attrs = el && el.attrs ? JSON.stringify(el.attrs).slice(0, 120) : ''
+        return '[' + type + '] ' + attrs
+      }).join(' | '))
+    }
+    process.exit(process.exitCode || 0)
+  }, waitMs)
+}, 5000)

package/scripts/smoke-parse.cjs

@@ -0,0 +1,54 @@
+/**
+ * 端到端冒烟测试：在裸 Koishi Context 里加载插件，模拟一条 B站链接消息，
+ * 走完「识别 → 取数 → 发送」全流程，并打印实际发出的消息段。
+ *
+ * 用法：node scripts/smoke-parse.cjs [链接]
+ */
+const path = require('node:path')
+const { Context } = require('koishi')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const plugin = require(path.join(pluginRoot, 'lib', 'index.js'))
+
+const target = process.argv[2] || 'https://www.bilibili.com/video/BV1xx411c7mD'
+const dataPath = path.resolve(pluginRoot, 'data-smoke')
+
+const ctx = new Context()
+ctx.plugin(plugin, { dataPath, debug: true })
+
+setTimeout(async () => {
+  try {
+    const { commandQueue } = require(path.join(pluginRoot, 'lib/compat/runtime.js'))
+    const { Message } = require(path.join(pluginRoot, 'lib/compat/node-karin.js'))
+    const reg = commandQueue.find((item) => String(item.reg).includes('bilibili'))
+    if (!reg) throw new Error('没有注册 B站 解析命令')
+
+    const sent = []
+    const bot = {
+      selfId: '10000', platform: 'smoke', status: 1, user: { id: '10000', name: 'smoke' }, ctx,
+      sendMessage: async (channel, content) => { sent.push(content); return ['msg-1'] },
+      getGuild: async () => ({ name: 'smoke-guild' })
+    }
+    const session = {
+      content: target, selfId: '10000', userId: '12345', guildId: '456', channelId: '456',
+      messageId: 'm1', bot, author: { nick: 'smoke' }, username: 'smoke', event: {},
+      send: async (content) => { sent.push(content); return ['msg-2'] }
+    }
+
+    await reg.handler(Message.fromSession(session), () => Symbol('next'))
+
+    console.log('\n=== 共发出 ' + sent.length + ' 条消息 ===')
+    for (const item of sent) {
+      const list = Array.isArray(item) ? item : [item]
+      console.log(list.map((el) => {
+        const type = el && el.type ? el.type : typeof el
+        const attrs = el && el.attrs ? JSON.stringify(el.attrs).slice(0, 120) : ''
+        return '[' + type + '] ' + attrs
+      }).join('\n'))
+    }
+  } catch (error) {
+    console.error('冒烟测试失败:', error && error.stack ? error.stack : error)
+    process.exitCode = 1
+  }
+  process.exit(process.exitCode || 0)
+}, 4000)

package/scripts/smoke-push-mock.cjs

@@ -0,0 +1,114 @@
+/**
+ * 推送渲染链路测试：把 amagi 的动态列表接口替换成固定数据，
+ * 验证「配置 → 取数 → 过滤 → 渲染 → 入库 → 发送」在 Koishi 侧是否跑得通。
+ * 用于在没有可用 Cookie / 被 B站风控的环境下验证迁移后的推送链路。
+ *
+ * 用法：node scripts/smoke-push-mock.cjs
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const { Context } = require('koishi')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const dataRoot = path.resolve(pluginRoot, 'data-smoke-mock')
+const cfgDir = path.join(dataRoot, 'koishi-plugin-kkk', 'config')
+fs.mkdirSync(cfgDir, { recursive: true })
+
+const config = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'config/default_config/config.json'), 'utf8'))
+config.app.parseTip = false
+config.pushlist = {
+  douyin: [],
+  bilibili: [{ switch: true, host_mid: 946974, group_id: ['456:10000'], remark: '测试UP', pushTypes: ['word'] }]
+}
+config.bilibili.push.switch = true
+fs.writeFileSync(path.join(cfgDir, 'config.json'), JSON.stringify(config, null, 2))
+
+const plugin = require(path.join(pluginRoot, 'lib/index.js'))
+const ctx = new Context()
+const sent = []
+const fakeBot = {
+  selfId: '10000', platform: 'smoke', status: 1, user: { id: '10000', name: 'smoke' }, ctx,
+  sendMessage: async (channel, content) => { sent.push({ channel, content }); return ['msg-1'] },
+  sendPrivateMessage: async (user, content) => { sent.push({ channel: 'private:' + user, content }); return ['msg-1'] },
+  getGuild: async () => ({ name: 'smoke-guild' }),
+  getFriendList: async () => []
+}
+Object.defineProperty(ctx, 'bots', { get: () => [fakeBot] })
+ctx.plugin(plugin, { dataPath: dataRoot, debug: true })
+
+/** 构造一条「纯文动态」的固定响应 */
+function makeDynamic () {
+  const now = Math.floor(Date.now() / 1000)
+  // 动态 ID 每次运行都不同，否则会被「已推送」缓存挡住（这本身是去重逻辑正确的表现）
+  const id = String(Date.now())
+  return {
+    id_str: id,
+    type: 'DYNAMIC_TYPE_WORD',
+    basic: { comment_id_str: '1000000000000000001', comment_type: 1, like_icon: { icon_id: '', icon_url: '' } },
+    modules: {
+      module_author: {
+        mid: 946974, name: '测试UP', face: 'https://i0.hdslb.com/bfs/face/member/noface.jpg',
+        pub_ts: now - 600, pub_time: '10分钟前', following: false, is_top: false,
+        official_verify: { type: -1, desc: '' }, vip: { type: 0, status: 0 }, pendant: {}, nameplate: {}
+      },
+      module_dynamic: {
+        desc: {
+          text: '这是一条用于验证 Koishi 推送链路的测试动态',
+          rich_text_nodes: [{ type: 'RICH_TEXT_NODE_TYPE_TEXT', text: '这是一条用于验证 Koishi 推送链路的测试动态', orig_text: '' }]
+        },
+        major: null, topic: null, additional: null
+      },
+      module_stat: {
+        comment: { count: 3, forbidden: false }, forward: { count: 1, forbidden: false }, like: { count: 5, forbidden: false }
+      },
+      module_tag: null,
+      module_interaction: { items: [] }
+    }
+  }
+}
+
+setTimeout(async () => {
+  try {
+    // 替换 amagi 的客户端工厂：每个 Base 实例都会新建 client，只有包住工厂才能稳定注入固定数据
+    const amagi = require('@ikenxuan/amagi')
+    const realFactory = amagi.default
+    amagi.default = function (options) {
+      const client = realFactory(options)
+      client.bilibili.fetcher.fetchUserDynamicList = async () => ({
+        success: true,
+        code: 200,
+        message: 'OK',
+        data: { code: 0, message: 'OK', data: { items: [makeDynamic()], offset: '', has_more: false } }
+      })
+      client.bilibili.fetcher.fetchUserCard = async () => ({
+        success: true, code: 200, message: 'OK',
+        data: { code: 0, message: 'OK', data: { card: { mid: '946974', name: '测试UP', face: '' } } }
+      })
+      return client
+    }
+
+    const { taskQueue } = require(path.join(pluginRoot, 'lib/compat/runtime.js'))
+    const task = taskQueue.find((item) => item.name === 'B站推送')
+    console.log('=== 执行定时任务：B站推送（固定数据） ===')
+    await task.handler()
+
+    const { bilibiliDB } = require(path.join(pluginRoot, 'lib/karin/module/db/index.js'))
+    const pushed = await bilibiliDB.isDynamicPushed('1000000000000000001', 946974, '456').catch((e) => '查询失败: ' + e.message)
+    console.log('动态是否已入库:', pushed)
+
+    console.log('\n=== 共发出 ' + sent.length + ' 条消息 ===')
+    for (const item of sent) {
+      const list = Array.isArray(item.content) ? item.content : [item.content]
+      console.log('→ ' + item.channel + ': ' + list.map((el) => {
+        if (typeof el === 'string') return el.slice(0, 300)
+        const type = el && el.type ? el.type : typeof el
+        const attrs = el && el.attrs ? JSON.stringify(el.attrs).slice(0, 200) : ''
+        return '[' + type + '] ' + attrs
+      }).join(' | '))
+    }
+  } catch (error) {
+    console.error('固定数据推送测试失败:', error && error.stack ? error.stack : error)
+    process.exitCode = 1
+  }
+  process.exit(process.exitCode || 0)
+}, 5000)

package/scripts/smoke-push.cjs

@@ -0,0 +1,104 @@
+/**
+ * 推送/权限链路冒烟测试（真实 Koishi 中间件链路）。
+ *
+ * 覆盖：
+ *   1. `#B站推送列表`：配置 → 数据库 → 渲染兜底 → 发送
+ *   2. `#解析统计`（perm: master）：统计库读取
+ *   3. 权限校验：非 master 执行 master 命令被拒绝、master 放行
+ *   4. 定时任务「B站推送」：真实接口（本机 IP 被 B站风控时应当优雅报错并入库不变）
+ *
+ * 用法：node scripts/smoke-push.cjs
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const { Context } = require('koishi')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const dataRoot = path.resolve(pluginRoot, 'data-smoke')
+const cfgDir = path.join(dataRoot, 'koishi-plugin-kkk', 'config')
+fs.mkdirSync(cfgDir, { recursive: true })
+
+const config = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'config/default_config/config.json'), 'utf8'))
+config.app.parseTip = false
+config.pushlist = {
+  douyin: [],
+  bilibili: [{ switch: true, host_mid: 946974, group_id: ['456:10000'], remark: '影视飓风', pushTypes: ['video', 'draw', 'word'] }]
+}
+config.bilibili.push.switch = true
+fs.writeFileSync(path.join(cfgDir, 'config.json'), JSON.stringify(config, null, 2))
+
+const plugin = require(path.join(pluginRoot, 'lib/index.js'))
+const ctx = new Context()
+const sent = []
+const fakeBot = {
+  selfId: '10000', platform: 'smoke', status: 1, user: { id: '10000', name: 'smoke' }, ctx,
+  sendMessage: async (channel, content) => { sent.push({ channel, content }); return ['msg-1'] },
+  sendPrivateMessage: async (user, content) => { sent.push({ channel: 'private:' + user, content }); return ['msg-1'] },
+  getGuild: async () => ({ name: 'smoke-guild' }),
+  getFriendList: async () => []
+}
+Object.defineProperty(ctx, 'bots', { get: () => [fakeBot] })
+
+// 捕获插件注册的中间件，测试时按 Koishi 的语义依次调用
+const middlewares = []
+const originalMiddleware = ctx.middleware.bind(ctx)
+ctx.middleware = (fn, ...rest) => { middlewares.push(fn); return originalMiddleware(fn, ...rest) }
+
+ctx.plugin(plugin, { dataPath: dataRoot, debug: true, masters: ['12345'] })
+
+const makeSession = (content, userId = '12345') => ({
+  content, selfId: '10000', userId, guildId: '456', channelId: '456',
+  messageId: 'm1', bot: fakeBot, author: { nick: 'smoke' }, username: 'smoke', event: {},
+  send: async (c) => { sent.push({ channel: '456', content: c }); return ['msg-2'] }
+})
+
+/** 模拟 Koishi 的中间件链路：某个中间件不调用 next 即视为消费了该消息 */
+async function dispatch (content, userId) {
+  const session = makeSession(content, userId)
+  let index = 0
+  const run = async () => {
+    while (index < middlewares.length) {
+      const middleware = middlewares[index++]
+      let continued = false
+      await middleware(session, () => { continued = true; return run() })
+      if (!continued) return
+    }
+  }
+  await run()
+}
+
+setTimeout(async () => {
+  const { taskQueue } = require(path.join(pluginRoot, 'lib/compat/runtime.js'))
+  try {
+    console.log('=== 1) #B站推送列表 ===')
+    await dispatch('#B站推送列表')
+
+    console.log('=== 2) #解析统计（perm: master，master 用户） ===')
+    await dispatch('#解析统计')
+
+    console.log('=== 3) 权限校验：#kkk设置推送机器人（perm: master） ===')
+    console.log('--- 非 master（99999） ---')
+    await dispatch('#kkk设置推送机器人10000', '99999')
+    console.log('--- master（12345） ---')
+    await dispatch('#kkk设置推送机器人10000', '12345')
+
+    console.log('=== 4) 定时任务：B站推送（真实接口） ===')
+    const task = taskQueue.find((item) => item.name === 'B站推送')
+    await task.handler().catch((error) => console.log('任务抛出异常（已被 ErrorHandler 处理后重新抛出）:', error.message.slice(0, 120)))
+
+    console.log('\n=== 共发出 ' + sent.length + ' 条消息 ===')
+    for (const item of sent) {
+      const list = Array.isArray(item.content) ? item.content : [item.content]
+      console.log('→ ' + item.channel + ': ' + list.map((el) => {
+        if (typeof el === 'string') return el.slice(0, 200)
+        const type = el && el.type ? el.type : typeof el
+        const attrs = el && el.attrs ? JSON.stringify(el.attrs).slice(0, 160) : ''
+        return '[' + type + '] ' + attrs
+      }).join(' | '))
+    }
+  } catch (error) {
+    console.error('推送冒烟测试失败:', error && error.stack ? error.stack : error)
+    process.exitCode = 1
+  }
+  process.exit(process.exitCode || 0)
+}, 5000)

package/scripts/smoke-qq.cjs

@@ -0,0 +1,147 @@
+/**
+ * QQ 平台适配性冒烟测试（不需要真实 QQ，也不需要外网）。
+ *
+ * 覆盖两个 QQ 场景：
+ *   1. **分享卡片解析**：QQ 官方适配器把卡片原始 JSON（URL 里斜杠被转义成 \/）当纯文本塞进 content，
+ *      导致各平台链接正则匹配不到。这里验证归一化后能正常触发解析。
+ *   2. **合并转发退化**：QQ 官方适配器（platform=qqguild）没有合并转发能力，
+ *      sendForwardMsg 必须退化成直接发送内容；OneBot 系仍走 <message> 元素。
+ *
+ * 用法：node scripts/smoke-qq.cjs
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const { Context } = require('koishi')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const dataRoot = path.resolve(pluginRoot, 'data-smoke-qq')
+fs.mkdirSync(path.join(dataRoot, 'koishi-plugin-kkk', 'config'), { recursive: true })
+
+const VIDEO_URL = 'https://www.w3schools.com/html/mov_bbb.mp4'
+const COVER_URL = 'https://www.w3schools.com/html/pic_trulli.jpg'
+const AWEME_ID = '7123456789012345678'
+
+// 配置：只收视频，避免评论/渲染等分支干扰
+const config = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'config/default_config/config.json'), 'utf8'))
+config.app.parseTip = false
+config.app.removeCache = true
+config.douyin.videoQuality = '720p'
+config.douyin.sendContent = ['video']
+config.pushlist = { douyin: [], bilibili: [] }
+fs.writeFileSync(path.join(dataRoot, 'koishi-plugin-kkk', 'config', 'config.json'), JSON.stringify(config, null, 2))
+
+// 1) 短链解析不走外网
+const axios = require(path.join(pluginRoot, 'node_modules/axios'))
+const LONG_URL = 'https://www.douyin.com/video/' + AWEME_ID
+axios.get = async () => ({ request: { res: { responseUrl: LONG_URL } }, data: '' })
+
+// 2) 抖音接口用固定数据
+const amagi = require('@ikenxuan/amagi')
+const realFactory = amagi.default
+function bitRate (definition, w, h) {
+  return { gear_name: definition, quality_type: 28, bit_rate: 1000000, FPS: 30, format: 'mp4', video_extra: JSON.stringify({ definition }), play_addr: { uri: 'v', url_list: [VIDEO_URL], data_size: 700000, width: w, height: h } }
+}
+amagi.default = function (options) {
+  const client = realFactory(options)
+  client.douyin.fetcher.parseWork = async () => ({
+    success: true, code: 200, message: 'OK',
+    data: { aweme_detail: {
+      aweme_id: AWEME_ID, aweme_type: 0, is_slides: false,
+      desc: 'QQ 卡片解析测试', preview_title: 'QQ 卡片解析测试',
+      create_time: Math.floor(Date.now() / 1000) - 600, share_url: LONG_URL,
+      author: { uid: '1', sec_uid: 'SEC', nickname: '测试作者', unique_id: 't', signature: '', avatar_thumb: { url_list: [COVER_URL] }, avatar_larger: { url_list: [COVER_URL] }, follower_count: 1 },
+      statistics: { digg_count: 1, comment_count: 2, share_count: 3, collect_count: 4, play_count: 5 },
+      images: null, music: null,
+      video: { play_addr: { uri: 'v', url_list: [VIDEO_URL], data_size: 700000, width: 1280, height: 720 }, play_addr_h264: { uri: 'v', url_list: [VIDEO_URL], data_size: 700000, width: 1280, height: 720 }, cover: { url_list: [COVER_URL] }, origin_cover: { url_list: [COVER_URL] }, dynamic_cover: { url_list: [COVER_URL] }, duration: 15000, ratio: '720p', bit_rate: [bitRate('720p', 1280, 720)] }
+    } }
+  })
+  client.douyin.fetcher.fetchWorkComments = async () => ({ success: true, code: 200, message: 'OK', data: { comments: [], cursor: 0, has_more: 0, total: 0 } })
+  client.douyin.fetcher.fetchEmojiList = async () => ({ success: true, code: 200, message: 'OK', data: { emoji_list: [] } })
+  client.douyin.fetcher.fetchUserProfile = async () => ({ success: true, code: 200, message: 'OK', data: { user: { uid: '1', sec_uid: 'SEC', nickname: '测试作者', avatar_thumb: { url_list: [COVER_URL] }, follower_count: 1 } } })
+  return client
+}
+
+const plugin = require(path.join(pluginRoot, 'lib/index.js'))
+const { KkkBot, makeForward } = require(path.join(pluginRoot, 'lib/compat/node-karin.js'))
+
+const sent = []
+const makeBot = (platform) => ({
+  selfId: '10000', platform, status: 1, user: { id: '10000', name: 'test' },
+  sendMessage: async (channel, content) => { sent.push({ platform, channel, content }); return ['msg-1'] },
+  getGuild: async () => ({ name: 'g' }), getFriendList: async () => []
+})
+
+const qqBot = makeBot('qqguild')
+const ctx = new Context()
+Object.defineProperty(ctx, 'bots', { get: () => [qqBot] })
+const middlewares = []
+const originalMiddleware = ctx.middleware.bind(ctx)
+ctx.middleware = (fn, ...rest) => { middlewares.push(fn); return originalMiddleware(fn, ...rest) }
+// qqPanel 关掉：本用例验证的是「卡片链接识别」和「合并转发退化」，
+// 面板会把解析截胡（那是 scripts/smoke-qqpanel.cjs 的用例），这里只要原行为
+ctx.plugin(plugin, { dataPath: dataRoot, debug: true, masters: ['12345'], webui: false, qqPanel: false })
+
+const makeSession = (content) => ({
+  content, selfId: '10000', userId: '12345', guildId: '456', channelId: '456',
+  messageId: 'm1', bot: qqBot, author: { nick: 'smoke' }, username: 'smoke', event: {},
+  send: async (c) => { sent.push({ platform: 'qqguild', channel: '456', content: c }); return ['msg-2'] }
+})
+
+async function dispatch (content) {
+  const session = makeSession(content)
+  let index = 0
+  const run = async () => {
+    while (index < middlewares.length) {
+      const middleware = middlewares[index++]
+      let continued = false
+      await middleware(session, () => { continued = true; return run() })
+      if (!continued) return
+    }
+  }
+  await run()
+}
+
+let failures = 0
+const check = (name, ok, extra = '') => {
+  console.log((ok ? '✅' : '❌') + ' ' + name + (extra ? ' | ' + extra : ''))
+  if (!ok) failures++
+}
+
+setTimeout(async () => {
+  try {
+    // === 1. QQ 分享卡片（URL 斜杠被 JSON 转义） ===
+    const card = '{"app":"com.tencent.structmsg","meta":{"detail_1":{"qqdocurl":"https:\\/\\/www.douyin.com\\/video\\/' + AWEME_ID + '"}},"prompt":"[分享] 抖音"}'
+    console.log('=== 1) QQ 卡片消息解析 ===')
+    console.log('卡片原文: ' + card.slice(0, 100))
+    const before = sent.length
+    await dispatch(card)
+    const produced = sent.slice(before)
+    const hasVideo = produced.some((item) => JSON.stringify(item.content).includes('video/mp4'))
+    check('卡片里的链接被识别并触发抖音解析', hasVideo, hasVideo ? '发出了视频消息' : '没有任何输出')
+
+    // 对照：把转义还原关掉（模拟旧行为）应当匹配不到，这里只做说明性输出
+    const raw = card
+    check('原样文本匹配不到链接（说明转义是根因）', !/(https?:\/\/)(www\.)?douyin\.com/.test(raw), '')
+
+    // === 2. 合并转发退化 ===
+    console.log('')
+    console.log('=== 2) 合并转发 ===')
+    const payload = makeForward(['第一段', '第二段'], '10000', '测试Bot')
+    sent.length = 0
+    await new KkkBot(qqBot).sendForwardMsg('456', payload)
+    const qqSent = sent.slice()
+    check('QQ（qqguild）退化为直接发送内容', qqSent.length > 0 && !JSON.stringify(qqSent).includes('"message"'),
+      '发出 ' + qqSent.length + ' 条，元素类型 ' + qqSent.map((s) => (Array.isArray(s.content) ? s.content.map((e) => e.type || typeof e).join(',') : typeof s.content)).join(' / '))
+
+    const onebotBot = makeBot('onebot')
+    sent.length = 0
+    await new KkkBot(onebotBot).sendForwardMsg('456', payload)
+    const obSent = sent.slice()
+    check('OneBot 仍使用合并转发元素', JSON.stringify(obSent).includes('"message"'),
+      '元素类型 ' + obSent.map((s) => (Array.isArray(s.content) ? s.content.map((e) => e.type || typeof e).join(',') : typeof s.content)).join(' / '))
+  } catch (error) {
+    console.error('QQ 冒烟测试失败:', error && error.stack ? error.stack : error)
+    failures++
+  }
+  process.exit(failures ? 1 : 0)
+}, 5000)

package/scripts/smoke-qqcard.cjs

@@ -0,0 +1,108 @@
+/**
+ * 冒烟测试：QQ 分享卡片解析与「无链接卡片」还原。
+ *
+ * 覆盖四种卡片形态 + 一条反例：
+ *   1. meta.detail_1.qqdocurl（带 JSON 转义的 b23.tv 短链）→ 只要链接被还原出来即可（不触发搜索）
+ *   2. meta.news 卡片，带封面 → 走封面哈希命中 B 站搜索
+ *   3. meta.news 卡片，只有标题 → 走标题匹配
+ *   4. 抖音卡片 → 识别成 douyin，不应触发 B 站搜索
+ *   5. 不存在的标题 → 必须放弃还原（宁可解析失败也不能猜错）
+ *
+ * 用法：node scripts/smoke-qqcard.cjs
+ */
+const path = require('node:path')
+const { Context } = require('koishi')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const plugin = require(path.join(pluginRoot, 'lib', 'index.js'))
+
+const dataPath = path.resolve(pluginRoot, 'data-smoke')
+const ctx = new Context()
+ctx.plugin(plugin, { dataPath, debug: true })
+
+/** 一条卡片消息（JSON 转义过的斜杠，和 QQ 适配器塞进来的形态一致） */
+const cardWithLink = '{"app":"com.tencent.structmsg","config":{"ctime":1700000000,"forward":1},"desc":"哔哩哔哩","meta":{"detail_1":{"appid":"1109937557","desc":"哔哩哔哩","qqdocurl":"https:\\/\\/b23.tv\\/aBcDeFg","title":"【测试】卡片视频"}},"prompt":"[分享] 卡片视频","view":"news"}'
+
+const newsCard = (title, cover) => JSON.stringify({
+  app: 'com.tencent.structmsg',
+  view: 'news',
+  desc: '哔哩哔哩',
+  meta: { news: { appid: '1109937557', tag: '哔哩哔哩', title, ...(cover ? { preview: cover } : {}), jumpUrl: '' } },
+  prompt: '[分享] ' + title
+})
+
+const douyinCard = JSON.stringify({
+  app: 'com.tencent.structmsg',
+  desc: '抖音',
+  meta: { detail_1: { appid: '1109937556', title: '抖音短视频', desc: '抖音' } },
+  prompt: '[分享] 抖音短视频'
+})
+
+const results = []
+const check = (name, ok, detail) => {
+  results.push({ name, ok })
+  console.log((ok ? '  ✅ ' : '  ❌ ') + name + (detail ? '  —— ' + detail : ''))
+}
+
+setTimeout(async () => {
+  try {
+    const { resolveQqCardContent } = require(path.join(pluginRoot, 'lib/karin/module/utils/QqCardResolve.js'))
+    const { parseQqCards } = require(path.join(pluginRoot, 'lib/compat/qqcard.js'))
+    const { searchBilibiliVideos } = require(path.join(pluginRoot, 'lib/karin/platform/bilibili/search.js'))
+
+    console.log('\n[1] 解析器：卡片字段抽取')
+    const cards = parseQqCards(cardWithLink)
+    check('detail_1 卡片被识别', cards.length === 1, 'cards=' + cards.length)
+    check('平台判定为 bilibili', cards[0] && cards[0].platform === 'bilibili', cards[0] && cards[0].platform)
+    check('标题抽取正确', cards[0] && cards[0].title === '【测试】卡片视频', cards[0] && cards[0].title)
+    check('qqdocurl 被还原成正常链接', cards[0] && cards[0].urls.includes('https://b23.tv/aBcDeFg'), cards[0] && cards[0].urls.join(','))
+    const dy = parseQqCards(douyinCard)
+    check('抖音卡片判定为 douyin', dy[0] && dy[0].platform === 'douyin', dy[0] && dy[0].platform)
+
+    console.log('\n[2] 带短链的卡片：不触发搜索，直接补链接')
+    const withLink = await resolveQqCardContent(cardWithLink)
+    check('文本里出现 b23.tv 链接', withLink.includes('b23.tv/aBcDeFg'), withLink.slice(-60))
+
+    console.log('\n[3] 无链接卡片（带封面）：封面哈希命中')
+    // 先用搜索接口拿一条真实结果的封面，再伪造一张「同封面、无链接」的卡片
+    const probe = await searchBilibiliVideos({ keyword: '字幕君交流场所', title: '字幕君交流场所', limit: 5 })
+    check('搜索接口可用', probe.length > 0, probe.length ? probe[0].bvid + ' ' + probe[0].title : '无结果')
+    // 老视频的封面是 transparent.gif 占位图，取第一条真有稿件封面的结果来验封面哈希分支
+    const target = probe.find((item) => /bfs\/archive/.test(item.pic))
+    check('存在带稿件封面的结果', !!target, target ? target.bvid : '无')
+    if (target) {
+      // 搜索接口的 pic 偶发返回占位图（transparent.gif），这时封面没得比，
+      // 最多重试 3 次，把「上游抽风」和「封面匹配坏了」区分开
+      let hit = null
+      for (let attempt = 0; attempt < 3 && !hit; attempt++) {
+        const items = await searchBilibiliVideos({ keyword: target.title, title: target.title, cover: target.pic, limit: 5 })
+        if (items[0] && items[0].coverMatch) hit = items[0]
+      }
+      check('同封面搜索时 coverMatch 命中', !!hit, hit ? hit.bvid + ' score=' + hit.score : '3 次都只拿到占位封面（上游抽风）')
+      if (hit) {
+        const resolved = await resolveQqCardContent(newsCard(target.title, target.pic))
+        check('卡片按封面还原出 ' + target.bvid, resolved.includes('bilibili.com/video/' + target.bvid), resolved.slice(-70))
+      }
+    }
+
+    console.log('\n[4] 无链接卡片（只有标题）：标题匹配')
+    const titleOnly = await resolveQqCardContent(newsCard('字幕君交流场所', ''))
+    check('还原出 BV1xx411c7mD', titleOnly.includes('BV1xx411c7mD'), titleOnly.slice(-70))
+
+    console.log('\n[5] 反例：不存在的标题必须放弃还原')
+    const junk = await resolveQqCardContent(newsCard('这个标题绝对不存在zzzq', ''))
+    check('没有凭空造出链接', !/bilibili\.com\/video|b23\.tv/.test(junk), junk.slice(-70))
+
+    console.log('\n[6] 抖音卡片不触发 B 站搜索')
+    const dyResolved = await resolveQqCardContent(douyinCard)
+    check('结果与普通文本一致', !/bilibili\.com/.test(dyResolved), dyResolved.slice(-50))
+
+    const failed = results.filter((item) => !item.ok)
+    console.log('\n=== ' + (results.length - failed.length) + '/' + results.length + ' 通过 ===')
+    process.exitCode = failed.length ? 1 : 0
+  } catch (error) {
+    console.error('冒烟测试失败:', error && error.stack ? error.stack : error)
+    process.exitCode = 1
+  }
+  process.exit(process.exitCode || 0)
+}, 4000)