Industry
/
aps-agent
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
22 Commits 3 Branches 0 Tags 61 MiB
Python 76.5%
TypeScript 13.6%
JavaScript 5%
HTML 3.2%
CSS 1.6%
Go to file
zh 2d0fdd2c50 docs: ADR-0008 数据库归属与实例拓扑、平台与业务能力边界、单机版口径 
ADR-0008：库各自私有、允许共用实例、平台禁止直连 APS 库，并纠正「单机版」口径（客户端与平台服务同机，不含 APS）。新增 docs/spec/platform-vs-business.md 作为拆分判据（三分类 + 三个判据 + 四项已确认边界）。术语表修正 Pi 的描述（长驻子进程 + 扩展桥），补单机版/服务端版。实施设计 9.5 补进程创建时机：首次发消息时懒启动。
 		2026-09-24 13:51:39 +08:00
.github/workflows feat(ci): 依赖方向检查与负例用例接入 CI（A1.2） 2026-09-23 19:31:13 +08:00
client feat(workspace): pnpm monorepo 骨架与包边界（A1.1） 2026-09-23 19:29:57 +08:00
contracts feat(contracts): 补齐 HTTP 契约与端点一致性检查（A1.8） 2026-09-23 20:52:24 +08:00
docs docs: ADR-0008 数据库归属与实例拓扑、平台与业务能力边界、单机版口径 2026-09-24 13:51:39 +08:00
providers/aps feat(workspace): pnpm monorepo 骨架与包边界（A1.1） 2026-09-23 19:29:57 +08:00
scripts feat(contracts): 补齐 HTTP 契约与端点一致性检查（A1.8） 2026-09-23 20:52:24 +08:00
server feat(workspace): pnpm monorepo 骨架与包边界（A1.1） 2026-09-23 19:29:57 +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: 按新结构重写 .gitignore 2026-09-23 21:02:10 +08:00
README.md docs: 设计文档随分支入库（A0.10） 2026-09-23 19:37:16 +08:00
package.json feat(contracts): 客户端与服务端协议 v1 及事件模型（A1.7） 2026-09-23 20:00:47 +08:00
pnpm-lock.yaml feat(contracts): 客户端与服务端协议 v1 及事件模型（A1.7） 2026-09-23 20:00:47 +08:00
pnpm-workspace.yaml feat(workspace): pnpm monorepo 骨架与包边界（A1.1） 2026-09-23 19:29:57 +08:00
tsconfig.base.json feat(workspace): pnpm monorepo 骨架与包边界（A1.1） 2026-09-23 19:29:57 +08:00
tsconfig.json feat(workspace): pnpm monorepo 骨架与包边界（A1.1） 2026-09-23 19:29:57 +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。

设计文档

文档 位置
架构设计 docs/architecture.md
实施设计 docs/implementation.md
架构决策记录 docs/adr/
术语与边界一页纸 docs/glossary.md
A0-G 评审材料与结论 docs/review/
能力描述规范 docs/spec/capability-description.md
问法评测集 docs/eval/

两份设计文档由飞书文档导入（A0-G 评审快照，2026-09-23）。导入后以仓库版本为准，改动走提交与 ADR 流程。

目录与包

一个 pnpm monorepo，四个一级目录（架构设计第 2 节）：

contracts/                @aps/contracts      共享契约（只有类型，无运行时依赖）
server/                   @aps/server         平台服务：entry / app / agent / core / workflows
server/provider-sdk/      @aps/provider-sdk   业务系统接入平台的契约与契约测试
providers/aps/            @aps/provider-aps   APS 适配器（ERP / EMS 同构）
client/app/               @aps/client-app     界面：对话、工作区、审批
client/desktop/           @aps/desktop        Electron 壳：窗口、本地守护、离线升级
docs/                                         架构、ADR、规范与评测集

依赖方向（A1.2 接入 CI 检查）：

contracts  ←  provider-sdk  ←  server  ←  client
                    ↑
              providers/*

快速开始

pnpm install        # 需要 Node >= 22.19.0
pnpm typecheck      # 等价于 tsc -b，按项目引用顺序构建全部包

开发约定

约定 出处
能力命名与描述七要素 docs/spec/capability-description.md
问法评测集与门槛 docs/eval/README.md
数据存储写法（整数毫秒、应用侧主键、JSONB/TEXT） docs/adr/0007-storage-and-consistency.md
架构决策记录 docs/adr/（写完不改，改结论就新写一份）