前言¶
在 DeepSeek Harness（DSH）里做电商相关智能体时，常见做法是：Agent 只产出提示词或外链，真正的主图、详情图、广告图还要人工切到别的工具里生成。对话和落盘脱节，批量出图、风格复刻、白底主图也很难在同一套工作流里闭环。
dsh-pixmart 是社区维护的 DSH 插件（维护者 mirror9933，SkillHub 分类为「模型推理」），把电商生图能力挂进 Harness：你在对话里描述需求，Agent 调用插件工具生成图片并写入插件数据目录，在侧边栏「PixMart → 作品库」里浏览与管理。下面介绍它是什么、怎么装、怎么用，以及使用时需要注意的点。
这是什么¶
dsh-pixmart 面向 DeepSeek Harness，提供一套电商生图能力，覆盖主图、详情图、广告图、风格复刻、白底图等场景。插件当前版本为 0.1.2（MIT 许可），源码与说明见 GitHub 仓库，社区目录页为 SkillHub：mirror9933/dsh-pixmart。
DSH 生态强调「一切皆插件」；SkillHub 等目录是独立社区站点，与 DeepSeek / 幻方无官方从属关系。安装插件前，建议自行查看源码与许可证，并理解插件以当前 dsh 进程权限运行。
核心功能¶
根据项目 README，能力可概括为以下几块。
对话驱动的生图
在对话里用自然语言说明需求（例如「给这个产品做一张 1:1 的白底主图」「照这张爆款的风格换成我的产品」「出一套详情图，先给我看提示词」），Agent 按工具链调用插件，把图真正生成并落盘。
多类电商图与提示词模块
支持主图、详情图、广告图等；内置提示词模块（README 提到 pixmart_prompt 加 listModules: true 可列出全部 24 个模块）。保真、风格复刻、带参考图的白底等场景需走 pixmart_edit 并带参考图；纯文生图无法保证主体一致。有参考图做纯白底用 tool.white-bg 模块；main.white-bg 是无参考图的白底首图，二者不要混用。
厂商与模型可配置
插件出厂不带任何厂商，首次使用须在设置里自行添加模型提供商（内置目录如 Ofox / Agnes AI / 阿里云百炼，或自定义 API），配置 API Key、测试连接、拉取并保存生图模型，再设默认厂商 / 模型 / 尺寸 / 每次张数（1–4）。
作品库与数据目录
生成结果落在插件数据目录（默认 $DSH_HOME/pixmart/，未设置 $DSH_HOME 时回落 ~/.dsh/pixmart；实际路径见设置页「数据目录」）。侧边栏「作品库」支持浏览、软删除（回收站可恢复）、导出（仅界面触发，导出路径须在设置里填绝对路径）。对话中渲染用的副本在会话工作区 pixmart-out/<项目 id>/，确认无用后可删，原件仍在数据目录。
工具分层与计费
共 8 个 Agent 工具。免费：pixmart_prompt、pixmart_check_size、pixmart_providers、pixmart_projects、pixmart_ping。计费：pixmart_generate、pixmart_edit、pixmart_batch。默认顺序为省钱：pixmart_prompt → pixmart_check_size → 计费类工具。计费次数 = 项数 × 每项张数；批量前 Agent 会先确认。单张实测约 1–3 分钟，等待期间勿重复调同一工具。余额不足（402）时工具返回 insufficient_credits，要求 Agent 停下来询问用户，不重试、不降级。
尺寸
可传比例（如 1:1、3:4、16:9）或像素（如 1024x1024）；拿不准可先调免费的 pixmart_check_size（不发请求）。部分厂商（如 agnes）档位由精确像素决定。
安装与启用¶
在线安装推荐顺序（勿填 GitHub 仓库地址作为依赖：pnpm 11 构建闸门会拦 prepare）：
- npm 包名（最省事）
- Release 的
.tgz - 本地目录（开发用，需先自行
pnpm build && pnpm build:client）
示例（README 使用 profile px，可按自己的 profile 替换）：
dsh plugin --profile px add dsh-pixmart # 已发布到 npm，最省事；也可换 .tgz 地址或本地绝对路径
dsh --profile px --dump-config # 输出里应出现 dsh-pixmart 层
Release 包示例地址（资料中版本 v0.1.2）：
# 示例：从 Release 安装 .tgz（零闸门，包内自带 lib/ + dist/）
https://github.com/mirror9933/dsh-pixmart/releases/download/v0.1.2/dsh-pixmart-0.1.2.tgz
安装后若不确定插件是否加载，可调用无副作用的 pixmart_ping。若设置页报「宿主未加载此接口」，host 侧改动通常需要重启 DSH 宿主。
首次使用¶
第一次使用前必须配置至少一家模型提供商：
- 打开 设置 → PixMart → 厂商，点 「添加模型提供商」。
- 选择 第三方模型提供商（内置目录）或 自定义模型 API（自填 ID / 显示名 / API 地址）。
- 填写 API Key 并 保存（也可先设环境变量，如
OFOX_API_KEY，优先级高于设置页）。密钥仅以「是否就位」回显，不显示内容、不进日志或响应体。 - 点 「测试连接」，再 「拉取模型」 多选生图模型 → 「保存选择」（唯一写入模型列表的入口）。
- 在 「默认值」 卡片选择 厂商 / 模型 / 尺寸 / 每次张数（1–4） 并保存；生图不带参数时使用这套默认。
未配置厂商时，计费工具会提示打开上述路径添加；已配厂商但 id 写错时，错误信息会列出「已配置：a, b」。
典型用法¶
在对话里提需求
用口语描述任务即可，例如白底 1:1 主图、爆款风格换自己的产品、详情图且先看提示词。Agent 会优先走免费的提示词与尺寸检查，再在你确认后调用计费生成。
保真与风格复刻
必须 pixmart_edit + 参考图；不要指望纯 pixmart_generate 保持产品外观一致。
批量
使用 pixmart_batch；批量前 Agent 会报计费项数，确认后再执行。
排障要点
尺寸以原件和账本（usage.jsonl 记录的厂商回传像素）为准，勿仅信对话里被缩放的预览。删除厂商卡片需两步确认，删掉后重启不会自动补回。
适用场景与注意¶
适合谁
已在 DSH 里做电商运营、商品上架、素材批量的智能体或工作流；愿意自备第三方或自定义生图 API，并接受按次计费（项数 × 张数）。
安全与权限
插件读写 $DSH_HOME/pixmart/（或 ~/.dsh/pixmart）及会话工作区中的 pixmart-out/；API Key 由你在设置或环境变量中提供。安装前请阅读 MIT LICENSE 与仓库 NOTICE，并自行评估源码。
不要做的
不要用 git clone 或仓库 URL 作为 dsh plugin add 的 spec（资料明确禁止，且与本文写作约束一致）。Agent 没有导出能力，导出只能你在作品库界面触发。
结尾¶
dsh-pixmart 把电商主图、详情图、广告图、风格复刻和白底图收进 DSH 对话与工具链，生成结果进作品库而不是停在提示词层面。若要安装或查版本细节，以 README 为准：
