dsh-bili-interactor

让 AI 替你在 B站上真的产生互动 —— 刷视频、点赞、投币、发弹幕、发评论、回评论，以及别人回你之后接着聊。

一个 DSH（DeepSeek Harness）插件。在 设置 → B站互动 里操作，不用另开网页。

用的是你自己的账号。 点赞会亮、投币会扣、评论会挂在视频下、关注会被人看见。默认参数刻意保守，请自己控制量 —— 大量重复操作很可能被 B站判定为异常并折叠、限流或封禁。详见文末的风险与免责。

它做什么

刷视频：按关键词搜索，粗筛掉广告/抽奖类内容，同一个 UP 主一轮内限量
互动：点赞 / 投币 / 收藏 / 发弹幕 / 关注，每项独立成败，互不影响
发评论：给视频发一条新评论，可以 @ 指定的人
读内容再说话：先取视频的 B站 AI 字幕（没有就本地转写，再没有就看弹幕），所以评论说的是视频里真正讲了什么
回评论：从别人的评论里挑「值得接话」的回 —— 挑之前也会先看一遍视频内容，判断才准；纯情绪、复读、广告不选，挑不出来就不回
接着回：后台定时检查自己发过的评论，有人回了就接着聊 —— 条数可设上限，也可设成不限
聊太多就撤：跟同一个人在同一个视频下来回聊到一定轮数，会先「审查」这段对话有没有营养、对方像不像真人。判定没营养（比如两边都是 AI 在互相捧场）就发最后一句表明不再聊，之后在这个视频下不再回复他
跳过刷过的：记住刷过哪些视频，之后不再重复推同一条（可关）
学习说话规律：不是抄别人的句子，而是从真人评论里总结「怎么说话才像真人」的可执行规律，跑得越多 AI 味越淡
都看得见：面板里能查到它说过什么、在哪些视频下说过、哪些评论真的被别人看到了、有多少条别人根本刷不到

三种「说」要分清，面板里也这么标：

标签	含义	谁先开口
评论	我在视频下发的新评论	我
回评论	别人发了评论，我去接他的话	别人
接着回	别人回的是我发过的评论，我接着聊	别人（冲我来的）

设置里改任何一项都是立刻保存、立刻生效的，不需要重启 DSH。设置页顶部有一条常驻状态条告诉你存没存上。「现在跑一轮」如果正好撞上后台监听在跑，会排队等它结束再自动开始，不用你反复点。

截图

图里是演示数据，不是真实账号内容。

总览 —— 今天动了多少次、额度用了多少、这一轮在干什么

它说了什么 —— 每条原文都在，可跳到对应楼层、可检查是否真的公开

它说了什么

碰过的视频 —— 每条视频下我说过什么，带直达链接

碰过的视频

另外三页（记忆 / 过程 / 设置）

记忆 —— 学到了什么、几分、为什么记、从哪来

过程 —— 这一轮的实时实录，包括为什么跳过某条

设置 —— 全部开关和限额

环境要求

需要什么	必须吗	用途	大小
DSH（Desktop 版，带插件系统）	必须	宿主	—
Python 3.10+ + `bilibili-api-python httpx qrcode pillow`	必须	调 B站接口、渲染登录二维码	~100MB
一个 B站账号（建议小号）	必须	干活的那个号	—
DeepSeek API key	可选	有 key 才按人设说话；没有就退回内置模板	—
本地转写环境（Whisper）	绝大多数人不需要	只有连 AI 字幕都没有的视频才用得上	700MB~1.5GB

关于「它怎么知道视频在说什么」

它读的是文字，不是画面：模型拿到的是视频的字幕文本，不解码画面、不听声音。

好消息是——大多数视频都有字幕，不需要下载任何东西。B站的 AI 字幕（ai-zh）覆盖很广，插件调 player/info 接口就能拿到，实测 4 个不同类型的视频全都有：

视频	字幕条数	语言
部署教程	1	`ai-zh` 中文
官方 MV	12	`zh-CN` / `zh-Hans` / `zh-Hant` …
748 集课程	1	`ai-zh` 中文
大肥鱼整活	8	`ai-zh` / `ai-en` / `ai-ja`

四层降级：

层	手段	条件	要装东西吗
①	B站字幕（`ai-zh` 优先）	大多数视频都有	不要
②	本地 Whisper 转写（`py/asr.py`）	连 AI 字幕都没生成的极少数视频	要，~500MB 模型
③	弹幕池	永远可用。观众会把重点和坑打在屏幕上	不要
④	只有标题/简介	上面都没有时。过程实录里会写明「只有标题」	不要

默认只用 ①③④，不下载任何东西。 第 ② 层是给你想覆盖「连字幕都没有」那种视频时用的，默认关闭，不装也完全不影响正常使用。

DeepSeek API key 是可选的：有 key 时评论/回复由模型按你的人设生成；没有 key 会退回内置模板，人设不生效（面板顶部会提示）。

安装

从插件市场装（推荐）

在 DSH 的插件市场里搜 B站互动 或 dsh-bili-interactor，点安装。

或者直接一条命令：

dsh plugin --profile desktop add github:acttk/dsh-bili-interactor

市场条目里没有锁版本 —— 安装时直接 clone 仓库的 main 分支，所以你拿到的是安装那一刻的最新代码。

装完第一件事：让它自己检查环境

面板顶部会自动做一次环境自检，缺什么直接列出来，带一个「一键装依赖」按钮（会自动建虚拟环境并 pip install，不用你手动敲命令）。

