2026-08-19 20:54:01 +08:00
|
|
|
|
# 云超服 / PineAgents — 工作区
|
|
|
|
|
|
|
2026-08-23 12:23:34 +08:00
|
|
|
|
**云南省 OPC 超级个体综合服务平台（云超服）** 及其配套业务（园区大屏展播、OPC 培训体系、资料搜集）的工作区根目录。
|
2026-08-19 20:54:01 +08:00
|
|
|
|
|
2026-08-23 12:23:34 +08:00
|
|
|
|
> 目录按 **代码 / 设计 / 资料** 三桶分层，各仓库独立跟踪。详细约定见根目录 `CLAUDE.md`。
|
2026-08-19 20:54:01 +08:00
|
|
|
|
|
2026-08-23 12:23:34 +08:00
|
|
|
|
## 顶层结构
|
|
|
|
|
|
|
|
|
|
|
|
| 目录 | 说明 |
|
|
|
|
|
|
|------|------|
|
2026-08-23 22:47:22 +08:00
|
|
|
|
| `code/` | **代码（按端口命名）**：`agent-desktop`（智能体桌面）、`server-core`（核心服务端）、`web-official`（官网展示端）、`park-desktop`（园区大屏）、`training`（培训前端：小程序/网站）、`bark-notify`（临时测试，非项目） |
|
2026-08-23 12:23:34 +08:00
|
|
|
|
| `design/` | **设计与架构文档**：`云超服平台/`、`dpm/` |
|
|
|
|
|
|
| `materials/` | **资料/内容**：`培训计划/`（课程内容）、`搜集资料/`（云南 OPC 政策）、`园区数据资料/` |
|
|
|
|
|
|
| `reference/` | **参考源**：`cloud-opc/`（OPC 前端骨架）、`PinePixel/`（园区像素可视化） |
|
2026-08-19 20:54:01 +08:00
|
|
|
|
|
|
|
|
|
|
## 快速入口
|
|
|
|
|
|
|
|
|
|
|
|
| 模块 | 命令 |
|
|
|
|
|
|
|------|------|
|
2026-08-23 22:47:22 +08:00
|
|
|
|
| 核心服务端（统一对外） | `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` |
|
2026-08-19 20:54:01 +08:00
|
|
|
|
|
|
|
|
|
|
## 约定
|
|
|
|
|
|
|
2026-08-23 22:47:22 +08:00
|
|
|
|
- 前端 UI 一律沿用 `code/agent-desktop/console/` 主基调。
|
2026-08-23 12:23:34 +08:00
|
|
|
|
- 设计文档放 `design/`，代码放 `code/`，资料/内容放 `materials/`，不得混放。
|
2026-08-19 20:54:01 +08:00
|
|
|
|
- 各仓库独立提交；详细约定见根目录 `CLAUDE.md`。
|
