# 文档导航与信息归属

按当前问题选择入口，不需要先读全部文档。操作电路使用公开设计 Skill；查询或维护源码可以
使用[仓库协作 Skill](agent-collaboration.md)。规范、实现与历史报告发生差异时，应分别报告
差异和版本，不能用旧验收记录覆盖当前契约。

## 按任务阅读

| 当前任务 | 先读 | 需要更多信息时 |
|---|---|---|
| CLI 现在能否日常使用、检查是否收尾 | [CLI Status](cli-STATUS.md) | 当前可用范围、已知限制和后续跟进 |
| 安装、连接和升级 | [quick-start.md](quick-start.md) | [dev-environment.md](dev-environment.md) |
| Codex 内置浏览器本地版本测试 | [codex-web-eda-runbook.md](codex-web-eda-runbook.md) | [原理图验收实例](reviews/2026-09-23-v1.6.0-schematic-acceptance.md) |
| 基础 CLI 动作与真实链路测试 | [cli-live-test.md](cli-live-test.md) | [B00–B10 前置条件与步骤](cli-live-test-detail.md) |
| 已知 CLI bug 与当前使用建议 | [cli-known-bugs.md](cli-known-bugs.md) | 影响、跟踪单、提示与暂停条件 |
| 基础门禁通过后的高级 CLI 业务验收 | [cli-advanced-test.md](cli-advanced-test.md) | [A00–A06 前置条件与步骤](cli-advanced-test-detail.md) |
| 让 Agent 设计或修复电路 | [SKILL.md](../.agents/skills/easyeda-agent/SKILL.md) | 该入口的任务路由与参考 |
| 交付清晰原理图和 PCB 正反面 | [设计图交付](../.agents/skills/easyeda-agent/references/design-drawings.md) | 实际回读图、官方图、离线图册与验证范围 |
| 找到可改参数的相近案例 | [样例索引](../.agents/skills/easyeda-agent/references/examples/index.md) | 具体样例的来源、参数及回读 |
| 确认能做什么、不能做什么 | [FEATURES.md](FEATURES.md) | [cli/README.md](cli/README.md) |
| 理解概念与职责 | [concepts.md](concepts.md)、[architecture.md](architecture.md) | [schematic-connectivity-model.md](schematic-connectivity-model.md) |
| 比较 PCB Layout/Router 算法、最优性与二层验证方案 | [调研与验证计划](pcb-layout-solver-research.md) | 开源源码、MCP/Skill 对照与分层测试；计划不代表已验收 |
| 逐项验证已有电路块的组合移动与布线空间 | [PCB 开发验证清单](pcb-layout-validation.md) | 独立场景、自动用例映射、现场证据与待办分开记录 |
| 新增或修复工具能力 | [cli-design.md](cli-design.md)、[protocol.md](protocol.md) | [connector-contract.md](connector-contract.md)、[ecosystem-survey.md](ecosystem-survey.md) |
| 社区贡献 PCB 布局布线算法 | [PCB 求解社区设计](pcb-solver-community-design.md) | [数学模型与 PR 验收](pcb-solver-community-design-detail.md)、[概念表](concepts.md) |
| 维护 Skill 和知识 | [skill-design.md](skill-design.md)、[编写约定](../.agents/skills/README.md) | [Agent 协作设计](agent-collaboration.md) |
| 判断是否需要发布新版本 | [下一版本发布评估](releases/next-release.md) | 修复范围、版本建议和待补验收 |
| 准备已获批准的版本发布 | [release-workflow.md](release-workflow.md) | [v1.8.0 发布准备](releases/release-1.8.md)、[仓库发布授权规则](../AGENTS.md) |
| 日常测试收尾、从需求到成品 | [最小点灯板原始需求](test-case-esp32-blink.md)第一节 | [执行详细稿](test-case-esp32-blink-detail.md)、[验收标准](e2e-automation-acceptance.md)、[仓库规则](../AGENTS.md)；四层开发板为扩展回归 |
| 复现缺陷、查验证边界 | [布局回归输入](../internal/app/testdata/schematic-layout/README.md)、[发布证据](releases/evidence/README.md) | 必要旧引用见[历史证据索引](reviews/README.md)，过程记录查 Git 历史 |

## 信息只有一个维护位置

| 信息 | 维护位置 | 其他入口怎么引用 |
|---|---|---|
| 仓库协作、分支和发布约束 | 根目录 [AGENTS.md](../AGENTS.md) | `CLAUDE.md` 软链接，不复制正文 |
| 仓库查询和维护流程 | `.agents/skills/easyeda-repo-*/` | `.claude` 和用户级安装链接共享源目录 |
| CLI 当前可用范围、检查进度与跟进总览 | [cli-STATUS.md](cli-STATUS.md) | 首页、CLI 索引和测试文档引用；问题细节留在已知问题与 issue |
| 下一版本的修复范围、版本建议与发布准备 | [releases/next-release.md](releases/next-release.md) | Status 与导航引用；正式发布后将该轮结论纳入对应版本说明 |
| 设计工作流、命令、操作知识 | `.agents/skills/easyeda-agent/` | README / 文档索引仅链接；发布包内引用自包含 |
| 新概念、架构理由与能力边界 | 本目录对应主题页 | 在 Skill 的相关决策点引用已纳入包内的操作知识 |
| 可重用设计输入、参数和步骤 | 公开 Skill 的 `references/examples/` | 通过样例索引发现，保留状态与证据 |
| 缺陷的最小复现输入与断言 | 对应代码的 `testdata/` 和自动测试 | README 写来源、运行方式及验证边界；issue 链接测试 |
| 正式发布的验收结论与必要证据 | `docs/releases/evidence/<version>/` | 按版本和清单保留，不改写既有结果 |
| 单次执行日志、个人运行状态和原始私有材料 | 仓库外或本地忽略的 `artifacts/` | 只回填脱敏且可迁移的结论，不另建运行报告 |

新增文档先判断它是否服务于当前用法、长期设计或自动复现；一次性证据默认留在本地。
具体入库标准见 [AGENTS.md](../AGENTS.md#开源资料入库)。更新已有主题通常比再写一份综合
指南更容易保持一致。增加入口时补本索引；公开 Skill 内链接仍须通过 `make skill-check`，
不能依赖只在源码仓库存在的文件。

## 历史资料与清理

`reviews/` 仅兼容发布材料仍引用的历史结论；`releases/` 保存版本说明和正式验收材料。
重复执行记录已退出当前目录，原文可由该目录索引的固定提交追溯；可运行的布局输入迁入
`internal/app/testdata/schematic-layout/`。不维护另一套逐次运行归档。
历史材料说明当时发生过什么；当前命令与架构分别以 CLI 索引、概念表、架构和公开 Skill 为准。
旧 Phase 1/2 规划、2026-08 路线图、三层布局蓝图、命令收敛提案及未立项外壳占位已移除；
仍有价值的审计数据、gate 现场结果和移动安全经验已归入对应证据页或现行命令说明。
需要追溯被删的旧想法时使用 Git 历史，不在当前导航中保留失效操作指南。