koishi-plugin-kkk 3.4.0 → 3.4.2

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # 更新日志
 
+## 3.4.2
+
+### 出错上报的内容更全，也更好看懂
+
+- 上报的「来源信息」以前常常是一排「—」：推送任务的会话是合成的，没有群号这些东西。现在改用框架自己的接口补：
+  机器人名、群名（用 bot.getGuild 查出来）、用户名都会显示，卡在哪一步（阶段）也会自动标出来 —— 一眼就知道是谁在哪个群、发的什么。
+- **顺便把配置也传上去了**，复现问题时有依据：你改过的设置、画质、发送内容、推送列表都会带过去。
+  两条硬规矩：**Cookie 一个都不传**（接口库里的 SESSDATA / bili_jct / 抖音那一串整块丢掉），凡是名字像 token / secret / password 的字段一律显示成 ***。
+- **日志只传本插件（kkk）的行**：以前会把整台机器所有插件的日志尾巴都传上去，现在只挑 kkk 相关的，看的人不用再大海捞针。
+
+### 机器人掉线时不再是一句英文报错
+
+- 适配器掉线后，机器人的对象还在，但底层连接已经没了 —— 这时推送会让适配器内部炸出一句
+  TypeError: this._request is not a function，你只看到一堆英文堆栈。
+  现在会提前拦住，并说清楚：机器人 2092582839 当前不在线（status=0），这条消息发不出去；等它重新上线后下次推送会正常发出。
+- 指定的机器人掉线时**不会偷偷换成另一个机器人发**（那样会串号），只会如实报出来。
+
+---
+
+## 3.4.1
+
+### 抖音解析失败时的提示看得懂了
+
+- 抖音接口没返回数据时（常见原因：Cookie 过期、被风控，或者链接 / 作品已失效），以前会直接抛一个英文错误
+  TypeError: Cannot read properties of undefined (reading 'aweme_detail')，你收到的是一张满屏英文的错误卡片。
+  现在会明说是哪一类问题：抖音没有返回这条作品的数据（错误码 8：风控校验失败），常见原因：Cookie 失效、被风控，或者这条链接已经失效 / 作品已删除。
+- 日志里会留下接口的原始错误码和返回内容，排查时一眼就能看出是风控还是 Cookie 过期。
+- 顺带：抖音的冒烟测试补了「接口被风控」这个场景，以后不会再退回那种英文报错。
+
+---
+
 ## 3.4.0
 
 > 这一版修的都是「用起来别扭」的地方：图片不再重复发、面板不再和卡片挤在一起、
@@ -19,6 +50,7 @@
 ### 出错的时候：上报照旧，发什么你说了算
 
 - 新增开关「**出错只发文字（不渲染错误卡片）**」（面板 → 通用 → 错误上报，默认关闭）。
+想法来自 @Jingmozhiyu 的 PR #1
   打开后出错只在群里发一行：错误信息已上传，ID：xxx —— 上传的东西一点不少，只是省掉十几秒渲染和一张几 MB 的大图。
 - 以前错误提示里那个加群链接是拿群号拼的，点开是 404；现在换成真正的加群链接，能直接点进去。
 - 以前遇到「一行日志里塞了几 MB 的图片数据」这种报错，错误卡片要渲染十几分钟、最后还发不出去；现在这种超长内容会自动折起来，几秒钟出图。

package/lib/compat/node-karin.js

