koishi-plugin-kkk 3.4.0 → 3.4.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 更新日志
 
+## 3.4.1
+
+### 抖音解析失败时的提示看得懂了
+
+- 抖音接口没返回数据时（常见原因：Cookie 过期、被风控，或者链接 / 作品已失效），以前会直接抛一个英文错误
+  TypeError: Cannot read properties of undefined (reading 'aweme_detail')，你收到的是一张满屏英文的错误卡片。
+  现在会明说是哪一类问题：抖音没有返回这条作品的数据（错误码 8：风控校验失败），常见原因：Cookie 失效、被风控，或者这条链接已经失效 / 作品已删除。
+- 日志里会留下接口的原始错误码和返回内容，排查时一眼就能看出是风控还是 Cookie 过期。
+- 顺带：抖音的冒烟测试补了「接口被风控」这个场景，以后不会再退回那种英文报错。
+
+---
+
 ## 3.4.0
 
 > 这一版修的都是「用起来别扭」的地方：图片不再重复发、面板不再和卡片挤在一起、
@@ -19,6 +31,7 @@
 ### 出错的时候：上报照旧，发什么你说了算
 
 - 新增开关「**出错只发文字（不渲染错误卡片）**」（面板 → 通用 → 错误上报，默认关闭）。
+想法来自 @Jingmozhiyu 的 PR #1
   打开后出错只在群里发一行：错误信息已上传，ID：xxx —— 上传的东西一点不少，只是省掉十几秒渲染和一张几 MB 的大图。
 - 以前错误提示里那个加群链接是拿群号拼的，点开是 404；现在换成真正的加群链接，能直接点进去。
 - 以前遇到「一行日志里塞了几 MB 的图片数据」这种报错，错误卡片要渲染十几分钟、最后还发不出去；现在这种超长内容会自动折起来，几秒钟出图。

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

@@ -91,8 +91,24 @@ class DouYin extends utils_1.Base {
                 const VideoData = await this.amagi.douyin.fetcher.parseWork({
                     aweme_id: data.aweme_id
                 });
-                if (VideoData.data.aweme_detail === null) {
-                    throw new Error('获取作品详情失败，可能是因为该作品已被删除或设置为私密。');
+                /**
+                 * **接口没给出作品详情时的兜底**（线上真实报错）：
+                 *
+                 *     TypeError: Cannot read properties of undefined (reading 'aweme_detail')
+                 *         at DouYin.DouyinHandler (douyin.js:94)
+                 *
+                 * 以前只挡了「aweme_detail === null」这一种 —— 而接口被风控 / Cookie 失效 / 链接失效时，
+                 * 返回体里**连 data 都没有**，于是直接 TypeError，用户拿到的是一张满屏英文的错误卡片。
+                 * 现在把整段摊开检查，并给一句人话 + 把原始响应写进日志（排查时才看得到错误码）。
+                 */
+                if (!VideoData || !VideoData.data || VideoData.data.aweme_detail === null || VideoData.data.aweme_detail === undefined) {
+                    const raw = VideoData ?? {};
+                    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));
+                    throw new Error('抖音没有返回这条作品的数据'
+                        + (code !== undefined ? '（错误码 ' + String(code) + (message ? '：' + String(message) : '') + '）' : '')
+                        + '，常见原因：Cookie 失效、被风控，或者这条链接已经失效 / 作品已删除。');
                 }
                 // 根据 API 返回的数据判断作品类型，而不是依赖 URL
                 // aweme_type: 0=视频, 68=图集, 163=文章

package/package.json

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

package/scripts/smoke-douyin.cjs

@@ -40,6 +40,9 @@ const LONG_URL = 'https://www.douyin.com/video/7123456789012345678'
 axios.get = async () => ({ request: { res: { responseUrl: LONG_URL } }, data: '' })
 
 // 2) 替换 amagi 的客户端工厂（每个 Base 实例都会新建 client，必须包住工厂）
+/** 由末尾的第二个场景打开：让 parseWork 返回「风控」响应 */
+let windy = false
+
 const amagi = require('@ikenxuan/amagi')
 const realFactory = amagi.default
 
