Profy 采用 Monorepo + 双层后端 架构：Web 前端（Next.js） 负责 UI 渲染和 SSE 代理，Core API（Hono + Bun） 作为业务中台处理认证、金融、任务与 Sandbox 编排等所有业务逻辑，Agent Runtime（Documentation Index
Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
Use this file to discover all available pages before exploring further.
services/agent-runtime）在 声明式 Sandbox（E2B/Docker） 内运行 Expert 对话与工具执行。
概览
- Nginx 作为统一入口，按路径分发到 Web 前端或 Core API
- Web 前端 负责页面渲染，同时作为 SSE 代理桥接用户与 Agent Runtime
- Core API 是所有业务逻辑的中枢 — 认证、金融、任务、市场、文件管理、Sandbox 编排
- Agent Runtime 在声明式 Sandbox（E2B/Docker）内为每个 Expert 提供隔离运行环境
技术栈
| 层级 | 技术 | 说明 |
|---|---|---|
| 前端 | Next.js 16, TypeScript, Tailwind CSS | SSR + CSR，i18n 支持 |
| 后端 | Hono + Bun | 高性能 API 框架，REST + tRPC 双轨 |
| ORM | Drizzle ORM | 类型安全的数据库访问 |
| 认证 | Better Auth + JWT | SMS OTP 登录，单设备策略 |
| 数据库 | MySQL | 主数据存储 |
| 缓存 | Redis | 会话缓存、验证码存储 |
| 存储 | MinIO (S3) | 文件上传与对象存储 |
| Agent | Agent Runtime | 声明式 Sandbox（E2B/Docker）隔离运行 |
| 部署 | Docker Compose, Nginx | 单机部署，蓝绿发布 |
| 工具链 | Bun, Biome, Lefthook | Monorepo 依赖管理、代码质量 |
核心模块
Portal — 应用市场
面向终端用户的应用发现平台。支持分类浏览、搜索、收藏和技能管理。公开 API 无需登录即可访问，为用户提供零门槛的应用探索体验。Expert — AI 专家产品与运行时
Expert 是可售卖的 AI 专家产品单元；其对话与工具链由 Agent Runtime 在 声明式 Sandbox 中执行。Sandbox 由 Core 编排（创建、健康检查、暂停、终止），拥有隔离文件系统，经 SSE 与 Web 前端实时交互。Core API — 业务中台
Hono 构建的高性能后端，统一处理所有业务领域：| 领域 | 能力 |
|---|---|
| 认证 | SMS 验证码登录、JWT 管理、API Key |
| 金融 | 金币体系、充值、微信支付、消费记录 |
| 任务 | 创建、提交、Expert / Sandbox 编排、付费查看 |
| 文件 | MinIO 对象存储、上传/下载 |
| 市场 | 应用/技能 CRUD、分类、收藏 |
Expert 沙箱与 agent-runtime
Core 是沙箱唯一编排层（create / provision / healthCheck / resume / pause / terminate），agent-runtime 仅提供纯基建操作（connect / 文件 / 命令执行）。所有 cloud 对话经 Coreprepare-invoke 统一编排，异步 provision 通过 Redis 桥接给 Python。详见 sandbox-runtime-contract.md。
请求生命周期
下一步
认证系统
SMS 登录、JWT 管理与安全策略
Agent 平台
Agent Runtime 与声明式 Sandbox 编排
应用市场
应用浏览、技能搜索与收藏
部署指南
Docker Compose 部署与 Nginx 配置