前言¶
在 DeepSeek Harness（DSH）裏做媒體生成，常見做法是各自對接上游 API、在對話裏零散調用工具，或單獨維護一個 Web 面板。任務狀態、密鑰和產物路徑往往分散，多模型切換還要改配置。下面介紹的 dsh-mote-media（包名 @local/dsh-mote-media）把 mote 統一媒體渠道、OpenAI 兼容圖片渠道、即夢式 Web 創作臺、聊天生圖技能和四個智能體工具收進同一個 DSH bundle，Host 側共用一套媒體實現。
這是什麼¶
維護者爲 MuRanSea。插件在社區目錄 SkillHub 中歸類爲 模型推理；源碼與說明見 GitHub：MuRanSea/dsh-mote-media（MIT 許可證，package.json 版本 1.0.0）。
它解決的是：在 DSH 內用多渠道路由調用 Seedream / Seedance 等 mote 能力，並在側欄提供參考即夢交互的創作臺；同時在正常對話裏通過 mote-image 技能或工具完成文生圖與參考圖編輯。平臺接口契約參考 platform.sgt.site 文檔（統一媒體任務、輪詢、冪等重放、錯誤碼）。
核心功能¶
多渠道路由¶
一個「渠道」對應一個可達上游（地址 + 密鑰），兩類驅動：
| 驅動 | 覆蓋 | 說明 |
|---|---|---|
mote |
圖片、視頻、3D、模型目錄 | 一把 mote 密鑰覆蓋 Seedream、Seedance、Nano Banana / Gemini、GPT Image、可靈、MiniMax H3、混元 / Tripo 等 |
openai-images |
圖片 | 任意 OpenAI 兼容 POST {base}/v1/images/generations，自行填寫模型 id |
模型目錄跨渠道聚合；創作臺與工具按「渠道 + 模型」提交，同名模型可區分。視頻僅走 mote 渠道。
智能體工具與聊天技能¶
| 工具 | 用途 |
|---|---|
mote_models |
列出各渠道可用模型與參數，可選 channel |
mote_image |
文生圖 / 參考圖編輯，返回 submissionId，可傳 channel |
mote_video |
文生視頻、首幀、首尾幀、多模態參考，可傳 channel |
mote_media_task |
按 submission_id 查詢、取消或保存；兼容舊 task_id |
啓用後註冊 mote-image 技能：可在對話中直接描述需求，或從技能菜單點名使用。技能會先查 mote_models，再補提示詞並選擇比例、分辨率與獨立任務數（1–15 張爲多次獨立單圖任務，每次上游 n=1）。生成結果在聊天中以圖片卡展示，並與創作臺作品同步。
Web 創作臺（即夢式）¶
側欄 mote 創作臺 爲暗色整頁面板：大輸入卡（參考圖或首尾幀 + 參數條 + 圓形發送鍵）、模式卡（文生圖 / 參考圖生圖 / 文生視頻 / 首尾幀生視頻）、原比例作品瀑布與大圖詳情。支持 ⌘/Ctrl + Enter 提交、渠道設置彈窗、作品篩選與「再次編輯 / 重新生成」。瀏覽器最多保留 120 條輕量作品記錄；完整輸入與收據在 Host 的 .mote-submissions/。
未實現即夢的畫布、專有 Agent 模式、視頻/音頻參考 UI、素材庫與收藏分組等能力。
安裝與啓用¶
這是 DSH bundle 包（dsh.bundle.patch + dsh.client），必須在已有 DSH 運行環境中安裝，不是獨立應用。
- 取得插件源碼目錄（例如從 GitHub 倉庫 下載解壓，或本地開發副本）。
- 在 DSH 插件 頁使用「安裝本地插件 / 目錄」，指向該目錄的絕對路徑；或由智能體調用
plugin_manager install_bundle，target傳同一絕對路徑。 - 刷新頁面，側欄應出現 mote 創作臺。
目錄安裝爲軟鏈。倉庫已包含構建好的 client.js，安裝插件本身無需執行 npm install。若自行修改 src/client/，需在目錄內 npm run build 後刷新 DSH；修改 Host 入口需重載插件（禁用再啓用）。
配置¶
在 profile 的 cordis.patch.yml 中本插件條目，或在創作臺「渠道設置」中增刪渠道（寫回同一配置行；面板留空 apiKey 表示沿用已存密鑰）：
- id: mote-media
name: '@local/dsh-mote-media'
config:
channels:
- id: mote
name: mote
driver: mote
baseUrl: 'https://platform.sgt.site'
apiKey: '替換爲你的虛擬密鑰' # 留空時讀環境變量 MOTE_API_KEY
- id: openai
name: openai 兼容
driver: openai-images
baseUrl: 'https://api.openai.com'
apiKey: 'sk-...'
models: ['dall-e-3', 'gpt-image-1']
imageModel: 'doubao-seedream-5-0-lite-260128'
videoModel: 'doubao-seedance-2-0-fast-260128'
imageChannelId: 'mote'
videoChannelId: 'mote'
outputDir: '' # 留空 = %USERPROFILE%\Pictures\mote-media
pollIntervalMs: 3000 # 500–30000
舊版單渠道寫法（頂層 baseUrl + apiKey）仍可用，加載時會歸併爲 id 爲 mote 的渠道。密鑰只留在 Host；瀏覽器僅看到渠道名與是否已配置。
典型用法¶
對話中生圖¶
插件啓用後，可直接在對話中說明需求，或明確要求使用技能，例如：
用 mote-image 生成一張咖啡新品海報，偏電影質感，標題“秋日限定”。幫我完善提示詞，並按手機海報用途選擇比例和清晰度。
僅要求寫提示詞或方案時，技能不會調用生成接口。
工具調用¶
視頻任務提交後，用 mote_media_task 輪詢至 succeeded 再 download；簽名鏈接會過期，宜儘早下載。多張獨立生圖時，mote_image 的 n>1 在 results 中返回各任務的 submissionId，需分別查詢狀態。
創作臺¶
選擇創作類型與模型，填寫提示詞，按需上傳參考圖或首尾幀（單張內聯 data: 不超過 2 MB），點擊圓形發送鍵或 ⌘/Ctrl + Enter。生成流程爲 Host 側 prepare（分配 submissionId 與快照）再 generate；同一提交標識不會重複向上遊 POST。
適用場景與注意¶
適合已在 DSH 中開發智能體、需要 集中管理多模型生圖/生視頻、又希望 對話與面板共用同一 Host 與產物目錄 的開發者。思路與 MuRanSea/media-workstage 相近：每張卡可反覆生成、結果落本地、多模型同屏使用。
使用前請注意：
- 插件以 當前 DSH 進程權限 運行，安裝前應閱讀源碼與 MIT 許可證，確認渠道密鑰與輸出目錄（默認
%USERPROFILE%\Pictures\mote-media）可接受。 - 虛擬密鑰僅存 Host（profile 或包內
.mote-state.json）；面板路由/api/mote-media需 Connection 認證，未授權請求會被拒絕。 - 保留 Host 側
.mote-submissions/才能繼續使用恢復查詢與重新生成；該目錄已從 Git 與運行包排除。 - SkillHub 爲社區插件目錄，與 DeepSeek / 幻方無官方從屬關係；星標等元數據以目錄頁爲準。
結尾¶
dsh-mote-media 把 mote 與 OpenAI 兼容圖片渠道、即夢式創作臺和聊天生圖收進同一 DSH 插件，適合在 Harness 裏統一做媒體任務與產物管理。