如果你更喜欢手动：

cd ~/.dsh
python -m venv bili-interactor/.venv
# Windows:
bili-interactor/.venv/Scripts/pip install bilibili-api-python httpx qrcode pillow
# macOS / Linux:
bili-interactor/.venv/bin/pip install bilibili-api-python httpx qrcode pillow

插件按这个顺序找解释器：配置项 pythonPath → ~/.dsh/bili-interactor/.venv → ~/.dsh/bili-duty/.venv（和另一个插件共用的兼容路径） → PATH 上的 python。 正常情况下你不用管这个，自检会告诉你找到的是哪个。

可选：装本地转写（大多数人不用装）

先看情况再决定：

视频有 B站字幕（大多数都有，包括 AI 字幕）→ 什么都不用装，插件直接读
视频连 AI 字幕都没有（纯音乐、无声录屏、少数冷门视频）→ 才需要这一层

要装的话：

# 在仓库根目录跑，会自动建 ~/.dsh/bili-interactor/.venv-asr 并预热模型
# Windows:
powershell -ExecutionPolicy Bypass -File scripts/setup-asr.ps1
# macOS / Linux:
bash scripts/setup-asr.sh

# 想更准可以换模型（tiny / base / small / medium，默认 small）
powershell -ExecutionPolicy Bypass -File scripts/setup-asr.ps1 medium

装完去设置里打开 「没字幕才本地转写」。

模型走 hf-mirror.com 国内镜像，不用梯子。第一次跑会加载模型（几十秒），之后就是本地读。如果本机已经装了「刷B站」插件，它的转写环境会被自动复用，不用重复装。

手动装进 profile（只有从源码开发时才需要）

从市场装的话跳过这一节。

# 2. 装进 profile
cd ~/.dsh/profiles/desktop
pnpm add link:<本仓库路径>

# 3. 让 profile 加载它：cordis.patch.yml 末尾加上
#    - insert:
#        - id: bili-interactor
#          name: dsh-bili-interactor

装完重启一次 DSH（首次要构建前端 bundle），之后改代码只需刷新页面。

第一次用

打开 设置 → B站互动
点 扫码登录，面板里会直接出二维码
手机 B站 App → 右上角扫一扫 → 点「确认登录」
面板变成「已登录」，就能用了

二维码 180 秒有效，面板里有倒计时。没扫完就离开页面也没关系，宿主在后台继续轮询，扫上了会自动变成已登录。

登录成功的凭证存在 ~/.dsh/bili-interactor/credential.json（含 SESSDATA，别外传、别提交）。

面板

页签	能看什么
总览	今天动了几次、剩多少额度、投币数、上一轮结果；可见性告警（有多少条别人看不到）；可以手动「现在跑一轮」；按时间范围批量查可见性
它说了什么	评论、回评论、接着回、私信的全部原文；带「跳到这一楼」和「复制正文」；每条都标了「公开 / 仅自己可见 / 查不到」
碰过的视频	今天碰过的视频卡片：标题、UP、各种动作次数、我在这条下说过的话（带直达）；可筛「我说过话的」
不再回复的人	聊太多被判定没营养之后记下来的人：名字、聊了几轮、原因、视频链接；可逐个「恢复回复」或全部清空
记忆	学到的说话规律（不是别人原话）、分数、为什么记、来源；可单条删除、可手动添加
过程	这一轮的实时实录：在搜什么、挑了哪条、为什么跳过、失败原因、审查结果
设置	全部开关和限额；顶部有常驻保存状态条

可见性检查按楼分组查，不是按条查 —— 一个楼只发 2 次请求就能判断这个楼里我所有评论的可见性，比按条查省 6 倍请求，不容易触发风控。

配置

配置存在 ~/.dsh/bili-interactor/config.json，也可以直接在面板「设置」里改。所有上限填 0 都是不限。

额度

键	默认	说明
`enabled`	`true`	总开关
`maxVideosPerRun`	`5`	一轮刷几条视频（你真正想调的那个）
`maxActionsPerRun`	`20`	一轮最多动几次（点赞/投币/弹幕/评论/回复全算），是护栏
`maxActionsPerDay`	`120`	一天最多动几次（管「跑一轮」，不含监听回复）

三个数字别搞混：maxVideosPerRun × (2 + replyCount) 才是一轮大约的动作数。比如每轮刷 5 条、每条跟 2 个人搭话 → 一条视频约 4 个动作 → 一轮约 20 个，正好等于 maxActionsPerRun。超了就会被护栏拦住，「刷几条视频」根本轮不完 —— 设置页会直接把这两个数算给你看，超了变黄字提醒。

动作

键	默认	说明
`doLike` / `doCoin` / `doDanmaku`	`true`	点赞 / 投币 / 发弹幕
`doDigest`	`true`	先摘视频内容（字幕/弹幕）再说话，评论才不会只吐槽标题
`doTranscribe`	`false`	没字幕时用本地 Whisper 转写（准但慢，一条 1~2 分钟，需装转写环境）
`doWatch`	`false`	上报观看进度。这是在刷播放数据，默认关，容易被识别
`watchStyle`	`fast`	`fast` 几秒上报完；`real` 按真实节奏走完（更慢但更像真人）
`doFavorite` / `favoriteId`	`false` / `0`	收藏，需要填收藏夹 ID
`doFollow`	`false`	关注 UP（最容易被人发现，默认关）
`coinPerVideo`	`1`	每条投几个币
`actionIntervalMs`	`[1500, 4000]`	两次动作之间的随机间隔

