# AI PaaS 商业平台 — 前后台功能框架 > 版本: 1.0 | 日期: 2026-06-27 > 定位: 让任何 AI 使用者都能像用水电一样使用 AI 能力 --- ## 功能全景图 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ QihuAI 平台 │ ├────────────────────────────┬────────────────────────────────────────┤ │ 前台（用户端） │ 后台（管理端） │ │ 12 个功能板块 │ 8 个功能板块 │ ├────────────────────────────┼────────────────────────────────────────┤ │ ① 首页/营销落地页 │ ① 管理仪表盘 │ │ ② 用户认证中心 │ ② 用户管理 │ │ ③ 工作台 Dashboard │ ③ 能力审核中心 │ │ ④ LLM 对话实验室 │ ④ 财务管理中心 │ │ ⑤ 模型广场 │ ⑤ 技能市场管理 │ │ ⑥ 技能市场 │ ⑥ 系统运维监控 │ │ ⑦ Agent 工坊 │ ⑦ 内容运营管理 │ │ ⑧ MCP 工具中心 │ ⑧ 平台配置中心 │ │ ⑨ API 开发者控制台 │ │ │ ⑩ 账务中心 │ │ │ ⑪ 开发者中心 │ │ │ ⑫ 个人设置 │ │ └────────────────────────────┴────────────────────────────────────────┘ ``` --- ## 一、前台功能板块（用户端） ### ① 首页 / 营销落地页 **作用**: 平台第一印象，转化访客为注册用户。 | 模块 | 说明 | |------|------| | Hero Banner | 一句话定位 + CTA 注册按钮 | | 核心卖点 | 3-4 个核心价值点（注册即用/按量付费/模型丰富/能力市场） | | 模型展示 | 支持的 LLM 列表 + 价格对比 | | 使用场景 | 典型用户场景（开发者/创作者/企业） | | 定价方案 | 订阅套餐对比表（Free/开发者/专业/旗舰） | | 开发者生态 | 技能市场精选 + 开发者收入故事 | | 数据看板 | 平台实时数据（注册用户/调用次数/技能数量） | | 文档入口 | 快速开始/API 文档/SDK 下载 | **页面结构**: ``` / ← 首页 /pricing ← 定价页 /docs ← 文档中心 /docs/quickstart ← 快速开始 /docs/api ← API 参考 /docs/sdk ← SDK 下载 ``` --- ### ② 用户认证中心 **作用**: 注册、登录、实名认证，用户身份管理。 | 功能 | 说明 | |------|------| | 手机号注册 | 手机号 + 短信验证码（短信宝） | | 邮箱注册 | 邮箱 + 密码（备用） | | 微信扫码登录 | Casdoor SSO 对接微信 | | 手机号登录 | 手机号 + 短信验证码 | | 邮箱登录 | 邮箱 + 密码 | | 忘记密码 | 邮箱重置密码 | | 实名认证 | 姓名 + 身份证号 → 阿里云实名认证 API | | 图形验证码 | 防短信轰炸，发送验证码前必须验证 | **用户状态机**: ``` 注册 → 未认证用户 → 实名认证通过 → 认证用户 → 订阅月费 → 订阅用户 → 欠费 → 保留已发布能力，限制新创建 ``` **页面结构**: ``` /auth/register ← 注册 /auth/login ← 登录 /auth/forgot-password ← 忘记密码 /auth/verify ← 实名认证 ``` --- ### ③ 工作台 Dashboard **作用**: 用户登录后的主界面，一眼掌握全局。 | 模块 | 说明 | |------|------| | 快速开始 | 引导新用户完成首次调用（3步：注册→获取API Key→调用） | | 余额概览 | Credit 余额 + 订阅状态 + 本月用量 | | 用量趋势 | 近7天/30天 Token 用量折线图 | | 最近调用 | 最近10条 LLM 调用记录（模型/Token/费用） | | 快捷入口 | 对话实验室 / 技能市场 / API 文档 | | 通知中心 | 系统公告 / 订阅到期提醒 / 费用预警 | | 开发者卡片 | 发布的技能数 / 总收入 / 待提现（订阅用户） | **页面结构**: ``` /dashboard ← 工作台首页 /dashboard/usage ← 用量详情 /dashboard/billing ← 账务概览 /dashboard/notifications ← 通知中心 ``` --- ### ④ LLM 对话实验室 **作用**: 在线体验和测试各种 LLM 模型，是平台核心功能。 | 功能 | 说明 | |------|------| | 多模型切换 | 下拉选择模型（DeepSeek/千问/豆包/智谱/元宝/百度） | | 对话界面 | 类 ChatGPT 的对话 UI | | 流式输出 | SSE 实时流式响应 | | 系统提示词 | 设置 System Prompt | | 参数调节 | 温度 / Top-P / 最大 Token / 停止词 | | 对话管理 | 新建/历史对话列表/删除对话 | | 导出对话 | 导出为 Markdown / JSON | | 对话分享 | 生成分享链接（可选） | | 用量显示 | 每次对话显示 Token 消耗和费用 | | 模型对比 | 同一问题多模型同时回答，对比效果 | **页面结构**: ``` /playground ← 对话实验室 /playground/new ← 新建对话 /playground/history ← 历史对话 /playground/compare ← 模型对比 ``` --- ### ⑤ 模型广场 **作用**: 展示所有可用模型，帮助用户选择合适的模型。 | 功能 | 说明 | |------|------| | 模型列表 | 所有可用模型卡片展示 | | 分类筛选 | 按提供商/能力/价格筛选 | | 模型详情 | 能力介绍 / 上下文长度 / 价格 / 评分 | | 能力雷达图 | 推理/写作/代码/多语言/创意 五维评分 | | 价格对比 | 各模型价格对比表 | | 快速试用 | 点击直接跳转对话实验室 | | 模型评测 | 用户评分和评价 | **模型分类**: ``` 按提供商: DeepSeek / 千问 / 豆包 / 智谱 / 元宝 / 百度 / Ollama(本地) 按能力: 通用对话 / 代码生成 / 长文本 / 多模态 / 推理增强 按价格: 免费 / 经济 / 标准 / 高端 ``` **页面结构**: ``` /models ← 模型广场 /models/{id} ← 模型详情 ``` --- ### ⑥ 技能市场 **作用**: AI 技能交易平台，用户可浏览、购买、使用开发者发布的技能。 | 功能 | 说明 | |------|------| | 技能浏览 | 卡片列表，支持搜索/分类/排序 | | 技能详情 | 描述 / 使用方法 / 价格 / 评分 / 使用量 | | 一键调用 | 购买后直接在平台内使用 | | 购买流程 | 确认 → 扣费 → 授权 → 使用 | | 评价系统 | 1-5 星评分 + 文字评价 | | 收藏夹 | 收藏感兴趣的技能 | | 分类体系 | 办公效率 / 内容创作 / 数据分析 / 开发工具 / 生活服务 | **计费模式**: ``` 按次调用: 每次使用扣 X Credit 按Token: 按 Token 用量计费 订阅制: 包月使用 免费: 完全免费 ``` **页面结构**: ``` /skills ← 技能市场 /skills/{id} ← 技能详情 /skills/purchased ← 已购技能 /skills/category/{cat} ← 分类浏览 ``` --- ### ⑦ Agent 工坊 **作用**: 可视化创建和管理 AI Agent，是 PaaS 平台的核心能力。 | 功能 | 说明 | |------|------| | Agent 列表 | 我创建的 / 我使用的 / 公开的 | | 可视化编排 | 拖拽式工作流编辑器（基于 LangFlow） | | 预置模板 | 常用 Agent 模板（客服/翻译/摘要/代码助手） | | 工具绑定 | 绑定 MCP 工具 / API 接口 / 自定义函数 | | 模型配置 | 为 Agent 选择底层 LLM 模型 | | 测试调试 | 在线测试 Agent 效果 | | 发布上线 | 发布到市场或私有使用 | | API 导出 | 生成独立的 API 端点 | | 版本管理 | 多版本管理，支持回滚 | **Agent 类型**: ``` 对话型 Agent: 多轮对话，上下文记忆 工作流 Agent: 多步骤任务编排 工具型 Agent: 调用外部工具完成任务 混合型 Agent: 对话 + 工具 + 工作流 ``` **页面结构**: ``` /agents ← Agent 工坊 /agents/new ← 创建 Agent /agents/{id} ← Agent 详情/编辑 /agents/{id}/test ← 测试调试 /agents/templates ← 模板库 ``` --- ### ⑧ MCP 工具中心 **作用**: 管理和使用 Model Context Protocol 工具，扩展 AI 能力边界。 | 功能 | 说明 | |------|------| | 工具列表 | 已安装的 MCP Server 列表 | | 工具市场 | 浏览和安装社区 MCP Server | | 工具详情 | 功能说明 / 参数定义 / 使用示例 | | 安装管理 | 一键安装/卸载/更新 | | 权限管理 | 控制哪些 Agent 可以使用哪些工具 | | 调用日志 | 工具调用记录和审计 | **预置 MCP Server**: ``` 文件系统: 读写本地文件 网页抓取: 抓取网页内容 代码执行: 安全沙箱执行代码 数据库: SQL 查询 搜索引擎: 联网搜索 图像生成: AI 绘图 ``` **页面结构**: ``` /mcp ← MCP 工具中心 /mcp/marketplace ← 工具市场 /mcp/installed ← 已安装工具 /mcp/{id} ← 工具详情 ``` --- ### ⑨ API 开发者控制台 **作用**: 程序化接入平台，开发者的核心工作台。 | 功能 | 说明 | |------|------| | API Key 管理 | 创建/查看/删除 API Key | | API 文档 | OpenAI 兼容格式的完整 API 文档 | | 代码示例 | Python/cURL/Node.js/Go 调用示例 | | 调试工具 | 在线 API 调试器（类似 Postman） | | 调用统计 | 按时间/模型/接口的调用统计 | | Webhook 配置 | 调用完成通知 | | SDK 下载 | 官方 SDK（Python/Node.js） | **API 接口**: ``` POST /v1/chat/completions ← Chat Completion (OpenAI 兼容) GET /v1/models ← 可用模型列表 POST /v1/embeddings ← 文本嵌入 GET /v1/usage ← 用量查询 ``` **页面结构**: ``` /developer ← 开发者控制台 /developer/api-keys ← API Key 管理 /developer/docs ← API 文档 /developer/playground ← 在线调试 /developer/statistics ← 调用统计 /developer/sdk ← SDK 下载 ``` --- ### ⑩ 账务中心 **作用**: 订阅管理、充值、账单、交易记录。 | 功能 | 说明 | |------|------| | 订阅管理 | 当前套餐 / 升级降级 / 取消订阅 | | 充值中心 | Token 包购买（¥10/¥50/¥100） | | 余额概览 | 当前余额 / 本月已用 / 本月包含 | | 交易流水 | 完整交易记录（按时间/类型筛选） | | 发票管理 | 申请发票（电子发票） | | 支付方式 | 支付宝 / 微信支付 | | 费用预警 | 余额不足提醒 / 用量预警 | **订阅套餐**: ``` 免费: ¥0/月 50次/天 LLM调用 开发者: ¥29/月 50万Token/月 + 创建/发布3个能力 专业版: ¥99/月 200万Token/月 + 创建/发布10个能力 旗舰版: ¥299/月 1000万Token/月 + 无限制 ``` **页面结构**: ``` /billing ← 账务中心 /billing/subscription ← 订阅管理 /billing/topup ← 充值 /billing/transactions ← 交易流水 /billing/invoice ← 发票 ``` --- ### ⑪ 开发者中心 **作用**: 能力/技能的创建、发布、管理、变现。 | 功能 | 说明 | |------|------| | 开发者仪表盘 | 发布数 / 使用量 / 收入概览 | | 能力创建 | 填写名称/描述/类型/端点/定价 | | 能力管理 | 编辑/下架/版本管理/审核状态 | | 技能发布 | 发布到技能市场 | | 技能管理 | 定价/描述/文档/版本 | | 收益统计 | 按天/周/月的收入趋势 | | 提现管理 | 申请提现 / 提现记录 | | 开发者文档 | 如何发布能力/技能的指南 | **发布流程**: ``` 创建能力 → 填写信息 → 提交审核 → 管理员审核（1-3工作日） → 审核通过 → 上架市场 → 用户购买/使用 → 获得分成 ``` **页面结构**: ``` /developer-center ← 开发者中心 /developer-center/dashboard ← 开发者仪表盘 /developer-center/capabilities/create ← 创建能力 /developer-center/capabilities ← 能力管理 /developer-center/skills/create ← 发布技能 /developer-center/skills ← 技能管理 /developer-center/revenue ← 收益统计 /developer-center/payout ← 提现管理 ``` --- ### ⑫ 个人设置 **作用**: 用户个人信息、安全、偏好管理。 | 功能 | 说明 | |------|------| | 个人信息 | 头像 / 昵称 / 手机号 / 邮箱 | | 安全设置 | 修改密码 / 绑定手机 / 绑定邮箱 | | 实名认证 | 查看认证状态 / 重新认证 | | 偏好设置 | 默认模型 / 界面语言 / 主题 | | 通知设置 | 邮件通知 / 短信通知 / 站内通知 | | 数据管理 | 导出数据 / 注销账号 | **页面结构**: ``` /settings ← 个人设置 /settings/profile ← 个人信息 /settings/security ← 安全设置 /settings/verify ← 实名认证 /settings/preferences ← 偏好设置 /settings/notifications ← 通知设置 ``` --- ## 二、后台功能板块（管理端） ### ① 管理仪表盘 **作用**: 平台运营全局概览，管理员第一入口。 | 指标 | 说明 | |------|------| | 用户数据 | 今日新增 / 总用户 / 活跃用户 / 订阅用户 | | 调用数据 | 今日调用次数 / 总 Token / 调用趋势图 | | 财务数据 | 今日收入 / 本月收入 / 总收入 / 待提现 | | 能力数据 | 总能力数 / 待审核 / 已上架 / 技能总数 | | 系统状态 | API 响应时间 / 错误率 / 各服务健康状态 | | 实时动态 | 最新注册 / 最新调用 / 最新交易 / 异常告警 | **页面结构**: ``` /admin ← 管理仪表盘 /admin/realtime ← 实时监控 ``` --- ### ② 用户管理 **作用**: 管理所有注册用户。 | 功能 | 说明 | |------|------| | 用户列表 | 分页/搜索/筛选（状态/认证/订阅） | | 用户详情 | 个人信息 / 认证状态 / 订阅信息 / 用量 / 交易 | | 状态管理 | 封禁/解封/删除 | | 角色管理 | 普通用户/开发者/管理员 | | 实名审核 | 查看实名认证记录 | | 用户画像 | 使用行为分析 / 活跃度评分 | **页面结构**: ``` /admin/users ← 用户列表 /admin/users/{id} ← 用户详情 ``` --- ### ③ 能力审核中心 **作用**: 审核开发者发布的能力和技能，确保平台内容质量。 | 功能 | 说明 | |------|------| | 审核列表 | 待审核的能力/技能列表 | | 审核详情 | 查看能力信息 / 测试调用 / 安全检查 | | 审批操作 | 通过/拒绝/要求修改 | | 审核记录 | 历史审核记录和备注 | | 审核标准 | 平台审核标准和规范文档 | | 举报处理 | 用户举报的内容处理 | **审核流程**: ``` 开发者提交 → 自动初审（格式/安全） → 人工审核（功能/内容/合规） → 通过 → 上架 / 拒绝 → 通知开发者 ``` **页面结构**: ``` /admin/review ← 审核中心 /admin/review/pending ← 待审核列表 /admin/review/{id} ← 审核详情 /admin/review/history ← 审核历史 ``` --- ### ④ 财务管理中心 **作用**: 平台财务全局管理。 | 功能 | 说明 | |------|------| | 收入概览 | 日/周/月收入趋势 / 收入构成 | | 订阅统计 | 各套餐订阅人数 / 续费率 / 流失率 | | 交易流水 | 全平台交易记录（可导出） | | 提现审核 | 开发者提现申请审核 | | 分成管理 | 平台/开发者分成比例配置 | | 财务报表 | 月度/年度财务报表生成 | | 对账管理 | 支付渠道对账 / 异常交易处理 | **页面结构**: ``` /admin/finance ← 财务管理 /admin/finance/overview ← 收入概览 /admin/finance/transactions ← 交易流水 /admin/finance/payouts ← 提现审核 /admin/finance/reports ← 财务报表 ``` --- ### ⑤ 技能市场管理 **作用**: 管理技能市场的运营。 | 功能 | 说明 | |------|------| | 市场概览 | 技能数量 / 交易量 / 热门技能 | | 分类管理 | 创建/编辑/删除技能分类 | | 推荐管理 | 首页推荐 / 精选技能配置 | | 评价管理 | 查看/删除违规评价 | | 举报处理 | 技能举报处理 | | 数据分析 | 技能使用趋势 / 热门搜索 / 转化率 | **页面结构**: ``` /admin/skills ← 技能市场管理 /admin/skills/overview ← 市场概览 /admin/skills/categories ← 分类管理 /admin/skills/featured ← 推荐管理 /admin/skills/reviews ← 评价管理 ``` --- ### ⑥ 系统运维监控 **作用**: 系统健康监控和运维管理。 | 功能 | 说明 | |------|------| | 服务状态 | 各微服务健康状态（API Gateway/Billing/Registry...） | | 性能监控 | 响应时间 / QPS / 错误率 / CPU/内存 | | 日志管理 | 结构化日志查询 / 错误日志追踪 | | 告警配置 | 阈值告警 / 通知渠道（邮件/短信/钉钉） | | 数据库监控 | 连接数 / 慢查询 / 存储空间 | | Redis 监控 | 内存 / 连接数 / 命中率 | | Kafka 监控 | 消费延迟 / 消息积压 | | 安全审计 | 登录日志 / 敏感操作日志 | **页面结构**: ``` /admin/system ← 系统运维 /admin/system/services ← 服务状态 /admin/system/performance ← 性能监控 /admin/system/logs ← 日志管理 /admin/system/alerts ← 告警配置 /admin/system/security ← 安全审计 ``` --- ### ⑦ 内容运营管理 **作用**: 平台内容和运营活动管理。 | 功能 | 说明 | |------|------| | 公告管理 | 发布/编辑/删除系统公告 | | Banner 管理 | 首页轮播图配置 | | 文档管理 | 帮助文档/FAQ 编辑 | | 活动管理 | 促销活动/优惠券配置 | | 模型管理 | 新增/下架/配置 LLM 模型 | | 邮件模板 | 注册/通知/账单邮件模板 | **页面结构**: ``` /admin/content ← 内容运营 /admin/content/announcements ← 公告管理 /admin/content/banners ← Banner 管理 /admin/content/documents ← 文档管理 /admin/content/models ← 模型管理 ``` --- ### ⑧ 平台配置中心 **作用**: 全局系统配置管理。 | 功能 | 说明 | |------|------| | 基础配置 | 平台名称/Logo/描述/联系信息 | | 订阅配置 | 套餐价格/额度/分成比例 | | 短信配置 | 短信宝 API Key/签名/模板 | | 支付配置 | 支付宝/微信支付 API 配置 | | LLM 配置 | 各模型 API Key/渠道管理 | | 安全配置 | 限流规则/IP 白名单/黑名单 | | 邮件配置 | SMTP 服务器配置 | | 存储配置 | 文件存储（OSS/本地） | **页面结构**: ``` /admin/config ← 平台配置 /admin/config/general ← 基础配置 /admin/config/subscription ← 订阅配置 /admin/config/sms ← 短信配置 /admin/config/payment ← 支付配置 /admin/config/llm ← LLM 配置 /admin/config/security ← 安全配置 ``` --- ## 三、功能板块关系图 ### 前台用户旅程 ``` 访客 → 首页(①) → 注册(②) → 工作台(③) → 对话实验室(④) 使用LLM → 模型广场(⑤) 发现模型 → 技能市场(⑥) 购买技能 → Agent工坊(⑦) 创建Agent → MCP中心(⑧) 安装工具 → API控制台(⑨) 程序化接入 → 账务中心(⑩) 充值订阅 → 开发者中心(⑪) 发布能力 → 个人设置(⑫) 管理账户 ``` ### 后台管理闭环 ``` 管理员 → 仪表盘(①) 全局概览 → 用户管理(②) 管理用户 → 能力审核(③) 审核内容 → 财务管理(④) 管理资金 → 技能市场(⑤) 运营市场 → 系统监控(⑥) 保障稳定 → 内容运营(⑦) 运营推广 → 平台配置(⑧) 系统配置 ``` ### 数据流关系 ``` 用户调用LLM → 用量上报Kafka → 计费扣费 → 交易记录 开发者发布能力 → 审核通过 → 上架市场 → 用户购买 → 分成结算 用户订阅 → 权限开放 → 创建/发布能力 → 欠费保护 → 已发布能力保持在线 ``` --- ## 四、PaaS 平台必备能力清单 | 能力 | 说明 | 对应功能 | |------|------|---------| | **多模型接入** | 统一接口调用多家 LLM | ④⑤⑨ | | **API 兼容** | OpenAI 兼容格式 | ⑨ | | **按量计费** | Token 级别精确计费 | ⑩ | | **订阅制** | 月费套餐 | ⑩ | | **能力注册** | 标准化能力注册/发现 | ⑪ | | **技能市场** | 生态交易平台 | ⑥ | | **Agent 编排** | 可视化工作流 | ⑦ | | **MCP 集成** | 工具扩展协议 | ⑧ | | **开发者生态** | SDK/文档/示例 | ⑨ | | **开放 API** | 独立应用接入 | ⑨ | | **多租户隔离** | 用户数据隔离 | 全局 | | **审计日志** | 操作可追溯 | ⑥⑫ | | **SLA 保障** | 高可用/故障转移 | ⑥ | | **安全合规** | 实名认证/数据加密 | ② | | **运维监控** | 全链路监控 | ⑥ | --- *文档结束*