前言¶

在 DSH 裏給角色接 B 站，常見做法是：人觸發一次搜索或拉稿件，模型當場總結。角色沒有「昨晚看了什麼」的連續感，也很難在沒人說話時自己開一篇視頻、讀字幕、記一筆，再決定是否要跟主人說一句。

dsh-whale-bili（npm 包名 dsh-bili-fishman，README 副標題「魚與人」）由 SenuMirai 維護，歸類爲聯網工具。它把「打開 B 站 → 成候選 → 讀文字稿 → 記決定」做成可長期運行的本地優先流程，並帶有生物鐘喚醒；沒有新發現、今天不想寫，在代碼約定裏是合法結果，而不是任務失敗。倉庫當前 GitHub 星標爲 0。

下面按定位、能力、安裝配置和典型用法說明，事實均來自倉庫 README 與 package.json。

這是什麼¶

一句話：給 DSH 智能體一套「自己在家裏刷 B 站的手」——能登錄態下瀏覽、撈候選、誠實讀稿、寫手賬與記憶相關工具，七類賬號寫入能力已實現但默認關閉。

它是 DSH Whale 系的一員（dsh-whale- 前綴）。與同系的 dsh-whale-world、dsh-whale-qq 等可獨立安裝；README 說明多個插件靠 npm 包 id 互相認親，包名仍沿用 dsh-bili-fishman 等舊 id。package.json 還寫明：日記、寫信、部分記憶能力已落在世界插件，本倉側重「刷」與記錄鏈路，觀看記錄可由世界的 biliBridge 讀成記憶。

維護者與來源：

• 目錄頁：https://www.skillhub.cn/plugins/SenuMirai/dsh-whale-bili
• 源碼：https://github.com/SenuMirai/dsh-whale-bili
• 許可證：MIT（package.json）
• 運行要求：Node >=24.0.0，DSH >=0.2.1-rc.2 <0.3.0

設計上的三條規矩¶

README 把「有骨架但不逼產出」寫進實現，三條值得先記住：

1. 沒有新發現是合法結果：工具不因「今天沒產出」報錯；狀態裏帶有 posture.noDiscoveryIsFine: true 一類約定。
2. 讀取不需要授權：只有對外寫入纔要授權與開關。
3. 賬本壞了就停：不悄悄重建空賬本，避免把角色「日子」清空。

本插件合併了早期「養魚」流程的自愈與記憶骨架，以及「人文」側的誠實取稿與寫入授權寫法；喚醒文案明確沒有九步清單，喚醒後可以不做事。

核心功能¶

看與記：工具面（README 列 26 個，其中 19 個讀/記/傾聽）¶

常用讀路徑包括：

評論區側：bili_fishman_comment_digest 掃評論，bili_fishman_reply_draft 寫回復草稿（不直接發，等主人審）。另有導入本機 ASR/畫面文字、讀人格札記等工具。

安裝並在設置裏配置模型後，可用設置頁的 測試 按鈕跑一遍當前啓用能力（只讀檢查爲主；若開啓評論寫入與授權，可能發一條 @ 你的測試評論，且不計入當天額度）。

寫入：七項全開實現，默認一律不發¶

評論、彈幕、動態、點贊、投幣、收藏、歷史上報——README 稱七項均已實現，但是能力不是任務：工具常駐註冊，執行時校驗；配置裏對應 enableXxxWrites: true 且本地 write-policy.json 授權有效，才允許考慮寫入。

打開單項寫入的步驟（README）：

1. 複製 docs/write-policy.example.json 爲 write-policy.json，填寫 accountId、expiresAt、targets（白名單）、maxWrites。
2. 配置裏把對應 enableCommentWrites 等改爲 true。
3. 重載插件。

約束包括：一次一條、同賬號 60 秒間隔、maxWrites 額度、目標白名單、結果不明或風控碼時持久暫停等。模型側不能自行解除暫停；覈對與確認在本地 CLI。

生物鐘¶

插件每 60 秒 tick，到點通過 sessionController.prompt 喚醒會話。可配置醒來的時段，例如：

night:
  windows:
    - { start: "20:00", end: "23:00" }

