dsh-mxpage：DeepSeek Harness 電商詳情頁工作流插件

前言¶

在 DeepSeek Harness（DSH）環境中開發電商類智能體時，直接調用圖像生成接口往往只能得到孤立的圖片，難以形成連貫的詳情頁結構。通用的圖庫插件無法替代從商品分析到頁面規劃再到生成編輯的完整工作流。

dsh-mxpage 是一個將 MxPage 電商產品圖工作臺移植到 DSH 官方 web profile 的插件。它實現了從註冊照片、分析賣點、規劃版塊到 Visual Prompt Agent（VPA）生成與編輯的完整鏈路。

插件定位¶

這是一個爲 DSH 插件生態設計的電商詳情頁生成工具，由社區開發者 kim1232aa 維護，基於 MIT 許可證。它不是通用圖庫，也不是一個簡單的提示詞包裝器。社區插件通常註冊一個單次調用的 generate_image，而 dsh-mxpage 要求模型必須嚴格遵循 analyze → plan → VPA → generate 的步驟，將單張商品圖轉化爲一套邏輯連貫的詳情頁素材。

核心功能¶

該插件提供了以下核心能力：

工作流控制：包含分析賣點、規劃 Hero/詳情部分、Visual Prompt Agent、生成、編輯等工具，所有工具均以 mxpage_* 命名。
項目管理：支持註冊照片、設置主圖、查看項目元數據、刪除項目。
生成與導出：支持按部分生成、整頁生成、整頁翻譯、ZIP/JSON 導出。
渠道管理：支持多渠道配置、負載均衡、配額輪轉。
監控與診斷：提供 API 使用日誌、渠道診斷、任務歷史與重試功能。

安裝與啓用¶

安裝插件需要將代碼包或構建好的 tarball 註冊到 DSH 中。

# 從本地 checkout 目錄安裝
dsh plugin add link:/absolute/path/to/mxpage

# 或從構建好的壓縮包安裝
dsh plugin add ./dsh-mxpage-0.3.0.tgz

安裝後，插件會註冊到 DSH 的 profile 中。你需要配置渠道並重啓 profile 以加載插件層。

配置渠道¶

該插件使用“渠道列表”而非單一環境變量來管理圖像 API。你可以在設置中配置，或直接修改 cordis.patch.yml：

- insert:
    - id: mxpage
      name: dsh-mxpage
      config:
        channels:
          - id: xai
            label: xAI (Grok)
            baseUrl: https://api.example.com/v1
            apiKeyEnv: MXPAGE_XAI_KEY
            models: [grok-imagine-image-2.0]
            textModel: grok-4
            imageModel: grok-imagine-image-2.0
        rotateChannelOnQuotaExhausted: true

如果遇到問題，請先運行診斷命令查看活躍渠道及模型狀態：

mxpage_channels

典型用法¶

在 DSH 聊天中，上傳一張商品圖片並輸入提示詞即可觸發工作流。

根據這張商品圖出一套淘寶詳情頁

插件會自動執行創建項目、分析賣點、規劃版塊、調用 VPA 生成圖片的流程。最終生成的圖片會作爲附件返回，存儲在 $DSH_HOME/mxpage/projects/<projectId>/ 下。

適用場景與注意¶

環境要求：必須使用 DSH 官方 web profile，不支持 sdk-minimal。
付費 API：生成和編輯工具調用的是 OpenAI 兼容的付費圖像 API，每次工具調用都會消耗配額。請確保在技能中設置確認步驟，避免一次性消耗過多額度。
模型能力：插件根據模型名稱推斷其能力，不進行實際的端點探測以節省配額。
安全性：API 密鑰在工具輸出、日誌和會話事件中永遠不會出現，系統會自動脫敏。
技能目錄：插件內置的技能目錄需要複製到 DSH 的技能目錄中才能被識別：

    mkdir -p "${DSH_HOME:-$HOME/.dsh}/skills"
    cp -R skills/mxpage-* "${DSH_HOME:-$HOME/.dsh}/skills/"

結語¶

dsh-mxpage 爲 DSH 提供了結構化的電商頁面生成能力，適合需要構建電商詳情頁、小紅書圖文或批量 SKU 生成的應用場景。更多細節可參考其 GitHub 倉庫或社區目錄。