koishi-plugin-kkk 3.7.2 → 3.9.0

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

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

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

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

package/lib/karin/setup.js

@@ -38,7 +38,6 @@ require(".//platform/bilibili/riskControl");
 const node_karin_1 = __importStar(require("../compat/node-karin.js"));
 const root_1 = require("../compat/root.js");
 const module_1 = require(".//module");
-const db_1 = require(".//module/db");
 const semver_1 = require("./module/utils/semver");
 // ----------------- VERSION CHECK -----------------
 const requireVersion = typeof __REQUIRE_KARIN_VERSION__ !== 'undefined' ? __REQUIRE_KARIN_VERSION__ : '1.1145.14';
@@ -90,9 +89,8 @@ if (process.env.NODE_ENV !== 'development' && (0, semver_1.isSemverGreater)(requ
     });
 }
 // ----------------- DATABASE INIT -----------------
-await (0, db_1.initAllDatabases)().catch((err) => {
-    node_karin_1.logger.error(`[koishi-plugin-kkk] 数据库初始化失败: ${err.message}`);
-});
+// 数据库走 Koishi 原生服务（ctx.database），由插件入口在 apply 阶段调用
+// bootstrapDatabases(ctx) 引导，这里不再初始化任何自有的 sqlite 文件。
 // ------------------- MAIN INIT -------------------
 (0, node_karin_1.mkdirSync)(`${root_1.karinPathBase}/${module_1.Root.pluginName}/data`);
 (0, node_karin_1.mkdirSync)(module_1.Common.tempDri.images);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "3.7.2",
+  "version": "3.9.0",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -43,6 +43,7 @@
     "postinstall": "node scripts/patch-deps.mjs",
     "patch-deps": "node scripts/patch-deps.mjs",
     "smoke": "node scripts/smoke-parse.cjs",
+    "smoke:db": "node scripts/smoke-db-koishi.cjs",
     "placeholders": "node scripts/make-demo-placeholders.mjs",
     "smoke:render": "node scripts/smoke-render.cjs",
     "check-types": "tsc -p tsconfig.json"
