AI 原生开放教材

外观

Coze Loop 源码研读源码研读·中英混排原文 ↗仓库 ↗

CozeLoop ​

🧭 CozeLoop - 智能化的 AI 提示工程与评估平台

📖 项目简介 ​

CozeLoop 是一个专业的 AI 提示工程与评估平台，为开发者和研究人员提供完整的 AI 应用开发工具链。平台集成了提示开发、模型评估、实验管理、可观测性监控等核心功能，帮助用户高效构建和优化 AI 应用。

✨ 核心功能 ​

🎯 提示工程 (Prompt Engineering) ​

  • 提示开发: 可视化的提示编辑器，支持多种模板和变量
  • Playground: 实时测试和调试提示效果
  • 版本管理: 提示版本控制和历史记录追踪

📊 评测系统 (Evaluation) ​

  • 评测数据集: 创建和管理测试数据集
  • 评估器: 自定义评估指标和规则
  • 实验管理: 批量实验执行和结果分析

🔍 可观测性 (Observability) ​

  • 链路追踪: 完整的请求链路监控
  • 性能分析: 实时性能指标和报告
  • 日志管理: 结构化日志收集和查询

🏷️ 标签管理 (Tag Management) ​

  • 标签系统: 灵活的资源分类和组织
  • 权限控制: 基于标签的访问控制
  • 批量操作: 高效的标签批量管理

🏗️ 技术架构 ​

前端技术栈 ​

  • 框架: React 18.2 + TypeScript 5.8
  • 构建工具: Rsbuild 1.1
  • 路由: React Router 6.22
  • 状态管理: Zustand 4.4
  • 样式: Tailwind CSS 3.3 + Less
  • 组件库: @coze-arch/coze-design
  • 国际化: 内置 i18n 支持

后端技术栈 ​

  • 语言: Go
  • 框架: Hertz (CloudWeGo)
  • 数据库: MySQL + ClickHouse
  • 缓存: Redis
  • 消息队列: RocketMQ
  • 微服务: Kitex (CloudWeGo)

项目结构 ​

frontend/apps/cozeloop/
├── src/
│   ├── components/          # 通用组件
│   │   ├── basic-layout/    # 基础布局
│   │   ├── navbar/          # 导航栏
│   │   └── user-info-section/ # 用户信息
│   ├── routes/              # 路由配置
│   ├── hooks/               # 自定义 Hooks
│   ├── constants/           # 常量定义
│   └── assets/              # 静态资源
├── config/                  # 配置文件
└── package.json

🚀 快速开始 ​

环境要求 ​

  • Node.js >= 18
  • pnpm >= 8
  • Go >= 1.19 (后端开发)

安装依赖 ​

bash
# 安装前端依赖
pnpm install

# 安装后端依赖 (如需本地开发)
cd ../../backend && go mod download

开发模式 ​

bash
# 启动开发服务器 (中国区 BOE 环境)
npm run dev

# 启动开发服务器 (中国区)
npm run dev:cn

# 启动开发服务器 (中国区生产环境)
npm run dev:cn-release

构建部署 ​

bash
# 构建生产版本
npm run build

# 预览构建结果
npm run preview

# 分析构建包大小
npm run analyze

🧪 测试与质量 ​

代码检查 ​

bash
# ESLint 检查
npm run lint

# 运行测试
npm run test

# TypeScript 类型检查
npm run build:ts

代码规范 ​

  • 遵循 Conventional Commits 规范
  • 使用 ESLint + Prettier 进行代码格式化
  • 支持 Stylelint 样式检查
  • 集成 Vitest 单元测试框架

📦 依赖说明 ​

核心依赖 ​

  • react & react-dom: React 框架
  • react-router-dom: 路由管理
  • zustand: 轻量级状态管理
  • ahooks: React Hooks 工具库
  • classnames: CSS 类名工具
  • immer: 不可变数据处理

内部包依赖 ​

  • @cozeloop/*: CozeLoop 业务模块包
  • @coze-arch/*: Coze 架构基础包

🌍 国际化 ​

项目支持多语言国际化，通过 @cozeloop/i18n-adapter 实现：

  • 中文 (简体)
  • 英文
  • 其他语言扩展支持

🔧 配置说明 ​

环境变量 ​

  • REGION: 部署区域 (cn/us/eu)
  • CUSTOM_VERSION: 自定义版本 (inhouse/release)
  • BUILD_TYPE: 构建类型 (online/offline)
  • BUNDLE_ANALYZE: 是否启用构建分析

构建配置 ​

  • rsbuild.config.ts: Rsbuild 构建配置
  • tailwind.config.ts: Tailwind CSS 配置
  • tsconfig.json: TypeScript 配置

🤝 贡献指南 ​

我们欢迎社区贡献！请查看 CONTRIBUTING.md 了解详细的贡献指南。

开发流程 ​

  1. Fork 项目仓库
  2. 创建功能分支: git checkout -b feat/your-feature
  3. 提交更改: git commit -m 'feat: add some feature'
  4. 推送分支: git push origin feat/your-feature
  5. 创建 Pull Request

📄 许可证 ​

本项目采用 Apache 2.0 许可证。

🔗 相关链接 ​

⬆ 回到顶部

Made with ❤️ by the CozeLoop Team