dsh-bili-scroll

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（NEXT / 0.2.x）：0.1.3 及以前的版本在桌面版上装不起来 —— 插件整条不激活， DSH 只留一句 warning: 1 entry did not activate … failed to import（根因是宿主半 import 的两个包 在桌面版 profile 里没被安装，详见下面「装不上」那节的第 5 条）。0.1.4 起已修 ✓。 另有用户反馈桌面版上「自动跑那一轮会卡住」—— 卡住就先只用设置页的「现在跑一轮」手动跑（那条稳）。

⚠️ 装的是旧版吗？ 如果设置页里那个按钮写的是「重装依赖」（而不是「重装主依赖」），说明你装的是 0.1.0 —— 跑一次 dsh plugin --profile web add dsh-bili-scroll 升级就好（那一版建 Python 环境时缺一个参数， 依赖装不上、二维码也画不出来，重装多少次都一样）。

DSH 插件：每天替你刷一轮 B站 —— 它自己搜、读字幕原文判断、把值得的写成报告，特别值得的会留一条评论 @ 你。 你收到的每一条 @，都是它先筛过一遍的。

它做什么

• 按你填的关键词（留空则用内置那几组）搜近几天的视频
• 逐条读字幕原文再判断（不看摘要）；没字幕的直接跳过 —— 除非你开了「本地转写」
• 写一份 Markdown 报告到 out/<日期>.md：每条含「为什么值得」+「它自己的一句话」
• 开着「自动评论」时，每轮最多发一条评论、@ 你一次
• 可以在峰谷时段自动跑（DeepSeek 的优惠时段），省 token
• ⭐ 评论区能跟你来回说话（0.1.6 新加）：你在它那条评论下面回一句，它下一轮就接一句； 你还能再回、它再接 —— 直到同一条串到达来回上限（默认 5 轮）或你不再说话。 想让它立刻接话，设置页有「现在回话」（只看消息、不刷视频，很快）。
• ⭐⭐ 在任意视频的评论区 @ 它，它也会出来（0.1.6）：打一句 @<它这个账号的昵称> 想说的话（昵称在设置页里会显示出来），它就会看到并在你那条评论下面回你 —— 靠的是 B站 自带的「收到的@」消息流，不是去全网扫评论 ✓ · ⚠️ 它永远不新开一层：只在你那条评论下面回（楼中楼），不会在别人视频底下留新的顶层评论 ✓

评论区「来回对话」怎么算的（0.1.6）

• ⭐⭐ 默认只跟你说话：名单里只有你（就是「要 @ 谁」那个人）的留言 —— 别人回复到它那条评论下面、或者在别处 @ 它，一律不理 ✓。想改成"回所有人"，把设置里那个开关关掉即可。 · 认人先按 UID、再按昵称认第一次：第一次按昵称认出你之后就把 UID 认死 ⇒ 以后别人改成同一个昵称也冒充不了 ✓（你哪天改名了，照样认得出 ✓） · ⚠️ 要是你把「要 @ 谁」填成了插件登录的那个账号，设置页会当场说清楚 —— 那样它分不清"自己说的"和"你说的"，对话根本转不起来 · 🔒 这条规矩有机器闸，不靠它自觉（0.1.6）：发出去那一下还会再去核一遍「要回的那条是谁写的」， 不是你就直接拒发（认不出来也一样不发）—— 就算它哪一轮判断失误，也说不出一句给别人的话 ✓ ⚠️ 只有你亲手关掉「只回我 @ 的那个人」，这道闸才会放开（因为这条规矩是你定的）✓
• 两种来源，一个名单： · 你回它那条评论 ⇒ 那一串的楼中楼（它自己发过的评论，账本里记着） · 你在别的评论区 @ 它 ⇒ 从 B站 的「收到的@」里读出来，就在你那条评论下面回
• 谁最后说话谁是"轮到的人"：最后一句是你说的 ⇒ 它接；最后一句是它说的 ⇒ 它闭嘴等着 （所以它不会自问自答、不会追问、不会刷屏）
• 有来回上限：设置页「同一条串最多来回几轮」。到顶就收住 —— 这是"不拉锯"的机器级保证，不是建议
• 同一条你发的评论只回一次，哪怕它正被审核、页面上还看不见 ✓
• ⚠️ 它只认"账本里记着的评论"：如果哪条评论是旧版本发的（那时还没有账本）， 它不知道"那条是我的" ⇒ 那下面的回复它看不到。 ⇒ 用设置页的「认领一条旧评论」：在 B站 App 里对着那条评论点「复制链接」，粘进去即可 ✓
• 🔴 永远不新开一层：它只在"你评论的下面"说话，从不在任何视频下发新的顶层评论 ✓
• ⭐ 它记的是"自己真发出去过什么"（家目录里的 conversation.json，宿主在发出去那一刻自己记的） —— 不是靠"那一轮记得去写"（实测：模型经常忘了写判重表）

