dsh-psd-batch-studio

DSH PSD Batch Studio · 主图批量替换工作台

简体中文 | [English](README.en.md)

> 由 Genca（缙嘉集团，上海缙嘉科技有限公司）VinkWork 团队 开源。

> VinkWork 的核心产品是 [VinkClaw.com](https://vinkclaw.com)。

一个 [DeepSeek Harness](https://github.com/deepseek-ai) 插件，用来批量生产电商商品主图：

载入 PSD/PSB 主图模板，标记商品槽位，批量放入 SKU 抠图，在画布上微调，最后一键整批导出。

同一套合成内核还提供两个 agent 工具，可以让 agent 在 Host 侧无人值守地跑完整个 SKU 目录。

> 协议： 修改版 Apache License 2.0，带附加条件。

> 允许商用；多租户服务或去除品牌标识需要书面授权。详见 [LICENSE](LICENSE) 与 [LICENSING.md](LICENSING.md)。

适用对象

适合已经有 PSD 主图模板、又需要批量产出变体的电商设计与运营团队。PSD 仍然是唯一事实来源：

插件只替换商品像素，保留模板里的文字、价格条、角标、赠品卡等装饰层，最后输出成品图。

它不是 Photoshop 替代品：不负责改文案、修图、管理素材库；它负责“模板 + 抠图 → 成品主图变体”。

适用场景

• 大促/活动批量出图：一个模板 × 几百个 SKU（618、双 11、黑五、店铺全场活动），

或者一批 SKU × 多个活动模板；换模板时 SKU 队列保留，不用重新导入。

• 新品上新：一个模板，多个颜色/规格/组合装变体，在同一组商品位里重新适配。
• 多平台/多尺寸：天猫、京东、抖音、拼多多，或方图、竖图、长图的模板集合；

换模板不用重搭流程。

• 设计到运营的交接：设计师交付 PSD 和槽位规则，运营/代运营/店长自己批量出图，不再排队等设计。
• Agent 自动化：psd_batch_render 在工作区里无人值守批量渲染，适合夜间任务、商品库对接、

“明早之前出 200 张”这类需求。

• 模板治理：文案、角标、价格条、活动道具分图层管理，按活动开关；商品位保持稳定。

一次典型运行：

templates/summer-main.psd + skus/0715/*.png
        ↓  商品槽位替换
out/0715-main/*.jpg（可选 ZIP）

功能

• 模板工作台：打开 .psd / .psb，浏览图层树、开关图层，在交互画布上实时看合成结果。
• 商品槽位：按面积、位置、长宽比和命名自动推荐商品图层；可手动标记/取消。

同一商品的「原层 + 阴影/高光副本」会组成一个商品簇，一起隐藏、商品只画一次。

• 批量适配：一次导入多张 PNG/JPG/WebP 抠图，自动裁掉透明边，按

完整放入 / 按高度 / 按宽度 / 铺满裁切适配，并支持对齐和占比。

• 画布微调：拖动商品、拖角点缩放、数值调偏移/缩放/角度，可一键同步到全部 SKU。
• 导出：按模板原始分辨率输出 JPG/PNG，每个 SKU 一张，可打包 ZIP。
• Agent 工具：psd_inspect、psd_batch_render，同一套内核在 Host 侧批量跑。
• 本地优先：PSD 解析和合成都在本机完成（页面内或 Host 进程），没有网络请求、没有埋点、不上传素材。

环境要求

• DeepSeek Harness（带插件管理器）。插件声明 dsh.engines.dsh >= 0.2.1-rc.5，

已在 0.2.1-rc.5 和 0.2.2-rc.1 上验证。

• Node.js 20+（构建和 Host 侧 agent 工具需要）。
• 安装时需要能访问 npm registry：agent 工具依赖 @napi-rs/canvas 的平台预编译包。
• 不需要安装 Photoshop。

安装

从 npm 安装（推荐）：

plugin_manager install_bundle, target = dsh-psd-batch-studio

固定版本用 dsh-psd-batch-studio@0.2.5。

也可以从 GitHub 安装：

plugin_manager install_bundle, target = github:vinkwork/dsh-psd-batch-studio

如果插件管理器不支持 GitHub spec，克隆后指向本地目录：

git clone https://github.com/vinkwork/dsh-psd-batch-studio.git
cd dsh-psd-batch-studio
npm install

plugin_manager install_bundle, target = /绝对路径/dsh-psd-batch-studio

安装后刷新 Harness 页面：侧边栏出现「主图批量替换」图标，agent 侧出现两个工具。

client.js / server.js 已随仓库提交，安装不需要先构建；改源码后执行 npm run build。

使用工作台

1. 从侧边栏打开「主图批量替换」。