前言¶
在 DSH 裏做圖像、視頻或語音生成，常見做法是各自接一套 API：參數格式不統一、單價要手工查、長任務還要自己輪詢和落盤。BizyAir 本身聚合了大量開源與閉源 AIGC 模型，但完整站點的能力與 Harness 會話、工作區並不是同一套界面。
dsh-bizyair（維護者 doombeaker，分類：模型推理）把 BizyAir 的模型目錄、參數 schema、估價、審批門閂和任務面板裝進 DSH：對話裏可調工具生成，Web 端有獨立的 BizyAir 視圖。下文按安裝、配置、工具與面板說明可覈對的操作步驟；事實以 GitHub 倉庫 README 爲準。社區目錄頁：skillhub.cn/plugins/doombeaker/dsh-bizyair。
這是什麼¶
一句話：dsh-bizyair 是 DeepSeek Harness 上的 BizyAir 模型廣場插件，在 Harness 內完成圖像、視頻、音頻與 3D 等多模態生成，並附帶費用估算與用戶確認。
- 包名 / bundle target：
dsh-bizyair（npm 直裝，當前資料中版本 0.12.2） - 許可證：MIT（
icon.svg/assets/icon-180.png中的 BizyAir logo 歸 BizyAir） - 引擎要求：
dsh>= 0.2.0 - 計費說明（BizyAir 側）：新賬戶約含 $1 額度，資料中對應約 200 張圖（約 $0.005/張）、3 段 5 秒 720P 視頻，或 100 分鐘語音；最終以 BizyAir 賬單爲準
插件以當前 DSH 進程權限運行，安裝前宜自行查看源碼與許可證；DSH 社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
對話工具¶
註冊在聊天中的工具（名稱與職責來自 README）：
| 工具 | 作用 |
|---|---|
bizyair_models |
按關鍵詞、輸出類型、版本（自託管 / economy / official）或最高價搜索模型 |
bizyair_model |
完整參數說明、示例 payload、價目表與文檔鏈接 |
bizyair_generate |
校驗 → 估價 → 超閾值審批 → 提交；短任務直接返回，長任務返回 request_id + job_id |
bizyair_task |
按 request_id 查詢並下載產物（冪等） |
bizyair_upload |
本地文件經 token → OSS STS → commit 上傳，得到公網 URL |
bizyair_price |
按公開價目表估算單次調用費用 |
後臺任務還可用內置命令 job_output <job_id> 讀取輸出。
Web 面板¶
重載頁面後，會話視圖切換器會出現 BizyAir 視圖（conversation.view，id bizyair）。面板是 BizyAir 站內能力的子集：價目、更多模型與賬戶操作鏈回 bizyair.ai。支持中英文切換；含模型列表與 schema 驅動的參數表單、畫廊（公開作品與 Remix）、運行記錄（按日分組、可搜索與複用）、結果預覽與 API Key 配置頁等。面板側 Host 路由包括 /bizyair/api/catalog、/bizyair/post/generate、/bizyair/post/quote 等（完整列表見 README）。
費用與審批¶
估價達到 approvalThresholdUsd（默認 20 USD）時，經 ctx.approval 請求用戶確認；用戶同意後可用 confirm_cost: true 跳過一次確認。面板在瀏覽器側對超過 20 USD 的預估同樣會確認。調用前可用 bizyair_price 自查。
產物與審計¶
生成產物默認落在 <workspace>/bizyair/<YYYYMMDD>/<request_id>/；調用審計寫入工作區下的 bizyair/calls.jsonl。API Key 默認路徑爲 $DSH_HOME/bizyair.key（權限建議 600），任務/產物使用你註冊的第一個 workspace。
安裝與啓用¶
無需插件市場即可從 npm 安裝 bundle。交給 DSH Agent 的等價說明見 README；命令如下。
plugin_manager install_bundle target=dsh-bizyair
安裝後配置 BizyAir API Key，任選其一：
- 打開 Settings → Model plaza · BizyAir → API Key，粘貼
sk-...，點擊 Save and verify - 或直接寫文件：
printf '%s\n' 'sk-...' > ~/.dsh/bizyair.key（mode 600） - 重載頁面；會話區會出現 BizyAir 標籤頁
環境變量 BIZYAIR_API_KEY 可作爲 Key 文件的回退來源。
經插件市場（可選）¶
plugin_manager set_bundle target=@deepseek-ai/dsh-experimental-plugin-market-bundle enabled=true
在 Plugins → Discover 添加索引：
https://doombeaker.github.io/dsh-bizyair/index.json
典型用法¶
1. 對話中生成¶
流程與 bizyair_generate 設計一致：先用 bizyair_models / bizyair_model 選定模型與參數，需要時用 bizyair_upload 準備 *_urls 類字段，用 bizyair_price 看單價，再調用 bizyair_generate。長任務記下 request_id，用 bizyair_task 拉取產物到工作區；或 job_output <job_id> 看後臺 Job。
2. 面板內操作¶
在 BizyAir 視圖選模型、填 schema 生成的表單（必填未齊時 Generate 會禁用並列出缺項），提交後可在 Runs 中查看狀態，在 lightbox 中預覽圖像/視頻/音頻，或將結果保存到 workspace。
3. 刷新本地模型目錄（維護者 / 自建）¶
發佈包內帶 data/catalog.json（約 740 KB）。若從源碼目錄更新目錄快照：
cd dsh-bizyair && node scripts/build-catalog.mjs --refresh
緩存目錄 .cache/ 可安全刪除。
適用場景與注意¶
適合誰：已在 DSH 中做智能體或媒體流水線、希望統一入口調用 BizyAir 上衆多圖像/視頻/音頻（及 3D）模型，並需要參數校驗、估價與審批的團隊或個人。
已知限制（README 原文）：
- 面板直接播放 CDN 鏈接，不落盤；要進工作區請用
bizyair_task下載 - BizyAir 無取消 API，後臺任務只能停止輪詢
- 默認不暴露文本/視覺模型（
allowedOutputs: [images, videos, audios]）；要全量暴露可將該配置設爲空列表 - 多維價目下估價爲近似值，以 BizyAir 調用歷史爲準
安裝與啓用插件即向 BizyAir 雲端發起請求，Key 與網絡出站策略應事先納入安全評審。
結尾¶
dsh-bizyair 把「模型廣場 + 參數 schema + 費用門閂 + 任務面板」收進 DSH 一條鏈路，減少在多套 API 之間切換的成本。目錄與源碼：
