B站刷分模型选择 ShingStars/dsh-bili-models-legacy

dsh-bili-models

dsh-bili-scroll 的社区分支（fork）：保留原版「每天替你刷一轮 B 站」的全部能力，在此之上加了每一轮的模型选择、宿主内固定会话运行、多人私信/@、特别关注 UP 主通知，并重做了设置页。

原版 dsh-bili-scroll（by c1overzz，MIT）每日自动刷 B 站：搜索关键词 → 读字幕挑出值得看的 → 写一份日报 → 值得的 @ 你 / 私信你。本仓库基于上游 0.1.11 演化而来，家目录（~/.dsh/bili-duty/）与上游完全兼容，可以从原版直接迁移，旧配置、判重表、日报、扫码登录的凭证都能沿用。

与原版 dsh-bili-scroll 的区别

| # | 能力 | 原版 dsh-bili-scroll | 本分支 dsh-bili-models |
| 1 | 每一轮用什么模型 | 另起 dsh --profile headless 子进程，用 profile 里写死的默认模型；没配 API key 整轮失败 | 设置页可任选 当前 DSH 里真实注册的模型（含其它插件提供的免费模型，如 Our Free Model）；GET /api/bili-duty/models 实时列清单 |
| 2 | 跑一轮的方式 | 每次新起一个子进程 = 新开会话 | 默认 宿主内固定会话（ctx.agents，同一条会话上的新一轮对话），不起子进程、不再新开会话；runMode: headless 可切回原版方式 |
| 3 | 上下文洞察冲突 | 子进程会话不在宿主 sessions 表里，打开「上下文洞察」面板会被当冷会话回写投影，正在跑的那一轮被中断 | 宿主内会话对宿主是活的，冲突从机制上消失 |
| 4 | 私信 / @ 的人数 | 各限一人（dmUid / mentionName） | 多人：dmUids / mentionNames 逗号分隔，最多各 20 人，每个收件人各发一条 |
| 5 | 特别关注 UP 主 | 无 | watchUids 关注最多 50 个 UP，有新视频时私信 / @ 通知（watchNotify），可设检查间隔，设置页可「立刻检查一遍」 |
| 6 | 崩溃 bug | loadCfg() 引用未声明变量（hostDiff / lastDiffSig），宿主里配过设置就 ReferenceError，host 半边起不来 | 已修（v1.0.1 起） |
| 7 | MCP 工具白名单 | 缺 bili_send_message / bili_received_replies，私信与评论复核在子进程里看不到工具 | 已补齐 |
| 8 | v4 会话格式 | — | 宿主内投喂的消息 source.kind 用自有 producer（'bili-duty'），过 v4 会话持久化校验（v2.2.0 修） |
| 9 | 设置页 UI | 一整页平铺的开关 | 胶囊分页（概览 / 定时 / 发言 / 关注 / 模型 / 环境），hero 卡 + 配额进度条，配色走 DSH 设计变量，深浅色跟随宿主 |

装

git clone https://github.com/ShingStars/dsh-bili-models.git
dsh plugin add file:C:/path/to/dsh-bili-models

装完重启 DSH，在「设置 → 刷B站」里能看到新 UI。

⭐ 别和原版 dsh-bili-scroll 同装：两个插件用同一个家目录，同时启用会互相干扰。从原版迁移请先卸载原版。

用

模型选择（「模型」页）

| 项 | 说明 |
| provider（哪家） | 当前 DSH 真实注册的 provider。留空 = 跟随 DSH 默认 |
| model | 跟着 provider 联动，列它下面能用的模型 |
| 推理强度 | 可不填；填了就写进那一轮 |
| 提供方插件（bridgePlugins） | 逗号分隔的包名，默认 dsh-our-free-model |

选好之后会显示「这一轮会用：provider / model · effort」。

和 Our Free Model 一起用：先装 dsh-our-free-model（本插件不内嵌它），provider 选 our-free-model 再挑免费模型即可。headless 模式下本插件会在 overlay 里用 file:// 精确指向它的 index.js 把它挂进子进程；没装也不报错，自动跳过。

宿主内运行（「定时」页）

runMode: in-host（默认）时，跑一轮 = 在 DSH 宿主里用 ctx.agents 驱动同一条固定会话：

- sessionId 留空自动生成并记住（存在家目录 state.json），想换新会话就清掉它；
- 每一轮是这条会话里的新一轮对话，历史上下文连续、不再新开子进程；
- 权限档位可选（read-only / workspace-write / danger-full-access），无人值守审批自动钉成 never；
- 也可切回 headless（原版方式：dsh --profile headless --patch <overlay> "<prompt>"），GET /api/bili-duty/overlay 可看当前生成的 overlay。

私信 / @ 多人（「发言」页）

- mentionNames（评论区 @ 谁）与 dmUids（私信发给谁）：逗号 / 分号 / 空格分隔均可，最多各 20 人；
- 兼容原版单数字段：留多人字段为空时沿用 mentionName / dmUid；
- 私信正文仍受 B 站 500 字符限制（code 21007），每个收件人各发一条。

特别关注 UP 主（「关注」页）

- watchUids：最多 50 个 UP 主 UID；
- watchNotify：off / dm（私信通知）/ comment（评论区 @）/ both；
- watchEveryMin：检查间隔（分钟，默认 15；后台定时器自动节流）；
- 首次见某个 UP 只建基线不补发，之后有新发布才通知（每 UP 每轮最多 3 条，按时间升序）；
- 设置页可看「已在盯」列表（UP 名 + 上次见到的视频）并「立刻检查一遍」（工具 bili_watch_check 同理）。

数据

家目录 ~/.dsh/bili-duty/（与上游一致）：

config.json 设置 state.json 运行状态（含 dutySessionId / 特别关注基线在 watch-state.json） duty.md 给那一轮的简报 seen.md 判重表 out/YYYY-MM-DD.md 日报 duty.log 运行日志 .venv/ 主依赖（设置页里「装主依赖」会建） bili_credential.json 扫码登录后的 Cookie headless-overlay.yml headless 模式每轮前重写

已知限制

- B 站账号等级：新号发不出公开评论（-107 账号未转正）、私信可能 21016 等级不够。不是插件的问题，报告里会如实记录。
- 模型调不通：/api/bili-duty/models 能看到某个 provider，不代表它的账号可用；失败时看 duty.log。
- 桥接解析（headless 模式）：桥接用的是本插件所在的那棵 node_modules，「提供方插件」要装在同一份 DSH 里。
- 本插件不提供自更新，更新请 git pull 后重装。
- 插件市场开关：不要在第三方插件市场页里切换本插件的开关 —— 它的启用状态走 profile 配置（cordis.patch.yml + dsh.profile.bundles），市场页的切换会和它打架（已知会误关）。

开发

node --check bili/index.js
node --check bili/client.js
node bili/selfcheck.mjs # 在插件目录里跑
node tools/client-smoke.mjs # 假 loader + 假 React，跑一遍 client

历史与致谢

- 本仓库是 c1overzz/dsh-bili-scroll（MIT, © 2026 c1overzz）的 fork，bili/ 下绝大部分代码来自上游，详见 NOTICE.md。
- v1.x 时代曾以 dsh-bili-free-scroll 的名字做过「两个插件合并成一个包」的方案，已废弃；其历史保留在本仓库 git 历史中（tag v1.0.0 / v1.0.1），旧仓库 ShingStars/dsh-bili-free-scroll 已归档，仅作历史参考。

许可

MIT。