# AI Editor RSP 中文 PRD v4 — 产品章节补丁

日期：2026-06-10
适用文件：AI Editor RSP 中文 PRD v4
用途：以下内容可直接合并进中文 PRD v4，不包含内部审查意见。

---

## A. 产品状态主合同

AI Editor RSP 的首版产品必须用统一状态合同控制登录、额度、provider、付费、checkout、Copy Prompt、Upload 与 Generate。所有页面、组件、文案、QA 验收都必须引用同一份状态定义。

### A.1 产品状态优先级

固定顺序：

1. **Copy Prompt**：基础价值，永远可用；不要求登录，不消耗额度，不受 provider、paid、checkout 影响。
2. **Open / Try in Editor**：增强入口；可匿名打开，带入 prompt 和 effect slug。
3. **Upload Preview**：可在 provider-disabled / provider-preview 下存在，但必须明确“不等于真实生成”。
4. **Generate**：有条件能力，只在 provider-live 且 auth / quota 满足时可用。
5. **Pricing / Checkout**：商业化入口，只能在用户理解产品价值和 provider 状态之后出现；不能主导首次体验。

### A.2 状态维度

#### Auth State

| 状态 | 定义 | 产品行为 |
|---|---|---|
| `anonymous` | 未登录用户 | 可浏览、筛选、复制 prompt、打开 editor、上传预览；生成能力按 provider 和策略决定，默认生成前要求登录 |
| `signed-in` | 已登录但套餐未知 | 过渡状态；按 signed-in-free 保守展示，额度加载完成后刷新 |
| `signed-in-free` | 免费登录用户 | Copy Prompt 免费；provider-live 时可使用免费生成额度；额度耗尽进入 quota-exhausted |
| `signed-in-pro` | Pro 用户 | 可使用 Pro 月度额度和已实现 Pro 能力；仍受 provider 和 quota 控制 |

#### Provider State

| 状态 | 定义 | 产品行为 |
|---|---|---|
| `provider-disabled` | 没有可调用生成 provider，或站点关闭生成 | 不展示真实 Generate；展示 Copy Prompt、upload preview、external-use guidance、waitlist |
| `provider-preview` | 可演示上传 / 选择效果 / 预览流程，但不保证真实生成 | 不扣 credits；Generate 文案必须是 preview / waitlist / use externally |
| `provider-live` | 生成 provider 真实可用 | 可以展示 Generate；必须提供 loading / success / error / quota / retry / no-credit-on-provider-fail 状态 |

#### Quota State

| 状态 | 定义 | 产品行为 |
|---|---|---|
| `quota-unknown` | 额度尚未加载 | 不允许直接生成或扣费；显示 checking quota；Copy Prompt 可用 |
| `quota-available` | 有可用生成额度 | provider-live 时可生成 |
| `quota-exhausted` | 额度用尽 | Copy Prompt 继续可用；Generate 不调用 provider；展示 Upgrade / Buy Credits / Wait Reset / Copy Prompt instead |

#### Payment State

| 状态 | 定义 | 产品行为 |
|---|---|---|
| `paid-disabled` | 付费能力未启用或不应售卖 | Pricing 只能解释未来能力 / waitlist；不能展示可购买生成套餐 |
| `checkout-disabled` | 定价可展示，但 checkout 未启用 | CTA 使用 Join waitlist / Get notified / Contact，不跳假 checkout |
| `checkout-enabled` | Stripe / 支付链路启用且合规 | 可展示 Upgrade / Buy Credits；必须满足 Stripe Tax / billing address / tax id / webhook 验收 |

### A.3 Runtime State Contract

```json
{
  "auth_state": "anonymous|signed-in|signed-in-free|signed-in-pro",
  "quota_state": "quota-unknown|quota-available|quota-exhausted",
  "provider_state": "provider-disabled|provider-preview|provider-live",
  "paid_state": "paid-disabled|checkout-disabled|checkout-enabled",
  "copy_prompt_enabled": true,
  "upload_enabled": true,
  "upload_mode": "preview|live",
  "generate_enabled": false,
  "generation_mode": "disabled|preview|live",
  "free_generation_available": false,
  "credits_balance": null,
  "monthly_quota_remaining": null,
  "provider_name": null,
  "provider_message": "Copy prompts are available. Upload-to-edit generation is currently in preview mode.",
  "pricing_message": "Prompt copying is free. Generation plans are available only when live generation is enabled.",
  "last_verified_at": "2026-06-10T00:00:00Z"
}
```

硬规则：

