Go to file
zh 8d261afbbc docs(adr): 补齐 ADR-0002/0003/0004(部署形态、数据作用域、桌面端边界) 2026-09-22 18:33:22 +08:00
docs/adr docs(adr): 补齐 ADR-0002/0003/0004(部署形态、数据作用域、桌面端边界) 2026-09-22 18:33:22 +08:00
.dockerignore chore: 从零开始重构(首个提交) 2026-09-22 17:46:56 +08:00
.env.example chore: 从零开始重构(首个提交) 2026-09-22 17:46:56 +08:00
.gitignore chore: 从零开始重构(首个提交) 2026-09-22 17:46:56 +08:00
README.md chore: 从零开始重构(首个提交) 2026-09-22 17:46:56 +08:00

README.md

多系统智能体平台 · 重构分支

本分支从零开始,不继承原仓库的提交历史。

这是什么

原 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 建立。