# 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. **手机号 + 验证码**（主推）
2. **邮箱 + 密码**（备用）
3. **第三方登录**: 微信扫码（通过 Casdoor SSO 对接）

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

### 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 标准协议管理 |

---

*文档结束*