前言¶
在 DSH 里跑「每天替你刷一轮 B 站」类插件时，常见两类麻烦：一轮用的模型被 profile 写死，没配好 API key 整轮直接失败；或者每轮起 dsh --profile headless 子进程，会话和宿主「上下文洞察」打架，跑着的任务会被打断。原版 dsh-bili-scroll（MIT，c1overzz）已经能把搜索、读字幕、写日报、@ 和私信串成定时任务，但上述模型与运行方式上的限制仍在。
下面介绍社区分支 dsh-bili-models（SkillHub 目录名 shingstars/dsh-bili-models-legacy）：在保留原版「刷 B 站」能力的前提下，增加每轮模型选择、宿主内固定会话、多人私信/@，以及特别关注 UP 主新视频通知，并重做设置页。家目录 ~/.dsh/bili-duty/ 与上游兼容，可从原版迁移配置与登录凭证。
这是什么¶
维护者 ShingStars 在 GitHub 提供本插件（ShingStars/dsh-bili-models-legacy），分类为联网工具；README 说明其基于上游 dsh-bili-scroll 0.1.11 演化，当前包版本 2.2.0（见 package.json），许可证 MIT。SkillHub 简介将其概括为：dsh-bili-scroll 的社区分支，每轮可选任意 DSH 注册模型（含免费模型）、宿主内固定会话运行、多人私信/@、特别关注 UP 主新视频通知、设置页重做。
与原版相比多了什么¶
| 能力 | 原版 | 本分支 |
|---|---|---|
| 每轮模型 | profile 子进程里默认模型 | 设置页选 DSH 已注册 provider/model；GET /api/bili-duty/models 列清单 |
| 运行方式 | 每轮新子进程、新会话 | 默认宿主内 ctx.agents 固定会话；runMode: headless 可回原版 |
| 上下文洞察 | 子进程会话易被当冷会话打断任务 | 宿主内会话对宿主可见，机制上避免该冲突 |
| 私信 / @ | 各限一人 | dmUids / mentionNames 逗号等分隔，各最多 20 人 |
| 特别关注 UP | 无 | watchUids 最多 50 人，新视频按 watchNotify 私信或 @ |
| 其它 | 已知 loadCfg 等问题、MCP 工具不全 |
v1.0.1 起修复崩溃；补齐 bili_send_message 等；v2.2.0 适配 v4 会话格式 |
安装与启用¶
README 给出的安装方式为：在本地准备好插件目录后，用 file 路径注册（示例为 Windows 路径，Linux/macOS 请换成你的实际路径）：
dsh plugin add file:C:/path/to/dsh-bili-models
装完后重启 DSH，在「设置 → 刷B站」中应能看到新 UI。要求 DSH >= 0.1.7-rc.1、Node >= 22。
注意：
- 不要与原版 dsh-bili-scroll 同时启用：两者共用
~/.dsh/bili-duty/，会互相干扰；从原版迁移请先卸载原版。 - README 写明本插件不提供自更新；更新代码后需重新执行
dsh plugin add file:...一类安装步骤。 - 不要在第三方插件市场页随意切换本插件开关；启用状态以 profile（
cordis.patch.yml+dsh.profile.bundles）为准，与市场页切换可能冲突。
目录页：SkillHub - shingstars/dsh-bili-models-legacy。
典型用法¶
模型（「模型」页）¶
| 项 | 说明 |
|---|---|
| provider | DSH 已注册的 provider；留空跟随 DSH 默认 |
| model | 随 provider 联动 |
| 推理强度 | 可选，写入当轮 |
| bridgePlugins | 逗号分隔，默认 dsh-our-free-model |
可与 Our Free Model 配合：先单独安装该插件，provider 选 our-free-model 再选免费模型；本插件不内嵌该依赖。
定时与运行模式（「定时」页）¶
默认 runMode: in-host：同一 sessionId（空则自动生成并写入家目录 state.json）上连续多轮对话；权限档可选 read-only / workspace-write / danger-full-access，无人值守时审批为 never。切回 headless 即原版子进程方式；可用 GET /api/bili-duty/overlay 查看生成的 overlay。
发言（「发言」页）¶
mentionNames 与 dmUids 支持逗号、分号或空格分隔，各最多 20 人；多人字段为空时仍兼容原版 mentionName / dmUid。私信受 B 站 500 字符限制（code 21007），每人单独一条。
关注（「关注」页）¶
watchUids 最多 50；watchNotify 为 off / dm / comment / both；watchEveryMin 默认 15 分钟。首次见到某 UP 只建基线不补发；之后新发布才通知。设置页可「立刻检查一遍」（工具 bili_watch_check）。
数据目录¶
家目录 ~/.dsh/bili-duty/ 含 config.json、state.json、duty.md、seen.md、out/YYYY-MM-DD.md、duty.log、bili_credential.json 等，与上游布局一致。
适用场景与注意¶
适合已经在用或打算用 dsh-bili-scroll 工作流、又希望在 同一 DSH 宿主 里按轮换模型（含其它插件提供的免费模型）、减少子进程与会话冲突，并需要多人通知或盯 UP 更新的开发者。
插件以当前 DSH 进程权限运行，会访问 B 站账号与网络；安装前请阅读仓库源码与 MIT 许可证，自行评估风险。
已知限制（来自 README）：
- B 站账号等级不足时可能无法发公开评论或私信，报告会记录平台返回码。
/api/bili-duty/models能列出 provider 不代表账号可用，失败时查duty.log。- headless 模式下桥接插件需装在同一 DSH 的
node_modules树中。
结尾¶
dsh-bili-models-legacy 在保留「搜索 → 字幕 → 日报 → 通知」主线的同时，把模型选择与运行方式拉回 DSH 宿主能力之内，并扩展多人通知与 UP 关注。需要细节与变更历史见 GitHub README 与 SkillHub 目录页；问题可提 Issues（README 中仓库名为 dsh-bili-models）。
