中文 · English

一个面向长期存在 Agent 的分布式执行与协作平台：云端统一维护 Agent、Team、Workflow、Memory、Connection、Data Source 与治理，将任务安全调度到本地、边缘、云端和 GPU Runner。

设计基线：v1.0 · 2026-07-31

核心定位

Pamiya 不是新的基础 Agent Loop。默认使用 @earendil-works/pi-agent-core 作为单 Agent Runtime，并通过 Runtime SPI 保持可替换。平台自研和形成壁垒的部分是：

• Multi-Agent 讨论、并行调查、Review、共识与决策；
• 耐久 Workflow、审批、重试和副作用安全；
• 分布式 Runner Registry、Scheduler、协议与本地执行；
• 集中 App OAuth/API Key、Connection、Action Catalog 和授权；
• 集中 Data Source 连接、同步、订阅、ACL 和权限感知检索；
• Memory、Artifact、审计、多租户、用量与 License 治理。

flowchart LR
  U[User / Event] --> A[Agent Service]
  A --> R[Runtime SPI]
  R --> P[Pi Core Adapter]
  A <--> M[Multi-Agent / Review]
  A --> W[Durable Workflow]
  W --> C[Connector Hub]
  W --> D[Data Source Hub]
  W --> S[Scheduler]
  S --> G[Runner Gateway]
  G --> X[Desktop / Edge / Cloud / GPU Runners]

Loading

设计原则

1. Runtime 可替换：Pi 类型不进入 Public API、数据库和领域事件。
2. Agent 选择执行要求，Scheduler 选择具体 Runner。
3. 云端保存权威状态，本地可以保管 Secret、登录态和敏感原始数据。
4. 多 Agent 协作由确定性 Collaboration Engine 调度，而不是无限互聊。
5. Review 是绑定不可变 Target Digest 的一等对象。
6. Connector 凭据永不进入模型上下文。
7. 向量检索不能绕过源端 ACL 和 Data View。
8. 所有外部副作用都经过 Policy、Effect Journal、Idempotency 和 Verification。

完整设计

阅读完整架构与工程设计

该文档包含完整目标系统，不按阶段或批次组织，覆盖：

• Product/Framework 边界；
• Runtime SPI 与 Pi Adapter；
• Agent、Team、Collaboration、Review；
• Tool Gateway；
• Connector Hub 与 OpenConnector Compatibility；
• Data Source Hub；
• Workflow、Runner、Scheduler、Effect Safety；
• Policy、Approval、Memory、Artifact；
• 多租户、数据模型、API、SDK；
• 威胁模型、测试、License 和仓库结构。

技术基线

• Control Plane、Agent/Collaboration/Connector/Data Source：TypeScript + Node.js 22+
• 默认 Agent Runtime：Pi Agent Core，通过 Runtime SPI 接入
• Runner Gateway、Runner Daemon：Go
• 权威数据库：PostgreSQL 16+
• Runner 本地 Journal：SQLite
• Runner 连接：gRPC 双向流 + Protocol Buffers
• Artifact：S3-compatible 或文件后端
• Policy 表达式：受限 CEL
• Telemetry：OpenTelemetry
• Console：TypeScript + React

仓库内容

• 完整设计
• 模块文档索引
• Runner Protocol 草案
• 数据库 Schema 草案
• 多 Agent 与 Connector/Data Source 增量 Schema
• JSON Schemas
• 示例配置
• 技术与 License

License

项目建议采用 Apache License 2.0。Pi Agent Core 使用 MIT License；OpenConnector Compatibility 面向 Apache-2.0 的 OpenConnector。所有直接和间接依赖、Provider Pack、容器构建和分发物必须通过 License Gate、SBOM 与 Third-party Notice 检查。

License 说明是工程合规设计，不构成法律意见。