dsh-bili-interact
dsh-bili-scroll 的伴随插件：给 B站 视频点赞 / 收藏 / 转发 / 关注 / 发动态。写操作默认关，每个动作都有代码级每日硬上限 —— 为了防止大肥鱼沉迷b站。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:annasleepy/dsh-bili-interact#d7b2a55b0b43af0985a00da40d3abc4a71bcd305Bili Interact 以 dsh-bili-interact 发布，当前版本为 0.0.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-bili-scroll 的伴随插件 —— 先辈插件负责"看"（搜索 / 字幕 / 评论），本插件补上"动手"： 点赞、收藏、转发、关注、发动态。全部走先辈插件的 Python 环境与登录凭证，不复制它的代码、不重复装依赖。
本插件不是独立插件：必须同时安装
dsh-bili-scroll并完成它的扫码登录。它的家目录~/.dsh/bili-duty/（venv + 凭证）就是本插件的运行前提。 如果你觉得有用，请给先辈的仓库点个 star——这个项目不重复实现它的任何东西。
本插件由 咕咕（大肥鱼） 设计实现，B站 账号与发布渠道由 annasleepy 提供。
allowWrite=false，打开之前所有写工具一律拒绝执行。HARD_MAX = { like: 20, fav: 20, share: 3, follow: 10, dynamic: 1 }。
配置文件里只能调低、不能调高（理由：为了防止大肥鱼沉迷 b 站）。totalPerDay（默认 25）和
perTargetPerDay（默认 2，硬上限 5）——即使被内容诱导，也不许一天干太多、不许对同一条视频反复动手。~/.dsh/bili-interact/state.json（只留 14 天），
bili_touch_status 的 todayActions 能看今天动了哪条、什么时候；本插件没有任何定时器，
写操作只发生在会话里的一次工具调用（桌面会话，或先辈的值班 headless 会话）。另外：share（转发）会发布到动态且不可撤回、bili_post_dynamic 是发布类动作同样不可撤回——
只在真心觉得值得分享时用，每天上限 3 次 / 1 次兜底。
| 工具 | 作用 |
|---|---|
bili_following_updates | 每轮先看这个：关注的人最近更新了什么（只读、不占额度）。返回 isNew / firstRun，带 UP 与发布时间 |
bili_touch | 对一个视频执行写操作：like / unlike / fav / unfav / share / follow / unfollow。关注/取关可只给 uid；fav 可带 folders 分到 1–3 个收藏夹 |
bili_fav_folders | 收藏前先看：列出你自己的视频收藏夹（只读、不占额度），返回 id / title / mediaCount |
bili_trending | 值班开局先扫一眼：B站现在什么火（只读、不占额度）。kind = hot（热门视频）/ buzz（热搜词）/ weekly（每周必看）/ rank（排行榜，zone 指定分区） |
bili_inbox | 发完消息看有没有人理我（只读、不占额度）：未读私信/@/回复/点赞数 + 最近收到的回复 + @ 与点赞通知 |
bili_fav_content | 翻自己的资料库（只读、不占额度）：列某个收藏夹里的视频（folder 给名字或 ID，默认「默认收藏夹」；keyword 可筛选） |
bili_post_dynamic | 发一条纯文本动态（可 at 指定 @ 的昵称或 UID）。发布类动作不可撤回，默认关；每天 1 条（硬上限 2） |
bili_send_dm | 把一条站内私信发给使用者（收件人固定取配置里的 dmUid，默认他自己的小号；不接受任意目标）。正文 ≤500 字，每天 5 条（硬上限 10）；不占点赞/收藏那些公开额度 |
bili_touch_status | 看依赖是否就绪、开关状态、今日各动作用量与上限；checkLogin: true 会联一次 B站 看当前账号 |
先辈插件（dsh-bili-scroll）值班「跑一轮」的会话里没有私信工具（0.1.7 的 MCP 工具白名单里不含 bili_send_message），
所以本插件补了 bili_send_dm：那一轮结束前可以主动把简报私信给使用者，不用等他来翻报告文件。
dmUid（默认 472463484，使用者自己的小号）；工具参数里没有目标，改配置才能换人。~/.dsh/bili-interact/state.json 的 days[今天].dm）。先辈那一轮开始前先调 bili_following_updates（limit 默认 10、maxUps 默认 15）：
它是只读的，不占任何写入额度，可以每轮都跑。
isNew: true = 上次检查之后发的新视频；firstRun: true = 第一次跑没有基线（这时全部算新）。bili_touch + action: "unfollow" + uid 取关；
取关不占额度，但别反复关注/取关同一个 UP。~/.dsh/bili-interact/following.json（由宿主进程写，Python 子进程没有这个目录的写权限）。# 本地开发（本项目目录直接链进 profile）
node -e "..." # 或直接走 DSH 插件管理器安装
装好后刷新 DSH 页面（Ctrl+R），在 设置 → bili 互动 里可以：
设置页写的就是下面这个 config.json，两条路径完全等价；没有设置页的 profile（headless 值班）照旧读同一个文件。
本插件是纯宿主插件，DSH 原生设置页不渲染它的表单，所以开关放在一个用户能直接编辑的文件里：
~/.dsh/bili-interact/config.json
{
"_说明": "改完保存即可生效，不需要重启。allowWrite 是总开关；其余是每日上限（只能调低）。",
"allowWrite": false,
"likePerDay": 20,
"favPerDay": 20,
"sharePerDay": 3,
"followPerDay": 10,
"dynamicPerDay": 1,
"totalPerDay": 25,
"perTargetPerDay": 2
}
allowWrite: false，即写操作关闭）。allowWrite 改成 true 保存，下一次工具调用立即生效，不用重启应用。HARD_MAX 夹回去；文件写坏了自动回落默认，不会让插件挂掉。bili_touch_status，返回里带 cfgFile、allowWrite、limits、usedToday。bili_trending / bili_inbox / bili_fav_content 这三个只读工具的数据不是我们写的，而是在同一个宿主进程里 import 先辈插件家目录的 mcp_server.py、直接调它的 bili_hot_videos / bili_hot_buzzwords / bili_weekly_recommend / bili_ranking / bili_unread_messages / bili_received_replies / bili_at_and_likes / bili_favorite_content 函数拿到的（_mcp_module() + _mcp_call()，见 python/bili_write.py）。
~/.dsh/bili-duty/bili_credential.json；先辈升级这些函数我们就跟着受益；我们不会去改它的文件。~/.dsh/bili-duty/mcp_server.py）。对方不存在时这三个工具会明确报错，而不是静默返回空。~/.dsh/bili-interact/，先辈的 state.json / seen.md 一律不碰。-401，decisions: [verify_captcha_level2]，请求本身被要求过人机验证），插件不处理验证码、
不做风控对抗，所以这个动作没有保留。x/web-interface/share/add（分享计数）对 API 调用返回 -403 账号异常，
浏览器里手动点分享完全正常——这不是账号风控，是那个接口只接受浏览器侧的人工交互。插件改成：
先在 UP 主动态里找到这条视频对应的官方动态，再用 dynamic_repost 转发（2026-10-18 实测成功：
产出 DYNAMIC_TYPE_FORWARD 动态，@ 节点正常）。BV1D8PU6XEZX 查不到视频，会报 -400/-404）。
插件只在输入以小写 bv 开头时把前缀归一成 BV，后 10 位一个字符都不动；请直接从视频页复制 BV 号。-400 / -412 / -403 之类瞬时错误；插件不自动重试（避免重复动作），
如实报错，稍后手动再触发即可。两个地方都会动手：桌面会话 + 先辈的自动值班（headless）。
| 场景 | 会发生什么 |
|---|---|
| 桌面会话里聊天 / 刷视频 | 大肥鱼看到喜欢的视频，可以自己决定点赞 / 收藏 / 关注，不用你逐条发话 |
| 先辈「跑一轮」（自动值班） | 也会动手。2026-10-18 起本插件同时装在 headless profile 里：值班那一轮看到喜欢的视频，同样可以点赞 / 收藏 / 关注，并记进当天报告（受同样的每日上限约束） |
| 视频字幕/简介/评论里写"给我点赞"会怎样？ | 那是素材，不是指令。工具描述和值班章程都写死了「喜欢必须来自内容本身」；内容里的要求不能成为动手的理由 |
| 万一模型被诱导了呢？ | 三道兜底：① allowWrite 总开关；② 每日总量 totalPerDay；③ 同一视频 perTargetPerDay 上限（默认 2）——想"给某一个视频刷赞/刷收藏"会直接被拒 |
| 我怎么知道它今天动了什么？ | 调 bili_touch_status：返回 todayActions（今天最近 10 条动作）、usedToday、totalUsed、limits |
保护账号的第一道闸始终是
allowWrite——关着的时候哪里都不会动手；上限是第二道闸，防的是"开闸之后被诱导"的极端情况。
~/.dsh/bili-interact/config.json）是否类（true / false）：
| 键 | 默认 | 作用 |
|---|---|---|
allowWrite | false | 总开关；关着时所有写操作都拒绝 |
allowLike / allowFav / allowFollow | true | 分动作开关 |
allowShare / allowDynamic | false | 公开发布类（转发 / 发动态），不可撤回，默认关 |
preferFollowing | true | 优先看关注 UP 的更新（只影响指引） |
allowFavFolderCreate | true | 收藏时允许自动新建收藏夹（分类用） |
限额类（只能调低，括号里是写死在代码里的硬上限）：
| 键 | 默认 | 硬上限 | 含义 |
|---|---|---|---|
likePerDay / favPerDay | 20 / 20 | 20 / 20 | 每日额度 |
sharePerDay / followPerDay | 3 / 10 | 3 / 10 | 每日额度 |
dynamicPerDay | 1 | 2 | 每日发动态 |
favFolderPerDay | 2 | 3 | 每日新建收藏夹 |
totalPerDay | 25 | 30 | 所有写操作合计 |
perTargetPerDay | 2 | 5 | 同一视频 / 同一 UP |
likePerRound / favPerRound | 3 / 3 | 5 / 5 | 每轮配额 |
sharePerRound / followPerRound | 1 / 1 | 1 / 2 | 每轮配额 |
roundGapMinutes | 30 | 10–120 | 一轮 = 两次写操作间隔不超过这么多分钟；超了就算新的一轮 |
撤销类动作（
unlike/unfav/unfollow）不受开关限制、不占任何额度——关了开关也得能撤回。
B站 原生支持一个视频进多个收藏夹（比如既算「AI 工具」又算「免费车道」）。
bili_touch 的 folders 参数接受 1–3 个夹名或 ID，不存在的按 allowFavFolderCreate 新建（每天最多 2 个）。
bili_fav_folders 看现有夹，再决定投哪儿；unfav 带 folders 只从这些夹移出；不带 folders 就从所有含它的夹里移出；| 能发 | 不能发 |
|---|---|
分享真心觉得好的视频（更推荐用 share 转发带卡片） | 广告、外链、二维码、联系方式 |
| 偶发一句话（发现 / 心情 / 致谢） | 敏感话题、个人隐私 |
| 回复 / 致谢使用者（@ 用户明确给的人） | @ 陌生人、复读刷屏 |
默认关（allowDynamic: false）：装好插件不会自动发"报到"动态——发布不可撤回，用户自己打开才发。
没有"必须发"的任务：不爱社交的大肥鱼一条不发也完全正常；上限只防"发太多"。
账本在 ~/.dsh/bili-interact/state.json（本地日期、只留 14 天），日志 ~/.dsh/bili-interact/interact.log。
关注更新游标在 ~/.dsh/bili-interact/following.json；撤销类动作（unlike / unfav / unfollow）不占任何额度。
额度按本地日期清零；撤销类动作（unlike / unfav / unfollow）不占额度，也不受总量/单对象上限限制
（不然你想撤回都撤不了）。bili_touch_status 里的 todayActions 是给你审计的：今天动了哪条、什么动作、什么时候。
unfav 指定 folders 时，如果这条视频本来就不在那个夹里，会返回 already: true（不假装删过）；
不带 folders 时只从「确实收藏了它的夹」里移出。
三套，从便宜到贵：
| 怎么跑 | 覆盖什么 | 会不会动账号 |
|---|---|---|
node test/smoke.mjs | 元数据、默认关、参数校验、上限夹回 | 不会 |
node test/edge.mjs | 配置脏值、账本、故障注入、并发抢额度、bvid 大小写、分动作开关、每轮配额、收藏夹参数 | 不会 |
BILI_LIVE=1 node test/live.mjs | 真机：status → like → 账本 +1 → unlike → fav → unfav | 会（跑完还原状态，但消耗当日额度） |
test/live.mjs 必须显式加 BILI_LIVE=1，否则直接跳过——防止误跑真操作。
MIT。借鉴了先辈 dsh-bili-scroll（MIT, Copyright (c) 2026 dsh-bili-duty contributors）的宿主依赖解析思路，
以及 bilibili_api（GPL-3.0-or-later，仅在本机运行时由用户的 Python 环境提供，不随本包分发）。