@petercjl/product-reference-replacement

中文文档
0.4.1发布于 2026/11/02MITES Module构建来源已验证

Reusable product asset boards and iterative product replacement with a portable Agent Skill.

原始使用文档
文档目录4 节
  1. 安装
  2. 使用
  3. 更新和检查
  4. 验证范围

产品视觉资产与场景替换

一个供具备所需能力的任意 Agent 使用的应用 Skill,包含本地任务与合成工具。

  • 从产品图片或详情页先确定图片职责与数量,再从8套固定16:9布局中选择分区,按4个独立单图任务一组并发生成高清图片,尾组按实际数量并合成16:9资产图;交付n张独立原图和整板,支持单格重生后重新合成。
  • 用已有资产图替换单张或明确指定的一组场景图中的产品。
  • 替换采用 nano-banana-pro,每次生成一张、检查后调整提示词,每图最多四轮,达标提前结束。

安装

把下面这段话发给 Agent:

请安装 @petercjl/product-reference-replacement,并将配套 Skill 安装到你当前使用的 Agent。

安装 Agent 请先读取包根目录的 安装指导,更新时读取 更新指导。由当前 Agent 识别自己的 Skill 目录与注册方式,并验证能发现和加载 Skill。npm 安装成功仅完成引导包安装。每个Agent实体安装自己的Skill、配套运行时与依赖,相互隔离。

包包含固定分区规划、单图版本、合成、来源追踪和任务记录工具。安装本包不授予生成服务访问权。资产图片生成与场景替换需要已配置的 sealseek-media;完整长详情页切片需要 semantic-image-slicer。Agent 会按实际任务检查依赖。

使用

制作资产图时附上产品照片或详情页:

用产品视觉资产与场景替换,根据所附产品图制作产品资产图。

替换单张时附上资产图和待改图:

用产品视觉资产与场景替换,用所附资产图修改这张图片。

批量替换时附上同一产品资产图和待改图片组:

用产品视觉资产与场景替换,批量修改这组图片,共用所附资产图。

更新和检查

请更新 @petercjl/product-reference-replacement 及当前 Agent 中的配套 Skill。

请检查 product-reference-replacement 的安装与依赖状态。

普通任务入口会限时检查新版本,默认仅提示。开发者和 Agent 可查看包的机器可读能力合同及命令帮助;自定义宿主使用显式目标目录安装,更新后同步相同目标。

验证范围

本地确定性图片处理、任务状态与安装机制有自动化测试。macOS 与 Windows 的包级验证由发布 CI 执行。完整 Agent 会话、收费生成结果及其他平台的实际视觉能力需要分别验收。

本包包含 MIT 许可代码及 SIL Open Font License 授权的 Noto CJK 字体,许可文件随包提供。

开发/运行合同:准备阶段通过reference batch-prepare/batch-review直接消费模板;模式A通过panel batch-prepare/batch-run/batch-review保留每格独立task和验收,未知提交只恢复原任务。当前阶段的依赖、原图检查和机械回执复用;验收输入使用外部工作目录,内部review.json由CLI维护。安装与源码修复本身不授权付费测试或替换运行中的环境。

模式A按用户与宿主选择支持原生imagegen或SealSeek。新任务先锁定模板计划,原件绑定请求并逐格验收后统一合成;职责调整保留版本,只重做受影响格。

运行时安装使用当前宿主提供的受管 Node 和 npm CLI;Windows 以参数数组直接调用 npm JavaScript 入口,保留含空格与中文的路径。宿主可通过标准 npm_execpath 提供 npm-cli.js,独立 Node 安装也可自动定位相邻 npm。

版本与发布记录

@petercjl/product-reference-replacement 共发布 14 个版本,首次发布于 2026/10/21;过去 12 个月发布了 14 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.1latest2026/11/021 天前
0.4.02026/11/011 天前
0.3.62026/10/286 天前
0.3.52026/10/268 天前
0.3.42026/10/2410 天前
0.3.32026/10/2410 天前

其他发布通道:bootstrap → 0.0.0-bootstrap.0。

关于 @petercjl/product-reference-replacement 的常见问题

@petercjl/product-reference-replacement 是什么?

可重用的产品资产板和迭代的产品替换与便携式代理技能。

如何安装 @petercjl/product-reference-replacement?

在项目目录运行 npm install @petercjl/product-reference-replacement,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 product-reference-replacement,可以用 npx product-reference-replacement 直接运行。

@petercjl/product-reference-replacement 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/petercjl__product-reference-replacement 是否存在。

@petercjl/product-reference-replacement 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@petercjl/product-reference-replacement 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@petercjl/product-reference-replacement 可以商用吗?

@petercjl/product-reference-replacement 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@petercjl/product-reference-replacement 还在维护吗?

最新版本 0.4.1 发布于 2026/11/02(1 天前);至今共发布 14 个版本,其中过去 12 个月发布了 14 个;首次发布于 2026/10/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。