ai-paas-comparison/docs/01-PRD-产品需求文档.md

AI PaaS 商业平台 — 产品需求文档 (PRD)

版本: 2.0 | 日期: 2026-06-27 状态: 已修订（基于用户反馈）

---

1. 产品概述

一句话描述

让任何 AI 使用者都能像用水电一样使用 AI 能力，注册即用，按量付费。

产品定位

AI PaaS 商业平台是一个 AI 能力的"水电煤"基础设施。用户注册后即可使用平台提供的各种 AI 能力（LLM 对话、Agent 工作流、MCP 工具链、Skills 技能），所有能力按 Token/调用次数计费，用多少付多少。

核心价值主张

• 注册即用: 无需自建模型、无需部署服务，注册账号即可调用 7+ 个 LLM 平台的能力
• 按量付费: 用多少 Token 付多少钱，零浪费
• 能力市场: 浏览、购买、使用其他开发者发布的 AI 技能
• 开放生态: 开发者可以发布自己的 AI 能力/技能到市场，获得分成收入

目标用户

• AI 使用者: 个人开发者、独立开发者、技术爱好者 — 需要便捷的 AI 能力调用
• AI 开发者: 能力/技能的创作者 — 需要分发渠道和变现途径

不区分企业和个人，不区分租户概念，只有一个用户角色。

---

2. 用户模型

2.1 扁平化用户体系（v2.0 核心调整）

用户注册 → 实名认证 → 基础用户
用户订阅 → 订阅用户（自动获得能力创建/发布权限）

原则：只有一个用户角色，无租户概念。

2.2 用户状态机

注册 → 未认证（仅使用基础 LLM 调用）
     → 实名认证通过 → 认证用户
     → 订阅月费 → 订阅用户（解锁能力创建/发布）
     → 欠费 → 保留已发布能力，限制新创建

2.3 权限矩阵

功能	未认证用户	认证用户	订阅用户	欠费用户
LLM 对话调用	✅ 基础额度	✅ 标准额度	✅ 扩展额度	✅ 基础额度
使用 Skills 技能	✅	✅	✅	✅
购买 Skills 技能	✅	✅	✅	✅
创建 AI 能力	❌	❌	✅	❌（新建）
发布 AI 能力到市场	❌	❌	✅	❌（新建）
已发布能力保持在线	—	—	✅	✅ 不受影响
获取分成收入	❌	❌	✅	✅（已有余额）

核心规则：欠费后，已发布的 AI 应用保持在线不被下架。这是对开发者的承诺。

---

3. 用户认证流程

3.1 注册与登录

注册方式

1. 手机号 + 短信验证码（主推，短信宝 SMS Bao 接口）
2. 邮箱 + 密码（备用）
3. 第三方登录: 微信扫码（通过 Casdoor SSO 对接）

登录方式

1. 手机号 + 短信验证码
2. 邮箱 + 密码
3. 微信扫码
4. API Key（程序化调用，无需登录态）

短信服务

• 服务商: 短信宝 (SMS Bao)
• 接口: https://api.smsbao.com/sms (GET)
• 验证码: 6 位数字，5 分钟有效
• 频率限制: 同号码 60 秒 1 条，每天 10 条
• 签名格式: 【QihuAI】您的验证码是123456...
• 详细集成文档: docs/smsbao-integration.md

3.2 实名认证（阿里云接口）

用户需要完成实名认证才能发布能力。对接阿里云实名认证 API：

用户提交: 真实姓名 + 身份证号
→ 调用阿里云实名认证接口
→ 验证通过 → 标记为「已认证」
→ 验证失败 → 提示原因，可重试

认证层级：

等级	要求	权限
L0 - 未认证	仅注册	基础 LLM 调用（每日限次）
L1 - 已实名	通过阿里云实名认证	标准 LLM 调用 + 使用/购买 Skills
L2 - 订阅用户	L1 + 支付月费	创建/发布 AI 能力 + 获得分成

3.3 SSO 单点登录（Casdoor）

使用 Casdoor 开源项目作为统一认证中心：

