ADRs

中文 | English

ADRs / 架构决策记录索引

维护版本：v0.51.2 ｜ 最后更新：2026-07-06

EnerOS 使用 ADR（Architecture Decision Records） 记录重大架构决策。每个 ADR 包含：背景（Context）→ 决策（Decision）→ 状态（Status）→ 后果（Consequences）。

完整 ADR 文件见 docs/adr/。

---

ADR 列表（19 份）

#	标题	决策摘要	状态
0001	记录架构决策	采用 ADR 模板记录重大架构决策	Accepted
0002	定位为电力原生 Agent OS	EnerOS 定位为 Power-Native AgentOS，非通用 OS	Accepted
0003	v0.28.0 采用 plugin-daemon 进程隔离	插件在独立 daemon 进程加载，IPC 通信	Accepted
0004	采用 TOML 场景脚本引擎	TOML 格式场景定义 + 7 种动作	Accepted
0005	CNPOWER 原生 Rust 移植	Python cnpower → Rust eneros-cnpower，零 Python 依赖	Accepted
0006	多租户命名空间隔离	<tenant_id>:<resource_id> 隔离，跨租户默认拒绝	Accepted
0007	零信任 mTLS 与安全增强	4 个新 crate（trust/audit/ids/compliance）	Accepted
0008	运维自动化	SLO/AIOps/Ops 三层 + 25 端点 + 3 守护进程	Accepted
0009	高可用增强	多区域多活 + WAL 复制 + DR 编排 + CRDT/LWW	Accepted
0010	Agent 智能进阶	5 模块：collab/learning/decomposition/strategy/explain	Accepted
0011	电网分析进阶	动态状态估计 + 实时稳定 + EMTP + 谐波 + 等值	Accepted
0012	物联网与泛在接入	MQTT/CoAP/LwM2M + 传感器聚合 + 边缘 OTA	Accepted
0013	可视化与交互增强	3D glTF + NL + 报表 + PWA + 移动端	Accepted
0014	国际化与合规	Fluent i18n + GDPR/PIPL/CCPA + DL/T 698/645	Accepted
0015	RT 类型层与安全类型层	Validated + NoAlloc + WCET + lockfree	Accepted
0016	v0.50.0 电力 MVP 纵向闭环	enerosctl demo 9 步闭环 + 7 项技术债清偿	Accepted
0017	LLM Agent 真实场景验证	100 场景 + 4 硬指标 + Ollama qwen2.5:14b	Accepted
0018	LLM Agent 语义正确性验证	11 期望规则 + 3 匹配维度 + 20 轮主测试	Accepted
0019	v0.51.0 算法精度 + 协议 Fuzz	FD 求解器 + MATPOWER + 4 协议 fuzz + proptest	Accepted

---

状态说明

• Accepted — 已采纳，正在执行
• Proposed — 已提议，待讨论
• Deprecated — 已废弃，被后续 ADR 取代
• Superseded — 被后续 ADR 取代（保留历史）

---

何时写新 ADR

根据 ADR-0001 与项目记忆系统规则，结构变更需新增 ADR：

• 新增 / 删除 / 重命名 crate
• 修改 eneros-core 公开类型或错误枚举
• 修改核心 Trait 签名
• 调整分层依赖方向
• 新增协议适配器 / HAL 后端
• 引入新的安全模型或信任边界
• 引入新的执行域或调度策略

ADR 模板：

# ADR-00NN: <标题>

## 状态
Accepted / Proposed / Deprecated / Superseded by ADR-00MM

## 背景
<为什么需要这个决策？现状是什么？问题是什么？>

## 决策
<我们决定什么？为什么？考虑过哪些备选？>

## 后果
<正面后果 / 负面后果 / 风险与缓解>

---

下一步

• Architecture Overview — 架构总览
• Crate Index — 56 crates 索引
• Version History — 版本史摘要
• docs/adr/ — 完整 ADR 目录