Introduction

When developing e-commerce agents in the DeepSeek Harness (DSH) environment, directly calling image generation interfaces often only yields isolated images, making it difficult to form a coherent product detail page structure. Generic image library plugins cannot replace the complete workflow from product analysis to page planning to generation and editing.

dsh-mxpage is a plugin that ports the MxPage e-commerce product image workbench to the DSH official web profile. It implements the complete chain from registering photos, analyzing selling points, planning sections, to Visual Prompt Agent (VPA) generation and editing.

Plugin Positioning

This is an e-commerce detail page generation tool designed for the DSH plugin ecosystem, maintained by community developer kim1232aa, under the MIT license. It is not a generic image library, nor is it a simple prompt wrapper. Community plugins usually register a single-call generate_image, while dsh-mxpage requires the model to strictly follow the analyze → plan → VPA → generate steps, converting a single product image into a set of logically coherent detail page assets.

Core Features

The plugin provides the following core capabilities:

  • Workflow control: Includes tools for analyzing selling points, planning Hero/detail sections, Visual Prompt Agent, generation, and editing; all tools are named with the mxpage_* prefix.
  • Project management: Supports registering photos, setting the main image, viewing project metadata, and deleting projects.
  • Generation and export: Supports generating by section, whole-page generation, whole-page translation, and ZIP/JSON export.
  • Channel management: Supports multi-channel configuration, load balancing, and quota rotation.
  • Monitoring and diagnostics: Provides API usage logs, channel diagnostics, task history, and retry functionality.

Installation and Enablement

Installing the plugin requires registering the code package or built tarball to DSH.

# 从本地 checkout 目录安装
dsh plugin add link:/absolute/path/to/mxpage

# 或从构建好的压缩包安装
dsh plugin add ./dsh-mxpage-0.3.0.tgz

After installation, the plugin is registered in the DSH profile. You need to configure channels and restart the profile to load the plugin layer.

Configure Channels

The plugin uses a “channel list” rather than a single environment variable to manage image APIs. You can configure this in settings or directly modify 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

If you encounter issues, first run the diagnostics command to view active channels and model status:

mxpage_channels

Typical Usage

In DSH chat, upload a product image and enter a prompt to trigger the workflow.

Generate a set of Taobao detail pages based on this product image

The plugin automatically executes the flow of creating a project, analyzing selling points, planning sections, and calling VPA to generate images. The final generated images are returned as attachments and stored under $DSH_HOME/mxpage/projects/<projectId>/.

Applicable Scenarios and Cautions

  • Environment requirements: Must use the DSH official web profile; sdk-minimal is not supported.
  • Paid API: The generation and editing tools call OpenAI-compatible paid image APIs, and each tool call consumes quota. Please ensure that a confirmation step is set in skills to avoid consuming excessive quota at once.
  • Model capabilities: The plugin infers capabilities based on the model name and does not perform actual endpoint probing to save quota.
  • Security: API keys never appear in tool outputs, logs, or session events; the system automatically masks them.
  • Skill directory: The plugin’s built-in skill directory must be copied to the DSH skill directory to be recognized:
    mkdir -p "${DSH_HOME:-$HOME/.dsh}/skills"
    cp -R skills/mxpage-* "${DSH_HOME:-$HOME/.dsh}/skills/"

Conclusion

dsh-mxpage provides DSH with structured e-commerce page generation capabilities, suitable for application scenarios requiring e-commerce detail pages, Xiaohongshu image-text content, or bulk SKU generation. For more details, refer to its GitHub repository or community catalog.