架构决策记录

架构决策记录（ADRs）是对会约束未来 ZeroClaw 工作的架构选择的持久记录。它们比 RFC 更简短：每一条都记录背景、决策、后果，以及为该决策提供依据的来源。

已接受的 ADR 是不可变的。如果架构发生变化，请撰写新的 ADR，并将旧的标记为已被取代，而不是重写历史。

当前 ADRs

ADR	状态	决策
ADR-001	已接受	ZeroClaw 的运行时和第一方 crate 以 Rust 实现。
ADR-002	已接受	第一方扩展表面使用显式的 trait 合约。
ADR-003	已被 ADR-009 取代	WASM 插件最初使用 Extism 作为执行桥接。
ADR-004	已接受	工具持有的共享状态遵循 daemon 拥有的身份、句柄所有权、隔离和重载规则。
ADR-005	已接受	内存存储使用与后端无关的契约，默认采用 SQLite。
ADR-006	提议的	可选通道的目标是运行时插件，迁移期间会有明确的基于能力的原生例外。
ADR-007	提议的	网关将通过受支持的本地 IPC 契约成为一个独立的可选进程。
ADR-008	已接受	目标模式使用持久化任务控制平面和权威用量账本。
ADR-009	已接受	WIT 组件和直接 `wasmtime` 替代了 Extism 插件桥接。
ADR-010	提议的	会话历史记录、精选记忆和增强内容具有各自独立的权限边界。
ADR-011	已接受	已配置的代理在单个守护进程下具有明确的运行时边界。
ADR-012	提议的	实时配置应用使用规范代次和特定目标的结果。
ADR-013	提议的	主密钥获取使用一个已配置的密钥源授权机构。
ADR-015	提议的	统一能力目录是对包、能力、实现、配置和运行时所有者的只读投影。

ADR-006 和 ADR-007 是来自 FND-002 的实现门控路线图决策。其目标方向已记录在案，但在各记录中的验收边界交付之前，它们将保持提案状态。

在记录中的验收门槛满足之前，ADR-010 仍处于提议状态。

ADR-012 在规范配置发布、按代际界定的结果，以及受限的安全和通道实时应用的使用方满足记录中的验收关卡之前，仍处于提议状态。

ADR-013 在规范密钥源边界、安全文件兼容性、已配置的失败关闭选择以及受支持的非文件源满足记录中的验收门槛之前，仍处于提议状态。

在统一目录投影保留事实来源证据、工件溯源、兼容性桥接，以及可见性不能授予调用权限这一规则之前，ADR-015 仍处于提议状态。