qyyfw
a9e141b695
- 新增 docs/smsbao-integration.md（完整集成文档+代码示例） - 更新 PRD：注册/登录使用短信宝发送验证码 - 更新架构设计：技术栈+选型矩阵+配置说明 - 更新 API 规范：新增 /send-code 接口 - 更新 AGENTS.md：短信服务配置说明 短信宝 API: - 发送: GET https://api.smsbao.com/sms?u=&p=&m=&c= - 查询: GET http://api.smsbao.com/query?u=&p= - 签名格式: 【QihuAI】您的验证码是123456
243 lines
7.5 KiB
Markdown
243 lines
7.5 KiB
Markdown
# 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 标准协议管理 |
|
||
|
||
---
|
||
|
||
*文档结束*
|