跳转到主要内容

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.

​
Profy 是什么？

Profy 是一个基于 TypeScript 构建的全栈业务中台系统，集成了消费级应用市场（Portal）与 AI 专家劳动力市场（Expert Workforce Platform），为企业提供从应用分发、多专家协作（Project）、声明式运行环境（Sandbox）到创作者生态（Marketplace）的完整解决方案。

​
为什么选择 Profy

全栈 TypeScript

从前端到后端、从数据库到 API 客户端，全链路类型安全，一套语言覆盖整个技术栈

AI Agent 原生

Agent Runtime 对话能力，声明式 Sandbox（E2B/Docker）编排，SSE 实时流式交互

生产就绪

完善的认证体系、金融级支付能力、蓝绿部署策略，满足生产环境要求

Monorepo 架构

Bun 驱动的 Monorepo，共享类型、组件和工具链，团队协作效率最大化

​
核心能力

​
Portal — 应用市场

应用市场为用户提供发现和使用应用的统一入口。支持分类浏览、热门推荐、技能搜索和收藏管理，所有公开接口无需登录即可访问。

​
Expert — AI 专家产品与 Agent 运行时

Expert（AI 专家产品） 是面向终端用户的可售卖智能体单元；多个 Expert 可在同一 Project 中协作编排。Sandbox 是声明式运行环境（E2B 或 Docker），由 Core 统一编排创建、健康检查与回收。Agent Runtime（services/agent-runtime）在 Sandbox 内提供对话与工具执行，通过 SSE 实现实时流式交互，并支持文件操作与 Web 预览。

​
Project — 多专家协作

Project 将多个 Expert 与共享上下文组织在同一工作空间语义下，便于复杂任务拆解与协作（详见架构与产品文档）。

​
Marketplace — 创作者生态

Marketplace 连接创作者与终端用户：应用、技能与 Expert 的分发、上架与发现均在此闭环。

​
Core API — 业务中台

Hono 构建的高性能后端 API，涵盖：
领域能力
认证SMS 验证码登录、JWT Token 管理、单设备策略
金融金币体系、充值流程、微信支付、消费记录
任务创建、提交、Expert / Sandbox 编排、付费查看结果
文件MinIO 对象存储、上传/下载/删除
市场应用/技能的 CRUD、分类、收藏

​
技术架构概览

​
快速开始

​
环境要求

  • Bun >= 1.x（运行时 & 包管理）
  • Node.js >= 20（Next.js 构建）
  • MySQL 数据库
  • Redis 缓存服务

​
安装与启动

git clone <repository-url>
cd profy

bun install

make dev
make dev 会同时启动 Core API（端口 8080）和 Web 前端（端口 3000）。

​
开始探索

系统架构

深入了解双层架构、请求生命周期和构建依赖

认证系统

SMS 登录、JWT 管理、API Key 和安全策略

应用市场

应用浏览、技能搜索、分类和收藏

金融支付

金币体系、充值流程、微信支付集成

任务调度

任务生命周期、Agent 分发和付费查看

Agent 平台

Agent Runtime、声明式 Sandbox 与 SSE 流式交互

部署运维

Docker Compose、蓝绿部署和 Nginx 配置