---
name: 同步更新三个项目文档
overview: 同步更新 README.md、接口文档.md、Stitch.md，反映本轮代码变更（广告激励配置开关+服务端定价、退款管理员操作、会员类型推导、iOS 退款问询细化等），并在 Stitch.md 额度商城页补充「看广告得额度」入口 UI。
todos:
  - id: update-readme
    content: 更新 README.md 的 AdReward 配置段、错误码 80004、退款管理员操作与广告激励接口描述
    status: completed
  - id: update-api-doc
    content: 更新接口文档.md 的广告激励参数与错误码、订单状态机、会员类型推导说明
    status: completed
  - id: update-stitch
    content: 更新 Stitch.md 在额度商城页补充「看广告得额度」入口 UI 描述
    status: completed
---

## 用户需求

将 README.md、接口文档.md、Stitch.md 三个文档同步更新至最近一轮后端代码修复后的最新状态。

## 核心变更点（需映射到文档）

1. 广告激励：新增 `AdReward` 配置段（`Enable` 开关 + `Cos`/`AI`/`OutfitShare`/`ClosetShare` 各类型固定金额）；`/ad-reward/grant` 请求移除 `amount`，仅传 `reward_type` 与 `ref_id`；金额由服务端配置固定；新增错误码 `80004 广告激励未开启`。
2. 退款管理员操作：订单「已取消但已付款」由「自动调微信退款」改为「生成待审核退款单，管理员后台手动退款」；退款成功回调兼容「已取消」订单流转且跳过权益回收。
3. XPay 退款反查：退款推送回退权益前反查微信侧退款真实性。
4. 会员类型推导：`vip_type` 按续费后最终到期时长推导（剩余不低于 365 天为年度，否则月度），体验会员保持不变。
5. iOS 退款问询：按权益消耗情况细化拒绝。
6. 上传接口：解析 multipart 前限制请求体大小。

## 更新范围

- README.md：配置说明表新增 `AdReward` 段；业务流程第 5 条退款描述；错误码段位表补 `80004`；API 概览广告激励行；额度体系措辞。
- 接口文档.md：`/ad-reward/grant` 参数表删除 `amount` 并补业务逻辑与 `80004`；额度模块引言；微信回调竞态兜底描述；订单状态机 mermaid；会员类型推导规则；错误码全表补 `80004`；版本号与日期。
- Stitch.md：在「额度与会员商城」页的「我的额度」卡片后补充「看广告得额度」入口 UI 描述（含开关控制、服务端定价、加载/失败态），严格沿用既有 iOS HIG 与 SF Symbols 风格。