aps-agent/server/README.md

22 lines
1014 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# @aps/server
平台服务。目录按架构设计第 2 节建立,各模块的边界与「不该出现什么」以该节为准。
| 目录 | 职责 | 不该出现什么 |
| --- | --- | --- |
| `entry/` | HTTP / SSE 入口、会话、鉴权 | 业务规则、直接调业务系统 |
| `app/` | 请求编排、能力查询、审批流转、事件推送 | 引擎内部概念、直接 import Pi |
| `agent/` | 引擎适配:`AgentRuntime` 接口 + Pi / Codex 实现 | 业务规则、碰凭据 |
| `core/` | 能力目录、身份映射、策略、凭据、执行、审计 | 业务数据、直接拼业务系统 URL |
| `workflows/` | 跨系统顺序流程 | 配置化 DAG 引擎 |
依赖方向(A1.2 会接入 CI 检查):
```
contracts ← provider-sdk ← server ← client
↑
providers/*
```
- `providers/*` 只依赖 `@aps/provider-sdk`(与 `@aps/contracts`),不依赖 `@aps/server`
- 只有 `agent/` 允许 import 引擎包;其它模块必须经这一层