前言¶

在 DeepSeek Harness（DSH）裏做「個人運營號」，常見做法是 agent 寫文案、人再剪片、人再上傳。腳本可以拼 plan → render → publish，但調度、失敗重試、真發開關和合規紅線往往要另寫一層。dsh-bili-faship（目錄名常寫作鯨魚娘視頻工坊）把這段能力收成 DSH 工作流插件：設置頁「視頻工坊」、生物鐘按節奏建工單、以及一組 faship_* 工具，讓 agent 從日記選題到 storyboard、配音與逐幀渲染、代碼自審，再到生成投稿包；真投稿默認關閉，並寫明不自動重試 B 站風控。下面按定位、能力、安裝與典型用法說明。

這是什麼¶

• 名稱：dsh-bili-faship（npm 包名同此）
• 維護者：Faust-sudo
• 分類：工作流（社區目錄 SkillHub 插件頁）
• 源碼：GitHub — Faust-sudo/dsh-bili-faship
• 當前版本（package.json）：0.2.1，許可 MIT
• 宿主要求：DSH >=0.2.0，Node >=20.12

插件面向「鯨魚娘 / 大肥魚」這類人設：生物鐘每隔幾天觸發一輪，agent 從日記和偏好裏選題，寫成 storyboard v4，用 Edge TTS 配音、Python（Pillow + numpy）逐幀出圖，混 BGM/音效，產出 video.mp4、cover.jpg、subtitles.srt；再用代碼跑 7 項硬閘門自審，通過後才生成 dry 投稿包。與同爲 Faust-sudo 體系的 dsh-bili-whale 代碼零依賴：whale 偏「看和說」，本插件偏「做和發」，日記路徑可共用約定。

v0.2 起每次「做一條」都是帶 id、目錄、會話與階段的工單；准入原因、看門狗與自動重試、需人工處理的項會集中在設置頁頂部「待你處理」。

核心功能¶

創作管線（plan → render → review → publish）¶

CLI 入口爲倉庫內 node tools/bili-faship.mjs <子命令>；另有 deps 做依賴體檢、status 看發佈節奏與待發片單。

Agent 工具（faship_*）¶

註冊給 DSH agent 的工具包括狀態與工單（faship_status、faship_tickets、faship_report、faship_ticket_action）、依賴與列表（faship_deps、faship_videos）、創作步驟（faship_plan、faship_render、faship_review、faship_publish）、後臺任務（faship_job）、手動叫醒（faship_wake）與只讀配置（faship_config）。工具註冊失敗只記日誌，不阻斷插件激活。

設置頁與調度¶

裝好後進入 設置 → 視頻工坊。頁面覆蓋節奏（總開關、生物鐘、cadenceDays、叫醒窗口）、發佈與紅線（分區 tid 默認 138、自審分數線、紅線詞表；「允許真發」爲 danger 開關且需二次確認）、聲音（Edge TTS 默認 zh-CN-XiaoyiNeural）、路徑與人物素材、憑據與視頻列表等。配置合併寫入 <DSH_HOME>/bili-faship.config.json（默認 DSH_HOME 爲 ~/.dsh），形狀 { "version": 1, "video": { ... } }。

調度器約每 60 秒 tick：看門狗、失敗工單自動重試、再按確定性准入規則決定是否建新工單並投遞叫醒詞（不調 LLM 做准入判斷）。

明確不做的事（README 能力邊界）¶

• 不做賬號安全設置，不關注/三連/投幣/花錢，不羣發私信
• 不刷量、不搬運、不冒充真人
• 遇 B 站風控（如 412 / 429 / 601）停止，不自動重試、不繞過驗證碼
• 未顯式打開「允許真發」時不投稿

投稿需 AI 標註等紅線由代碼側強制；材質（表情包、角色形象）不隨插件分發，使用權需自行確認。

安裝與啓用¶

安裝前建議對照 README「裝之前」表：除 DSH 與 Node 外，硬依賴包括 ffmpeg、Python 3 + Pillow + numpy、可寫的 <DSH_HOME>/bili-faship 數據目錄；BGM/SFX 已隨包（CC0 合成）。表情包、中文字體、日記、投稿 cookie 缺失多爲 warn，不擋 dry 鏈路。