选视频

键	默认	说明
`keywords`	`["恐怖游戏","游戏解说"]`	搜什么
`order`	`click`	`click` 按播放 / `pubdate` 按最新 / `totalrank` 综合
`daysBack`	`7`	太老的不碰，`0` = 不限。服务端筛，不是本地事后过滤
`minPlay`	`1000`	播放量下限
`maxPerUpPerRun`	`2`	同一个 UP 一轮最多碰几条
`skipKeywords`	见默认值	标题命中就跳过
`skipSeenVideos`	`true`	跳过刷过的视频，不再重复推同一条

daysBack 交给 B站服务端筛（time_start / time_end），不是下载 42 条再本地砍。这点很关键：按播放排序返回的天然是历史爆款，本地砍完必然剩 0 —— 会表现为「这轮空手」。另外 time_range 参数筛的是视频时长，不是发布时间，别搞混。

键	默认	说明
`doComment`	`true`	发新评论
`doReplyComment` / `replyCount`	`true` / `2`	回别人的评论；每条视频最多跟几个人搭话（是人数，不是句数）
`mentionUid`	`0`	`@` 谁（填 UID），`0` = 不 `@`
`persona` / `commentPersona`	见默认值	人设提示词，写多长都行

接着回（回复监听）

键	默认	说明
`doReplyBack`	`true`	开关
`replyBackMax`	`0`	每条评论下最多回几句，`0` = 不限
`replyBackPerDay`	`0`	一天最多回几条，`0` = 不限
`replyBackMinLen`	`2`	对方回复太短就不理
`listenIntervalMin`	`1`	每几分钟查一次
`listenMaxThreadsPerTick`	`15`	每次最多看几条「我发过的评论」（多了轮流）
`listenLookbackHours`	`72`	只往回看多少小时内自己发的评论
`deepTalkLimit`	`10`	跟同一个人在同一视频下来回聊到这么多轮就审查；判定没营养就发最后一句后不再回复他。`0` = 关掉

listenMaxThreadsPerTick 直接决定请求频率：填 20 就是每分钟最多 20 次请求。楼很多时它会轮流看，几轮转完一圈，不会漏。

「查几楼」和「隔几分钟」要一起调：两个乘起来决定「多久能发现新回复」，除起来决定「每分钟发多少请求」。楼多了之后建议 20 楼 / 5 分钟，一圈约 1 小时、每分钟 4 次请求 —— 比 50 楼 / 2 分钟（每分钟 25 次）稳得多。

学习

键	默认	说明
`doLearn`	`true`	开关
`learnPerRun`	`3`	一轮最多记几条
`learnUseCount`	`8`	说话时参考几条
`learnMinScore`	`6`	低于这个分不记（0~10）
`learnPrompt`	见默认值	你自己写的标准，会原样交给模型

它记的是规律，不是别人的原话。 分两类：

类型	是什么	怎么用
规律（rule）	可执行的写法，如「先甩结论再补理由，别铺垫」	下次写评论时必须照着做
例句（quote）	别人的原话	只用来感受语感，一个字都不许照抄

为什么这样设计：以前是「从评论区挑出说得好的句子存起来」，结果模型只会模仿那些句子，写出缝合怪 —— 记的是「别人说了什么」，不是「怎么说话」。现在改成从真人评论里提炼「怎么说话才像真人」的可执行规律（真人的回复短、有情绪、会跑题、只说半句； AI 的回复工整、面面俱到、爱总结、爱升华），跑得越多 AI 味越淡。

旧数据（没有 kind 字段）会自动当成「例句」处理，不会丢。

数据文件

全部在 ~/.dsh/bili-interactor/：

credential.json   登录凭证（含 SESSDATA，别外传）
config.json       配置
ledger.jsonl      一行一个动作（超过 3MB 自动只留最近 2000 行）
learned.jsonl     学到的规律/例句，一行一条
replied.json      已回过的子评论（防重复回）
seen.json         刷过的视频（跳过用，最多留 3000 条）
ignored.json      不再回复的人（按 视频+用户 记）
visibility.json   哪些评论是「别人能看到」的
daily.json        当日计数
live.md           过程实录
interact.log      运行日志

命令行

py/interact.py 可以单独用，全部输出 JSON：

PY=~/.dsh/bili-interactor/.venv/Scripts/python   # macOS/Linux: .venv/bin/python3

$PY py/interact.py whoami
$PY py/interact.py search    --keyword 恐怖游戏 --order click --limit 10
$PY py/interact.py comments  --bvid BV1xxxxxxx --order time --limit 20
$PY py/interact.py act       --bvid BV1xxxxxxx --like --coin 1 --danmaku "这波可以"
$PY py/interact.py comment   --bvid BV1xxxxxxx --text "……"
$PY py/interact.py sub-replies --bvid BV1xxxxxxx --rpid 123456
$PY py/interact.py visible   --bvid BV1xxxxxxx --rpid 123456
$PY py/interact.py digest    --bvid BV1xxxxxxx      # 摘视频内容（字幕/弹幕/简介）
$PY py/interact.py transcribe --bvid BV1xxxxxxx     # 本地转写（慢，要装转写环境）
$PY py/interact.py watch     --bvid BV1xxxxxxx      # 上报观看（会产生观看记录）

