dsh-bili-scroll 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-bili-scroll 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-bili-scroll 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-bili-scroll 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/10/29。

B站每日精选 zxz-feng/dsh-bili-scroll

DeepSeek Harness

zxz-feng5 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

自动搜片读字幕，筛出值得看的写成报告

29.6/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/11/2 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add zxz-feng/dsh-bili-scroll

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

dsh 原生插件 · platform

装得上吗

本站尚未做安装检查

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 5 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 218 处，展示前 106 条）

读取本地文件
index.js:138
try { myVer = String(JSON.parse(readFileSync(join(pluginDir, 'package.json'), 'utf8')).version || '') } catch { myVer = '' }
读取本地文件
index.js:160
if (existsSync(win)) return win
读取本地文件
index.js:163
for (const d of readdirSync(lib)) {
读取本地文件
index.js:166
if (existsSync(p)) return p
读取本地文件
index.js:172
try { return readdirSync(sitePkgs(venvRoot)).some((n) => n.startsWith(prefix)) } catch { return false }
读取本地文件
index.js:179
const venvReadyNow = () => existsSync(venvPython()) && missingVenvDeps().length === 0
写入本地文件
index.js:197
writeFileSync(overrideFile, JSON.stringify(cur, null, 2), 'utf8')
写入本地文件
index.js:229
mkdirSync(outDir, { recursive: true })
写入本地文件
index.js:233
try { appendFileSync(logFile, line + '\n', 'utf8') } catch { }
写入本地文件
index.js:485
writeFileSync(marker, String(Date.now()), 'utf8')
请求外部主机api.github.com
index.js:813
const rr = await fetch('https://api.github.com/repos/c1overzz/dsh-bili-scroll/releases/latest', {
发起网络请求
index.js:813
const rr = await fetch('https://api.github.com/repos/c1overzz/dsh-bili-scroll/releases/latest', {
写入本地文件
index.js:1021
mkdirSync(stateDir, { recursive: true })
写入本地文件
index.js:1029
writeFileSync(dutyMemoryFile, [...head, ...items].join('\n') + '\n', 'utf8')
执行外部命令来自配置/变量
index.js:1483
const child = spawn(dsh.command, args, {
删除本地文件
index.js:1561
try { rmSync(dutySessionFile, { force: true }) } catch { }
删除本地文件
index.js:1572
try { rmSync(dutySessionFile, { force: true }) } catch { }
删除本地文件
index.js:1577
try { rmSync(dutySessionFile, { force: true }) } catch { }
执行外部命令来自配置/变量
index.js:1850
const child = spawn(dsh.command, args, {
删除本地文件
index.js:1893
try { rmSync(dmSessionFile, { force: true }) } catch { }
执行外部命令固定命令
index.js:2050
const c = spawn('uv', ['--version'], { windowsHide: true, stdio: 'ignore' })
执行外部命令来自配置/变量
index.js:2064
const c = spawn(cmd, ['--version'], { windowsHide: true, stdio: 'ignore' })
执行外部命令来自配置/变量
index.js:2073
try { c = spawn(cmd, args, { cwd: stateDir, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'], env: uvEnv() }) }
执行外部命令来自配置/变量
index.js:2127
const child = spawn(py, [join(stateDir, 'favops.py'), ...args], {
请求外部主机api.bilibili.com
index.js:2294
const r = await fetch('https://api.bilibili.com/x/web-interface/view?bvid=' + bv, {
发起网络请求
index.js:2294
const r = await fetch('https://api.bilibili.com/x/web-interface/view?bvid=' + bv, {
发起网络请求
index.js:2302
const img = await fetch(pic, {
删除本地文件
index.js:2317
try { rmSync(bak, { force: true }) } catch { }
请求外部主机registry.npmjs.org
index.js:2805
const r = await fetch('https://registry.npmjs.org/dsh-bili-scroll/latest', { signal: AbortSignal.timeout(8000) })
发起网络请求
index.js:2805
const r = await fetch('https://registry.npmjs.org/dsh-bili-scroll/latest', { signal: AbortSignal.timeout(8000) })
请求外部主机api.github.com
index.js:2816
const r = await fetch('https://api.github.com/repos/c1overzz/dsh-bili-scroll/contents/package.json', {
发起网络请求
index.js:2816
const r = await fetch('https://api.github.com/repos/c1overzz/dsh-bili-scroll/contents/package.json', {
请求外部主机api.bilibili.com
index.js:2902
const r = await fetch('https://api.bilibili.com/x/web-interface/nav', {
发起网络请求
index.js:2902
const r = await fetch('https://api.bilibili.com/x/web-interface/nav', {
删除本地文件
index.js:2919
try { const t = join(stateDir, '.diag-write-test'); writeFileSync(t, 'x'); rmSync(t) } catch { writable = false }
请求外部主机api.bilibili.com
index.js:2925
const r = await fetch('https://api.bilibili.com/x/web-interface/nav', { headers: { 'User-Agent': 'Mozilla/5.0' } })
发起网络请求
client.js:42
const jget = async (p) => asJson(await fetch(API + p, { credentials: 'same-origin' }))
发起网络请求
client.js:43
const jpost = async (p, body) => asJson(await fetch(API + p, {
写入剪贴板
client.js:429
await navigator.clipboard.writeText(v)
读取本地文件
lib/hostdeps.mjs:40
for (const n of readdirSync(join(npm, '@deepseek-ai'))) {
读取本地文件
lib/hostdeps.mjs:53
for (const p of readdirSync(join(dshHome, 'profiles'))) {
读取本地文件
lib/hostdeps.mjs:68
if (!existsSync(pkgFile)) return null
读取本地文件
lib/hostdeps.mjs:69
const pkg = JSON.parse(readFileSync(pkgFile, 'utf8'))
读取本地文件
lib/hostdeps.mjs:76
return existsSync(file) ? pathToFileURL(file).href : null
读取本地文件
lib/mcp.mjs:16
const PKG = (() => { try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) } catch { return {} } })()
执行外部命令来自配置/变量
lib/mcp.mjs:36
this.proc = spawn(command, args, {
读取本地文件
lib/verify.mjs:44
if (!existsSync(f)) return null
读取本地文件
lib/verify.mjs:46
const c = JSON.parse(readFileSync(f, 'utf8'))
发起网络请求
lib/verify.mjs:62
const r = await fetch(url, { headers })
读取本地文件
lib/verify.mjs:120
if (!existsSync(seenFile)) return { checked: [], skipped: 0, text: '⚠️ 判重表还没生成，没什么可复核的' }
读取本地文件
lib/verify.mjs:124
const rows = parseSeen(readFileSync(seenFile, 'utf8'))
读取本地文件
lib/verify.mjs:130
try { state = JSON.parse(readFileSync(stateFile, 'utf8')) } catch { }
写入本地文件
lib/verify.mjs:152
try { writeFileSync(stateFile, JSON.stringify(state, null, 2), 'utf8') } catch { }
读取本地文件
lib/verify.mjs:168
if (!existsSync(f)) return null
写入本地文件
lib/verify.mjs:169
writeFileSync(f, readFileSync(f, 'utf8').replace(/ *$/, '') + '\n' + text + '\n', 'utf8')
写入本地文件
lib/state.mjs:48
mkdirSync(dir, { recursive: true })
读取本地文件
lib/state.mjs:53
try { return JSON.parse(readFileSync(file, 'utf8')) } catch { return fallback }
写入本地文件
lib/state.mjs:57
writeFileSync(file, JSON.stringify(value, null, 2), 'utf8')
读取本地文件
lib/state.mjs:81
if (!existsSync(from)) { log(`缺文件：${from}`); continue }
读取本地文件
lib/state.mjs:82
const incoming = readFileSync(from, 'utf8')
读取本地文件
lib/state.mjs:84
const shipped = existsSync(markFile) ? readFileSync(markFile, 'utf8').trim() : ''
读取本地文件
lib/state.mjs:84
const shipped = existsSync(markFile) ? readFileSync(markFile, 'utf8').trim() : ''
写入本地文件
lib/state.mjs:85
const writeMark = (txt) => { try { writeFileSync(markFile, sha(Buffer.from(txt, 'utf8')), 'utf8') } catch { } }
读取本地文件
lib/state.mjs:86
if (!existsSync(to)) {
写入本地文件
lib/state.mjs:87
copyFileSync(from, to); writeMark(incoming); log(`已铺好：${to}`); continue
写入本地文件
lib/state.mjs:93
copyFileSync(from, to); writeMark(incoming); log(`已更新：${to}`)
写入本地文件
lib/state.mjs:96
copyFileSync(from, to); writeMark(incoming); log(`已更新（首次记录指纹）：${to}`)
发起网络请求
lib/login.mjs:46
const r = await fetch(SPI, { headers: { 'User-Agent': UA } })
发起网络请求
lib/login.mjs:55
const r = await fetch(GEN, { headers: { 'User-Agent': UA } })
发起网络请求
lib/login.mjs:64
const res = await fetch(pollUrl(key), { headers: { 'User-Agent': UA }, redirect: 'manual' })
执行外部命令固定命令
lib/login.mjs:88
execFileSync('icacls', [file, '/inheritance:r', '/grant:r', user + ':F'], { stdio: 'ignore', windowsHide: true })
执行外部命令固定命令
lib/login.mjs:90
execFileSync('chmod', ['600', file], { stdio: 'ignore' })
写入本地文件
lib/login.mjs:97
mkdirSync(stateDir, { recursive: true })
写入本地文件
lib/login.mjs:99
writeFileSync(file, JSON.stringify({
执行外部命令来自配置/变量
lib/login.mjs:116
child = spawn(pythonPath || 'python', ['-c', code, url, png], { cwd: stateDir, windowsHide: true })
读取本地文件
lib/login.mjs:118
const done = () => { try { resolve(existsSync(png) ? png : null) } catch { resolve(null) } }
读取本地文件
lib/uid.mjs:13
if (!existsSync(f)) return null
读取本地文件
lib/uid.mjs:15
const c = JSON.parse(readFileSync(f, 'utf8'))
读取本地文件
lib/uid.mjs:21
try { return JSON.parse(readFileSync(join(stateDir, 'uid-cache.json'), 'utf8')) || {} } catch { return {} }
写入本地文件
lib/uid.mjs:24
try { writeFileSync(join(stateDir, 'uid-cache.json'), JSON.stringify(obj, null, 2), 'utf8') } catch { }
发起网络请求
lib/uid.mjs:38
const r = await fetch(url, {
读取本地文件
lib/dm.mjs:21
if (!existsSync(f)) return null
读取本地文件
lib/dm.mjs:23
const c = JSON.parse(readFileSync(f, 'utf8'))
发起网络请求
lib/dm.mjs:38
const r = await fetch(url, { headers: headers(cred) })
读取本地文件
lib/uvfetch.mjs:33
return createHash('sha256').update(readFileSync(file)).digest('hex')
发起网络请求
lib/uvfetch.mjs:45
const r = await fetch(source.url + '.sha256')
读取本地文件
lib/uvfetch.mjs:55
try { entries = readdirSync(dir, { withFileTypes: true }) } catch { return null }
执行外部命令来自配置/变量
lib/uvfetch.mjs:69
const r = spawnSync(cmd, args, { stdio: 'ignore' })
读取本地文件
lib/uvfetch.mjs:83
if (existsSync(target)) return target
写入本地文件
lib/uvfetch.mjs:85
mkdirSync(dir, { recursive: true })
删除本地文件递归
lib/uvfetch.mjs:87
rmSync(tmp, { recursive: true, force: true })
写入本地文件
lib/uvfetch.mjs:88
mkdirSync(tmp, { recursive: true })
请求外部主机pypi.tuna.tsinghua.edu.cn
lib/uvfetch.mjs:100
const r = await fetch('https://pypi.tuna.tsinghua.edu.cn/pypi/uv/json')
发起网络请求
lib/uvfetch.mjs:100
const r = await fetch('https://pypi.tuna.tsinghua.edu.cn/pypi/uv/json')
发起网络请求
lib/uvfetch.mjs:124
const res = await fetch(s.url)
写入本地文件
lib/uvfetch.mjs:126
await pipeline(Readable.fromWeb(res.body), createWriteStream(s.file))
读取本地文件
lib/uvfetch.mjs:127
const mb = (statSync(s.file).size / 1048576).toFixed(1)
写入本地文件
lib/uvfetch.mjs:144
copyFileSync(hit, target)
写入本地文件
lib/uvfetch.mjs:145
try { chmodSync(target, 0o755) } catch { }
执行外部命令来自配置/变量
lib/uvfetch.mjs:147
const r = spawnSync(target, ['--version'], { stdio: 'ignore' })
删除本地文件递归
lib/uvfetch.mjs:150
rmSync(tmp, { recursive: true, force: true })
删除本地文件递归
lib/uvfetch.mjs:158
rmSync(tmp, { recursive: true, force: true })
删除本地文件递归
selfcheck.mjs:45
try { rmSync(SANDBOX_HOME, { recursive: true, force: true }) } catch { }
写入本地文件
selfcheck.mjs:46
mkdirSync(SANDBOX_HOME, { recursive: true })
读取本地文件
selfcheck.mjs:58
const pkg = JSON.parse(readFileSync('./package.json', 'utf8'))
删除本地文件递归
selfcheck.mjs:118
try { rmSync(SANDBOX_HOME, { recursive: true, force: true }) } catch { }

扫描于 2026/11/4（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

涉及外部主机：api.github.com、api.bilibili.com、registry.npmjs.org、pypi.tuna.tsinghua.edu.cn

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/dsh-tools

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

DSH 插件：每天替你刷一轮 B站（个人 fork：私信会话 / 按工具口径记额度 / 通用同源判断）

README

由 DeepSeek 最新模型翻译生成

dsh-bili-scroll ｜刷B站 ⚠️ 这是个人 fork（私人版），不是上游 —— 上游见 c1overzz/dsh-bili-scroll。相对上游 2.0.4 多出的东西（私信会话、按工具口径记额度、通用同源判断…）见 FORK.md。装法一样：dsh plugin --profile web add <本仓库地址>，装完重启一次 dsh。先看三行 - 需要 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 起已修 ✓。

展开完整文档（README 剩余 1 节）

dsh-bili-scroll ｜ 刷B站

⚠️ 这是个人 fork（私人版），不是上游 —— 上游见 c1overzz/dsh-bili-scroll。
相对上游 2.0.4 多出的东西（私信会话、按工具口径记额度、通用同源判断…）见 FORK.md。
装法一样：dsh plugin --profile web add <本仓库地址>，装完重启一次 dsh。

先看三行
- 需要 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 环境时缺一个参数，依赖装不上、二维码也画不出来，重装多少次都一样）。

🎬 演示视频：https://www.bilibili.com/video/BV1d8pU6xEZX/　·　💬 交流群（QQ）：1128547307

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

它做什么

- 按你填的关键词（留空则用内置那几组）搜近几天的视频
- 逐条读字幕原文再判断（不看摘要）；没字幕的直接跳过 —— 除非你开了「本地转写」
- 写一份 Markdown 报告到 out/<日期>.md：每条含「为什么值得」+「它自己的一句话」；每条的段首固定写成 ### BV号 —— 插件数今天挑了几条，数的就是这些标题行
- 开着「自动评论」时，每轮发一条评论、@ 你一次（默认每轮 1 条，设置页可调到每轮最多 20 条）
- 可以在峰谷时段自动跑（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 下到自己的家目录 ⇒ 这条前提不用用户操心、也不用管理员权限。
⚠️ 万一它自己也下不动（有用户反馈桌面版上这条链路经常不通）：手动放一份 uv.exe 到 <家目录>\bin\ 就行 ——插件会用那一份、跳过下载（你的 PATH 里本来就有 uv 的话，它直接用那个）。

装

🔴 先看这条：npm 上还是旧版（0.1.7），别用 add dsh-bili-scroll 装。
我们的 npm 发布账号还在申诉里（工单 4880295），2026-10-17 之后的新版本只能从下面两条装。

⭐ 首选：Release 里的 tgz 直链（不需要 git，也不会被 pnpm 拦构建脚本）
dsh plugin --profile web add https://github.com/c1overzz/dsh-bili-scroll/releases/download/v2.0.2/dsh-bili-scroll-2.0.2.tgz

备选：git 方式（需要机器上装了 git；pnpm 10 可能拦它的构建脚本）
dsh plugin --profile web add github:c1overzz/dsh-bili-scroll

连不上 github 的话，在链接前面加镜像：https://gh-proxy.com/（实测可用，返回的是同一个文件）。
版本号那一节会变，最新的下载地址在 Releases 页（…/releases/latest）。
（⭐ 最省事的一条：把仓库链接贴给你自己的 dsh，说「帮我装这个插件」，它会自己装。）

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

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

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

首次使用（两步）

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

设置页里有什么

分成四页签，第一次用建议只看「日常」：

| 页签 | 里面有什么 |
| 日常 | 峰谷自动刷（总开关，打开才展开「中午 12–14」「晚上 18–09」两个子开关）· 每天最多挑几条（0 = 只手动）· 它刷过的视频（卡片墙 + 档位/状态筛选 + 分页） |
| 偏好 | 它按什么说话（人设提示词） ← 想让它像谁就写在这儿，留空按中性说话 · 关注关键词（一行一个）· 自动收藏到（可选收藏夹）· 日报写多细（完整 / 薄版 / 不写）· 下面一个保存按钮 |
| 互动 | 自动评论并 @ 你（默认关）· 回复评论（默认关，只回楼中楼）· 投递方式（只私信 = 默认 / 只发评论 / 两边都发）· 私信发给谁（UID）（可留空，用昵称自动查）· 私信双向（默认关，开了它会读你的私信并回一句） |
| 高级 | 环境与账号（装主依赖 / 测一下 / 检查更新 / 扫码登录）· 复制诊断信息 · 环境自检 · 它的地盘（家目录、报告、复核评论、打开文件夹）· 工作区（老用户才需要） |

⭐ 这些设置写在 <DSH_HOME>/bili-duty/config.json；在插件这一页改，就以这一页为准。

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

- 不透露你的隐私：账号、机器路径、你聊过的话 —— 一个字都不进评论
- 每轮按设置里定的条数发评论（默认 1 条，最多 20 条）；同一视频只评论一次；不刷屏、不吵架
- 不确定的事不编（报告里如实写「没查到」）

它是怎么跑的

- 插件内部起一个 Python MCP（下面那个开源项目，已内置），把它的能力注册成 DSH 工具
- 定时到点 → 起一个 headless dsh 会话，把 prompts/duty.md（它一轮要做的事）+ 当天设置交给它
- 那一轮的工作目录 = 插件自己的家目录（它被沙箱关着，只写得了自己那一亩三分地）； ⭐ 你填的工作区里的 AGENTS.md 由插件读进来、内联进提示词 ⇒ 它按你的设定说话，而不是用一套通用人格
- ⭐ 那一轮拿不到整台工具：只给它四个只读的（搜视频 / 读字幕 / 读评论 / 看视频信息），开了「自动评论」或「回复评论」才多给一个发评论 —— 上传视频、发动态、私信、抓全站那些根本不注册，模型连它们的名字都看不到
- ⭐ 值班章程（prompts/duty.md）升级的规矩：插件记着「上次铺的是哪一版」（charter.sha256）——你没改过就跟着插件自动升级；改过就保留你那份、把新版另存成 duty.md.new（日志里会说一句），自己合一下。
⚠️ 从 0.1.5 及以前升上来的第一次没有账本可比 ⇒ 保守地当成「你改过」：新版落成 duty.md.new；确认自己没改过，把它覆盖到 duty.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（MIT，Copyright (c) 2026 AGI_Ananas）——搜索 / 字幕 / 评论 / 发评论这些能力来自它；本插件只做「挑什么、什么时候挑、要不要说话」这一层
- 需要本机有 Python 3.10+（会用 uv 或 python -m venv 建独立环境），不需要它已经进 PATH
- Python 依赖只有 4 个（bilibili-api-python / aiohttp / qrcode / mcp，见 vendor/bilibili-mcp/requirements.txt）；mcp 必须锁 <2（2.x 起不来）

路线图

- 2.0.0（当前）：私信投递默认 · 私信双向 · 「它刷过的视频」列表（档位/筛选/分页/卡片墙）· 人设提示词框 · 诊断与自检 · 每条视频一份笔记 · 设置页四页签
- 下一步：用 JS 重写 search / subtitle / comments / reply ⇒ 不再需要 Python（零安装）· 手机窄屏入口 · 「停掉这一轮」按钮

许可证

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

交流与反馈

- 遇到问题先去群里问一句 —— 安装、报错、设置这些，群里大多有人踩过；比自己从头试快得多。
- QQ 交流群：1128547307
- 确实像 bug 的（能复现、有报错原文），欢迎开 Issue：请带上 dsh 版本 / 插件版本（设置页顶部徽章）/ 系统（web 还是桌面版）/ 报错原文或 duty.log 最后几十行。
有这个我基本一轮就能定位；只说"装不上"，通常要来回问三四次。
- 想改进它：欢迎 PR。⚠️ 但请一件事一个 PR（不要一个 PR 塞五个功能），这样我能独立合并、出问题也好回滚。
- 二次分发 / 二创：本仓库是 MIT，允许改、允许再发、允许商用，保留 LICENSE 里的版权行和 MIT 正文即可；提一句"基于 dsh-bili-scroll 改的"就更好了。第三方代码与署名见 NOTICE.md。
- 演示视频：<https://www.bilibili.com/video/BV1d8pU6xEZX/>

反馈请不要去打扰素材作者（上善 / ZipZipPipe 等），他们只管角色形象，不管这个插件。