- `copy_prompt_enabled=true` 是默认产品公理；除非 prompt 被安全 / 版权 / abuse 下架。
- `generate_enabled=true` 只能在 `provider_state=provider-live` 且 auth / quota 满足时出现。
- `checkout-enabled` 不代表任何状态都能买生成；如果 provider 不是 live，生成套餐仍必须禁用或转 waitlist。
- provider error、network error、safety rejection、timeout 不得扣 credits。

### A.4 全局组件行为矩阵

| Product State | Header | Editor | Prompt card | Pricing CTA | Checkout | Copy Prompt | Upload | Generate |
|---|---|---|---|---|---|---|---|---|
| `anonymous + provider-disabled + paid-disabled` | Browse prompts / Sign in；Pricing 弱化 | Prompt preload + upload preview；显示 generation not live | Copy 主按钮；Open in Editor 可用 | Join waitlist | 不可用 | 可用 | preview | 不可用 |
| `anonymous + provider-preview + checkout-disabled` | Browse / Prompt Library / Sign in | 可上传、选 effect、预览流程；清楚标注 preview-only | Copy + Try in Editor | Join waitlist / Sign in | 不可用 | 可用 | preview | Preview only，不扣费 |
| `anonymous + provider-live + checkout-disabled` | Sign in 可见但不遮挡 prompt | 可上传；生成前要求登录或说明匿名限制 | Copy + Try in Editor | Sign in / Join Pro waitlist | 不可用 | 可用 | 可用 | 有条件可用 |
| `anonymous + provider-live + checkout-enabled` | Sign in / Pricing 可见但不抢首屏 | 可上传；生成前提示登录或匿名额度 | Copy + Try in Editor | Sign in / Upgrade after value | 登录后可用 | 可用 | 可用 | 有条件可用 |
| `signed-in + quota-unknown` | Account | Checking quota；不能生成 | Copy 可用 | 暂不高亮 | 暂不触发 | 可用 | 可用 | 不可用 |
| `signed-in-free + provider-disabled` | Account + Prompt Library | Preview / external guidance | Copy 主按钮 | Join waitlist | 不可用 | 可用 | preview | 不可用 |
| `signed-in-free + provider-preview` | Account + Prompt Library | Upload preview + waitlist | Copy + Try in Editor | Join waitlist | 不可用 | 可用 | preview | Preview only |
| `signed-in-free + provider-live + quota-available + checkout-disabled` | Account + Usage | Live editor；显示剩余额度 | Copy + Try in Editor | Join Pro waitlist | 不可用 | 可用 | 可用 | 可用，失败不扣额度 |
| `signed-in-free + provider-live + quota-available + checkout-enabled` | Account + Usage + Upgrade | Live editor；显示剩余免费额度 | Copy + Try in Editor | Upgrade to Pro | 可用 | 可用 | 可用 | 可用，成功扣免费额度 |
| `signed-in-free + quota-exhausted + provider-live + checkout-enabled` | Usage exhausted | 禁止免费生成；展示升级 / 买 credits / copy instead | Copy 仍为主 | Upgrade / Buy credits | 可用 | 可用 | 可用 | 不可用，直到 quota 恢复 |
| `signed-in-free + quota-exhausted + provider-live + checkout-disabled` | Usage exhausted | 展示 reset time / waitlist / copy instead | Copy 仍为主 | Join waitlist / Wait reset | 不可用 | 可用 | 可用 | 不可用 |
| `signed-in-pro + provider-disabled` | Account + Manage plan；显示 outage | Preview / outage notice | Copy + Try in Editor | Manage plan，不推新购买 | 不作主 CTA | 可用 | preview | 不可用 |
| `signed-in-pro + provider-preview` | Account + Manage plan | Preview / limited mode | Copy + Try in Editor | Manage plan | 不抢主 CTA | 可用 | preview | Preview only |
| `signed-in-pro + provider-live + quota-available` | Account + Usage + Manage plan | Live editor；显示 Pro quota | Copy + Try in Editor | Manage / Buy credits | 可用 | 可用 | 可用 | 可用 |
| `signed-in-pro + provider-live + quota-exhausted + checkout-enabled` | Usage exhausted | 阻止生成；展示 Buy credits / Wait reset | Copy 仍可用 | Buy credits / Manage plan | 可用 | 可用 | 可用 | 不可用，直到 credit / quota 恢复 |
| `checkout-enabled + provider-disabled` | Pricing 可访问但必须警示 | Editor 不生成 | Prompt card 不变 | Get notified when generation is live | 生成套餐不可 checkout | 可用 | preview | 不可用 |
| `paid-disabled` | 不强调 Pricing | 不显示付费解锁生成 | Prompt card 不变 | Waitlist / Contact only | 不可用 | 可用 | 按 provider state | 只按 provider + quota 判断，不因付费禁用影响 copy |