推薦：DSH 插件管理器

1. 設置 → 插件 → 添加插件 → 從本地目錄安裝，選擇插件源碼目錄；或 從 Git 安裝，填寫
   git+https://github.com/<你的賬號>/dsh-bili-faship.git
2. 桌面版開 HMR 時一般立即生效；未開 HMR 則重啓一次 DSH。
3. 打開 設置 → 視頻工坊（若無入口可刷新或重啓）。

亦可對 agent 說明把插件目錄交給 plugin_manager 的 install_bundle。

手動 / CLI（等價）

# 1) 把 bundle link 進 profile（路徑含空格請加引號）
dsh plugin --profile desktop add "link:<你本地的插件目錄>"

# 2) 編輯 profile 的 package.json（如 ~/.dsh/profiles/desktop/package.json），
#    將 "dsh-bili-faship" 加入 dsh.profile.bundles（建議放末尾）
# 3) 重啓 DSH

dsh 來自 DSH 安裝目錄自帶 CLI（Windows 示例：<DSH 安裝目錄>\resources\runtime\cli\bin\dsh.cmd）。

注意：cordis.patch.yml 的 name: 須與安裝包名 dsh-bili-faship 一致，否則可能出現設置頁 404 或 entry 未激活。配置示例見倉庫 bili-faship.config.example.json。

典型用法¶

設置頁四步（首次）¶

1. 依賴體檢：設置頁點「依賴體檢」，或執行
   node tools/bili-faship.mjs deps --json
2. 粘貼 cookie（僅真發）：瀏覽器登錄 B 站後從存儲中抄 SESSDATA、bili_jct、buvid3，寫入設置頁「憑據」並保存（只寫不讀回）。
3. 確認素材路徑：渲染與路徑、人物與素材分區中確認表情包、Python、ffmpeg、日記列表等。
4. 先做 dry：設置頁「現在做一條」（二次確認），或走 CLI 分步驗證。

CLI 分步示例（README）¶

node tools/bili-faship.mjs plan --dir D:\videos\demo --topic "第一天，站在中間"
# 按需修改 storyboard.json 的 scenes 後：
node tools/bili-faship.mjs render --dir D:\videos\demo
node tools/bili-faship.mjs review --dir D:\videos\demo
node tools/bili-faship.mjs publish --dir D:\videos\demo --dry

publish --dry 僅在本地生成投稿包，不聯網。真發需設置頁打開「允許真發」且調用方顯式 confirm，並滿足自審與頻率閘。小尺寸（如 320×180）適合快速驗鏈路，正式成片宜 1920×1080。

ffmpeg 解析順序（資料記載）：FFMPEG 環境變量 → PATH → 插件 bin/ → ~/.dsh/bili-whale/bin → 剪映自帶路徑。Python 可用 WHALE_PYTHON 或設置頁指定。

適用場景與注意¶

適合誰：已在 DSH 跑 agent、有人設日記或選題素材，希望把 B 站短視頻做成可審計工單（而非一次性腳本）的開發者；可與 dsh-bili-whale 並行，共享 cookie/表情包目錄約定，但無代碼耦合。

安裝與運行注意：

• 插件以當前 DSH 進程權限讀寫本機目錄與調用 ffmpeg、Python；安裝前請自行審閱 倉庫源碼 與 MIT 許可證。
• 社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，屬社區插件生態。
• 星標、版本以倉庫與目錄頁爲準；勿在未覈對憑證的情況下開啓真發。
• 原獨立項目 bili-faship 在資料中標註爲只讀參考，新能力以本 DSH 插件爲準。

結尾¶

dsh-bili-faship 把「構思 → storyboard → 渲染 → 代碼自審 → 投稿包」固化爲 DSH 工作流：設置頁可運維，生物鐘與工單可追蹤，真發與風控策略在文檔與代碼裏寫死邊界。要從 dry 跑通再考慮投稿，可從依賴體檢與一條 --dry 開始。

• 社區目錄：https://www.skillhub.cn/plugins/Faust-sudo/dsh-bili-faship
• 源碼與 README：https://github.com/Faust-sudo/dsh-bili-faship