前言¶
在 DeepSeek Harness（DSH）裏做 agent，常見做法是直接調雲端生圖、生視頻 API：Key 和計費綁在對話側，產物路徑也要自己管。若你本機已經在跑 GenBox（FastAPI 媒體工作臺），provider、尺寸、風格都在瀏覽器裏配好，更自然的訴求是讓 agent 走同一套服務，並把圖片、視頻落到工作目錄後把路徑交回模型。
下面介紹社區插件 dsh-genbox-plugin（維護者 liwei9745），它在 SkillHub 分類爲「工作流」，通過 HTTP 調用本機 GenBox，不修改 GenBox 本體；GenBox 爲 GPL-3.0，插件爲 MIT，僅作調用方。
這是什麼¶
dsh-genbox-plugin 是 DSH 的 Cordis bundle 插件：DSH agent → 插件（TypeScript）→ GenBox FastAPI（默認 127.0.0.1:8892）→ 各 provider。插件負責註冊工具、輪詢任務、下載媒體到本地；API Key 與模型選擇仍在 GenBox 工作臺界面管理。
形態可以概括爲：
DSH agent → dsh-genbox-plugin (TypeScript) ──HTTP──▶ GenBox FastAPI (127.0.0.1:8892) ──▶ providers
核心功能¶
README 中爲 agent 註冊了 15 個工具，覆蓋自檢、生圖、改圖、視頻與本地剪輯、圖庫等能力。
| 類別 | 工具 | 作用（摘要） |
|---|---|---|
| 服務與診斷 | genbox_server |
啓動 / 停止 / 重啓 / 查看本機 GenBox |
genbox_doctor |
可達性、認證、provider/Key、輸出目錄、ffmpeg 等自檢 | |
genbox_open_workbench |
打開 GenBox 工作臺（首裝常用） | |
genbox_health |
探測 GenBox 是否在線 | |
genbox_providers |
列出 provider、模型與能力 | |
| 圖像 | genbox_image_generate |
文生圖 |
genbox_image_edit |
i2i、inpaint、精準改圖（批註）等 | |
genbox_image_upscale |
本地超分（無需 API Key） | |
genbox_image_variations |
變體 | |
genbox_cutout |
摳圖（需 GenBox 側 checkpoint） | |
| 視頻 | genbox_video_generate |
文生視頻 / 圖生視頻 / 關鍵幀等 |
genbox_task |
查詢或取消後臺任務（支持 background: true） |
|
genbox_video_edit |
本地 ffmpeg 剪輯（trim、concat、字幕等，無需 GenBox Key） | |
| 其它 | genbox_gallery |
媒體庫檢索並複製到本地 |
genbox_prompt_optimize |
提示詞優化 |
生成結果默認寫入配置項 outputDir（默認 .genbox），返回絕對路徑；模型可用 DSH 內置的 read_image 查看圖片。
從 DSH 0.2.0 起，插件還提供原生側邊欄面板：在 DSH NEXT 中 Ctrl+Shift+G 或右側邊欄 GenBox 卡片可嵌入 GenBox Web UI（桌面端通過 webview 租約加載，因 GenBox 禁止 iframe）。
倉庫提供免模型憑據的證據看板（node scripts/lab.mjs，默認 http://127.0.0.1:3098/），可查看連接狀態、工具清單與復現命令；驗證套件默認使用零成本 mock provider，真實 provider 需顯式設置 GENBOX_REAL_PROVIDER。
安裝與啓用¶
前提：GenBox 已在本機運行。GenBox 本體默認端口 8891，插件 dev 文檔常用 8892；插件通過 baseUrl 與 baseUrlFallbacks 依次探測並記住可用地址。
從 npm 安裝（README 已發佈流程）：
dsh plugin --profile <profile> add dsh-genbox-plugin
dsh --profile <profile> --dump-config | Select-String genbox # 確認插件層已生效
從 tarball（示例版本 0.1.0）：
corepack pnpm pack # 產出 dsh-genbox-plugin-0.1.0.tgz
dsh plugin --profile <profile> add ./dsh-genbox-plugin-0.1.0.tgz
因 package.json 聲明瞭 dsh.bundle，安裝後會寫入 profile 的 bundles；啓動時應看到類似：
[genbox] plugin loaded (baseUrl=http://127.0.0.1:8892)
裝進 desktop profile 後需重啓 DSH NEXT。建議先用獨立 profile 驗證，例如：
dsh --profile genbox-dev --from-default-profile web
本地源碼聯調可使用 overlay patch（路徑按你本機倉庫位置替換）：
dsh --profile <profile> --patch E:/AI/GenBox-dsh/dev/overlay.cordis.yml
package.json 要求 Node >=20、DSH >=0.1.5-rc.1；當前包版本爲 0.2.1（npm 包名 dsh-genbox-plugin）。
常用配置字段：
| 字段 | 默認 | 說明 |
|---|---|---|
baseUrl |
http://127.0.0.1:8892 |
GenBox 服務地址 |
adminKey |
空 | prod 模式 X-Admin-Key（dev 不需要） |
defaultProviderId |
空 | 未指定 provider 時的默認值 |
outputDir |
.genbox |
媒體落盤目錄 |
pollIntervalMs |
2000 | 輪詢間隔 |
taskTimeoutMs |
900000 | 單任務超時 |
ffmpegPath / ffprobePath |
ffmpeg / ffprobe |
本地視頻編輯與探測 |
典型用法¶
README 給出的「30 秒上手」可按下面三步走（也可直接讓 agent 執行對應工具）：
- 打開工作臺：對 agent 說「打開 GenBox 工作臺」（
genbox_open_workbench），或瀏覽器訪問http://127.0.0.1:8892/配置 provider 與 Key。 - 自檢：「跑一下 GenBox 自檢」（
genbox_doctor），按返回清單補全環境。 - 開始用：例如「用 GenBox 畫一隻在雪地裏的柴犬」。
GenBox 未啓動時，插件會明確提示無應答，並指向文檔中的本地啓動說明。
三個端口不要混淆：
| 端口 | 用途 |
|---|---|
| 3098 | 插件證據看板（只讀，無需憑據） |
| 3099 | DSH 會話頁（需模型憑據） |
| 8892 | GenBox 工作臺（畫圖、圖庫、配 provider） |
工具參數速查見倉庫 docs/tools.md（由代碼自動生成）；安裝與排錯見 docs/install.md。
適用場景與注意¶
適合誰： 已在或計劃在本機跑 GenBox，希望 DSH agent 統一調用生圖、改圖、生視頻、本地 ffmpeg 剪輯與圖庫，而不是在 agent 裏重複封裝各雲 API 的同學。
權限與安全： 插件隨當前 DSH 進程權限運行，可啓停本機 GenBox 進程、讀寫 outputDir、調用 ffmpeg。安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證；第三方 provider 的 Key 仍在 GenBox 界面配置，插件經 HTTP 轉發請求。
生態說明： DSH 社區插件目錄託管在 SkillHub 等獨立站點，與 DeepSeek / 幻方無官方從屬關係；選插件時以倉庫文檔與自測爲準。
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/liwei9745/dsh-genbox-plugin
- 源碼與 README：https://github.com/liwei9745/dsh-genbox-plugin
若你本地已有 GenBox，按上文安裝 bundle 並完成自檢後，即可在對話裏把媒體生成納入 agent 工作流，產物路徑可直接交給後續步驟使用。
