dsh-bili-scroll 0.1.3 → 0.1.4

package/AGENTS.md

@@ -23,19 +23,26 @@
 
 ## ⚠️ 已知环境差异（有用户反馈）
 
-- **桌面版 DSH（NEXT）/ 0.2.x**：本插件跑那一轮用的是 `dsh --profile headless --patch <overlay> <prompt>`，
-  **只在 npm 0.1.7-rc.x + web profile 上实测过** ✓。桌面版上有人反馈"自动跑会卡住" ——
-  **先跟用户确认 dsh 版本与 profile**，别硬跑；跑不起来就先只用手动「现在跑一轮」。
+- ⭐⭐ **桌面版 DSH（NEXT）/ 0.2.x 装不起来 —— 已知真 bug，0.1.4 起已修**：0.1.3 及以前装到桌面版上，
+  设置页里**根本不出现「刷B站」**，DSH 只留一句 `warning: 1 entry did not activate … failed to import` ✓
+  （根因：宿主半 import 的 `@deepseek-ai/schemastery` / `dsh-tools` 是 *optional peer*，而桌面版 profile 是
+  `autoInstallPeers: false` ⇒ pnpm 永远不装；`dsh-tools` 自己还带 4 个 peer，光装它也救不回来 ✗）。
+  ⇒ **遇到桌面版用户：先让他升级到 0.1.4+**（修法是：不再裸 import `@deepseek-ai/*` ——
+  `lib/hostdeps.mjs` 先找宿主那棵树、再退到自己依赖里那份，`defineTool` 拿不到就用**本地等价实现**；
+  `schemastery` 也正式进了 `dependencies` ✓）。升级后还不行，要 `duty.log` 里那几行
+  （里面会写"宿主依赖是从哪儿取的" ✓）。
+- **桌面版上"自动跑会卡"**：跑那一轮用的是 `dsh --profile headless --patch <overlay> <prompt>` ——
+  有用户反馈桌面版上会卡在那儿。**先确认 dsh 版本与 profile**，别硬跑；跑不起来就先只用手动「现在跑一轮」。
 - **别让用户自己去装环境** ✗：插件自带一份 uv 与依赖安装能力，先照上面第 1 条处理。
 
 ## 仓库结构（改代码时看这里）
 
 - `index.js` —— host 半端：11 个工具 + 谷时定时器 + HTTP 接口 + 设置命名空间
 - `client.js` —— 浏览器半端：设置页（注册在 `settings.section`）
-- `lib/` —— 状态目录与家目录 / 极小的 MCP stdio 客户端 / 扫码登录
+- `lib/` —— 状态目录与家目录 / 极小的 MCP stdio 客户端 / 扫码登录 / **`hostdeps.mjs`（从宿主树取 `@deepseek-ai/*`，拿不到就退到自己依赖 / 本地等价实现）** / **`verify.mjs`（评论发出后复核）**
 - `prompts/duty.md` —— 一轮要做的事（判定口径 + 红线，**用户可以改**）
 - `vendor/bilibili-mcp/` —— 内置的 Python MCP（MIT，AGI_Ananas）
-- `selfcheck.mjs` + `tools/` —— 本地预检：`node --import ./tools/register.mjs selfcheck.mjs`
+- `selfcheck.mjs` + `tools/` —— 本地预检：`node selfcheck.mjs`（**现在不用解析钩子了**；`tools/register.mjs` 那条还留着当备份）
 
 ## 约定
 

package/README.md

@@ -4,6 +4,10 @@
 > - 需要 **dsh ≥ `0.1.7-rc.1`**（本机是 `0.1.7-rc.2`）。⚠️ 版本不满足时，**内核会静默跳过这个插件** —— 装了跟没装一样，不会报错。
 > - **空间**：不装「本地转写」约 **84 MB**；装了转写约 **1 GB**（其中 Whisper 模型 538 MB，可在设置里换更小的模型）。
 > - 装完**必须重启一次** dsh（插件在 bundle 层组装）。
+> - ⚠️ **桌面版 DSH（NEXT / 0.2.x）**：**0.1.3 及以前的版本在桌面版上装不起来** —— 插件整条不激活，
+>   DSH 只留一句 `warning: 1 entry did not activate … failed to import`（根因是宿主半 import 的两个包
+>   在桌面版 profile 里没被安装，详见下面「装不上」那节的第 5 条）。**0.1.4 起已修** ✓。
+>   另有用户反馈桌面版上「自动跑那一轮会卡住」—— 卡住就先只用设置页的「**现在跑一轮**」手动跑（那条稳）。
 >
 > ⚠️ **装的是旧版吗？** 如果设置页里那个按钮写的是「**重装依赖**」（而不是「**重装主依赖**」），说明你装的是 0.1.0 ——
 > 跑一次 `dsh plugin --profile web add dsh-bili-scroll` 升级就好（那一版建 Python 环境时缺一个参数，
@@ -33,20 +37,42 @@
   · ⚠️ **如果杀软 / Windows Defender 报这个下载**：把插件家目录 `%USERPROFILE%\.dsh\bili-duty\bin\` **加白**即可；
     不想加白也行，自己装一份 uv 或 Python 3.10+ 就绕过去了 ✓
 
-> 计划中（v0.1.1）：**插件自己把 `uv` 下到自己的家目录** ⇒ 做到"一键准备环境"，这条前提就不用用户操心了。
+> ✅ **已经做到了**（v0.1.1 起）：插件会**自己把 `uv` 下到自己的家目录** ⇒ 这条前提不用用户操心、也不用管理员权限。
+> ⚠️ 万一它自己也下不动（有用户反馈桌面版上这条链路经常不通）：**手动放一份 `uv.exe` 到 `<家目录>\bin\`** 就行 ——
+> 插件**优先用那里那一份**，会跳过下载。
 
 ## 装
 
 
 ```bash