### A.5 Header 合同

Header 服务 prompt discovery，不服务 SaaS 销售。

必需入口：

- Prompt Library
- RSP Prompts
- Editor
- Pricing
- Sign in / Account

禁止：

- provider-disabled / paid-disabled 状态下显示 `Upgrade to Generate`。
- 把登录作为 Copy Prompt 前置条件。
- 暗示 Gemini / ChatGPT / RSP 官方合作。

### A.6 Editor 合同

Editor 是 `apply / copy workflow`，不是所有状态都真实生成。

必须支持：

- 从 card / detail 带入 `effect_slug` 与 `copy_prompt`。
- 上传后保留 selected prompt。
- 在生成按钮之前显示 provider state。
- provider-disabled / provider-preview 时保留 Copy Prompt 和 external-use guidance。
- provider-live 时提供 loading、success、error、quota-exhausted、auth-required、provider-unavailable。

按钮文案：

| 条件 | 主按钮文案 |
|---|---|
| provider-disabled | `Copy Prompt` / `Preview upload flow` / `Join waitlist` |
| provider-preview | `Preview edit flow` / `Use prompt externally` |
| provider-live + anonymous | `Sign in to generate` 或 `Generate free preview`（仅真实支持匿名额度时） |
| provider-live + signed-in-free + quota available | `Generate with free credit` |
| provider-live + signed-in-free + quota exhausted | `Upgrade to generate more` / `Buy credits` / `Copy Prompt instead` |
| provider-live + signed-in-pro + quota available | `Generate` |
| provider-live + signed-in-pro + quota exhausted | `Buy credits` / `Wait for quota reset` |

### A.7 Prompt Card 合同

每张 active prompt card 必须是可独立完成任务的最小单元。

必需字段 / 行为：

- 用户搜索语言命名的 title。
- before / after 或 sample preview。
- provider tags。
- prompt excerpt。
- best_for。
- avoid_if。
- variables to replace。
- Copy Prompt button：可见、可点击、无登录。
- Open / Try in Editor：带 slug / prompt。
- safety note。

### A.8 Pricing / Checkout 合同

Pricing 页面必须先说明：

- Copy Prompt 永久免费。
- Generation 取决于 provider availability。
- 不存在 unlimited generation。
- Provider failure 不扣 credits。

CTA 规则：

| 条件 | CTA |
|---|---|
| paid-disabled | Join waitlist / Contact us |
| checkout-disabled | Join Pro waitlist / Get notified |
| checkout-enabled + provider-disabled | Get notified when generation is live；不能卖生成套餐 |
| checkout-enabled + provider-preview | Join Pro waitlist；不能承诺 live generation |
| checkout-enabled + provider-live | Free / Pro / Business / Credit Pack 可展示；Pro / Credit 可 checkout；Business 首版 Contact only |

Stripe Checkout 启用时必须：

- `automatic_tax: { enabled: true }`
- `billing_address_collection: 'required'`
- `tax_id_collection: { enabled: true }`
- webhook 处理 checkout completed、subscription updated / canceled、payment failed、refund。
- 订单区分 subtotal / tax / total；tax 记 tax payable，不算收入。

---

## B. 首版范围收敛合同

AIE v1 不做“完整 AI 图片编辑 SaaS”。v1 只把一个链路做扎实：

**找同款效果 → 看示例 → 复制 prompt → 打开 editor → 理解 provider 状态 → 有条件生成。**

### B.1 v1 必做范围

#### 1. 首页 `/`

必须：

- H1 → short answer → editor / generator module 的垂直首屏。
- 不使用左右分栏 hero。
- 不使用泛 CTA 按钮组。
- 首屏附近展示 6-9 张 featured prompt cards。
- Featured cards 必须有 Copy Prompt 和 Open in Editor。
- Pricing 不进入首屏主叙事。

#### 2. Prompt Library `/prompt-library`

必须：

- 至少 60 条 active effect records。
- 至少 30 张 index-ready cards。
- 搜索：keyword / effect / provider / use case。
- 过滤：Boy、Girl、Couple、Festival、Bike、Cinematic、Double Exposure、3 Layer、IPL、Holi、Eid、Ram Navami、Instagram milestone、Personal、Social Creator、Ecommerce、Business、Utility。
- Provider 过滤：Gemini、ChatGPT、Nano Banana、Bing、CapCut、Lightroom、Generic AI editor。
- 排序：Trending、New、Festival、Most copied、Provider、Easy copy。

#### 3. RSP Hub `/rsp-editing-prompts`

必须：

