当前位置：首页 > news >正文

Coze Studio概览（一）

news 2025/7/28 15:25:49

字节的Coze刚开源，我先给大家来一波简要分析。

Coze Studio 技术栈详情

后端技术栈

核心技术

Go版本: 1.24.0
Web框架: Cloudwego Hertz (高性能HTTP框架)
架构模式: 微服务架构 + DDD（领域驱动设计）

主要依赖库

AI引擎: Cloudwego Eino (AI智能体和工作流运行时)
模型支持:
- OpenAI、Claude、DeepSeek、Gemini
- 火山方舟(Ark)、通义千问等
数据库: GORM (MySQL/SQLite驱动)
缓存: Redis (go-redis/v9)
消息队列: Kafka (IBM/sarama)、RocketMQ
搜索引擎: Elasticsearch
向量数据库: Milvus
对象存储: 火山引擎TOS、MinIO
配置管理: Viper、YAML
测试框架: Testify、GoMock

项目结构

backend/
├── api/           # API层 (Handler, Router, Middleware)
├── application/   # 应用层 (Application Services)
├── domain/        # 领域层 (Domain Models, Entities)
├── infra/         # 基础设施层 (Repository实现)
├── crossdomain/   # 跨域服务
├── pkg/           # 通用工具包
├── conf/          # 配置文件
└── types/         # 类型定义

前端技术栈

核心技术

包管理: Rush.js (Microsoft的monorepo管理工具)
Node版本: >=16.13.0
包管理器: pnpm 8.15.8
构建工具: Rsbuild (基于Rspack的构建工具)
UI框架: React + TypeScript
工作流编辑器: FlowGram (字节跳动开源的流程搭建引擎)

主要依赖

UI组件库: Semi Design (@coze-arch/bot-semi)
状态管理: 自研Store系统
国际化: @coze-arch/i18n
HTTP客户端: @coze-arch/bot-http
代码编辑器: Monaco Editor
工作流渲染: FlowGram + Fabric.js

项目结构

frontend/
├── apps/          # 应用入口
├── packages/      # 功能包
│   ├── arch/      # 架构层基础包
│   ├── common/    # 通用组件和工具
│   ├── workflow/  # 工作流相关
│   ├── agent-ide/ # 智能体IDE
│   └── studio/    # Studio核心功能
├── config/        # 配置文件
└── infra/         # 基础设施工具

数据存储

主要存储

关系数据库: MySQL 8.4.5
缓存数据库: Redis 8.0
搜索引擎: Elasticsearch
向量数据库: Milvus (用于知识库检索)

对象存储

火山引擎TOS (主要)
MinIO (可选)

部署方案

容器化

容器: Docker + Docker Compose
最低配置: 2 Core、4 GB内存
服务编排: 支持多Profile部署
- middleware: 中间件服务
- mysql-setup: 数据库初始化
- web: 完整Web服务

Coze Studio 命令清单

开发环境搭建

前置要求

# 确保系统满足最低要求：2 Core、4 GB内存
# 安装Docker和Docker Compose并启动Docker服务
docker --version
docker-compose --version

快速开始

# 1. 克隆代码
git clone https://github.com/coze-dev/coze-studio.git
cd coze-studio# 2. 配置模型 (必须步骤)
# 复制模型配置模板
cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml
# 编辑配置文件，设置id、meta.conn_config.api_key、meta.conn_config.model字段# 3. 部署并启动服务
cd docker
cp .env.example .env
docker compose --profile "*" up -d# 4. 访问应用
# 浏览器打开 http://localhost:8888/

开发模式命令

使用Makefile (推荐)

# 启动完整开发环境 (中间件 + Python + 服务器)
make debug# 单独构建前端
make fe# 单独构建并运行服务器
make server# 仅构建服务器(不运行)
make build_server# 启动中间件服务 (MySQL + Redis + Elasticsearch等)
make middleware# 启动完整Web服务
make web# 同步数据库
make sync_db# 导出数据库结构
make dump_db# 停止所有服务
make down# 清理所有数据(危险操作)
make clean# 设置Python环境
make python# 查看帮助
make help

直接使用脚本

# 前端相关
./scripts/setup_fe.sh    # 设置前端环境
./scripts/build_fe.sh    # 构建前端
./scripts/start_fe.sh    # 启动前端开发服务器# 后端相关
./scripts/setup/server.sh        # 构建服务器
./scripts/setup/db_migrate_apply.sh  # 数据库迁移
./scripts/setup/python.sh       # 设置Python环境

前端开发命令

使用Rush.js

cd frontend# 安装依赖
rush install# 构建所有包
rush rebuild# 构建特定应用
rush rebuild -o @coze-studio/app# 运行开发服务器
rush start -p @coze-studio/app# 运行测试
rush test# 代码检查
rush lint# 代码格式化
rush prettier

后端开发命令

Go开发

cd backend# 安装依赖
go mod download# 构建
go build -o bin/coze-server .# 运行
./bin/coze-server# 测试
go test ./...# 代码格式化
go fmt ./...# 代码检查
go vet ./...

Docker命令

开发环境

# 启动所有服务
docker compose --profile "*" up -d# 启动特定Profile
docker compose --profile middleware up -d    # 仅中间件
docker compose --profile mysql-setup up -d  # 仅MySQL设置# 查看服务状态
docker compose ps# 查看日志
docker compose logs -f# 停止服务
docker compose down# 清理数据卷
docker compose down -v

数据库操作

# 数据库迁移
docker compose --profile mysql-setup up -d# 查看MySQL日志
docker logs coze-mysql# 连接MySQL
docker exec -it coze-mysql mysql -ucoze -pcoze123 opencoze

Git工作流

# 标准工作流
git checkout -b feature/your-feature
git add .
git commit -m "feat: your feature description"
git push origin feature/your-feature# 提交前检查
rush lint          # 代码检查
rush test          # 运行测试
go test ./...      # 后端测试