# 云超服 / PineAgents — 工作区

**云南省 OPC 超级个体综合服务平台（云超服）** 及其配套业务（园区大屏展播、OPC 培训体系、资料搜集）的工作区根目录。

> 目录按 **代码 / 设计 / 资料** 三桶分层，各仓库独立跟踪。详细约定见根目录 `CLAUDE.md`。

## 顶层结构

| 目录 | 说明 |
|------|------|
| `code/` | **代码（按端口命名）**：`agent-desktop`（智能体桌面）、`server-core`（核心服务端）、`web-official`（官网展示端）、`park-desktop`（园区大屏）、`training`（培训前端：小程序/网站）、`bark-notify`（临时测试，非项目） |
| `design/` | **设计与架构文档**：`云超服平台/`、`dpm/` |
| `materials/` | **资料/内容**：`培训计划/`（课程内容）、`搜集资料/`（云南 OPC 政策）、`园区数据资料/` |
| `reference/` | **参考源**：`cloud-opc/`（OPC 前端骨架）、`PinePixel/`（园区像素可视化） |

## 快速入口

| 模块 | 命令 |
|------|------|
| 核心服务端（统一对外） | `cd code/server-core && uv sync && uv run uvicorn dispatcher:app --host 0.0.0.0 --port 8090 --reload` |
| 算力引擎（new-api 微服务） | `cd code/compute-engine && cp .env.example .env && docker compose up -d`（详见 `README.云超服.md`） |
| 智能体桌面 console | `cd code/agent-desktop/console && yarn dev` |
| 官网展示端 | `cd code/web-official && pnpm install && pnpm run dev` |
| 园区大屏后端 | `cd code/park-desktop/backend && uv run python main.py` |
| 培训网站前端 | `cd code/training/website && pnpm dev` |
| 培训小程序 | `cd code/training/miniprogram && yarn dev:weapp` |

## 约定

- 前端 UI 一律沿用 `code/agent-desktop/console/` 主基调。
- 设计文档放 `design/`，代码放 `code/`，资料/内容放 `materials/`，不得混放。
- 各仓库独立提交；详细约定见根目录 `CLAUDE.md`。