快速开始

用当前仓库的真实路径启动 WunoOS：PostgreSQL、DatabaseMigrator、Api、Worker、Web 与一个 Active PersonalAssistant。

推荐通过 Aspire AppHost 启动。新数据库没有 Agent 数据时，需要先用管理员进入“智能体管理”创建 Active PersonalAssistant，之后聊天输入才会开放。

前置环境

.NET SDK 10.0.301（由 global.json 固定）。
Node.js 24+ 与 pnpm 11.7.0。
Docker Desktop、OrbStack 或兼容 Docker Engine。
Aspire CLI 13.4.6。

推荐：Aspire 启动

aspire run --apphost WunoOS.AppHost/WunoOS.AppHost.csproj

在 Aspire Dashboard 中等待 database-migrator 完成，然后 Api、Worker 和 Web 会按依赖启动。

命令行质量检查

dotnet restore WunoOS.sln
dotnet build WunoOS.sln --no-restore
dotnet test WunoOS.sln --no-build
pnpm --dir web test
pnpm --dir web run lint:check
pnpm --dir web run format:check
pnpm --dir web run build

Docker Compose

cp docker/.env.example .env
docker compose up -d --build --wait

可选 knowledge profile 只启动 Milvus/Neo4j/MinIO 等基础设施，不表示完整 Knowledge Runtime 已接入 Agent。

下一步

继续阅读运行第一个智能体、智能体总览与系统架构。