章节 01
导读 / 主楼:CentrAI Chat:开源的集中式 AI 对话平台
CentrAI Chat 是一个开源的集中式 AI 对话平台,采用 Next.js 15 + NestJS 11 技术栈,支持多租户、多模型提供商管理,适合企业或团队统一部署 AI 服务。
正文
CentrAI Chat 是一个开源的集中式 AI 对话平台,采用 Next.js 15 + NestJS 11 技术栈,支持多租户、多模型提供商管理,适合企业或团队统一部署 AI 服务。
章节 01
CentrAI Chat 是一个开源的集中式 AI 对话平台,采用 Next.js 15 + NestJS 11 技术栈,支持多租户、多模型提供商管理,适合企业或团队统一部署 AI 服务。
章节 02
\ncentrai-chat/\n├── apps/\n│ ├── api/ # NestJS 后端 (端口 4000)\n│ └── web/ # Next.js 前端 (端口 3000)\n├── packages/\n│ ├── config/ # 共享 tsconfig、prettier 配置\n│ └── types/ # 共享 TypeScript 类型 + Zod schemas\n├── docs/ # 架构文档、范围定义、MVP 计划\n├── turbo.json # Turborepo 流水线配置\n└── pnpm-workspace.yaml\n\n\n这种结构的好处是前后端可以共享类型定义和配置,同时保持各自的独立性。packages/types 中定义的 Zod schema 可以同时用于前端的表单验证和后端的 API 校验,确保数据一致性。\n\n## 核心功能设计\n\n从 API 设计可以看出平台的核心功能:\n\n用户认证系统:支持邮箱密码注册登录、Google OAuth、GitHub OAuth。JWT 双 token 机制(access + refresh)提供了安全的会话管理。\n\n管理员能力:虽然没有在 README 中详细列出,但从"Admins configure providers and publish agents"可以看出,管理员可以配置 AI 模型提供商(如 OpenAI、Anthropic 等)、创建和发布代理(预设提示词和工具配置的 AI 助手)。\n\n用户能力:终端用户可以查看已发布的代理列表、与代理或启用的模型进行对话、查看自己的对话历史。\n\n健康检查:提供 /health 和 /health/ready 端点,便于容器化部署时的存活探针和就绪探针配置。\n\n## 快速开始\n\n项目要求 Node.js >= 20、pnpm >= 9、PostgreSQL 15+。启动流程相对标准:\n\nbash\npnpm install\ncp .env.example .env\npnpm db:generate\npnpm db:migrate\npnpm db:seed\npnpm dev\n\n\n数据库 seed 会创建默认工作区和管理员用户(admin@centrai.local / Admin123!),方便初次体验。\n\n## 应用场景\n\nCentrAI Chat 适合以下场景:\n\n企业内部 AI 平台:IT 部门统一部署,员工按需使用,避免每个人单独申请 API 密钥。\n\n多租户 SaaS:基于工作区机制,可以为不同团队或客户提供隔离的 AI 服务。\n\n代理市场:管理员可以创建各种专业代理(如代码审查助手、文案生成器等),用户按需选择。\n\n成本管控:集中管理可以更好地监控 token 使用量,设置预算限制。\n\n## 与同类项目的对比\n\n相比个人使用的 AI 客户端(如 OpenClaw、Paprwork),CentrAI Chat 更侧重于管理和治理。它不提供本地模型支持,而是专注于云端模型的集中管理。相比商业产品如 ChatGPT Enterprise,CentrAI Chat 是开源的,可以自托管,数据完全掌控在自己手中。\n\n## 当前状态与展望\n\n从文档结构来看,项目还处于早期阶段,有详细的 Scope、Architecture 和 MVP 计划文档。这意味着核心功能可能还在开发中,但架构设计已经比较清晰。对于希望参与开源项目或寻找企业 AI 平台解决方案的开发者来说,这是一个值得关注的项目。\n\n## 总结\n\nCentrAI Chat 代表了一种务实的 AI 平台化思路——不追求花哨的功能,而是解决企业 AI 采用中的实际痛点:管理、安全、成本。通过现代化的技术栈和清晰的架构设计,它为构建企业级 AI 对话平台提供了一个良好的起点。章节 03
项目定位与核心价值\n\nCentrAI Chat 是一个开源的集中式 AI 对话平台,其设计理念是将所有 AI 交互、代理和工作流整合到一个可扩展的系统中。与面向个人用户的 AI 客户端不同,CentrAI Chat 更侧重于企业或团队场景——管理员可以统一配置模型提供商、发布代理,而终端用户只需登录即可使用已发布的代理或启用的模型,并查看自己的对话历史。\n\n这种模式解决了企业 AI 采用中的一个常见问题:分散的 AI 工具使用导致管理困难、成本不可控、数据安全风险增加。通过集中式平台,IT 部门可以统一管理 API 密钥、监控使用情况、确保合规性,同时用户仍然可以享受到便捷的 AI 服务。\n\n技术栈选择\n\nCentrAI Chat 采用了现代且成熟的技术栈:\n\n前端:Next.js 15(App Router)、Tailwind CSS 4、React 19。Next.js 15 的 App Router 提供了更好的性能和更简洁的路由模型,React 19 则带来了改进的并发特性和自动记忆化。\n\n后端:NestJS 11、Prisma 6、PostgreSQL。NestJS 提供了模块化的架构和依赖注入,非常适合构建可维护的企业级应用。Prisma 作为 ORM 提供了类型安全的数据库访问。\n\n认证:JWT(access + refresh token)、Passport.js(支持本地、Google、GitHub 登录)。双 token 机制兼顾了安全性和用户体验。\n\n** monorepo 管理**:Turborepo + pnpm workspaces。这种组合提供了高效的依赖管理和构建缓存,适合前后端共享代码的场景。\n\n项目结构\n\n代码库采用清晰的 monorepo 结构:\n\n\ncentrai-chat/\n├── apps/\n│ ├── api/ NestJS 后端 (端口 4000)\n│ └── web/ Next.js 前端 (端口 3000)\n├── packages/\n│ ├── config/ 共享 tsconfig、prettier 配置\n│ └── types/ 共享 TypeScript 类型 + Zod schemas\n├── docs/ 架构文档、范围定义、MVP 计划\n├── turbo.json Turborepo 流水线配置\n└── pnpm-workspace.yaml\n\n\n这种结构的好处是前后端可以共享类型定义和配置,同时保持各自的独立性。packages/types 中定义的 Zod schema 可以同时用于前端的表单验证和后端的 API 校验,确保数据一致性。\n\n核心功能设计\n\n从 API 设计可以看出平台的核心功能:\n\n用户认证系统:支持邮箱密码注册登录、Google OAuth、GitHub OAuth。JWT 双 token 机制(access + refresh)提供了安全的会话管理。\n\n管理员能力:虽然没有在 README 中详细列出,但从"Admins configure providers and publish agents"可以看出,管理员可以配置 AI 模型提供商(如 OpenAI、Anthropic 等)、创建和发布代理(预设提示词和工具配置的 AI 助手)。\n\n用户能力:终端用户可以查看已发布的代理列表、与代理或启用的模型进行对话、查看自己的对话历史。\n\n健康检查:提供 /health 和 /health/ready 端点,便于容器化部署时的存活探针和就绪探针配置。\n\n快速开始\n\n项目要求 Node.js >= 20、pnpm >= 9、PostgreSQL 15+。启动流程相对标准:\n\nbash\npnpm install\ncp .env.example .env\npnpm db:generate\npnpm db:migrate\npnpm db:seed\npnpm dev\n\n\n数据库 seed 会创建默认工作区和管理员用户(admin@centrai.local / Admin123!),方便初次体验。\n\n应用场景\n\nCentrAI Chat 适合以下场景:\n\n企业内部 AI 平台:IT 部门统一部署,员工按需使用,避免每个人单独申请 API 密钥。\n\n多租户 SaaS:基于工作区机制,可以为不同团队或客户提供隔离的 AI 服务。\n\n代理市场:管理员可以创建各种专业代理(如代码审查助手、文案生成器等),用户按需选择。\n\n成本管控:集中管理可以更好地监控 token 使用量,设置预算限制。\n\n与同类项目的对比\n\n相比个人使用的 AI 客户端(如 OpenClaw、Paprwork),CentrAI Chat 更侧重于管理和治理。它不提供本地模型支持,而是专注于云端模型的集中管理。相比商业产品如 ChatGPT Enterprise,CentrAI Chat 是开源的,可以自托管,数据完全掌控在自己手中。\n\n当前状态与展望\n\n从文档结构来看,项目还处于早期阶段,有详细的 Scope、Architecture 和 MVP 计划文档。这意味着核心功能可能还在开发中,但架构设计已经比较清晰。对于希望参与开源项目或寻找企业 AI 平台解决方案的开发者来说,这是一个值得关注的项目。\n\n总结\n\nCentrAI Chat 代表了一种务实的 AI 平台化思路——不追求花哨的功能,而是解决企业 AI 采用中的实际痛点:管理、安全、成本。通过现代化的技术栈和清晰的架构设计,它为构建企业级 AI 对话平台提供了一个良好的起点。