# @petercjl/product-reference-replacement 中文文档

规范地址：https://npmcn.com/package/%40petercjl/product-reference-replacement/

版本：0\.4\.1
npm 元数据更新时间：2026-11-02T02:20:44.175Z
中文译文更新时间：2026-11-02T04:09:43.251Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40petercjl/product-reference-replacement
原文对照：https://npmcn.com/package/%40petercjl/product-reference-replacement/?lang=original
项目主页：https://github.com/petercjl/product-reference-replacement#readme
源码仓库：https://github.com/petercjl/product-reference-replacement

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：16.8 MB，80 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-10-21T03:51:54.817Z
- 最新版本发布：2026-11-02T02:20:43.901Z
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

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

## 安装

```sh
npm install @petercjl/product-reference-replacement
```

也可以使用：`pnpm add @petercjl/product-reference-replacement`、`yarn add @petercjl/product-reference-replacement`、`bun add @petercjl/product-reference-replacement`

## README

# 产品视觉资产与场景替换

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

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

## 安装

把下面这段话发给 Agent：

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

安装 Agent 请先读取包根目录的 [安装指导](https://npmcn.com/package/%40petercjl/product-reference-replacement/INSTALL.md)，更新时读取 [更新指导](https://npmcn.com/package/%40petercjl/product-reference-replacement/UPDATE.md)。由当前 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 是什么？

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

### 如何安装 @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 和提交记录判断。