前言¶
DeepSeek Harness（DSH）採用插件化架構擴展能力。本插件（內部名：Agnes 創意工作站）旨在集成 Agnes AI 免費生圖與生視頻大模型，爲 DSH 提供可視化的創作工具與流水線。
核心功能¶
插件主要分爲模型推理與內容創作兩大類：
* 圖像與視頻生成：支持文生圖（Image 2.5 Flash，1K-4K 尺寸）、圖生圖（風格遷移、場景變換、多圖合成）、文生視頻（Video 2.5 Flash，4-12 秒）、圖生視頻（首幀控制、多模態參考）。
* 內容生產流水線：包含短劇流水線（劇本導入、分鏡生成、自動合成、燒錄字幕）、數字人口播（TTS 配音、逐段生成畫面）、MTV 製作、背景視頻自動分幕與定妝。
* 創作工具箱：提供小說工具（長篇拆分、去 AI 味）、小說封面生成、提示詞專家（中文擴寫）、視頻解析（切場景、生成 VPT）、多能寶箱（視頻下載、TTS）。
* 工作流編排：無限畫布（節點化編排、連線傳參）、創作臺（Oh Story 流程集成）、公衆號草稿管理。
安裝與配置¶
在 DSH 容器內執行安裝命令：
npm install /root/軟件/dsh-agnes-studio
編輯 package.json，在 dsh.profile.bundles 和 dependencies 中添加插件引用。若之前已安裝 @oh-story/dsh，需從上述兩處移除，避免技能重複註冊。安裝完成後重啓 DSH 容器。
環境依賴¶
部分功能依賴於宿主機環境：
* ffmpeg + ffprobe：用於視頻拼接、字幕燒錄與音畫合成。若缺失，面板頂部會提示安裝方法。
* 中文字體：用於字幕渲染。若未安裝，會明確報錯而非靜默輸出豆腐塊。
* MIMO_API_KEY：用於數字人口播 TTS 配音。需在憑據或環境變量中配置。
使用方法¶
- 生圖/生視頻：側邊欄進入插件，輸入提示詞（或使用「試試」示例），選擇模型與尺寸，點擊生成。
- 短劇流水線：導入劇本 → 生成分鏡 → 點擊「一鍵生成全部鏡頭」→ 合成成片（可選燒字幕）→ 下載。
- 數字人口播：切換到「🎙 口播」頁籤，輸入文稿，選擇形象圖，開始生成，預覽或下載。
- 無限畫布：切換到「🕸 畫布」，通過拖拽、滾輪縮放進行平移與操作，利用節點連線傳遞參考圖，在節點上直接發起生成。
- 小說封面：切換到「📕 封面」，上傳 TXT/DOCX 或手動填寫書名，選擇風格，一鍵生成。
技術細節與注意事項¶
- 宿主與客戶端分離：合併非代碼混改，而是將
agnes宿主半與oh-story宿主半在lib/host-entry.js處組合；客戶端註冊通過私有 ID 避免衝突。宿主半改動需重啓 DSH，客戶端半改動需刷新頁面。 - 狀態管理：畫布狀態保存在瀏覽器
localStorage，不依賴後端。 - API Key 安全：所有 API Key 由宿主端代理處理，瀏覽器端不暴露 Key 明文。
- 面板尺寸：支持緊湊、標準、全屏三檔尺寸切換，設置保存在本地。
總結¶
該插件將 Agnes AI 的免費大模型能力與 DSH 的插件生態深度結合，提供了從生成到合成的全鏈路工具，適合需要進行影視製作、短劇開發及內容輔助創作的用戶。源碼與文檔詳見 GitHub。
