dsh-bili-scroll 0.1.0 → 0.1.1

package/AGENTS.md

@@ -0,0 +1,30 @@
+# 给 AI 助手看的（本仓库 = 一个 DSH 插件）
+
+`dsh-bili-scroll`（中文名「**刷B站**」）：每天替用户刷一轮 B 站 —— 搜、**读字幕原文**判断、写一份日报，特别值得的会发一条评论 **@ 用户**。
+
+## 帮用户安装时，按这个顺序
+
+1. **前提**：机器上有 `Python 3.10+` **或** `uv`（有一个即可）。
+   两个都没有**也不用让用户先装** —— 插件点「装依赖」时会**自己下一份 `uv` 到自己的家目录**（免管理员、不用 PATH）；
+   只有它自己也下不动时（网络到不了 GitHub / 加速代理 / PyPI 镜像），才需要引导用户手动装。
+   · 它是**直连 GitHub → 国内加速代理 → PyPI 镜像**依次试的，并且会**核对官方 sha256** ✓
+   · ⚠️ 若用户机器上的**杀软拦了这次下载**：让他把 `%USERPROFILE%\.dsh\bili-duty\bin\` 加白，或干脆自己装 uv / Python 3.10+ ✓
+2. `dsh plugin --profile web add github:c1overzz/dsh-bili-scroll`
+   （npm 的 `dsh-bili-scroll` 同内容；审核通过后用它更省事）
+3. ⚠️ **提醒用户重启一次 dsh**（必须，bundle 层要重启才组装）。
+4. 让用户进 **设置 → 刷B站**：点「**装依赖**」→ 点「**扫码登录**」（手机扫码，选"记住我 / 长期"）。
+5. **别擅自打开「自动评论并 @ 你」** —— 那是拿用户的号说话；要用得让用户自己填「要 @ 谁」。
+
+## 仓库结构（改代码时看这里）
+
+- `index.js` —— host 半端：11 个工具 + 谷时定时器 + HTTP 接口 + 设置命名空间
+- `client.js` —— 浏览器半端：设置页（注册在 `settings.section`）
+- `lib/` —— 状态目录与家目录 / 极小的 MCP stdio 客户端 / 扫码登录
+- `prompts/duty.md` —— 一轮要做的事（判定口径 + 红线，**用户可以改**）
+- `vendor/bilibili-mcp/` —— 内置的 Python MCP（MIT，AGI_Ananas）
+- `selfcheck.mjs` + `tools/` —— 本地预检：`node --import ./tools/register.mjs selfcheck.mjs`
+
+## 约定
+
+- 配置与运行数据都在用户的 `$DSH_HOME/bili-duty/`，**不写进插件包目录**
+- 谷时窗口按 DeepSeek 官方口径：工作日 9–12 / 14–18 是高峰，其余（含周末）都是谷时

package/README.md

@@ -1,5 +1,10 @@
 # dsh-bili-scroll ｜ 刷B站
 
+> **先看三行**
+> - 需要 **dsh ≥ `0.1.7-rc.1`**（本机是 `0.1.7-rc.2`）。⚠️ 版本不满足时，**内核会静默跳过这个插件** —— 装了跟没装一样，不会报错。
+> - **空间**：不装「本地转写」约 **84 MB**；装了转写约 **1 GB**（其中 Whisper 模型 538 MB，可在设置里换更小的模型）。
+> - 装完**必须重启一次** dsh（插件在 bundle 层组装）。
+
 > DSH 插件：**每天替你刷一轮 B站** —— 它自己搜、**读字幕原文**判断、把值得的写成报告，特别值得的会留一条评论 **@ 你**。
 > **你收到的每一条 @，都是它先筛过一遍的。**
 
@@ -11,8 +16,24 @@
 - 开着「自动评论」时，每轮最多发一条评论、**@ 你**一次
 - 可以在**峰谷时段自动跑**（DeepSeek 的优惠时段），省 token
 
+## 装之前（一条前提，30 秒）
+
+机器上要有 **`Python 3.10+` 或 `uv`** —— **有一个就够**：
+
+- **有 `uv` 最好**：单个 ~32 MB 的 exe，**解压就能用、不用管理员、不用进 PATH**，而且它还能自己把 Python 拉下来；
+- 只有 Python 也行（装官方安装器时记得勾 **`Add to PATH`**）；
+- ⭐ **两个都没有？也没关系**：点「装依赖」时**插件会自己下一份 `uv` 放到自己的家目录**
+  （单文件、约 15MB、**免管理员、不用进 PATH** ✓），之后全程自动 ✓
+  · 它会**先直连 GitHub，不通就走国内加速代理**，还配了 PyPI 镜像兜底 ✓
+  · 下载完会**核对官方 `sha256`**（对不上就丢弃换下一个源 ✓）—— 因为它下来的东西是要**被执行**的
+  · ⚠️ **如果杀软 / Windows Defender 报这个下载**：把插件家目录 `%USERPROFILE%\.dsh\bili-duty\bin\` **加白**即可；
+    不想加白也行，自己装一份 uv 或 Python 3.10+ 就绕过去了 ✓
+
+> 计划中（v0.1.1）：**插件自己把 `uv` 下到自己的家目录** ⇒ 做到"一键准备环境"，这条前提就不用用户操心了。
+
 ## 装
 
+
 ```bash
 dsh plugin --profile web add dsh-bili-duty     # 从 npm
 ```
@@ -52,6 +73,19 @@ dsh plugin --profile web add dsh-bili-duty     # 从 npm
 - 那一轮的**工作目录 = 你填的工作区** ⇒ 那里的 `AGENTS.md` 会自动加载 ⇒ **它按你的设定说话**，
   而不是用一套通用人格
 
+## 如果你是一个 AI 助手，正在帮用户装这个插件
+
+按顺序来，别跳步：
+
+1. **先确认前提**：机器上有 `Python 3.10+` 或 `uv` 吗？（查 `python --version` / `uv --version`）
+   两个都没有 ⇒ **建议装 `uv`**（单文件 exe、免管理员、能自带 Python）；
+2. **装插件**：`dsh plugin --profile web add github:c1overzz/dsh-bili-scroll`
+   （npm 上的 `dsh-bili-scroll` 同名同内容，审核通过后用 `add dsh-bili-scroll` 更省事）
+3. ⚠️ **必须提醒用户重启一次 dsh** —— bundle 层要重启才组装，不重启插件不会生效；
+4. 重启后请用户进 **设置 → 刷B站**：先点「**装依赖**」（几十秒，进度就显示在页面下面）、再点「**扫码登录**」
+   （手机 B 站扫码，**确认时选"记住我 / 长期"**）；
+5. **不要**替用户打开「自动评论并 @ 你」—— 那是拿用户的号说话。要用得让用户自己在设置里填「要 @ 谁」。
+
 ## 依赖与致谢
 
 - 内置 [**bilibili-mcp**](https://github.com/adoresever/bilibili-mcp)（MIT，Copyright (c) 2026 AGI_Ananas）——

package/client.js

@@ -140,6 +140,7 @@ window.__ModuleLoader__.load({
       const [perRound, setPerRound] = React.useState(null)
       const [mention, setMention] = React.useState(null)
       const [login, setLogin] = React.useState(null)
+      const [runNote, setRunNote] = React.useState(null)   // 顶部那行状态（跑一轮/装依赖的反馈原来在最底下，看不见）
       const [loginState, setLoginState] = React.useState('')
       const [loginTone, setLoginTone] = React.useState('')
 
@@ -154,7 +155,10 @@ window.__ModuleLoader__.load({
 
       const win = { ...DEFAULT_WINDOWS, ...(st?.windows || {}) }
 
-      const say = (text, tone) => { setMsg(text); setMsgTone(tone || '') }
+      const say = (text, tone) => {
+        setMsg(text); setMsgTone(tone || '')
+        setRunNote(text ? { t: text, tone: tone || '' } : null)   // ⭐ 同时镜像到顶部，免得提示掉到页面最底下看不见
+      }
 
       const patch = async (p, what) => {
         setBusy(JSON.stringify(p))
@@ -166,6 +170,26 @@ window.__ModuleLoader__.load({
         finally { setBusy('') }
       }
 
+      const onCheck = async () => {
+        setBusy('check')
+        say('')
+        try {
+          const r = await jpost('/check', {})
+          if (r && r.ok) say('能用！' + (r.steps || []).join('、'))
+          else say('还不能用：' + (r && r.error ? r.error : '没拿到结果'))
+        } catch (e) { say(String(e?.message ?? e), 'warn') } finally { setBusy('') }
+      }
+
+      const onInstallAsr = async () => {
+        setBusy('asr')
+        say('')
+        try {
+          const r = await jpost('/install-asr', {})
+          say(r?.started ? '开始装转写依赖 —— 进度显示在下面（要下模型，慢一点正常）' : (r?.hint || '没起来'),
+            r?.started ? 'good' : 'warn')
+        } catch (e) { say(String(e?.message ?? e), 'warn') } finally { setBusy('') }
+      }
+
       const onInstall = async () => {
         setBusy('install')
         say('')
@@ -230,10 +254,12 @@ window.__ModuleLoader__.load({
         /* ── 今天 ── */
         h('div', { 'data-bd-row': '' },
           h('span', { 'data-bd-badge': '' }, `今天已挑 ${st.ranToday} / ${cfg.perDay} 条`),
-          h('span', { 'data-bd-badge': '' }, `venv ${st.venvReady ? '就绪' : '未装'}${st.installing ? '（正在装）' : ''}`),
+          h('span', { 'data-bd-badge': '' }, '环境' + (st.venvReady ? '已就绪' : (st.installing ? '正在装' : '未装'))),
           h('span', { 'data-bd-badge': '' }, st.loggedIn ? 'B站已登录' : 'B站未登录'),
           h('div', { 'data-bd-grow': '' }),
           h('button', { 'data-bd-btn': '', disabled: busy === 'run', onClick: onRun }, '现在跑一轮')),
+          runNote ? h('div', { 'data-bd-msg': '', 'data-good': runNote.tone === 'good' ? '' : undefined,
+            'data-warn': runNote.tone === 'warn' ? '' : undefined }, runNote.t) : null,
 
         /* ── 定时 ── */
         h('div', { 'data-bd-sec': '' },
@@ -298,10 +324,24 @@ window.__ModuleLoader__.load({
             h('div', { 'data-bd-note': '' }, '留空的话它就不发评论了 —— 因为评论存在的意义就是 @ 那一下')) : null,
           h(ToggleRow, {
             label: '本地转写没字幕的视频',
-            note: '要在本机装 Whisper、下几百 MB 模型；默认关，没字幕的直接跳过',
+            note: '默认关；开了以后，没字幕的视频会在本机转写一遍（不花 API 钱）',
             on: sw('transcribe'),
             onChange: (v) => patch({ transcribe: v }, '本地转写'),
-          })),
+          }),
+          sw('transcribe') ? h('div', { 'data-bd-sub': '' },
+            h('div', { 'data-bd-row': '' },
+              h('button', { 'data-bd-btn': '', disabled: busy === 'asr', onClick: onInstallAsr },
+                st.asrReady ? '重装转写依赖' : '装转写依赖'),
+              h('div', { 'data-bd-note': '' },
+                !st.asrReady ? '还没装 —— 没装的话转写用不了'
+                  : (st.asrModelReady ? '环境和模型都好了' : '环境好了；模型会在第一次转写时自动下（几百 MB）'))),
+            h('div', { 'data-bd-note': '' },
+              '点一下就好：建一个独立环境、装 faster-whisper + yt-dlp，并把 Whisper 模型也下好',
+              h('br'),
+              '（模型默认 small，几百 MB，走国内镜像；装一次就够了）'),
+            st.asrTail ? h('div', null,
+              h('div', { 'data-bd-note': '' }, st.asrInstalling ? '正在装转写依赖（进度）：' : '转写依赖的日志（末尾）—— 只有「没字幕的视频」用得到它：'),
+              h('pre', { 'data-bd-pre': '' }, st.asrTail)) : null) : null),
 
         /* ── 关注什么 / 在哪儿刷 ── */
         h('div', { 'data-bd-sec': '' },
@@ -324,12 +364,15 @@ window.__ModuleLoader__.load({
           h('div', { 'data-bd-h': '' }, '环境与账号'),
           h('div', { 'data-bd-row': '' },
             h('button', { 'data-bd-btn': '', disabled: busy === 'install', onClick: onInstall },
-              st.venvReady ? '重装依赖' : '装依赖（建 venv）'),
+              st.venvReady ? '重装主依赖' : '装主依赖（建 venv）'),
+            h('button', { 'data-bd-btn': '', disabled: busy === 'check', onClick: onCheck }, '测一下'),
             h('button', { 'data-bd-btn': '', disabled: busy === 'login', onClick: onLoginStart }, '扫码登录'),
-            h('div', { 'data-bd-note': '' }, st.loggedIn ? '已登录' : '还没登录 B站')),
+            h('div', { 'data-bd-note': '' },
+              !st.venvReady ? (st.installFailed ? '上次没装成 → 看下面日志' : '还没装 → 先点「装主依赖」')
+                : (st.loggedIn ? '装好了 → 下一步「扫码登录」' : '环境好了 → 点「扫码登录」'))),
           loginState ? h('div', { 'data-bd-msg': '', 'data-good': loginTone === 'good' ? '' : undefined, 'data-warn': loginTone === 'warn' ? '' : undefined }, loginState) : null,
           st.installTail ? h('div', null,
-            h('div', { 'data-bd-note': '' }, st.installing ? '正在装依赖（进度）：' : '装依赖的日志（末尾）：'),
+            h('div', { 'data-bd-note': '' }, st.installing ? '正在装主依赖（进度）：' : '主依赖的日志（B站 搜索 / 字幕 / 评论 用得到，末尾）：'),
             h('pre', { 'data-bd-pre': '' }, st.installTail)) : null,
           login?.qr ? h('div', { 'data-bd-qr': '' },
             h('img', { src: login.qr, alt: 'B站登录二维码' }),

package/index.js

@@ -23,6 +23,7 @@ import { fileURLToPath } from 'node:url'
 import { McpClient } from './lib/mcp.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'
 
 export const name = 'bili-scroll'
 export const inject = ['webServer', 'tools', 'settings']
@@ -45,6 +46,8 @@ export const Config = z.object({
   autoComment: z.boolean().default(false).extra('volatile', true),
   /** 本地转写（没字幕的视频用 Whisper 转；默认关，要下模型） */
   transcribe: z.boolean().default(false).extra('volatile', true),
+  /** 本地转写用哪个 Whisper 模型（tiny / base / small / medium） */
+  asrModel: z.string().default('small').extra('volatile', true),
   /** ⭐ 每轮最多发几条评论（每条里 @ 一次下面那个人） */
   commentPerRound: z.natural().default(1).extra('volatile', true),
   /** ⭐ 要 @ 谁（B站 昵称）；**留空 = 不发评论** —— 评论存在的意义就是 @ 那一下 */
@@ -88,7 +91,7 @@ export function apply(ctx, config) {
    *     ② **定时器回调里绝不让异常外冒**（见 tick）—— 未捕获异常会杀掉整个宿主进程。
    */
   const DEFAULTS = {
-    perDay: 5, peakValley: false, noon: true, night: true, autoComment: false, transcribe: false,
+    perDay: 5, peakValley: false, noon: true, night: true, autoComment: false, transcribe: false, asrModel: 'small',
     keywords: [], commentPerRound: 1, mentionName: '', pythonPath: 'python', dshBin: '', headlessProfile: 'headless', overlayMcp: true, workspace: '',
   }
   const normalize = (src, base) => {
@@ -393,7 +396,7 @@ export function apply(ctx, config) {
       + `然后读章程 ${duty}，按里面的要求刷一轮 B站，`
       + `把报告写到 ${join(outDir, `${dayKey()}.md`)}。`
       + `今天最多挑 ${cfg.perDay} 条；关键词${kws.length ? `用这些：${kws.join('、')}` : '用章程里的默认那几组'}。`
-      + `本地转写是${cfg.transcribe ? '开着的（没字幕可以转）' : '关着的（没字幕就跳过）'}；`
+      + `本地转写是${cfg.transcribe ? '开着的（没字幕就用家目录里的 asr.py 转，命令见章程）' : '关着的（没字幕就跳过）'}；`
       + `自动评论并 @ ${cfg.mentionName || '（还没填要 @ 谁）'} 是${cfg.autoComment && cfg.mentionName
         ? `开着的（每轮最多 ${cfg.commentPerRound} 条评论，每条在正文里纯文本 @ ${cfg.mentionName}，150 字内）`
         : '关着的（只写报告，别发评论）'}。`
@@ -558,6 +561,91 @@ export function apply(ctx, config) {
     c.on('error', (e) => { appendInstall(`起不来：${e?.message ?? e}\n`); resolve(1) })
   })
 
+  // ───────── 本地转写（ASR）：**独立环境**，别把主 venv 撑成 1GB ─────────
+  const asrDir = join(stateDir, '.venv-asr')
+  const asrLogFile = join(stateDir, 'asr-install.log')
+  const asrPython = () => join(asrDir, process.platform === 'win32' ? 'Scripts' : 'bin',
+    process.platform === 'win32' ? 'python.exe' : 'python')
+  const appendAsr = (s) => { try { appendFileSync(asrLogFile, String(s)) } catch { /* 日志写不了也不能炸 */ } }
+  // ⭐ 转写的临时目录必须由**宿主**预先建好：值班那一轮跑在沙箱里，
+  //    而沙箱只允许写"该子进程启动前就已存在"的目录（2026-10-14 那一轮自己挖出来的规则）
+  const asrTmp = join(stateDir, 'tmp', 'asr')
+  try { mkdirSync(asrTmp, { recursive: true }) } catch { /* 建不了也别拦着插件加载 */ }
+  let installingAsr = false
+
+  /** 找 uv：系统里的 → 插件家里下好的 → 自己下一份（给"两样都没有"的人）；主/转写两套安装共用 */
+  const resolveUv = async () => {
+    const bundled = join(stateDir, 'bin', process.platform === 'win32' ? 'uv.exe' : 'uv')
+    if (await haveUv()) return 'uv'
+    if (existsSync(bundled)) return bundled
+    appendInstall('这台机器上没有 uv —— 我下一份放进插件家目录（单文件、免管理员、约 15MB，只需要一次）…\n')
+    const got = await ensureUv({ dir: join(stateDir, 'bin'), log: appendInstall })
+    if (got) appendInstall('uv 已就位：' + got + '\n')
+    return got
+  }
+
+  /** 跟 spawnLogged 一样，但可以写进别的日志、可以带环境变量 */
+  const spawnTo = (cmd, args, { sink = appendInstall, env = null } = {}) => new Promise((resolve) => {
+    sink(`\n$ ${cmd} ${args.join(' ')}\n`)
+    let c
+    try {
+      c = spawn(cmd, args, { cwd: stateDir, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'],
+        env: env ? { ...process.env, ...env } : process.env })
+    } catch (e) { sink(`起不来：${e?.message ?? e}\n`); return resolve(1) }
+    const w = (b) => sink(String(b))
+    c.stdout?.on('data', w)
+    c.stderr?.on('data', w)
+    c.on('exit', (code) => { sink(`\n--- exit ${code} ---\n`); resolve(code) })
+    c.on('error', (e) => { sink(`起不来：${e?.message ?? e}\n`); resolve(1) })
+  })
+
+  /** 装"本地转写"那一套：独立环境 + faster-whisper + yt-dlp + 先把 Whisper 模型下好 */
+  const runAsrInstall = () => {
+    if (installingAsr) return { ok: true, busy: true, log: asrLogFile, hint: '正在装转写依赖，别重复起' }
+    installingAsr = true
+    appendAsr(`\n=== ${new Date().toISOString()} 开始装"本地转写"依赖 ===\n`)
+    ;(async () => {
+      try {
+        const mirror = process.env.BILI_DUTY_PIP_MIRROR || 'https://pypi.tuna.tsinghua.edu.cn/simple'
+        const hf = process.env.BILI_DUTY_HF_ENDPOINT || 'https://hf-mirror.com'
+        const py = asrPython()
+        const uvCmd = await resolveUv()
+        if (!existsSync(py)) {
+          // --seed：把 pip 也装进去（uv 默认不给）—— 不然出现问题时连 pip 都没有，没法补救 ✗
+          if (uvCmd) await spawnTo(uvCmd, ['venv', '--seed', asrDir], { sink: appendAsr })
+          else await spawnTo(String(cfg.pythonPath || 'python'), ['-m', 'venv', asrDir], { sink: appendAsr })
+        }
+        if (!existsSync(py)) {
+          appendAsr('建环境失败 —— 先点上面的「装依赖」，把 uv 或 Python 准备好\n')
+          log('转写：建环境失败'); return
+        }
+        appendAsr('装 faster-whisper + yt-dlp（走国内镜像）…\n')
+        let code = 1
+        // ⚠️ av 必须钉在 17 以下：faster-whisper 1.2.1 会调 av.open(metadata_errors=…)，
+        //    而 av 17+ 不再接受这个参数 ⇒ 装了最新的 av 反而转不了（2026-10-14 在主人机器上实证）
+        const AV_PIN = process.env.BILI_DUTY_AV_PIN || 'av>=12,<17'
+        if (uvCmd) code = await spawnTo(uvCmd, ['pip', 'install', '--python', py, '-i', mirror, 'faster-whisper', 'yt-dlp', AV_PIN], { sink: appendAsr })
+        if (code !== 0) code = await spawnTo(py, ['-m', 'pip', 'install', '-i', mirror, 'faster-whisper', 'yt-dlp', AV_PIN], { sink: appendAsr })
+        if (code !== 0) { appendAsr('装包失败 —— 看上面的报错\n'); log('转写：装包失败'); return }
+        // ⭐ 顺手把模型也下好（不然第一次跑那一轮会卡在下载上 ✗）；模型走 HuggingFace 国内镜像
+        const model = String(cfg.asrModel || 'small')
+        // 模型缓存必须放进插件家：默认的 ~/.cache 在本机拒绝写入（2026-10-14 实测 WinError 5）
+        const hfHome = join(stateDir, '.hf-cache')
+        try { mkdirSync(hfHome, { recursive: true }) } catch { /* 建不了后面会给报错 */ }
+        appendAsr(`下 Whisper 模型「${model}」（缓存在 ${hfHome}，源 ${hf}，几百 MB，只需要一次）…\n`)
+        const code2 = await spawnTo(py, ['-c',
+          'import os,sys;os.environ["HF_HUB_DISABLE_XET"]="1";from faster_whisper import WhisperModel;WhisperModel(sys.argv[1], device="cpu", compute_type="int8");print("模型就绪")',
+          model], { sink: appendAsr, env: { HF_ENDPOINT: hf, HF_HOME: hfHome, HF_HUB_DISABLE_XET: '1' } })
+        appendAsr(`=== 结束（装包 exit ${code}，模型 exit ${code2}，asrReady=${existsSync(py)}）===\n`)
+        log(`装转写依赖结束：exit=${code}/${code2}`)
+      } catch (e) {
+        appendAsr(`装转写依赖崩了：${e?.stack ?? e}\n`)
+        log(`装转写依赖崩了：${e?.message ?? e}`)
+      } finally { installingAsr = false }
+    })()
+    return { ok: true, started: true, log: asrLogFile, hint: '正在后台装转写依赖 —— 进度显示在下面（要下几百 MB 模型，慢一点正常）' }
+  }
+
   const runInstall = () => {
     if (installing) return { ok: true, busy: true, log: installLogFile, hint: '正在装，别重复起' }
     installing = true
@@ -567,18 +655,20 @@ export function apply(ctx, config) {
         const reqFile = join(pluginDir, 'vendor', 'bilibili-mcp', 'requirements.txt')
         const mirror = process.env.BILI_DUTY_PIP_MIRROR || 'https://pypi.tuna.tsinghua.edu.cn/simple'
         const venvPy = venvPython()
-        // ⭐ 陌生人的头一条坎：机器上可能既没有 uv 也没有 python —— 原来只丢一句 ENOENT，用户看不懂 ✗
-        if (!existsSync(venvPy) && !(await haveUv()) && !(await probeCmd(String(cfg.pythonPath || 'python')))) {
-          const msg = '这台机器上没有 uv，也没有可用的 python（试过 "' + String(cfg.pythonPath || 'python') + '"）'
-            + '⇒ 请先装 Python 3.10+（python.org 下载，安装时勾上 Add to PATH）或 uv（https://docs.astral.sh/uv/），再回来点一次「装依赖」。'
+        const py = String(cfg.pythonPath || 'python')
+          const uvCmd = await resolveUv()   // ⭐ 系统里的 → 家里下好的 → 自己下一份
+        if (!existsSync(venvPy) && !uvCmd && !(await probeCmd(py))) {
+          const msg = '这台机器上没有 uv，也没有可用的 python（试过 "' + py + '"），而且我自动下 uv 也没成功'
+            + '（大概是网络到不了 GitHub / PyPI 镜像）。⇒ 请手动装 uv（单个 exe：https://docs.astral.sh/uv/）'
+            + '或 Python 3.10+（安装时勾 Add to PATH），然后回来再点一次「装依赖」。'
           appendInstall(msg + '\n'); log(msg); installing = false; return
         }
         if (!existsSync(venvPy)) {
-          if (await haveUv()) await spawnLogged('uv', ['venv', join(stateDir, '.venv')])
-          if (!existsSync(venvPy)) await spawnLogged(String(cfg.pythonPath || 'python'), ['-m', 'venv', join(stateDir, '.venv')])
+          if (uvCmd) await spawnLogged(uvCmd, ['venv', join(stateDir, '.venv')])
+          if (!existsSync(venvPy) && !uvCmd) await spawnLogged(py, ['-m', 'venv', join(stateDir, '.venv')])
         }
         let code = 1
-        if (await haveUv()) code = await spawnLogged('uv', ['pip', 'install', '--python', venvPy, '-i', mirror, '-r', reqFile])
+        if (uvCmd) code = await spawnLogged(uvCmd, ['pip', 'install', '--python', venvPy, '-i', mirror, '-r', reqFile])
         if (code !== 0) code = await spawnLogged(venvPy, ['-m', 'pip', 'install', '-i', mirror, '-r', reqFile])
         if (existsSync(venvPy)) { saveCfg({ pythonPath: venvPy }); appendInstall(`已把 pythonPath 设为 ${venvPy}\n`) }
         appendInstall(`=== 结束（exit ${code}，venvReady=${existsSync(venvPy)}）===\n`)
@@ -591,6 +681,27 @@ export function apply(ctx, config) {
     return { ok: true, started: true, log: installLogFile, hint: '正在后台装依赖 —— 进度就显示在下面（走国内镜像，通常几十秒到一两分钟）' }
   }
 
+  /** 「测一下」：真跑一次查询再下结论（判据落在载荷上，不看自报） */
+  const checkUp = async () => {
+    const out = { ok: false, steps: [] }
+    if (!existsSync(venvPython())) { out.error = '环境还没装：先点「装主依赖」（几十秒）'; return out }
+    if (!hasCredential()) { out.error = '还没登录：点「扫码登录」，手机 B站 扫一下'; return out }
+    try {
+      const who = await call('bili_check_credential', {})
+      out.who = (typeof who === 'object' ? JSON.stringify(who) : String(who)).slice(0, 140)
+      out.steps.push('登录有效')
+    } catch (e) { out.error = '登录检查失败：' + (e?.message ?? e); return out }
+    try {
+      const s = await call('bili_search', { keyword: 'DeepSeek Harness', num: 3 })
+      const t = typeof s === 'string' ? s : JSON.stringify(s)
+      out.sample = t.slice(0, 160)
+      out.steps.push('能搜到东西')
+      out.ok = t.length > 2
+      if (!out.ok) out.error = '搜到了空结果'
+    } catch (e) { out.error = '搜索失败：' + (e?.message ?? e) }
+    return out
+  }
+
   const status = () => {
     const st = readJson(dutyStateFile, {})
     const today = dayKey()
@@ -605,7 +716,15 @@ export function apply(ctx, config) {
       lastWhy: st.lastWhy || null,
       loggedIn: hasCredential(),
       venvReady: existsSync(venvPython()),
+      installFailed: !installing && !existsSync(venvPython()) && (() => { try { return readFileSync(installLogFile, 'utf8').length > 0 } catch { return false } })(),
       installing,
+      // ── 本地转写那一套的状态（设置页要显示进度）──
+      asrReady: existsSync(asrPython()),
+      // 模型下没下（免得界面写"就绪"、其实还得现下）
+      asrModelReady: (() => { try { return existsSync(join(stateDir, '.hf-cache', 'hub')) } catch { return false } })(),
+      asrInstalling: installingAsr,
+      asrLog: asrLogFile,
+      asrTail: (() => { try { return readFileSync(asrLogFile, 'utf8').slice(-1400) } catch { return '' } })(),
       installLog: installLogFile,
       // ⭐ 让设置页能显示"装到哪了"（陌生人原来只看到一句"后台在装" ✗）
       installTail: (() => { try { return readFileSync(installLogFile, 'utf8').slice(-1400) } catch { return '' } })(),
@@ -625,7 +744,7 @@ export function apply(ctx, config) {
     if (req.method === 'POST' && path === '/api/bili-duty/config') {
       const body = await readBody(req)
       const patch = {}
-      for (const k of ['perDay', 'peakValley', 'noon', 'night', 'autoComment', 'transcribe',
+      for (const k of ['perDay', 'peakValley', 'noon', 'night', 'autoComment', 'transcribe', 'asrModel',
         'commentPerRound', 'mentionName',
         'keywords', 'pythonPath', 'dshBin', 'headlessProfile', 'workspace']) {
         if (k in body) patch[k] = body[k]
@@ -645,6 +764,16 @@ export function apply(ctx, config) {
       return sendJson(res, 200, runInstall())
     }
 
+    // 装"本地转写"那套（独立环境：faster-whisper + yt-dlp + Whisper 模型）
+    if (req.method === 'POST' && path === '/api/bili-duty/install-asr') {
+      return sendJson(res, 200, runAsrInstall())
+    }
+
+    // 「测一下」：真跑一次，回答"能不能用"
+    if (req.method === 'POST' && path === '/api/bili-duty/check') {
+      return sendJson(res, 200, await checkUp())
+    }
+
     // ── 扫码登录（设置页用）──
     if (req.method === 'POST' && path === '/api/bili-duty/login/start') {
       const { key, url } = await loginStart()

package/lib/asr.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+asr.py —— 把一条 B站 视频（或本地音视频文件）转成文字。
+给"这个视频没有字幕、但又值得判断"的情况用。
+
+用法（在插件的 ASR 环境里跑）：
+    .venv-asr/Scripts/python.exe asr.py BV1xxxxxxxxx          # Windows
+    .venv-asr/bin/python       asr.py https://www.bilibili.com/video/BV1xx
+    .venv-asr/Scripts/python.exe asr.py D:\\some\\clip.mp4 -o out.txt
+    …还可以加 --model small / --model medium 换模型（默认 small）
+
+设计上的两个要点：
+  ① **模型走国内镜像**（HF_ENDPOINT=hf-mirror.com）—— 否则 HuggingFace 拉不动
+  ② **音频不落盘到别处**：yt-dlp 下到临时目录，转写完就随系统清理
+"""
+import argparse
+import os
+import re
+import sys
+import tempfile
+
+# ⚠️ 临时目录必须待在家目录里：值班那一轮跑在沙箱里（只允许写工作区/cwd），
+#    yt-dlp 默认往 %TEMP% 写、会被直接拒掉（2026-10-14 在主人机器上实证：
+#    yt_dlp DownloadError: unable to open for writing: [Errno 13] Permission denied）
+_HOME = os.path.dirname(os.path.abspath(__file__))
+_TMP = os.path.join(_HOME, 'tmp', 'asr')
+try:
+    os.makedirs(_TMP, exist_ok=True)
+    tempfile.tempdir = _TMP
+except Exception:
+    pass
+
+# ⭐ 必须在 import faster_whisper **之前**设好，否则它已经去连 HuggingFace 了
+os.environ.setdefault('HF_ENDPOINT', 'https://hf-mirror.com')
+# 模型缓存放本脚本所在目录（= 插件家）：默认的 ~/.cache 在本机拒绝写入
+os.environ.setdefault('HF_HOME', os.path.join(os.path.dirname(os.path.abspath(__file__)), '.hf-cache'))
+# HuggingFace 新版存储（Xet）国内镜像不代理 ⇒ 关掉它，走老 CDN 通道（否则 401）
+os.environ.setdefault('HF_HUB_DISABLE_XET', '1')
+
+
+def to_url(target: str) -> str:
+    t = target.strip()
+    if t.upper().startswith('BV') and len(t) <= 20:
+        return 'https://www.bilibili.com/video/' + t
+    return t
+
+
+def fetch_audio(url: str, tmp: str, tag: str) -> str:
+    """用 yt-dlp 把音频拉下来（B站 是 DASH 音视频分离，取 bestaudio 即可，不需要 ffmpeg 合并）"""
+    from yt_dlp import YoutubeDL
+    opts = {
+        'format': 'bestaudio/best',
+        'outtmpl': os.path.join(tmp, tag + '.%(ext)s'),   # ⭐ 用 BV 号当文件名：固定名会和别的轮次撞车（踩过）
+        'paths': {'home': tmp, 'temp': tmp},   # 别让 yt-dlp 往 %TEMP% 写（沙箱会拒）
+        'cachedir': False,                      # 顺手别去动用户目录里的缓存
+        # ⭐ nopart：不写 .part 再改名，直接落最终文件。
+        #    沙箱里"新建文件 + 改名"会被拒，而这条能绕开（2026-10-14 值班那一轮自己试出来的）
+        'nopart': True,
+        'quiet': True,
+        'no_warnings': True,
+        'noplaylist': True,
+        'http_headers': {
+            'Referer': 'https://www.bilibili.com',
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
+        },
+    }
+    with YoutubeDL(opts) as ydl:
+        info = ydl.extract_info(url, download=True)
+        return ydl.prepare_filename(info)
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description='把一条视频转成文字（默认中文）')
+    ap.add_argument('target', help='BV 号 / B站链接 / 本地音视频文件')
+    ap.add_argument('-o', '--out', help='写到这个文件（不给就打到标准输出）')
+    ap.add_argument('--model', default=os.environ.get('BILI_DUTY_ASR_MODEL', 'small'),
+                    help='Whisper 模型大小：tiny / base / small / medium（默认 small）')
+    ap.add_argument('--lang', default='zh', help='语言（默认 zh；不给就自动判断请传 auto）')
+    args = ap.parse_args()
+
+    src = args.target
+    # ⚠️ 不用 mkdtemp：沙箱只允许写"子进程启动前就存在"的目录，新建的会被拒 ✗
+    #    这个目录由宿主（插件）预先建好；文件名固定，跑完自己清掉
+    tmp = _TMP
+    # ⭐ 每个视频用**自己的**文件名：以前写死 audio.m4a ⇒ 两轮同时跑会互相覆盖，
+    #    上一轮转出来的其实是另一个视频的内容（2026-10-14 值班那轮亲踩 ✗）
+    tag = os.path.basename(src).rsplit('.', 1)[0] or 'clip'
+    tag = re.sub(r'[^0-9A-Za-z_-]', '_', tag)[:40] or 'clip'
+    try:
+        if src.lower().startswith('http') or src.upper().startswith('BV'):
+            print('[asr] 先下音频…', file=sys.stderr)
+            src = fetch_audio(to_url(src), tmp, tag)
+        if not os.path.exists(src):
+            print('[asr] 找不到文件：' + src, file=sys.stderr)
+            return 2
+
+        from faster_whisper import WhisperModel
+        print('[asr] 加载模型 %s（第一次会自动下模型，之后就是本地读）…' % args.model, file=sys.stderr)
+        model = WhisperModel(args.model, device='cpu', compute_type='int8')
+        print('[asr] 开始转写…', file=sys.stderr)
+        segments, _info = model.transcribe(
+            src,
+            language=None if args.lang == 'auto' else args.lang,
+            vad_filter=True,          # 掐掉静音段，省时间也少出错
+        )
+        text = ''.join(seg.text for seg in segments).strip()
+    finally:
+        # 临时音频不留在磁盘上
+        try:
+            import glob
+            for f in glob.glob(os.path.join(tmp, tag + '.*')):
+                try:
+                    os.remove(f)
+                except Exception:
+                    pass
+        except Exception:
+            pass
+
+    if args.out:
+        with open(args.out, 'w', encoding='utf-8') as f:
+            f.write(text)
+        print('[asr] 已写入：' + args.out, file=sys.stderr)
+    else:
+        print(text)
+    return 0
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())

package/lib/state.mjs

@@ -60,6 +60,7 @@ export function ensureHomeFiles(pluginDir, stateDir, log = () => {}) {
   const copies = [
     [join(pluginDir, 'vendor', 'bilibili-mcp', 'mcp_server.py'), join(stateDir, 'mcp_server.py'), true],
     [join(pluginDir, 'prompts', 'duty.md'), join(stateDir, 'duty.md'), false],
+    [join(pluginDir, 'lib', 'asr.py'), join(stateDir, 'asr.py'), true],
   ]
   for (const [from, to, overwrite] of copies) {
     try {

package/lib/uvfetch.mjs

@@ -0,0 +1,161 @@
+/**
+ * lib/uvfetch.mjs —— 「机器上连 uv 和 Python 都没有」时，**插件自己把 uv 弄到手**
+ * ============================================================================
+ * 为什么值得单独做：uv 是**单个可执行文件**（Windows 上 ~32MB 的 uv.exe ✓），
+ * **解压就能用、不用管理员、不用进 PATH** ✓，而且它还能自己把 Python 拉下来 ✓
+ * ⇒ 只要拿到它，"首次安装"就从「先去装个 Python」变成「点一下就好」✓
+ *
+ * 两个源，按顺序试：
+ *   ① **GitHub 官方 release**（`uv-x86_64-pc-windows-msvc.zip`）—— 有加速器时最快 ✓
+ *   ② ⭐ **PyPI 清华镜像的 uv wheel** —— wheel 本身就是个 zip，里面装着 `uv.exe` ✓
+ *      （国内速度快、不依赖 GitHub ✓）
+ *
+ * 解压：优先用 **系统自带的 `tar`**（Windows 10+ 的 bsdtar 能直接读 zip ✓），
+ *       再退到 `unzip`；然后**在解压出来的整棵树里按文件名找** ✓
+ *       —— 不管官方把它放在哪一层都能找着 ✓
+ * ============================================================================
+ */
+import { spawnSync } from 'node:child_process'
+import { createWriteStream, existsSync, mkdirSync, readdirSync, statSync, copyFileSync, chmodSync, rmSync, readFileSync } from 'node:fs'
+import { createHash } from 'node:crypto'
+import { join } from 'node:path'
+import { Readable } from 'node:stream'
+import { pipeline } from 'node:stream/promises'
+
+const ASSETS = {
+  win32: { name: 'uv-x86_64-pc-windows-msvc.zip', bin: 'uv.exe' },
+  darwin: { name: 'uv-aarch64-apple-darwin.tar.gz', bin: 'uv' },
+  linux: { name: 'uv-x86_64-unknown-linux-gnu.tar.gz', bin: 'uv' },
+}
+
+/** 算一个文件的 sha256 */
+function sha256Of(file) {
+  return createHash('sha256').update(readFileSync(file)).digest('hex')
+}
+
+/**
+ * 取"官方期望的 sha256"：
+ *   · PyPI wheel：JSON 里自带 `digests.sha256` ✓
+ *   · GitHub 资产：同目录下有一份 `<文件名>.sha256` ✓（代理会一起转 ✓）
+ * 取不到就返回 null（那时只记一句"未校验"，不拦着）
+ */
+async function expectedSha(source) {
+  if (source.sha) return String(source.sha).toLowerCase()
+  try {
+    const r = await fetch(source.url + '.sha256')
+    if (!r.ok) return null
+    const m = /([0-9a-f]{64})/i.exec(await r.text())
+    return m ? m[1].toLowerCase() : null
+  } catch { return null }
+}
+
+/** 在目录树里按文件名找可执行文件（递归） */
+export function findBin(name, dir) {
+  let entries = []
+  try { entries = readdirSync(dir, { withFileTypes: true }) } catch { return null }
+  for (const e of entries) {
+    const p = join(dir, e.name)
+    if (e.isDirectory()) { const hit = findBin(name, p); if (hit) return hit }
+    else if (e.name === name) return p
+  }
+  return null
+}
+
+/** 解压一个压缩包并找出目标文件（tar 优先 —— Windows 自带那份能读 zip） */
+export function extractArchive(binName, archive, into) {
+  const attempts = [['tar', ['-xf', archive, '-C', into]], ['unzip', ['-o', archive, '-d', into]]]
+  for (const [cmd, args] of attempts) {
+    try {
+      const r = spawnSync(cmd, args, { stdio: 'ignore' })
+      if (r.status === 0) { const hit = findBin(binName, into); if (hit) return hit }
+    } catch { /* 换下一个工具 */ }
+  }
+  return null
+}
+
+/**
+ * 确保家目录里有一份可用的 uv，返回它的路径（拿不到就返回 null）。
+ * @param {{ dir: string, log?: (m: string) => void }} opts
+ */
+export async function ensureUv({ dir, log = () => {} }) {
+  const a = ASSETS[process.platform] || ASSETS.linux
+  const target = join(dir, a.bin)
+  if (existsSync(target)) return target
+
+  mkdirSync(dir, { recursive: true })
+  const tmp = join(dir, '_tmp')
+  rmSync(tmp, { recursive: true, force: true })
+  mkdirSync(tmp, { recursive: true })
+
+  // 源按顺序试：直连 → 两个国内能用的 GitHub 加速代理（2026-10-14 实测这两条能出真 zip ✓）
+  //          → 最后兜底是 PyPI 镜像上的 uv wheel（⚠️ 那个停在 0.2.33/2024-08，能用但不是最新 ✗）
+  const asset = `https://github.com/astral-sh/uv/releases/latest/download/${a.name}`
+  const sources = [
+    { label: 'GitHub 直连', url: asset, file: join(tmp, a.name) },
+    { label: 'GitHub 加速代理 gh-proxy.com', url: `https://gh-proxy.com/${asset}`, file: join(tmp, a.name) },
+    { label: 'GitHub 加速代理 ghproxy.net', url: `https://ghproxy.net/${asset}`, file: join(tmp, a.name) },
+  ]
+  if (process.platform === 'win32') {
+    try {
+      const r = await fetch('https://pypi.tuna.tsinghua.edu.cn/pypi/uv/json')
+      const j = await r.json()
+      // ⚠️ PyPI 的 urls 顺序**不保证最新在前** ⇒ 必须按版本号自己排序挑最新（踩过：取到了 0.2.33 的老版本 ✗）
+      const verOf = (name) => { const m = /-(\d+\.\d+\.\d+(?:[.-][0-9A-Za-z.]+)?)-py3-none-win_amd64\.whl$/.exec(String(name)); return m ? m[1] : '0.0.0' }
+      const cmpVer = (a, b) => {
+        const A = verOf(a).split(/[.-]/).map(Number), B = verOf(b).split(/[.-]/).map(Number)
+        for (let i = 0; i < 4; i++) { if ((A[i] || 0) !== (B[i] || 0)) return (B[i] || 0) - (A[i] || 0) }
+        return 0
+      }
+      const w = (j.urls || [])
+        .filter((u) => /win_amd64\.whl$/.test(String(u.filename)))
+        .sort((x, y) => cmpVer(x.filename, y.filename))[0]
+      if (w?.url) {
+        sources.push({ label: 'PyPI 清华镜像（uv wheel）', url: w.url, file: join(tmp, String(w.filename)), sha: w.digests?.sha256 })
+        log(`  （备选源已就绪：${w.filename}）`)
+      }
+    } catch (e) {
+      log(`  列 PyPI 版本时出错（不影响，继续试别的源）：${e?.message ?? e}`)
+    }
+  }
+
+  for (const s of sources) {
+    try {
+      log(`正在下载 uv —— ${s.label}`)
+      const res = await fetch(s.url)
+      if (!res.ok) { log(`  → 返回 ${res.status}，换下一个源`); continue }
+      await pipeline(Readable.fromWeb(res.body), createWriteStream(s.file))
+      const mb = (statSync(s.file).size / 1048576).toFixed(1)
+      log(`  → 下载完成 ${mb} MB`)
+      // ⭐ 完整性校验：下载下来是要**被执行**的，必须跟官方 sha256 对上（防的是第三方代理动过包 ✗）
+      const want = await expectedSha(s)
+      if (want) {
+        const gotSha = sha256Of(s.file)
+        if (gotSha !== want) {
+          log(`  → ⚠️ sha256 校验不过（期望 ${want.slice(0, 12)}… 实际 ${gotSha.slice(0, 12)}…）⇒ 丢弃这个源`)
+          continue
+        }
+        log('  → 官方 sha256 校验通过 ✓')
+      } else {
+        log('  → 没取到官方 sha256，跳过校验（下载来自 HTTPS 的官方地址时风险很小）')
+      }
+      log('  → 开始解压')
+      const hit = extractArchive(a.bin, s.file, tmp)
+      if (!hit) { log('  → 解压后没找到可执行文件，换下一个源'); continue }
+      copyFileSync(hit, target)
+      try { chmodSync(target, 0o755) } catch { /* Windows 上不需要 */ }
+      try {
+        const r = spawnSync(target, ['--version'], { stdio: 'ignore' })
+        log('  → 版本检查：' + (r.status === 0 ? '能跑 ✓' : '跑不起来 ✗'))
+      } catch { /* 跑不起来也别拦着，后面自己会报错 */ }
+      rmSync(tmp, { recursive: true, force: true })
+      log(`  → uv 已就位：${target}`)
+      return target
+    } catch (e) {
+      log(`  → ${s.label} 失败：${e?.message ?? e}`)
+    }
+  }
+
+  rmSync(tmp, { recursive: true, force: true })
+  log('所有源都拿不到 uv（大概是网络到不了 GitHub / PyPI 镜像）')
+  return null
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bili-scroll",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DSH 插件：每天替你刷一轮 B站 —— 读字幕挑出值得的、写一份日报，值得的就 @ 你",
   "keywords": [
     "dsh",
@@ -26,9 +26,11 @@
     "prompts",
     "vendor",
     "README.md",
+    "AGENTS.md",
     "LICENSE"
   ],
   "engines": {
+    "dsh": ">=0.1.7-rc.1",
     "node": ">=22"
   },
   "peerDependencies": {

package/prompts/duty.md

@@ -13,14 +13,24 @@
   ⚠️ **不要把日记内容抄进报告或评论** —— 那是他的私事。
 - 两份都没有？那就中性一点，别擅自扮演任何人格。
 
+## 先记住两条（省钱，也是纪律）
+
+- ⚠️ **看够了就下结论**：不要反复权衡同一条该不该收 —— 拿不准就按"跳过"处理，别来回改主意。
+- ⚠️ **工具失败两次就记为"跳过"**：不要反复重试同一个命令、也不要为了绕过它写一堆临时脚本。
+  （这两条省的是使用者的钱：实测里"纠结"那一轮比干净的一轮多花了**近一倍** token。）
+
 ## 一轮要做的事
 
 1. **搜一轮**（近 7 天优先）：用**设置页里填的「关注关键词」**；没填就用默认这几组 ——
    `DeepSeek Harness`、`DSH 插件`、`dsh 教程`、`meow-memory`、`DeepSeek Harness 桌面端`
-2. 从结果里挑出**值得的**，条数看设置页的「定量刷（每天几条）」；**判重** —— 已经看过的跳过
+2. 从结果里挑出**值得的**，条数看设置页的「定量刷（每天几条）」；**判重** —— 已经看过的跳过（判重表就在家目录根下，叫 `seen.md`）
 3. 每条：
    - **读字幕原文**（⚠️ 别看摘要下判断）
-   - 没有字幕时：**只有**设置里开了「本地转写」才去转写；没开就跳过、别硬凑
+   - 没有字幕时：**只有**设置里开了「本地转写」才去转写；没开就跳过、别硬凑。
+  转写命令（家目录里的独立环境，别用主 venv）：
+  · Windows：`<家目录>\.venv-asr\Scripts\python.exe <家目录>\asr.py <BV号>`
+  · macOS/Linux：`<家目录>/.venv-asr/bin/python <家目录>/asr.py <BV号>`
+  它会把字幕打到标准输出（第一次调用要加载模型，慢几十秒正常）。
    - 顺手翻一眼评论
 4. 写一份 Markdown 报告，每条一段：
    **标题 / UP / 链接 / 播放量 / 为什么值得（两三句）/ 你自己的一句话**，结尾给一句总结