Coze Studio 源码解析系列

本系列共 10 篇文章，从架构全景到代码细节，系统解析字节跳动扣子开发平台 Coze Studio 的开源代码。适合有 1-3 年经验的开发者深入学习。

系列总览

技术栈：Go 1.24 + React 18 + TypeScript 5.8 + Rush.js Monorepo基础设施：MySQL + Redis + Elasticsearch + Milvus + MinIO + NSQ + etcd核心框架：Eino（Agent 运行时）+ FlowGram（工作流画布引擎）架构模式：DDD 四层架构 + Adapter/Base 分离 + 三层服务依赖编排

文章目录

第一部分：架构全景（第 1-2 篇）

#	标题	核心内容	文件
01	项目总览 — 开篇导读	Coze Studio 是什么、技术栈总览、核心功能一览、学习路线	`01-project-overview.md`
02	整体架构设计 — DDD + 微服务	DDD 分层设计、服务初始化流程、三层依赖编排、依赖注入	`02-architecture-design.md`

第二部分：后端深入（第 3-5 篇）

#	标题	核心内容	文件
03	后端 API 层与中间件链	Hertz 框架、9 层中间件链、双重鉴权、IDL 路由、Handler 设计	`03-backend-api-middleware.md`
04	后端领域模型与业务分层	17 个领域全景、Domain 标准四件套、Agent Flow、CrossDomain	`04-backend-domain-model.md`
05	基础设施层 — 存储与中间件	Docker Compose 服务栈、7 种中间件集成、Infra 接口设计	`05-infra-storage-middleware.md`

第三部分：前端工程（第 6-7 篇）

#	标题	核心内容	文件
06	前端 Monorepo 架构	Rush.js 管理 135+ 包、4 层依赖体系、Adapter/Base 分离、8 个 Scope	`06-frontend-monorepo.md`
07	前端状态管理与组件体系	Zustand 状态管理、Store 设计、Semi Design、Adapter 模式、i18n	`07-frontend-state-components.md`

第四部分：核心业务（第 8-10 篇）

#	标题	核心内容	文件
08	智能体与工作流引擎	Agent 编排全链路、Eino Agent Flow、Workflow 执行引擎、FlowGram 画布、SSE 流式	`08-agent-workflow-engine.md`
09	知识库、插件与 RAG	RAG 全链路、混合检索架构、文档处理管线、插件系统、NL2SQL	`09-knowledge-plugin-rag.md`
10	二次开发指南与最佳实践	环境搭建、新增 API/前端包、测试策略、Schema 管理、贡献指南	`10-development-guide.md`

学习路线图

graph LR    A[第1篇 项目总览] --> B[第2篇 架构设计]    B --> C[第3篇 API与中间件]    C --> D[第4篇 领域模型]    D --> E[第5篇 基础设施]    E --> F[第6篇 Monorepo]    F --> G[第7篇 状态管理]    G --> H[第8篇 Agent与工作流]    H --> I[第9篇 知识库与RAG]    I --> J[第10篇 二次开发]

推荐阅读顺序：

架构师/技术负责人：第 1 → 2 → 4 → 8 篇，快速把握整体设计
后端开发者：第 3 → 4 → 5 → 8 → 9 篇，深入后端实现
前端开发者：第 6 → 7 → 8 篇，聚焦前端工程体系
全栈/二次开发者：第 1 → 2 → 10 篇，快速上手开发

项目信息

GitHub: https://github.com/coze-dev/coze-studio
技术栈: Go + React + TypeScript + Rush.js
许可证: Apache 2.0
版本: v0.5.1

本系列文章基于 Coze Studio v0.5.1 源码编写，所有内容仅供学习交流使用。