Learning OS 本地联调
Learning OS V1 是当前项目配套的学习场景原型，使用 x-boot-cloud 提供系统、AI、学习和应用端服务。
V1 服务范围
V1 使用：
sys-serviceai-servicelearning-serviceapp-api
V1 不需要 admin-api、oss-service、Qdrant、RAG 索引和多 Agent runtime。
本地依赖
- Java 21
- Maven 3.9+
- MySQL 8.x
- Redis 6.x+
- Nacos 2.x
- 可选：Ollama 和本地模型
推荐流程
完整操作以主仓库 docs/project/LEARNING_OS_V1_LOCAL_SETUP.md 为准，核心步骤如下：
bash
cd /Users/zhuxucai/workspace/github/x-boot-cloud
cp scripts/learning-os/env.local.example scripts/learning-os/env.local编辑本地环境变量后，初始化数据库并发布 Nacos 配置：
bash
bash scripts/learning-os/init-db.sh
bash scripts/learning-os/publish-nacos-config.sh启动后端服务：
bash
bash scripts/learning-os/run-local.sh停止服务：
bash
bash scripts/learning-os/stop-local.sh日志默认写入 .logs/learning-os/。
本地地址
仓库文档中的默认本地端口为：
| 服务 | 默认端口 |
|---|---|
app-api | 8080 |
sys-service | 7101 |
ai-service | 7102 |
learning-service | 7103 |
| Web prototype | 5173 |
端口和 Nacos 配置以本地环境为准。
OAuth 与 AI fallback
如果使用 GitHub OAuth，需要配置 Client ID、Client Secret 和回调地址。AI 不可用时，V1 可以根据本地配置使用 fallback 行为；具体规则和检查项请以主仓库联调文档为准。