dsh-bili-interactor

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

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

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

它做什么

刷视频：按关键词搜索，粗筛掉广告/抽奖类内容，同一个 UP 主一轮内限量
互动：点赞 / 投币 / 收藏 / 发弹幕 / 关注，每项独立成败，互不影响
发评论：给视频发一条新评论，可以 @ 指定的人
回评论：从别人的评论里挑「值得接话」的回（纯情绪、复读、广告不选；挑不出来就不回）
接着回：后台定时检查自己发过的评论，有人回了就接着聊 —— 条数可设上限，也可设成不限
学习记忆：从评论区里挑有信息量的内容存下来，下次说话时带上；挑选标准由你自己写
都看得见：面板里能查到它说过什么、在哪些视频下说过、哪些评论真的被别人看到了

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

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

截图

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

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

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

它说了什么

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

碰过的视频

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

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

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

设置 —— 全部开关和限额

环境要求

需要什么	必须吗	用途	大小
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 会退回内置模板，人设不生效（面板顶部会提示）。

安装

# 1. 给插件建一个 Python 虚拟环境（推荐）
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。你已经有现成的环境就填 pythonPath，不用再建。

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

先看情况再决定：

视频有 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站」插件，它的转写环境会被自动复用，不用重复装。

# 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、各种动作次数、我在这条下说过的话（带直达）
记忆	学到的东西、分数、为什么记、来源；可单条删除、可手动添加；「什么才值得记」在这里自己写
过程	这一轮的实时实录：在搜什么、挑了哪条、为什么跳过、失败原因
设置	全部开关和限额

配置

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

额度

键	默认	说明
`enabled`	`true`	总开关
`maxActionsPerRun`	`20`	一轮最多动几次（点赞/投币/弹幕/评论/回复全算）
`maxActionsPerDay`	`120`	一天最多动几次（管「跑一轮」，不含监听回复）

动作

键	默认	说明
`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`	见默认值	标题命中就跳过

键	默认	说明
`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`	只往回看多少小时内自己发的评论

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

学习

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

数据文件

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

credential.json   登录凭证（含 SESSDATA，别外传）
config.json       配置
ledger.jsonl      一行一个动作（超过 3MB 自动只留最近 2000 行）
learned.jsonl     记忆，一行一条
replied.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   文案生成（有 key 用模型，否则模板）
lib/learn.js     记忆的读写与淘汰
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_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 # 主动换码
node tests/test_reply_pick.mjs        # 「值得接话」的筛选
node tests/test_learn_mention.mjs     # @ 去重、记忆读写
node tests/test_dedupe.mjs            # 同一个楼不重复回
python tests/test_comment_result.py   # 评论结果判定（含 12014 频率上限）
python tests/test_login.py            # Python 侧零写盘

已知限制

弹幕收不回（B站限制：发出后 2 分钟内、每天 5 条），写歪了只能手动删
评论可能只有你自己看得见：code: 0 只代表 B站收下了。新号、敏感内容、短时间大量评论会被折叠或送审 —— 面板的「检查这些是不是真的公开了」就是查这个，别以为发出去了别人就能看到
有频率上限：短时间内发太多评论会返回 12014，这一轮会自动停下
有风控：密集写操作可能返回 -412 / -352 / -101
它"看"视频的方式是读字幕文本，不是看画面：拿 B站字幕（ai-zh 优先）当材料，没有字幕时可以用本地 Whisper 转写，再没有就靠弹幕池 —— 它不会解码画面、也不听声音
它不上报观看（默认）：不会给视频刷播放量。开了「上报观看」才会，那属于刷数据，风险自担
没有定时「跑一轮」：只有手动触发和回复监听（写操作要你亲手按）

风险与免责

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

License

MIT

dsh-bili-interactor

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

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

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

它做什么

刷视频：按关键词搜索，粗筛掉广告/抽奖类内容，同一个 UP 主一轮内限量
互动：点赞 / 投币 / 收藏 / 发弹幕 / 关注，每项独立成败，互不影响
发评论：给视频发一条新评论，可以 @ 指定的人
回评论：从别人的评论里挑「值得接话」的回（纯情绪、复读、广告不选；挑不出来就不回）
接着回：后台定时检查自己发过的评论，有人回了就接着聊 —— 条数可设上限，也可设成不限
学习记忆：从评论区里挑有信息量的内容存下来，下次说话时带上；挑选标准由你自己写
都看得见：面板里能查到它说过什么、在哪些视频下说过、哪些评论真的被别人看到了

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

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