@@ -52,7 +53,7 @@
   },
   "dependencies": {
     "@icons-pack/react-simple-icons": "^13.15.1",
-    "@ikenxuan/amagi": "6.6.0",
+    "@ikenxuan/amagi": "7.0.0-beta.5",
     "@ikenxuan/qrcode": "1.5.0",
     "@outpacelabs/avatars": "0.6.0",
     "@phosphor-icons/react": "^2.1.10",

package/scripts/build.mjs

@@ -9,7 +9,7 @@
  *    - node-karin[/sub] → 兼容层实现（这样产物自带兼容层，不依赖 node_modules 里的转发包）
  */
 import { execFileSync } from 'node:child_process'
-import { readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from 'node:fs'
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 
@@ -27,10 +27,20 @@ if (configFile.error) {
 const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, root)
 const options = { ...parsed.options, noCheck: true, incremental: false }
 
-if (existsSync(outDir)) rmSync(outDir, { recursive: true, force: true })
+/**
+ * 记录本次 emit 写出的文件，用于构建后清理残留。
+ *
+ * 以前是 emit 前直接 rmSync 掉整个 lib（一次删几百个文件），现在改成事后比对清理：
+ * 只删「上次产物里有、这次没被重写」的文件，正常情况下是 0 个。
+ */
+const emitted = new Set()
+const recordAndWrite = (fileName, text, writeByteOrderMark) => {
+  emitted.add(path.resolve(fileName))
+  ts.sys.writeFile(fileName, text, writeByteOrderMark)
+}
 
 const program = ts.createProgram(parsed.fileNames, options)
-const emitResult = program.emit()
+const emitResult = program.emit(undefined, recordAndWrite)
 
 const diagnostics = ts.getPreEmitDiagnostics(program).filter((item) => item.category === ts.DiagnosticCategory.Error)
 if (diagnostics.length) {
@@ -49,10 +59,32 @@ if (emitResult.emitSkipped) {
   process.exit(1)
 }
 
+/** 递归收集目录下的文件（只用于找残留产物） */
+const walkFiles = (dir, out = []) => {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) walkFiles(full, out)
+    else if (entry.isFile()) out.push(full)
+  }
+  return out
+}
+
+/** 清掉这次没被重写的旧产物（比如删除源文件后 lib 里留下的孤儿 .js） */
+const cleanStaleArtifacts = () => {
+  const stale = walkFiles(outDir).filter((file) => {
+    if (!/\.(js|cjs|mjs|d\.ts|map)$/.test(file)) return false
+    return !emitted.has(path.resolve(file))
+  })
+  for (const file of stale) {
+    rmSync(file, { force: true })
+    console.log('  清理残留 ' + path.relative(outDir, file).split(path.sep).join('/'))
+  }
+  return stale.length
+}
+
 /** 顺序敏感：子路径必须排在 node-karin 之前 */
 const ALIASES = [
   { prefix: 'node-karin/root', target: 'compat/root', exact: true },
-  { prefix: 'node-karin/sqlite3', target: 'compat/sqlite3', exact: true },
   { prefix: 'node-karin/axios', target: 'compat/axios', exact: true },
   { prefix: 'node-karin/yaml', target: 'compat/yaml', exact: true },
   { prefix: 'node-karin/express', target: 'compat/express', exact: true },
@@ -161,5 +193,6 @@ if (offenders.length) {
   for (const item of offenders) console.error('  - ' + item)
   process.exit(1)
 }
-console.log('构建完成：输出到 ' + path.relative(root, outDir) + '，重写别名文件 ' + rewritten + ' 个')
+const stale = cleanStaleArtifacts()
+console.log('构建完成：输出到 ' + path.relative(root, outDir) + '，重写别名文件 ' + rewritten + ' 个，清理残留 ' + stale + ' 个')
 console.log('构建信息：v' + buildMetadata.version + ' · ' + (buildMetadata.shortCommitHash || '无 commit') + ' · ' + buildMetadata.buildTime)

package/scripts/deploy.mjs

@@ -5,12 +5,17 @@
  * 不带 src、scripts、测试数据。依赖不复制（那会多出 400+ MB），而是在副本里建一个
  * node_modules junction 指回开发目录的依赖，Node 的模块解析照常生效。
  *
+ * 同步策略是「镜像」而不是「先删再拷」：
+ *   - 覆盖：源文件比目标新（或大小不同）才复制
+ *   - 清理：目标里源已经没有的文件逐个删掉（比如删掉的旧模块），避免残留文件被 require 到
+ *   - 依赖 junction：路径不对（比如项目从 D 盘迁到 E 盘后指向了不存在的旧路径）就重建
+ *
  * 用法：
  *   node scripts/deploy.mjs                        # 部署到 <工作区>/node_modules/koishi-plugin-kkk
  *   node scripts/deploy.mjs --with-deps            # 连依赖一起复制（自包含，可整体拷走，约 450 MB）
  *   node scripts/deploy.mjs --target <dir>         # 指定目标目录
  */
-import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, rmSync, statSync, symlinkSync } from 'node:fs'
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, realpathSync, rmSync, statSync, symlinkSync, unlinkSync } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 
@@ -32,47 +37,91 @@ if (!existsSync(path.join(root, 'lib', 'index.js'))) {
   process.exit(1)
 }
 
-// 清掉旧的部署（可能是 junction、目录或文件）
-if (existsSync(target) || lstatSync(target, { throwIfNoEntry: false })) {
-  rmSync(target, { recursive: true, force: true })
+const stats = { copied: 0, removed: 0, bytes: 0 }
+
+/** 收集目录里的相对文件路径（用 / 分隔） */
+function walk (dir, base = dir, out = new Map()) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) walk(full, base, out)
+    else if (entry.isFile()) out.set(path.relative(base, full).split(path.sep).join('/'), full)
+  }
+  return out
+}
+
+/** 目录镜像：该覆盖的覆盖，该删的删 */
+function mirrorDir (from, to) {
+  const src = walk(from)
+  const dst = existsSync(to)
+    ? walk(to)
+    : (mkdirSync(to, { recursive: true }), new Map())
+
+  for (const [rel, srcFile] of src) {
+    const dstFile = path.join(to, rel.split('/').join(path.sep))
+    const s = statSync(srcFile)
+    const d = existsSync(dstFile) ? statSync(dstFile) : null
+    if (d && d.size === s.size && d.mtimeMs >= s.mtimeMs) continue
+    mkdirSync(path.dirname(dstFile), { recursive: true })
+    cpSync(srcFile, dstFile)
+    stats.copied++
+    stats.bytes += s.size
+  }
+
+  for (const [rel, dstFile] of dst) {
+    if (src.has(rel)) continue
+    rmSync(dstFile, { force: true })
+    stats.removed++
+    console.log('  删除残留 ' + rel)
+  }
 }
