| name | pricing-setup |
| description | VideoFly 商品定价与积分配置向导。引导用户完成订阅产品定价、积分包配置、新用户赠送积分设置， 自动更新 pricing-user.ts 代码和 price-data.ts / price-faq-data.ts 展示数据， 最终生成 Creem 后台操作指南 markdown 文档，帮助用户在 Creem 创建商品并回填 Product ID。 触发词："配置定价"、"设置价格"、"pricing setup"、"配置积分"、"设置积分包"、 "配置商品"、"setup pricing"、"configure credits"、"定价配置"、"积分配置"、 "creem 商品"、"创建商品"、"product setup"。
|
VideoFly 商品定价与积分配置向导
通过多轮对话引导用户完成 VideoFly 的完整定价体系配置。
成本模型
积分成本参考 evolink.ai 的 API 定价，按 1:1 设置积分消耗。
- 1 积分 = 0.1 元人民币（约 $0.014 USD，按汇率 7.2 计算）
- 成本计算：套餐积分 x $0.014 = 积分成本(USD)
- 毛利率 = (售价 - 积分成本) / 售价 x 100%
在 Step 2 和 Step 3 的确认环节，展示利润率分析表：
| 方案 | 售价 | 积分 | 积分成本 | 毛利 | 毛利率 |
|------|------|------|----------|------|--------|
| Basic 月付 | $9.90 | 280 | $3.89 | $6.01 | 60.7% |
| Pro 月付 | $29.90 | 960 | $13.33 | $16.57 | 55.4% |
| Ultimate 月付 | $79.90 | 2,850 | $39.58 | $40.32 | 50.5% |
| Basic 年付 | $95.00 | 3,360 | $46.67 | $48.33 | 50.9% |
| Pro 年付 | $287.00 | 11,520 | $160.00 | $127.00 | 44.3% |
| Ultimate 年付 | $767.00 | 34,200 | $475.00 | $292.00 | 38.1% |
计算公式（汇率可调，默认 7.2）：
- 积分成本(USD) = 积分数 x 0.1 / 汇率
- 毛利(USD) = 售价 - 积分成本
- 毛利率 = 毛利 / 售价 x 100%
核心文件
| 文件 | 用途 |
|---|
src/config/pricing-user.ts | 主配置文件：所有价格、积分、模型计费 |
src/config/price/price-data.ts | 前端展示数据（自动从 pricing-user.ts 生成） |
src/config/price/price-faq-data.ts | 定价页 FAQ（需手动同步价格数字） |
src/config/credits.ts | 内部积分系统（从 pricing-user.ts 读取，无需修改） |
.env.local | Creem API 密钥和 Webhook Secret |
docs/CREEM-SETUP-GUIDE.md | Creem 后台操作参考文档 |
工作流程
按以下 5 步顺序执行。每步收集用户输入后再进入下一步。
Step 1: 基础设置 - 新用户注册赠送
读取 src/config/pricing-user.ts 中的 NEW_USER_GIFT，向用户展示当前配置并询问：
- 是否赠送新用户积分？ 当前:
enabled: true/false
- 赠送多少积分？ 当前:
credits: N（提示：1 个 Veo 3.1 视频 = 10 积分，1 个 Sora 2 视频 = 2 积分）
- 赠送积分有效期？ 当前:
validDays: N 天
CREDIT_EXPIRATION（赠送积分有效期、订阅积分有效期、一次性购买积分有效期）保持默认值不变，
除非用户主动要求修改。不要主动询问这些过期时间配置。
用户确认后，更新 NEW_USER_GIFT 对象。
Step 2: 订阅产品定价
读取 SUBSCRIPTION_PRODUCTS 数组，向用户展示当前订阅方案。
2a. 收集月付方案
询问用户：
- 需要几个订阅档位？ 默认 3 档（Basic / Pro / Ultimate）
- 每档的月付价格和积分？ 提供当前值作为参考
- 哪个档位标记为推荐（popular）？ 默认中间档位（Pro）
- 是否禁用某个档位？
2b. 年付折扣自动计算
询问用户年付折扣率，默认 20%（即年付 = 月付 x 12 x 0.8）。用户可自定义折扣率。
年付自动计算规则：
- 年付价格 = 月付价格 x 12 x (1 - 折扣率)，取整数
- 年付积分 = 月付积分 x 12（用户享受全年完整积分，不打折）
- 中间档位（推荐档）的折扣力度最合适，是主推方案
2c. 展示完整方案让用户确认
展示两张表。第一张：月付 + 年付的完整对比：
| 方案 | 月付 | 月积分 | 年付 | 年积分 | 年付折扣 | 年省 | 推荐 |
|------|------|--------|------|--------|----------|------|------|
| Basic | $9.90 | 280 | $95 | 3,360 | 20% | $23.80 | |
| Pro | $29.90 | 960 | $287 | 11,520 | 20% | $71.80 | * |
| Ultimate | $79.90 | 2,850 | $767 | 34,200 | 20% | $190.80 | |
第二张：利润率分析（基于成本模型自动计算）：
| 方案 | 售价 | 积分 | 积分成本 | 毛利 | 毛利率 |
|------|------|------|----------|------|--------|
| Basic 月付 | $9.90 | 280 | $3.89 | $6.01 | 60.7% |
| Pro 月付 | $29.90 | 960 | $13.33 | $16.57 | 55.4% |
| ... | ... | ... | ... | ... | ... |
提示用户：月付毛利率建议 50-65%，年付因折扣毛利率会低 10-15 个百分点。
如果某方案毛利率低于 35%，给出警告。
必须等用户明确确认后，才进入下一步。
用户确认后，更新 SUBSCRIPTION_PRODUCTS 数组。注意：
id 字段暂时保留占位符格式 prod_PLAN_PERIOD（后续从 Creem 回填）name 字段格式：月付 "Basic Plan"，年付 "Basic Plan (Yearly)"period 字段：月付 "month"，年付 "year"
Step 3: 积分包配置
读取 CREDIT_PACKAGES 数组，向用户展示当前积分包。
询问用户：
- 是否需要积分包？ 如不需要，将所有积分包
enabled: false，跳到 Step 4
- 需要几个积分包？ 默认 3 个
- 每个积分包的价格和积分？ 提示：积分包通常比订阅月付贵 25-35%
- 哪些积分包允许免费用户购买？
allowFreeUser: true/false
- 哪个标记为推荐？
展示积分包方案 + 利润率分析（同 Step 2 格式），让用户确认后更新 CREDIT_PACKAGES 数组。
积分包毛利率通常比订阅高（因为溢价 25-35%），建议 60-75%。id 同样暂用占位符。
Step 4: 同步前端展示（关键步骤）
用户确认定价方案后，必须同步所有前端展示文件，确保网站展示与配置一致。
4a. price-data.ts - 前端展示文案
price-data.ts 的价格数据从 SUBSCRIPTION_PRODUCTS 自动生成，但 planFeatures 中的文案需手动同步：
- 更新每个档位 benefits 中的积分数字描述
- 格式：
"每月 {N} 积分（约 {N/10} 个视频）" / "{N} credits/month (~{N/10} videos)"
- 约数按 Veo 3.1 = 10 积分/视频计算
- 如果方案名称或档位数量变化，同步更新
planIdMap 和 plans 数组
- 更新 description 描述文案
4b. price-faq-data.ts - 定价页 FAQ
逐条检查并更新 FAQ 中所有涉及价格和积分的数字（zh / en / ja / ko 四种语言）：
需要同步的数据点：
- 各档位月付价格（$X.XX/月）
- 各档位年付价格（$XXX/年）
- 各档位月积分和年积分数量
- 积分包价格和积分数量
- 折扣比例（如 "省 20%"）
- "约 N 个视频" 的估算数
只更新数字和与定价直接相关的文案，不改变 FAQ 结构和问题本身。
4c. pricing 组件页面
搜索以下文件中是否有硬编码的价格数字需要同步：
src/messages/en.json 和 src/messages/zh.json 中的 pricing 相关 keysrc/components/ 下与 pricing 相关的组件src/app/[locale]/(marketing)/pricing/ 下的页面文件
使用 Grep 搜索旧价格数字（如 9.90、29.90、280、960 等），确保无遗漏。
4d. 变更校验
完成所有文件修改后，输出变更汇总表：
| 文件 | 修改内容 |
|------|----------|
| pricing-user.ts | 更新了 N 个产品配置 |
| price-data.ts | 同步了积分描述文案 |
| price-faq-data.ts | 更新了 N 条 FAQ 中的数字 |
| ... | ... |
Step 5: 生成 Creem 操作指南
根据最终配置，生成 docs/CREEM-PRODUCT-CHECKLIST.md 文档，包含：
5a. 产品创建清单
按产品逐一列出在 Creem 后台创建时需要填写的信息：
## 需要在 Creem 创建的产品
### 月付订阅
#### 1. Basic Plan (Monthly)
- 产品类型: Subscription
- 产品名称: Basic Plan
- 描述: {credits} credits/month - Perfect for individuals
- 价格: ${price} USD
- 计费周期: Monthly
- 元数据: credits="{credits}", features="{features}"
- [ ] 已创建 Product ID: _______________
（每个产品重复此格式）
5b. Product ID 回填指引
## 回填 Product ID
创建完所有产品后，将 Product ID 填入 `src/config/pricing-user.ts`：
1. 打开 `src/config/pricing-user.ts`
2. 找到对应产品，将 `id` 字段替换为 Creem 的 Product ID
示例：
id: "prod_4yNyvLWQ88n8AqJj35uOvK", // Basic Monthly
5c. Webhook 配置提醒
## Webhook 配置
1. Creem Dashboard -> Webhooks -> Add Webhook
2. URL: {NEXT_PUBLIC_APP_URL}/api/auth/creem/webhook
3. Events: checkout.completed, subscription.created/updated/cancelled/expired
4. 复制 Secret 到 .env.local 的 CREEM_WEBHOOK_SECRET
5d. 验证清单
## 验证清单
- [ ] 所有产品已在 Creem 创建
- [ ] Product ID 已回填到 pricing-user.ts
- [ ] CREEM_API_KEY 已配置
- [ ] CREEM_WEBHOOK_SECRET 已配置
- [ ] pnpm dev 启动后 /pricing 页面显示正确
- [ ] 价格、积分、折扣数字在页面上展示正确
- [ ] FAQ 中的数字与实际配置一致
- [ ] 测试环境支付流程正常
交互要求
- 每步展示当前配置，让用户看到现状后再决定是否修改
- 用表格形式展示产品数据，便于对比
- 价格确认后再改代码：修改代码前必须先让用户确认完整方案
- 价格用美元（如 9.9），不是美分
- 积分用整数
- Step 4 是关键步骤：必须主动搜索并同步所有前端展示文件，不能遗漏
- 完成所有步骤后，输出完整的变更摘要