• 支持 OAuth2 / OIDC / SAML
• 可对接微信、钉钉、飞书等社交登录
• 提供统一的用户管理和 Token 签发
• 可独立部署，也可嵌入现有系统

---

4. 订阅与计费

4.1 订阅套餐

套餐	月费	包含额度	能力创建	发布能力	分成比例
免费	0	每日 50 次 LLM 调用	❌	❌	—
开发者	¥29/月	每月 50 万 Token	✅ 3 个	✅	70%
专业版	¥99/月	每月 200 万 Token	✅ 10 个	✅	75%
旗舰版	¥299/月	每月 1000 万 Token	✅ 无限制	✅	80%

4.2 Token 包（按量加购）

订阅额度用完后，可购买 Token 包：

• ¥10 = 10 万 Token
• ¥50 = 60 万 Token（送 10 万）
• ¥100 = 130 万 Token（送 30 万）

4.3 欠费处理

订阅到期 / 余额为 0
→ 进入「欠费保护期」（7 天）
→ 保护期内：已发布能力保持在线，但不能新建/修改
→ 保护期后：已发布能力转为「暂停」（数据保留，恢复订阅即可重新上线）
→ 续费后：已发布能力自动恢复

4.4 分成结算

• 平台抽成: 20%-30%（根据订阅等级）
• 开发者分成: 70%-80%
• 结算周期: 月结
• 最低提现: ¥100
• 提现方式: 支付宝 / 银行卡

---

5. 功能模块

5.1 LLM 对话能力

• 预置 7+ 个 LLM 平台接入（NEW API 统一管理）
• 支持 DeepSeek、千问、豆包、智谱、元宝、百度文心、Ollama 本地模型
• OpenAI 兼容 API 格式
• 流式/非流式响应
• 模型切换、参数调节

5.2 Skills 技能市场

• 浏览、搜索、购买 AI 技能
• 技能详情页（描述、价格、评分、使用量）
• 一键调用（平台内集成）
• 开发者发布技能（订阅用户权限）
• 技能审核流程

5.3 Agent 工作流

• 可视化 Agent 编排（基于开源方案）
• 预置常用 Agent 模板
• 支持自定义工具链

5.4 MCP 工具链

• MCP Server 注册与管理
• MCP 工具市场
• 工具组合调用

5.5 IM Bot

• 微信/QQ/钉钉/飞书 多平台对接
• 会话管理与上下文记忆
• 多模型切换

---

6. 非功能需求

6.1 性能

• LLM 首 token 延迟 < 500ms
• API 平均响应 < 200ms
• 并发支持 1000+ 用户

6.2 安全

• 用户密码 bcrypt 加密
• API Key SHA-256 哈希存储
• 实名信息 AES-256 加密存储
• HTTPS 全站加密
• RBAC 权限控制

6.3 可用性

• 系统可用性 > 99.9%
• 数据库主从备份
• 关键操作幂等
• 欠费不影响已发布能力

---

7. 开源选型原则（v2.0 新增）

7.1 选型优先级

1. 社区活跃度（GitHub Stars、Contributors、Release 频率）
2. AI 生态兼容性（能否无缝对接主流 AI 框架）
3. 技术先进性（语言、架构是否符合当前趋势）
4. 标准化程度（是否遵循行业标准/协议）
5. 功能完备性（是否开箱即用）
6. 许可证（是否允许商用）

7.2 核心开源组件预置

组件	选型	理由
LLM 网关	NEW API (songquanpeng/one-api)	14k+ Stars，OpenAI 兼容，多模型管理，开箱即用
SSO 认证	Casdoor (casdoor/casdoor)	10k+ Stars，OAuth2/OIDC，多社交登录，管理界面完善
实名认证	阿里云实名认证 API	国内最权威，接口稳定，成本低
AI 服务框架	FastAPI (tiangolo/fastapi)	79k+ Stars，异步高性能，AI 生态标准框架
本地 LLM	Ollama (ollama/ollama)	130k+ Stars，本地部署标准，模型生态丰富
Agent 编排	LangFlow (langflow-ai/langflow)	可视化工作流，LangChain 生态
MCP 管理	mcp-hub	MCP 标准协议管理

---

文档结束