+
 mkdirSync(target, { recursive: true })
 
-let copied = 0
-let bytes = 0
 for (const entry of ENTRIES) {
   const from = path.join(root, entry)
   if (!existsSync(from)) continue
   const to = path.join(target, entry)
-  cpSync(from, to, { recursive: true })
-  const size = statSync(from).isDirectory()
-    ? readdirSync(from, { recursive: true }).reduce((sum, item) => {
-      const file = path.join(from, item)
-      return sum + (statSync(file).isFile() ? statSync(file).size : 0)
-    }, 0)
-    : statSync(from).size
-  bytes += size
-  copied++
-  console.log('  复制 ' + entry + '（' + (size / 1024 / 1024).toFixed(2) + ' MB）')
+  if (statSync(from).isDirectory()) {
+    mirrorDir(from, to)
+  } else {
+    const s = statSync(from)
+    const d = existsSync(to) ? statSync(to) : null
+    if (d && d.size === s.size && d.mtimeMs >= s.mtimeMs) continue
+    cpSync(from, to)
+    stats.copied++
+    stats.bytes += s.size
+  }
 }
 
+// 依赖：--with-deps 时整份复制，否则用 junction 指回开发目录
+const depsLink = path.join(target, 'node_modules')
+const deps = path.join(root, 'node_modules')
 if (withDeps) {
-  const from = path.join(root, 'node_modules')
-  if (existsSync(from)) {
+  if (existsSync(deps)) {
     console.log('  复制 node_modules（依赖，比较慢）…')
-    cpSync(from, path.join(target, 'node_modules'), { recursive: true })
+    cpSync(deps, depsLink, { recursive: true })
   }
-} else {
-  // 依赖不复制，用 junction 指回开发目录；Node 解析依赖时会正常走到这里
-  const deps = path.join(root, 'node_modules')
-  if (existsSync(deps)) {
-    symlinkSync(deps, path.join(target, 'node_modules'), 'junction')
-    console.log('  依赖：junction → ' + deps)
+} else if (existsSync(deps)) {
+  // junction 可能指向一个已经不存在的路径（项目换过盘符/目录），这时必须重建，
+  // 否则运行时解析插件私有依赖会直接失败
+  let current = null
+  if (lstatSync(depsLink, { throwIfNoEntry: false })) {
+    try { current = realpathSync(depsLink) } catch { current = null }
+  }
+  if (current && path.resolve(current) === path.resolve(deps)) {
+    console.log('  依赖：junction 已正确 → ' + deps)
   } else {
-    console.warn('  警告：开发目录没有 node_modules，副本运行时会缺依赖')
+    if (existsSync(depsLink) || lstatSync(depsLink, { throwIfNoEntry: false })) {
+      try { rmSync(depsLink, { recursive: true, force: true }) } catch { unlinkSync(depsLink) }
+    }
+    symlinkSync(deps, depsLink, 'junction')
+    console.log('  依赖：junction' + (current ? '（修复，原来指向 ' + current + '）' : '') + ' → ' + deps)
   }
+} else {
+  console.warn('  警告：开发目录没有 node_modules，副本运行时会缺依赖')
 }
 
 console.log('\n部署完成 → ' + target)
-console.log('  文件 ' + copied + ' 项，约 ' + (bytes / 1024 / 1024).toFixed(2) + ' MB' + (withDeps ? '（另有依赖副本）' : '，依赖走 junction'))
+console.log('  更新 ' + stats.copied + ' 个文件，约 ' + (stats.bytes / 1024 / 1024).toFixed(2) + ' MB；清理残留 ' + stats.removed + ' 个'
+  + (withDeps ? '；另有依赖副本' : '；依赖走 junction'))
 console.log('  宿主重启（koishi start）后生效')

package/scripts/smoke-amagi-capability.cjs

@@ -0,0 +1,97 @@
+/**
+ * 冒烟测试：**解析库（@ikenxuan/amagi）得是带 secsdk 的那一版**。
+ *
+ * 线上事故：抖音从某天起要求 web 接口带 `uifid` + `x-secsdk-web-signature`（Argus 风控），
+ * npm 上的 latest 6.6.0 没有这套实现 → 每个抖音接口都被拦成
+ * `403 Blocked by ArgusSecurityPlugin Uifid Not Found` → 插件报「Cookie 失效」。
+ * 换 cookie、换网络都没用，**只能升解析库**（上游 karin-plugin-kkk 也是把新 amagi 打进包里）。
+ *
+ * 这个冒烟不联网，只检查「装到的那份库**有**做签名和 uifid 的能力」：
+ * 一旦有人把依赖降回 6.x，这里立刻红，不会等到用户来报「抖音解析不了」。
+ *
+ * 用法：node scripts/smoke-amagi-capability.cjs
+ */
+const fs = require('node:fs')
+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++
+}
+
+/** 装上那份库的根目录：require.resolve 拿到入口文件，再往上找 package.json */
+const resolveInstalled = () => {
+  const entry = require.resolve('@ikenxuan/amagi', { paths: [pluginRoot] })
+  let dir = path.dirname(entry)
+  for (let i = 0; i < 6; i++) {
+    const candidate = path.join(dir, 'package.json')
+    if (fs.existsSync(candidate)) {
+      const pkg = JSON.parse(fs.readFileSync(candidate, 'utf8'))
+      if (pkg.name === '@ikenxuan/amagi') return { dir, pkg }
+    }
+    dir = path.dirname(dir)
+  }
+  return null
+}
+
+const versionOf = (text) => String(text ?? '').split('-')[0].split('.').map((n) => Number(n) || 0)
+
+const main = () => {
+  console.log('— 解析库能力 —')
+  const installed = resolveInstalled()
+  check('能找到已安装的 @ikenxuan/amagi', !!installed, installed ? installed.dir : '（找不到）')
+  if (!installed) return done()
+
+  const [major] = versionOf(installed.pkg.version)
+  check('装的是 7.x（6.x 没有 secsdk，抖音会被 Argus 拦）', major >= 7, '实际 ' + installed.pkg.version)
+
+  /** secsdk 签名只在 7.x 里导出，是最直接的能力探针 */
+  let signing = null
+  try {
+    signing = require('@ikenxuan/amagi/signing')
+  } catch (error) {
+    signing = null
+    check('导出 ./signing（secsdk 签名，7.x 才有）', false, String(error && error.message).slice(0, 120))
+  }
+  if (signing) {
+    const names = Object.keys(signing)
+    check('导出 ./signing（secsdk 签名，7.x 才有）', names.length > 0, names.slice(0, 6).join(', ') + '…')
+    check('签名模块里能找到 secsdk / uifid 相关导出',
+      names.some((name) => /secsdk|uifid|sign/i.test(name)),
+      names.filter((name) => /secsdk|uifid|sign/i.test(name)).slice(0, 6).join(', '))
+  }
+
+  const amagi = require('@ikenxuan/amagi')
+  const Client = amagi.Client || amagi.default
+  check('Client 能拿到（v7 的默认导出）', typeof Client === 'function', typeof Client)
+  if (typeof Client === 'function') {
+    const client = Client({ cookies: {}, request: {}, debug: false })
+    check('client.douyin.fetcher.parseWork 在（插件主链路）', typeof client?.douyin?.fetcher?.parseWork === 'function')
+    check('client.douyin.login 在（扫码登录走它）', typeof client?.douyin?.login?.qrcode === 'function')
+  }
+
+  console.log('')
+  console.log('— 仓库里的声明 —')
+  const pkg = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'package.json'), 'utf8'))
+  const pinned = pkg.dependencies?.['@ikenxuan/amagi']
+  const [pinnedMajor] = versionOf(pinned)
+  check('package.json 钉的版本也是 7.x', pinnedMajor >= 7, '实际 ' + String(pinned))
+
+  done()
+}
+
+const done = () => {
+  console.log('')
+  console.log(failures === 0 ? '全部通过' : failures + ' 项失败')
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+try {
+  main()
+} catch (error) {
+  console.error(error)
+  process.exit(1)
+}

package/scripts/smoke-comments.cjs

@@ -0,0 +1,164 @@
+/**
+ * 冒烟测试：**快手 / 小红书的评论数据能变成模板要的结构**。
+ *
+ * 这两条评论链路对接的接口都换过（快手换到 H5 photo/comment/list、小红书字段也变过），
+ * 换完之后字段名、层级、置顶标记、子评论形状全变，而插件是「取不到就静默少一块」的风格 ——
+ * 错了不会报错，只是评论区空着。这里用两大平台**真实的返回形状**喂进去，盯住映射结果：
+ *   - 字段对不对（昵称 / 点赞 / 子评论数 / ip 归属地 / 图片兜底）
+ *   - 富文本对不对（表情、@、换行都解析成节点，不是拼 HTML）
+ *   - 排序与条数限制（快手按点赞、小红书置顶优先，超上限按配置截断）
+ *
+ * 用法：node scripts/smoke-comments.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 noop = () => {}
+const dataRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'kkk-comments-'))
+const runtime = require(path.join(pluginRoot, 'lib/compat/runtime.js'))
+runtime.bindRuntime({
+  ctx: { get: () => undefined, logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }), bots: [], registry: new Map(), on: () => () => {} },
+  config: {},
+  pluginRoot,
+  dataRoot
+})
+
+const { Config } = require(path.join(pluginRoot, 'lib/karin/module/utils/Config.js'))
+const { kuaishouComments } = require(path.join(pluginRoot, 'lib/karin/platform/kuaishou/comments.js'))
+const { xiaohongshuComments } = require(path.join(pluginRoot, 'lib/karin/platform/xiaohongshu/comments.js'))
+
+/** 节点类型序列，方便断言富文本结构 */
+const kinds = (doc) => (doc && Array.isArray(doc.nodes) ? doc.nodes.map((node) => node.type) : [])
+const textOf = (doc) => (doc && Array.isArray(doc.nodes) ? doc.nodes.filter((n) => n.type === 'text').map((n) => n.text).join('') : '')
+
+const EMOJIS = [
+  { name: '[微笑]', url: 'https://example.com/smile.png' },
+  { name: '[笑]', url: 'https://example.com/laugh.png' }
+]
+
+const main = async () => {
+  console.log('— 快手评论区 —')
+  {
+    Config.initCfg()
+    const payload = {
+      // H5 接口的形状：rootComments 在顶层、字段是 snake_case
+      rootComments: [
+        {
+          comment_id: 111,
+          author_name: '点赞少的',
+          headurl: 'https://example.com/a.jpg',
+          content: '第一条\n第二行',
+          likedCount: 3,
+          timestamp: 1700000000,
+          subCommentCount: 2
+        },
+        {
+          comment_id: 222,
+          author_name: '点赞多的',
+          headurl: 'https://example.com/b.jpg',
+          content: '[微笑]@小明(123) 你好',
+          likedCount: '1.2万',
+          timestamp: 1700000001,
+          subCommentCount: 0
+        }
+      ]
+    }
+    const list = await kuaishouComments(payload, EMOJIS)
+  const byNick = (nick) => list.find((item) => item.nickname === nick)
+  const many = byNick('点赞多的')
+  const few = byNick('点赞少的')
+
+  check('两条都映射出来了', list.length === 2, '实际 ' + list.length)
+  check('cid / aweme_id 是字符串（H5 接口给的是数字）', many?.cid === '222' && many?.aweme_id === '222', String(many?.cid))
+  check('昵称与头像映射正确', many?.nickname === '点赞多的' && many?.userimageurl === 'https://example.com/b.jpg')
+  check('子评论数映射正确', few?.reply_comment_total === 2, String(few?.reply_comment_total))
+  /**
+   * 「1.2万」这种点赞数解不出数字时**兜底为 0**（而不是 NaN / 1.2）：
+   * 快手的 H5 接口只给展示用的字符串，排序会因此把它排到后面，这是已知取舍。
+   */
+  check('「1.2万」这种点赞数兜底为 0（不是 NaN）', many?.digg_count === 0 && Number.isFinite(many?.digg_count), String(many?.digg_count))
+  check('按点赞排序（兜底为 0 的排后面）', list[0]?.nickname === '点赞少的', list.map((c) => c.nickname).join(','))
+  check('正文里的表情解析成 emoji 节点', kinds(many?.text).includes('emoji'), kinds(many?.text).join(','))
+  check('@昵称(uid) 解析成 mention 节点',
+    kinds(many?.text).includes('mention'),
+    JSON.stringify(many?.text?.nodes?.find((node) => node.type === 'mention')))
+  check('换行解析成 lineBreak 节点', kinds(few?.text).includes('lineBreak'), kinds(few?.text).join(','))
+  check('富文本里没有 HTML 字符串', !JSON.stringify(list).includes('&lt;') && !JSON.stringify(list).includes('<span'))
+
+  const empty = await kuaishouComments({ rootComments: [] }, EMOJIS)
+    check('没有评论时返回空数组（不是报错）', Array.isArray(empty) && empty.length === 0)
+  }
+
+  console.log('')
+  console.log('— 小红书评论区 —')
+  {
+    const payload = {
+      data: {
+        comments: [
+          {
+            id: 'c1',
+            note_id: 'n1',
+            content: '普通评论',
+            user_info: { nickname: '普通用户' },
+            create_time: 1700000000,
+            like_count: 1,
+            liked: false,
+            sub_comment_count: 1,
+            sub_comments: [
+              { id: 's1', note_id: 'n1', content: '子评论 [笑]', user_info: { nickname: '子用户' }, create_time: 1700000001, like_count: 0, ip_location: '上海', show_tags: [], status: 0 }
+            ],
+            show_tags: [],
+            at_users: ['@旧形态'],
+            ip_location: '',
+            pictures: null,
+            status: 0
+          },
+          {
+            id: 'c2',
+            note_id: 'n1',
+            content: '置顶评论',
+            user_info: { nickname: '置顶用户' },
+            create_time: 1700000002,
+            like_count: 5,
+            liked: true,
+            sub_comment_count: 0,
+            sub_comments: [],
+            show_tags: ['user_top'],
+            at_users: [{ nickname: '新形态' }, { user_info: { nickname: '另一种形态' } }],
+            ip_location: '北京',
+            pictures: [{ url: 'https://example.com/p.jpg' }],
+            status: 0
+          }
+        ]
+      }
+    }
+    const list = xiaohongshuComments(payload, EMOJIS)
+    check('两条都映射出来了', list.length === 2, '实际 ' + list.length)
+    check('置顶（user_top）排最前', list[0]?.id === 'c2', list.map((c) => c.id).join(','))
+    check('ip 归属地缺失时兜底「未知」', list[1]?.ip_location === '未知', String(list[1]?.ip_location))
+    check('pictures 不是数组时兜底成空数组', Array.isArray(list[1]?.pictures) && list[1].pictures.length === 0)
+    check('子评论也映射出来了且带表情', list[1]?.sub_comments?.length === 1 && kinds(list[1]?.sub_comments?.[0]?.content).includes('emoji'))
+    check('at_users 两种形态（字符串 / 对象）都能归一化',
+      list[1]?.at_users?.join(',') === '@旧形态' && list[0]?.at_users?.join(',') === '@新形态,@另一种形态',
+      JSON.stringify([list[0]?.at_users, list[1]?.at_users]))
+    check('正文富文本带平台标记', list[0]?.content?.platform === 'xiaohongshu' && textOf(list[0]?.content).includes('置顶评论'))
+
+    const empty = xiaohongshuComments({ data: { comments: [] } }, EMOJIS)
+    check('没有评论时返回空数组（不是报错）', Array.isArray(empty) && empty.length === 0)
+  }
+
+  console.log('')
+  console.log(failures === 0 ? '全部通过' : failures + ' 项失败')
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((error) => { console.error(error); process.exit(1) })