架构设计文档

系统概述

本方案旨在设计一款集成了当前市面主流AI助手优势的大型Web系统,满足三大核心目标:

数据与进化

核心目标 1

解决上下文长文本存储与语义检索、用户数据隔离与认证、用户行为自进化。

生态构建

核心目标 2

构建支持技能/应用创作、发布审核、在线交易的Hub集市。

标准规范

核心目标 3

建立完整的平台规范与功能标准,支持开源集成与高效开发。

核心功能设计

长文本处理层技术选型

文档加载与解析

使用 LlamaIndex 框架作为数据接入核心引擎,支持PDF、CSV、Notion等160+种数据源。对于复杂PDF,使用 LlamaParse 工具提取表格、公式。

文本切分

采用递归字符分割器,按优先级 `["\n\n", "\n", "。", "!", "?", ";", ",", " ", ""]` 切割。推荐 chunk_size 300-500字符,chunk_overlap 50-200字符。

向量数据库与检索

  • Embedding: 离线与在线查询必须使用同一模型,确保向量空间一致。
  • 存储: Milvus (大规模生产) 或 Chroma (开发测试)。
  • 高级检索: 结合向量检索与关键词检索 (BM25),使用 BGE-Reranker 交叉编码器进行二次打分。

Hub集市全流程说明

技能市场全链路

1. 创作/导入

输入GitHub仓库URL,利用GitHub Actions自动构建Docker镜像并推送到托管平台,实现一键部署。

2. 发布审核 (五重保障)

  • 代码扫描: 静态分析检测硬编码凭证、恶意命令。
  • 语义分析: LLM意图识别,判断功能一致性。
  • 行为分析: 沙箱环境动态运行,检测危险行为。
  • 文件全扫描: 全面文件检查。
  • 人工复核: 抽样检查后上架。

3. 版本管理

Git LFS追踪模型权重,生产环境锁定commit哈希。支持Delta Lake实现数据集时间旅行与回滚。

交易与计费

订阅计费模型

基础订阅 + Token溢出计费。支持Prorate差价计算。

免费版 10万 Token/月
基础版 ¥29/月 (100万)
专业版 ¥99/月 (500万)

支付集成

Stripe (国际) 支付宝/微信

API网关与实时计量

统一调用

兼容OpenAI规范,虚拟Key映射真实厂商Key,实现独立配额和模型范围控制。

认证授权

验证JWT签名及tenant_id。高安全服务间通信采用mTLS双向认证。

限流与计量

Redis+Lua实现分布式令牌桶。LSTM预测流量波形动态调整参数。异步处理账单生成。

平台标准规范

API格式统一标准

契约先行 (OpenAPI 3.0/3.1)

先定义API规范再进行开发,支持生成交互式文档、Mock服务和类型安全的服务端骨架。

RESTful & GraphQL

资源导向URI,精准使用HTTP方法。GraphQL使用DataLoader解决N+1查询问题。

RESTful 示例

GET /users/{id} (获取用户) POST /skills (创建技能) PUT /agents/{id} (更新Agent) Idempotency-Key:

安全认证规范

OIDC (首选)
SAML (传统企业)
零信任架构

内容安全:在模型生成Token流的同时进行动态研判,结合黑白名单、规则引擎与大模型语义理解进行交叉验证。

扩展指南与工具链

Trea (字节)

AI原生IDE,自然语言驱动开发,Figma转代码。

Qoder (阿里)

专家团协同开发,Leader Agent分配任务。

Workbuddy (腾讯)

全场景办公工作台,Ask/Craft/Plan模式。

开源项目集成清单

核心框架

LlamaIndex, LangChain

向量数据库

Milvus, Weaviate

身份认证

Keycloak, Clerk

计费引擎

Kill Bill

API网关

Apache APISIX, Kong

消息队列

Kafka, RabbitMQ

容器编排

Docker, Kubernetes

开发工具

Trea, Qoder, Workbuddy

实施路线图

基于模块交互图的系统流转逻辑可视化。