喚醒提示允許「什麼都不做」；沒有「必須走完幾步」的 KPI。

設置頁與 Windows 工作目錄¶

README：裝好並重啓 DSH 後，在 設置 → 魚與人 可改角色名、模型、掃碼登錄、愛好/避雷、作息、全天監聽、七項寫入開關、待審回覆、信與日記展示、活動賬本等；保存後立刻生效。

package.json 描述中設置入口寫爲 設置 → 刷B站，若你升級後界面文案不一致，以當前 DSH 裏實際菜單爲準。

Windows 上需注意 DSH ACL 沙箱：工作區不能與系統臨時目錄互相嵌套。本插件用 pickSessionCwd() 選擇不嵌套目錄（默認 <DSH_HOME>/bili-fishman），並對已有會話用 ctx.workingDirectory.set(agent, path) 糾正 cwd。

安裝與啓用¶

README 給出的插件條目示例（寫入你的 DSH 插件配置，路徑按本機替換）：

- id: bili-fishman
  name: dsh-bili-fishman
  config:
    dataDir: C:/Users/<你>/.dsh/bili-fishman
    credentialPath: C:/Users/<你>/.dsh/bili-fishman/credential.json
    maxSessionTokens: 600000
    enablePersonalityLearning: true
    # 授權文件：不存在 = 任何寫入都開不了
    writePolicyPath: C:/Users/<你>/.dsh/bili-fishman/write-policy.json
    # 七項寫入開關（默認全關；要開還要配合授權文件）
    enableCommentWrites: false
    enableDanmakuWrites: false
    enableDynamicWrites: false
    enableHistoryWrites: false
    enableFavoriteWrites: false
    enableLikeWrites: false
    enableCoinWrites: false
    persona:
      name: ""
      ownerTitle: 主人
    preferences:
      like: []
    night:
      windows:
        - { start: "20:00", end: "23:00" }

憑據文件 credential.json 至少包含無 BOM 的 UTF-8 sessdata；只讀夠用。若要寫入，還需 bili_jct；彈幕、點贊、投幣還需 buvid3：

{ "sessdata": "..." }

也可在設置頁掃碼登錄，憑據寫入插件自有路徑且不回顯。

典型用法¶

1. 只讀刷站：配置 sessdata（或掃碼），保持七項 enableXxxWrites 爲 false，不配 write-policy.json。在喚醒時段或手動會話中讓模型先調 bili_fishman_guide，再 bili_fishman_candidates → bili_fishman_read；無候選時直接結束即可。
2. 記一筆與跟主人說話：用 bili_fishman_journal、bili_fishman_day 等記錄；bili_fishman_letter 非每日必寫。若你已裝 dsh-whale-world，長期信箋/日記以世界插件與 biliBridge 爲準（見 package.json 說明）。
3. 對外發言（可選）：按需完成 write-policy.json 與開關，評論走 bili_fishman_comment 等；回覆陌生人建議關「免審覈」，用待審隊列 + 安全詞（命中則連草稿都不進）。
4. 驗收：設置頁點 測試，在活動賬本與「她的日記 / 她寫給我的信」等分組覈對產出。

適用場景與注意¶

適合：你希望角色在 B 站有連續「過日子」行爲、讀稿誠實標註覆蓋率、寫入與監聽都帶額度與白名單，且能接受本機保管登錄態與授權文件。

注意：

• 插件以當前 DSH 進程權限訪問網絡與本機路徑；安裝前請閱讀源碼與 MIT 許可證，自行評估憑據與 write-policy.json 的風險。
• 社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係；DSH 生態是「一切皆插件」的獨立組裝方式。
• 可與 README 推薦的 dsh-see-now、dsh-loadout、dsh-persona-distill 等搭配，但與 Whale 世界插件的聯動需自行按倉庫文檔配置。

結尾¶

dsh-whale-bili 把 B 站從「人點一次、模型回一段」拉成「她會自己醒來、能看能記、想說再說」的本地流程，並把無產出與讀-only 默認立場寫進策略。若要查閱簡介與安裝入口，見 SkillHub 目錄頁 與 GitHub 倉庫。