登录走宿主（lib/login.mjs），凭证在 Set-Cookie 响应头里。

代码结构

lib/index.js     宿主：HTTP 路由、调度、回复监听、审查、记账
lib/login.mjs    扫码登录（Node 侧，从 Set-Cookie 取凭证）
lib/targets.js   搜索、粗筛、挑目标
lib/danmaku.js   文案生成（评论/回复/弹幕/审查/告别）、学习提炼
lib/learn.js     说话规律的读写、去重、淘汰
lib/seen.js      刷过的视频（跳过用）
lib/ignore.js    不再回复的人（纯本地，不做任何 B站 拉黑）
lib/state.js     配置、账本、当日额度、本地时间
py/interact.py   执行层：只调 B站 接口，只干活不判断
py/asr.py        本地转写（Whisper，把没字幕的视频读成文字）
client.js        设置页面前端

写盘全部在 Node 侧，Python 只负责联网 —— DSH 沙箱下子进程往往写不进 ~/.dsh/<插件名>。这条边界由 tests/test_login.py 断言（它会监视每一次写盘尝试）。

测试

node smoke.mjs                          # 前端渲染、七个页签、跳转链接
node smoke-host.mjs                     # 宿主路由、状态、拒绝路径

# 契约与界面规则（这几条是踩过坑之后补的，别删）
node tests/test_state_serializable.mjs   # /state 必须永远能序列化（Timer 会挂死接口）
node tests/test_hooks_strict.mjs         # 真 React 的 hooks 顺序（放错位置整块面板崩）
node tests/test_hooks_order.mjs          # hooks 不能在提前 return 之后
node tests/test_backnow.mjs              # 「立刻检查一次」的返回契约
node tests/audit_contract.mjs            # 全量交叉检查：配置项/接口/开关有没有没闭环的

# 功能
node tests/test_no_reply.mjs            # 聊太多不再回复（作用域、轮数统计）
node tests/test_visibility_scan.mjs     # 可见性按楼分组、时间窗过滤
node tests/test_vis_busy.mjs            # 可见性扫描的忙判断（查过一次还能再查）
node tests/test_seen.mjs                # 跳过刷过的视频
node tests/test_reply_select.mjs        # 挑评论兜底：按信息量不按字数
node tests/test_reply_pick.mjs          # 「值得接话」的筛选
node tests/test_learn_rule.mjs          # 学习：规律去重、例句不挤掉规律
node tests/test_learn_mention.mjs       # @ 去重、记忆读写
node tests/test_dedupe.mjs              # 同一个楼不重复回
node tests/test_digest.mjs              # 视频内容摘取
node tests/test_login_flow.mjs          # 扫码 → 自动登录 → 凭证落盘 → 界面变已登录
node tests/test_cookie_parse.mjs        # 从 Set-Cookie 取凭证
node tests/test_qr_ttl.mjs              # 二维码有效期预算
node tests/test_scan_then_expire.mjs    # 扫了没确认就过期
node tests/test_proactive_refresh.mjs   # 主动换码

python tests/test_comment_result.py     # 评论结果判定（含 12014 频率上限）
python tests/test_login.py              # Python 侧零写盘

# 需要插件正在运行（真实端到端）
python tests/probe_endpoints.py http://127.0.0.1:<端口>
python tests/probe_userpath.py  http://127.0.0.1:<端口>

已知限制

弹幕收不回（B站限制：发出后 2 分钟内、每天 5 条），写歪了只能手动删
评论可能只有你自己看得见：code: 0 只代表 B站收下了。新号、敏感内容、短时间大量评论会被折叠或送审 —— 面板的「可见性」卡片就是查这个：选个时间范围（1 小时 / 24 小时 / 3 天 / 全部），立刻把这段时间里所有评论的可见性过一遍，列出哪些别人根本刷不到。别以为发出去了别人就能看到
被折叠多半是内容问题，不是频率问题：实测被折叠的评论几乎都是攻击性言论。降频率救不了这个，改内容才行 —— 毒舌可以，骂人不行
有频率上限：短时间内发太多评论会返回 12014，这一轮会自动停下
有风控：密集写操作可能返回 -412 / -352 / -101
它"看"视频的方式是读字幕文本，不是看画面：拿 B站字幕（ai-zh 优先）当材料，没有字幕时可以用本地 Whisper 转写，再没有就靠弹幕池 —— 它不会解码画面、也不听声音
它不上报观看（默认）：不会给视频刷播放量。开了「上报观看」才会，那属于刷数据，风险自担
没有定时「跑一轮」：只有手动触发和回复监听（写操作要你亲手按）
圈子刷久了会干：同一个小圈子（比如某个关键词）就那么几条视频，刷过之后「跳过刷过的」会把它们全筛掉，表现为「这轮空手」。这不是 bug —— 加新关键词、把「只看最近几天」调大、或清掉已刷记录就能解决

风险与免责

这是非官方工具，使用的是网页端接口。B站可能随时调整接口或提高风控等级。
请不要用它刷量、发广告、引战、批量骚扰。这类行为违反 B站社区规则，可能导致账号被限制或封禁。
自动化操作本身就有被判定为异常的风险。建议用小号，并且把各项上限设在合理范围。
使用者需自行承担使用本工具的一切后果。作者不对账号受限、内容被删、数据丢失等任何损失负责。
项目仅供学习和个人研究使用。

License

MIT

dsh-bili-interactor

