前言¶
在 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 倉庫。
