dsh-bili-watch 0.2.2 → 0.2.4

package/README.md

@@ -1,8 +1,13 @@
 # dsh-bili-watch
 
-把一条 B 站视频变成模型能读的内容：元数据、评论、弹幕、AI 字幕、本地转写、抽帧 OCR。可以装在 DSH 里当插件，也能直接跑命令行。
+将一条 B 站视频变成模型能读的内容：元数据、评论、弹幕、AI 字幕、本地转写、抽帧 OCR。可作为 DSH 插件运行，也可直接当命令行工具。
 
-取内容的顺序是先用文字（字幕或转写），文字不够再抽帧看画面。只读元数据、评论、弹幕、搜索、热榜不需要任何额外依赖；抽帧相关命令要 ffmpeg，没装会明确报错并指出装法，不会假装成功。
+取内容的顺序是先用文字（字幕或转写），文字不够则抽帧看画面。只读元数据、评论、弹幕、搜索、热榜不需要任何额外依赖；抽帧相关命令需要 ffmpeg，未安装会明确报错并指出装法。
+
+> [!IMPORTANT]
+> 面板要重启 DSH 后才出现，插件只在启动时加载。
+> 抽帧类命令（`frames` / `ocr` / `sheet` / `substrip` / `text` 的兜底档）需要 ffmpeg，没有会直接报错，不会静默降级。
+> 登录只影响 AI 字幕；其余命令匿名可用。
 
 ## 安装
 
@@ -12,12 +17,14 @@
 dsh plugin --profile web add dsh-bili-watch
 ```
 
-**第二步容易漏**：打开 profile 的 `package.json`，在 `dsh.profile.bundles` 数组里加一行 `"dsh-bili-watch"`。`dsh plugin add` 只写 `dependencies`，不写 bundles。漏了这步插件装了但不生效，也不报错。改完重启 DSH。
+**第二步易漏**：打开 profile 的 `package.json`，在 `dsh.profile.bundles` 数组里加一行 `"dsh-bili-watch"`。`dsh plugin add` 只写 `dependencies`，不写 bundles。漏了这步插件装了但不生效，也不报错。改完重启 DSH。
 
 也可以把本仓库直接放进 `profiles/<名字>/node_modules/dsh-bili-watch`。
 
 插件依赖 DSH 自带的 `@deepseek-ai/dsh-tools`（peer，optional）。profile 里缺这个包时 `index.js` 会报 `ERR_MODULE_NOT_FOUND`，先补装再重启。
 
+插件尚未收录到插件市场，目前只能按上面的命令装。
+
 ### 只当命令行工具
 
 ```bash
@@ -27,12 +34,34 @@ bili-watch view BV1EPnG6DEJC
 
 不装全局也行：clone 仓库后在目录里跑 `node tools/look.mjs view BV1EPnG6DEJC`。命令行的依赖和插件完全一样，`scripts/fetch-deps` 同样可用。
 
+### 更新与卸载
+
+```bash
+dsh plugin --profile web add dsh-bili-watch@latest
+dsh plugin --profile web remove dsh-bili-watch
+```
+
+升级后重启 DSH。卸载不会删除 `deps/` 里的模型、环境与凭证；要清理就在面板里逐项删，或手动删目录。
+
+## 插件面板
+
+装进 DSH 后，设置 → 插件 → `dsh-bili-watch` 的详情页有一块面板，常规操作无需去对话里敲命令：
+
+- **依赖状态**：ffmpeg、yt-dlp、ASR 环境、OCR 环境、转写模型、登录凭证逐项列出是否就绪、实际路径、占用体积。缺的点击行末「下载」，后台跑 `scripts/fetch-deps`（体积是估算值，实际以跑完为准）。
+- **扫码登录**：凭证未登录时点「重新扫码」，面板里弹出二维码，手机 B 站扫完自动刷新。凭证保存在本机 `deps/credential.json`。
+- **删除**：面板按实际路径判断——装在插件目录里的（yt-dlp、转写模型、登录凭证）可直接删；装在插件目录外的（比如复用系统 ffmpeg 或已有的 Python 环境）按钮置灰，旁边标出它实际在哪。
+- **批量**：标题行的「批量下载 / 批量清理」打开勾选清单，默认勾上所有可操作的项，删除前会再确认一次。
+- **抽帧缓存**：显示当前占用与文件数，「立即清除」一键清空；不点则会按规则自动清理——保留天数（默认 7 天）与总量上限（默认 2048 MB），超过则从最旧的删起。规则存在 `deps/cache-config.json`，插件启动和打开面板时各检查一次。
+- **最近一次调用**：显示命令、时间、成败，用来判断上一次看视频是否卡住。
+
+装完第一次重启 DSH，面板才会出现。
+
 ## 依赖
 
 | 能力 | 需要 | 没有时 |
 |---|---|---|
 | 元数据 / 评论 / 弹幕 / 搜索 / 热榜 | 无（匿名 HTTP） | — |
-| 抽帧 / 九宫格 / 字幕带 | `ffmpeg` | 报错并提示装法（`text` 会降级到读图） |
+| 抽帧 / 九宫格 / 字幕带 | `ffmpeg` | 报错并提示装法（`text` 的兜底档就是抽帧，所以同样要 ffmpeg） |
 | AI 字幕 | 一次扫码登录（SESSDATA） | 返回「无字幕轨」，自动降级 |
 | 本地转写 | Python 3.10+ 与 faster-whisper（`deps/.venv-asr`） | 跳过，自动降级 |
 | 画面 OCR | Python 3.10+ 与 rapidocr_onnxruntime（`deps/.venv-ocr`） | 跳过，只剩基础抽帧 |
@@ -40,7 +69,7 @@ bili-watch view BV1EPnG6DEJC
 
 环境：Node.js ≥ 22。装在 DSH 里时 DSH 自带 node，命令行跑也一样。
 
-`ffmpeg` 查找顺序：`--ffmpeg` 参数 → `BILI_LOOK_FFMPEG` → 插件 `deps/` → PATH。
+`ffmpeg` 查找顺序：`--ffmpeg` 参数 → `BILI_WATCH_FFMPEG` → 插件 `deps/` → PATH。
 
 `deps/` 用来放运行期文件：Python venv、模型、yt-dlp、凭证，默认不进 git（见 `.gitignore`）。ASR 和 OCR 的 Python 环境是可选的，不装也能用，只是少这两档。
 
@@ -61,16 +90,16 @@ powershell -ExecutionPolicy Bypass -File scripts\fetch-deps.ps1 -Target model
 ```bash
 # macOS / Linux
 bash scripts/fetch-deps.sh all
-BILI_LOOK_MIRROR=cn bash scripts/fetch-deps.sh all
+BILI_WATCH_MIRROR=cn bash scripts/fetch-deps.sh all
 ```
 
