37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
# 多系统智能体平台 · 重构分支
|
||
|
||
> 本分支**从零开始**，不继承原仓库的提交历史。
|
||
|
||
## 这是什么
|
||
|
||
原 `main` 是「APS 产品 + 内嵌智能体层」的混合实现。本次重构把它拆成两件事：
|
||
|
||
- **平台**：客户端 + 平台服务 + Core + 引擎适配 + Provider 契约。从零重写，TypeScript / Node。
|
||
- **APS**：作为独立业务系统，以现有代码搬迁适配（Python），通过 Provider 契约接入平台。
|
||
|
||
## 分支约定
|
||
|
||
| 分支 | 用途 |
|
||
| --- | --- |
|
||
| `rewrite/platform`（本分支） | 重构实现；提交历史从首个提交开始 |
|
||
| `main` | 原实现，只读参考；切换前另存为 `legacy/main` 并设为只读 |
|
||
|
||
- 旧代码参考用 `git show main:<path>`，或另开 worktree 检出 `main`。
|
||
- 移植旧逻辑时在提交信息里写明来源，例如 `移植自 main:server/aps_domain/flex.py`——孤儿历史下 `git blame` 追不到来源。
|
||
- 切换时以本分支强推覆盖 `main`（`--force-with-lease`）；切换前必须先把 `main` 备份为 `legacy/main`。
|
||
|
||
## 设计文档
|
||
|
||
设计文档在飞书评审中，评审通过后随本分支的后续提交入库（任务表 A0.10）。在此之前仓库里没有设计文档是正常的。
|
||
|
||
## 目录规划
|
||
|
||
```
|
||
client/ 客户端（桌面 Electron 与浏览器共用）
|
||
server/ 平台服务（entry / app / agent / core / provider-sdk / workflows）
|
||
providers/ Provider 适配器（aps / erp / ems）
|
||
contracts/ 客户端与服务端共享的契约
|
||
```
|
||
|
||
骨架随 A1 建立。
|