koishi-plugin-kkk 3.12.0 → 3.13.0

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # 更新日志
 
+## 3.13.0
+
+这一版把上游最近一批改动搬了过来，另外修了几处只有真用起来才会碰到的显示问题。
+
+### 修：实况照片提示卡整张崩了
+
+那张卡（「这是一张实况照片」的提示）在群里显示成一坨：文字挤在一起、间距全没、
+一排品牌图标只剩零星两三个。
+
+原因是卡片的样式是**跟着模板按需生成**的，模板更新后新用到的样式没跟着补上。
+这类问题最坑的地方是**页面不报错**，只是悄悄少样式 —— 光看日志什么都看不出来。
+
+现在补了一套「和上游样式逐条对齐」的机制，并加了守卫脚本，
+以后模板再更新不会再漏。顺带修好了 B站评论卡的字体，以及群统计卡缺掉的一段间距。
+
+### 修：抖音会重复推一遍历史作品
+
+喜欢 / 推荐列表的去重记录以前是「固定有效期」：一条作品记下之后，时间一到就作废，
+哪怕它还在你列表里，也会被当成新作品再推一次。
+
+现在改成**跟着列表走**：每轮推送都把当前列表里所有作品的有效期一起往后延，
+只有**真正离开列表**的作品才会被清掉。清理的时机也跟着挪了 ——
+这两件事必须同时生效，否则升级的那一刻老记录会先被清掉，反而多推一轮。
+
+### 新：评论卡片的二维码中间带上作者头像
+
+B站 / 快手 / 小红书三张评论卡片，右下角那个二维码以前是纯黑白码，
+现在把作者头像嵌在正中间（和抖音那张卡的样子统一），深色模式也一起处理了。
+
+### 修：B站卡片的简介（这次修的是 QQ 面板那张）
+
+上一版修的是「解析出来那张卡」。但 QQ 上开着解析面板的时候，
+**解析卡其实是不发的** —— 群里那一张是面板自己画的，它的简介从出生起就是空的，
+所以修完看起来毫无变化。现在两张卡走同一份简介逻辑，单行、多行、带 @ 和链接的都正常。
+
+### 其它
+
+- **修**：小红书评论里「回复的图片」以前按一串网址处理，接口其实给的是带宽高的对象，
+  现在按真实结构解析；
+- **修**：抖音推送图里「谁在喜欢 / 谁推荐」那行取不到人，会退回显示作品作者，现在正常了；
+- **改**：一批卡片标题和数字的字重从最粗降到次粗（B站、抖音、小红书、单张统计卡都覆盖了），
+  小尺寸下不再糊成一团。
+
+## 3.12.1
+
+### 修：B站卡片的简介没了
+
+有一批 B 站视频解析出来的卡片，标题下面直接跳到播放数据，**视频简介整块不见了**。
+不是渲染糊了，是压根没画上去。
+
+原因是 B 站接口有时会把简介放在「分段简介」里、有时只放在普通简介字段里，
+之前的代码碰上第一种情况以外的数据会算出一份空简介，然后把「空的」当成「有内容」画出来，
+结果整块简介反而被吃掉了。
+
+现在两个字段都试，哪个真的有内容就用哪个 —— 单行简介、多行简介、带 @ 和链接的简介
+都能正常显示出来。
+
+顺手还修了一处：接口返回的简介字段是空的时候不会再让解析报错。
+
 ## 3.12.0
 
 ### 新：提取图片的按钮只能点一次

package/docs/upstream-audit-2026-10.md

