Pine
daf3532120
- 总设计文档迁至根目录（云超服一体化架构设计方案.md，figures/ 随迁） - 设计文档补充 §十二 各代码项目工作原理 - code 六个子项目转独立仓库（组织 Pine），移出根跟踪、保留文件夹 - CLAUDE.md 补充主项目/子项目约束（分别提交、同步全子项目）
33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# 云超服 / 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`。
|