前言¶

在 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，安装前需自行评估冲突。

核心功能¶

一个会生活的世界¶

1. 家与会话：独立家会话 + 工作区房间，房间内文件可由角色自行整理。
2. 记忆：最近若干轮对话常驻；更早内容按天归档，可用 memory_find / memory_read 回查；日记与自我描述由角色自行维护。
3. 生活线：闹钟、焦点、日程；每日回顾与日记；可主动发起对话。
4. 控制台：概览、人设、世界提示词、记录、档案、相册，以及 QQ、微信、B 站、评论与评论记录等分页。
5. 相册：收藏对话中出现过的图片，控制台分页查看。

B 站自动化¶

1. 定时刷视频：在世界作息窗口内随机触发，每次若干条，对每条做 debrief（标题、简介、字幕、热评等深读）。
2. 转发动态：评分达标的视频转发到个人动态，配文由 agent 生成。
3. 评论：可单独评论，或在转发动态时「同时评论」；共用风控与额度。
4. 评论记录：控制台按天查看已发出的评论；删除时先删 B 站侧评论，再删本地记录。
5. 额度与行为：每日上限、同视频去重、评论额度、心情与饥饿度等影响行为；调度上每日 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 站、转发动态与评论，同时在控制台审计评论记录的场景。

注意：

1. 插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，并理解 Cookie、QQ Token 等敏感配置的处理方式。
2. 真实发帖前务必完成干跑与 allowWrite 双重确认，避免误发。
3. 与原版 dsh-world 并存可能存在不兼容；QQ 依赖 SnowLuma，插件不代替登录 QQ。
4. SkillHub 页简介版本为 0.8.10，与 README / package.json 不一致时，以你实际安装的 tgz 与 package.json 为准。

结尾¶

dsh-dafeiyu-biliWorld 把世界骨架、评论风控与 B 站 CLI 调度收成一条 DSH 工作流，适合要做 B 站侧「刷—读—转—评」闭环的开发者。目录页：SkillHub 插件页；源码与文档：GitHub 仓库。