电商生图工坊 mirror9933/dsh-pixmart

dsh-pixmart

给 DeepSeek Harness 加一套电商生图能力：主图 / 详情图 / 广告图、风格复刻、白底图。
你在对话里说要什么，智能体调工具把图真的生成出来，落盘到插件数据目录，在侧边栏「PixMart → 作品库」里看。

安装

dsh plugin --profile px add dsh-pixmart # 已发布到 npm，最省事；也可换 .tgz 地址或本地绝对路径
dsh --profile px --dump-config # 输出里应出现 dsh-pixmart 层

在线安装（dsh plugin add <spec>），按推荐顺序：

- 包名 dsh-pixmart —— 已发布，最省事；
- Release 的 .tgz（零闸门，包内自带 lib/+dist/）： https://github.com/mirror9933/dsh-pixmart/releases/download/v0.1.2/dsh-pixmart-0.1.2.tgz
- 本地目录（开发用）：链接安装不触发构建，先自己 pnpm build && pnpm build:client。

⚠️ 别填仓库地址：它算 git 依赖，pnpm 11 的构建闸门会拦下 prepare（allowBuilds 要精确键、含 commit sha，DSH 的「允许并重试」救不了）。用上面前两条。

首次使用

插件出厂不带任何厂商，第一次必须先自己加一家：

1. 设置 → PixMart → 厂商 → 点 「添加模型提供商」；
2. 选一个 tab：第三方模型提供商（内置目录里挑一家，如 Ofox / Agnes AI / 阿里云百炼）或 自定义模型 API（自填 ID / 显示名 / API 地址）；
3. 填 API Key → 保存（也可以先设环境变量，如 OFOX_API_KEY，优先级高于设置页）；
4. 点 「测试连接」 确认端点与密钥；再点 「拉取模型」 多选生图模型 → 「保存选择」（唯一写入模型列表的入口）；
5. 回顶部 「默认值」 卡片选 厂商 / 模型 / 尺寸 / 每次张数（1–4） 并保存 —— 生图不带参数就用这套。

- 密钥只以「是否就位」回显，任何时候都不显示内容，也不进日志或响应体。
- 卡片行尾的 「删除」 是两步确认；删掉不会在重启后被补回来（出厂没有预设可补）。
- 可选：「作品库导出路径」填一个绝对路径（相对路径会被当成未设置）；只有你点「导出」才会往那儿复制，生成时不会。

怎么用

「给这个产品做一张 1:1 的白底主图」「照这张爆款的风格换成我的产品」「出一套详情图，先给我看提示词」。

智能体的默认顺序（为了省钱）：pixmart_prompt（免费）→ pixmart_check_size（免费）→ pixmart_generate / pixmart_edit / pixmart_batch（计费）。
计费次数 = 项数 × 每项张数，批量前智能体会先报给你确认；单张实测 1–3 分钟，等待期间别让它重复调同一个工具。
8 个工具：免费的 pixmart_prompt / pixmart_check_size / pixmart_providers / pixmart_projects / pixmart_ping，计费的 pixmart_generate / pixmart_edit / pixmart_batch（pixmart_prompt 加 listModules: true 能列出全部 24 个提示词模块）。

- 要保持产品外观一致（保真 / 风格复刻 / 白底图）必须走 pixmart_edit 并带参考图；文生图保证不了主体一致。
- 有参考图做纯白底用 tool.white-bg 模块；main.white-bg 是无参考图的白底首图，别混。

尺寸

比例（1:1、3:4、16:9…）或像素（1024x1024）都能传；agnes 的档位由精确像素决定 （2048x2048 = 2K + 1:1，只给比例则用默认 1K），比例支持 8 种。拿不准就先调 pixmart_check_size（免费，不发请求）。

产物在哪

只落盘插件数据目录：$DSH_HOME/pixmart/（没设时回落 ~/.dsh/pixmart，实际路径见设置页的「数据目录」）—— config.json（设置页写的就是它）、usage.jsonl（用量账本）、projects/<项目 id>/（元数据 + 图片）。
浏览 / 删除 / 恢复 / 导出都在侧边栏「作品库」：删除是软删（进回收站，可恢复，清空才真删）； 导出只能你点界面触发，落点是设置里的导出路径，智能体侧没有导出能力。
对话里渲染图片用的副本在会话工作区的 pixmart-out/<项目 id>/，确认没用了可以整体删（原件在数据目录）。

开发与打包

pnpm install
pnpm build # host tsc → lib/
pnpm build:client # 剥离 client bundle 的 __test__ → dist/client.js（test 的 pretest 会顺带跑）
pnpm prepare # 安装时自动跑（git 依赖 / 本地 install）→ lib/ + dist/
pnpm prepack # pack / publish 前自动跑 → lib/ + dist/（两者同一条完整构建）
pnpm verify # typecheck + build + 宿主 lane + 浏览器 lane，全绿才算过（计数以它输出为准）

目录：

- src/ —— host 半（TypeScript，运行时零 @deepseek-ai 依赖）：配置、厂商目录、路由、tools/、vendor/、prompts/、store/
- client/client.js —— client 半（手写、__ModuleLoader__ 包装，测试从这里取组件）
- test/ —— 宿主 lane（node:test + jsdom）；test/browser/ —— 浏览器 lane（Playwright + 系统浏览器）
- tools/ —— 开发脚本：strip-test-hooks.mjs（打包剥离）、lane-mutations.mjs（变异验证）
- docs/ —— 契约笔记 / 技术方案 / 验收记录：不上传仓库，只在本机（远端链接会 404，且无版本历史，请自行备份）
- lib/ dist/ —— 构建产物；pixmart-in/ pixmart-out/ —— 会话工作区进 / 出目录（都不入库）

排障

- 点了按钮报「宿主未加载此接口」 → 预期：host 改动要重启宿主（分级见「安装」）；不确定插件有没有加载就调一次 pixmart_ping（无副作用）。
- 报「还没有配置任何厂商：打开「设置 → PixMart → 厂商」，点「添加模型提供商」…」 → 预期首启状态，去加一家就行；已配厂商只是 id 写错时，文案会列「已配置：a, b」。
- 尺寸对不上 → 核对原件，别看对话里的附件预览（预览会被缩放）；账本记的是厂商真实回传的像素。
- 余额不足（402） → 工具返 insufficient_credits 并要求 Agent 停下来问你，不重试、不降级，也不允许用脚本"合成"一张图充数。

许可

MIT，见 LICENSE；原创范围声明见 NOTICE。

项目主页：https://github.com/mirror9933/dsh-pixmart