装之前（一条前提，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 下到自己的家目录 ⇒ 这条前提不用用户操心、也不用管理员权限。 ⚠️ 万一它自己也下不动（有用户反馈桌面版上这条链路经常不通）：手动放一份 uv.exe 到 <家目录>\bin\ 就行 —— 插件优先用那里那一份，会跳过下载。

自己改代码 / 手动拷了插件文件之后（一条坑，30 秒看完）

DSH 的插件是两半：浏览器那半刷新页面就换新，宿主那半要完全退出 DSH 再打开才换新。 只刷新页面 ⇒ 页面是新的、宿主还是旧的 ⇒ 新加的开关点了不会有反应（而且以前什么都不说）。

• ✅ 改完/拷完文件，完全退出 DSH（不是刷新页面），再打开。
• ✅ 现在这件事会自己说：设置页顶部会顶一条「磁盘上的插件代码比正在跑的这一份新」； 改设置时如果宿主不认识那个字段，也会直接告诉你"多半是没重启"。
• ⭐ 想少踩这个坑：别手拷文件，让 DSH 直接装你这个目录（改完只需重启一次）：

  dsh plugin --profile desktop add link:<仓库目录的绝对路径>
  

装

dsh plugin --profile web add dsh-bili-scroll      # 从 npm
dsh plugin --profile web add github:c1overzz/dsh-bili-scroll   # 备选：直接从 GitHub

（⭐ 最省事的一条：把仓库链接贴给你自己的 dsh，说「帮我装这个插件」，它会自己装。）

⚠️ 装完必须重启一次 dsh（bundle 层要重启才组装）。然后进 设置 → 刷B站。

自动跑失败？先看这一条（headless 凭据）

如果手动点「现在跑一轮」能成、自动跑那一轮却几秒钟就退出，duty.log 里反复出现：

dsh: MISSING_CREDENTIAL: llm-deepseek: no API key for provider route "deepseek-official"

那不是插件的问题 —— 是 --profile headless 的 profile 把 deepseek-account 和 credentials 两项关掉了，子进程只能用环境变量 DEEPSEEK_API_KEY。修法：在 C:\Users\<你>\.dsh\profiles\headless\cordis.patch.yml 里写

- id: deepseek-account
  disabled: false
- id: credentials
  disabled: false

改完不用重启 dsh，新起的子进程会重新 compose profile。验证：

"<DSH目录>/DeepSeek Harness.exe" "<DSH目录>/dsh/node_modules/@deepseek-ai/dsh/lib/bin.js" \
  headless "Reply with exactly: OK"

打出 OK 就成了。

装不上 / 卡住时，先看这四条（都是用户实测撞过的）

1. 桌面版（DSH NEXT / 0.2.x）上"自动跑"会卡住 —— 有用户反馈：它起那一轮用的是 dsh --profile headless …，桌面版上容易卡在那儿。⇒ 先用设置页的「现在跑一轮」手动跑（那条是稳的）； 能不能自动跑，等你确认过自己那台桌面版的版本与 profile 再说。
2. 「装依赖」卡住、或者扫码时一直不出二维码 —— 大概率是 0.1.0 那版（见开头那个按钮指纹，跑一次 add 就升级了）。 不想升级也行，救急一句：<家>\.venv\Scripts\python.exe -m ensurepip --upgrade，再点一次「重装主依赖」。
3. 它下不动 uv（桌面版上这条链路经常不通）⇒ 自己放一份 uv.exe 到 <家目录>\bin\， 插件会优先用它、跳过下载。
4. 「本地转写」是两段式的 —— 只打开开关不够，还得点它下面那个「装转写依赖」。 没装的时候，没字幕的视频会被跳过（报告里现在会写「因无字幕跳过 N 条」，你能一眼看出漏了几条）。
5. ⭐ 桌面版：装完设置页里根本不出现「刷B站」，日志只有一句 1 entry did not activate … failed to import —— 这是 0.1.3 及以前在桌面版上的一个真 bug：插件宿主半 import 的两个包是 optional peer， 而桌面版 profile（autoInstallPeers: false）不会装它们 ⇒ 插件整条不激活。 0.1.4 起已修（不再裸 import 那两个包）。⇒ 升级一次就好：dsh plugin --profile desktop add dsh-bili-scroll。 ⚠️ 我们自己也只在 npm 0.1.7-rc.x + web profile 上实测过；桌面版这条路靠用户反馈修好的 —— 装完还是不行的话，把 duty.log 里那几行发来（里面会写清楚"宿主依赖是从哪儿取的"）。

首次使用（两步）

1. 装主依赖 —— 设置页点「装主依赖」：在插件自己的家目录建一个独立 venv，装 3 个包 （bilibili-api-python / mcp<2 / qrcode）。走国内镜像 + uv，通常几十秒（进度写 install.log，不卡页面）。
2. 扫码登录 —— 点「扫码登录」，用手机 B站 扫页面上那张码。 ⚠️ 确认时选「记住我 / 长期」那张（选 24 小时的话，明天就得重扫）。 凭证只落在你本机的插件家目录：<DSH_HOME>/bili-duty/bili_credential.json，不上传任何地方。