- India-first RSP/social prompt hub。
- hub 与 linked detail 合计至少 20 张 RSP / India / social cards。
- hub 首屏至少 3 张真实卡片。
- updated date。
- unofficial disclaimer。
- boy / girl / couple / bike / cinematic / festival 入口。

#### 4. Editor `/ai-photo-prompt-editor`

必须：

- effect slug / prompt deep link。
- prompt import state。
- upload preview。
- provider state banner。
- Copy Prompt 独立可用。
- provider-disabled / preview / live 三态文案与按钮。
- provider-live 时才真实 Generate。
- auth-required / quota-exhausted / provider-error / network-error / safety-rejection 状态。

#### 5. Provider Cluster

v1 必做或明确 noindex 的 provider 页面：

- `/gemini-photo-editing-prompts`
- `/chatgpt-photo-editing-prompts`
- `/nano-banana-photo-editing-prompts`
- `/bing-image-creator-prompts`

每页必须：

- provider-specific intro。
- what works best。
- what to avoid。
- prompt cards。
- how to use uploaded photos。
- identity / product preservation caveats。
- no official-affiliation wording。
- FAQ。

#### 6. Core Use-case / Category Pages

v1 必做或明确 noindex：

- `/professional-headshot-prompts`
- `/linkedin-headshot-prompts`
- `/product-photo-prompts`
- `/youtube-thumbnail-prompts`
- `/instagram-photo-editing-prompts`
- `/background-swap-prompts`
- `/photo-enhance-prompts`
- `/couple-photo-editing-prompts`
- `/boy-ai-photo-editing-prompts`
- `/girl-ai-photo-editing-prompts`
- `/bike-ai-photo-editing-prompts`
- `/cinematic-ai-photo-editing-prompts`
- `/double-exposure-ai-photo-editing-prompts`

每页 index 条件：至少 3 张真实 prompt cards + unique intro + FAQ + internal links。

#### 7. Effect Detail `/prompts/[slug]`

可 index 的 detail 必须包含：

- unique prompt。
- before / after 或 sample preview。
- variables。
- best_for / avoid_if。
- provider notes。
- Copy Prompt。
- Open in Editor。
- related prompts。
- FAQ。
- updated date。
- unofficial disclaimer。
- schema。

`/effects/[slug]` 如果存在，只能作为 alias，必须 308 redirect 或 canonical，避免重复索引。

### B.2 v1 允许 noindex / waitlist

| 内容 | v1 状态 | 规则 |
|---|---|---|
| Festival pages: Holi / Eid / IPL / Ram Navami / Republic Day / Diwali | `index when ready`；不足则 noindex | 每页至少 3 张真实 cards + updated date + cultural safety note 才能 index |
| `/prompts/[slug]` 批量详情页 | 部分 index，部分 noindex | 缺 unique prompt / visual / FAQ / internal links 的 detail 必须 noindex |
| Pro generation | waitlist 或 checkout，取决于 provider-live | provider-disabled / preview 时不能真实售卖 |
| Credit Pack | waitlist，除非 checkout + provider-live + credit accounting 完成 | 不能提前展示 Buy credits checkout |
| Business / API | Contact / Waitlist only | 不承诺 seat、invoice、SLA、API、批量 checkout |
| Saved prompts / favorites | 仅登录和数据层完成后展示 | 未完成时放 future，不进 pricing 权益 |
| Recent edits history | future 或 hidden | 未完成不得作为 Pro 权益 |
| HD / no-watermark | 仅真实生成链路支持后展示 | 未实现不得售卖 |
| Batch product photo workflow | waitlist | 首版不做批处理工作台 |

### B.3 future / 不做首版

v1 不做：

- 完整 Photoshop / Canva / Pixlr 式在线编辑器。
- 时间线、图层、画笔、局部蒙版、专业修图套件。
- 社区 UGC 投稿、评论、排行榜。
- 大规模自动生成几百个薄 SEO 页面。
- 未经确认的品牌 / 名人 / 官方模板下载。
- 官方 Gemini / ChatGPT / RSP integration 声明。
- Business seat management、invoice billing、API SLA、团队权限。
- 任意 prompt marketplace 或付费模板交易。
- “unlimited generation”。

### B.4 Index / Noindex 决策表

