aps-agent/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 建立。