设置页里有什么

红线（写死在提示词里，不靠自觉）

• 不透露你的隐私：账号、机器路径、你聊过的话 —— 一个字都不进评论
• 每轮最多一条评论；同一视频只评论一次；不刷屏、不吵架
• ⭐ 来回也有限度：同一条串最多来回几轮（设置里能改），到顶就收住；同一条你发的评论只回一次
• ⭐⭐ 默认只跟你说话：名单里只有你；别人回复到它那条评论下面、或者 @ 它，一律不理（想改成回所有人，关掉那个开关） · 🔒 而且发出去那一下还有一道机器闸：不是本人写的评论，bili_reply 直接拒发（认不出来也拒）✓ · 「本人当场让你发」（force）只放行这一次、这一条 —— 不会把整道闸关掉 ✓
• 🔴 永远不新开一层：只在你评论的下面说话（楼中楼），从不在任何视频下发新的顶层评论 ✓
• 不确定的事不编（报告里如实写「没查到」）

它是怎么跑的

• 插件内部起一个 Python MCP（下面那个开源项目，已内置），把它的能力注册成 DSH 工具
• 定时到点 → 起一个 headless dsh 会话，把 prompts/duty.md（它一轮要做的事）+ 当天设置交给它
• 那一轮的工作目录 = 插件自己的家目录（它被沙箱关着，只写得了自己那一亩三分地）； ⭐ 你填的工作区里的 AGENTS.md 由插件读进来、内联进提示词 ⇒ 它按你的设定说话， 而不是用一套通用人格
• ⭐ "谁在等我回话"由插件自己去拉，不交给那一轮去翻（0.1.6）：插件读 conversation.json（自己真发出去过的评论）
  • 判重表，去 B站 把每条串的楼中楼读一遍，算出「最后一句是对方说的」那些，写进 inbox.md 并内联进提示词。 这样它不用在几百条评论里翻（翻不全、还费钱），只要照着名单说话。
• ⭐ 两种轮次：刷一轮（搜视频 + 写日报）和 只回话（只看名单 + 说话，不搜视频、不写日报）。 后者就是设置页那个「现在回话」按钮 → POST /api/bili-duty/chat；没人在等 ⇒ 不起会话（不白花钱）。
• ⭐⭐ 一个时段 = 一次窗口实例，额度摊成几轮随机排（0.1.7）：晚上的 18:00–09:00 开到第二天早上都算同一次， 00:30 是"昨晚那一轮"的继续（不会过 0 点重开一轮）；「每天最多看几条」按「每轮最多看几条」摊成几轮， 每轮的时间点随机落在时段里（切成几等份再各取一点 ⇒ 既随机又不挤在一起）； 自定义时间段开着时，这套照旧按你填的时段来（可以跨零点）。

如果你是一个 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（MIT，Copyright (c) 2026 AGI_Ananas）—— 搜索 / 字幕 / 评论 / 发评论这些能力来自它；本插件只做「挑什么、什么时候挑、要不要说话」这一层 · ⭐ 本仓库对它只有一处增量改动（0.1.6）：bili_reply 的回执里多带回一个 rpid （原版把发出去的评论对象丢掉了）—— 插件要靠它记「自己发过什么」。
• 需要本机有 Python 3.10+（会用 uv 或 python -m venv 建独立环境），不需要它已经进 PATH
• Python 依赖只有 3 个（见 vendor/bilibili-mcp/requirements.txt）；mcp 必须锁 <2（2.x 起不来）

路线图

• 0.1.x（当前 = 0.1.7）：内置 MCP + 扫码登录 + 章程 + 设置页（峰谷级联开关 / 自定义时间段 / 定量刷（摊成几轮随机排）/ 每轮最多看几条 / 自动评论（@ 是上限不是任务）/ 评论区来回对话 / 工作区 / 日报三档）+ 谷时定时器 + 报告 + 看报告与打开文件夹 + 评论复核 + 版本徽章 / 检查更新 / 一键升级
• 0.1.6（这一版）：评论区能跟你来回说话（有来回上限 / 按宿主拉好的名单回 / 「现在回话」立刻回一趟）
• 下一步：每轮记账（token 与花费）· 周末时段 · 数据目录可配 · 「停掉这一轮」按钮
• v0.2：用 JS 重写那几个接口 ⇒ 不再需要 Python（零安装）；报告归档、失败重试

第三方代码

vendor/bilibili-mcp/ 内含第三方项目 bilibili-mcp，MIT 许可， Copyright (c) 2026 AGI_Ananas，完整许可见该目录下的 LICENSE 文件。

许可证

MIT（内置的 vendor/bilibili-mcp/ 另见该目录下的 LICENSE）