@@ -94,7 +97,10 @@ function makeDetail () {
 
 amagi.default = function (options) {
   const client = realFactory(options)
-  client.douyin.fetcher.parseWork = async () => ({ success: true, code: 200, message: 'OK', data: { aweme_detail: makeDetail() } })
+  // windy = true 时模拟「接口被风控」：返回体里连 data 都没有（见文件末尾的第二个场景）
+  client.douyin.fetcher.parseWork = async () => (windy
+    ? { success: false, code: 8, message: '风控校验失败' }
+    : { success: true, code: 200, message: 'OK', data: { aweme_detail: makeDetail() } })
   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 () => ({
@@ -134,7 +140,8 @@ 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'], webui: false })
+// parseDedupe: false —— 下面有两个场景会解析同一条链接，去重会把第二个场景挡掉
+ctx.plugin(plugin, { dataPath: dataRoot, debug: true, masters: ['12345'], webui: false, parseDedupe: false })
 
 const makeSession = (content) => ({
   content, selfId: '10000', userId: '12345', guildId: '456', channelId: '456',
@@ -170,6 +177,27 @@ setTimeout(async () => {
         return '[' + type + '] ' + attrs
       }).join(' | ').slice(0, 400))
     }
+    /**
+     * 第二个场景：**接口被风控**（返回体里连 data 都没有）。
+     *
+     * 线上真实报错：以前只挡了 aweme_detail === null，风控时直接
+     * TypeError: Cannot read properties of undefined (reading 'aweme_detail') —— 用户拿到一张满屏英文的错误卡片。
+     * 现在应当给一句人话（并且日志里留下错误码）。
+     */
+    console.log('\n=== 抖音接口被风控时的提示 ===')
+    windy = true
+    const before = sent.length
+    try {
+      await dispatch('https://www.douyin.com/video/7123456789012345678')
+      console.log('  ❌ 期望它抛错（这样才会走错误提示），但它正常跑完了')
+      process.exitCode = 1
+    } catch (error) {
+      const message = String(error?.message ?? error)
+      const friendly = /抖音没有返回这条作品的数据/.test(message) && /风控校验失败/.test(message)
+      console.log((friendly ? '  ✅' : '  ❌') + ' 提示是人话: ' + message.slice(0, 140))
+      if (!friendly) process.exitCode = 1
+      if (sent.length !== before) console.log('  （顺带：还多发了 ' + (sent.length - before) + ' 条消息）')
+    }
   } catch (error) {
     console.error('抖音冒烟测试失败:', error && error.stack ? error.stack : error)
     process.exitCode = 1

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

@@ -115,8 +115,24 @@ export class DouYin extends Base {
           aweme_id: data.aweme_id
         })
 
-        if (VideoData.data.aweme_detail === null) {
-          throw new Error('获取作品详情失败，可能是因为该作品已被删除或设置为私密。')
+        /**
+         * **接口没给出作品详情时的兜底**（线上真实报错）：
+         *
+         *     TypeError: Cannot read properties of undefined (reading 'aweme_detail')
+         *         at DouYin.DouyinHandler (douyin.js:94)
+         *
+         * 以前只挡了「aweme_detail === null」这一种 —— 而接口被风控 / Cookie 失效 / 链接失效时，
+         * 返回体里**连 data 都没有**，于是直接 TypeError，用户拿到的是一张满屏英文的错误卡片。
+         * 现在把整段摊开检查，并给一句人话 + 把原始响应写进日志（排查时才看得到错误码）。
+         */
+        if (!VideoData || !(VideoData as any).data || (VideoData as any).data.aweme_detail === null || (VideoData as any).data.aweme_detail === undefined) {
+          const raw: any = VideoData ?? {}
+          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))
+          throw new Error('抖音没有返回这条作品的数据'
+            + (code !== undefined ? '（错误码 ' + String(code) + (message ? '：' + String(message) : '') + '）' : '')
+            + '，常见原因：Cookie 失效、被风控，或者这条链接已经失效 / 作品已删除。')
         }
         // 根据 API 返回的数据判断作品类型，而不是依赖 URL
         // aweme_type: 0=视频, 68=图集, 163=文章