Initial commit

README.md

@@ -0,0 +1,25 @@
+# 云超服 / 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`。