# 云超服 / PineAgents — 工作区

**OPC 超级个体综合服务平台（云南省 OPC 超级个体综合服务平台，云超服）** 的代码工作区。多仓库组合：后端、核心端、网页展示端彼此独立。

## 组成

- **`PineAgentsServer/`** — 总后端（FastAPI，uv 管理）。
- **`PineAgents/`** — 核心部分：前端 / 桌面端 / CLI 端，含 UI 基调来源 `console/`。
- **`PineAgentsWeb/`** — 网页展示端口（Vite + React 静态站，SPA）。
- **`reference/`** — 参考：`cloud-opc/`（OPC 前端骨架）、`PinePixel/`（园区像素可视化）。
- **`docs/`** — 整体设计与相关文档。

## 快速入口

| 模块 | 命令 |
|------|------|
| 后端 | `cd PineAgentsServer && uv sync && uv run uvicorn app.main:app --port 8090 --reload` |
| 核心 console | `cd PineAgents/console && yarn dev` |
| 网页展示端 | `cd PineAgentsWeb && pnpm install && pnpm run dev` |

## 约定

- 前端 UI 一律沿用 `PineAgents/console/` 主基调。
- 整体设计文档放 `docs/`。
- 各仓库独立提交；详细约定见根目录 `CLAUDE.md`。