前言¶
在 DSH（DeepSeek Harness）里做带人格、带日程的智能体时，常见做法是单独接评论脚本或 B 站 CLI，再在会话外手动拼调度。lmlmlml717/dsh-dafeiyu-biliWorld（npm 包名 dsh-world-bili）把「可生活的世界」和 B 站刷视频、转动态、发评论放在同一套 profile 里，由角色按作息窗口触发，而不是靠外部 cron 零散调用。
下面按定位、能力、安装、配置与 CLI 用法说明如何使用；事实均来自仓库 README、package.json 与 SkillHub 目录简介。DSH 社区插件目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
- 维护者：lmlmlml717
- 分类：工作流（SkillHub）
- GitHub：lmlmlml717/dsh-dafeiyu-biliWorld
- 定位：在 DSH 上提供基于
dsh-world骨架的自定义酒馆式「世界」角色，并融合dsh-feiyu的评论链路与dsh-bili-whale的 B 站工具链 / 调度设计；README 写明当前介绍版本 0.9.2，package.json中包版本为 0.9.5。 - 上游关系：世界 / 记忆 / 控制台来自 dsh-world；本仓库为 B 站特化整合版，许可为 MIT。
README 注明与上游 dsh-world「大概不兼容」（维护者未实测），若 profile 里已有原版 dsh-world，安装前需自行评估冲突。
核心功能¶
一个会生活的世界¶
- 家与会话：独立家会话 + 工作区房间，房间内文件可由角色自行整理。
- 记忆：最近若干轮对话常驻；更早内容按天归档，可用
memory_find/memory_read回查；日记与自我描述由角色自行维护。 - 生活线：闹钟、焦点、日程；每日回顾与日记；可主动发起对话。
- 控制台：概览、人设、世界提示词、记录、档案、相册，以及 QQ、微信、B 站、评论与评论记录等分页。
- 相册：收藏对话中出现过的图片，控制台分页查看。
B 站自动化¶
- 定时刷视频：在世界作息窗口内随机触发，每次若干条，对每条做
debrief（标题、简介、字幕、热评等深读）。 - 转发动态：评分达标的视频转发到个人动态，配文由 agent 生成。
- 评论：可单独评论，或在转发动态时「同时评论」；共用风控与额度。
- 评论记录：控制台按天查看已发出的评论；删除时先删 B 站侧评论，再删本地记录。
- 额度与行为：每日上限、同视频去重、评论额度、心情与饥饿度等影响行为；调度上每日 N 次触发按「剩余窗口 ÷ 剩余次数」等分，避免首次被随机拖到很久之后。
聊天与桥接¶
- QQ 原生通道：经 SnowLuma 提供的 OneBot WebSocket 直连，无需第二个桥进程。
- 微信：可选 Windows 适配器（Python），默认关闭。
- 桌面桥：本机其他程序可通过
bridge送入家里并接收回复。
环境要求¶
- DSH NEXT 桌面版（README 开发对应宿主
0.2.2-rc.1一代）。 - Node.js ≥ 22.16（可用 DSH 自带运行时）。
- pnpm：优先 DSH 安装目录下的自带 pnpm。
- 可选 SnowLuma（QQ）、可选 Python 3.11（仅微信适配器）。
插件 engines.dsh 为 >=0.2.1-rc.2 <0.3.0-0。装 tgz 时 peer 可能解析到 0.2.1-rc.5 而非 0.2.2-rc.1；若重启后出现 1 required plugin did not activate，需将 profile 内 @deepseek-ai/dsh-* 与宿主对齐。@deepseek-ai/cordis peer 警告（如装成 4.1.0）README 称不影响运行。
安装与启用¶
推荐从 Releases 下载打包好的 tgz（README 示例产物名为 dsh-world-bili-0.9.2.tgz），勿在未知来源重复打包。
退出 DSH 后，在所用 profile 目录安装：
cd <DSH_HOME>/profiles/<你的 profile>
node <DSH 自带 pnpm 的入口> add <tgz 的绝对路径> --ignore-scripts
确认该 profile 的 package.json 中 dsh.profile.bundles 包含 dsh-world-bili，然后重启 DSH；也可在 DSH 插件面板中直接安装该 tgz。
开发联调时可用 link:<本仓库绝对路径>，改 src/** 后需 npm run build 并重启；分发给别人应使用 tgz，避免 link: 指向带 @deepseek-ai 依赖的源码目录导致激活失败。
更细的安装、升级与排障见仓库 docs-md/DISTRIBUTION.md 与 INSTALL.md。
配置要点¶
在 profile 的 cordis.patch.yml 中注册 bundle dsh-world-bili。README 给出占位示例，核心字段包括伴侣名、时区、life、dailyBili、qqNative 等：
- id: dsh-world-bili
name: dsh-world-bili
config:
companionName: '<她的名字>'
partnerName: '<你的称呼>'
worldId: 'default'
timeZone: 'Asia/Shanghai'
life: true
dailyBili:
enabled: false
dailyMaxVideos: 10
allowWrite: false
qqNative:
enabled: false
wsUrl: 'ws://127.0.0.1:3001'
完整字段见 docs-md/CONFIG-REFERENCE.md。
B 站凭据放在世界数据目录：
<DSH_HOME>/worlds/<worldId>/bili/credentials.json
{ "SESSDATA": "<浏览器 Cookie>", "bili_jct": "<CSRF token>", "buvid3": "<buvid3>" }
也可在控制台「B站 → Cookie 凭据」粘贴。Cookie 等同账号凭证，勿提交到 git。
先干跑再真发：bili.config.json 的 guard.dryRun 默认 true；主配置 dailyBili.allowWrite 默认 false。两处均确认后再开启真实发帖。
典型用法（B 站 CLI）¶
仓库 tools/bili.mjs 提供自检与操作命令（在克隆或解压后的仓库根目录执行）：
# 自检：凭据、登录态、API、干跑状态
node tools/bili.mjs deps
# 抓候选视频
node tools/bili.mjs feed --json
# 深读一条视频
node tools/bili.mjs debrief --bvid BV1xxxxxxxxx
# 转发到动态（先干跑，确认后加 --go）
node tools/bili.mjs act dyn --bvid BV1xxxxxxxxx --text "配文" --score 17
node tools/bili.mjs act dyn --bvid BV1xxxxxxxxx --text "配文" --score 17 --go
# 转发的同时评论
node tools/bili.mjs act dyn --bvid BV1xxxxxxxxx --text "配文" --score 17 --go --also-comment
细节见 node tools/bili.mjs --help 与 DISTRIBUTION 文档。仓库含约 592 条 Node 回归测试，写操作在测试中走 fake transport，不依赖联网发帖。
适用场景与注意¶
适合：希望在 DSH 单 profile 内跑「有人设、有记忆、有日程」的角色，并让其按规则浏览 B 站、转发动态与评论，同时在控制台审计评论记录的场景。
注意：
- 插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，并理解 Cookie、QQ Token 等敏感配置的处理方式。
- 真实发帖前务必完成干跑与
allowWrite双重确认，避免误发。 - 与原版
dsh-world并存可能存在不兼容；QQ 依赖 SnowLuma，插件不代替登录 QQ。 - SkillHub 页简介版本为 0.8.10，与 README /
package.json不一致时，以你实际安装的 tgz 与package.json为准。
结尾¶
dsh-dafeiyu-biliWorld 把世界骨架、评论风控与 B 站 CLI 调度收成一条 DSH 工作流，适合要做 B 站侧「刷—读—转—评」闭环的开发者。目录页：SkillHub 插件页；源码与文档：GitHub 仓库。
