前言¶

在 DeepSeek Harness（DSH）裏做 B 站相關能力時，常見做法是堆「自動發帖」腳本：搜視頻、生成文案、直接發出去。一旦 agent 誤發、越權用他人素材，或沒有可複查的學習記錄，運維成本會落在人身上。社區插件 dsh-bili-whale-studio（大肥魚工作室，維護者 DorododoG11）把「學、聲、發」拆成三條可單獨驗證的鏈路，發佈默認進草稿箱、需人批准後才調用發佈工具。下面介紹它的定位、能力與安裝用法；事實以 GitHub 倉庫 README 爲準。目錄頁：SkillHub · bili-whale-studio（社區站點，與 DeepSeek / 幻方無官方從屬關係）。

這是什麼¶

dsh-bili-whale-studio 是 DSH 工作流類插件（package 名 dsh-bili-whale-studio，當前資料中版本 0.2.0，MIT 許可證）。一句話：讓 agent 在 B 站自學、整理自己的聲音、把內容做成動態和視頻——發出去之前必須過草稿箱。它不是「又一個自動發帖機」；B 站操作走 bili-cli（bili 命令），音視頻走 ffmpeg，語音默認走系統 SAPI，插件負責編排、留痕和兜底。

本地數據默認落在 ~/.dsh/bili-studio/（學習筆記在 knowledge/，音色在 voices/，草稿在 drafts/）。

核心功能¶

學：教程檢索與筆記落盤¶

studio_learn 支持 search 找教程、fetch 看全一條視頻。fetch 會把整條視頻的原始數據存成 json，筆記可經 studio_note 的 save / list / read 寫成帶 frontmatter 的 md。寫動態時用 studio_note action=list 檢索已學內容，避免重複看片。

聲：邊界明確的音色與風格¶

studio_voice 提供 pull / list / remove / ref / voices / tune 等 action。pull 只接受：配置裏自己號的 self.mid（見 ~/.dsh/bili-whale.config.json）、config.allowedOwnerMids 中列出的 mid，或調用時顯式 authorized=true（來源記入 meta.json）；他人視頻一律拒絕。若要「像」某種說話方式，可用 studio_style action=analyze 從字幕統計語速、句長、標點與口頭禪，存風格卡，再用自己的聲音配合 tune 參數演繹。

studio_say 把文字轉成 wav；studio_video 用圖片與配音合成 1080p mp4（合成參數見配置中的 compose）。

發：草稿 → 批准 → 發佈¶

草稿狀態單向流轉：draft → approved → publishing → published。requireApproval 默認開啓時，未 approved 的草稿調用 studio_publish 會報錯。另有每日配額（按 publish-log.jsonl 記賬）、投稿強制 AI 聲明、失敗也記賬等約束。studio_queue 管理草稿（new / list / show / preview / approve / reject）；studio_publish 只認已批准草稿；studio_history 查發佈記賬。

裝好後可在 DSH 設置 → 工作室 面板查看隊列與配額，對待批准草稿點批准或打回；界面經 /dsh-studio/api/* 與 studio_* 工具讀寫同一份磁盤狀態，信任柵欄不可用時按拒絕處理（fail-closed）。

自檢¶

studio_status 檢查 B 站是否登錄、ffmpeg 是否可用、當日剩餘發佈條數、本地庫存概況。

安裝與啓用¶

前提（README 原文）：

• DSH ≥ 0.4
• bili CLI 已登錄（bili auth status 返回 logged_in: true）
• 系統已安裝 ffmpeg

安裝步驟來自倉庫 README，不是 dsh plugin add github:... 一類拼接命令：

# 1. 放到任意工作目錄
git clone <this-repo> bili-studio && cd bili-studio

# 2. 裝進當前 profile（DSH 會自己 apply patch）
#    在 DSH 裏對 agent 說：
#    「把 C:\path\to\bili-studio 作爲 bundle 安裝到當前 profile」
#    或直接調用 plugin_manager install_bundle(target: <絕對路徑>)

裝完後調用 studio_status 應能回答登錄、依賴、配額與本地庫存。

首次運行生成 ~/.dsh/bili-studio/config.json，修改後無需重啓（每次調用重讀）。示例字段（節選）：

{
  "biliPath": "C:\\Users\\you\\.local\\bin\\bili.exe",
  "ffmpegPath": "C:\\Users\\you\\.dsh\\bili-whale\\bin\\ffmpeg.exe",
  "maxPublishPerDay": 3,
  "requireApproval": true,
  "allowedOwnerMids": [],
  "voice": {
    "engine": "sapi",
    "sapiVoice": "Microsoft Huihui Desktop",
    "rate": 0,
    "pitch": 1.0,
    "cloneCommand": ""
  },
  "compose": { "width": 1920, "height": 1080, "fps": 30 }
}

voice.engine = "command" 時可接外部「文本文件進、wav 出」的命令行 TTS；模型與引擎由自行部署，插件不代下載。

典型用法¶

README 給出的一條完整鏈路如下（BV 號需替換爲真實視頻）：

studio_learn  search  "DeepSeek Harness 插件"
studio_learn  fetch   BV1xxxx
studio_note   save    title="DSH 插件的最小骨架"  body="……"
studio_say    text="今天學了插件骨架……"  pitch=1.06
studio_video  audio=out/say-xxx.wav  images=["cover.png"]
studio_queue  new     kind=video title="……" tags=["DSH"] video=out/video-xxx.mp4
studio_queue  preview id=dr_xxx
studio_queue  approve id=dr_xxx
studio_publish id=dr_xxx

工具一覽（與 README 表一致）：studio_status、studio_learn、studio_note、studio_voice、studio_style、studio_say、studio_video、studio_queue、studio_publish、studio_history。

適用場景與注意¶

適合誰： 希望在 DSH 裏用 agent 系統學 B 站教程、把筆記與成片留在本地、且發佈前必須人工過稿的開發者或創作者。

權限與安全： 插件以當前 DSH 進程權限運行；安裝前應閱讀源碼與 MIT 許可證，確認 bili 憑據路徑（插件只讀 ~/.bili-ai/credentials.json，不復制、不回顯）。數據默認不上傳，均在 ~/.dsh/bili-studio/。

明確不做的事（v0.1）： 直播推流（依賴 bili 能力與後續版本規劃）；聲紋克隆；自動點贊/投幣/評論等仍受 bili-cli 自身規則約束。

生態： DSH 理念是「一切皆插件」；本插件通過 bundle + patch 接入，與社區目錄條目一致歸類爲工作流。

結尾¶

dsh-bili-whale-studio 把 B 站自學、本地筆記、可控音色與「草稿經人點頭才發」綁在同一套 studio_* 工具與工作室面板上，適合不想把賬號完全交給自動發帖鏈路的 DSH 用戶。進一步瞭解請查看 SkillHub 目錄頁 與 GitHub：DorododoG11/bili-whale-studio。