这是一个相当有规模的全栈开源项目，下面从多个维度做系统性拆解，帮助你快速建立完整认知。
一、项目定位与核心目标
AiToEarn 定位为面向 OPC（一人公司）/ 内容创作者的 AI 内容营销智能体平台，核心理念是用 AI 自动化帮助创作者在全球主流社交平台上构建、分发和变现内容。目前 GitHub 有 10.5k stars、2.1k forks，是一个活跃度较高的国产开源项目（最新提交是 2026 年 4 月 20 日）。
它围绕四大 Agent 能力构建：
Monetize（变现） — 内容交易市场，支持 CPS/CPE/CPM 三种结算模式，创作者接单完成推广任务赚钱。
Publish（发布） — 一键将内容分发到 12+ 平台（抖音、小红书、快手、B站、TikTok、YouTube、Facebook、Instagram、X、Pinterest、LinkedIn 等），支持日历排期。
Engage（互动） — 通过浏览器插件实现自动点赞/收藏/关注、AI 智能回复评论、评论挖掘高意向用户、品牌监测。
Create（创作） — Agent 驱动的内容生产流水线，自动调用视频生成模型（Grok、Veo、Seedance）、图片模型、翻译/剪辑模块，支持批量生成。
二、整体技术架构
项目采用前后端分离 + 微服务架构，所有代码集中在 project/ 目录下，分为三大子项目：
project/
├── aitoearn-backend/ # 后端 Monorepo（NestJS + Nx）
│ ├── apps/
│ │ ├── aitoearn-server/ # 主 API 服务（端口 3002）
│ │ └── aitoearn-ai/ # AI 专属服务（端口 3010）
│ └── libs/ # 共享库（16 个）
├── aitoearn-web/ # Web 前端（Next.js 14）
└── aitoearn-electron/ # 桌面端（Electron，独立仓库）
运行时基础设施（见 docker-compose.yml）：
| 服务 | 技术栈 | 端口 |
|---|---|---|
| aitoearn-server | NestJS | 3002 |
| aitoearn-ai | NestJS | 3010 |
| aitoearn-web | Next.js | 6060 |
| nginx | 反向代理/网关 | 8080 |
| mongodb | 副本集模式 | 27017 |
| redis | 缓存/队列 | 6379 |
| rustfs | S3 兼容对象存储 | 9001 |
三、后端深度解析（aitoearn-backend）
后端使用 Nx Monorepo 管理，包管理器是 pnpm，语言是 TypeScript（占比 92.6%）。
主服务（aitoearn-server）核心模块
src/core/
├── account/ # 账号管理（社交媒体账号绑定）
├── api-key/ # API Key 鉴权管理
├── channel/ # 渠道对接（各平台适配）
├── content/ # 内容管理
├── credits/ # 积分/计费系统
├── fingerprint/ # 浏览器指纹生成（反检测）
├── notification/ # 通知系统
├── publish-record/ # 发布记录
├── relay/ # Relay 代理（借用官方 OAuth 凭据）
├── short-link/ # 短链服务
├── tools/ # 工具类接口
├── unified-mcp/ # MCP 协议统一入口
└── user/ # 用户系统
主要依赖亮点：@modelcontextprotocol/sdk（MCP 协议支持）、bullmq（异步任务队列）、@nestjs/swagger（API 文档）、fingerprint-generator（浏览器指纹）、googleapis（YouTube/Google OAuth）、@volcengine/openapi（字节火山引擎）。
AI 服务（aitoearn-ai）核心模块
src/core/
├── agent/ # Agent 调度核心
├── ai/ # AI 模型调用（OpenAI、Anthropic、Gemini、Grok）
├── draft-generation/ # 草稿自动生成
├── internal/ # 内部服务通信
└── material-adaptation/ # 素材适配（视频/图片处理）
支持的 AI 服务商（通过环境变量配置）：OpenAI、Anthropic、Google Gemini、Grok（字节），体现了多模型路由的设计思路。
共享库（libs/）
16 个内部共享库，全部通过 workspace:* 引用：aitoearn-auth、aitoearn-queue、common、helpers、mongodb、redis、redlock、aws-s3、ali-oss、ali-sms、mail、nest-mcp、channel-db 等，职责清晰，高度解耦。
四、前端深度解析（aitoearn-web）
基于 Next.js 14（App Router），使用 TypeScript + TailwindCSS v4，UI 组件采用 Radix UI + shadcn/ui 体系。
路由结构（App Router）
src/app/[lng]/ # 多语言路由（i18n）
├── (welcome)/ # 欢迎/引导页
├── accounts/ # 社交账号管理
├── agent-assets/ # AI 素材资产
├── ai-social/ # AI 社交功能
├── auth/ # 登录/注册
├── brand-promotion/ # 品牌推广（线下商户）
├── chat/ # Agent 聊天界面
├── draft-box/ # 草稿箱
├── tasks-history/ # 任务历史
└── websit/ # 官网/展示页
核心技术选型
状态管理用 Zustand，表单用 React Hook Form + Zod 验证，富文本编辑器用 Lexical，日历排期用 FullCalendar，数据可视化用 ECharts，动画用 Framer Motion，国际化用 i18next（支持中/英/日三语），E2E 测试用 Playwright。
五、MCP 协议集成（创新亮点）
这是项目 2.1 版本的重大更新。AiToEarn 实现了完整的 MCP（Model Context Protocol）服务器，让 Claude Desktop、Cursor 等任何支持 MCP 的 AI 工具都能直接调用 AiToEarn 的能力（发布内容、执行变现任务等），同时还支持 SSE 长连接和 OpenClaw（龙虾）插件两种接入方式。后端有专门的 @yikart/nest-mcp 库封装了 NestJS 的 MCP 适配层。
六、版本演进路线（帮你理解项目历史）
| 时间 | 版本 | 里程碑 |
|---|---|---|
| 2025-02 | v0.1.1 | 首个开源版本，小红书/抖音/快手/视频号一键发布 |
| 2025-09 | v1.0.18 | 出海版，新增 Facebook/Instagram/X/TikTok/YouTube 等 |
| 2025-11 | v1.3.2 | 首个完全可用的开源版本 |
| 2025-12 | v1.4.3 | "All In Agent"，加入自动内容生成和发布 Agent |
| 2026-02 | v1.8.0 | 线下商户推广解决方案 |
| 2026-03 | v2.1.0 | 内容交易市场上线 + MCP 协议 + OpenClaw 支持 |
七、如何深入学习的路线建议
第一步：跑起来。按照 README 的方式④，用 git clone + docker compose up -d 先把整个系统跑起来，感受完整功能链路。
第二步：理解后端核心业务。从 aitoearn-server/src/core/channel/ 入手，这是整个项目最核心、也最复杂的部分——各社交平台的 OAuth 授权和内容发布适配逻辑都在这里。再看 publish-record/ 了解发布流水线。
第三步：理解 AI Agent 链路。从 aitoearn-ai/src/core/agent/ 入手，看 Agent 是如何接收任务、调度 AI 模型、生成内容草稿并下发给 server 发布的。
第四步：理解前端架构。从 aitoearn-web/src/app/[lng]/chat/ 开始，这是 Agent 聊天入口，顺着 API 调用链往后捋，可以快速理解前后端交互模式。
第五步：研究 MCP 集成。看 aitoearn-server/src/core/unified-mcp/ 和 libs/nest-mcp/，这是项目技术创新最前沿的部分，也是未来 AI Agent 接入平台的标准范式。