让 AI 替你在 B站上真的产生互动 —— 刷视频、点赞、投币、发弹幕、发评论、回评论，以及别人回你之后接着聊。

一个 DSH（DeepSeek Harness）插件。在 设置 → B站互动 里操作，不用另开网页。

用的是你自己的账号。 点赞会亮、投币会扣、评论会挂在视频下、关注会被人看见。默认参数刻意保守，请自己控制量 —— 大量重复操作很可能被 B站判定为异常并折叠、限流或封禁。详见文末的风险与免责。

它做什么

刷视频：按关键词搜索，粗筛掉广告/抽奖类内容，同一个 UP 主一轮内限量
互动：点赞 / 投币 / 收藏 / 发弹幕 / 关注，每项独立成败，互不影响
发评论：给视频发一条新评论，可以 @ 指定的人
读内容再说话：先取视频的 B站 AI 字幕（没有就本地转写，再没有就看弹幕），所以评论说的是视频里真正讲了什么
回评论：从别人的评论里挑「值得接话」的回 —— 挑之前也会先看一遍视频内容，判断才准；纯情绪、复读、广告不选，挑不出来就不回
接着回：后台定时检查自己发过的评论，有人回了就接着聊 —— 条数可设上限，也可设成不限
聊太多就撤：跟同一个人在同一个视频下来回聊到一定轮数，会先「审查」这段对话有没有营养、对方像不像真人。判定没营养（比如两边都是 AI 在互相捧场）就发最后一句表明不再聊，之后在这个视频下不再回复他
跳过刷过的：记住刷过哪些视频，之后不再重复推同一条（可关）
学习说话规律：不是抄别人的句子，而是从真人评论里总结「怎么说话才像真人」的可执行规律，跑得越多 AI 味越淡
都看得见：面板里能查到它说过什么、在哪些视频下说过、哪些评论真的被别人看到了、有多少条别人根本刷不到

三种「说」要分清，面板里也这么标：

标签	含义	谁先开口
评论	我在视频下发的新评论	我
回评论	别人发了评论，我去接他的话	别人
接着回	别人回的是我发过的评论，我接着聊	别人（冲我来的）

设置里改任何一项都是立刻保存、立刻生效的，不需要重启 DSH。设置页顶部有一条常驻状态条告诉你存没存上。「现在跑一轮」如果正好撞上后台监听在跑，会排队等它结束再自动开始，不用你反复点。

截图

图里是演示数据，不是真实账号内容。

总览 —— 今天动了多少次、额度用了多少、这一轮在干什么

它说了什么 —— 每条原文都在，可跳到对应楼层、可检查是否真的公开

它说了什么

碰过的视频 —— 每条视频下我说过什么，带直达链接

碰过的视频

另外三页（记忆 / 过程 / 设置）

记忆 —— 学到了什么、几分、为什么记、从哪来

过程 —— 这一轮的实时实录，包括为什么跳过某条

设置 —— 全部开关和限额

环境要求

需要什么	必须吗	用途	大小
DSH（Desktop 版，带插件系统）	必须	宿主	—
Python 3.10+ + `bilibili-api-python httpx qrcode pillow`	必须	调 B站接口、渲染登录二维码	~100MB
一个 B站账号（建议小号）	必须	干活的那个号	—
DeepSeek API key	可选	有 key 才按人设说话；没有就退回内置模板	—
本地转写环境（Whisper）	绝大多数人不需要	只有连 AI 字幕都没有的视频才用得上	700MB~1.5GB

关于「它怎么知道视频在说什么」

它读的是文字，不是画面：模型拿到的是视频的字幕文本，不解码画面、不听声音。

视频	字幕条数	语言
部署教程	1	`ai-zh` 中文
官方 MV	12	`zh-CN` / `zh-Hans` / `zh-Hant` …
748 集课程	1	`ai-zh` 中文
大肥鱼整活	8	`ai-zh` / `ai-en` / `ai-ja`

四层降级：

层	手段	条件	要装东西吗
①	B站字幕（`ai-zh` 优先）	大多数视频都有	不要
②	本地 Whisper 转写（`py/asr.py`）	连 AI 字幕都没生成的极少数视频	要，~500MB 模型
③	弹幕池	永远可用。观众会把重点和坑打在屏幕上	不要
④	只有标题/简介	上面都没有时。过程实录里会写明「只有标题」	不要

默认只用 ①③④，不下载任何东西。 第 ② 层是给你想覆盖「连字幕都没有」那种视频时用的，默认关闭，不装也完全不影响正常使用。

DeepSeek API key 是可选的：有 key 时评论/回复由模型按你的人设生成；没有 key 会退回内置模板，人设不生效（面板顶部会提示）。

安装

从插件市场装（推荐）

在 DSH 的插件市场里搜 B站互动 或 dsh-bili-interactor，点安装。

或者直接一条命令：

dsh plugin --profile desktop add github:acttk/dsh-bili-interactor

市场条目里没有锁版本 —— 安装时直接 clone 仓库的 main 分支，所以你拿到的是安装那一刻的最新代码。

装完第一件事：让它自己检查环境

面板顶部会自动做一次环境自检，缺什么直接列出来，带一个「一键装依赖」按钮（会自动建虚拟环境并 pip install，不用你手动敲命令）。

如果你更喜欢手动：

cd ~/.dsh
python -m venv bili-interactor/.venv
# Windows:
bili-interactor/.venv/Scripts/pip install bilibili-api-python httpx qrcode pillow
# macOS / Linux:
bili-interactor/.venv/bin/pip install bilibili-api-python httpx qrcode pillow

