> ## 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 是什么：AI 专家劳动力平台

> Profy 是基于 Bun Monorepo 的 TypeScript 全栈业务平台，提供 Portal 门户、应用市场、项目协作、AI 专家、声明式沙箱与统一 Core API。

# Profy 是什么？

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

## 为什么选择 Profy

<CardGroup cols={2}>
  <Card title="全栈 TypeScript" icon="code">
    从前端到后端、从数据库到 API 客户端，全链路类型安全，一套语言覆盖整个技术栈
  </Card>

  <Card title="AI Agent 原生" icon="robot">
    Agent Runtime 对话能力，声明式 Sandbox（E2B/Docker）编排，SSE 实时流式交互
  </Card>

  <Card title="生产就绪" icon="shield-check">
    完善的认证体系、金融级支付能力、蓝绿部署策略，满足生产环境要求
  </Card>

  <Card title="Monorepo 架构" icon="cubes">
    Bun 驱动的 Monorepo，共享类型、组件和工具链，团队协作效率最大化
  </Card>
</CardGroup>

## 核心能力

### 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 编排、付费查看结果 |
| **文件** | S3 对象存储、上传/下载/删除                 |
| **市场** | 应用/技能的 CRUD、分类、收藏                |

## 技术架构概览

```mermaid theme={null}
graph TB
    Client[客户端] --> Nginx[Nginx 反向代理]

    Nginx -->|"/*"| Web["apps/web<br/>Next.js 16"]
    Nginx -->|"/api/*"| Core["services/core<br/>Hono + Bun"]
    Nginx -->|"/openapi/*"| Core

    Web -->|SSE 代理| ExpertRT["Agent Runtime<br/>声明式 Sandbox（E2B/Docker）"]

    Core --> PostgreSQL[(PostgreSQL)]
    Core --> Redis[(Redis)]
    Core --> S3[(S3)]
    Core --> WeChat["微信支付"]

    subgraph packages["共享包"]
        Types["@profy/types"]
        DB["@profy/db"]
        Auth["@profy/auth"]
        UI["@profy/ui"]
        Fetch["@profy/fetch"]
    end

    Core -.-> packages
    Web -.-> packages
```

## 快速开始

### 环境要求

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

### 安装与启动

```bash theme={null}
git clone <repository-url>
cd profy

bun install

make dev
```

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

## 开始探索

<CardGroup cols={2}>
  <Card title="系统架构" icon="sitemap" href="/zh/documentation/architecture/overview">
    深入了解双层架构、请求生命周期和构建依赖
  </Card>

  <Card title="认证系统" icon="lock" href="/zh/documentation/auth">
    SMS 登录、JWT 管理、API Key 和安全策略
  </Card>

  <Card title="应用市场" icon="store" href="/zh/documentation/marketplace">
    应用浏览、技能搜索、分类和收藏
  </Card>

  <Card title="金融支付" icon="credit-card" href="/zh/documentation/finance">
    积分体系、充值流程、微信支付集成
  </Card>

  <Card title="任务调度" icon="list-check" href="/zh/documentation/tasks">
    任务生命周期、Agent 分发和付费查看
  </Card>

  <Card title="Agent 平台" icon="robot" href="/zh/documentation/agent">
    Agent Runtime、声明式 Sandbox 与 SSE 流式交互
  </Card>

  <Card title="部署运维" icon="server" href="/zh/documentation/deployment">
    Docker Compose、蓝绿部署和 Nginx 配置
  </Card>
</CardGroup>