# code/ — 代码仓库

本目录集中存放云超服工作区内的**一切可运行代码 / 代码仓库**，按「代码 / 设计 / 资料」分桶规范与 `design/`（设计文档）、`materials/`（资料内容）隔离。

> 目录规范见根 `CLAUDE.md`。各子项目内部文档以各自 `README.md` / `AGENTS.md` 为准。

## 子项目索引

> 目录按「端口/终端」命名。各仓库独立跟踪。

| 目录 | 说明 | 跟踪 |
|------|------|------|
| `agent-desktop/` | **智能体桌面应用**（原 PineAgents）：Agent OS + console + Tauri 壳。 | 独立仓库 |
| `server-core/` | **核心服务端**（原 PineAgentsServer）：身份/平台 API + 培训子应用（`app/training`），统一对外 `opc.pinesound.cn`（`dispatcher.py` 入口）。 | 独立仓库 |
| `compute-engine/` | **算力引擎微服务**（new-api，原 `reference/new-api`）：OpenAI 兼容 `/v1` 模型中继 + 额度/令牌/流水；**仅服务，管理/页面自研**。启动见 `README.云超服.md`。 | 根仓库 |
| `web-official/` | **官网展示端**（原 PineAgentsWeb）：Vite + React SPA。 | 独立仓库 |
| `park-desktop/` | **园区大屏桌面应用**（原 dpm）：Tauri + React 大屏 + FastAPI 后端，多园区通用。 | 独立仓库 |
| `training/` | **培训前端**（原 opc-training，后端已并入 server-core）：`miniprogram/`（小程序）、`website/`（业务 Web）。 | 根仓库 |
| `bark-notify/` | Bark 推送工具（**临时测试，非项目**，勿纳入）。 | 根仓库 |

## 关联位置

- 各项目对应的**设计 / 架构文档**：见 `design/`（DPM 文档在 `design/dpm/`，云超服文档在 `design/云超服平台/`）。
- 培训系统对应的**课程内容**（模板 / 知识库 / 配套件）：见 `materials/培训计划/`。
- 云超服平台整体设计总览：见 `design/云超服平台/云超服一体化架构设计方案.md`。