koishi-plugin-kkk 3.7.2 → 3.8.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # 更新日志
 
+## 3.8.0
+
+> 抖音解析修好了。抖音那边改了风控规则，**换 cookie 是没用的** —— 问题出在解析用的那个库太旧；
+> 顺带修好快手、小红书的评论区渲染。
+
+### 抖音：解析不了 / 一直提示 Cookie 失效
+
+- **现象**：发抖音链接，机器人回「抖音没有返回这条作品的数据（错误码 500：抖音数据获取失败），
+  常见原因：Cookie 失效、被风控」，可同一个 cookie 换个插件却能正常解析。
+- **原因**：抖音现在要求每个网页接口都带上设备标识（`uifid`）和一套新的签名头
+  （`x-secsdk-web-signature`，由抖音自己的风控 SDK 算出来）。
+  插件用的解析库 6.6.0 里根本没有这套东西，请求直接被抖音拦下
+  （服务器回的是「Blocked by ArgusSecurityPlugin Uifid Not Found」），
+  库再把它包成一句「抖音数据获取失败」—— 看起来就像 cookie 过期，怎么换都没用。
+- **处理**：把解析库升到 7.x（目前是 7.0.0-beta.5；npm 上标着「最新」的 6.6.0 反而是坏的）。
+  升级后实测：作品详情、评论区、弹幕都正常。
+- 更新完**重启一次机器人**即可；手动 `npm i` 更新插件时会自动装上对应版本的解析库。
+
+### 日志更好排查
+
+- 以后再遇到这类失败，日志里会直接写明「**多半是解析库版本过旧**」，
+  不用再照着「换 cookie、换网络」排查半天。
+
+### 修复快手评论渲染
+
+- 快手评论区接口以前未实现，现已实现
+
+### 修复小红书评论渲染
+
+- 小红书评论区接口变更导致失效，现已重新接好，评论能正常显示了
+
 ## 3.7.2
 
 > 群里发的图片**统一改走 markdown** 了 —— 普通图片消息会被 QQ 压得发糊，markdown 图片不会；

package/lib/build-metadata.json

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

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/package.json

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

package/src/karin/module/utils/amagiClient.ts

@@ -1,3 +1,16 @@
+/**
+ * 解析库（`@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 反而是坏的。升级解析库时请一并确认抖音能解析。
+ */
 import Client, {
   type AmagiError as AmagiErrorContract,
   type AmagiFailure,
@@ -135,36 +148,45 @@ const isFailureEnvelope = (value: unknown): value is AmagiFailure => {
 const isThenable = (value: unknown): value is PromiseLike<unknown> =>
   !!value && (typeof value === 'object' || typeof value === 'function') && typeof (value as PromiseLike<unknown>).then === 'function'
 
-/**
- * 递归代理一个 fetcher 对象，把失败信封转成 `throw AmagiError`。返回类型与入参同形 ——
- * 「只保留成功分支」是**类型层**由 {@link ThrowingClient} 声明的，这里只管运行时行为。
- */
-const throwOnFailure = <T extends object>(target: T): T =>
-  new Proxy(target, {
-    get(obj: any, prop: string | symbol) {
-      const value = obj[prop]
-
-      if (typeof value === 'function') {
-        return (...args: unknown[]) => {
-          const returned = value.apply(obj, args)
-          // 同步方法原样放行：包成 async 会把返回值套一层 Promise，破坏语义
-          if (!isThenable(returned)) return returned
-          return returned.then((result: unknown) => {
-            if (isFailureEnvelope(result)) throw new AmagiError(result)
-            return result
-          })
-        }
-      }
-
-      if (value && typeof value === 'object' && !Array.isArray(value)) {
-        return throwOnFailure(value)
+const throwOnFailure = <T extends object>(target: T): T => {
+  /**
+   * **摊平成普通对象，而不是再套一层 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: Record<string | symbol, unknown> = {}
+  for (const key of Reflect.ownKeys(target)) {
+    const value = (target as any)[key]
+
+    if (typeof value === 'function') {
+      const fn = value.bind(target)
+      wrapped[key] = (...args: unknown[]) => {
+        const returned = fn(...args)
+        // 同步方法原样放行：包成 async 会把返回值套一层 Promise，破坏语义
+        if (!isThenable(returned)) return returned
+        return returned.then((result: unknown) => {
+          if (isFailureEnvelope(result)) throw new AmagiError(result)
+          return result
+        })
       }
-
-      return value
+      continue
     }
-  })
 
-/** 解析库基类 */
+    wrapped[key] = value && typeof value === 'object' && !Array.isArray(value)
+      ? throwOnFailure(value)
+      : value
+  }
+  return wrapped as T
+}
 export class AmagiBase {
   /**
    * 原始 v7 客户端。

package/src/karin/platform/douyin/douyin.ts

@@ -130,6 +130,16 @@ export class DouYin extends Base {
           const code = raw.code ?? raw.data?.code
           const message = raw.message ?? raw.msg ?? raw.data?.message ?? raw.data?.msg
           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 ?? ''))) {
+            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 失效、被风控，或者这条链接已经失效 / 作品已删除。')