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 仓库或社区目录。