@@ -0,0 +1,257 @@
+# 上游 karin-plugin-kkk 变更对照审查
+
+对照对象：`ikenxuan/karin-plugin-kkk` 的 8 个 commit（2026-09-16 ~ 2026-09-22）
+对照基准：本地 `E:/devkoishi/plugins/koishi-plugin-kkk`（v3.12.1）
+审查方式：GitHub API 逐个取 commit 的文件清单与 patch，再在本地源码里逐条核对
+
+> 说明：上游是 `packages/core` monorepo，本地是 Koishi 单包移植版，
+> 路径前缀 `packages/core/` 对应本地根目录，`packages/core/ktr/` 对应本地 `src/ktr/`，
+> `packages/core/src/` 对应本地 `src/karin/`。
+
+---
+
+## 结论速览
+
+| # | commit | 标题 | 本地状态 |
+|---|--------|------|----------|
+| 1 | `ff54ba5` | 优化作品缓存管理，新增续期去重记录功能并调整清理逻辑 | ❌ **未移植**（改动最大，含一个真实 bug 修复） |
+| 2 | `677e213` | 评论/笔记二维码统一补作者头像并修复深色模式 | ❌ **未移植**（B站/快手/小红书三张评论卡） |
+| 3 | `0659c2b` | fix: xhs comments | ❌ **未移植**（子评论 pictures 类型 + amagi 类型名） |
+| 4 | `2fa299a` | ui: 优化部分字体粗细 | ❌ **未移植**（`font-black` → `font-bold`） |
+| 5 | `f4b5312` | fix(dy): 修复推送图片获取用户信息的逻辑 | ⚠️ **部分**（拉取路径已是新写法，但缺一层兜底） |
+| 6 | `ee22474` | ui: 重写 live phtot tip | ➖ **不适用**（本地这张卡是自研的，跟上游结构不同） |
+| 7 | `049eb2f` | deps: update amagi | ➖ **不适用**（本地已用更新的 `7.0.0-beta.5`） |
+| 8 | `85088c7` | fix: alias | ➖ **不适用**（上游 monorepo 的 vite alias / workspace 配置） |
+
+**有实际价值的是 1~4 号，其中 1 号除了功能还修了一个会「重推历史作品」的 bug。**
+
+---
+
+## 1. `ff54ba5` 缓存续期去重 —— ❌ 未移植（最值得搬）
+
+### 上游改了什么
+
+把抖音喜欢/推荐列表的去重记录从「**固定 TTL**」改成「**滑动 TTL**」：
+
+- 新增 `DouyinDBBase.touchAwemeCache(sec_uid, pushType, aweme_ids)`：
+  每轮推送把「当前列表里全部作品的 `updatedAt`」刷新到当前时间；
+- `cleanOldAwemeCache` 的判据从 `createdAt < cutoff` 改成 **`updatedAt < cutoff`**；
+- `favorite.ts` / `recommend.ts` 里原来调的 `updateListSnapshot` 换成 `touchAwemeCache`；
+- **`push.ts` 里清理的时机从「拉列表之前」挪到「拉列表之后」**。
+
+### 为什么时机也要挪（上游注释写得很清楚）
+
+> 若放在续期之前，升级后旧记录的 `updatedAt` 偏早，会在续期前被按 `updatedAt` 清理掉，
+> 导致仍在列表中的历史作品被当作新作品重推一次。
+
+也就是说：**单独改判据而不挪时机，升级的那一刻会把老记录全清掉 → 全量重推一次。**
+这两件事必须一起改。
+
+### 本地现状
+
+- `src/karin/module/db/douyin.ts:694` `cleanOldAwemeCache` 仍按 **`createdAt`** 清理；
+- 本地有 `updateListSnapshot`（写 `TABLE.douyinListSnapshot`，**另一张表**），
+  上游已把它换成 `touchAwemeCache`；
+- 本地 `src/karin/platform/douyin/push.ts:85` 清理**仍在** `getDynamicList` 之前；
+- `favorite.ts:90` / `recommend.ts:89` 仍调 `updateListSnapshot`。
+
+### 移植要点（本地）
+
+1. `douyin.ts` 加 `touchAwemeCache`；本地是 Koishi 原生 db，写法要用 `this.db.update(...)` 而非原生 SQL 的 `IN (...)`；
+2. `cleanOldAwemeCache` 判据 `createdAt` → `updatedAt`；
+3. `favorite.ts` / `recommend.ts` 的 `updateListSnapshot` → `touchAwemeCache`；
+4. `push.ts` 把清理块挪到 `const data = await this.getDynamicList(...)` **之后**；
+5. `updateListSnapshot` 是否保留需确认（本地 `douyinListSnapshot` 表还有没有别的读取方）。
+
+⚠️ 迁移期风险：老记录 `createdAt` 早、`updatedAt` 也早，第一次跑如果先清理后续期，
+会重推一轮。所以第 4 点必须和第 2 点同批上线。
+
+---
+
+## 2. `677e213` 评论二维码头像 + 深色模式 —— ❌ 未移植
+
+### 上游改了什么
+
+三张评论卡片（B站/快手/小红书）的二维码从 `generateQRCode()` 换成 `<QRCodeWithAvatar>`，
+把作者头像放到二维码正中；`Comment.tsx` 的 types 各加一个 `AuthorAvatar?: string`；
+三个平台对应的 `.ts` 在渲染评论卡时把头像传进去。
+另外小红书 `noteInfo.tsx` 也补了 `avatarUrl={data.author.avatar}`。
+
+### 本地现状
+
+- ✅ `src/ktr/template/components/QRCodeWithAvatar.tsx` **已存在**（1737 字节），
+  抖音评论卡 + 小红书 noteInfo 已经在用；
+- ❌ `bilibili/comment`、`kuaishou/comment`、`xiaohongshu/comment` 三处**仍用**
+  `import { generateQRCode }` + `<img src={generateQRCode(...)}>`；
+- ❌ 这三个 `types.ts` 里**没有** `AuthorAvatar`；
+- ❌ `xiaohongshu/noteInfo/components/noteInfo.tsx` 的 `QRCodeWithAvatar` **没传** `avatarUrl`。
+
+### 移植要点（本地）
+
+改 3 张卡的 `Comment.tsx`（换组件）+ 3 个 `types.ts`（加字段）+ 3 个平台 `.ts`（传值）
++ `noteInfo.tsx`（补 `avatarUrl`）。字段名上游统一叫 `AuthorAvatar`，本地照抄即可。
+小红书那处的头像来源是 `NoteData.data.data.items[0].note_card.user.avatar`。
+
+---
+
+## 3. `0659c2b` xhs comments —— ❌ 未移植
+
+### 上游改了什么
+
+- `xiaohongshu/comments.ts` 和 `xiaohongshu.ts` 的类型从 `NoteComments`
+  换成 **`XiaohongshuNoteCommentsResponse`**（amagi 换名）；
+- `xiaohongshu/comment/components/types.ts` 里 **子评论** 的 `pictures` 从 `string[]`
+  换成结构化对象数组（`height/width/url_pre/url_default/info_list`）。
+
+### 本地现状
+
+- ❌ 仍在用 `NoteComments`（`comments.ts:1`、`xiaohongshu.ts:7`）；
+- ⚠️ `types.ts:54` 的**主评论** `pictures` **已经是**结构化数组了 —— 上游这次改的是
+  **子评论**（`types.ts:102` 仍是 `string[]`），本地正好漏的就是这一处；
+- ✅ 依赖没问题：本地 amagi `7.0.0-beta.5` **已经导出** `XiaohongshuNoteCommentsResponse`
+  （在 `dist/default/index.d.ts` 和 `dist/exports/compat.d.ts` 里都能找到），**不用升依赖**。
+
+### 移植要点（本地）
+
+改 2 处 import/注解 + 1 处子评论 `pictures` 类型。风险低。
+
+---
+
+## 4. `2fa299a` 字体粗细 —— ❌ 未移植
+
+上游把模板里一批 `font-black` 降成 `font-bold`（30 个文件，主要是各卡片的标题/数字）。
+
+本地抽样核对：
+
+| 文件 | 行 | 现况 |
+|------|-----|------|
+| `bilibili/videoInfo/components/videoInfo.tsx` | 90 | `font-black`（弹幕） |
+| 同上 | 125 | `font-black`（标题 h1） |
+| `components/DefaultLayout.tsx` | 85 | `font-black` |
+| 同上 | 137 | `font-black` |
+
+即本地仍是旧的 `font-black`。这属于纯视觉微调，**30 个文件**搬运量不小、收益很小
+（本地还有自研改动，比如 `poweredBy` 那块跟上游已经不一样了），
+建议**按需挑几个用户最常看到的卡片改**，不必全量跟。
+
+---
+
+## 5. `f4b5312` dy 推送图片用户信息 —— ⚠️ 部分已覆盖
+
+上游改的是 `douyin/push/render.ts:527`：
+
+```diff
+- const user = Detail_Data.user_info?.data?.user ?? Detail_Data.author
++ const user = Detail_Data.user_info?.user ?? Detail_Data.author
+```
+
+即去掉中间那层 `.data`。本地 `render.ts:527` **已经是新写法**（`user_info?.user`），
+说明这个修复本地已经通过别的方式跟上了。
+
+但本地同文件 **54 行**还留着老写法：
+
+```
+src/karin/platform/douyin/push/render.ts:54
+const subscriber: DouyinUserLike = Detail_Data.user_info?.data?.user ?? Detail_Data.author
+```
+
+以及 374 行的 `Detail_Data.user_info?.data?.user?.ip_location`。
+这两处是「订阅者/推荐者」那条路径，**上游这次没动**，但如果 amagi 已经把
+`user_info.data.user` 收成 `user_info.user`，这两处也会取不到值 —— **建议顺手核一下**。
+
+---
+
+## 6~8. 不适用说明
+
+- **`ee22474` 重写 live photo tip**：上游把 `LivePhotoTip.tsx` 从 223 行重写成 280+，
+  并重构了 `DefaultLayout` 的页脚（新增 `GlowIcon`/`GlowText` 的 Design By 署名区）。
+  本地 `LivePhotoTip.tsx` 是 **295 行自研版**，且 `DefaultLayout` 页脚已经改成
+  maimai 自己的署名（「构建工具信息整块去掉：ROLLDOWN / VITE 都不要了」）。
+  **上游的页脚署名区对本地无意义**；LivePhotoTip 若要跟，得逐行比对，价值待定。
+- **`049eb2f` update amagi**：上游从 `pkg.pr.new` 的临时构建换回 `7.0.0-beta.4`；
+  本地已是 **`7.0.0-beta.5`**，更新，无需处理。
+- **`85088c7` fix: alias**：删掉 `vite.config.ts` 里指向本地 `../amagi/packages/core/src`
+  的 alias、把 `node-karin` override 升到 `1.16.3`。都是上游 monorepo 的内部构建配置，
+  **本地单包结构没有对应物**。
+
+---
+
+## 建议的搬运顺序
+
+如果决定搬，建议按这个顺序、分批发版：
+
+1. **`ff54ba5`（缓存续期）** —— 唯一含真实 bug 修复，单独发一版（patch）。注意判据+时机必须同批。
+2. **`677e213`（二维码头像）** —— 用户能直接看到，改动集中在模板层，风险低，可发 minor。
+3. **`0659c2b`（xhs 子评论 pictures 类型）** —— 改动小，可并进 2 里一起发。
+4. **`2fa299a`（字体粗细）** —— 纯视觉，建议只挑常用卡片改，或干脆不做。
+5. **`f4b5312` 的 54/374 行** —— 顺手核实即可，确认有问题再改。
+
+---
+
+## 附：核对证据
+
+- 上游 8 个 commit 的 SHA 均能在 `ikenxuan/karin-plugin-kkk` 上解析到，时间戳 2026-09-16 ~ 2026-09-22；
+- patch 明细来自 GitHub API `GET /repos/ikenxuan/karin-plugin-kkk/commits/<sha>`（含 `files[].patch`）；
+- 本地对照全部用现网源码逐行 grep 确认，涉及文件：
+  `src/karin/module/db/douyin.ts`、`src/karin/platform/douyin/push.ts`、
+  `src/karin/platform/douyin/push/{favorite,recommend,render}.ts`、
+  `src/ktr/template/{bilibili,kuaishou,xiaohongshu}/comment/components/{Comment.tsx,types.ts}`、
+  `src/ktr/template/xiaohongshu/noteInfo/components/noteInfo.tsx`、
+  `src/ktr/template/components/DefaultLayout.tsx`、
+  `src/ktr/template/bilibili/videoInfo/components/videoInfo.tsx`、
+  `src/karin/platform/xiaohongshu/{comments.ts,xiaohongshu.ts}`。
+
+---
+
+## 移植结果（2026-10-04，commit `7f1d705`，未发版）
+
+用户确认「1~6 全部搬过来」，第 7、8 条不适用。以下为实际落点，并**订正本报告前面两处误判**。
+
+| commit | 是否搬 | 落点 | 验证 |
+|---|---|---|---|
+| `ff54ba5` 缓存续期 | ✅ 全搬 | `module/db/douyin.ts` 新增 `touchAwemeCache`，清理判据 `createdAt`→`updatedAt`；`platform/douyin/push.ts` 清理时机挪到 `getDynamicList` 之后；`push/favorite.ts`、`push/recommend.ts` 换成续期调用 | `probe-aweme-ttl.cjs` 21/21 |
+| `677e213` 二维码头像 | ✅ 全搬 | 三张评论卡改 `QRCodeWithAvatar` + `AuthorAvatar`；三份 `types.ts` 加字段；xhs `noteInfo.tsx` 补 `avatarUrl`；B站/快手/小红书平台层传值 | `probe-qrcode-avatar.cjs` 25/25 |
+| `0659c2b` xhs 类型 | ✅ 全搬 | `comments.ts` / `xiaohongshu.ts` 的 `NoteComments` → `XiaohongshuNoteCommentsResponse`；子评论 `pictures` 改结构化数组 | 无专用探针，靠 tsc：**160 → 159** |
+| `2fa299a` 字体 | ✅ 全搬 | 25 个模板文件、136 行按上游 patch 逐行映射；另含本地 `DefaultLayout` 的 `By maimai` 署名行（上游无对应物，class 结构同型） | `probe-font-weight.cjs` 16/16 |
+| `f4b5312` 用户信息 | ✅ 且**扩大到 3 处** | `push/render.ts` 的 527 / 54 / 374 行 `user_info?.data?.user` → `user_info?.user` | `probe-dy-user-info.cjs` 12/12 |
+| `ee22474` 实况图 | ⚠️ 部分 | `LivePhotoTip.tsx` **全量替换**；`DefaultLayout.tsx` **不搬**（上游是给 ikenxuan 加署名，本地已有自己的页脚并写明「ROLLDOWN / VITE 整块去掉」），只取同 commit 里的分隔条对比度微调 | `probe-live-photo-tip.cjs` 20/20 |
+
+### 订正一：`f4b5312` 的 54/374 行不是「顺手核实」，是同一个真实缺陷
+
+本报告前面写「本地主路径已是新写法（`user_info?.user`）……建议顺手核实 54 行和 374 行」——
+结论对（确实要改），但**依据写反了**：本地 527 行**也还是**旧写法，上游只改了那一处。
+
+口径是怎么定死的：`DouyinUserProfileResponse` = amagi 的 `UserProfile_V0`，
+带 `[property: string]: any` 索引签名 ⇒ `.data` 与 `.user` **在类型上都能过**（tsc 帮不上忙）。
+只能看运行时 —— 本地 **15 处**一致用法（`comments.ts:132` 的 `userInfo.data.user.nickname`、
+`douyin.ts:1215` 的 `UserData.data.user.avatar_larger`、`push/live.ts:39`、
+`push.ts:829/1193`、`testPush.ts` 多处）证明 `fetchUserProfile()` 返回**信封**；
+而各推送流程传的是 `userinfo.data`（`push.ts:893`、`favorite.ts:66`、`testPush.ts:110/152`），
+所以 `user_info` 顶层就是 `.user`，没有 `.data`。三处 `.data?.user` 全部恒 `undefined`，
+静默兜底成「作品作者」/「作品自带 ip_location」。
+
+`probe-dy-user-info.cjs` 里用「用户资料 重庆 vs 作品自带 北京」制造冲突来断言，
+旧代码会明确给出「北京」。
+
+### 订正二：`ee22474` 不是「本地已有 295 行自研版」
+
+本报告前面写「本地 `LivePhotoTip.tsx` 是 295 行自研版，需逐行比对后决定合并方式」——
+**这是错的**。把上游改前版本（`2fa299a`）拉下来 `diff -u` 后发现，
+本地那份与上游改前**逐字节一致**，只差两行品牌名（`karin-plugin-kkk`→`koishi-plugin-kkk`、
+`KARIN-PLUGIN`→`KOISHI-PLUGIN`）。
+
+所以可以直接整套替换。`DefaultLayout` 才是真正分叉的那块：本地页脚已经换成了
+自己的署名（`By maimai` + QQ 头像）并明确删掉了构建工具区，
+上游 `ee22474` 给 DefaultLayout 加的是「Design By ikenxuan」+ Rolldown/Vite 两行堆叠 ——
+**与本地已有的决定冲突，故不搬**。
+
+### 回归
+
+- 探针 10 个全绿（含本报告上表 5 个新探针 + `probe-bili-desc` / `probe-extract-once` /
+  `probe-extract-buttons` / `probe-group-file-name` / `probe-md-image-size`）；
+- `smoke-koishi-commands` 46/46、`smoke-render` 36/36 路由、
+  `smoke-comments` / `smoke-commands` / `smoke-md-image` / `smoke-imports` 通过；
+- **tsc 159**（基线 160）；
+- `smoke-douyin.cjs` 的「抖音接口被风控时的提示」失败 —— 已用 `git stash` + 重建 HEAD 对照，
+  在 `837a222` 上同样失败，**属预先存在的问题**，与本批无关；
+- `deploy.mjs` 已同步本地镜像（326 文件 / 2.83MB），宿主重启后生效。

