dsh-bili-scroll 0.0.0-stage → 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/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 dsh-bili-duty contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---------------------------------------------------------------------------
+
+本插件内含第三方代码：`vendor/bilibili-mcp/`
+  · 项目：bilibili-mcp
+  · 许可证：MIT，Copyright (c) 2026 AGI_Ananas
+  · 完整许可见该目录下的 LICENSE 文件
+
+（如果你要改版权署名 —— 比如换成你自己的名字或 GitHub 用户名 —— 改上面第一行那个
+  "dsh-bili-duty contributors" 就行。）

package/README.md

@@ -1,3 +1,104 @@
-# Temporary Holding Version
+# dsh-bili-scroll ｜ 刷B站
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **先看三行**
+> - 需要 **dsh ≥ `0.1.7-rc.1`**（本机是 `0.1.7-rc.2`）。⚠️ 版本不满足时，**内核会静默跳过这个插件** —— 装了跟没装一样，不会报错。
+> - **空间**：不装「本地转写」约 **84 MB**；装了转写约 **1 GB**（其中 Whisper 模型 538 MB，可在设置里换更小的模型）。
+> - 装完**必须重启一次** dsh（插件在 bundle 层组装）。
+
+> DSH 插件：**每天替你刷一轮 B站** —— 它自己搜、**读字幕原文**判断、把值得的写成报告，特别值得的会留一条评论 **@ 你**。
+> **你收到的每一条 @，都是它先筛过一遍的。**
+
+## 它做什么
+
+- 按你填的关键词（留空则用内置那几组）搜近几天的视频
+- **逐条读字幕原文再判断**（不看摘要）；没字幕的直接跳过 —— 除非你开了「本地转写」
+- 写一份 Markdown 报告到 `out/<日期>.md`：每条含「为什么值得」+「它自己的一句话」
+- 开着「自动评论」时，每轮最多发一条评论、**@ 你**一次
+- 可以在**峰谷时段自动跑**（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
+```
+
+⚠️ 装完**必须重启一次 dsh**（bundle 层要重启才组装）。然后进 **设置 → 刷B站**。
+
+## 首次使用（两步）
+
+1. **装依赖** —— 设置页点「装依赖（建 venv）」：在插件自己的家目录建一个独立 venv，装 3 个包
+   （`bilibili-api-python` / `mcp<2` / `qrcode`）。**走国内镜像 + uv，通常几十秒**（进度写 `install.log`，不卡页面）。
+2. **扫码登录** —— 点「扫码登录」，用手机 B站 扫页面上那张码。
+   ⚠️ **确认时选「记住我 / 长期」那张**（选 24 小时的话，明天就得重扫）。
+   凭证只落在你本机的插件家目录：`<DSH_HOME>/bili-duty/bili_credential.json`，不上传任何地方。
+
+## 设置页里有什么
+
+| 项 | 说明 |
+|---|---|
+| **峰谷时段自动刷** | 总开关；**打开之后才展开**「中午谷时 12:00–14:00」「晚上/夜间谷时 18:00–09:00」两个子开关。依据 DeepSeek 官方定价：**工作日 9:00–12:00、14:00–18:00 是高峰，其余（含整个周末）都是谷时** |
+| **每天最多挑几条** | 数字自己填；填 0 = 不自动刷（但还能手动跑） |
+| **自动评论并 @ 你** | **默认关**；打开后展开两栏：**每轮最多发几条评论**、**要 @ 谁（B站 昵称）** —— ⚠️ **留空就不发评论**（评论的意义就是 @ 那一下） |
+| **本地转写没字幕的视频** | **默认关** —— 要在本机装 Whisper、下几百 MB 模型 |
+| **关注关键词** | 一行一个；留空用内置那几组 |
+| **工作区** | 它按这里的 `AGENTS.md` 认「设定」⇒ **你有设定就按你的来** |
+| 现在跑一轮 / 装依赖 / 扫码登录 | |
+
+## 红线（写死在提示词里，不靠自觉）
+
+- 不透露你的隐私：账号、机器路径、你聊过的话 —— 一个字都不进评论
+- 每轮最多一条评论；同一视频只评论一次；不刷屏、不吵架
+- 不确定的事**不编**（报告里如实写「没查到」）
+
+## 它是怎么跑的
+
+- 插件**内部**起一个 Python MCP（下面那个开源项目，已内置），把它的能力注册成 DSH 工具
+- 定时到点 → 起一个 headless dsh 会话，把 `prompts/duty.md`（它一轮要做的事）+ 当天设置交给它
+- 那一轮的**工作目录 = 你填的工作区** ⇒ 那里的 `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）——
+  搜索 / 字幕 / 评论 / 发评论这些能力来自它；本插件只做「**挑什么、什么时候挑、要不要说话**」这一层
+- 需要本机有 **Python 3.10+**（会用 `uv` 或 `python -m venv` 建独立环境），不需要它已经进 PATH
+- Python 依赖只有 3 个（见 `vendor/bilibili-mcp/requirements.txt`）；`mcp` **必须锁 `<2`**（2.x 起不来）
+
+## 路线图
+
+- **v0.1（当前）**：内置 MCP + 扫码登录 + 章程 + 设置页（峰谷级联开关 / 定量刷 / 自动评论 / 工作区）+ 谷时定时器 + 报告
+- **v0.2**：判重表文档化、报告归档、失败重试与日志查看
+- **v0.3**：**用 JS 重写那几个接口 ⇒ 不再需要 Python**（零安装）
+
+## 许可证
+
+MIT（内置的 `vendor/bilibili-mcp/` 另见该目录下的 LICENSE）