截图

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

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

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

它说了什么

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

碰过的视频

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

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

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

设置 —— 全部开关和限额

环境要求

需要什么	必须吗	用途	大小
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 会退回内置模板，人设不生效（面板顶部会提示）。

安装

# 1. 给插件建一个 Python 虚拟环境（推荐）
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。你已经有现成的环境就填 pythonPath，不用再建。

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

先看情况再决定：

视频有 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站」插件，它的转写环境会被自动复用，不用重复装。

# 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、各种动作次数、我在这条下说过的话（带直达）
记忆	学到的东西、分数、为什么记、来源；可单条删除、可手动添加；「什么才值得记」在这里自己写
过程	这一轮的实时实录：在搜什么、挑了哪条、为什么跳过、失败原因
设置	全部开关和限额

配置

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

额度

键	默认	说明
`enabled`	`true`	总开关
`maxActionsPerRun`	`20`	一轮最多动几次（点赞/投币/弹幕/评论/回复全算）
`maxActionsPerDay`	`120`	一天最多动几次（管「跑一轮」，不含监听回复）

动作

键	默认	说明
`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`	见默认值	标题命中就跳过

键	默认	说明
`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`	只往回看多少小时内自己发的评论

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

学习

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

数据文件

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

credential.json   登录凭证（含 SESSDATA，别外传）
config.json       配置
ledger.jsonl      一行一个动作（超过 3MB 自动只留最近 2000 行）
learned.jsonl     记忆，一行一条
replied.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   文案生成（有 key 用模型，否则模板）
lib/learn.js     记忆的读写与淘汰
lib/state.js     配置、账本、当日额度
py/interact.py   执行层：只调 B站 接口，只干活不判断
py/asr.py        本地转写（Whisper，把没字幕的视频读成文字）
client.js        设置页面前端

测试

node smoke.mjs                        # 前端渲染、六个页签、跳转链接
node smoke-host.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 # 主动换码
node tests/test_reply_pick.mjs        # 「值得接话」的筛选
node tests/test_learn_mention.mjs     # @ 去重、记忆读写
node tests/test_dedupe.mjs            # 同一个楼不重复回
python tests/test_comment_result.py   # 评论结果判定（含 12014 频率上限）
python tests/test_login.py            # Python 侧零写盘

已知限制

弹幕收不回（B站限制：发出后 2 分钟内、每天 5 条），写歪了只能手动删
评论可能只有你自己看得见：code: 0 只代表 B站收下了。新号、敏感内容、短时间大量评论会被折叠或送审 —— 面板的「检查这些是不是真的公开了」就是查这个，别以为发出去了别人就能看到
有频率上限：短时间内发太多评论会返回 12014，这一轮会自动停下
有风控：密集写操作可能返回 -412 / -352 / -101
它"看"视频的方式是读字幕文本，不是看画面：拿 B站字幕（ai-zh 优先）当材料，没有字幕时可以用本地 Whisper 转写，再没有就靠弹幕池 —— 它不会解码画面、也不听声音
它不上报观看（默认）：不会给视频刷播放量。开了「上报观看」才会，那属于刷数据，风险自担
没有定时「跑一轮」：只有手动触发和回复监听（写操作要你亲手按）

风险与免责

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

License

MIT

acttk/dsh-bili-interactor

dsh-bili-interactor

它做什么

截图

环境要求

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

安装

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

第一次用

面板

配置

额度

动作

选视频

评论

接着回（回复监听）

学习

数据文件

命令行

代码结构

测试

已知限制

风险与免责

License

Community comments

acttk/dsh-bili-interactor

dsh-bili-interactor

它做什么

截图

环境要求

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

安装

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

第一次用

面板

配置

额度

动作

选视频

评论

接着回（回复监听）

学习

数据文件

命令行

代码结构

测试

已知限制

风险与免责

License

Community comments