c1overzz/dsh-bili-scroll

选用指南

AI 根据 README 整理 · 2026/10/29 20:36:30

使用方式

通过命令行安装插件，然后在设置页配置关键词、自动评论等选项，并扫码登录B站账号。

查看 README 依据

> ✅ **已经做到了**（v0.1.1 起）：插件会**自己把 `uv` 下到自己的家目录** ⇒ 这条前提不用用户操心、也不用管理员权限。 > ⚠️ 万一它自己也下不动（有用户反馈桌面版上这条链路经常不通）：**手动放一份 `uv.exe` 到 `<家目录>\bin\`** 就行 —— > 插件会**用那一份、跳过下载**（你的 `PATH` 里本来就有 `uv` 的话，它直接用那个）。 ## 装 > 🔴 **先看这条：npm 上还是旧版（0.1.7），别用 `add dsh-bili-scroll` 装。** > 我们的 npm 发布账号还在申诉里（工单 4880295），2026-10-17 之后的新版本**只能**从下面两条装。 ```bash # ⭐ 首选：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 可能拦它的构建脚本）

⚠️ 我们自己也只在 **npm 0.1.7-rc.x + web profile** 上实测过；桌面版这条路靠用户反馈修好的 —— 装完还是不行的话，把 `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`，不上传任何地方。 ## 设置页里有什么 分成四页签，第一次用建议只看「日常」： | 页签 | 里面有什么 | |---|---|

部署要求

需要 dsh ≥ 0.1.7-rc.1，以及 Python 3.10+ 或 uv（至少一个）。安装后必须重启 dsh。

查看 README 依据

# 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 ——

- 可以在**峰谷时段自动跑**（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+ 就绕过去了 ✓

已知限制

桌面版（DSH NEXT / 0.2.x）上自动运行可能卡住，建议手动运行；0.1.3及以前版本在桌面版无法安装。

查看 README 依据

# 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 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` 就升级了）。