插件按这个顺序找解释器：配置项 pythonPath → ~/.dsh/bili-interactor/.venv → ~/.dsh/bili-duty/.venv（和另一个插件共用的兼容路径） → PATH 上的 python。 正常情况下你不用管这个，自检会告诉你找到的是哪个。

可选：装本地转写（大多数人不用装）

先看情况再决定：

视频有 B站字幕（大多数都有，包括 AI 字幕）→ 什么都不用装，插件直接读
视频连 AI 字幕都没有（纯音乐、无声录屏、少数冷门视频）→ 才需要这一层

要装的话：

# 在仓库根目录跑，会自动建 ~/.dsh/bili-interactor/.venv-asr 并预热模型
# Windows:
powershell -ExecutionPolicy Bypass -File scripts/setup-asr.ps1
# macOS / Linux:
bash scripts/setup-asr.sh

# 想更准可以换模型（tiny / base / small / medium，默认 small）
powershell -ExecutionPolicy Bypass -File scripts/setup-asr.ps1 medium

装完去设置里打开 「没字幕才本地转写」。

模型走 hf-mirror.com 国内镜像，不用梯子。第一次跑会加载模型（几十秒），之后就是本地读。如果本机已经装了「刷B站」插件，它的转写环境会被自动复用，不用重复装。

手动装进 profile（只有从源码开发时才需要）

从市场装的话跳过这一节。

# 2. 装进 profile
cd ~/.dsh/profiles/desktop
pnpm add link:<本仓库路径>

# 3. 让 profile 加载它：cordis.patch.yml 末尾加上
#    - insert:
#        - id: bili-interactor
#          name: dsh-bili-interactor

装完重启一次 DSH（首次要构建前端 bundle），之后改代码只需刷新页面。

第一次用

打开 设置 → B站互动
点 扫码登录，面板里会直接出二维码
手机 B站 App → 右上角扫一扫 → 点「确认登录」
面板变成「已登录」，就能用了

二维码 180 秒有效，面板里有倒计时。没扫完就离开页面也没关系，宿主在后台继续轮询，扫上了会自动变成已登录。

登录成功的凭证存在 ~/.dsh/bili-interactor/credential.json（含 SESSDATA，别外传、别提交）。

面板

页签	能看什么
总览	今天动了几次、剩多少额度、投币数、上一轮结果；可见性告警（有多少条别人看不到）；可以手动「现在跑一轮」；按时间范围批量查可见性
它说了什么	评论、回评论、接着回、私信的全部原文；带「跳到这一楼」和「复制正文」；每条都标了「公开 / 仅自己可见 / 查不到」
碰过的视频	今天碰过的视频卡片：标题、UP、各种动作次数、我在这条下说过的话（带直达）；可筛「我说过话的」
不再回复的人	聊太多被判定没营养之后记下来的人：名字、聊了几轮、原因、视频链接；可逐个「恢复回复」或全部清空
记忆	学到的说话规律（不是别人原话）、分数、为什么记、来源；可单条删除、可手动添加
过程	这一轮的实时实录：在搜什么、挑了哪条、为什么跳过、失败原因、审查结果
设置	全部开关和限额；顶部有常驻保存状态条

可见性检查按楼分组查，不是按条查 —— 一个楼只发 2 次请求就能判断这个楼里我所有评论的可见性，比按条查省 6 倍请求，不容易触发风控。

配置

配置存在 ~/.dsh/bili-interactor/config.json，也可以直接在面板「设置」里改。所有上限填 0 都是不限。

额度

键	默认	说明
`enabled`	`true`	总开关
`maxVideosPerRun`	`5`	一轮刷几条视频（你真正想调的那个）
`maxActionsPerRun`	`20`	一轮最多动几次（点赞/投币/弹幕/评论/回复全算），是护栏
`maxActionsPerDay`	`120`	一天最多动几次（管「跑一轮」，不含监听回复）

三个数字别搞混：maxVideosPerRun × (2 + replyCount) 才是一轮大约的动作数。比如每轮刷 5 条、每条跟 2 个人搭话 → 一条视频约 4 个动作 → 一轮约 20 个，正好等于 maxActionsPerRun。超了就会被护栏拦住，「刷几条视频」根本轮不完 —— 设置页会直接把这两个数算给你看，超了变黄字提醒。

动作

键	默认	说明
`doLike` / `doCoin` / `doDanmaku`	`true`	点赞 / 投币 / 发弹幕
`doDigest`	`true`	先摘视频内容（字幕/弹幕）再说话，评论才不会只吐槽标题
`doTranscribe`	`false`	没字幕时用本地 Whisper 转写（准但慢，一条 1~2 分钟，需装转写环境）
`doWatch`	`false`	上报观看进度。这是在刷播放数据，默认关，容易被识别
`watchStyle`	`fast`	`fast` 几秒上报完；`real` 按真实节奏走完（更慢但更像真人）
`doFavorite` / `favoriteId`	`false` / `0`	收藏，需要填收藏夹 ID
`doFollow`	`false`	关注 UP（最容易被人发现，默认关）
`coinPerVideo`	`1`	每条投几个币
`actionIntervalMs`	`[1500, 4000]`	两次动作之间的随机间隔

选视频

