本地开发

约 431 字大约 1 分钟

项目包含 Go 微服务、React 桌面客户端、React 管理后台、Vue 管理后台对照版本，以及独立文档工程。推荐使用仓库根目录的 process-compose.yaml 一次性拉起后端，前端按需独立启动。

前置环境

Go：版本以各服务 go.mod 和构建脚本为准。
Node.js：桌面端和文档站要求 Node.js 20+；文档站要求 >=20.19。
Docker Desktop：运行 MySQL、Redis、Qdrant 或执行容器化部署验证时需要。
PowerShell：Windows 本地编排和打包脚本使用 PowerShell。

启动后端编排

process-compose.yaml 定义了预检查、构建、数据库迁移及各服务的健康依赖。执行前准备根目录 .env 中需要的开发配置，然后启动：

process-compose up

它会依次执行预检查、构建服务、迁移数据库，并启动 user、generation、ai-control、media、workspace、workflow、billing、platform-config、story、agent 和 gateway 服务。健康检查端口为 20000 至 20009，Gateway 为 9999。

启动桌面客户端

Set-Location desktop_client_app
npm install
npm run dev

仅调试渲染层：

npm run dev:web

桌面端 Web 开发服务固定监听 127.0.0.1:5174。

启动 React 管理后台

Set-Location fronted_admin_web
npm ci
npm run dev

旧版 Vue 管理后台仅用于并行对照：

Set-Location fronted_admin_web_vue
npm install
npm run dev

启动本手册站

Set-Location frameai-docs
npm install
npm run dev

访问 http://127.0.0.1:3201/。

提交前检查

按变更范围运行检查，不必为文档改动构建全部服务：

Set-Location desktop_client_app; npm run typecheck
Set-Location fronted_admin_web; npm run build
Set-Location database; go test ./...; go vet ./...
Set-Location frameai-docs; npm run build