package/client.js

@@ -0,0 +1,413 @@
+/**
+ * dsh-bili-scroll —— 浏览器半端（**设置在「设置」里的一页**）
+ * ============================================================================
+ * ⭐ **client bundle 不是 ESM，是自注册脚本**（2026-10-14 从官方包里挖到的约定）：
+ *
+ *     window.__ModuleLoader__.load({
+ *       id: '<包名>',                       // 必须等于 package.json 的 name
+ *       factory: (require) => { ... return { inject: [...], apply(ctx) {...} } },
+ *     })
+ *
+ * ⭐ **怎么进「设置」**（抄第三方插件 `dsh-meme/client.js`，2026-10-14 使用者指出位置不对后才查到）：
+ *
+ *     const slots = ctx.get('slots')
+ *     slots.inject('settings.section', () => slots.register(
+ *       { name: 'settings.section', id: 'bili-scroll', order: 30, label: '刷B站' },   // label = 左侧导航那一项
+ *       () => h(Panel),
+ *     ))
+ *
+ *   ⇒ **别自己糊一个标题栏按钮 + 全屏 overlay** ✗（第一版就是这么干的，使用者一眼看出"跟别的插件不一样"）。
+ *
+ * 这一页要满足使用者 2026-10-14 说的形状：
+ *   · **总开关 → 打开之后下面才展开子开关**（峰谷自动刷 → 中午 / 晚上）
+ *   · **数字项要能自己填**（定量刷：每天几条）
+ *   · **账号绑定必须在设置页里**（扫码登录 + 二维码直接显示在页里）
+ *   · 会发东西出去的（自动评论）、要下大模型的（本地转写）**默认关**
+ * ============================================================================
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-bili-scroll',
+  factory: (require) => {
+    const React = require('react')
+    const h = React.createElement
+
+    const API = '/api/bili-duty'
+    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-bd-page]{display:flex;flex-direction:column;gap:18px;padding:2px 2px 8px;max-width:640px;}
+[data-bd-sec]{display:flex;flex-direction:column;gap:8px;}
+[data-bd-h]{font-size:11px;font-weight:600;letter-spacing:.04em;color:var(--dsw-alias-label-tertiary,#9aa0a6);}
+[data-bd-row]{display:flex;align-items:center;gap:10px;}
+[data-bd-grow]{flex:1;min-width:0;}
+[data-bd-label]{font-size:13px;}
+[data-bd-note]{font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary,#9aa0a6);}
+[data-bd-sw]{flex:none;width:38px;height:22px;border-radius:11px;border:0;cursor:pointer;position:relative;
+  background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.35));transition:background .15s;padding:0;}
+[data-bd-sw][data-on]{background:#3b82f6;}
+[data-bd-sw] i{position:absolute;top:3px;left:3px;width:16px;height:16px;border-radius:50%;background:#fff;
+  transition:left .15s;display:block;}
+[data-bd-sw][data-on] i{left:19px;}
+[data-bd-sw][disabled]{opacity:.45;cursor:default;}
+[data-bd-sub]{margin-left:14px;padding-left:12px;border-left:2px solid var(--dsw-alias-border-l2,rgba(255,255,255,.1));
+  display:flex;flex-direction:column;gap:10px;}
+[data-bd-input]{width:100%;box-sizing:border-box;padding:7px 9px;border-radius:8px;font-size:12px;
+  border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.14));
+  background:var(--dsw-alias-bg-overlay,rgba(128,128,128,.12));color:inherit;font-family:inherit;}
+[data-bd-input]:focus{outline:none;border-color:#3b82f6;}
+[data-bd-num]{width:88px;text-align:center;}
+[data-bd-btn]{padding:7px 12px;border-radius:8px;font-size:12px;cursor:pointer;font-family:inherit;
+  border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.16));
+  background:var(--dsw-alias-bg-overlay,rgba(128,128,128,.14));color:inherit;}
+[data-bd-btn]:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.24));}
+[data-bd-btn][data-primary]{background:#3b82f6;border-color:#3b82f6;color:#fff;}
+[data-bd-btn][disabled]{opacity:.5;cursor:default;}
+[data-bd-msg]{font-size:11px;line-height:16px;padding:7px 9px;border-radius:8px;word-break:break-all;
+  background:var(--dsw-alias-bg-overlay,rgba(128,128,128,.12));color:var(--dsw-alias-label-tertiary,#9aa0a6);}
+[data-bd-msg][data-warn]{color:#f59e0b;}
+[data-bd-msg][data-good]{color:#22c55e;}
+[data-bd-qr]{display:flex;gap:14px;align-items:flex-start;}
+[data-bd-qr] img{width:150px;height:150px;border-radius:8px;background:#fff;padding:6px;}
+[data-bd-pre]{margin:6px 0 0;padding:8px 9px;border-radius:8px;max-height:170px;overflow:auto;font-size:11px;
+  line-height:15px;white-space:pre-wrap;word-break:break-all;
+  background:var(--dsw-alias-bg-overlay,rgba(0,0,0,.25));color:var(--dsw-alias-label-secondary,#c9ccd1);}
+[data-bd-kv]{font-size:11px;line-height:18px;color:var(--dsw-alias-label-tertiary,#9aa0a6);word-break:break-all;}
+[data-bd-badge]{font-size:11px;padding:2px 7px;border-radius:6px;
+  background:var(--dsw-alias-bg-overlay,rgba(128,128,128,.14));color:var(--dsw-alias-label-secondary,#c9ccd1);}
+`
+
+    // ⚠️ 与 lib/state.mjs 的 WINDOWS 保持一致（官方口径：工作日 9–12、14–18 是高峰，其余都是谷时）
+    const DEFAULT_WINDOWS = {
+      noon: { label: '中午谷时', start: '12:00', end: '14:00' },
+      night: { label: '晚上/夜间谷时', start: '18:00', end: '09:00' },
+    }
+
+    /* ────────────── 小组件 ────────────── */
+
+    function Switch({ on, onChange, disabled }) {
+      return h('button', {
+        'data-bd-sw': '',
+        'data-on': on ? '' : undefined,
+        disabled: Boolean(disabled),
+        title: on ? '已开' : '已关',
+        onClick: () => { if (!disabled) onChange(!on) },
+      }, h('i'))
+    }
+
+    function ToggleRow({ label, note, on, onChange, disabled }) {
+      return h('div', { 'data-bd-row': '' },
+        h('div', { 'data-bd-grow': '' },
+          h('div', { 'data-bd-label': '' }, label),
+          note ? h('div', { 'data-bd-note': '' }, note) : null),
+        h(Switch, { on, onChange, disabled }))
+    }
+
+    function useStatus(intervalMs) {
+      const [st, setSt] = React.useState(null)
+      React.useEffect(() => {
+        let alive = true
+        const tick = async () => {
+          try {
+            const d = await jget('/status')
+            if (alive && d?.ok) setSt(d)
+          } catch { /* 网络抖动就下次再问 */ }
+        }
+        tick()
+        const t = setInterval(tick, intervalMs || 5000)
+        return () => { alive = false; clearInterval(t) }
+      }, [intervalMs])
+      return [st, setSt]
+    }
+
+    /* ────────────── 设置页正文 ────────────── */
+
+    function Panel() {
+      const [st, setSt] = useStatus(5000)
+      const [busy, setBusy] = React.useState('')
+      const [msg, setMsg] = React.useState('')
+      const [msgTone, setMsgTone] = React.useState('')
+      const [kws, setKws] = React.useState(null)
+      const [ws, setWs] = React.useState(null)
+      // ⚠️ 输入框必须绑"本地草稿"：页面每 5 秒轮询 /status，服务端那份会把 config 盖掉
+      //    ⇒ 直接绑 cfg 的话，用户打字打到一半就被冲没了 ✗（2026-10-14 陌生人验收时抓到）
+      const [perDay, setPerDay] = React.useState(null)
+      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('')
+
+      const cfg = st?.config
+      React.useEffect(() => {
+        if (cfg && kws === null) setKws((cfg.keywords || []).join('\n'))
+        if (cfg && ws === null) setWs(cfg.workspace || '')
+        if (cfg && perDay === null) setPerDay(String(cfg.perDay ?? 5))
+        if (cfg && perRound === null) setPerRound(String(cfg.commentPerRound ?? 1))
+        if (cfg && mention === null) setMention(cfg.mentionName || '')
+      }, [cfg])
+
+      const win = { ...DEFAULT_WINDOWS, ...(st?.windows || {}) }
+
+      const say = (text, tone) => {
+        setMsg(text); setMsgTone(tone || '')
+        setRunNote(text ? { t: text, tone: tone || '' } : null)   // ⭐ 同时镜像到顶部，免得提示掉到页面最底下看不见
+      }
+
+      const patch = async (p, what) => {
+        setBusy(JSON.stringify(p))
+        try {
+          const r = await jpost('/config', p)
+          if (r?.config) setSt((old) => ({ ...old, config: r.config }))
+          say(what ? `${what}：已保存` : '已保存', 'good')
+        } catch (e) { say(String(e?.message ?? e), 'warn') }
+        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('')
+        try {
+          const r = await jpost('/install', {})
+          say(r?.hint || '已经在后台开始装了', '')
+        } catch (e) { say(String(e?.message ?? e), 'warn') }
+        finally { setBusy('') }
+      }
+
+      const onRun = async () => {
+        setBusy('run')
+        try {
+          const r = await jpost('/run', {})
+          say(r?.started ? '已经在后台跑一轮了，报告会写在 out/ 里' : '没起来，看 duty.log', r?.started ? 'good' : 'warn')
+        } catch (e) { say(String(e?.message ?? e), 'warn') }
+        finally { setBusy('') }
+      }
+
+      const onLoginStart = async () => {
+        setBusy('login')
+        setLoginTone('')
+        setLoginState('正在出码…')
+        try {
+          const r = await jpost('/login/start', {})
+          if (!r?.ok) { setLoginTone('warn'); setLoginState(r?.error || '出码失败'); return }
+          setLogin({ key: r.key, qr: r.qr })
+          if (!r.qr) { setLoginTone('warn'); setLoginState('没画出二维码 —— 先点上面的「重装依赖」（venv 里要有 qrcode）') }
+          else setLoginState('用手机 B站 扫这张码')
+          let n = 0
+          const timer = setInterval(async () => {
+            n += 1
+            try {
+              const p = await jpost('/login/poll', { key: r.key })
+              if (p?.state === 'ok') {
+                clearInterval(timer); setLogin(null)
+                setLoginTone('good'); setLoginState('登录成功')
+                setSt((old) => ({ ...old, loggedIn: true }))
+              } else if (p?.state === 'scanned') { setLoginTone(''); setLoginState('扫到了，请在手机上确认') }
+              else if (p?.state === 'expired') { clearInterval(timer); setLogin(null); setLoginTone('warn'); setLoginState('二维码过期了，再点一次「扫码登录」') }
+              else { setLoginTone(''); setLoginState('等扫码…') }
+            } catch { /* 抖动就下次再问 */ }
+            if (n > 90) { clearInterval(timer); setLogin(null); setLoginTone('warn'); setLoginState('超时了，再点一次「扫码登录」') }
+          }, 2000)
+        } catch (e) { setLoginTone('warn'); setLoginState(String(e?.message ?? e)) }
+        finally { setBusy('') }
+      }
+
+      const onSaveText = async () => {
+        const list = String(kws || '').split('\n').map((s) => s.trim()).filter(Boolean)
+        await patch({ keywords: list, workspace: String(ws || '').trim() }, '关键词与工作区')
+      }
+
+      if (!cfg) {
+        return h('div', { 'data-bd-page': '' }, h('div', { 'data-bd-note': '' }, '读设置中…'))
+      }
+
+      const sw = (k) => Boolean(cfg[k])
+
+      return h('div', { 'data-bd-page': '' },
+
+        /* ── 今天 ── */
+        h('div', { 'data-bd-row': '' },
+          h('span', { 'data-bd-badge': '' }, `今天已挑 ${st.ranToday} / ${cfg.perDay} 条`),
+          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': '' },
+          h('div', { 'data-bd-h': '' }, '什么时候自己跑'),
+          h(ToggleRow, {
+            label: '峰谷时段自动刷',
+            note: '只在谷时跑 —— 工作日 12:00–14:00 与 18:00 之后（整个周末也算谷时）；关了就只能手动跑',
+            on: sw('peakValley'),
+            onChange: (v) => patch({ peakValley: v }, '峰谷时段自动刷'),
+          }),
+          sw('peakValley') ? h('div', { 'data-bd-sub': '' },
+            ...['noon', 'night'].map((k) => h(ToggleRow, {
+              key: k,
+              label: win[k].label,
+              note: `${win[k].start} – ${win[k].end}`,
+              on: sw(k),
+              onChange: (v) => patch({ [k]: v }, win[k].label),
+            }))) : null),
+
+        /* ── 一轮挑几条 ── */
+        h('div', { 'data-bd-sec': '' },
+          h('div', { 'data-bd-h': '' }, '一轮挑几条'),
+          h('div', { 'data-bd-row': '' },
+            h('div', { 'data-bd-grow': '' },
+              h('div', { 'data-bd-label': '' }, '每天最多挑几条'),
+              h('div', { 'data-bd-note': '' }, '填 0 = 不自动刷（还是能手动跑）')),
+            h('input', {
+              'data-bd-input': '', 'data-bd-num': '', type: 'number', min: 0, max: 50,
+              value: perDay ?? '',
+              onChange: (e) => setPerDay(e.target.value),
+              onBlur: () => { const n = Math.max(0, Math.min(Number(perDay) || 0, 50)); setPerDay(String(n)); patch({ perDay: n }, '每天挑几条') },
+            })),
+          st.lastRunAt ? h('div', { 'data-bd-note': '' }, `上次跑：${new Date(st.lastRunAt).toLocaleString('zh-CN')}`) : null),
+
+        /* ── 发言与转写 ── */
+        h('div', { 'data-bd-sec': '' },
+          h('div', { 'data-bd-h': '' }, '它会不会替你说话'),
+          h(ToggleRow, {
+            label: '自动评论并 @ 你',
+            note: '默认关；开了之后它会在挑中的视频下面留评论，并 @ 你填的那个人',
+            on: sw('autoComment'),
+            onChange: (v) => patch({ autoComment: v }, '自动评论'),
+          }),
+          sw('autoComment') ? h('div', { 'data-bd-sub': '' },
+            h('div', { 'data-bd-row': '' },
+              h('div', { 'data-bd-grow': '' },
+                h('div', { 'data-bd-label': '' }, '每轮最多发几条评论'),
+                h('div', { 'data-bd-note': '' }, '每条评论里 @ 一次下面那个人')),
+              h('input', {
+                'data-bd-input': '', 'data-bd-num': '', type: 'number', min: 1, max: 20,
+                value: perRound ?? '',
+                onChange: (e) => setPerRound(e.target.value),
+                onBlur: () => { const n = Math.max(1, Math.min(Number(perRound) || 1, 20)); setPerRound(String(n)); patch({ commentPerRound: n }, '每轮几条评论') },
+              })),
+            h('div', { 'data-bd-label': '' }, '要 @ 谁（B站 昵称）'),
+            h('input', {
+              'data-bd-input': '', value: mention ?? '',
+              placeholder: '填你要 @ 的那个人的 B站 昵称；留空 = 只写报告、不发评论',
+              onChange: (e) => setMention(e.target.value),
+              onBlur: () => { const v = String(mention || '').trim(); setMention(v); patch({ mentionName: v }, '要 @ 谁') },
+            }),
+            h('div', { 'data-bd-note': '' }, '留空的话它就不发评论了 —— 因为评论存在的意义就是 @ 那一下')) : null,
+          h(ToggleRow, {
+            label: '本地转写没字幕的视频',
+            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': '' },
+          h('div', { 'data-bd-h': '' }, '关注什么'),
+          h('textarea', {
+            'data-bd-input': '', rows: 5, placeholder: '一行一个关键词；留空用内置那几组',
+            value: kws ?? '', onChange: (e) => setKws(e.target.value),
+          }),
+          h('div', { 'data-bd-label': '' }, '工作区（它按这里的 AGENTS.md 认设定）'),
+          h('input', {
+            'data-bd-input': '', value: ws ?? '', placeholder: '留空 = dsh 自己的工作目录',
+            onChange: (e) => setWs(e.target.value),
+          }),
+          h('div', { 'data-bd-row': '' },
+            h('button', { 'data-bd-btn': '', 'data-primary': '', disabled: Boolean(busy), onClick: onSaveText }, '保存'),
+            msg ? h('div', { 'data-bd-msg': '', 'data-good': msgTone === 'good' ? '' : undefined, 'data-warn': msgTone === 'warn' ? '' : undefined }, msg) : null)),
+
+        /* ── 环境与账号 ── */
+        h('div', { 'data-bd-sec': '' },
+          h('div', { 'data-bd-h': '' }, '环境与账号'),
+          h('div', { 'data-bd-row': '' },
+            h('button', { 'data-bd-btn': '', disabled: busy === 'install', onClick: onInstall },
+              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.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 ? '正在装主依赖（进度）：' : '主依赖的日志（B站 搜索 / 字幕 / 评论 用得到，末尾）：'),
+            h('pre', { 'data-bd-pre': '' }, st.installTail)) : null,
+          login?.qr ? h('div', { 'data-bd-qr': '' },
+            h('img', { src: login.qr, alt: 'B站登录二维码' }),
+            h('div', { 'data-bd-note': '' },
+              '手机 B站 → 我的 → 扫一扫。',
+              h('br'),
+              '确认时选「记住我 / 长期」那张 —— 选 24 小时的话，明天就得重扫。')) : null),
+
+        /* ── 它是怎么干活的（给他看的） ── */
+        h('div', { 'data-bd-sec': '' },
+          h('div', { 'data-bd-h': '' }, '它的地盘'),
+          h('div', { 'data-bd-kv': '' },
+            `家目录：${st.home}`,
+            h('br'),
+            `今天的报告：${st.report}`)),
+      )
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        const style = document.createElement('style')
+        style.setAttribute('data-plugin-css', 'dsh-bili-duty')
+        style.textContent = CSS
+        document.head.appendChild(style)
+        ctx.effect(() => () => style.remove(), 'dsh-bili-duty: 设置页样式')
+
+        // ⭐ 进「设置」：label 就是左侧导航里那一项（抄 dsh-meme 的写法）
+        const slots = (typeof ctx.get === 'function' ? ctx.get('slots') : undefined) || ctx.slots
+        if (!slots) return
+        slots.inject('settings.section', () => slots.register(
+          { name: 'settings.section', id: 'bili-scroll', order: 30, label: '刷B站' },
+          () => h(Panel),
+        ))
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,20 @@
+# ============================================================================
+# dsh-bili-duty —— DSH bundle patch（插件**自带**的挂载声明）
+# ============================================================================
+# 这就是"标准 DSH 插件"的样子：包自己声明要往 profile 的配置树里插什么。
+# 装上之后，profile 只要在 `dsh.profile.bundles` 里列出本包名即生效，
+# 不用再手改 profile 自己的 cordis.patch.yml：
+#
+#   dsh plugin --profile web add dsh-bili-scroll
+#   （本地开发时用：dsh plugin --profile web add link:<你自己的插件目录>）
+#
+# 组成顺序：每个 bundle 的 patch 按 `dsh.profile.bundles` 顺序叠
+#          → 再叠 profile 自己那一层的 cordis.patch.yml（只有那层是热重载）
+# ============================================================================
+
+- insert:
+    - id: bili-scroll
+      name: dsh-bili-scroll
+      config:
+        # 真正的用户配置在插件自己的 config 里（设置页可改），这里只放默认值
+        enabled: true