键	默认	说明
`keywords`	`["恐怖游戏","游戏解说"]`	搜什么
`order`	`click`	`click` 按播放 / `pubdate` 按最新 / `totalrank` 综合
`daysBack`	`7`	太老的不碰，`0` = 不限。服务端筛，不是本地事后过滤
`minPlay`	`1000`	播放量下限
`maxPerUpPerRun`	`2`	同一个 UP 一轮最多碰几条
`skipKeywords`	见默认值	标题命中就跳过
`skipSeenVideos`	`true`	跳过刷过的视频，不再重复推同一条

daysBack 交给 B站服务端筛（time_start / time_end），不是下载 42 条再本地砍。这点很关键：按播放排序返回的天然是历史爆款，本地砍完必然剩 0 —— 会表现为「这轮空手」。另外 time_range 参数筛的是视频时长，不是发布时间，别搞混。

键	默认	说明
`doComment`	`true`	发新评论
`doReplyComment` / `replyCount`	`true` / `2`	回别人的评论；每条视频最多跟几个人搭话（是人数，不是句数）
`mentionUid`	`0`	`@` 谁（填 UID），`0` = 不 `@`
`persona` / `commentPersona`	见默认值	人设提示词，写多长都行

接着回（回复监听）

键	默认	说明
`doReplyBack`	`true`	开关
`replyBackMax`	`0`	每条评论下最多回几句，`0` = 不限
`replyBackPerDay`	`0`	一天最多回几条，`0` = 不限
`replyBackMinLen`	`2`	对方回复太短就不理
`listenIntervalMin`	`1`	每几分钟查一次
`listenMaxThreadsPerTick`	`15`	每次最多看几条「我发过的评论」（多了轮流）
`listenLookbackHours`	`72`	只往回看多少小时内自己发的评论
`deepTalkLimit`	`10`	跟同一个人在同一视频下来回聊到这么多轮就审查；判定没营养就发最后一句后不再回复他。`0` = 关掉

listenMaxThreadsPerTick 直接决定请求频率：填 20 就是每分钟最多 20 次请求。楼很多时它会轮流看，几轮转完一圈，不会漏。

「查几楼」和「隔几分钟」要一起调：两个乘起来决定「多久能发现新回复」，除起来决定「每分钟发多少请求」。楼多了之后建议 20 楼 / 5 分钟，一圈约 1 小时、每分钟 4 次请求 —— 比 50 楼 / 2 分钟（每分钟 25 次）稳得多。

学习

键	默认	说明
`doLearn`	`true`	开关
`learnPerRun`	`3`	一轮最多记几条
`learnUseCount`	`8`	说话时参考几条
`learnMinScore`	`6`	低于这个分不记（0~10）
`learnPrompt`	见默认值	你自己写的标准，会原样交给模型

它记的是规律，不是别人的原话。 分两类：

类型	是什么	怎么用
规律（rule）	可执行的写法，如「先甩结论再补理由，别铺垫」	下次写评论时必须照着做
例句（quote）	别人的原话	只用来感受语感，一个字都不许照抄

旧数据（没有 kind 字段）会自动当成「例句」处理，不会丢。

数据文件

全部在 ~/.dsh/bili-interactor/：

credential.json   登录凭证（含 SESSDATA，别外传）
config.json       配置
ledger.jsonl      一行一个动作（超过 3MB 自动只留最近 2000 行）
learned.jsonl     学到的规律/例句，一行一条
replied.json      已回过的子评论（防重复回）
seen.json         刷过的视频（跳过用，最多留 3000 条）
ignored.json      不再回复的人（按 视频+用户 记）
visibility.json   哪些评论是「别人能看到」的
daily.json        当日计数
live.md           过程实录
interact.log      运行日志

命令行

py/interact.py 可以单独用，全部输出 JSON：

PY=~/.dsh/bili-interactor/.venv/Scripts/python   # macOS/Linux: .venv/bin/python3

$PY py/interact.py whoami
$PY py/interact.py search    --keyword 恐怖游戏 --order click --limit 10
$PY py/interact.py comments  --bvid BV1xxxxxxx --order time --limit 20
$PY py/interact.py act       --bvid BV1xxxxxxx --like --coin 1 --danmaku "这波可以"
$PY py/interact.py comment   --bvid BV1xxxxxxx --text "……"
$PY py/interact.py sub-replies --bvid BV1xxxxxxx --rpid 123456
$PY py/interact.py visible   --bvid BV1xxxxxxx --rpid 123456
$PY py/interact.py digest    --bvid BV1xxxxxxx      # 摘视频内容（字幕/弹幕/简介）
$PY py/interact.py transcribe --bvid BV1xxxxxxx     # 本地转写（慢，要装转写环境）
$PY py/interact.py watch     --bvid BV1xxxxxxx      # 上报观看（会产生观看记录）

登录走宿主（lib/login.mjs），凭证在 Set-Cookie 响应头里。

代码结构

lib/index.js     宿主：HTTP 路由、调度、回复监听、审查、记账
lib/login.mjs    扫码登录（Node 侧，从 Set-Cookie 取凭证）
lib/targets.js   搜索、粗筛、挑目标
lib/danmaku.js   文案生成（评论/回复/弹幕/审查/告别）、学习提炼
lib/learn.js     说话规律的读写、去重、淘汰
lib/seen.js      刷过的视频（跳过用）
lib/ignore.js    不再回复的人（纯本地，不做任何 B站 拉黑）
lib/state.js     配置、账本、当日额度、本地时间
py/interact.py   执行层：只调 B站 接口，只干活不判断
py/asr.py        本地转写（Whisper，把没字幕的视频读成文字）
client.js        设置页面前端