-脚本可以重复跑：目标已存在就跳过，`-Force` 重下（Windows），`-DryRun` 只打印命令。装 venv 时会验证包能不能 import，上次装到一半的会被重建。`-Target model` 需要 ASR 环境先装好，脚本会提示。
+脚本可以重复跑：目标已存在就跳过；Windows 用 `-Force` 重下、`-DryRun` 只打印命令（sh 版没有这两个参数，要重装就删掉目标目录）。装 venv 时会验证包能不能 import，上次装到一半的会被重建。`-Target model` 需要 ASR 环境先装好，脚本会提示。
 
 **从 GitHub 下载很慢或断**：ffmpeg 要从 GitHub 拉约 80 MB 的压缩包，国内直连经常断。三条替代路径：
 
 1. 加 `-Mirror cn` 重试（走 gh-proxy）；
 2. 手动下载 `ffmpeg.exe` 放进 `deps\` 再重跑（会被跳过）；
-3. 已经有 ffmpeg 就设 `BILI_LOOK_FFMPEG` 指向它。
+3. 已经有 ffmpeg 就设 `BILI_WATCH_FFMPEG` 指向它。
 
 macOS/Linux 的 ffmpeg 用系统包管理器装，脚本只给提示。其余目标和 Windows 一样；sh 版本单项失败会跑完再汇总。
 
@@ -85,7 +114,7 @@ macOS/Linux 的 ffmpeg 用系统包管理器装，脚本只给提示。其余目
 
 凭证顺序：给了 `--cred` 就只用它，读不到就按匿名跑；没给 `--cred` 才用 `deps/credential.json`；两者都没有就匿名。
 
-这份文件等同账号登录态。别分享、别提交、别上传。
+这份文件等同账号登录态。请勿分享、提交、上传。
 
 ## 命令
 
@@ -94,7 +123,7 @@ macOS/Linux 的 ffmpeg 用系统包管理器装，脚本只给提示。其余目
 | `view <BV或链接或URL>` | 元数据 + 简介 + 热评 |
 | `peek <BV或链接>` | 元数据 + 热评 + 5 张均匀帧（最便宜；仅 B 站） |
 | `sub <BV>` | AI 字幕 + 三判据（字/秒、关键词命中、时长） |
-| `comments <BV> [N]` | 评论区，默认按时间倒序 |
+| `comments <BV> [N]` | 评论区，默认按热度排序 |
 | `asr <BV或URL>` | 本地转写音频 |
 | `frames <BV或URL> [--step 秒] [--ocr]` | 抽帧；`--ocr` 顺带识别画面文字 |
 | `ocr <BV>` | 抽帧并 OCR |
@@ -115,7 +144,7 @@ macOS/Linux 的 ffmpeg 用系统包管理器装，脚本只给提示。其余目
 
 `view` / `text` / `asr` / `frames` 接受非 B 站 URL（YouTube、X、直链 mp4 等），走 yt-dlp：
 
-- `yt-dlp.exe` 放进 `deps/`，或设 `BILI_LOOK_YTDLP`，或让它出现在 PATH 里。
+- `yt-dlp.exe` 放进 `deps/`，或设 `BILI_WATCH_YTDLP`，或让它出现在 PATH 里。
 - 下载按 URL 哈希隔离在 `%TEMP%\bili-watch\`，不会串目录。
 - `peek` / `sub` / `comments` / `danmaku` / `sheet` / `substrip` / `ocr` 只支持 B 站。
 
@@ -137,10 +166,10 @@ AI 字幕（需登录）
 
 | 变量 | 作用 |
 |---|---|
-| `BILI_LOOK_PROJ` | ASR/OCR 环境目录（默认插件 `deps/`） |
-| `BILI_LOOK_FFMPEG` | ffmpeg 可执行文件路径 |
-| `BILI_LOOK_YTDLP` | yt-dlp 可执行文件路径 |
-| `BILI_LOOK_SEEN` | `seen.md` 去重文件路径（默认 `deps/seen.md`） |
+| `BILI_WATCH_PROJ` | ASR/OCR 环境目录（默认插件 `deps/`） |
+| `BILI_WATCH_FFMPEG` | ffmpeg 可执行文件路径 |
+| `BILI_WATCH_YTDLP` | yt-dlp 可执行文件路径 |
+| `BILI_WATCH_SEEN` | `seen.md` 去重文件路径（默认 `deps/seen.md`） |
 
 ## 成本
 
@@ -148,11 +177,13 @@ AI 字幕（需登录）
 - 抽帧会下载视频（360p）并跑 ffmpeg。`--step` 调低抽帧频率，脚本另外限了 `-threads 2`。
 - 九宫格和字幕带把多帧压成一张图，省 token。
 
-## 风险
+## 限制与风险
 
+- **不支持**：点赞、评论、发弹幕、留观看历史；B 站侧只读。本机会写登录凭证、抽帧缓存与 `seen.md` 去重文件。
+- **只支持 B 站与 yt-dlp 能下的站点**；`peek` / `sub` / `comments` / `danmaku` / `sheet` / `substrip` / `ocr` 仅限 B 站。
 - **凭证**：等同账号登录态，泄露即被盗。只存本机，不进日志。
 - **频率**：正常看几条没问题；批量扫几百条会触发风控。
-- **只读**：插件只读，不点赞、不评论、不留观看历史。
+- **任意 http(s) 地址都会被请求**：通用 URL 走 yt-dlp 时不做内网地址过滤，别拿它请求内网服务。
 
 ## 许可
 

package/client.js

@@ -0,0 +1,386 @@
+/**
+ * dsh-bili-watch —— 浏览器半端：插件详情页里的「依赖与状态」面板。
+ *
+ * 面板回答三件事（不碰业务流程）：
+ *   ① 这个插件依赖的 ffmpeg / yt-dlp / ASR / OCR / 模型 / 登录凭证，现在配好了没有；
+ *   ② 缺的可以一键下载（后台跑插件自带的 fetch-deps 脚本，带预估体积）；
+ *   ③ 抽帧缓存占了多少、可以一键清，平时按「天数 + 总量阈值」自动清。
+ *
+ * 后端只走 host 的 /api/bili-watch（读盘 + 清缓存 + 起下载），面板不存任何凭证。
+ * 挂载点：plugins.bundle.config（key = 包名），因此设置页里看不到它，只在插件详情页出现。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-bili-watch',
+  factory: (require) => {
+    const React = require('react')
+    const h = React.createElement
+
+    // 包名：生产插件是 dsh-bili-watch，发布树派生时改成 dsh-bili-watch
+    const PKG = 'dsh-bili-watch'
+    const API = '/api/bili-watch'
+    const jget = async (p) => (await fetch(API + p, { credentials: 'same-origin' })).json()
+    const jpost = async (p, body) =>
+      (await fetch(API + p, {
+        method: 'POST',
+        credentials: 'same-origin',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(body ?? {}),
+      })).json()
+
+    const CSS = `
+[data-bl-page]{display:flex;flex-direction:column;gap:12px;padding:4px 2px 10px;max-width:720px;font-size:13px;}
+[data-bl-head]{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap;}
+[data-bl-title]{font-size:14px;font-weight:600;}
+[data-bl-sub]{font-size:12px;color:var(--dsw-alias-label-tertiary,#8a9099);}
+[data-bl-sec]{display:flex;flex-direction:column;gap:6px;border-top:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.18));padding-top:10px;}
+[data-bl-sec-title]{font-size:12px;font-weight:600;color:var(--dsw-alias-label-secondary,#6b7280);}
+[data-bl-row]{display:flex;align-items:center;gap:10px;flex-wrap:wrap;min-height:28px;}
+[data-bl-dot]{width:8px;height:8px;border-radius:50%;flex:none;}
+[data-bl-dot="ok"]{background:#3c9a5f;}
+[data-bl-dot="bad"]{background:#d9534f;}
+[data-bl-name]{min-width:150px;flex:none;}
+[data-bl-detail]{flex:1;min-width:0;color:var(--dsw-alias-label-tertiary,#8a9099);font-size:12px;word-break:break-all;}
+[data-bl-size]{flex:none;color:var(--dsw-alias-label-tertiary,#8a9099);font-size:12px;min-width:64px;text-align:right;}
+[data-bl-btn]{font-size:12px;min-height:26px;padding:2px 10px;border-radius:6px;cursor:pointer;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.16));background:transparent;color:inherit;flex:none;}
+[data-bl-btn:disabled]{opacity:.45;cursor:default;}
+[data-bl-input]{width:64px;font-size:12px;padding:2px 6px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.16));background:transparent;color:inherit;}
+[data-bl-note]{font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary,#8a9099);}
+[data-bl-bad]{color:#d9534f;}
+[data-bl-good]{color:#3c9a5f;}
+[data-bl-qrbox]{display:flex;gap:16px;align-items:center;flex-wrap:wrap;}
+[data-bl-qr]{flex:none;width:220px;height:220px;background:#fff;padding:6px;border-radius:8px;}
+[data-bl-qr svg]{width:100%;height:100%;display:block;}
+[data-bl-qrside]{display:flex;flex-direction:column;gap:10px;max-width:320px;}
+[data-bl-sechead]{display:flex;align-items:center;gap:8px;flex-wrap:wrap;}
+[data-bl-sechead] [data-bl-sec-title]{margin-right:auto;}
+[data-bl-dlg]{border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.25));border-radius:8px;padding:10px;gap:8px;}
+[data-bl-dlgrow]{display:flex;align-items:center;gap:8px;font-size:12px;min-height:24px;}
+[data-bl-dlgrow] input{accent-color:#3c9a5f;}
+`
+
+    const fmtBytes = (b) => {
+      const n = Number(b) || 0
+      if (n >= 1073741824) return (n / 1073741824).toFixed(2) + ' GB'
+      if (n >= 1048576) return (n / 1048576).toFixed(1) + ' MB'
+      return (n / 1024).toFixed(1) + ' KB'
+    }
+    const fmtTime = (t) => {
+      if (!t) return '—'
+      const d = new Date(t)
+      return Number.isNaN(d.getTime()) ? String(t) : d.toLocaleString('zh-CN', { hour12: false })
+    }
+
+    function DepRow({ d, busy, onDownload, onDelete }) {
+      const canDownload = !d.ok && d.id !== 'credential'
+      return h('div', { 'data-bl-row': '' },
+        h('span', { 'data-bl-dot': d.ok ? 'ok' : 'bad' }),
+        h('span', { 'data-bl-name': '' }, d.name),
+        h('span', { 'data-bl-detail': '' }, d.ok ? d.detail : h('span', { 'data-bl-bad': '' }, d.detail)),
+        h('span', { 'data-bl-size': '' }, d.ok ? fmtBytes(d.size) : d.estimate),
+        d.id === 'credential'
+          ? h('button', { 'data-bl-btn': '', onClick: () => onDownload('login') }, d.ok ? '重新扫码' : '去扫码登录')
+          : canDownload
+            ? h('button', { 'data-bl-btn': '', disabled: busy, onClick: () => onDownload(d.id) }, busy ? '下载中…' : '一键下载')
+            : null,
+        d.id === 'credential'
+          ? h('button', { 'data-bl-btn': '', disabled: !d.ok, onClick: () => onDelete(d.id) }, '清除凭证')
+          : d.removable
+            ? h('button', { 'data-bl-btn': '', onClick: () => onDelete(d.id) }, '删除')
+            : h('button', { 'data-bl-btn': '', disabled: true, title: d.removableWhy || '不在插件目录内' }, '删除'),
+        d.id === 'credential' && d.path ? h('span', { 'data-bl-note': '' }, '文件：' + d.path) : null,
+      )
+    }
+
+    function Panel() {
+      const [st, setSt] = React.useState(null)
+      const [err, setErr] = React.useState('')
+      const [msg, setMsg] = React.useState('')
+      const [busy, setBusy] = React.useState('')
+      const [days, setDays] = React.useState('7')
+      const [maxMb, setMaxMb] = React.useState('2048')
+      const [qr, setQr] = React.useState(null)
+      const [qrState, setQrState] = React.useState('')
+      const [dlg, setDlg] = React.useState(null) // 'download' | 'clean'
+      const [picked, setPicked] = React.useState([])
+
+      const load = React.useCallback(async () => {
+        try {
+          const j = await jget('/status')
+          if (j.ok) {
+            setSt(j.data)
+            setErr('')
+            setDays(String(j.data.cache?.days ?? 7))
+            setMaxMb(String(j.data.cache?.maxMb ?? 2048))
+          } else {
+            setErr(j.why || '状态读取失败')
+          }
+        } catch (e) {
+          setErr(String(e?.message || e))
+        }
+      }, [])
+
+      React.useEffect(() => {
+        load()
+        const t = setInterval(load, 8000)
+        return () => clearInterval(t)
+      }, [load])
+
+      // 二维码出现后每 2.5 秒问一次扫码结果；成功就刷新依赖状态（凭证会变绿）
+      React.useEffect(() => {
+        if (!qr?.key) return undefined
+        let stop = false
+        const tick = async () => {
+          if (stop) return
+          try {
+            const j = await jpost('/login/poll', { key: qr.key })
+            if (stop) return
+            if (j.state === 'ok') {
+              stop = true
+              setQr(null)
+              setQrState('ok')
+              setMsg('登录成功，凭证已保存。')
+              await load()
+              return
+            }
+            if (j.state === 'expired' || j.state === 'error') {
+              stop = true
+              setQrState(j.state)
+              setMsg(j.why || (j.state === 'expired' ? '二维码已过期，点「重新扫码」再试。' : '轮询失败'))
+              return
+            }
+            setQrState(j.state)
+            setTimeout(tick, 2500)
+          } catch (e) {
+            if (!stop) setTimeout(tick, 4000)
+          }
+        }
+        const t = setTimeout(tick, 1500)
+        return () => {
+          stop = true
+          clearTimeout(t)
+        }
+      }, [qr, load])
+
+      const startLogin = async () => {
+        setMsg('')
+        setQr(null)
+        setQrState('loading')
+        try {
+          const j = await jpost('/login/qr', {})
+          if (j.ok) {
+            setQr(j.data)
+            setQrState('waiting')
+          } else {
+            setQrState('error')
+            setMsg('生成二维码失败：' + (j.why || '未知错误'))
+          }
+        } catch (e) {
+          setQrState('error')
+          setMsg(String(e?.message || e))
+        }
+      }
+
+      const download = async (target) => {
+        if (target === 'login') {
+          await startLogin()
+          return
+        }
+        setBusy(target)
+        setMsg('')
+        try {
+          const j = await jpost('/download', { target })
+          setMsg(j.ok ? `已开始下载（后台跑，日志 ${j.data.log}）。下载较久，过一会儿点刷新看状态。` : (j.data?.why || j.why || '启动失败'))
+        } catch (e) {
+          setMsg(String(e?.message || e))
+        } finally {
+          setBusy('')
+        }
+      }
+
+      const saveCache = async () => {
+        try {
+          const j = await jpost('/cache/clear', { days: Number(days), maxMb: Number(maxMb) })
+          setMsg(j.ok ? `缓存已清（${j.data.removed} 个文件 / ${fmtBytes(j.data.bytes)}）；之后按 ${days} 天、${maxMb} MB 自动清` : (j.why || '清缓存失败'))
+          await load()
+        } catch (e) {
+          setMsg(String(e?.message || e))
+        }
+      }
+
+      const saveRule = async () => {
+        try {
+          await jpost('/cache/clear', { days: Number(days), maxMb: Number(maxMb) })
+        } catch {}
+      }
+
+      const rows = st?.deps || []
+      // 打开批量弹层：默认全勾选（可下载 = 缺的且不是凭证；可清理 = 插件目录内且已存在）
+      const openDlg = (kind) => {
+        if (kind === 'download') setPicked(rows.filter((d) => d.id !== 'credential' && !d.ok).map((d) => d.id))
+        else setPicked(rows.filter((d) => d.removable && d.ok).map((d) => d.id))
+        setDlg(kind)
+      }
+      const toggle = (id) => setPicked((p) => (p.includes(id) ? p.filter((x) => x !== id) : [...p, id]))
+
+      const confirmDlg = async () => {
+        const kind = dlg
+        setDlg(null)
+        if (kind === 'download') {
+          if (!picked.length) {
+            setMsg('没有勾选可下载的项。')
+            return
+          }
+          for (const t of picked) {
+            try {
+              await jpost('/download', { target: t })
+            } catch {}
+          }
+          setMsg(`已启动 ${picked.length} 个下载（后台跑，过一会儿刷新看状态）。`)
+          return
+        }
+        if (!picked.length) {
+          setMsg('没有勾选可清理的项。')
+          return
+        }
+        try {
+          const j = await jpost('/delete', { targets: picked })
+          const d = j.data || {}
+          const skipped = (d.skipped || []).map((s) => `${s.id}（${s.why}）`).join('、')
+          setMsg(`已删除：${(d.deleted || []).join('、') || '无'}` + (skipped ? `；跳过：${skipped}` : ''))
+          await load()
+        } catch (e) {
+          setMsg('删除失败：' + String(e?.message || e))
+        }
+      }
+
+      const delOne = async (target) => {
+        const row = rows.find((d) => d.id === target)
+        const label = target === 'credential' ? '登录凭证（删了要重新扫码）' : (row?.name || target)
+        if (typeof window !== 'undefined' && typeof window.confirm === 'function') {
+          if (!window.confirm(`确定删除 ${label}？`)) return
+        }
+        try {
+          const j = await jpost('/delete', { targets: [target] })
+          const d = j.data || {}
+          const skipped = (d.skipped || []).map((s) => s.why).join('、')
+          setMsg(d.deleted?.length ? `已删除 ${target}` : `没删：${skipped || '未知原因'}`)
+          await load()
+        } catch (e) {
+          setMsg('删除失败：' + String(e?.message || e))
+        }
+      }
+
+      if (err) return h('div', { 'data-bl-page': '' }, h('div', { 'data-bl-bad': '' }, '状态读取失败：' + err))
+      if (!st) return h('div', { 'data-bl-page': '' }, h('div', { 'data-bl-note': '' }, '读取中…'))
+
+      const deps = st.deps || []
+      const cache = st.cache || { bytes: 0, files: 0 }
+      const lastRun = st.lastRun || {}
+
+      return h('div', { 'data-bl-page': '' },
+        h('div', { 'data-bl-head': '' },
+          h('span', { 'data-bl-title': '' }, '依赖与状态'),
+          h('span', { 'data-bl-sub': '' }, '缺什么点下载，装好后这里会变绿。')),
+        h('div', { 'data-bl-sec': '' },
+          h('div', { 'data-bl-sechead': '' },
+            h('span', { 'data-bl-sec-title': '' }, '运行依赖'),
+            h('button', { 'data-bl-btn': '', onClick: () => openDlg('download') }, '批量下载'),
+            h('button', { 'data-bl-btn': '', onClick: () => openDlg('clean') }, '批量清理')),
+          ...deps.map((d) => h(DepRow, { key: d.id, d, busy: busy === d.id, onDownload: download, onDelete: delOne })),
+          h('div', { 'data-bl-note': '' },
+            '下载在后台跑，用插件自带的 fetch-deps 脚本；体积是预估，实际以跑完为准。')),
+        dlg
+          ? h('div', { 'data-bl-sec': '', 'data-bl-dlg': '' },
+              h('span', { 'data-bl-sec-title': '' }, dlg === 'download' ? '批量下载（默认全勾选，可取消）' : '批量清理（默认全勾选，可取消）'),
+              ...(dlg === 'download'
+                ? deps
+                    .filter((d) => d.id !== 'credential')
+                    .map((d) =>
+                      h('label', { 'data-bl-dlgrow': '' },
+                        h('input', { type: 'checkbox', checked: picked.includes(d.id), disabled: d.ok, onChange: () => toggle(d.id) }),
+                        h('span', { 'data-bl-name': '' }, d.name),
+                        h('span', { 'data-bl-size': '' }, d.estimate),
+                        d.ok ? h('span', { 'data-bl-good': '' }, '已就绪，跳过') : null),
+                    )
+                : deps.map((d) =>
+                    h('label', { 'data-bl-dlgrow': '' },
+                      h('input', {
+                        type: 'checkbox',
+                        checked: picked.includes(d.id),
+                        disabled: !d.removable || !d.ok,
+                        onChange: () => toggle(d.id),
+                      }),
+                      h('span', { 'data-bl-name': '' }, d.name),
+                      h('span', { 'data-bl-size': '' }, d.path || ''),
+                      d.removable
+                        ? d.ok
+                          ? h('span', { 'data-bl-good': '' }, '可清理')
+                          : h('span', { 'data-bl-note': '' }, '没有可删的')
+                        : h('span', { 'data-bl-note': '' }, d.removableWhy || '不在插件目录内'),
+                    ),
+                  )),
+              h('div', { 'data-bl-row': '' },
+                h('button', { 'data-bl-btn': '', onClick: confirmDlg }, dlg === 'download' ? '开始下载' : '确认删除'),
+                h('button', { 'data-bl-btn': '', onClick: () => setDlg(null) }, '取消')))
+          : null,
+        qr
+          ? h('div', { 'data-bl-sec': '' },
+              h('span', { 'data-bl-sec-title': '' }, '扫码登录'),
+              h('div', { 'data-bl-qrbox': '' },
+                h('span', { 'data-bl-qr': '', dangerouslySetInnerHTML: { __html: qr.svg } }),
+                h('div', { 'data-bl-qrside': '' },
+                  h('div', { 'data-bl-note': '' },
+                    qrState === 'scanned'
+                      ? '已扫码，请在手机 B 上点确认。'
+                      : qrState === 'loading'
+                        ? '正在生成二维码…'
+                        : '用手机 B 站「扫一扫」扫左边这张；扫完这里会自动变绿。'),
+                  h('button', { 'data-bl-btn': '', onClick: () => { setQr(null); setQrState('') } }, '取消'))))
+          : null,
+        h('div', { 'data-bl-sec': '' },
+          h('span', { 'data-bl-sec-title': '' }, '抽帧缓存'),
+          h('div', { 'data-bl-row': '' },
+            h('span', { 'data-bl-name': '' }, '当前占用'),
+            h('span', { 'data-bl-detail': '' }, `${fmtBytes(cache.bytes)} / ${cache.files} 个文件`),
+            h('button', { 'data-bl-btn': '', onClick: saveCache }, '立即清除')),
+          h('div', { 'data-bl-row': '' },
+            h('span', { 'data-bl-name': '' }, '自动清理规则'),
+            h('span', { 'data-bl-detail': '' },
+              '保留 ',
+              h('input', { 'data-bl-input': '', value: days, onChange: (e) => setDays(e.target.value), inputMode: 'numeric' }),
+              ' 天；总量超过 ',
+              h('input', { 'data-bl-input': '', value: maxMb, onChange: (e) => setMaxMb(e.target.value), inputMode: 'numeric' }),
+              ' MB 时从最旧的删。'),
+            h('button', { 'data-bl-btn': '', onClick: saveRule }, '保存规则')),
+          h('div', { 'data-bl-note': '' },
+            '不点也会按上面的规则自动清（每次打开面板与插件启动时检查一次）。')),
+        h('div', { 'data-bl-sec': '' },
+          h('span', { 'data-bl-sec-title': '' }, '最近一次调用'),
+          h('div', { 'data-bl-row': '' },
+            h('span', { 'data-bl-name': '' }, lastRun.command || '—'),
+            h('span', { 'data-bl-detail': '' }, lastRun.time ? `${fmtTime(lastRun.time)}（${lastRun.ok ? '成功' : '失败'}）` : '还没有记录'),
+            h('button', { 'data-bl-btn': '', onClick: load }, '刷新'))),
+        msg ? h('div', { 'data-bl-note': '' }, msg) : null,
+      )
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        const style = document.createElement('style')
+        style.setAttribute('data-plugin-css', 'dsh-bili-watch')
+        style.textContent = CSS
+        document.head.appendChild(style)
+        if (typeof ctx.effect === 'function') ctx.effect(() => () => style.remove(), 'dsh-bili-watch: 面板样式')
+
+        const slots = (typeof ctx.get === 'function' ? ctx.get('slots') : undefined) || ctx.slots
+        if (!slots) return
+        // 插件详情页的配置区：key 用包名，按包页面 dispatch（见 Slot 清单 plugins.bundle.config）
+        slots.inject('plugins.bundle.config', () => slots.register(
+          { name: 'plugins.bundle.config', key: PKG },
+          Panel,
+        ))
+      },
+    }
+  },
+})

package/index.js

@@ -7,19 +7,59 @@
  *
  * 两侧执行同一份 lookup：spawn 插件自带的只读工具
  *   <插件目录>\tools\look.mjs
- * 只读、默认匿名：不修改任何状态，可反复调用。
+ * 只读、匿名，不改任何业务状态。
  */
 import { spawn } from 'node:child_process'
+import { appendFileSync, existsSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { defineTool } from '@deepseek-ai/dsh-tools'
+import QRCode from 'qrcode'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const LOOK = join(HERE, 'tools', 'look.mjs')
 const COMMANDS = ['search', 'hot', 'peek', 'view', 'sub', 'comments', 'danmaku', 'asr', 'frames', 'sheet', 'substrip', 'ocr', 'text', 'login', 'clean']
 
+// 设置页端点读的落点，与 tools/look.mjs 同源（look.mjs:41/52/54/46/48/51）
+const DEPS = join(HERE, 'deps')
+const PROJ = process.env.BILI_WATCH_PROJ || DEPS
+const CRED_FILE = join(DEPS, 'credential.json')
+const LAST_RUN = join(DEPS, 'last-run.json')
+const CACHE = join(tmpdir(), 'bili-watch')
+const PY_DIR = process.platform === 'win32' ? 'Scripts' : 'bin'
+const PY_EXE = process.platform === 'win32' ? 'python.exe' : 'python'
+const VENV_ASR = [join(DEPS, '.venv-asr', PY_DIR, PY_EXE), join(PROJ, '.venv-asr', PY_DIR, PY_EXE)]
+const VENV_OCR = [join(DEPS, '.venv-ocr', PY_DIR, PY_EXE), join(PROJ, '.venv-ocr', PY_DIR, PY_EXE)]
+const FFMPEG_CANDS = [
+  process.env.BILI_WATCH_FFMPEG,
+  join(DEPS, process.platform === 'win32' ? 'ffmpeg.exe' : 'ffmpeg'),
+].filter(Boolean)
+const HF_HOME = [join(DEPS, '.hf-home'), join(PROJ, '.hf-home')]
+const SCRIPTS = join(HERE, 'scripts')
+const CACHE_CFG = join(DEPS, 'cache-config.json')
+const DEFAULT_CACHE_DAYS = 7
+const DEFAULT_CACHE_MAX_MB = 2048
+const DOWNLOAD_LOG = join(DEPS, 'download.log')
+// 一键下载的预估体积，只给面板显示，不参与逻辑
+const ESTIMATES = {
+  ffmpeg: '约 94 MB',
+  ytdlp: '约 17 MB',
+  asr: '约 294 MB（venv）',
+  ocr: '约 263 MB（venv）',
+  model: '约 464 MB',
+}
+
+// 面板内扫码登录（与 tools/look.mjs 的 login 同一套接口，凭证落同一个文件）
+const UA =
+  'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
+const QR_GEN = 'https://passport.bilibili.com/x/passport-login/web/qrcode/generate?source=main-fe-header'
+const QR_POLL = (key) =>
+  'https://passport.bilibili.com/x/passport-login/web/qrcode/poll?qrcode_key=' + encodeURIComponent(key) + '&source=main-fe-header'
+const SPI = 'https://api.bilibili.com/x/frontend/finger/spi'
+
 const name = 'dsh-bili-watch'
-const inject = ['commands', 'tools']
+const inject = ['commands', 'tools', 'webServer']
 
 function runLook(args, { timeoutMs = 1_200_000 } = {}) {
   return new Promise((resolve) => {
@@ -61,6 +101,382 @@ function runLook(args, { timeoutMs = 1_200_000 } = {}) {
   })
 }
 
+// ── 面板内扫码登录 ─────────────────────────────────────────────────────────
+/** 从 poll 响应的 Set-Cookie 里挑登录需要的几个 cookie。 */
+function pickLoginCookies(list) {
+  const jar = {}
+  const want = { SESSDATA: 'sessdata', bili_jct: 'bili_jct', DedeUserID: 'dedeuserid', buvid3: 'buvid3', buvid4: 'buvid4' }
+  for (const raw of list ?? []) {
+    const first = String(raw).split(';')[0] || ''
+    const i = first.indexOf('=')
+    if (i <= 0) continue
+    const k = first.slice(0, i).trim()
+    const v = first.slice(i + 1).trim()
+    if (want[k] && v) jar[want[k]] = v
+  }
+  return jar
+}
+
+/** poll 往往只给 buvid3，buvid4 走 finger/spi 补。 */
+async function fillBuvids(jar) {
+  if (jar.buvid3 && jar.buvid4) return jar
+  try {
+    const r = await fetch(SPI, { headers: { 'User-Agent': UA } })
+    const j = await r.json()
+    if (!jar.buvid3 && j?.data?.b_3) jar.buvid3 = j.data.b_3
+    if (!jar.buvid4 && j?.data?.b_4) jar.buvid4 = j.data.b_4
+  } catch {}
+  return jar
+}
+
+/** 生成扫码登录二维码：返回 qrcode_key 与可直接插进页面的 SVG。 */
+async function loginQr() {
+  const r = await fetch(QR_GEN, { headers: { 'User-Agent': UA } })
+  const j = await r.json()
+  const d = j?.data
+  if (!d?.url || !d?.qrcode_key) return { ok: false, why: j?.message || '生成二维码失败' }
+  let svg = ''
+  try {
+    svg = await QRCode.toString(d.url, { type: 'svg', margin: 1, width: 220, errorCorrectionLevel: 'M' })
+  } catch (e) {
+    return { ok: false, why: `二维码渲染失败：${e?.message ?? e}` }
+  }
+  return { ok: true, data: { key: d.qrcode_key, url: d.url, svg } }
+}
+
+/**
+ * 轮询一次扫码结果（前端每 2.5 秒调一次）。
+ * 成功时把凭证写进 deps\credential.json——与 tools/look.mjs login --poll 同一个格式。
+ */
+async function loginPollOnce(key) {
+  if (!key) return { ok: false, state: 'error', why: '缺少二维码 key' }
+  const res = await fetch(QR_POLL(key), { headers: { 'User-Agent': UA }, redirect: 'manual' })
+  const setCookies = typeof res.headers.getSetCookie === 'function' ? res.headers.getSetCookie() : []
+  let body = {}
+  try {
+    body = await res.json()
+  } catch {}
+  const code = body?.data?.code
+  if (code === 0) {
+    const jar = await fillBuvids(pickLoginCookies(setCookies))
+    if (!jar.sessdata) return { ok: false, state: 'error', why: '登录成功但响应里没有 SESSDATA' }
+    try {
+      writeFileSync(
+        CRED_FILE,
+        JSON.stringify(
+          {
+            sessdata: jar.sessdata,
+            bili_jct: jar.bili_jct || '',
+            buvid3: jar.buvid3 || '',
+            buvid4: jar.buvid4 || '',
+            mid: jar.dedeuserid || '',
+            note: '扫码登录（插件面板），只用于读取 AI 字幕',
+            updatedAt: new Date().toISOString(),
+          },
+          null,
+          2,
+        ),
+        'utf8',
+      )
+    } catch (e) {
+      return { ok: false, state: 'error', why: `凭证写入失败：${e?.message ?? e}` }
+    }
+    return { ok: true, state: 'ok', data: { mid: jar.dedeuserid || '' } }
+  }
+  const map = { 86101: 'waiting', 86090: 'scanned', 86038: 'expired' }
+  return { ok: false, state: map[code] ?? 'error', why: code === undefined ? body?.message || 'poll 返回异常' : '' }
+}
+
+// ── 设置页状态（只读端点 + 清缓存按钮）──────────────────────────────────────
+function writeLastRun(command, code) {
+  try {
+    writeFileSync(LAST_RUN, JSON.stringify({ time: new Date().toISOString(), command, code, ok: code === 0 }), 'utf8')
+  } catch {}
+}
+
+function readLastRun() {
+  try {
+    const j = JSON.parse(readFileSync(LAST_RUN, 'utf8'))
+    return { time: j.time ?? null, command: j.command ?? null, ok: j.ok ?? null }
+  } catch {
+    return { time: null, command: null, ok: null }
+  }
+}
+
+function credState() {
+  if (!existsSync(CRED_FILE)) return { exists: false, state: 'missing', updatedAt: null, ageDays: null }
+  try {
+    const j = JSON.parse(readFileSync(CRED_FILE, 'utf8'))
+    const t = j.updatedAt || statSync(CRED_FILE).mtime.toISOString()
+    const ageDays = Math.max(0, Math.floor((Date.now() - new Date(t).getTime()) / 86400000))
+    return { exists: true, state: ageDays > 30 ? 'expired' : 'ok', updatedAt: t, ageDays }
+  } catch {
+    return { exists: true, state: 'unknown', updatedAt: null, ageDays: null }
+  }
+}
+
+function dirStat(dir) {
+  let bytes = 0
+  let files = 0
+  const walk = (d) => {
+    for (const e of readdirSync(d, { withFileTypes: true })) {
+      const p = join(d, e.name)
+      if (e.isDirectory()) walk(p)
+      else {
+        files += 1
+        try {
+          bytes += statSync(p).size
+        } catch {}
+      }
+    }
+  }
+  try {
+    walk(dir)
+  } catch {}
+  return { bytes, files }
+}
+
+/** 缓存目录里每个文件的 { path, size, mtime }，用于按天数/总量清理。 */
+function walkEntries(dir) {
+  const out = []
+  const walk = (d) => {
+    let list = []
+    try {
+      list = readdirSync(d, { withFileTypes: true })
+    } catch {
+      return
+    }
+    for (const e of list) {
+      const p = join(d, e.name)
+      if (e.isDirectory()) walk(p)
+      else {
+        try {
+          const st = statSync(p)
+          out.push({ path: p, size: st.size, mtime: st.mtimeMs })
+        } catch {}
+      }
+    }
+  }
+  walk(dir)
+  return out
+}
+
+function cacheCfg() {
+  try {
+    const j = JSON.parse(readFileSync(CACHE_CFG, 'utf8'))
+    return {
+      days: Number.isFinite(j.days) ? Math.max(1, j.days) : DEFAULT_CACHE_DAYS,
+      maxMb: Number.isFinite(j.maxMb) ? Math.max(100, j.maxMb) : DEFAULT_CACHE_MAX_MB,
+    }
+  } catch {
+    return { days: DEFAULT_CACHE_DAYS, maxMb: DEFAULT_CACHE_MAX_MB }
+  }
+}
+
+function writeCacheCfg(days, maxMb) {
+  try {
+    writeFileSync(CACHE_CFG, JSON.stringify({ days, maxMb }), 'utf8')
+  } catch {}
+}
+
+/**
+ * 缓存自动清理：先按天数删过期文件，再按总量从最旧删到阈值内。
+ * 返回被删统计，供面板显示。
+ */
+function autoCleanCache() {
+  if (!existsSync(CACHE)) return { removed: 0, bytes: 0 }
+  const { days, maxMb } = cacheCfg()
+  const cutoff = Date.now() - days * 86400000
+  const limit = maxMb * 1024 * 1024
+  const entries = walkEntries(CACHE)
+  let removed = 0
+  let bytes = 0
+  const fresh = []
+  for (const e of entries) {
+    if (e.mtime < cutoff) {
+      try {
+        rmSync(e.path, { force: true })
+        removed += 1
+        bytes += e.size
+      } catch {}
+    } else {
+      fresh.push(e)
+    }
+  }
+  let total = fresh.reduce((n, e) => n + e.size, 0)
+  if (total > limit) {
+    fresh.sort((a, b) => a.mtime - b.mtime)
+    for (const e of fresh) {
+      try {
+        rmSync(e.path, { force: true })
+        removed += 1
+        bytes += e.size
+        total -= e.size
+      } catch {}
+      if (total <= limit) break
+    }
+  }
+  return { removed, bytes }
+}
+
+/** 面板上的依赖行：一条依赖一个状态 + 体积 + 是否需要下载。 */
+function depRows() {
+  const ffmpeg = FFMPEG_CANDS.find((p) => existsSync(p)) || ''
+  let ffmpegSize = 0
+  try {
+    ffmpegSize = ffmpeg ? statSync(ffmpeg).size : 0
+  } catch {}
+  const ytdlp = join(DEPS, process.platform === 'win32' ? 'yt-dlp.exe' : 'yt-dlp')
+  let ytdlpSize = 0
+  try {
+    ytdlpSize = existsSync(ytdlp) ? statSync(ytdlp).size : 0
+  } catch {}
+  const asrPython = VENV_ASR.find((p) => existsSync(p)) || ''
+  const ocrPython = VENV_OCR.find((p) => existsSync(p)) || ''
+  const model = HF_HOME.find((d) => existsSync(d)) || ''
+  const rows = [
+    {
+      id: 'ffmpeg',
+      name: 'ffmpeg（抽帧 / 取音轨）',
+      ok: Boolean(ffmpeg),
+      detail: ffmpeg || '没找到，抽帧与转写取音轨会失败',
+      path: ffmpeg,
+      removable: false,
+      removableWhy: '在插件目录外，这里不删',
+      size: ffmpegSize,
+      estimate: ESTIMATES.ffmpeg,
+    },
+    {
+      id: 'ytdlp',
+      name: 'yt-dlp（通用 URL）',
+      ok: existsSync(ytdlp),
+      detail: existsSync(ytdlp) ? ytdlp : '没找到，非 B 站 URL 不可用',
+      path: ytdlp,
+      removable: true,
+      size: ytdlpSize,
+      estimate: ESTIMATES.ytdlp,
+    },
+    {
+      id: 'asr',
+      name: 'ASR 环境（本地转写）',
+      ok: Boolean(asrPython),
+      detail: asrPython || '没找到 python 环境，无字幕视频无法转写',
+      path: asrPython,
+      removable: false,
+      removableWhy: '在插件目录外，这里不删',
+      size: asrPython ? dirStat(join(asrPython, '..', '..')).bytes : 0,
+      estimate: ESTIMATES.asr,
+    },
+    {
+      id: 'ocr',
+      name: 'OCR 环境（画面文字）',
+      ok: Boolean(ocrPython),
+      detail: ocrPython || '没找到 python 环境，画面文字无法识别',
+      path: ocrPython,
+      removable: false,
+      removableWhy: '在插件目录外，这里不删',
+      size: ocrPython ? dirStat(join(ocrPython, '..', '..')).bytes : 0,
+      estimate: ESTIMATES.ocr,
+    },
+    {
+      id: 'model',
+      name: '转写模型（faster-whisper small）',
+      ok: Boolean(model),
+      detail: model || '没找到模型目录，本地转写不可用',
+      path: model,
+      removable: true,
+      size: model ? dirStat(model).bytes : 0,
+      estimate: ESTIMATES.model,
+    },
+  ]
+  const cred = credState()
+  rows.push({
+    id: 'credential',
+    name: 'B 站登录凭证',
+    ok: cred.state === 'ok',
+    detail: cred.exists ? `更新于 ${cred.updatedAt ?? '未知时间'}（${cred.ageDays ?? '?'} 天前）` : '没登录，AI 字幕与部分接口不可用',
+    path: CRED_FILE,
+    removable: true,
+    size: 0,
+    estimate: '扫码登录',
+  })
+  return rows
+}
+
+/** 一键下载：跑插件自带的 fetch-deps 脚本，后台执行，返回日志路径。 */
+function runDownload(target) {
+  const script = join(SCRIPTS, 'fetch-deps.ps1')
+  if (!existsSync(script)) return { started: false, why: '插件目录里没有 scripts/fetch-deps.ps1' }
+  const allowed = ['ffmpeg', 'ytdlp', 'asr', 'ocr', 'model', 'all']
+  if (!allowed.includes(target)) return { started: false, why: `不支持的依赖：${target}` }
+  try {
+    appendFileSync(DOWNLOAD_LOG, `[${new Date().toISOString()}] 开始下载 ${target}\n`, 'utf8')
+  } catch {}
+  const child = spawn(
+    'powershell.exe',
+    ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, '-Target', target],
+    { windowsHide: true, stdio: 'ignore', detached: true },
+  )
+  child.unref()
+  return { started: true, log: DOWNLOAD_LOG }
+}
+
+/**
+ * 删除插件 deps\ 里的依赖。
+ * 只认这三个：yt-dlp、模型目录、登录凭证；ffmpeg / ASR / OCR 在插件目录外，一律跳过。
+ */
+function deleteDeps(targets) {
+  const map = {
+    ytdlp: join(DEPS, process.platform === 'win32' ? 'yt-dlp.exe' : 'yt-dlp'),
+    model: join(DEPS, '.hf-home'),
+    credential: CRED_FILE,
+  }
+  const deleted = []
+  const skipped = []
+  for (const t of targets) {
+    const p = map[t]
+    if (!p) {
+      skipped.push({ id: t, why: '不在插件目录内，不能从这里删' })
+      continue
+    }
+    try {
+      if (!existsSync(p)) {
+        skipped.push({ id: t, why: '本来就不存在' })
+        continue
+      }
+      rmSync(p, { recursive: true, force: true })
+      deleted.push(t)
+    } catch (e) {
+      skipped.push({ id: t, why: String(e?.message || e) })
+    }
+  }
+  return { deleted, skipped }
+}
+
+function sendJson(res, code, obj) {
+  res.writeHead(code, { 'content-type': 'application/json; charset=utf-8' })
+  res.end(JSON.stringify(obj))
+}
+
+/** 读 POST 的小 JSON body；读不到就返回 {}，端点自己决定默认值。 */
+function readJsonBody(req) {
+  return new Promise((resolve) => {
+    let raw = ''
+    req.on('data', (d) => {
+      raw += d
+      if (raw.length > 65536) req.destroy()
+    })
+    req.on('end', () => {
+      try {
+        resolve(JSON.parse(raw))
+      } catch {
+        resolve({})
+      }
+    })
+    req.on('error', () => resolve({}))
+  })
+}
+
 /** 把 "text BV1xx --cred path --step 2" 拆成 { command, bv, extra }。 */
 function parseCommandLine(raw) {
   const tokens = String(raw ?? '')
@@ -118,11 +534,19 @@ async function lookup({ command, bv, extra = [] }) {
           ? ['hot', ...extra]
           : [command, bv, ...extra]
   const r = await runLook(args)
+  // login 只生成二维码，真正的登录成功由面板 poll 写；命令层不记 lastRun，避免「生成成功」被读成「已登录」
+  if (command !== 'login') writeLastRun(command, r.code)
   const text = (r.out || r.err || '').trim() || '（没有输出）'
   return { ok: r.code === 0, text }
 }
 
 function apply(ctx) {
+  // 启动时按「天数 + 总量阈值」清一次缓存，不点按钮也不会无限涨
+  try {
+    const r = autoCleanCache()
+    if (r.removed) ctx.logger?.info?.(`[dsh-bili-watch] 自动清理缓存 ${r.removed} 个文件 / ${(r.bytes / 1048576).toFixed(1)} MB`)
+  } catch {}
+
   // ① 斜杠命令：人敲，确定性执行，不花推理 token
   ctx.commands.register({
     definitionId: 'dsh-bili-watch',
@@ -185,14 +609,6 @@ function apply(ctx) {
         type: 'string',
         description: 'command=sheet 时的格子，如 3x3 或 4x4（默认 3x3）。',
       },
-      limit: {
-        type: 'number',
-        description: 'command=search 时最多返回几条（默认 10）、command=hot 时取前 N 条（默认 10）。',
-      },
-      cred: {
-        type: 'string',
-        description: '可选的 B 站凭证 JSON 路径（只在 command=sub/text 时需要；不传就匿名，匿名拿不到 AI 字幕轨）。',
-      },
     },
     output: {
       // 注意：DSH 的 output.schema 是「author-facing spec」，编译时 allowRequired=false，
@@ -217,12 +633,9 @@ function apply(ctx) {
       if (typeof args.grid === 'string' && args.grid.trim()) extra.push('--grid', args.grid.trim())
       if (typeof args.days === 'number' && args.days > 0) extra.push('--days', String(Math.floor(args.days)))
       if (args.command === 'hot') {
-        if (typeof args.limit === 'number' && args.limit > 0) extra.push('--limit', String(Math.floor(args.limit)))
-        const r = await lookup({ command: 'hot', bv: '', extra })
+        const r = await lookup({ command: 'hot', bv: '' })
         return { ok: r.ok, text: r.text }
       }
-      if (typeof args.limit === 'number' && args.limit > 0) extra.push('--limit', String(Math.floor(args.limit)))
-      if (typeof args.cred === 'string' && args.cred.trim()) extra.push('--cred', args.cred.trim())
       const target = args.command === 'search' ? String(args.keyword ?? '').trim() : String(args.bv ?? '').trim()
       if (args.command === 'search' && !target) return { ok: false, text: 'search 需要 keyword 参数（要搜什么词）' }
       if (!target) return { ok: false, text: '缺少 BV 号或分享链接' }
@@ -230,6 +643,79 @@ function apply(ctx) {
       return { ok: r.ok, text: r.text }
     },
   }))
+
+  // ③ 设置页：读盘状态 + 清缓存（只读优先；唯一写操作是删本机抽帧缓存目录）
+  try {
+    ctx.effect(
+      () =>
+        ctx.webServer.register({
+          kind: 'prefix',
+          path: '/api/bili-watch',
+          handler: async (req, res) => {
+            try {
+              const url = new URL(req.url, 'http://127.0.0.1')
+              if (req.method === 'GET' && url.pathname === '/api/bili-watch/status') {
+                const cleaned = autoCleanCache()
+                return sendJson(res, 200, {
+                  ok: true,
+                  data: {
+                    credential: credState(),
+                    deps: depRows(),
+                    cache: { ...dirStat(CACHE), ...cacheCfg(), lastAutoClean: cleaned },
+                    lastRun: readLastRun(),
+                  },
+                })
+              }
+              if (req.method === 'POST' && url.pathname === '/api/bili-watch/cache/clear') {
+                const body = await readJsonBody(req)
+                if (Number.isFinite(body?.days) || Number.isFinite(body?.maxMb)) {
+                  writeCacheCfg(
+                    Number.isFinite(body?.days) ? Math.max(1, body.days) : cacheCfg().days,
+                    Number.isFinite(body?.maxMb) ? Math.max(100, body.maxMb) : cacheCfg().maxMb,
+                  )
+                }
+                const before = dirStat(CACHE)
+                try {
+                  rmSync(CACHE, { recursive: true, force: true })
+                } catch {}
+                return sendJson(res, 200, { ok: true, data: { removed: before.files, bytes: before.bytes } })
+              }
+              if (req.method === 'POST' && url.pathname === '/api/bili-watch/download') {
+                const body = await readJsonBody(req)
+                const targets = Array.isArray(body?.targets) ? body.targets.map(String) : [String(body?.target ?? '')]
+                const results = targets.map((t) => runDownload(t))
+                const started = results.filter((r) => r.started).length
+                return sendJson(res, started ? 200 : 400, { ok: started > 0, data: { results, started } })
+              }
+              if (req.method === 'POST' && url.pathname === '/api/bili-watch/delete') {
+                const body = await readJsonBody(req)
+                const targets = Array.isArray(body?.targets) ? body.targets.map(String) : [String(body?.target ?? '')]
+                const r = deleteDeps(targets)
+                return sendJson(res, 200, { ok: true, data: r })
+              }
+              if (req.method === 'POST' && url.pathname === '/api/bili-watch/login/qr') {
+                const r = await loginQr()
+                return sendJson(res, r.ok ? 200 : 502, r)
+              }
+              if (req.method === 'POST' && url.pathname === '/api/bili-watch/login/poll') {
+                const body = await readJsonBody(req)
+                const r = await loginPollOnce(String(body?.key ?? ''))
+                if (r.state === 'ok') writeLastRun('login', 0)
+                return sendJson(res, 200, r)
+              }
+              sendJson(res, 404, { ok: false, why: 'not found' })
+            } catch (e) {
+              sendJson(res, 500, { ok: false, why: String(e?.message || e) })
+            }
+          },
+        }),
+      'dsh-bili-watch: /api/bili-watch 设置页端点',
+    )
+  } catch (e) {
+    try {
+      ctx.logger?.info?.(`[dsh-bili-watch] 设置页端点没挂上：${e?.message ?? e}`)
+    } catch {}
+  }
 }
 
 export { apply, inject, name }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bili-watch",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "private": false,
   "description": "Bilibili video reader for DSH: subtitles, ASR, frame OCR, comments, danmaku.",
   "type": "module",
@@ -10,16 +10,25 @@
   },
   "exports": {
     ".": "./index.js",
+    "./client": "./client.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json"
   },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
     }
   },
   "files": [
     "index.js",
+    "client.js",
     "cordis.patch.yml",
     "tools/",
     "scripts/",

package/scripts/fetch-deps.ps1

@@ -39,7 +39,7 @@ $Root = Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path)
 $Deps = Join-Path $Root 'deps'
 if (-not $DryRun) { New-Item -ItemType Directory -Force -Path $Deps | Out-Null }
 
-$UseCn = ($Mirror -eq 'cn') -or (($Mirror -eq 'auto') -and ($env:BILI_LOOK_MIRROR -eq 'cn'))
+$UseCn = ($Mirror -eq 'cn') -or (($Mirror -eq 'auto') -and ($env:BILI_WATCH_MIRROR -eq 'cn'))
 $GhProxy = if ($UseCn) { 'https://gh-proxy.com/' } else { '' }
 $PyIndex = if ($UseCn) { 'https://pypi.tuna.tsinghua.edu.cn/simple' } else { 'https://pypi.org/simple' }
 $HfEndpoint = if ($UseCn) { 'https://hf-mirror.com' } else { 'https://huggingface.co' }
@@ -75,7 +75,7 @@ function Ensure-Ffmpeg {
     # 80 MB 的 BtbN zip 在 GitHub 直连不稳时大概率断流；给替代路径，别让安装卡死在这
     Write-Warning 'ffmpeg 下载失败。可选替代路径：'
     Write-Host '  1) 手动下载 ffmpeg.exe 放进 deps\ 后重跑本脚本（会自动跳过）'
-    Write-Host '  2) 已有 ffmpeg 时设 $env:BILI_LOOK_FFMPEG = <ffmpeg.exe 路径>'
+    Write-Host '  2) 已有 ffmpeg 时设 $env:BILI_WATCH_FFMPEG = <ffmpeg.exe 路径>'
     Write-Host '  3) 换镜像重试：-Mirror cn（走 gh-proxy）'
     throw 'ffmpeg 未安装（见上面的替代路径）'
   }

package/scripts/fetch-deps.sh

@@ -4,7 +4,7 @@
 # 用法：
 #   bash scripts/fetch-deps.sh all
 #   bash scripts/fetch-deps.sh ytdlp
-#   BILI_LOOK_MIRROR=cn bash scripts/fetch-deps.sh all   # 国内网络
+#   BILI_WATCH_MIRROR=cn bash scripts/fetch-deps.sh all   # 国内网络
 #
 # 目标：
 #   ffmpeg  只提示用系统包管理器安装（脚本不下载）
@@ -19,7 +19,7 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 DEPS="$ROOT/deps"
 mkdir -p "$DEPS"
 TARGET="${1:-all}"
-MIRROR="${BILI_LOOK_MIRROR:-}"
+MIRROR="${BILI_WATCH_MIRROR:-}"
 
 if [ "$MIRROR" = "cn" ]; then
   GH="https://gh-proxy.com/https://github.com"

package/tools/look.mjs

@@ -36,9 +36,9 @@ import { tmpdir } from 'node:os'
 import { fileURLToPath } from 'node:url'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
-// 依赖自包含：优先用插件目录 deps\ 下的环境，缺失时回退 BILI_LOOK_PROJ
+// 依赖自包含：优先用插件目录 deps\ 下的环境，缺失时回退 BILI_WATCH_PROJ
 const DEPS = join(HERE, '..', 'deps')
-const PROJ = process.env.BILI_LOOK_PROJ || DEPS
+const PROJ = process.env.BILI_WATCH_PROJ || DEPS
 const pick = (...cands) => cands.find((p) => existsSync(p)) ?? cands[cands.length - 1]
 const PY_DIR = process.platform === 'win32' ? 'Scripts' : 'bin'
 const PY_EXE = process.platform === 'win32' ? 'python.exe' : 'python'
@@ -47,10 +47,10 @@ const ASR_SCRIPT = pick(join(DEPS, '_bili-asr.py'), join(PROJ, '_bili-asr.py'))
 const OCR_PY = pick(join(DEPS, '.venv-ocr', PY_DIR, PY_EXE), join(PROJ, '.venv-ocr', PY_DIR, PY_EXE))
 const HF_HOME_DIR = pick(join(DEPS, '.hf-home'), join(PROJ, '.hf-home'))
 const OCR_SCRIPT = join(HERE, 'ocr.py')
-const FFMPEG_CAND = process.env.BILI_LOOK_FFMPEG || ''
+const FFMPEG_CAND = process.env.BILI_WATCH_FFMPEG || ''
 // 缺 ffmpeg 时的统一指路（一键脚本 / 环境变量 / --ffmpeg 三条出路）
 const FFMPEG_HINT =
-  '跑 scripts/fetch-deps.ps1 -Target ffmpeg（macOS/Linux：bash scripts/fetch-deps.sh 或系统包管理器装），或设 BILI_LOOK_FFMPEG，或用 --ffmpeg 传路径'
+  '跑 scripts/fetch-deps.ps1 -Target ffmpeg（macOS/Linux：bash scripts/fetch-deps.sh 或系统包管理器装），或设 BILI_WATCH_FFMPEG，或用 --ffmpeg 传路径'
 const CACHE = join(tmpdir(), 'bili-watch')
 const require = createRequire(import.meta.url)
 const CRED_FILE = join(DEPS, 'credential.json')
@@ -1112,7 +1112,7 @@ async function cmdLogin(opts = {}) {
   try { chmodSync(LOGIN_KEY_FILE, 0o600) } catch {}
 }
 
-const SEEN_FILE = process.env.BILI_LOOK_SEEN || join(DEPS, 'seen.md')
+const SEEN_FILE = process.env.BILI_WATCH_SEEN || join(DEPS, 'seen.md')
 
 /**
  * 往项目判重表追加一行「看过」。只在 --mark-seen 时调用：
@@ -1260,7 +1260,7 @@ function resolveSource(input) {
 // 定位 yt-dlp：环境变量 → 插件 deps\yt-dlp.exe → PATH；找到后 --version 验一次
 function findYtDlp() {
   const localExe = process.platform === 'win32' ? 'yt-dlp.exe' : 'yt-dlp'
-  const cands = [process.env.BILI_LOOK_YTDLP, join(DEPS, localExe), 'yt-dlp'].filter(Boolean)
+  const cands = [process.env.BILI_WATCH_YTDLP, join(DEPS, localExe), 'yt-dlp'].filter(Boolean)
   for (const c of cands) {
     if (c !== 'yt-dlp' && !existsSync(c)) continue
     try {
@@ -1488,7 +1488,7 @@ const HELP = `用法:
 
   多 P 视频加 --p N 指定第几个分P（默认 P1）。
   B 站目标可以直接贴分享链接，会自己提取 BV 号；短链 b23.tv/... 要先展开成完整链接。
-  通用视频 URL（YouTube/X 等）需要 yt-dlp：跑 scripts/fetch-deps.ps1 -Target ytdlp 装到 deps\\yt-dlp.exe（或设 BILI_LOOK_YTDLP / 系统 PATH）。
+  通用视频 URL（YouTube/X 等）需要 yt-dlp：跑 scripts/fetch-deps.ps1 -Target ytdlp 装到 deps\\yt-dlp.exe（或设 BILI_WATCH_YTDLP / 系统 PATH）。
 `
 try {
   if (srcErr || src.type === 'error') {