# Eva-CLI 文档

> Language: 简体中文
> Content authority: current detailed architecture source
> English default entry: [../en/README.md](../en/README.md)

这里维护 Eva-CLI 当前最完整的中文架构详案入口。项目已经推进到
V1.17.6 V1.x closure release gate 检查点，仍使用 V1.11.5-alpha 源码版本：当前仓库包含可编译 Rust workspace、可执行 CLI
表面、配置校验、V1.0 in-memory basic runtime、本地 task 诊断、V1.1
外部能力诊断、V1.2 记忆/知识上下文、V1.3 硬件绑定计划、V1.4
备份/生命周期诊断、V1.5 发布加固检查、V1.6 durable runtime/storage、V1.7 Lua 执行与热更新生命周期、V1.8-V1.10 runtime capability 和高风险 apply gate、V1.11 release evidence 与 runtime command completion、V1.12 daemon control/recovery、V1.13 provider supervision gate、V1.14 restore mutation/rollback 和 service-manager abstraction、V1.15 hardware safety 与 memory retrieval/redaction、V1.16 observability retention/rotation policy、V1.17 run command split、operator execution-state 字段、高风险 text summary、public JSON contract diff validation、文档/i18n 同步闭环，以及 V1.17.6 `release check` closure report、`REL-OBSERVABILITY-POLICY-001`、`REL-V1X-CLOSURE-001` 和生产 external blockers 记录。英文文档位于
[../en/README.md](../en/README.md)，当前承担默认公开入口和稳定英文 slug 的职责；
在英文详案补齐之前，不能用英文摘要覆盖本目录中的详细架构规格。

当前受管理项目版本：`V1.11.5-alpha`（`Cargo.toml` 版本 `1.11.5-alpha`，预发布 Git tag 形式 `v1.11.5-alpha`）。V1.17.6 是 V1.x closure release gate 检查点，不新增 release tag；生产签名、仓库、平台 service-manager、硬件 fixture 和生产 database sink 仍作为 external blockers 记录。版本规则见 [版本管理方案](release/版本管理方案.md)。

## 文档分类

### 使用指南

需要运行项目时先读这里。

- [Eva-CLI 使用手册](guide/Eva-CLI使用手册.md)

### 架构

理解运行时模型、模块边界和 Topic 路由时阅读这些文档。

- [总体架构方案](architecture/总体架构方案.md)
- [模块划分](architecture/模块划分方案.md)
- [eva-core 契约模块](architecture/eva-core模块设计.md)
- [Rust、Lua 与 EventBus 单进程运行时](architecture/Rust与Lua事件总线智能体调度架构方案.md)：说明当前同步投递、Lua 5.4、basic loop 和 daemon 边界。
- [Topic 路由事实源与校验边界](architecture/Topic路由混合同步方案.md)：说明人工 route 归属、已实现校验和 Scheduler 语义。

### 能力

这里放外部能力接入、记忆、发现、Skill 和硬件边界。

- [Lua 调用外部 Agent 动态 Adapter 架构方案](capabilities/Lua调用外部Agent动态Adapter架构方案.md)
- [Lua 承载 Skill-MCP-Tool 热更新架构方案](capabilities/Lua承载Skill-MCP-Tool热更新架构方案.md)
- [Skill 实现方案](capabilities/Skill实现方案.md)
- [Agent 记忆与知识库架构方案](capabilities/Agent记忆与知识库架构方案.md)
- [Agent 扫描与发现架构方案](capabilities/Agent扫描与发现架构方案.md)
- [外接硬件接入与热插拔架构方案](capabilities/外接硬件接入与热插拔架构方案.md)

### 运维

这里放配置、生命周期、备份恢复计划和文档发布相关内容。

- [项目配置方案](operations/项目配置方案.md)
- [进程级停机升级架构方案](operations/进程级停机升级架构方案.md)
- [备份、迁移包与 Release Snapshot 架构方案](operations/备份迁移包与ReleaseSnapshot架构方案.md)
- [网站与文档多语言适配方案](operations/网站与文档多语言适配方案.md)

### 发布

这里放已发布检查点、已知限制、发布门禁和迁移策略。

- [项目发布方案](release/项目发布方案.md)
- [版本管理方案](release/版本管理方案.md)
- [GitHub Packages 发布方案](release/软件包发布方案.md)
- [安装、升级和卸载说明](release/安装升级卸载说明.md)
- [V1.0 已知限制](release/V1.0已知限制.md)
- [V1.0 发布说明](release/V1.0发布说明.md)
- [V1.5 发布加固](release/V1.5发布加固.md)
- [V1.5 迁移指南](release/V1.5迁移指南.md)
- [V1.5 兼容性策略](release/V1.5兼容性策略.md)
- [V1.11.5 Alpha 发布说明与 V1.17 同步](release/V1.11.5-alpha发布说明.md)
- [V1.11.4 Alpha 发布说明](release/V1.11.4-alpha发布说明.md)
- [V1.7.4 Alpha 发布说明](release/V1.7.4-alpha发布说明.md)
- [V1.7.3 Alpha 发布说明](release/V1.7.3-alpha发布说明.md)
- [V1.7.2 Alpha 发布说明](release/V1.7.2-alpha发布说明.md)
- [V1.7.1 Alpha 发布说明](release/V1.7.1-alpha发布说明.md)
- [V1.6.5 Alpha 发布说明](release/V1.6.5-alpha发布说明.md)
- [V1.6.4 Alpha 发布说明](release/V1.6.4-alpha发布说明.md)
- [V1.6.3 Alpha 发布说明](release/V1.6.3-alpha发布说明.md)
- [V1.6.2 Alpha 发布说明](release/V1.6.2-alpha发布说明.md)
- [V1.6.1 Alpha 发布说明](release/V1.6.1-alpha发布说明.md)
- [V1.5.1 发布说明](release/V1.5.1发布说明.md)
- [V1.5 发布说明](release/V1.5发布说明.md)
- [V1.5 发布验收记录](release/V1.5发布验收记录.md)

### 规划

规划目录保留当前 V1.x 功能清单、实施计划和外部前置项的平台自主性评估。已替代的
路线图与里程碑历史由 Git 历史、不可变 release tag 和发布说明保存。

- [V1.x 未完整实现功能清单](planning/V1.x未完整实现功能清单.md)
- [V1.x 真实运行时能力补齐实施计划](planning/V1.x真实运行时能力补齐实施计划.md)
- [V1.x Windows 下 Codex 自主可解决阻塞项](planning/V1.x-Windows-Codex自主可解决阻塞项.md)

### 工具链

工具链文档描述 CLI 和 IDE 相关能力。

- [Eva-CLI 命令行工具功能设计文档](tooling/Eva-CLI命令行工具功能设计文档.md)
- [IDEA Plugin 开发工具链功能方案](tooling/IDEA插件开发工具链功能方案.md)

## 说明

中文文档当前保留完整的实现细节与规格，并暂时作为架构细节与实现规格的事实主源。
新增和结构性更新应先进入对应中文详案，再同步英文摘要或全文，并更新
`../_i18n/manifest.json` 中的内容权威、覆盖度和翻译状态。