c1overzz/dsh-bili-scroll

dsh‑bili‑scroll – 自动刷 B 站

What it is

• A plugin for the DSH (Dynamic Shell) platform that runs once a day, searches recent B‑site (bilibili.com) videos based on your keywords, reads the subtitles (or locally‑transcribed speech), decides which videos are worth noting, and writes a Markdown report. It can also post a comment and @‑mention you for the selected videos.

Key features

• Keyword‑driven search – use your own list or the built‑in defaults.
• Subtitle‑first filtering – videos without subtitles are skipped unless you enable the optional local transcription (Whisper model ~538 MB).
• Markdown report – saved to out/<date>.md with a short rationale and a one‑sentence summary for each video, prefixed by ### BVxxxx.
• Automatic commenting – optionally post up to 20 comments per run, each @‑mentioning you.
• Peak‑off‑peak scheduling – run during DeepSeek’s cheap‑token windows.
• Self‑contained dependencies – the plugin can download a tiny uv binary (≈15 MB) to create an isolated Python 3.10+ virtual environment, so no admin rights are required.

Installation steps

1. Prerequisite – have either Python 3.10+ or the uv installer on the machine. If neither is present, the plugin will download uv for you.
2. Run the DSH command:

   dsh plugin --profile web add github:c1overzz/dsh-bili-scroll
   

   (or use the npm name once the npm account is restored).
3. Restart DSH – the bundle layer only loads after a restart.
4. Open Settings → 刷B站 and click 装主依赖 to install the four Python packages (bilibili-api-python, aiohttp, qrcode, mcp<2).
5. Click 扫码登录 and scan the QR code with the B‑site mobile app (choose “记住我 / 长期”).

First‑run workflow

• The plugin creates a private virtual environment under <DSH_HOME>/bili-duty.
• It downloads the Whisper model if you enable 本地转写 (local transcription).
• A headless DSH session executes prompts/duty.md, which contains the prompt that tells the underlying bilibili‑mcp model how to search, read subtitles, and generate the report.
• Results appear in the 日常 tab and as a Markdown file in out/.

Configuration highlights

Tab	Controls
日常	Enable peak/off‑peak auto‑run, set daily max items, view processed videos.
偏好	Set persona prompt, keyword list, target favorite folder, report detail level.
互动	Toggle auto‑comment/@‑mention, reply mode, delivery method (private message or comment), target UID.
高级	Install/check dependencies, run diagnostics, view plugin home directory.

Safety “red lines” (hard‑coded in prompts)

• Never leak personal data (account, file paths, conversation history) in comments.
• Respect the per‑run comment limit; each video gets at most one comment.
• If the plugin cannot determine value, it records “没查到” rather than fabricating.

Troubleshooting tips

• Desktop‑only DSH (NEXT/0.2.x) requires plugin version ≥ 0.1.4; older versions silently fail.
• If dependency installation hangs, you are likely on the old 0.1.0 build – run add again to upgrade.
• When uv cannot be downloaded, drop a pre‑downloaded uv.exe into <home>\.dsh\bili-duty\bin\.
• Enable 本地转写 by also clicking the 装转写依赖 button; otherwise subtitle‑less videos are skipped.

Roadmap

• v2.0.0 (current) adds richer UI, bidirectional private‑message interaction, per‑video notes, and diagnostic tools.
• Future work aims to rewrite the search/subtitle pipeline in JavaScript to eliminate the Python runtime entirely.

License

• MIT for the plugin itself; the bundled bilibili-mcp component carries its own MIT license.

Community

• QQ group 1128547307 for quick help.
• Issues and PRs are welcomed; include DSH version, plugin version, system type, and relevant log excerpts.

---

This summary is based solely on the repository’s README.