测试

node smoke.mjs                          # 前端渲染、七个页签、跳转链接
node smoke-host.mjs                     # 宿主路由、状态、拒绝路径

# 契约与界面规则（这几条是踩过坑之后补的，别删）
node tests/test_state_serializable.mjs   # /state 必须永远能序列化（Timer 会挂死接口）
node tests/test_hooks_strict.mjs         # 真 React 的 hooks 顺序（放错位置整块面板崩）
node tests/test_hooks_order.mjs          # hooks 不能在提前 return 之后
node tests/test_backnow.mjs              # 「立刻检查一次」的返回契约
node tests/audit_contract.mjs            # 全量交叉检查：配置项/接口/开关有没有没闭环的

# 功能
node tests/test_no_reply.mjs            # 聊太多不再回复（作用域、轮数统计）
node tests/test_visibility_scan.mjs     # 可见性按楼分组、时间窗过滤
node tests/test_vis_busy.mjs            # 可见性扫描的忙判断（查过一次还能再查）
node tests/test_seen.mjs                # 跳过刷过的视频
node tests/test_reply_select.mjs        # 挑评论兜底：按信息量不按字数
node tests/test_reply_pick.mjs          # 「值得接话」的筛选
node tests/test_learn_rule.mjs          # 学习：规律去重、例句不挤掉规律
node tests/test_learn_mention.mjs       # @ 去重、记忆读写
node tests/test_dedupe.mjs              # 同一个楼不重复回
node tests/test_digest.mjs              # 视频内容摘取
node tests/test_login_flow.mjs          # 扫码 → 自动登录 → 凭证落盘 → 界面变已登录
node tests/test_cookie_parse.mjs        # 从 Set-Cookie 取凭证
node tests/test_qr_ttl.mjs              # 二维码有效期预算
node tests/test_scan_then_expire.mjs    # 扫了没确认就过期
node tests/test_proactive_refresh.mjs   # 主动换码

python tests/test_comment_result.py     # 评论结果判定（含 12014 频率上限）
python tests/test_login.py              # Python 侧零写盘

# 需要插件正在运行（真实端到端）
python tests/probe_endpoints.py http://127.0.0.1:<端口>
python tests/probe_userpath.py  http://127.0.0.1:<端口>

已知限制

弹幕收不回（B站限制：发出后 2 分钟内、每天 5 条），写歪了只能手动删
评论可能只有你自己看得见：code: 0 只代表 B站收下了。新号、敏感内容、短时间大量评论会被折叠或送审 —— 面板的「可见性」卡片就是查这个：选个时间范围（1 小时 / 24 小时 / 3 天 / 全部），立刻把这段时间里所有评论的可见性过一遍，列出哪些别人根本刷不到。别以为发出去了别人就能看到
被折叠多半是内容问题，不是频率问题：实测被折叠的评论几乎都是攻击性言论。降频率救不了这个，改内容才行 —— 毒舌可以，骂人不行
有频率上限：短时间内发太多评论会返回 12014，这一轮会自动停下
有风控：密集写操作可能返回 -412 / -352 / -101
它"看"视频的方式是读字幕文本，不是看画面：拿 B站字幕（ai-zh 优先）当材料，没有字幕时可以用本地 Whisper 转写，再没有就靠弹幕池 —— 它不会解码画面、也不听声音
它不上报观看（默认）：不会给视频刷播放量。开了「上报观看」才会，那属于刷数据，风险自担
没有定时「跑一轮」：只有手动触发和回复监听（写操作要你亲手按）
圈子刷久了会干：同一个小圈子（比如某个关键词）就那么几条视频，刷过之后「跳过刷过的」会把它们全筛掉，表现为「这轮空手」。这不是 bug —— 加新关键词、把「只看最近几天」调大、或清掉已刷记录就能解决

风险与免责

这是非官方工具，使用的是网页端接口。B站可能随时调整接口或提高风控等级。
请不要用它刷量、发广告、引战、批量骚扰。这类行为违反 B站社区规则，可能导致账号被限制或封禁。
自动化操作本身就有被判定为异常的风险。建议用小号，并且把各项上限设在合理范围。
使用者需自行承担使用本工具的一切后果。作者不对账号受限、内容被删、数据丢失等任何损失负责。
项目仅供学习和个人研究使用。

License

MIT

acttk/dsh-bili-interactor

dsh-bili-interactor

它做什么

截图

环境要求

关于「它怎么知道视频在说什么」

安装

从插件市场装（推荐）

装完第一件事：让它自己检查环境

可选：装本地转写（大多数人不用装）

手动装进 profile（只有从源码开发时才需要）

第一次用

面板

配置

额度

动作

选视频

评论

接着回（回复监听）

学习

数据文件

命令行

代码结构

测试

已知限制

风险与免责

License

Community comments

acttk/dsh-bili-interactor

dsh-bili-interactor

它做什么

截图

环境要求

关于「它怎么知道视频在说什么」

安装

从插件市场装（推荐）

装完第一件事：让它自己检查环境

可选：装本地转写（大多数人不用装）

手动装进 profile（只有从源码开发时才需要）

第一次用

面板

配置

额度

动作

选视频

评论

接着回（回复监听）

学习

数据文件

命令行

代码结构

测试

已知限制

风险与免责

License

Community comments