前言¶
在 DeepSeek Harness（DSH）裏做直播互動，常見做法是自行拼接彈幕抓取、大模型回覆、TTS 和 OBS 瀏覽器素材，進程與配置分散，也難以在同一套數據目錄裏保留人設、記憶和消耗賬本。維護者 XiaoZheBrother 發佈的 dsh-live-studio（社區目錄名 xiaozhebrother/dsh-live-studio，分類爲趣味換裝）把上述能力收進一個獨立插件：接收 B 站直播彈幕、合併同一觀衆的問題、生成語音、內置 Live2D 舞臺、輸出瀏覽器直播畫面，並記錄模型消耗與禮物金額。當前爲 0.2.0-alpha.3 開發預覽，默認關閉，源碼在 GitHub 公開（MIT 許可證，約 2 stars）。
下面按定位、能力、安裝配置與使用邊界說明，事實以倉庫 README 與 package.json 爲準。
這是什麼¶
dsh-live-studio 是 DSH 生態下的虛擬主播插件，由 XiaoZheBrother 維護。它不代替你點擊開播，也不分發 Live2D 模型素材；在 DSH 插件進程託管下運行，關閉 DSH 會停止本插件，與宿主權限一致，安裝前應自行審閱源碼與許可證。
插件描述爲：DSH 虛擬主播——彈幕互動、語音、Live2D 橋接和直播畫面。大肥魚直播工作室場景在 README 中有示意截圖（純聊天場景與直播姬開播前預覽），佈局可能與當前版本略有差異。
核心功能¶
彈幕與語音互動¶
接收 B 站直播彈幕，合併同一觀衆的問題；語音當前使用 Edge TTS，模型調用使用 DeepSeek Flash，需要聯網。需配置 DEEPSEEK_API_KEY 環境變量，或沿用 DSH home 中的憑據文件，勿將密鑰提交到版本庫。
真實彈幕依賴 blivedm，須按其上游說明安裝到與插件 Python 相同的虛擬環境中。
內置 Live2D 舞臺¶
配置 model（含 model3.json 及引用素材的目錄）與 cubismCore（本地 live2dcubismcore.min.js 絕對路徑，需自行取得許可）後，由插件加載模型，無需安裝或啓動鯨語。模型與 Cubism Core 均不隨包分發。
- 訪問路徑
/avatar爲透明角色頁，適合瀏覽器素材捕捉；完整直播頁會嵌入並傳遞語音音量驅動口型。 - 工具
live2d_catalog列出模型真實存在的表情與動作；live2d_perform按名稱執行；live2d_status查詢播放回執。模型未打開時請求會排隊，30 秒未消費則過期。 - 表演語義支持
keep、neutral、none、stop等；沒有按臺詞關鍵詞自動切換情緒的規則。 - 渲染與動作邏輯複用了 鯨語 jingyu-live2d-agent 的 MIT 組件，詳見倉庫
NOTICE.md。
直播畫面與賬本¶
開啓後本機迴環地址提供網頁輸出；直播軟件中可用瀏覽器素材抓取流式頁面。賬本使用獨立 SQLite 路徑（ledger 配置項），顯示 API 用量估算與禮物標價，不等於平臺結算到賬。
表演組件與生態拆分¶
backend/live_performance.py 與 backend/live-performance.mjs 提供表情/動作目錄、校驗及 createPerformanceController，供渲染器複用；不會自動給每條彈幕加表情。離線陪看已拆到獨立插件 dsh-reaction-studio，直播用戶不必安裝識別模型和媒體制作依賴。
環境與依賴¶
- Node.js：
>=22.19.0（package.jsonengines） - Python：3.11+
- DSH 對等依賴：
@deepseek-ai/schemastery^3.18.4、@deepseek-ai/dsh-tools>=0.2.1-rc.5
在包目錄創建 Python 虛擬環境並安裝依賴：
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
安裝與啓用¶
官方開發包安裝流程爲在源碼目錄執行 npm pack，再在目標 DSH 數據目錄下安裝生成的 tgz（勿憑插件名拼接 dsh plugin add github:owner/repo）：
$env:DSH_HOME = 'D:\my-agent-data'
dsh plugin --profile web add '<生成的 tgz 絕對路徑>'
說明：
- 安裝不會自動啓用；須在插件配置中填寫字段後將
enabled設爲 true。 - 若需搭配同版本遊戲相關插件，須先把同版本直播插件 tgz 安裝到同一 profile。
- 開發包不得覆蓋正在運行的舊任務，請先停用舊實例。
- 開發預覽發行包見 GitHub Releases。
插件配置¶
在 DSH 插件配置中填寫（默認 enabled 爲 false）：
| 字段 | 含義 |
|---|---|
| enabled | 默認 false，準備好後手動開啓 |
| home | 自己的 DSH 數據目錄 |
| persona | 人設 Markdown 文件的絕對路徑 |
| python | 上述虛擬環境的 python.exe 絕對路徑 |
| port | 默認 3088，綁定本機迴環地址 |
| model | Live2D 目錄，包含 model3.json 及其引用素材 |
| cubismCore | 本地 live2dcubismcore.min.js 的絕對路徑 |
| jingyuUrl / pet | 原外部舞臺配置，僅在未配置 cubismCore 時使用 |
| room | 直播間 ID；0 表示只做本地預覽 |
| credential | 可選獨立直播賬號憑據文件，不能誤用投稿賬號 |
| ledger | 獨立賬本 SQLite 路徑 |
沿用原來的 home、persona、ledger 可保留數據，不復制或清空舊記錄。相同 home 與直播間有進程鎖；不得同時開啓原實驗啓動器。
典型用法¶
- 完成 Python 環境、
blivedm、DeepSeek 憑據與 Live2D 素材路徑準備。 - 填寫配置並開啓
enabled。 - 瀏覽器訪問
http://127.0.0.1:3088/做本地預覽與調試。 - 在直播軟件（如直播姬）中添加瀏覽器素材，地址使用：
http://127.0.0.1:3088/?view=stream&audio=direct
畫布建議 1920×1080。只保留一份播出端，避免重複語音。
平臺的「直播與遊戲」入口會讀取 home/plugin-services 中的無密鑰狀態文件並覈對服務身份，不會替插件啓動後臺任務。
適用場景與注意¶
適合：已在用 DSH、需要把 B 站彈幕、DeepSeek 回覆、TTS 與 Live2D 畫面收攏到同一插件進程，並希望在本地賬本中記錄用量與禮物顯示的用戶。
務必注意：
- 當前版本尚未完成「全新 DSH 啓動」與真實直播驗收；README 聲明單元測試覆蓋配置與聊天邏輯，不能據此認定長時間推流、新機安裝或音畫質量已驗證。
- 插件以當前 DSH 進程權限運行；
credential須使用獨立直播賬號憑據，避免誤用投稿賬號。 - 社區目錄 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；DSH 理念是「一切皆插件」，本文安裝命令與配置項均以倉庫原文爲準。
結尾¶
dsh-live-studio 把虛擬主播鏈路——彈幕、語音、Live2D 舞臺與瀏覽器直播輸出——做成可配置的 DSH 插件，適合願意自行準備模型與憑據、接受 alpha 預覽邊界的開發者。查閱詳情與 Issue 請訪問 GitHub：XiaoZheBrother/dsh-live-studio，社區索引見 SkillHub 目錄頁。