package/lib/build-metadata.json

@@ -1,10 +1,10 @@
 {
-  "version": "3.12.0",
-  "buildTime": "2026-10-01T15:04:46.055Z",
-  "buildTimestamp": 1790867086061,
+  "version": "3.13.0",
+  "buildTime": "2026-10-04T03:01:39.157Z",
+  "buildTimestamp": 1791082899161,
   "name": "koishi-plugin-kkk",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "homepage": "https://github.com/maimai993/koishi-plugin-kkk#readme",
-  "commitHash": "676659fbbdf78244670d22aee37bb7668ef73b42",
-  "shortCommitHash": "676659f"
+  "commitHash": "4d322db76de3637eeb155bf556cbd771e4cedf7b",
+  "shortCommitHash": "4d322db"
 }

package/lib/karin/module/db/douyin.js

@@ -444,35 +444,35 @@ class DouyinDBBase {
             return false; // 如果没有 sec_uid，默认不过滤
         }
         const { filterMode, filterWords, filterTags } = await this.getFilterConfig(sec_uid);
-        node_karin_1.logger.debug(`
-      获取用户${PushItem.remark}（${PushItem.sec_uid}）的过滤配置：
-      过滤模式：${filterMode}
-      过滤词：${filterWords}
-      过滤标签：${filterTags}
+        node_karin_1.logger.debug(`
+      获取用户${PushItem.remark}（${PushItem.sec_uid}）的过滤配置：
+      过滤模式：${filterMode}
+      过滤词：${filterWords}
+      过滤标签：${filterTags}
       `);
         const desc = PushItem.Detail_Data.desc ?? '';
         // 检查内容中是否包含过滤词
         const hasFilterWord = filterWords.some((word) => desc.includes(word));
         // 检查标签中是否包含过滤标签
         const hasFilterTag = filterTags.some((filterTag) => tags.some((tag) => tag === filterTag));
-        node_karin_1.logger.debug(`
-      作者：${PushItem.remark}
-      检查内容：${desc}
-      命中词：[${filterWords.join('], [')}]
-      命中标签：[${filterTags.join('], [')}]
-      过滤模式：${filterMode}
-      是否过滤：${hasFilterWord || hasFilterTag ? node_karin_1.logger.red(`${hasFilterWord || hasFilterTag}`) : node_karin_1.logger.green(`${hasFilterWord || hasFilterTag}`)}
-      作品地址：${node_karin_1.logger.green(`https://www.douyin.com/video/${PushItem.Detail_Data.aweme_id}`)}
+        node_karin_1.logger.debug(`
+      作者：${PushItem.remark}
+      检查内容：${desc}
+      命中词：[${filterWords.join('], [')}]
+      命中标签：[${filterTags.join('], [')}]
+      过滤模式：${filterMode}
+      是否过滤：${hasFilterWord || hasFilterTag ? node_karin_1.logger.red(`${hasFilterWord || hasFilterTag}`) : node_karin_1.logger.green(`${hasFilterWord || hasFilterTag}`)}
+      作品地址：${node_karin_1.logger.green(`https://www.douyin.com/video/${PushItem.Detail_Data.aweme_id}`)}
       `);
         // 根据过滤模式决定是否过滤
         if (filterMode === 'blacklist') {
             // 黑名单模式：如果包含过滤词或过滤标签，则过滤
             if (hasFilterWord || hasFilterTag) {
-                node_karin_1.logger.warn(`
-          作品内容命中黑名单规则，已过滤该作品不再推送
-          作品地址：${node_karin_1.logger.yellow(PushItem.Detail_Data.share_url)}
-          命中的黑名单词：[${filterWords.join('], [')}]
-          命中的黑名单标签：[${filterTags.join('], [')}]
+                node_karin_1.logger.warn(`
+          作品内容命中黑名单规则，已过滤该作品不再推送
+          作品地址：${node_karin_1.logger.yellow(PushItem.Detail_Data.share_url)}
+          命中的黑名单词：[${filterWords.join('], [')}]
+          命中的黑名单标签：[${filterTags.join('], [')}]
           `);
                 return true;
             }
@@ -487,28 +487,55 @@ class DouyinDBBase {
             if (hasFilterWord || hasFilterTag) {
                 return false; // 不过滤
             }
-            node_karin_1.logger.warn(`
-        作品内容未命中白名单规则，已过滤该作品不再推送
-        作品地址：${node_karin_1.logger.yellow(PushItem.Detail_Data.share_url)}
-        命中的黑名单词：[${filterWords.join('], [')}]
-        命中的黑名单标签：[${filterTags.join('], [')}]
+            node_karin_1.logger.warn(`
+        作品内容未命中白名单规则，已过滤该作品不再推送
+        作品地址：${node_karin_1.logger.yellow(PushItem.Detail_Data.share_url)}
+        命中的黑名单词：[${filterWords.join('], [')}]
+        命中的黑名单标签：[${filterTags.join('], [')}]
         `);
             return true;
         }
     }
     /**
-     * 清理旧的作品缓存记录
-     * @param days 保留最近几天的记录
+     * 清理过期的作品缓存记录
+     *
+     * 判据用 `updatedAt`（最后一次仍出现在列表中的时间）而非 `createdAt`：喜欢/推荐列表会长期返回
+     * 同一批作品，只要作品还在列表里，每轮推送都会通过 {@link touchAwemeCache} 续期，其去重记录就不会
+     * 被清理，从而避免过往作品被反复重推；一旦作品掉出列表、不再续期，超过保留期后即回收，保证缓存表
+     * 规模有界。作品列表(post)/直播(live)从不续期，行为与旧逻辑一致（且 post 另有 24h 闸门兜底）。
+     * @param days 保留最近几天内仍出现过的记录
      * @returns 删除的记录数量
      */
     async cleanOldAwemeCache(days = 7) {
         const cutoffDate = new Date();
         cutoffDate.setDate(cutoffDate.getDate() - days);
         const result = await this.db.remove(model_1.TABLE.douyinAwemeCache, {
-            createdAt: { $lt: cutoffDate.toISOString() }
+            updatedAt: { $lt: cutoffDate.toISOString() }
         });
         return result.removed ?? 0;
     }
+    /**
+     * 为「仍在列表中」的作品续期去重记录（滑动 TTL）
+     *
+     * 喜欢/推荐列表每轮都用当前返回的全部 aweme_id 调用此方法，把这些记录的 `updatedAt` 刷新到当前
+     * 时间。配合 {@link cleanOldAwemeCache} 按 `updatedAt` 清理：仍在列表里的作品永不过期（不会重推），
+     * 掉出列表的作品因不再续期而在保留期后被回收（缓存表规模有界）。
+     * @param sec_uid 抖音用户sec_uid
+     * @param pushType 推送类型
+     * @param aweme_ids 当前列表中的全部作品ID
+     */
+    async touchAwemeCache(sec_uid, pushType, aweme_ids) {
+        const ids = [...new Set(aweme_ids)];
+        if (ids.length === 0)
+            return;
+        await this.db.set(model_1.TABLE.douyinAwemeCache, {
+            sec_uid,
+            pushType,
+            aweme_id: { $in: ids }
+        }, {
+            updatedAt: now()
+        });
+    }
     /** 为了向后兼容，保留groupRepository和awemeCacheRepository属性 */
     get groupRepository() {
         return {

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

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildImageMessageFor = exports.buildMarkdownImageMessage = exports.toMarkdownImage = exports.sendParseTip = exports.EXTRACT_COMMENT_COMMAND = exports.EXTRACT_COVER_COMMAND = exports.supportsMarkdown = void 0;
+exports.buildImageMessageFor = exports.buildMarkdownImageMessage = exports.toMarkdownImage = exports.sendParseTip = exports.buildBilibiliPanelCardData = exports.EXTRACT_COMMENT_COMMAND = exports.EXTRACT_COVER_COMMAND = exports.supportsMarkdown = void 0;
 exports.rememberPanelRequest = rememberPanelRequest;
 exports.resolvePanelQualitySize = resolvePanelQualitySize;
 exports.resolvePanelToken = resolvePanelToken;
@@ -98,7 +98,7 @@ const CardImageCache_1 = require("../../module/utils/CardImageCache");
 const Render_1 = require("../../module/utils/Render");
 const imageSize_1 = require("../../../compat/imageSize");
 const danmaku_1 = require("../../platform/bilibili/danmaku");
-// 头像框 / 昵称颜色要从 UP 主页接口拿，和解析结果保持一致
+// 头像框 / 昵称颜色要从 UP 主页接口拿，和解析结果保持一致；简介同样走解析那边的统一口径
 const dynamic_text_1 = require("../../platform/bilibili/dynamic-text");
 // 抖音卡片复用推送那套构建器（保真度最高）
 const render_1 = require("../../platform/douyin/push/render");
@@ -979,6 +979,46 @@ const panelCardInfo = (buffer, url) => {
     }
     return { url, width: size.width, height: size.height };
 };
+/**
+ * 面板卡片的 B 站数据（`bilibili/videoInfo` 模板吃的那份）。
+ *
+ * ## 单独抽成函数，是为了「这张卡也得有简介」这件事能被离线测到
+ *
+ * 这份对象以前是内联在 {@link uploadPanelCard} 里的，其中 `desc` 被写死成 `''`。
+ * 于是出现一个很隐蔽的现象：**解析卡片有简介、面板卡片永远没有**，
+ * 而 QQ 上开着面板时解析卡片是**不发**的（见 bilibili.ts 的 `fromPanel` 分支），
+ * 用户实际看到的每一张卡都是面板这张 —— 修了解析那边的简介，
+ * 用户这边「标题下面还是没有简介」。（见 scripts/probe-bili-desc.cjs）
+ *
+ * 简介和解析那边走**同一个** {@link buildVideoDescRichText}：接口有时把简介放在
+ * `desc_v2` 里、有时只在 `desc` 里，口径收在一处才不会两边不一致。
+ *
+ * @param detail 稿件对象（`fetchVideoInfo` 的 `data.data`，含 desc / desc_v2）
+ * @param fallbackId 稿件对象里没有 bvid 时用的作品 ID（面板请求里的那个）
+ * @param hotDanmaku 热门弹幕，卡片顶部飘过的那几条（和解析结果一致）
+ * @param ownerCard UP 主页卡片（头像框 / 昵称颜色），拉失败传 null
+ */
+const buildBilibiliPanelCardData = (detail, fallbackId, hotDanmaku = [], ownerCard = null) => ({
+    share_url: bilibiliShareUrl(String(detail?.bvid ?? fallbackId)),
+    title: detail?.title,
+    desc: (0, dynamic_text_1.buildVideoDescRichText)(detail?.desc_v2, detail?.desc),
+    stat: detail?.stat,
+    bvid: detail?.bvid ?? fallbackId,
+    ctime: detail?.ctime,
+    pic: detail?.pic,
+    hotDanmaku,
+    /**
+     * 头像框和粉名都来自 UP 主页（userCard）—— 面板只拉了视频信息，
+     * 之前直接传 detail.owner 就少了 frame / usernameMeta 两个字段，
+     * 于是卡片上「没有头像框、名字也不是粉色」。这里和解析那边用同一份构造。
+     */
+    owner: {
+        ...detail?.owner,
+        usernameMeta: ownerCard ? (0, dynamic_text_1.getUsernameMetadata)(ownerCard) : undefined,
+        frame: ownerCard?.pendant?.image || ''
+    }
+});
+exports.buildBilibiliPanelCardData = buildBilibiliPanelCardData;
 /**
  * 渲染面板卡片（和解析结果同一套模板）并上传到 assets，拿到 QQ markdown 能用的图片地址。
  *
@@ -1029,27 +1069,7 @@ async function uploadPanelCard(e, request, detail, hotDanmaku = []) {
         }
         const route = 'bilibili/videoInfo';
         const cardData = request.platform === 'bilibili'
-            ? {
-                share_url: bilibiliShareUrl(String(detail.bvid ?? request.id)),
-                title: detail.title,
-                desc: '',
-                stat: detail.stat,
-                bvid: detail.bvid ?? request.id,
-                ctime: detail.ctime,
-                pic: detail.pic,
-                // 和解析结果一致：带热门弹幕，卡片顶部就有弹幕飘过
-                hotDanmaku,
-                /**
-                 * 头像框和粉名都来自 UP 主页（userCard）—— 面板只拉了视频信息，
-                 * 之前直接传 detail.owner 就少了 frame / usernameMeta 两个字段，
-                 * 于是卡片上「没有头像框、名字也不是粉色」。这里和解析那边用同一份构造。
-                 */
-                owner: {
-                    ...detail.owner,
-                    usernameMeta: ownerCard ? (0, dynamic_text_1.getUsernameMetadata)(ownerCard) : undefined,
-                    frame: ownerCard?.pendant?.image || ''
-                }
-            }
+            ? (0, exports.buildBilibiliPanelCardData)(detail, request.id, hotDanmaku, ownerCard)
             : {
             // 抖音卡片的数据结构由模板决定，这里先不做卡片，交给兜底面板
             };

package/lib/karin/module/utils/Render/index.js

@@ -44,8 +44,20 @@ function loadTemplateCss() {
     if (cachedCss !== null)
         return cachedCss;
     try {
-        const cssPath = node_path_1.default.resolve(utils_1.Root.pluginPath, 'resources', 'template', 'style.css');
-        const raw = node_fs_1.default.readFileSync(cssPath, 'utf8');
+        const dir = node_path_1.default.resolve(utils_1.Root.pluginPath, 'resources', 'template');
+        let raw = node_fs_1.default.readFileSync(node_path_1.default.join(dir, 'style.css'), 'utf8');
+        /**
+         * style.css 是 tailwind v4 的**按需产物**，只含构建那一刻扫描到的类。
+         * 模板跟着上游更新后，新引入的工具类不会自动出现 —— 页面不报错，只是静默掉间距、
+         * 掉尺寸、图标塌成 0 宽（实况照片提示卡就这么崩过）。
+         * scripts/sync-template-css.mjs 把上游产物里对应的规则抽到 extra-utilities.css，这里追加。
+         */
+        try {
+            raw += '\n' + node_fs_1.default.readFileSync(node_path_1.default.join(dir, 'extra-utilities.css'), 'utf8');
+        }
+        catch {
+            // 没有这个文件就是没同步过，按原样用 style.css
+        }
         cachedCss = raw.replace(/url\("?http:\/\/localhost:\d+\/config\/commonResource\//g, 'url("./template-fonts/');
     }
     catch (error) {

package/lib/karin/platform/bilibili/bilibili.js

@@ -344,9 +344,7 @@ class Bilibili extends utils_1.Base {
                         const img = await (0, utils_1.Render)(this.e, 'bilibili/videoInfo', {
                             share_url: 'https://b23.tv/' + infoData.data.data.bvid,
                             title: infoData.data.data.title,
-                            desc: infoData.data.data.desc_v2?.length
-                                ? (0, dynamic_text_1.buildBilibiliVideoDescRichText)(infoData.data.data.desc_v2)
-                                : (0, dynamic_text_1.buildBilibiliDynamicRichText)(infoData.data.data.desc || '', []),
+                            desc: (0, dynamic_text_1.buildVideoDescRichText)(infoData.data.data.desc_v2, infoData.data.data.desc),
                             stat: infoData.data.data.stat,
                             bvid: infoData.data.data.bvid,
                             ctime: infoData.data.data.ctime,
@@ -572,7 +570,8 @@ class Bilibili extends utils_1.Base {
                                 shareurl: 'https://b23.tv/' + infoData.data.data.bvid,
                                 Resolution: useAnonymousQuality
                                     ? null
-                                    : `${playUrlData.data.data.dash.video[0].width} x ${playUrlData.data.data.dash.video[0].height}`
+                                    : `${playUrlData.data.data.dash.video[0].width} x ${playUrlData.data.data.dash.video[0].height}`,
+                                AuthorAvatar: infoData.data.data.owner?.face
                             });
                             // 评论卡可能极长（实测 2880x40000），交给切片+md 拼接发送，避免 QQ 拒收
                             /** 评论区那张长图也记下来，「提取评论区图片」按钮点的是它 */
@@ -1187,9 +1186,7 @@ class Bilibili extends utils_1.Base {
                             img = await (0, utils_1.Render)(this.e, 'bilibili/dynamic/DYNAMIC_TYPE_AV', {
                                 image_url: INFODATA.data.data.pic,
                                 text: (0, dynamic_text_1.buildBilibiliDynamicRichText)(INFODATA.data.data.title, []),
-                                desc: INFODATA.data.data.desc_v2?.length
-                                    ? (0, dynamic_text_1.buildBilibiliVideoDescRichText)(INFODATA.data.data.desc_v2)
-                                    : (0, dynamic_text_1.buildBilibiliDynamicRichText)(INFODATA.data.data.desc || '', []),
+                                desc: (0, dynamic_text_1.buildVideoDescRichText)(INFODATA.data.data.desc_v2, INFODATA.data.data.desc),
                                 dynamic_text: dynamicText,
                                 dianzan: (0, utils_1.Count)(INFODATA.data.data.stat.like),
                                 pinglun: (0, utils_1.Count)(INFODATA.data.data.stat.reply),
@@ -1358,7 +1355,8 @@ class Bilibili extends utils_1.Base {
                                     : `https://t.bilibili.com/${dynamicInfo.data.data.item.id_str}`,
                                 ImageLength: dynamicInfo.data.data.item.modules?.module_dynamic?.major?.draw?.items?.length ?? 0,
                                 shareurl: '动态分享链接',
-                                Resolution: null
+                                Resolution: null,
+                                AuthorAvatar: dynamicInfo.data.data.item.modules?.module_author?.face
                             });
                             /** 动态评论区下面只带「提取评论区图片」，封面那个归动态卡片 */
                             (0, CardImageCache_1.rememberCardImages)(dynamicCardKey, { comment: (0, CardImageCache_1.imageSourcesOf)(img) });