套餐与订阅
套餐与订阅
v12 更新：本模块进行了全面升级，主要变更如下：
- 双维度数据隔离：同时按租户和用户维度隔离数据，确保多租户场景下的数据安全
- 代理商树结构：支持无限级物化路径，灵活构建代理层级关系
- 多级佣金自动计算：支付成功后自动触发多级佣金计算，无需人工介入
- 支付→订阅自动激活：支付完成后自动激活订阅，无缝衔接下单到生效
- 平台全局视角查询：超管可通过全局视角查看所有租户的计费与代理数据
欣悦互通提供多种套餐方案，覆盖从个人试用到企业级大规模使用的不同需求。通过套餐与订阅管理，您可以查看方案、选择套餐、管理订阅状态并监控配额使用。
本分类将围绕计费与代理商体系展开，涵盖套餐订阅、订单发票、配额预警、代理商、佣金、集成和常见问题七方面内容。
学习路径
建议按以下顺序阅读，每篇约 2-3 分钟。
1. 套餐与订阅
查看套餐方案、管理订阅状态、检查配额，并通过数据看板了解整体使用情况。
- 文档：套餐与订阅（本页）
2. 订单与发票
查看订单记录，管理支付方式和发票，生成周报与竞品报告。
- 文档：订单与发票
3. 配额与用量预警
监控 API 配额使用情况，设置用量预警避免超额。
- 文档：配额与用量预警
4. 代理商入驻
成为欣悦互通代理商，创建推广链接和发展下级代理。
- 文档：代理商入驻
5. 佣金规则与提现
配置多级佣金规则，查看佣金流水和提现记录。
- 文档：佣金规则与提现
6. 集成：Webhook 与 WebSocket
配置 Webhook 接收事件通知，使用 WebSocket 实时通信，集成 RAG 知识库。
7. 常见问题 FAQ
汇总账号、计费、功能和集成方面的常见问题解答。
- 文档：常见问题 FAQ
套餐方案浏览
- 进入「计费中心 → 套餐方案」查看所有可用套餐。
- 列表展示套餐名称、功能范围、价格、配额限制。
- 点击套餐卡片可查看详细功能对比。
套餐方案通过 GET /api/billing/plans 获取，常见套餐类型包括：
- 免费版：试用功能，配额有限
- 基础版：适合个人或小团队
- 专业版：适合中型企业，功能完整
- 企业版：适合大型企业，支持定制和专属服务
!TIP 套餐功能范围受版本体系控制，具体可用功能以实际套餐详情为准。升级套餐后新功能立即生效。
订阅管理
查看订阅
- 进入「计费中心 → 我的订阅」查看当前订阅状态。
- 展示套餐名称、生效时间、到期时间、当前状态（试用中/生效中/已过期/已暂停）。
- 可查看历史订阅记录。
订阅列表通过 GET /api/billing/subscriptions 获取。
订阅状态转换
订阅支持以下状态转换：
- 试用中 → 生效中（支付首笔订单）
- 生效中 → 已暂停（欠费或主动暂停）
- 已暂停 → 生效中（补缴或恢复）
- 生效中 → 已过期（到期未续费）
- 已过期 → 生效中（续费）
状态转换通过 POST /api/billing/transition-subscription 触发，系统会自动校验前置状态是否合法。
!WARNING 订阅过期后，所有 API 调用将被拒绝，但数据会保留 30 天。请在 30 天内续费，否则数据可能被清理。
配额检查
- 在订阅详情页可查看当前配额使用情况。
- 展示各资源的已用量/总量，如：AI Token 数、API 调用次数、存储空间、项目数量。
- 接近上限时会以黄色或红色高亮提示。
配额检查通过 GET /api/billing/check-quota 实时查询。所有 API 调用前会自动经过配额拦截（QuotaGuard），超额调用将返回 403 Forbidden。
过期订阅检查
系统每天自动执行过期订阅检查（POST /api/billing/check-expired），对即将到期（7 天内）和已过期的订阅执行：
- 到期前 7 天：发送续费提醒通知
- 到期前 3 天：再次提醒
- 到期当天：暂停 API 访问，保留数据
- 过期 30 天：清理数据并归档
!NOTE 过期订阅检查由后台 Worker 自动执行，无需人工干预。如需调整提醒策略，联系平台管理员。
数据看板概览
数据看板提供各维度使用情况的实时统计，帮助您全面了解账号运营状态。
- 进入「数据中心 → 综合看板」查看整体概览。
- 切换不同维度查看详细指标：
- SEO 指标（
GET /api/dashboard/seo）：排名变化、收录情况 - GEO 指标（
GET /api/dashboard/geo）：AI 搜索可见度、品牌提及 - AEO 指标（
GET /api/dashboard/aeo）：PAA 覆盖、FAQ 命中 - AIO 指标（
GET /api/dashboard/aio）：事实一致性、可信度 - AAO 指标（
GET /api/dashboard/aao）：Agent 运行次数、工作流执行
- SEO 指标（
综合看板通过 GET /api/dashboard 获取汇总数据。
!TIP 看板数据每 5 分钟刷新一次。如需实时数据，可在看板右上角点击「刷新」按钮手动更新。