| 页面类型 | Index 条件 | Noindex 条件 |
|---|---|---|
| Homepage | 有真实 card、copy/open action、editor state | 无 |
| RSP Hub | hub + linked details 至少 20 张 RSP/social cards，首屏 3 张卡 | 少于 3 张真实卡或全是占位 |
| Prompt Library | 至少 60 active records，核心过滤可用 | 只有 demo/mock 或重复内容 |
| Provider page | 至少 3 张 provider-specific cards + caveats + FAQ | 无 provider-specific 内容、误导官方关系、内容不足 |
| Use-case category | 至少 3 张真实卡 + unique intro + FAQ | 少于 3 张卡、薄页、重复页 |
| Festival page | 至少 3 张真实卡 + updated date + cultural safety note + 时机合理 | 非时令、素材不足、文化风险未处理 |
| Effect detail | unique prompt + visual/sample + variables + best_for/avoid_if + FAQ + related links | 重复 prompt、无视觉、placeholder、版权/名人风险 |
| Pricing | 可 index，但不得误导可购状态 | 若全站 paid-disabled 且页面只有 waitlist，可 noindex 直到合同完整 |

---

## C. 产品验收任务

### C.1 Product Acceptance 必测链路

1. 匿名用户进入首页，5 秒内知道这里可以找 / 复制 / 应用 AI photo editing prompts。
2. 匿名用户从首页 card 复制 prompt，无需登录。
3. 匿名用户打开 `/prompt-library`，按 category/provider 过滤并复制 prompt。
4. 匿名用户打开 effect detail，看到 before/after 或 sample、prompt、variables、best_for、avoid_if、provider notes。
5. 匿名用户从 card/detail 打开 editor，prompt 与 effect slug 保留。
6. provider-disabled 时，editor 不出现假 Generate now；Copy Prompt 继续可用。
7. provider-preview 时，upload preview 可用，不扣 credits，文案清楚说明 preview-only。
8. provider-live + signed-in-free + quota available 时，可以生成，失败不扣 credits。
9. quota-exhausted 时，Generate 不调用 provider，展示 Upgrade / Buy credits / Copy Prompt instead。
10. checkout-disabled 时，所有购买 CTA 都是 waitlist / notify / contact，不跳假 checkout。
11. checkout-enabled 时，Stripe Tax / billing / tax id / webhook 证据齐全。
12. 移动端 390px / 430px 视口重复 Copy Prompt、Open in Editor、Upload、Quota 状态。

### C.2 PM Verdict JSON

```json
{
  "pm_verdict": "PM_GO | PM_CONDITIONAL_GO | PM_NO_GO",
  "competitive_minimum_verdict": "pass | fail | partial",
  "core_tool_ux_verdict": "pass | fail | partial",
  "conversion_path_verdict": "pass | fail | partial",
  "verified_user_tasks": [
    "find effect",
    "view before/after or sample",
    "copy prompt",
    "open/apply in editor",
    "upload preview",
    "provider state clear",
    "quota state clear",
    "checkout state honest"
  ],
  "verified_tool_states": [
    "anonymous",
    "signed-in-free",
    "signed-in-pro",
    "quota-exhausted",
    "provider-disabled",
    "provider-preview",
    "provider-live",
    "checkout-disabled",
    "paid-disabled",
    "loading",
    "result",
    "error"
  ],
  "scope_gaps": [],
  "blocker_count": 0,
  "next_gate": "motest_qa"
}
```

---

## D. 下游执行边界

### D.1 设计不得自行决定

- 哪些状态可以 Generate。
- provider-disabled 时按钮怎么写。
- Pricing 是否能 checkout。
- Copy Prompt 是否需要登录。
- 哪些页面 index / noindex。
- Business 是否展示真实付费入口。

### D.2 前端不得自行决定

- auth / quota / provider / paid / checkout 状态组合。
- route alias / redirect / canonical。
- placeholder 页面是否进 sitemap。
- failed generation 是否扣 credit。
- provider-preview 是否伪装成 live generation。

### D.3 后端不得自行决定

- paid-enabled 与 checkout-enabled 的销售文案。
- provider error 的扣费规则。
- Business/API 是否真实可购买。
- Stripe Tax 是否后补。

### D.4 SEO 不得自行决定

- 薄页是否进入 sitemap。
- 重复 detail 是否 index。
- provider / RSP 是否使用官方关系暗示。
- 没有真实 prompt card 的 category 是否 index。

---

## E. 合并建议

本补丁建议合并进中文 PRD v4 的以下位置：

1. 在“Provider 与信任合同”之后新增：`产品状态主合同`。
2. 将原 PRD 中“Pricing Contract 状态合同”替换为本补丁 A.4 / A.8 的状态矩阵和 CTA 规则。
3. 在“信息架构与 Route Contract”后新增：`首版范围收敛合同`。
4. 在“Product Acceptance / QA”中追加 C.1 与 C.2。
5. 在“给下游的交接摘要”中追加 D.1-D.4，作为设计 / 前端 / 后端 / SEO 的不可自行决策边界。