docs: v2.0 全面修订 — 开源优先 + 扁平化用户模型
核心变更: - 产品定位: '像用水电一样使用AI能力,注册即用,按量付费' - 用户模型: 去掉租户概念,扁平化为 订阅用户/非订阅用户 - 认证: Casdoor SSO + 阿里云实名认证(替代 Keycloak) - LLM 网关: NEW API 开源(替代自研 Go 网关) - AI 服务: FastAPI(替代 Go 自研,AI 生态更兼容) - 新增: 欠费不影响已发布能力(核心商业规则) - 新增: 开发者提现模块 - 开发周期: 20周 → 15周(开源组件复用) 文档列表: - 01-PRD-产品需求文档.md (v2.0) - 02-系统架构设计.md (v2.0) - 03-数据库设计.md (v2.0) - 04-API接口规范.md (v2.0) - 05-AGENTS-MiMoCode配置.md (v2.0)
This commit is contained in:
1 parent
d9a8a0e93c
commit
8209f15d0a
5 files changed
+1031
-1433
No files matched your search
+194
-405
@@ -1,444 +1,233 @@
|
||||
# AI PaaS 商业平台 — 产品需求文档(PRD)
|
||||
# AI PaaS 商业平台 — 产品需求文档 (PRD)
|
||||
|
||||
> 版本: 1.0 | 日期: 2026-06-27
|
||||
> 产品名: **AIPaaS**(AI能力服务平台)
|
||||
> 目标用户: 个人开发者 / AI 爱好者 / 小型团队
|
||||
> 版本: 2.0 | 日期: 2026-06-27
|
||||
> 状态: 已修订(基于用户反馈)
|
||||
|
||||
---
|
||||
|
||||
## 1. 产品定位
|
||||
## 1. 产品概述
|
||||
|
||||
**一句话描述**: 让任何开发者都能像用水电一样使用 AI 能力——注册即用,按量付费。
|
||||
### 一句话描述
|
||||
> **让任何 AI 使用者都能像用水电一样使用 AI 能力,注册即用,按量付费。**
|
||||
|
||||
**核心价值**:
|
||||
- **统一入口**: Agent、MCP、Skills、IM Bot、LLM 调用,一个平台全搞定
|
||||
- **按需付费**: 不买服务器,不养团队,按 Token 用量付费
|
||||
- **能力交易**: 开发者发布 AI 技能,用户购买使用,平台促成交易
|
||||
- **多平台接入**: 一个 API Key 调用 DeepSeek/千问/豆包/百度/元宝/智谱
|
||||
### 产品定位
|
||||
AI PaaS 商业平台是一个 **AI 能力的"水电煤"基础设施**。用户注册后即可使用平台提供的各种 AI 能力(LLM 对话、Agent 工作流、MCP 工具链、Skills 技能),所有能力按 Token/调用次数计费,用多少付多少。
|
||||
|
||||
### 核心价值主张
|
||||
- **注册即用**: 无需自建模型、无需部署服务,注册账号即可调用 7+ 个 LLM 平台的能力
|
||||
- **按量付费**: 用多少 Token 付多少钱,零浪费
|
||||
- **能力市场**: 浏览、购买、使用其他开发者发布的 AI 技能
|
||||
- **开放生态**: 开发者可以发布自己的 AI 能力/技能到市场,获得分成收入
|
||||
|
||||
### 目标用户
|
||||
- **AI 使用者**: 个人开发者、独立开发者、技术爱好者 — 需要便捷的 AI 能力调用
|
||||
- **AI 开发者**: 能力/技能的创作者 — 需要分发渠道和变现途径
|
||||
|
||||
**不区分企业和个人,不区分租户概念,只有一个用户角色。**
|
||||
|
||||
---
|
||||
|
||||
## 2. 用户角色
|
||||
## 2. 用户模型
|
||||
|
||||
| 角色 | 说明 | 典型操作 |
|
||||
|------|------|---------|
|
||||
| **平台管理员** | 平台运营者 | 审核能力、管理用户、配置系统、查看收入 |
|
||||
| **租户(开发者)** | 注册开发者,创建和发布 AI 能力 | 创建 Agent、发布 Skill、管理 API Key、查看用量 |
|
||||
| **终端用户** | 使用 AI 能力的最终用户 | 调用 API、购买 Skill、通过 IM Bot 对话 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 功能模块
|
||||
|
||||
### 3.1 用户认证与多租户(Auth)
|
||||
|
||||
#### 3.1.1 注册/登录
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 邮箱注册 | 邮箱 + 密码注册,发送验证邮件 | P0 |
|
||||
| GitHub OAuth | 第三方登录 | P1 |
|
||||
| 微信扫码登录 | 第三方登录 | P2 |
|
||||
| 登录 | 邮箱 + 密码,返回 JWT | P0 |
|
||||
| Token 刷新 | Access Token 过期后用 Refresh Token 续期 | P0 |
|
||||
| 忘记密码 | 邮箱重置密码 | P0 |
|
||||
|
||||
#### 3.1.2 多租户
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 租户隔离 | 每个用户/团队是独立租户,数据严格隔离 | P0 |
|
||||
| 角色体系 | owner / admin / developer / user 四级角色 | P0 |
|
||||
| 团队管理 | 邀请成员、分配角色(Phase 2) | P1 |
|
||||
|
||||
#### 3.1.3 API Key 管理
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 创建 Key | 用户创建 API Key,用于程序化调用 | P0 |
|
||||
| 删除 Key | 可随时删除,立即失效 | P0 |
|
||||
| Key 列表 | 查看所有 Key 的创建时间、最后使用时间 | P0 |
|
||||
| 用途标识 | 给每个 Key 标记用途(如"我的应用") | P1 |
|
||||
|
||||
---
|
||||
|
||||
### 3.2 LLM 智能路由(LLM Router)
|
||||
|
||||
#### 3.2.1 多平台对接
|
||||
|
||||
| 平台 | 协议 | 模型列表 | 优先级 |
|
||||
|------|------|---------|--------|
|
||||
| DeepSeek | OpenAI 兼容 | deepseek-chat, deepseek-reasoner | P0 |
|
||||
| 千问(阿里云) | OpenAI 兼容 | qwen-turbo, qwen-plus, qwen-max | P0 |
|
||||
| 豆包(字节) | OpenAI 兼容 | doubao-pro, doubao-lite | P0 |
|
||||
| 智谱 GLM | OpenAI 兼容 | glm-4, glm-4-flash | P0 |
|
||||
| 元宝(腾讯) | OpenAI 兼容 | yuanbao-pro, yuanbao-lite | P1 |
|
||||
| 百度文心 | 自定义(需适配层) | ernie-4.0, ernie-3.5 | P1 |
|
||||
| 本地 Ollama | OpenAI 兼容 | 用户自定义 | P1 |
|
||||
|
||||
#### 3.2.2 智能路由
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 用户选择 | 用户指定使用哪个平台/模型 | P0 |
|
||||
| 成本优先 | 自动选择当前最便宜的模型 | P1 |
|
||||
| 延迟优先 | 自动选择响应最快的模型 | P1 |
|
||||
| 故障转移 | 主模型不可用时自动切换备用模型 | P0 |
|
||||
| 负载均衡 | 同一模型多个 API Key 时轮询 | P2 |
|
||||
|
||||
#### 3.2.3 调用方式
|
||||
### 2.1 扁平化用户体系(v2.0 核心调整)
|
||||
|
||||
```
|
||||
POST /v1/chat/completions ← OpenAI 兼容格式,用户直接用
|
||||
GET /v1/models ← 可用模型列表
|
||||
POST /v1/embeddings ← 向量嵌入(Phase 2)
|
||||
用户注册 → 实名认证 → 基础用户
|
||||
用户订阅 → 订阅用户(自动获得能力创建/发布权限)
|
||||
```
|
||||
|
||||
**原则:只有一个用户角色,无租户概念。**
|
||||
|
||||
### 2.2 用户状态机
|
||||
|
||||
```
|
||||
注册 → 未认证(仅使用基础 LLM 调用)
|
||||
→ 实名认证通过 → 认证用户
|
||||
→ 订阅月费 → 订阅用户(解锁能力创建/发布)
|
||||
→ 欠费 → 保留已发布能力,限制新创建
|
||||
```
|
||||
|
||||
### 2.3 权限矩阵
|
||||
|
||||
| 功能 | 未认证用户 | 认证用户 | 订阅用户 | 欠费用户 |
|
||||
|------|----------|---------|---------|---------|
|
||||
| LLM 对话调用 | ✅ 基础额度 | ✅ 标准额度 | ✅ 扩展额度 | ✅ 基础额度 |
|
||||
| 使用 Skills 技能 | ✅ | ✅ | ✅ | ✅ |
|
||||
| 购买 Skills 技能 | ✅ | ✅ | ✅ | ✅ |
|
||||
| 创建 AI 能力 | ❌ | ❌ | ✅ | ❌(新建) |
|
||||
| 发布 AI 能力到市场 | ❌ | ❌ | ✅ | ❌(新建) |
|
||||
| **已发布能力保持在线** | — | — | ✅ | **✅ 不受影响** |
|
||||
| 获取分成收入 | ❌ | ❌ | ✅ | ✅(已有余额) |
|
||||
|
||||
> **核心规则:欠费后,已发布的 AI 应用保持在线不被下架。这是对开发者的承诺。**
|
||||
|
||||
---
|
||||
|
||||
### 3.3 计费系统(Billing)
|
||||
## 3. 用户认证流程
|
||||
|
||||
#### 3.3.1 Credit 模型
|
||||
### 3.1 注册与登录
|
||||
|
||||
| 概念 | 说明 |
|
||||
|------|------|
|
||||
| **Credit** | 内部统一计费单位,1 Credit = 1000 tokens |
|
||||
| **模型系数** | 不同模型消耗不同: deepseek-chat=1.0, deepseek-reasoner=2.0, doubao-pro=1.5 |
|
||||
| **余额** | 租户 Credit 余额,先扣后服 |
|
||||
| **充值** | 支持手动充值(支付宝/微信支付) |
|
||||
| **订阅** | 每月固定 Credit 额度,超出按量计费 |
|
||||
#### 注册方式
|
||||
1. **手机号 + 验证码**(主推)
|
||||
2. **邮箱 + 密码**(备用)
|
||||
3. **第三方登录**: 微信扫码(通过 Casdoor SSO 对接)
|
||||
|
||||
#### 3.3.2 订阅套餐
|
||||
#### 登录方式
|
||||
1. 手机号 + 验证码
|
||||
2. 邮箱 + 密码
|
||||
3. 微信扫码
|
||||
4. API Key(程序化调用,无需登录态)
|
||||
|
||||
| 套餐 | 月费 | 包含 Credits | 超出价格 | QPS 限制 |
|
||||
|------|------|-------------|---------|---------|
|
||||
| **Free** | ¥0 | 100 | 不允许超出 | 2 |
|
||||
| **Pro** | ¥99 | 50,000 | ¥0.01/Credit | 20 |
|
||||
| **Team** | ¥499 | 300,000 | ¥0.008/Credit | 100 |
|
||||
| **Enterprise** | 定制 | 定制 | 定制 | 定制 |
|
||||
### 3.2 实名认证(阿里云接口)
|
||||
|
||||
#### 3.3.3 计费流程
|
||||
用户需要完成实名认证才能发布能力。对接阿里云实名认证 API:
|
||||
|
||||
```
|
||||
用户调用 API
|
||||
↓
|
||||
1. API Key 验证 → 提取 tenant_id
|
||||
↓
|
||||
2. 余额检查 → 余额不足返回 402
|
||||
↓
|
||||
3. 预扣费(预留最大可能消耗)
|
||||
↓
|
||||
4. 调用 LLM Router → 获取实际消耗
|
||||
↓
|
||||
5. 结算(实际消耗 vs 预扣,多退少补)
|
||||
↓
|
||||
6. 记录流水(不可变审计日志)
|
||||
↓
|
||||
7. 返回结果 + 用量信息
|
||||
用户提交: 真实姓名 + 身份证号
|
||||
→ 调用阿里云实名认证接口
|
||||
→ 验证通过 → 标记为「已认证」
|
||||
→ 验证失败 → 提示原因,可重试
|
||||
```
|
||||
|
||||
#### 3.3.4 核心原则
|
||||
|
||||
| 原则 | 说明 |
|
||||
|------|------|
|
||||
| **先扣后服** | 先扣减余额,再允许调用,绝不允许"调用成功但余额为负" |
|
||||
| **幂等** | 同一请求多次重试,绝不重复扣费 |
|
||||
| **原子** | Redis Lua 脚本保证扣费操作原子性 |
|
||||
| **可审计** | 每笔 Credit 变动都有 trace_id + 原因 |
|
||||
| **实时可见** | Dashboard 上余额和用量秒级更新 |
|
||||
|
||||
---
|
||||
|
||||
### 3.4 能力注册中心(Capability Registry)
|
||||
|
||||
#### 3.4.1 能力类型
|
||||
|
||||
| 类型 | 说明 | 示例 |
|
||||
**认证层级:**
|
||||
| 等级 | 要求 | 权限 |
|
||||
|------|------|------|
|
||||
| **agent** | AI 智能体 | 客服机器人、代码助手、翻译器 |
|
||||
| **mcp** | MCP 协议服务 | 文件操作、数据库查询、API 调用 |
|
||||
| **skill** | 可交易技能 | 文案生成、图片分析、数据分析 |
|
||||
| **llm** | LLM 提供商 | DeepSeek、千问、豆包 |
|
||||
| **custom** | 自定义 OpenAPI 应用 | 用户自己的 API 服务 |
|
||||
| L0 - 未认证 | 仅注册 | 基础 LLM 调用(每日限次) |
|
||||
| L1 - 已实名 | 通过阿里云实名认证 | 标准 LLM 调用 + 使用/购买 Skills |
|
||||
| L2 - 订阅用户 | L1 + 支付月费 | 创建/发布 AI 能力 + 获得分成 |
|
||||
|
||||
#### 3.4.2 能力生命周期
|
||||
### 3.3 SSO 单点登录(Casdoor)
|
||||
|
||||
```
|
||||
draft (草稿) → pending_review (待审核) → active (活跃) → deprecated (弃用)
|
||||
↘ rejected (拒绝)
|
||||
```
|
||||
|
||||
#### 3.4.3 能力元数据
|
||||
|
||||
```yaml
|
||||
name: "智能客服 Agent"
|
||||
type: agent
|
||||
version: "1.2.0"
|
||||
description: "基于 GPT-4 的智能客服,支持多轮对话和知识库检索"
|
||||
tags: [客服, 多轮对话, 知识库]
|
||||
endpoint: "https://my-agent.example.com/api"
|
||||
protocol: rest
|
||||
pricing:
|
||||
model: per_token
|
||||
rate: 2 # 每 1000 tokens 消耗 2 Credits
|
||||
dependencies:
|
||||
- capability_id: "milvus-rag"
|
||||
version: ">=1.0.0"
|
||||
status: active
|
||||
```
|
||||
使用 Casdoor 开源项目作为统一认证中心:
|
||||
- 支持 OAuth2 / OIDC / SAML
|
||||
- 可对接微信、钉钉、飞书等社交登录
|
||||
- 提供统一的用户管理和 Token 签发
|
||||
- 可独立部署,也可嵌入现有系统
|
||||
|
||||
---
|
||||
|
||||
### 3.5 Skills 市场
|
||||
## 4. 订阅与计费
|
||||
|
||||
#### 3.5.1 核心功能
|
||||
### 4.1 订阅套餐
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 发布技能 | 开发者上传技能,填写描述、定价、示例 | P0 |
|
||||
| 浏览市场 | 按分类、标签、评分、热度浏览 | P0 |
|
||||
| 搜索技能 | 全文搜索 + 分类过滤 | P0 |
|
||||
| 购买技能 | 用 Credit 购买,立即可用 | P0 |
|
||||
| 已购管理 | 查看已购技能列表 | P0 |
|
||||
| 技能评分 | 用户评分和评论 | P1 |
|
||||
| 技能试用 | 免费试用 N 次 | P1 |
|
||||
| 套餐 | 月费 | 包含额度 | 能力创建 | 发布能力 | 分成比例 |
|
||||
|------|------|---------|---------|---------|---------|
|
||||
| 免费 | 0 | 每日 50 次 LLM 调用 | ❌ | ❌ | — |
|
||||
| 开发者 | ¥29/月 | 每月 50 万 Token | ✅ 3 个 | ✅ | 70% |
|
||||
| 专业版 | ¥99/月 | 每月 200 万 Token | ✅ 10 个 | ✅ | 75% |
|
||||
| 旗舰版 | ¥299/月 | 每月 1000 万 Token | ✅ 无限制 | ✅ | 80% |
|
||||
|
||||
#### 3.5.2 计费模式
|
||||
### 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 核心开源组件预置
|
||||
|
||||
| 组件 | 选型 | 理由 |
|
||||
|------|------|------|
|
||||
| per_call | 每次调用扣费 | 平台 25% / 开发者 75% |
|
||||
| per_token | 按 Token 扣费 | 平台 25% / 开发者 75% |
|
||||
| subscription | 订阅制(月/年) | 平台 25% / 开发者 75% |
|
||||
| free | 免费 | 无 |
|
||||
|
||||
#### 3.5.3 技能详情页内容
|
||||
|
||||
```
|
||||
名称 / 作者 / 版本 / 价格
|
||||
简介 / 详细描述
|
||||
功能列表 / 使用示例
|
||||
API 文档 / 调用示例
|
||||
评分 / 评论 / 使用次数
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3.6 IM Bot 网关
|
||||
|
||||
#### 3.6.1 支持平台
|
||||
|
||||
| 平台 | 协议 | 优先级 | 说明 |
|
||||
|------|------|--------|------|
|
||||
| 微信 | LangBot / OpenClaw | P0 | 个人微信,扫码登录 |
|
||||
| QQ | OneBot v11 | P1 | go-cqhttp |
|
||||
| 钉钉 | 钉钉开放平台 | P1 | 企业机器人 |
|
||||
| 飞书 | 飞书开放平台 | P2 | 企业机器人 |
|
||||
| Telegram | Bot API | P2 | 个人机器人 |
|
||||
|
||||
#### 3.6.2 核心功能
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 多轮对话 | 维护会话上下文(Redis,24h 过期) | P0 |
|
||||
| 模型选择 | 用户可切换不同 LLM 模型 | P0 |
|
||||
| 指令系统 | /help /model /clear /balance 等快捷指令 | P0 |
|
||||
| 消息格式 | 文本 / Markdown / 图片 | P0 |
|
||||
| 按钮交互 | 平台支持时提供按钮选择 | P1 |
|
||||
| 文件处理 | 接收和发送文件(图片、文档) | P2 |
|
||||
|
||||
#### 3.6.3 会话管理
|
||||
|
||||
```
|
||||
每个用户 + 每个平台 = 独立会话
|
||||
会话存储: Redis Hash
|
||||
上下文窗口: 最近 20 条消息
|
||||
过期时间: 24 小时无活动自动清除
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3.7 用户 Dashboard
|
||||
|
||||
#### 3.7.1 页面结构
|
||||
|
||||
```
|
||||
Dashboard
|
||||
├── 首页概览
|
||||
│ ├── Credit 余额卡片
|
||||
│ ├── 今日/本月用量趋势图
|
||||
│ ├── 快捷操作按钮
|
||||
│ └── 最近调用记录
|
||||
├── API Key 管理
|
||||
│ ├── Key 列表(创建时间/最后使用/状态)
|
||||
│ ├── 创建新 Key
|
||||
│ └── 删除 Key
|
||||
├── 用量详情
|
||||
│ ├── 按日/周/月图表
|
||||
│ ├── 按模型分类统计
|
||||
│ ├── 按能力分类统计
|
||||
│ └── 导出 CSV
|
||||
├── 账单中心
|
||||
│ ├── Credit 流水记录
|
||||
│ ├── 订阅管理(升级/降级/取消)
|
||||
│ └── 充值历史
|
||||
├── 我的能力
|
||||
│ ├── 已创建的能力列表
|
||||
│ ├── 创建新能力
|
||||
│ └── 能力统计(调用量/收入)
|
||||
├── 市场
|
||||
│ ├── 浏览技能
|
||||
│ ├── 搜索技能
|
||||
│ └── 已购技能
|
||||
└── 设置
|
||||
├── 个人信息
|
||||
├── 修改密码
|
||||
└── 通知偏好
|
||||
```
|
||||
|
||||
#### 3.7.2 首页概览卡片
|
||||
|
||||
```
|
||||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||||
│ Credit 余额 │ │ 今日调用次数 │ │ 今日消耗 │ │ 当前套餐 │
|
||||
│ 12,580 │ │ 342 次 │ │ 1,280 Credits│ │ Pro │
|
||||
│ [充值] [升级] │ │ ↑12% vs 昨日 │ │ ↓5% vs 昨日 │ │ 到期: 07-27 │
|
||||
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3.8 管理后台
|
||||
|
||||
#### 3.8.1 页面结构
|
||||
|
||||
```
|
||||
Admin Console
|
||||
├── 仪表盘
|
||||
│ ├── 核心指标(用户数/API调用量/收入)
|
||||
│ ├── 趋势图表
|
||||
│ └── 系统状态
|
||||
├── 用户管理
|
||||
│ ├── 用户列表(搜索/过滤/分页)
|
||||
│ ├── 用户详情
|
||||
│ └── 封禁/解封
|
||||
├── 租户管理
|
||||
│ ├── 租户列表
|
||||
│ ├── 租户详情(订阅/用量/余额)
|
||||
│ └── 调整余额
|
||||
├── 能力审核
|
||||
│ ├── 待审核列表
|
||||
│ ├── 审核详情
|
||||
│ └── 通过/拒绝
|
||||
├── 系统配置
|
||||
│ ├── LLM 提供商配置
|
||||
│ ├── 订阅套餐配置
|
||||
│ └── 全局限流配置
|
||||
└── 数据分析
|
||||
├── API 调用趋势
|
||||
├── 热门能力排行
|
||||
└── 收入报表
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3.9 MCP Hub 集成
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| MCP Server 注册 | 开发者注册自己的 MCP Server | P0 |
|
||||
| 工具列表 | 查看已注册 MCP Server 提供的工具 | P0 |
|
||||
| 工具调用 | 通过平台调用 MCP 工具(经过计费) | P0 |
|
||||
| Server 市场 | 浏览和使用社区 MCP Server | P1 |
|
||||
|
||||
---
|
||||
|
||||
### 3.10 Agent 编排(LangFlow 集成)
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 可视化编辑器 | 嵌入 LangFlow 的 Flow 编辑器 | P1 |
|
||||
| Flow 发布 | 将 Flow 发布为可调用的 Agent | P0 |
|
||||
| Flow 运行 | API 调用运行 Flow(经过计费) | P0 |
|
||||
| Flow 模板 | 预置常用 Flow 模板 | P2 |
|
||||
|
||||
---
|
||||
|
||||
### 3.11 ACP 协议(Phase 4)
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| Agent 发现 | 发现已注册的 Agent | P1 |
|
||||
| Agent 通信 | Agent 间发送消息 | P1 |
|
||||
| 工作流编排 | 多 Agent 协作完成复杂任务 | P2 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 非功能需求
|
||||
|
||||
### 4.1 性能要求
|
||||
|
||||
| 指标 | 目标值 |
|
||||
|------|--------|
|
||||
| API 响应时间 (P95) | < 200ms(不含 LLM 调用) |
|
||||
| LLM 调用响应时间 (P95) | < 5s(流式首 token < 1s) |
|
||||
| 并发用户数 | 1000+ |
|
||||
| API QPS | 500+ |
|
||||
| 计费延迟 | < 100ms(Redis Lua) |
|
||||
|
||||
### 4.2 安全要求
|
||||
|
||||
| 要求 | 说明 |
|
||||
|------|------|
|
||||
| 数据加密 | 传输 HTTPS,存储敏感字段 AES-256 |
|
||||
| 多租户隔离 | PostgreSQL RLS,数据严格隔离 |
|
||||
| API Key 安全 | 哈希存储,仅展示一次 |
|
||||
| 限流防刷 | 按租户/Key 限流,防止滥用 |
|
||||
| 审计日志 | 所有关键操作可追溯 |
|
||||
|
||||
### 4.3 可用性要求
|
||||
|
||||
| 指标 | 目标值 |
|
||||
|------|--------|
|
||||
| 系统可用性 | 99.9% |
|
||||
| 数据备份 | 每日自动备份 |
|
||||
| 故障恢复 | RPO < 1h, RTO < 4h |
|
||||
|
||||
---
|
||||
|
||||
## 5. Phase 交付范围
|
||||
|
||||
### Phase 1(Week 1-4): 基座
|
||||
- ✅ 注册/登录/鉴权
|
||||
- ✅ 多租户隔离
|
||||
- ✅ 数据库 Schema
|
||||
- ✅ API Gateway 基础路由
|
||||
- ✅ 项目骨架可运行
|
||||
|
||||
### Phase 2(Week 5-8): 核心引擎
|
||||
- ✅ LLM Router(7 个平台对接)
|
||||
- ✅ Token 计费引擎
|
||||
- ✅ 用量追踪
|
||||
- ✅ OpenAI 兼容 API
|
||||
- ✅ 流式响应 SSE
|
||||
|
||||
### Phase 3(Week 9-12): 能力治理
|
||||
- ✅ Capability Registry
|
||||
- ✅ Skills 市场
|
||||
- ✅ 用户 Dashboard
|
||||
- ✅ 管理后台
|
||||
|
||||
### Phase 4(Week 13-16): 生态扩展
|
||||
- ✅ IM Bot 网关(微信/QQ/钉钉)
|
||||
- ✅ MCP Hub 集成
|
||||
- ✅ LangFlow Agent 集成
|
||||
- ✅ ACP 协议基础
|
||||
|
||||
### Phase 5(Week 17-20): 集成上线
|
||||
- ✅ 全链路测试
|
||||
- ✅ 生产部署
|
||||
- ✅ 监控告警
|
||||
- ✅ 完整文档
|
||||
| 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 标准协议管理 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user