# 两个浏览插件的历史隔离与升级 核对日期:2026-10-24。B 站源码参考 `c1overzz/dsh-bili-scroll` 提交 `5be5f6d57c47c7e79ad9bc4ce39457b68a160dfa`(2.1.0)。 ## 数据与界面互不共用 | 项目 | 刷小黑盒 | 刷 B 站 | | --- | --- | --- | | 数据目录 | `$DSH_HOME/heybox` | `$DSH_HOME/bili-duty` | | 浏览来源 | `automation.json` 中当前账号的 `watched` | `seen.md` | | 浏览接口 | `/heybox/watched` | `/api/bili-duty/watched` | | 会话标签 ID | `heybox-watched` | `bili-watched` | 小黑盒不会读取、写入或删除 B 站的历史、日报、凭据或插件源码。高级菜单的一键安装只在 `heybox/dependencies` 安装扫码依赖,不重装其他插件。两个标签使用独立 ID,不会互相替换注册项。 小黑盒 v0.9.0 起将浏览档案与最近运行日志分开保存。运行日志仍滚动保留 200 条、显示 40 条,浏览档案按账号持久化,界面每页 50 帖。生成失败导致帖子下轮可重试时,已读档案仍保留。升级从旧版 `seen` 恢复帖子 ID 和时间,并尽可能从尚存的运行日志恢复标题;已经被旧版日志轮转丢弃的标题无法找回。 ## B 站界面变空的独立原因 上游 2.1.0 的 `parseSeenTable()` 仍跳过非 `|` 开头的行。如果模型写入: ```text - 2026-10-24 · BV1dsn86FEKB · 标题 · 挑中(值得看) ``` 文件存在但接口可能返回 0 条。重装包会替换 `index.js` 中的手工补丁;这与小黑盒数据无关。上游还会把 30 天前的表格归档到 `seen/YYYY-MM.md`,目前卡片接口只读取主 `seen.md`,因此不能把它视为所有月份的完整历史。 仓库提供显式维护工具 `scripts/bili-compat.mjs`,插件本身不会自动执行它。支持已核对的源码结构:兼容表格和日期 / BV / 标题 / 状态列表;B 站元数据请求携带本机登录 SESSDATA,图片 CDN 不携带;仅把旧 `PERSONA_LIMIT = 6000` 提高到 8000,保留新版的 40000 上限。未知源码结构会拒绝修改。 先停止宿主里的 B 站任务,定位**当前实际加载的包目录**,再执行: ```sh # 默认仅检测,不写文件。 node scripts/bili-compat.mjs /actual/dsh-bili-scroll/index.js # 语法检查通过后原子替换,原文件备份到插件目录外。 node scripts/bili-compat.mjs /actual/dsh-bili-scroll/index.js \ --apply --backup-dir=/path/to/private-backups/bili ``` 之后重启实际的 DSH Web 服务,在已登录宿主的浏览器 Network 中检查 `/api/bili-duty/watched` 的 `total` 和卡片封面;不要为了测试发评论。工具不接触 `seen.md`、日报和凭据文件。重复执行已打补丁的源码不会追加修改。不要直接用它覆盖已经带有其他手工补丁的源码。 ## 防止重装覆盖的维护方式 推荐把 B 站修复保存在用户维护的源码副本 / fork,记录基于哪个上游提交修复,检查通过后以本地路径安装: ```sh dsh plugin --profile web add /path/to/maintained/dsh-bili-scroll ``` 保留包名与数据目录。先备份 profile 和 `$DSH_HOME/bili-duty`,检查安装变更后再重启。后续更新这个维护副本、重新应用补丁并跑解析检查;不要再用上游原包重装它,否则仍会覆盖修复。另一种方式是在每次上游重装后手动运行本维护工具,但这不是自动保留补丁的保证。长期最好把兼容解析合入上游;本次没有代用户向上游发布 Issue / PR。 小黑盒升级前也先备份 `$DSH_HOME/heybox` 与 profile,只更新小黑盒包。不要删除整个 `$DSH_HOME`、批量重装所有插件,或在两个插件之间复用数据目录。 ## 部署检查清单 以下使用通用路径示例,请按自己的安装位置和服务管理方式调整: 1. 停止定时任务并等待当前一轮结束,备份自己的 Web profile、两个插件的数据目录和维护副本。备份可能包含登录凭据,应限制访问,不要提交到仓库。 2. 在小黑盒独立源码目录更新代码,执行 `npm ci --ignore-scripts`、`npm run check`、`npm test`。只更新当前插件,不批量重装 B 站插件。 3. 确认 profile 仍引用各自的维护目录,重启自己的 DSH Web 宿主。 4. 核对两个浏览历史接口的条数与更新前一致,分别检查图片、账号状态和任务开关;无需为了检查而发送评论。 5. B 站上游更新先合并到维护副本,确认兼容补丁、列表解析和封面请求正常后再部署。直接重装上游包仍可能覆盖维护补丁。 文档中的路径与账号字段均应使用示例值。真实服务名称、部署目录、备份位置和运行数据应保存在自己的私有运维记录中。