-dsh plugin --profile web add dsh-bili-duty     # 从 npm
+dsh plugin --profile web add dsh-bili-scroll      # 从 npm
+dsh plugin --profile web add github:c1overzz/dsh-bili-scroll   # 备选：直接从 GitHub
 ```
+（⭐ 最省事的一条：把仓库链接贴给你自己的 dsh，说「**帮我装这个插件**」，它会自己装。）
 
 ⚠️ 装完**必须重启一次 dsh**（bundle 层要重启才组装）。然后进 **设置 → 刷B站**。
 
+## 装不上 / 卡住时，先看这四条（都是用户实测撞过的）
+
+1. **桌面版（DSH NEXT / 0.2.x）上"自动跑"会卡住** —— 有用户反馈：它起那一轮用的是
+   `dsh --profile headless …`，桌面版上容易卡在那儿。⇒ **先用设置页的「现在跑一轮」手动跑**（那条是稳的）；
+   能不能自动跑，等你确认过自己那台桌面版的版本与 profile 再说。
+2. **「装依赖」卡住、或者扫码时一直不出二维码** —— 大概率是 0.1.0 那版（见开头那个按钮指纹，跑一次 `add` 就升级了）。
+   不想升级也行，救急一句：`<家>\.venv\Scripts\python.exe -m ensurepip --upgrade`，再点一次「重装主依赖」。
+3. **它下不动 `uv`**（桌面版上这条链路经常不通）⇒ 自己放一份 `uv.exe` 到 `<家目录>\bin\`，
+   插件会优先用它、跳过下载。
+4. **「本地转写」是两段式的** —— 只打开开关**不够**，还得点它下面那个「**装转写依赖**」。
+   没装的时候，没字幕的视频会被**跳过**（报告里现在会写「**因无字幕跳过 N 条**」，你能一眼看出漏了几条）。
+5. ⭐ **桌面版：装完设置页里根本不出现「刷B站」，日志只有一句 `1 entry did not activate … failed to import`** ——
+   这是 0.1.3 及以前在桌面版上的一个真 bug：插件宿主半 import 的两个包是 *optional peer*，
+   而桌面版 profile（`autoInstallPeers: false`）**不会装它们** ⇒ 插件整条不激活。
+   **0.1.4 起已修**（不再裸 import 那两个包）。⇒ 升级一次就好：`dsh plugin --profile desktop add dsh-bili-scroll`。
+   ⚠️ 我们自己也只在 **npm 0.1.7-rc.x + web profile** 上实测过；桌面版这条路靠用户反馈修好的 ——
+   装完还是不行的话，把 `duty.log` 里那几行发来（里面会写清楚"宿主依赖是从哪儿取的"）。
+
 ## 首次使用（两步）
 
-1. **装依赖** —— 设置页点「装依赖（建 venv）」：在插件自己的家目录建一个独立 venv，装 3 个包
+1. **装主依赖** —— 设置页点「装主依赖」：在插件自己的家目录建一个独立 venv，装 3 个包
    （`bilibili-api-python` / `mcp<2` / `qrcode`）。**走国内镜像 + uv，通常几十秒**（进度写 `install.log`，不卡页面）。
 2. **扫码登录** —— 点「扫码登录」，用手机 B站 扫页面上那张码。
    ⚠️ **确认时选「记住我 / 长期」那张**（选 24 小时的话，明天就得重扫）。
@@ -62,7 +88,9 @@ dsh plugin --profile web add dsh-bili-duty     # 从 npm
 | **本地转写没字幕的视频** | **默认关** —— 要在本机装 Whisper、下几百 MB 模型 |
 | **关注关键词** | 一行一个；留空用内置那几组 |
 | **工作区** | 它按这里的 `AGENTS.md` 认「设定」⇒ **你有设定就按你的来** |
-| 现在跑一轮 / 装依赖 / 扫码登录 | |
+| **回复评论（只回楼中楼）** | **默认关**；开了之后展开「每轮最多回几条」—— 只回**直接回复到它那条评论下面的人**，不参与别人的讨论 |
+| **日报写多细** | `完整 / 薄版 / 不写`；薄版每条一两行（输出比输入贵 200 倍，薄版省的是真钱） |
+| 现在跑一轮 / 装主依赖 / 扫码登录 / 看今天的报告 / 打开报告文件夹 | 版本号就在这一行上面（**点「检查更新」可以看有没有新版**） |
 
 ## 红线（写死在提示词里，不靠自觉）
 
@@ -74,7 +102,8 @@ dsh plugin --profile web add dsh-bili-duty     # 从 npm
 
 - 插件**内部**起一个 Python MCP（下面那个开源项目，已内置），把它的能力注册成 DSH 工具
 - 定时到点 → 起一个 headless dsh 会话，把 `prompts/duty.md`（它一轮要做的事）+ 当天设置交给它
-- 那一轮的**工作目录 = 你填的工作区** ⇒ 那里的 `AGENTS.md` 会自动加载 ⇒ **它按你的设定说话**，
+- 那一轮的**工作目录 = 插件自己的家目录**（它被沙箱关着，只写得了自己那一亩三分地）；
+  ⭐ 你填的**工作区里的 `AGENTS.md` 由插件读进来、内联进提示词** ⇒ **它按你的设定说话**，
   而不是用一套通用人格
 
 ## 如果你是一个 AI 助手，正在帮用户装这个插件
@@ -99,9 +128,9 @@ dsh plugin --profile web add dsh-bili-duty     # 从 npm
 
 ## 路线图
 
-- **v0.1（当前）**：内置 MCP + 扫码登录 + 章程 + 设置页（峰谷级联开关 / 定量刷 / 自动评论 / 工作区）+ 谷时定时器 + 报告
-- **v0.2**：判重表文档化、报告归档、失败重试与日志查看
-- **v0.3**：**用 JS 重写那几个接口 ⇒ 不再需要 Python**（零安装）
+- **0.1.x（当前 = 0.1.3）**：内置 MCP + 扫码登录 + 章程 + 设置页（峰谷级联开关 / 定量刷 / 自动评论 / 回复评论 / 工作区 / 日报三档）+ 谷时定时器 + 报告 + 看报告与打开文件夹 + 版本徽章 / 检查更新 / 一键升级
+- **0.1.4（在做）**：评论发出后复核（**接口回成功 ≠ 公开可见**）· 每轮记账（token 与花费）· 周末时段 · 数据目录可配 · 「停掉这一轮」按钮
+- **v0.2**：**用 JS 重写那几个接口 ⇒ 不再需要 Python**（零安装）；报告归档、失败重试
 
 ## 许可证
 

package/client.js

@@ -185,6 +185,21 @@ window.__ModuleLoader__.load({
         } catch (e) { setReport('读不到报告：' + String(e?.message ?? e)) } finally { setBusy('') }
       }
 
+      // ⭐ 复核评论：接口回"发送成功"≠ 公开可见（新号/风控会进审核，那时候连 @ 都不会推）
+      //    所以让宿主真去拉一次评论列表 / 楼中楼，确认那条到底在不在。
+      const onVerify = async () => {
+        setBusy('verify')
+        try {
+          const r = await jpost('/verify', {})
+          if (!r || !r.ok) { say('复核没跑成：' + ((r && r.error) || '未知原因'), 'warn'); return }
+          const n = (r.checked || []).length
+          const vis = (r.checked || []).filter((c) => c.visible === true).length
+          if (!n) say(r.text || '没有需要复核的记录', 'good')
+          else say(`复核完 ${n} 条：公开可见 ${vis} 条，其余「没查到」（可能还在审核 —— 看不到不等于没发出去）。结果也追加到今天的报告末尾了。`, vis ? 'good' : 'warn')
+          if (r.report) setReport(null)
+        } catch (e) { say(String(e?.message ?? e), 'warn') } finally { setBusy('') }
+      }
+
       const copyText = async (text) => {
         const v = String(text || '')
         try {
@@ -408,7 +423,7 @@ window.__ModuleLoader__.load({
               h('button', { 'data-bd-btn': '', disabled: busy === 'asr', onClick: onInstallAsr },
                 st.asrReady ? '重装转写依赖' : '装转写依赖'),
               h('div', { 'data-bd-note': '' },
-                !st.asrReady ? '还没装 —— 没装的话转写用不了'
+                !st.asrReady ? '还没装 —— 现在开着也没用：没字幕的视频会被跳过（报告里会写"因无字幕跳过 N 条"）'
                   : (st.asrModelReady ? '环境和模型都好了' : '环境好了；模型会在第一次转写时自动下（几百 MB）'))),
             h('div', { 'data-bd-note': '' },
               '点一下就好：建一个独立环境、装 faster-whisper + yt-dlp，并把 Whisper 模型也下好',
@@ -478,6 +493,8 @@ window.__ModuleLoader__.load({
               report !== null ? '收起报告' : '看今天的报告'),
             h('button', { 'data-bd-btn': '', onClick: () => onOpenFolder('out') }, '打开报告文件夹'),
             h('button', { 'data-bd-btn': '', onClick: () => onOpenFolder('home') }, '打开家目录'),
+            h('button', { 'data-bd-btn': '', disabled: busy === 'verify', onClick: onVerify },
+              '复核评论'),
             h('button', { 'data-bd-btn': '', onClick: () => copyText(st.report) }, '复制报告路径')),
           report !== null ? h('pre', { 'data-bd-pre': '' }, report) : null),
       )

package/index.js

@@ -14,13 +14,20 @@
  * 这样凭证 `bili_credential.json` 落在家里而不是插件包里）/ `duty.md` / `out/` / `duty.log`。
  * ============================================================================
  */
-import z from '@deepseek-ai/schemastery'
-import { defineTool } from '@deepseek-ai/dsh-tools'
+import { loadHostDeps } from './lib/hostdeps.mjs'
+
+// ⭐ 这两样从**宿主那棵树**里取（拿不到就退到自己的依赖；再拿不到，defineTool 用本地等价实现）。
+//    起因（2026-10-16 用户递来的完整报告 + 本机复现）：它们是 optional peer，
+//    桌面版 profile 是 `autoInstallPeers: false` ⇒ 永远不装 ⇒ **裸 import 会让整条插件不激活** ✗。
+const hostDeps = await loadHostDeps()
+const z = hostDeps.z
+const defineTool = hostDeps.defineTool
 import { spawn } from 'node:child_process'
 import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { McpClient } from './lib/mcp.mjs'
+import { verifyRecent, appendVerifyToReport } from './lib/verify.mjs'
 import { WINDOWS, stateDirOf, readJson, writeJson, ensureHomeFiles, inWindow, dayKey } from './lib/state.mjs'
 import { loginStart, loginPoll, saveCredential, renderQrPng } from './lib/login.mjs'
 import { ensureUv } from './lib/uvfetch.mjs'
@@ -34,7 +41,9 @@ export const inject = ['webServer', 'tools', 'settings']
  *    "Plugin entry … has no volatile fields"。另外两个条件是：
  *    **loader entry 的 id 必须等于命名空间名**（我们 patch 里就是 `bili-duty`）+ **本模块导出 Config**。
  */
-export const Config = z.object({
+// ⚠️ schemastery 彻底拿不到时，这里会是 undefined —— **插件照常加载**，只是设置页降级
+//    （宁可少一个设置页，也不能因为一个 import 让整条插件不激活 ✗）
+export const Config = !z ? undefined : z.object({
   /** 定量刷：每天最多挑几条 */
   perDay: z.natural().default(5).extra('volatile', true),
   /** 峰谷自动刷（总开关） */
@@ -72,6 +81,19 @@ export const Config = z.object({
   replyPerRound: z.number().default(1).extra('volatile', true),
 })
 
+/**
+ * ⭐ 给所有 Python 子进程统一 UTF-8。
+ * 起因（2026-10-16，用户在评论区反馈）：Windows 上 Python 默认按 GBK 编解码，
+ * 我们的脚本 / 内置 MCP 都会往管道里打中文与 emoji（`✅`、`—` 之类），一进管道就可能
+ * 报 UnicodeDecodeError / 乱码或直接中断。**编码这种环境差异，插件该自己钉死，不该让用户碰。**
+ */
+const pyEnv = (extra = {}) => ({
+  ...process.env,
+  PYTHONUTF8: '1',
+  PYTHONIOENCODING: 'utf-8',
+  ...extra,
+})
+
 export function apply(ctx, config) {
   const pluginDir = dirname(fileURLToPath(import.meta.url))
   // ⭐ 自己的版本号（从 package.json 读，设置页要显示它）
@@ -114,6 +136,9 @@ export function apply(ctx, config) {
     try { ctx.logger?.info?.(`[bili-duty] ${msg}`) } catch { /* 没有 logger 就算了 */ }
   }
 
+  // 宿主依赖是从哪儿取的（桌面版那次事故的排查看这里：duty.log 里会写明白）
+  for (const n of hostDeps.notes) log(n)
+
   /**
    * ⚠️ 2026-10-14 事故（第一次挂上就炸了整个 DSH，见当天的 lesson）：
    *   `apply(ctx, config)` 传进来的那个 `config`，字段值**不保证是标量** —— 我们的 `config.pythonPath`
@@ -175,6 +200,9 @@ export function apply(ctx, config) {
       command: cfg.pythonPath || 'python',
       args: [script],
       cwd: stateDir,                     // 凭证落在家里 ✓
+      // ⭐ 这个内置的 Python MCP 会往 stdout 打中文（ensure_ascii=False）；
+      //    Windows 默认 GBK 的话，中文/emoji 一进管道就可能炸 ⇒ 钉死 UTF-8
+      env: pyEnv(),
       log,
     })
     return mcp
@@ -458,7 +486,14 @@ export function apply(ctx, config) {
           ? `这一轮不要写日报文件，也别生成任何报告；只有真发了评论就一句话记下。`
           : `把报告写到 ${join(outDir, `${dayKey()}.md`)}。`)
       + `今天最多挑 ${cfg.perDay} 条；关键词${kws.length ? `用这些：${kws.join('、')}` : '用章程里的默认那几组'}。`
-      + `本地转写是${cfg.transcribe ? '开着的（没字幕就用家目录里的 asr.py 转，命令见章程）' : '关着的（没字幕就跳过）'}；`
+      + `本地转写：${cfg.transcribe
+        ? (asrReadyNow()
+          ? '开着，而且装好了（没字幕的视频用家里那份 asr.py 转，命令见章程）'
+          : '**开着、但依赖没装好** ⇒ 这一轮没字幕的视频只能跳过')
+        : '关着（没字幕的视频就跳过）'}；`
+      + `⭐ 不管哪种情况，**报告里都要写一行「因无字幕跳过 N 条」**（N=0 也写）—— 别让它悄悄少几条。`
+      + `判重表 = ${join(stateDir, 'seen.md')}（**就是这个绝对路径**，别写到家目录 ~、也别写到别处）；`
+      + `⚠️ 它读不出来或写不进去，**必须在报告里明说** —— 那一轮宁可不发评论，也别当成"没有记录"重发一遍。`
       + `自动评论并 @ ${cfg.mentionName || '（还没填要 @ 谁）'} 是${cfg.autoComment && cfg.mentionName
         ? `开着的（每轮最多 ${cfg.commentPerRound} 条评论，每条在正文里纯文本 @ ${cfg.mentionName}，150 字内）`
         : '关着的（只写报告，别发评论）'}。`
@@ -494,6 +529,30 @@ export function apply(ctx, config) {
     try { writeFileSync(file, yml, 'utf8'); return file } catch (e) { log(`写 overlay 失败：${e?.message ?? e}`); return null }
   }
 
+  /**
+   * ⭐ 评论发出后复核（2026-10-16 加的行 —— 起因是用户在评论区反馈
+   *    「**回执成功不等于公开可见，新号会被压审**」）：
+   * 那一轮的 `bili_reply` 回"发送成功"只代表**接口收了**；新号 / 风控会让它进审核，
+   * 那时候连 @ 通知都不会推 ⇒ 插件以为发了、下一轮又不再发 ⇒ **一条都没到人**。
+   * 所以由**宿主**（有网络、有凭证、不受沙箱限制）去拉一次评论列表 / 楼中楼来核。
+   * ⚠️ 措辞守则：看不到写「**没查到**」，**绝不写"没发出去"**（翻页/热度排序都会漏）。
+   */
+  let verifying = false
+  const runVerify = async (why = 'manual') => {
+    if (verifying) return { ok: false, error: '上一次复核还没跑完，等它完事' }
+    verifying = true
+    try {
+      log(`评论复核开始（${why}）`)
+      const r = await verifyRecent(stateDir, { log })
+      const f = appendVerifyToReport(stateDir, r.text)
+      log(`评论复核结束（${why}）：查了 ${r.checked.length} 条${f ? `，已写进 ${f}` : ''}`)
+      return { ok: true, why, checked: r.checked, skipped: r.skipped, text: r.text, report: f || '' }
+    } catch (e) {
+      log(`评论复核失败（${why}）：${e?.message ?? e}`)
+      return { ok: false, why, error: String(e?.message ?? e) }
+    } finally { verifying = false }
+  }
+
   const runDuty = (why = 'window') => {
    try {
     const dsh = resolveDsh()
@@ -513,12 +572,20 @@ export function apply(ctx, config) {
       shell: dsh.shell,
       windowsHide: true,
       stdio: ['ignore', 'pipe', 'pipe'],
-      env: { ...process.env, BILI_DUTY_HOME: stateDir },
+      // ⭐ PYTHONUTF8 / PYTHONIOENCODING：Windows 上 Python 默认按 GBK 编解码，
+      //    中文 / emoji 打进管道会炸（用户反馈过 UnicodeDecodeError），一律按 UTF-8 来
+      env: pyEnv({ BILI_DUTY_HOME: stateDir }),
     })
     const pick = (buf) => appendFileSync(logFile, String(buf), 'utf8')
     child.stdout?.on('data', pick)
     child.stderr?.on('data', pick)
-    child.on('exit', (code) => log(`刷B站结束（${why}，code=${code}）`))
+    child.on('exit', (code) => {
+      log(`刷B站结束（${why}，code=${code}）`)
+      // ⭐ 发完评论之后**过一会儿再核一次**（2026-10-16 加的「评论发出后复核」）：
+      //    接口回"发送成功"≠ 公开可见（新号/风控会进审核）；而"不公开"时连 @ 通知都不会推 ⇒
+      //    插件会以为发了、下一轮不再发 ⇒ 一条都没到人。等 90 秒再查，避免把"还在审核"误判成"没发出去"。
+      setTimeout(() => { Promise.resolve(runVerify('round')).catch((e) => log('复核异常：' + (e?.message ?? e))) }, 90_000)
+    })
     child.on('error', (e) => log(`刷B站起不来：${e?.message ?? e}`))
     return { started: true, why, profile: cfg.headlessProfile, cwd, log: logFile }
    } catch (e) {
@@ -617,7 +684,7 @@ export function apply(ctx, config) {
   const spawnLogged = (cmd, args) => new Promise((resolve) => {
     appendInstall(`\n$ ${cmd} ${args.join(' ')}\n`)
     let c
-    try { c = spawn(cmd, args, { cwd: stateDir, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] }) }
+    try { c = spawn(cmd, args, { cwd: stateDir, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'], env: pyEnv() }) }
     catch (e) { appendInstall(`起不来：${e?.message ?? e}\n`); return resolve(1) }
     const w = (b) => appendInstall(String(b))
     c.stdout?.on('data', w)
@@ -636,6 +703,26 @@ export function apply(ctx, config) {
   //    而沙箱只允许写"该子进程启动前就已存在"的目录（2026-10-14 那一轮自己挖出来的规则）
   const asrTmp = join(stateDir, 'tmp', 'asr')
   try { mkdirSync(asrTmp, { recursive: true }) } catch { /* 建不了也别拦着插件加载 */ }
+
+  // ⭐ 判重表也由**宿主**预先建好（两个原因）：
+  //   ① 那一轮被沙箱关着，"新建文件"会被拒（2026-10-14 那条规矩）；
+  //   ② 它读不出判重表 ⇒ 以为"没记录过" ⇒ 同一批视频反复推送（用户实测反馈 2026-10-16）。
+  const seenFile = join(stateDir, 'seen.md')
+  try {
+    if (!existsSync(seenFile)) {
+      writeFileSync(seenFile, [
+        '# 刷B站 · 判重表（宿主预建，那一轮只往后面追加）',
+        '',
+        '## 评论记录（BV | rpid | root（楼中楼才填） | 时间 | 正文前 20 字）',
+        '',
+        '| BV | rpid | root（楼中楼才填） | 时间 | 正文前 20 字 |',
+        '| --- | --- | --- | --- | --- |',
+        '',
+        '## 看过的视频',
+        '',
+      ].join('\n'), 'utf8')
+    }
+  } catch { /* 建不了也别拦着插件加载 */ }
   let installingAsr = false
 
   /** 找 uv：系统里的 → 插件家里下好的 → 自己下一份（给"两样都没有"的人）；主/转写两套安装共用 */
@@ -655,7 +742,7 @@ export function apply(ctx, config) {
     let c
     try {
       c = spawn(cmd, args, { cwd: stateDir, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'],
-        env: env ? { ...process.env, ...env } : process.env })
+        env: pyEnv(env || {}) })
     } catch (e) { sink(`起不来：${e?.message ?? e}\n`); return resolve(1) }
     const w = (b) => sink(String(b))
     c.stdout?.on('data', w)
@@ -840,6 +927,10 @@ export function apply(ctx, config) {
       return sendJson(res, 200, runAsrInstall())
     }
 
+    // ⭐ 「复核评论」：拿判重表里最近的记录，去 B站 核一遍到底公开可见没有
+    //    （设置页那个按钮、以及每轮结束 90 秒后自动跑一次，都走这里）
+    if (req.method === 'POST' && path === '/api/bili-duty/verify') return sendJson(res, 200, await runVerify('manual'))
+
     // 「看今天的报告」：把报告的文本读出来给设置页显示（浏览器不能直接开本地文件 ✗）
     if (req.method === 'GET' && path === '/api/bili-duty/report') {
       const day = String(url.searchParams.get('day') || dayKey()).replace(/[^0-9-]/g, '') || dayKey()

package/lib/asr.py

@@ -20,6 +20,14 @@ import re
 import sys
 import tempfile
 
+# ⭐ Windows 上 Python 默认按 GBK 编/解码标准输出 —— 中文或 emoji 打进管道会直接炸
+#    （有用户反馈装依赖 / 跑转写时报 UnicodeDecodeError 或乱码）⇒ 这里钉死 UTF-8
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except Exception:
+    pass
+
 # ⚠️ 临时目录必须待在家目录里：值班那一轮跑在沙箱里（只允许写工作区/cwd），
 #    yt-dlp 默认往 %TEMP% 写、会被直接拒掉（2026-10-14 在主人机器上实证：
 #    yt_dlp DownloadError: unable to open for writing: [Errno 13] Permission denied）

package/lib/hostdeps.mjs

@@ -0,0 +1,141 @@
+/**
+ * lib/hostdeps.mjs —— 从宿主那棵树里取 `@deepseek-ai/*`（拿不到就退到"自己的依赖"）
+ * ============================================================================
+ * 🔴 为什么要有它（2026-10-16 一位用户递来的完整报告，本机也复现了）：
+ *   `index.js` 顶部裸 import `@deepseek-ai/schemastery` 和 `@deepseek-ai/dsh-tools`，
+ *   而它们在 package.json 里是 **optional peer** ⇒ 桌面版 profile（`autoInstallPeers: false`）
+ *   **永远不装它们** ⇒ 插件整条不激活，DSH 只留一句
+ *   `warning: 1 entry did not activate … failed to import` ✓
+ *   （web profile 上之所以一直没事，是因为 profile 树里恰好有别的插件把它们 hoist 上来了 —— 这是运气 ✗）
+ *   ⚠️ `dsh-tools` 自己还有 7 个顶层 import、其中 4 个是 peer ⇒ 光把它装上也救不回来 ✗。
+ *
+ * ⭐ 策略（两条一起走）：
+ *   ① **优先从宿主那棵树里解析**（跟宿主用同一份，行为最一致）；
+ *   ② 解析不到就 **bare import**（靠我们自己 package.json 的 `dependencies` 装一份保底）；
+ *   ③ `schemastery` 彻底拿不到 ⇒ 返回 null，**插件照常加载**（只是没有 Config、设置页降级）——
+ *      **绝不因为一个 import 就让整条插件不激活** ✗✓。
+ * ============================================================================
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+/** 插件自己那棵树（`dependencies` 装出来的那份）—— 用模块位置算，别依赖 cwd */
+const SELF_MODULES = join(dirname(fileURLToPath(import.meta.url)), '..', 'node_modules', '@deepseek-ai')
+
+/** 可能藏着宿主 `@deepseek-ai` 包的地方（不写死某一台机器，按可能性排序） */
+export function candidateRoots() {
+  const out = []
+  const push = (p) => { if (p && !out.includes(p)) out.push(p) }
+  push(process.env.DSH_HOST_MODULES)
+
+  const appdata = process.env.APPDATA
+  if (appdata) {
+    const npm = join(appdata, 'npm', 'node_modules')
+    push(join(npm, '@deepseek-ai', 'dsh', 'node_modules', '@deepseek-ai'))
+    push(join(npm, '@deepseek-ai'))
+    // 桌面版可能叫别的包名（dsh-desktop / dsh-next…）⇒ 逐个看它们的 node_modules
+    try {
+      for (const n of readdirSync(join(npm, '@deepseek-ai'))) {
+        push(join(npm, '@deepseek-ai', n, 'node_modules', '@deepseek-ai'))
+      }
+    } catch { /* 没有就算了 */ }
+  }
+  push('/usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai')
+  push('/usr/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai')
+  push('/usr/local/lib/node_modules/@deepseek-ai')
+  push('/usr/lib/node_modules/@deepseek-ai')
+
+  // profile 树：有些机器上这些包是被别的插件 hoist 到 profile 根上的
+  try {
+    const dshHome = process.env.DSH_HOME || join(homedir(), '.dsh')
+    for (const p of readdirSync(join(dshHome, 'profiles'))) {
+      push(join(dshHome, 'profiles', p, 'node_modules', '@deepseek-ai'))
+    }
+  } catch { /* 没有就算了 */ }
+
+  // 插件自己那份（package.json 的 dependencies 装出来的）—— 放最后，前面优先"跟宿主同一份"
+  push(SELF_MODULES)
+  return out
+}
+
+/** 按包的 exports['.'] 找入口文件，返回 file:// URL */
+function entryUrlFor(root, name) {
+  try {
+    const dir = join(root, name)
+    const pkgFile = join(dir, 'package.json')
+    if (!existsSync(pkgFile)) return null
+    const pkg = JSON.parse(readFileSync(pkgFile, 'utf8'))
+    const dot = pkg.exports?.['.']
+    const rel = typeof dot === 'string'
+      ? dot
+      : (dot?.import || dot?.default || pkg.module || pkg.main)
+    if (!rel) return null
+    const file = join(dir, String(rel).replace(/^\.\//, ''))
+    return existsSync(file) ? pathToFileURL(file).href : null
+  } catch { return null }
+}
+
+/** 试从宿主树里 import 一个包；拿不到返回 null（失败原因写进 notes，方便远程排查） */
+async function fromHostTree(name, log) {
+  const fails = []
+  for (const root of candidateRoots()) {
+    if (root === SELF_MODULES) continue          // 自己那份交给下面的 bare import 处理
+    const url = entryUrlFor(root, name)
+    if (!url) continue
+    try {
+      const mod = await import(url)
+      log(`${name}：从宿主树取到（${url.replace(/^file:\/\/\//, '')}）`)
+      return mod
+    } catch (e) { fails.push(`${e?.code || 'ERR'}:${root}`) }
+  }
+  if (fails.length) log(`${name}：宿主树里都不行（${fails.slice(0, 3).join(' ')}）`)
+  return null
+}
+
+/** 兜底：这是**我们自己的等价实现**，只在拿不到宿主的 dsh-tools 时用 */
+function localDefineTool(options, log) {
+  // 宿主的 defineTool 会做 spec→JSONSchema 转换 + 参数校验；我们的 parameters / output.schema
+  // **本来就是标准 JSON Schema**（2026-10-14 那次 additionalProperties 报错就是被它校验出来的），
+  // 所以这里只补一条同样的校验，别的原样返回。
+  const check = (schema, where) => {
+    if (!schema || typeof schema !== 'object') return
+    if (schema.type === 'object' && schema.additionalProperties === undefined) {
+      throw new Error(`defineTool(${options.name}): ${where} 是 object 却没写 additionalProperties`)
+    }
+    for (const [k, v] of Object.entries(schema.properties || {})) check(v, `${where}.properties.${k}`)
+  }
+  check(options.parameters, 'parameters')
+  check(options.output?.schema, 'output.schema')
+  log?.(`dsh-tools 拿不到 —— 用本地等价实现顶上了（工具 ${options.name}）`)
+  return options
+}
+
+/**
+ * 取回宿主半端要用的一点点东西
+ * @returns {Promise<{z:any, defineTool:Function|null, notes:string[]}>}
+ */
+export async function loadHostDeps() {
+  const notes = []
+  const log = (m) => notes.push(m)
+
+  // ① schemastery（Config 要用；宿主设置层要用**它自己那份**读 volatile 字段）
+  let zMod = await fromHostTree('schemastery', log)
+  if (!zMod) {
+    try { zMod = await import('@deepseek-ai/schemastery'); log('schemastery：宿主树里没有，用自己依赖里那份') }
+    catch (e) { log(`⚠️ schemastery 彻底拿不到（${e?.code || ''} ${String(e?.message || '').slice(0, 120)}）—— 这一份插件没有 Config，设置页会降级（插件本体照常跑）`) }
+  }
+  const z = zMod?.default ?? zMod ?? null
+
+  // ② dsh-tools 的 defineTool（拿不到就用本地等价实现 —— 这是本次桌面版修复的关键一步）
+  let defineTool = null
+  let dtMod = await fromHostTree('dsh-tools', log)
+  if (!dtMod) {
+    try { dtMod = await import('@deepseek-ai/dsh-tools'); log('dsh-tools：宿主树里没有，用自己依赖里那份') }
+    catch (e) { log(`dsh-tools 拿不到（${e?.code || ''}）—— 用本地等价实现顶上`); dtMod = null }
+  }
+  defineTool = dtMod?.defineTool || ((options) => localDefineTool(options, log))
+
+  return { z, defineTool, notes }
+}

package/lib/verify.mjs

@@ -0,0 +1,186 @@
+/**
+ * lib/verify.mjs —— 「评论发出后复核」
+ * ============================================================================
+ * 为什么要有它（2026-10-16，用户 `你的deepseek` 在评论区反馈 + 我们 10/10 亲踩）：
+ *   **接口回「发送成功」≠ 公开可见** —— 新号 / 风控会让评论进审核，你自己看不见，
+ *   而插件以为发出去了、还把它记进判重表 ⇒ 下一轮不再发 ⇒ **一条都没到人**。
+ *   还有更坏的一层：**不公开时连通知都不会推**，于是"@ 了但没人收到"。
+ *
+ * 复核靠两条只读接口（2026-10-16 实测可行）：
+ *   ① **顶层评论**：`/x/v2/reply/main?type=1&oid=<aid>&mode=2&next=0&ps=20`（按时间）
+ *      —— 刚发出来的通常在**第一页**；找得到 ⇒ 公开可见（还能顺便读到赞数）。
+ *   ② **楼中楼**：`/x/v2/reply/reply?type=1&oid=<aid>&root=<root>&ps=20`
+ *      —— 直接按 root 拉那一串，找我们的 rpid。
+ *   ⚠️ **看不到 ≠ 没发出**（翻页 / 热度排序都会漏）⇒ 结论一律用"**没查到**"这种说法，
+ *      不写成"没发出去"（这是 2026-10-15 那条教训的同一把尺子）。
+ *   ✗ `/x/v2/reply/detail` 走不通（回 `-400 请求错误`），别无谓地换它。
+ * ============================================================================
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { dayKey } from './state.mjs'
+
+const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/124.0 Safari/537.36'
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+/** 从判重表里抠出「我们发过的评论」记录：容忍 markdown 表格 / 列表 / 随手写的行 */
+export function parseSeen(text) {
+  const rows = []
+  for (const line of String(text).split(/\r?\n/)) {
+    const bv = /BV[0-9A-Za-z]{10}/.exec(line)
+    if (!bv) continue
+    const nums = [...line.matchAll(/\b(\d{9,})\b/g)].map((m) => Number(m[1]))
+    if (!nums.length) continue
+    // 约定：第一个长数字 = rpid；如果后面还有第二个，且明显是另一个 id，就当 root（楼中楼）
+    const rpid = nums[0]
+    const root = nums.length > 1 ? nums[1] : 0
+    rows.push({ bv: bv[0], rpid, root, line: line.trim().slice(0, 160) })
+  }
+  return rows
+}
+
+export function loadCredential(stateDir) {
+  const f = join(stateDir, 'bili_credential.json')
+  if (!existsSync(f)) return null
+  try {
+    const c = JSON.parse(readFileSync(f, 'utf8'))
+    if (!c?.sessdata) return null
+    return c
+  } catch { return null }
+}
+
+function headersFor(cred) {
+  return {
+    'User-Agent': UA,
+    Referer: 'https://www.bilibili.com/',
+    Cookie: `SESSDATA=${cred.sessdata}; bili_jct=${cred.bili_jct}; buvid3=${cred.buvid3}`,
+  }
+}
+
+async function jget(url, headers) {
+  try {
+    const r = await fetch(url, { headers })
+    const t = await r.text()
+    try { return JSON.parse(t) } catch { return { code: -999, message: 'not json' } }
+  } catch (e) { return { code: -998, message: String(e?.message ?? e) } }
+}
+
+/** 我们自己的 mid（从凭证里读；读不到就退化成"看名字对不对"） */
+function ourMid(cred) {
+  const v = String(cred?.dedeuserid || cred?.DedeUserID || '')
+  return /^\d+$/.test(v) ? Number(v) : 0
+}
+
+/**
+ * 复核一条：先试顶层（按时间第一页），再试楼中楼（如果记了 root）
+ * @returns {{rpid:number, bv:string, visible:boolean|null, likes?:number, how:string, note:string}}
+ */
+export async function verifyOne(record, { cred, aidCache = new Map(), headers }) {
+  const out = { rpid: record.rpid, bv: record.bv, visible: null, how: '', note: '' }
+  if (!aidCache.has(record.bv)) {
+    const v = await jget(`https://api.bilibili.com/x/web-interface/view?bvid=${record.bv}`, headers)
+    aidCache.set(record.bv, v?.code === 0 ? { aid: v.data.aid, mid: v.data.owner?.mid, title: v.data.title } : null)
+    await sleep(300)
+  }
+  const meta = aidCache.get(record.bv)
+  if (!meta) { out.how = '取视频信息失败'; out.note = '这条跳过（视频可能已删/不可见）'; return out }
+  const aid = meta.aid
+  const mine = ourMid(cred)
+
+  // ① 顶层：按时间第一页（刚发的就在这儿）
+  if (!record.root) {
+    const d = await jget(`https://api.bilibili.com/x/v2/reply/main?type=1&oid=${aid}&mode=2&next=0&ps=20`, headers)
+    const list = d?.data?.replies || []
+    const hit = list.find((r) => r.rpid === record.rpid) || (mine ? list.find((r) => r.mid === mine) : null)
+    if (hit && hit.rpid === record.rpid) {
+      out.visible = true; out.likes = hit.like; out.how = '顶层·最新一页'
+      out.note = hit.invisible ? '（但接口标了 invisible）' : ''
+      return out
+    }
+    out.how = '顶层·最新一页'
+    out.note = '最新一页里没找到 —— 可能还在审核，也可能只是翻页看不到（**不等于没发出去**）'
+    return out
+  }
+
+  // ② 楼中楼：按 root 拉那一串
+  const d = await jget(`https://api.bilibili.com/x/v2/reply/reply?type=1&oid=${aid}&root=${record.root}&ps=20&pn=1`, headers)
+  const subs = d?.data?.replies || []
+  const hit = subs.find((r) => r.rpid === record.rpid)
+  if (hit) {
+    out.visible = true; out.likes = hit.like; out.how = `楼中楼·root=${record.root}`
+    out.note = hit.invisible ? '（但接口标了 invisible）' : ''
+    return out
+  }
+  out.how = `楼中楼·root=${record.root}`
+  out.note = subs.length
+    ? `那一串里有 ${subs.length} 条，但没有我们这条 —— 可能还在审核（**不等于没发出去**）`
+    : '那一串暂时拉不到内容 —— 可能还在审核（**不等于没发出去**）'
+  return out
+}
+
+/**
+ * 复核最近的一批（默认最多 6 条、只挑没复核过的）
+ * @returns {Promise<{checked:Array, skipped:number, text:string}>}
+ */
+export async function verifyRecent(stateDir, { max = 6, log = () => {} } = {}) {
+  const seenFile = join(stateDir, 'seen.md')
+  if (!existsSync(seenFile)) return { checked: [], skipped: 0, text: '⚠️ 判重表还没生成，没什么可复核的' }
+  const cred = loadCredential(stateDir)
+  if (!cred) return { checked: [], skipped: 0, text: '⚠️ 还没扫码登录，没法复核（复核要用你自己的登录态）' }
+
+  const rows = parseSeen(readFileSync(seenFile, 'utf8'))
+  if (!rows.length) return { checked: [], skipped: 0, text: '判重表里还没有「我们发过的评论」记录' }
+
+  // 状态账本：已经确认真见过的，7 天内不重复查
+  const stateFile = join(stateDir, 'verify-state.json')
+  let state = {}
+  try { state = JSON.parse(readFileSync(stateFile, 'utf8')) } catch { /* 头一次跑 */ }
+  const now = Date.now()
+  const fresh = []
+  let skipped = 0
+  for (const r of rows.slice().reverse()) {          // 从最新的往回看
+    const prev = state[String(r.rpid)]
+    if (prev?.visible === true && now - (prev.at || 0) < 7 * 864e5) { skipped++; continue }
+    fresh.push(r)
+    if (fresh.length >= max) break
+  }
+  if (!fresh.length) return { checked: [], skipped, text: `都复核过了（跳过的旧记录 ${skipped} 条）` }
+
+  const headers = headersFor(cred)
+  const aidCache = new Map()
+  const checked = []
+  for (const r of fresh) {
+    const res = await verifyOne(r, { cred, aidCache, headers })
+    checked.push(res)
+    state[String(r.rpid)] = { visible: res.visible, at: now, how: res.how, bv: r.bv, likes: res.likes ?? null }
+    log(`复核 ${r.bv} rpid=${r.rpid} → ${res.visible === true ? '公开可见' : '没查到'}（${res.how}）`)
+    await sleep(700)
+  }
+  try { writeFileSync(stateFile, JSON.stringify(state, null, 2), 'utf8') } catch { /* 写不了就算了，复核不该因此失败 */ }
+
+  const lines = ['', '## 评论复核（宿主自动跑的，不是那一轮自己说的）', '']
+  for (const c of checked) {
+    const t = c.visible === true ? `公开可见（赞 ${c.likes ?? 0}）` : '没查到'
+    lines.push(`- \`${c.bv}\` rpid **${c.rpid}** —— ${t} · 依据：${c.how}${c.note ? ' · ' + c.note : ''}`)
+  }
+  if (skipped) lines.push(`- （另外 ${skipped} 条最近已复核过，没重复查）`)
+  const text = lines.join('\n')
+  return { checked, skipped, text }
+}
+
+/** 把复核结果追加到当天的报告末尾（报告可能还不存在 —— 那就别硬造一份） */
+export function appendVerifyToReport(stateDir, text) {
+  try {
+    const f = join(stateDir, 'out', `${dayKey()}.md`)
+    if (!existsSync(f)) return null
+    writeFileSync(f, readFileSync(f, 'utf8').replace(/\s*$/, '') + '\n' + text + '\n', 'utf8')
+    return f
+  } catch { return null }
+}
+
+// ── 单独跑：node lib/verify.mjs <stateDir>（方便手工验 / 也方便我测） ──
+if (process.argv[1] && /verify\.mjs$/.test(process.argv[1])) {
+  const dir = process.argv[2] || join(process.env.DSH_HOME || join(process.env.USERPROFILE || '.', '.dsh'), 'bili-duty')
+  const r = await verifyRecent(dir, { log: (m) => console.log('  ' + m) })
+  console.log(r.text)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bili-scroll",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "DSH 插件：每天替你刷一轮 B站 —— 读字幕挑出值得的、写一份日报，值得的就 @ 你",
   "keywords": [
     "dsh",
@@ -41,6 +41,9 @@
     "@deepseek-ai/dsh-tools": "*",
     "@deepseek-ai/schemastery": "*"
   },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-llm": {
       "optional": true

package/prompts/duty.md

@@ -27,6 +27,8 @@
   **每轮最多回它说的那个条数**，回完把内容记进报告。
 - ⭐ **发完评论，把「视频 BV 号 + 评论 rpid + 时间 + 正文前 20 字」一起记进判重表的「评论记录」**
   —— 有了 rpid，下一轮就能**直接定位到那条评论**，不用在几百条评论里翻。
+  ⭐ **如果发的是"回复别人"（楼中楼），还要把它回复的那条根评论的 rpid 记在同一行**（写在 rpid 后面）
+  —— 宿主会拿这两个号去 B站 复核"到底公开可见没有"，缺了 root 就核不了楼层里的那条。
 - ⭐ **要回评论时，先看判重表的「评论记录」** —— 那里记着它自己在哪几个视频发过评论、发了什么；
   ⚠️ **查的范围别太窄**：把判重表里**最近 7 天内自己发过的评论都过一遍**（漏掉一条，那个人就永远收不到回复 ✗）；
   实在太多就按时间**从新到旧**挑最近 **5～8 条**。找不到就跳过，别硬找、别硬凑。
@@ -45,7 +47,10 @@
 
 1. **搜一轮**（近 7 天优先）：用**设置页里填的「关注关键词」**；没填就用默认这几组 ——
    `DeepSeek Harness`、`DSH 插件`、`dsh 教程`、`meow-memory`、`DeepSeek Harness 桌面端`
-2. 从结果里挑出**值得的**，条数看设置页的「定量刷（每天几条）」；**判重** —— 已经看过的跳过（判重表就在家目录根下，叫 `seen.md`）
+2. 从结果里挑出**值得的**，条数看设置页的「定量刷（每天几条）」；**判重** —— 已经看过的跳过。
+   ⭐ **判重表的绝对路径以这一轮开头告诉你的为准**（通常是 `<家目录>/seen.md`，就是插件数据目录里那个）。
+   ⚠️ **如果那份判重表读不出来（不存在 / 打不开）**：**不要当成"没记录过"** —— 那会让同一批视频反复推送、
+   重复打扰一批人。正确做法是：**在报告里明写"判重表读不到"**，而且**这一轮不发评论**（宁可少发）。
 3. 每条：
    - **读字幕原文**（⚠️ 别看摘要下判断）
    - 没有字幕时：**只有**设置里开了「本地转写」才去转写；没开就跳过、别硬凑。
@@ -53,6 +58,8 @@
   · Windows：`<家目录>\.venv-asr\Scripts\python.exe <家目录>\asr.py <BV号>`
   · macOS/Linux：`<家目录>/.venv-asr/bin/python <家目录>/asr.py <BV号>`
   它会把字幕打到标准输出（第一次调用要加载模型，慢几十秒正常）。
+   ⚠️ **转写没装好（开头会告诉你）、或者你选择了不开转写时**：没字幕的视频只能跳过 ——
+   但**必须在报告里写一行「因无字幕跳过 N 条」**，别让它悄悄少几条（用户看不到"漏了什么"就以为全看过了）。
    - 顺手翻一眼评论
 4. 写一份 Markdown 报告，每条一段：
    **标题 / UP / 链接 / 播放量 / 为什么值得（两三句）/ 你自己的一句话**，结尾给一句总结
@@ -78,7 +85,8 @@
 ## 产物
 
 - 报告写到插件的 `out/<YYYY-MM-DD>.md`
-- 跑过的每一条记进判重表；日志留在插件数据目录
+- 跑过的每一条记进判重表（**路径以开头给的为准，写不进去要在报告里明说**）；日志留在插件数据目录
+- ⭐ 报告末尾顺带一行：**「因无字幕跳过 N 条」**（N=0 也写）—— 让人一眼知道这轮有没有漏
 
 ## 关于你自己