前言¶
DeepSeek Harness（DSH）通過插件體系擴展功能。在聊天界面生成圖片或視頻，通常需要切出上下文或編寫複雜指令。dsh-media-studio 插件將媒體生成能力直接接入對話流，通過後臺任務和內聯畫廊，讓模型在會話中直接輸出結果。
安裝與啓用¶
運行環境要求：
* DeepSeek Harness 0.2.0-rc.2
* Node.js >= 22.19.0
- 打開 DSH 的 插件 頁面。
- 點擊右上角 「+ 添加插件」。
- 輸入 GitHub 地址：
https://github.com/1497105876/dsh-media-studio
安裝並啓用後，插件詳情頁會出現設置卡片。
核心功能¶
- 文生圖 / 圖生圖：支持本地路徑、HTTPS URL、Data URI 作爲參考圖。
- 文生視頻：支持文本生成與首尾幀（keyframe）、參考圖模式。
- 發送本地媒體：將已有圖片或視頻文件通過畫廊或文件卡片形式發送到會話。
- 斜槓命令：提供
/image和/video命令。 - 後臺生成：默認使用
ctx.jobs後臺任務，立即返回句柄，完成後自動推送。 - 富渲染：工具行和命令行支持內聯畫廊與視頻播放器，支持下載、燈箱查看及系統默認應用打開。
- 自動保存：生成結果默認寫入
~/.dsh/media-studio。 - 憑據安全：API Key 通過環境變量或憑據卡片管理，不寫入配置文件。
- 設置卡片：插件詳情頁內的官方樣式配置卡片，支持模型選擇與參數設置。
配置與憑據¶
模型配置¶
默認內置 Agnes（有免費額度，支持文生圖、圖生圖、文生視頻）。其他服務商（如 OpenAI、Gemini、硅基流動、阿里百鍊）通過設置卡片選擇，支持自定義 baseURL + model。
憑據管理¶
每個模型條目通過 apiKeyEnv 引用一個環境變量名，插件運行時解析。例如使用 Agnes：
export AGNES_API_KEY=sk-...
或直接在插件詳情頁的設置卡片中填入 Key，Key 保存至 dsh 憑據庫。
輸出目錄¶
生成結果默認保存至 ~/.dsh/media-studio（~ 展開爲用戶主目錄）。
典型用法¶
斜槓命令¶
/image <提示詞>：後臺生成，完成後推送結果。/image --wait <提示詞>：同步等待，在命令卡片內聯展示。/video <提示詞>：後臺生成視頻（通常幾分鐘）。/video --wait <提示詞>：同步等待，卡片內聯播放。
工具調用¶
插件向模型暴露三個工具：
* generate_image：必填 prompt，可選 model、resolution（1K–4K）、aspect_ratio、reference_images。
* generate_video：必填 prompt，可選 model、seconds（4–12）、size（720P–2K）、mode（text / keyframe / reference）。
* send_media：參數 paths（本地文件路徑數組）+ 可選 caption。
注意事項¶
插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。需確保 Node.js 版本滿足要求（>= 22.19.0）。