@@ -644,6 +644,29 @@ const contactGroup = (groupId) => ({ peer: groupId, guildId: groupId, isGroup: t
 exports.contactGroup = contactGroup;
 const contactFriend = (userId) => ({ peer: 'private:' + userId, userId, isGroup: false });
 exports.contactFriend = contactFriend;
+/**
+ * 这个机器人现在能不能发消息。
+ *
+ * 线上真实报错（B站推送）：
+ *
+ *     TypeError: this._request is not a function
+ *         at _Internal._get (adapter-onebot/lib/index.js:115)
+ *         at ... sendGroupMsg ...
+ *         at async Object.sendMsg (koishi-plugin-kkk/lib/compat/node-karin.js:684)
+ *
+ * 适配器**掉线后 bot 对象仍然留在 ctx.bots 里**，但底层连接（OneBot 的 _request）已经没了，
+ * 于是 sendMessage 一路传到适配器内部才炸成一句莫名其妙的英文。
+ * 这里提前认出来，给一句人话（用户要求：日志和错误卡片要能看懂）。
+ *
+ * Koishi 的 Bot.status：0 离线 / 1 在线 / 2 连接中 / 3 断开 / 4 重连。
+ */
+function isBotOnline(bot) {
+    const status = bot?.status;
+    // 没有 status 字段的（老适配器 / 测试桩）不拦，免得把好机器人也挡住
+    if (typeof status !== 'number')
+        return true;
+    return status === 1 || status === 2;
+}
 function resolveBot(selfId) {
     const runtime = (0, runtime_1.tryGetRuntime)();
     if (!runtime)
@@ -652,7 +675,12 @@ function resolveBot(selfId) {
     if (!bots?.length)
         return undefined;
     const matched = selfId ? bots.find((bot) => bot.selfId === selfId || bot.user?.id === selfId) : undefined;
-    return new KkkBot(matched ?? bots[0]);
+    // 指定了 selfId：就算它掉线也返回它 —— 不能偷偷换一个机器人发，那样会串号（调用方会报「不在线」）
+    if (matched)
+        return new KkkBot(matched);
+    // 没指定：优先挑在线的
+    const online = bots.find((bot) => isBotOnline(bot));
+    return online ? new KkkBot(online) : (bots[0] ? new KkkBot(bots[0]) : undefined);
 }
 function command(reg, handler, options) {
     const registration = { reg, handler, options, order: commandOrder++ };
@@ -676,6 +704,11 @@ async function sendMsg(selfId, contact, content, _options) {
     const bot = resolveBot(selfId);
     if (!bot)
         throw new Error('[kkk] 没有可用的机器人实例，无法发送消息');
+    const rawBot = bot.bot;
+    if (!isBotOnline(rawBot)) {
+        throw new Error('[kkk] 机器人 ' + String(selfId || rawBot?.selfId || '') + ' 当前不在线（status=' + String(rawBot?.status)
+            + '），这条消息发不出去。等它重新上线后下次推送会正常发出；如果是长期不在线，检查一下适配器连接');
+    }
     const channelId = peerOf(contact);
     /** 解析结果合并转发：这条也走漏斗（karin.sendMsg 是业务代码另一条常用出口） */
     if ((0, forward_collect_1.collectForward)(channelId, normalizeContent(content))) {

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

@@ -24,6 +24,7 @@ const fold_1 = require("../../../compat/fold");
 const runtime_1 = require("../../../compat/runtime");
 const qqOptions_1 = require("../../../qqOptions");
 const root_1 = require("../../root");
+const Config_1 = require("./Config");
 const build_metadata_1 = require("./build-metadata");
 /**
  * 收集站地址：**写死，不开放配置**。
@@ -186,6 +187,108 @@ const makeReportId = () => {
     const stamp = now.getFullYear() + pad(now.getMonth() + 1) + pad(now.getDate()) + '-' + pad(now.getHours()) + pad(now.getMinutes()) + pad(now.getSeconds());
     return stamp + '-' + Math.random().toString(36).slice(2, 8);
 };
+/**
+ * **用框架原生 API 补齐来源信息**（用户要求：上报里「来源信息」不能是一片「—」）。
+ *
+ * 以前只读 event 上的几个字段 —— 推送任务（B站推送 / 抖音推送）的 event 是**合成**的，
+ * 根本没有 channelId / guildId，于是详情页里群号、频道全是空的。
+ * 现在：
+ *   - 先从 event 上取（消息场景最准）；
+ *   - 取不到就退回 bot 的原生字段（platform / selfId / user.name）；
+ *   - 群名 / 用户名尽量用 bot.getGuild() 这类**原生接口**查出来（查不到就算了，绝不让上报卡住）。
+ */
+const collectSource = async (input, adapterInfo) => {
+    const event = input.event ?? {};
+    const bot = event?.bot?.bot ?? event?.bot;
+    const channelId = String(event?.channelId ?? event?.contact?.peer ?? event?.guildId ?? '');
+    const guildId = String(event?.guildId ?? event?.contact?.guildId ?? channelId);
+    const userId = String(event?.userId ?? event?.sender?.userId ?? event?.author?.userId ?? '');
+    const source = {
+        platform: String(bot?.platform ?? event?.platform ?? adapterInfo?.platform ?? ''),
+        route: String(input.route ?? ''),
+        stage: String(input.stage ?? ''),
+        business: String(input.business ?? ''),
+        guildId,
+        channelId,
+        userId,
+        selfId: String(event?.selfId ?? bot?.selfId ?? bot?.account?.selfId ?? ''),
+        // 机器人名 / 用户名：能取到就填，详情页里比一串数字好认
+        botName: String(bot?.user?.name ?? bot?.username ?? bot?.account?.name ?? ''),
+        userName: String(event?.sender?.nick ?? event?.author?.nick ?? event?.username ?? event?.sender?.name ?? ''),
+        guildName: '',
+        command: (0, fold_1.foldAndTruncate)(String(event?.msg ?? event?.content ?? ''), 300)
+    };
+    // 群名（框架原生接口；取不到就留空，不抛错）
+    if (!source.guildName && channelId && typeof bot?.getGuild === 'function') {
+        try {
+            const guild = await bot.getGuild(channelId);
+            source.guildName = String(guild?.name ?? guild?.guildName ?? '');
+        }
+        catch { /* 频道查不到就算了 */ }
+    }
+    /**
+     * 阶段（stage）：解析链路里抛的错会带一句「步骤「渲染评论区」失败」，
+     * 直接抽出来当阶段，详情页上就能看出是卡在哪一步（route 同理，有就带）。
+     */
+    if (!source.stage) {
+        const message = String(input.error?.message ?? '');
+        const step = /步骤「([^」]+)」/.exec(message) ?? /步骤失败[（(]([^）)]+)[）)]/.exec(message);
+        if (step)
+            source.stage = step[1];
+    }
+    return source;
+};
+/** 上游配置的几段（与 config.json 的顶层键一致）；Config 是只有 get 的 Proxy，只能按名字取 */
+const UPSTREAM_SECTIONS = ['amagi', 'app', 'douyin', 'bilibili', 'kuaishou', 'xiaohongshu', 'pushlist'];
+/** 这些键一律不上传（cookie / 密钥 / 密码之类） */
+const SECRET_KEY = /cookie|token|secret|password|passwd|sessdata|bili_jct|csrf|authorization|apikey|api_key/i;
+/**
+ * **上报用的配置快照**：把「改过什么」也带上去，复现问题才有依据。
+ *
+ * 两条硬规矩：
+ *   1. **cookie 一个都不传**（SESSDATA / bili_jct / 抖音那一长串都在 amagi.cookies 里，整块丢掉）；
+ *   2. 其余凡是键名像密钥/密码的（token / secret / password / apiKey…）也一律换成 '***'。
+ */
+const snapshotConfig = (upstream, qq) => {
+    const clean = (value, depth) => {
+        if (depth > 6 || value === null || value === undefined)
+            return value;
+        if (Array.isArray(value))
+            return value.slice(0, 200).map((item) => clean(item, depth + 1));
+        if (typeof value !== 'object')
+            return typeof value === 'string' ? (0, fold_1.foldAndTruncate)(value, 500) : value;
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (SECRET_KEY.test(key)) {
+                out[key] = '***';
+                continue;
+            }
+            out[key] = clean(item, depth + 1);
+        }
+        return out;
+    };
+    const upstreamClean = clean(upstream ?? {}, 0);
+    // cookie 整块不要：键名可能不叫 cookie（amagi.cookies.bilibili 才是），所以直接在源头删掉
+    if (upstreamClean?.amagi && typeof upstreamClean.amagi === 'object')
+        delete upstreamClean.amagi.cookies;
+    return { qq: clean(qq, 0), upstream: upstreamClean };
+};
+/** 日志只留本项目（kkk）的行：日志文件是 JSON 行，控制台那份是人读的文本行，两种都要认 */
+const isOwnLogLine = (line) => {
+    const text = String(line ?? '').trim();
+    if (!text)
+        return false;
+    if (text.startsWith('{')) {
+        try {
+            const record = JSON.parse(text);
+            const name = String(record?.name ?? '');
+            // 本插件的日志 name 是 kkk；带 paths 的是它的作用域
+            return name === 'kkk' || name === root_1.Root.pluginName || (Array.isArray(record?.meta?.paths) && record.meta.paths.includes('uclubw'));
+        }
+        catch { /* 不是完整 JSON，按文本处理 */ }
+    }
+    return /\bkkk\b/.test(text);
+};
 /**
  * 上传一份错误报告。
  *
@@ -203,22 +306,41 @@ const uploadErrorReport = async (input) => {
     const id = makeReportId();
     const lines = (input.logs ?? []).slice(-Math.max(config.logLines, 0))
         .map((line) => (0, fold_1.foldAndTruncate)(line, LOG_LINE_LIMIT));
-    const envLogs = readLogFileTail(Math.min(config.logLines, 300));
+    const envLogsRaw = readLogFileTail(Math.min(config.logLines, 300));
+    /** 宿主日志文件里**只留本项目（kkk）的行**（用户要求：别把整台机器所有插件的日志都传上去） */
+    const envLogs = { ...envLogsRaw, lines: envLogsRaw.lines.filter((line) => isOwnLogLine(line)) };
+    const source = await collectSource(input, adapterInfo);
+    const runtimeConfig = ((0, runtime_1.tryGetRuntime)()?.config ?? {});
+    const configSnapshot = (() => {
+        try {
+            /**
+             * 上游那份（接口库 / 各平台 / 推送列表）以 **Config** 为准：它是 config.json 的读取代理，
+             * 也是实际生效的那份；运行时 config 上的 `upstream` 只在控制台保存过才会有。
+             *
+             * 注意 Config 是个**只有 get 的 Proxy**（没有 ownKeys），直接 Object.entries 会得到空对象 ——
+             * 所以按已知的几段逐个取值再拼。
+             */
+            const upstream = {};
+            for (const section of UPSTREAM_SECTIONS) {
+                try {
+                    const value = Config_1.Config[section];
+                    if (value !== undefined)
+                        upstream[section] = value;
+                }
+                catch { /* 某一段读不到就跳过 */ }
+            }
+            return snapshotConfig(upstream, (0, qqOptions_1.readQqOptions)(runtimeConfig));
+        }
+        catch (error) {
+            node_karin_1.logger.debug('[错误上报] 配置快照生成失败（忽略）: ' + String(error?.message ?? error));
+            return undefined;
+        }
+    })();
     const payload = {
         id,
         time: Date.now(),
         plugin: { name: root_1.Root.pluginName, version: root_1.Root.pluginVersion },
-        source: {
-            platform: String(input.event?.bot?.platform ?? input.event?.platform ?? adapterInfo?.platform ?? ''),
-            route: String(input.route ?? ''),
-            stage: String(input.stage ?? ''),
-            business: String(input.business ?? ''),
-            guildId: String(input.event?.guildId ?? ''),
-            channelId: String(input.event?.channelId ?? ''),
-            userId: String(input.event?.userId ?? ''),
-            selfId: String(input.event?.selfId ?? ''),
-            command: (0, fold_1.foldAndTruncate)(String(input.event?.msg ?? input.event?.content ?? ''), 300)
-        },
+        source,
         error: {
             name: String(error?.name ?? 'Error'),
             message: (0, fold_1.foldAndTruncate)(error?.message ?? String(error), fold_1.MAX_CAPTURED_LOG_CHARS),
@@ -247,16 +369,27 @@ const uploadErrorReport = async (input) => {
             // 宿主日志文件的尾部：整台机器最近的动静
             envFile: envLogs.file ?? '',
             envLines: envLogs.lines,
-            envTruncated: envLogs.truncated
+            envTruncated: envLogs.truncated,
+            // 只留本项目日志这件事要说清楚，免得看的人以为日志被截断了
+            envFiltered: 'kkk-only'
         },
+        /** 配置快照：cookie 与密钥已剔除（见 snapshotConfig） */
+        config: configSnapshot,
         extra: input.extra ?? {}
     };
-    // 体积兜底：还是太大就继续砍日志（先把宿主日志去掉，再砍本次日志）
+    /**
+     * 体积兜底：太大就一层层砍（先去掉整份配置快照，再去掉宿主日志，最后砍本次日志）。
+     * 配置快照最占地方（几百个字段），但它对复现最有帮助，所以放在最后才丢。
+     */
     let body = Buffer.from(JSON.stringify(payload));
-    if (body.length > PAYLOAD_LIMIT_BYTES) {
+    if (body.length > PAYLOAD_LIMIT_BYTES && payload.logs) {
         payload.logs.envLines = [];
         body = Buffer.from(JSON.stringify(payload));
     }
+    if (body.length > PAYLOAD_LIMIT_BYTES) {
+        payload.config = { dropped: '配置快照过大，已省略' };
+        body = Buffer.from(JSON.stringify(payload));
+    }
     if (body.length > PAYLOAD_LIMIT_BYTES) {
         payload.logs.lines = payload.logs.lines.slice(-50);
         payload.logs.count = payload.logs.lines.length;

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.2",
   "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/compat/node-karin.ts

@@ -656,13 +656,40 @@ let commandOrder = 0
 export const contactGroup = (groupId: string): Contact => ({ peer: groupId, guildId: groupId, isGroup: true })
 export const contactFriend = (userId: string): Contact => ({ peer: 'private:' + userId, userId, isGroup: false })
 
+/**
+ * 这个机器人现在能不能发消息。
+ *
+ * 线上真实报错（B站推送）：
+ *
+ *     TypeError: this._request is not a function
+ *         at _Internal._get (adapter-onebot/lib/index.js:115)
+ *         at ... sendGroupMsg ...
+ *         at async Object.sendMsg (koishi-plugin-kkk/lib/compat/node-karin.js:684)
+ *
+ * 适配器**掉线后 bot 对象仍然留在 ctx.bots 里**，但底层连接（OneBot 的 _request）已经没了，
+ * 于是 sendMessage 一路传到适配器内部才炸成一句莫名其妙的英文。
+ * 这里提前认出来，给一句人话（用户要求：日志和错误卡片要能看懂）。
+ *
+ * Koishi 的 Bot.status：0 离线 / 1 在线 / 2 连接中 / 3 断开 / 4 重连。
+ */
+function isBotOnline (bot: any): boolean {
+  const status = bot?.status
+  // 没有 status 字段的（老适配器 / 测试桩）不拦，免得把好机器人也挡住
+  if (typeof status !== 'number') return true
+  return status === 1 || status === 2
+}
+
 function resolveBot (selfId?: string): KkkBot | undefined {
   const runtime = tryGetRuntime()
   if (!runtime) return undefined
   const bots = runtime.ctx.bots as unknown as Bot[]
   if (!bots?.length) return undefined
   const matched = selfId ? bots.find((bot) => bot.selfId === selfId || bot.user?.id === selfId) : undefined
-  return new KkkBot(matched ?? bots[0])
+  // 指定了 selfId：就算它掉线也返回它 —— 不能偷偷换一个机器人发，那样会串号（调用方会报「不在线」）
+  if (matched) return new KkkBot(matched)
+  // 没指定：优先挑在线的
+  const online = bots.find((bot) => isBotOnline(bot))
+  return online ? new KkkBot(online) : (bots[0] ? new KkkBot(bots[0]) : undefined)
 }
 
 function command (reg: RegExp | string, handler: (...args: any[]) => any, options?: Record<string, any>) {
@@ -688,6 +715,11 @@ function on (event: string, handler: (...args: any[]) => any) {
 async function sendMsg (selfId: string, contact: Contact | string, content: any, _options?: any) {
   const bot = resolveBot(selfId)
   if (!bot) throw new Error('[kkk] 没有可用的机器人实例，无法发送消息')
+  const rawBot: any = (bot as any).bot
+  if (!isBotOnline(rawBot)) {
+    throw new Error('[kkk] 机器人 ' + String(selfId || rawBot?.selfId || '') + ' 当前不在线（status=' + String(rawBot?.status)
+      + '），这条消息发不出去。等它重新上线后下次推送会正常发出；如果是长期不在线，检查一下适配器连接')
+  }
   const channelId = peerOf(contact)
   /** 解析结果合并转发：这条也走漏斗（karin.sendMsg 是业务代码另一条常用出口） */
   if (collectForward(channelId, normalizeContent(content))) {

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

@@ -19,6 +19,7 @@ import { MAX_CAPTURED_LOG_CHARS, foldAndTruncate } from '../../../compat/fold'
 import { tryGetRuntime } from '../../../compat/runtime'
 import { readQqOptions } from '../../../qqOptions'
 import { Root } from '../../root'
+import { Config } from './Config'
 import { getBuildMetadata } from './build-metadata'
 
 /**
@@ -192,6 +193,101 @@ const makeReportId = (): string => {
   return stamp + '-' + Math.random().toString(36).slice(2, 8)
 }
 
+/**
+ * **用框架原生 API 补齐来源信息**（用户要求：上报里「来源信息」不能是一片「—」）。
+ *
+ * 以前只读 event 上的几个字段 —— 推送任务（B站推送 / 抖音推送）的 event 是**合成**的，
+ * 根本没有 channelId / guildId，于是详情页里群号、频道全是空的。
+ * 现在：
+ *   - 先从 event 上取（消息场景最准）；
+ *   - 取不到就退回 bot 的原生字段（platform / selfId / user.name）；
+ *   - 群名 / 用户名尽量用 bot.getGuild() 这类**原生接口**查出来（查不到就算了，绝不让上报卡住）。
+ */
+const collectSource = async (input: UploadErrorReportInput, adapterInfo: any): Promise<Record<string, any>> => {
+  const event: any = input.event ?? {}
+  const bot: any = event?.bot?.bot ?? event?.bot
+  const channelId = String(event?.channelId ?? event?.contact?.peer ?? event?.guildId ?? '')
+  const guildId = String(event?.guildId ?? event?.contact?.guildId ?? channelId)
+  const userId = String(event?.userId ?? event?.sender?.userId ?? event?.author?.userId ?? '')
+  const source: Record<string, any> = {
+    platform: String(bot?.platform ?? event?.platform ?? adapterInfo?.platform ?? ''),
+    route: String(input.route ?? ''),
+    stage: String(input.stage ?? ''),
+    business: String(input.business ?? ''),
+    guildId,
+    channelId,
+    userId,
+    selfId: String(event?.selfId ?? bot?.selfId ?? bot?.account?.selfId ?? ''),
+    // 机器人名 / 用户名：能取到就填，详情页里比一串数字好认
+    botName: String(bot?.user?.name ?? bot?.username ?? bot?.account?.name ?? ''),
+    userName: String(event?.sender?.nick ?? event?.author?.nick ?? event?.username ?? event?.sender?.name ?? ''),
+    guildName: '',
+    command: foldAndTruncate(String(event?.msg ?? event?.content ?? ''), 300)
+  }
+  // 群名（框架原生接口；取不到就留空，不抛错）
+  if (!source.guildName && channelId && typeof bot?.getGuild === 'function') {
+    try {
+      const guild: any = await bot.getGuild(channelId)
+      source.guildName = String(guild?.name ?? guild?.guildName ?? '')
+    } catch { /* 频道查不到就算了 */ }
+  }
+  /**
+   * 阶段（stage）：解析链路里抛的错会带一句「步骤「渲染评论区」失败」，
+   * 直接抽出来当阶段，详情页上就能看出是卡在哪一步（route 同理，有就带）。
+   */
+  if (!source.stage) {
+    const message = String((input.error as any)?.message ?? '')
+    const step = /步骤「([^」]+)」/.exec(message) ?? /步骤失败[（(]([^）)]+)[）)]/.exec(message)
+    if (step) source.stage = step[1]
+  }
+  return source
+}
+
+/** 上游配置的几段（与 config.json 的顶层键一致）；Config 是只有 get 的 Proxy，只能按名字取 */
+const UPSTREAM_SECTIONS = ['amagi', 'app', 'douyin', 'bilibili', 'kuaishou', 'xiaohongshu', 'pushlist']
+
+/** 这些键一律不上传（cookie / 密钥 / 密码之类） */
+const SECRET_KEY = /cookie|token|secret|password|passwd|sessdata|bili_jct|csrf|authorization|apikey|api_key/i
+
+/**
+ * **上报用的配置快照**：把「改过什么」也带上去，复现问题才有依据。
+ *
+ * 两条硬规矩：
+ *   1. **cookie 一个都不传**（SESSDATA / bili_jct / 抖音那一长串都在 amagi.cookies 里，整块丢掉）；
+ *   2. 其余凡是键名像密钥/密码的（token / secret / password / apiKey…）也一律换成 '***'。
+ */
+const snapshotConfig = (upstream: any, qq: Record<string, any>): Record<string, any> => {
+  const clean = (value: any, depth: number): any => {
+    if (depth > 6 || value === null || value === undefined) return value
+    if (Array.isArray(value)) return value.slice(0, 200).map((item) => clean(item, depth + 1))
+    if (typeof value !== 'object') return typeof value === 'string' ? foldAndTruncate(value, 500) : value
+    const out: Record<string, any> = {}
+    for (const [key, item] of Object.entries(value)) {
+      if (SECRET_KEY.test(key)) { out[key] = '***'; continue }
+      out[key] = clean(item, depth + 1)
+    }
+    return out
+  }
+  const upstreamClean = clean(upstream ?? {}, 0) as Record<string, any>
+  // cookie 整块不要：键名可能不叫 cookie（amagi.cookies.bilibili 才是），所以直接在源头删掉
+  if (upstreamClean?.amagi && typeof upstreamClean.amagi === 'object') delete upstreamClean.amagi.cookies
+  return { qq: clean(qq, 0), upstream: upstreamClean }
+}
+
+/** 日志只留本项目（kkk）的行：日志文件是 JSON 行，控制台那份是人读的文本行，两种都要认 */
+const isOwnLogLine = (line: string): boolean => {
+  const text = String(line ?? '').trim()
+  if (!text) return false
+  if (text.startsWith('{')) {
+    try {
+      const record = JSON.parse(text)
+      const name = String(record?.name ?? '')
+      // 本插件的日志 name 是 kkk；带 paths 的是它的作用域
+      return name === 'kkk' || name === Root.pluginName || (Array.isArray(record?.meta?.paths) && record.meta.paths.includes('uclubw'))
+    } catch { /* 不是完整 JSON，按文本处理 */ }
+  }
+  return /\bkkk\b/.test(text)
+}
 export interface UploadErrorReportInput {
   error: Error
   /** 业务名（解析 / 推送…） */
@@ -226,23 +322,39 @@ export const uploadErrorReport = async (input: UploadErrorReportInput): Promise<
   const id = makeReportId()
   const lines = (input.logs ?? []).slice(-Math.max(config.logLines, 0))
     .map((line) => foldAndTruncate(line, LOG_LINE_LIMIT))
-  const envLogs = readLogFileTail(Math.min(config.logLines, 300))
+  const envLogsRaw = readLogFileTail(Math.min(config.logLines, 300))
+  /** 宿主日志文件里**只留本项目（kkk）的行**（用户要求：别把整台机器所有插件的日志都传上去） */
+  const envLogs = { ...envLogsRaw, lines: envLogsRaw.lines.filter((line) => isOwnLogLine(line)) }
+  const source = await collectSource(input, adapterInfo)
+  const runtimeConfig: any = (tryGetRuntime()?.config ?? {}) as any
+  const configSnapshot = (() => {
+    try {
+      /**
+       * 上游那份（接口库 / 各平台 / 推送列表）以 **Config** 为准：它是 config.json 的读取代理，
+       * 也是实际生效的那份；运行时 config 上的 `upstream` 只在控制台保存过才会有。
+       *
+       * 注意 Config 是个**只有 get 的 Proxy**（没有 ownKeys），直接 Object.entries 会得到空对象 ——
+       * 所以按已知的几段逐个取值再拼。
+       */
+      const upstream: Record<string, any> = {}
+      for (const section of UPSTREAM_SECTIONS) {
+        try {
+          const value = (Config as any)[section]
+          if (value !== undefined) upstream[section] = value
+        } catch { /* 某一段读不到就跳过 */ }
+      }
+      return snapshotConfig(upstream, readQqOptions(runtimeConfig))
+    } catch (error: any) {
+      logger.debug('[错误上报] 配置快照生成失败（忽略）: ' + String(error?.message ?? error))
+      return undefined
+    }
+  })()
 
   const payload: Record<string, any> = {
     id,
     time: Date.now(),
     plugin: { name: Root.pluginName, version: Root.pluginVersion },
-    source: {
-      platform: String(input.event?.bot?.platform ?? input.event?.platform ?? adapterInfo?.platform ?? ''),
-      route: String(input.route ?? ''),
-      stage: String(input.stage ?? ''),
-      business: String(input.business ?? ''),
-      guildId: String(input.event?.guildId ?? ''),
-      channelId: String(input.event?.channelId ?? ''),
-      userId: String(input.event?.userId ?? ''),
-      selfId: String(input.event?.selfId ?? ''),
-      command: foldAndTruncate(String(input.event?.msg ?? input.event?.content ?? ''), 300)
-    },
+    source,
     error: {
       name: String(error?.name ?? 'Error'),
       message: foldAndTruncate(error?.message ?? String(error), MAX_CAPTURED_LOG_CHARS),
@@ -271,17 +383,28 @@ export const uploadErrorReport = async (input: UploadErrorReportInput): Promise<
       // 宿主日志文件的尾部：整台机器最近的动静
       envFile: envLogs.file ?? '',
       envLines: envLogs.lines,
-      envTruncated: envLogs.truncated
+      envTruncated: envLogs.truncated,
+      // 只留本项目日志这件事要说清楚，免得看的人以为日志被截断了
+      envFiltered: 'kkk-only'
     },
+    /** 配置快照：cookie 与密钥已剔除（见 snapshotConfig） */
+    config: configSnapshot,
     extra: input.extra ?? {}
   }
 
-  // 体积兜底：还是太大就继续砍日志（先把宿主日志去掉，再砍本次日志）
+  /**
+   * 体积兜底：太大就一层层砍（先去掉整份配置快照，再去掉宿主日志，最后砍本次日志）。
+   * 配置快照最占地方（几百个字段），但它对复现最有帮助，所以放在最后才丢。
+   */
   let body = Buffer.from(JSON.stringify(payload))
-  if (body.length > PAYLOAD_LIMIT_BYTES) {
+  if (body.length > PAYLOAD_LIMIT_BYTES && payload.logs) {
     payload.logs.envLines = []
     body = Buffer.from(JSON.stringify(payload))
   }
+  if (body.length > PAYLOAD_LIMIT_BYTES) {
+    payload.config = { dropped: '配置快照过大，已省略' }
+    body = Buffer.from(JSON.stringify(payload))
+  }
   if (body.length > PAYLOAD_LIMIT_BYTES) {
     payload.logs.lines = payload.logs.lines.slice(-50)
     payload.logs.count = payload.logs.lines.length

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=文章