路线图与设计决策

这页把 生态对比与发展方向 的定位落到工程顺序。目标不是把 iamai 做成全功能平台， 而是稳定一个安全、可测试、可嵌入的 Python + Rust runtime/agent runtime。

版本路线图

0.1

shipped 建立 Rust + PyO3 消息核心、Python runtime、插件与适配器基础契约。

0.2

shipped 补齐规则、权限、中间件、状态后端、适配器 conformance tests、Telegram/Webhook 支持、 社区商店和管理命令。

0.3

current 提供 tool registry、agent permission、审计 trace、MCP gateway、管理 HTTP API 和多种 Agent runtime 示例；同时为 handler 并发和 Session backlog 加入可配置资源边界。

0.4

planned 稳定第三方适配器与插件的独立包发布规范，扩展 conformance tests，并提供配置 schema 导出。 WebUI 不进入核心；如果需要 UI，应作为独立插件或独立项目调用管理 API。

1.0

planned 冻结核心公共 API，发布兼容性规范，并明确 0.x 到 1.x 的迁移窗口。

设计决策

核心 API 先少后稳

Adapter.start、Adapter.send_message、Adapter.call_api、Plugin、Context、 Event 和 Message 是第三方扩展的主要契约。新增能力优先通过规范、测试和 helper 提供。

适配器外置优先

内置适配器只覆盖高质量基础平台。更多平台通过 iamai-adapter-<platform> 包发布，并用 conformance tests 证明事件归一化、消息编码、API 调用和错误处理行为。

安全声明前置

插件和 Agent 工具在进入社区商店前必须说明网络访问、凭据需求、危险动作和可选依赖。本阶段先做声明、 审核字段和审计 trace，不承诺完整隔离沙箱。

管理面先 API 后 UI

候选端点包括 /health、/metrics、/adapters、/plugins、/sessions、/state、 /schema。WebUI 可以消费这些 API，但不绑定核心 runtime。

Rust 只承接纯数据热路径

消息段转换、规则字段匹配、签名校验和事件 schema validation 可以逐步下沉到 Rust。网络生命周期、 插件运行和平台 SDK 仍留在 Python，避免过早固化 PyO3 边界。