mirror of
https://github.com/AtomUI/AtomUI.git
synced 2026-10-28 23:08:36 +08:00
chinboy
9f6ec36645
统一文档目录的入口文件名为 `overview.md`，取代原先的 `index.md`。单 Control 目录本来就用 `overview.md`，此前只有目录级入口用 `index.md`，两套命名并存；现在全库一致。 改名覆盖 42 个入口文件：`docs/` 根、一级分类目录、Architecture 分组与跨模块系统目录、Module 目录、Control 平台与分类目录、Guide 与 Reference 子目录。`docs/AI/generated/index.md` 是手工 维护的导航页，一并改名。 生成产物 `docs/AI/generated/llms/**/index-cn.md` 保持原名，它属于 LLMs Generator 的输出契约。 同步更新 28 个正式文档与 `AGENTS.md` 中的入站链接，以及两处目录树示意图。改名后全部相对链接 可解析，LLMs Generator `verify` 通过（78 控件 / 159 文件），单 Control 四件套文件名契约未变。 新增 `docs/engineering/contributing/documentation-structure-guidelines.md` 承载入口命名、文档 拆分标准、事实所有权和链接规范。此前该规则只写在带日期的设计过程记录里，不适合作为长期来源。 `docs/superpowers/specs/2026-08-10-documentation-information-architecture-design.md` 保留原文 并加取代说明，其余结论继续有效。
2.0 KiB
2.0 KiB
源码模块
本目录按源码项目或发布包描述实现边界、注册入口、关键目录和内部依赖。跨多个项目的稳定模型由 Architecture 维护；具体 Control 的公共行为和模板契约由 Control 文档 维护。
| 模块文档 | 对应源码项目或包 | 推荐架构阅读 |
|---|---|---|
| Native | src/AtomUI.Native |
运行平台、Windowing |
| Core | src/AtomUI.Core |
主题系统、本地化系统 |
| Localization | src/AtomUI.Localization |
本地化系统 |
| Controls.Shared | src/AtomUI.Controls.Shared |
Control 基础设施 |
| Controls | src/AtomUI.Controls |
渲染系统 |
| Generator | src/AtomUI.Generator |
主题系统、本地化系统 |
| Fonts | src/AtomUI.Fonts.* |
主题系统 |
| Icons | src/AtomUI.Icons.* |
整体架构 |
| GalleryBase | src/AtomUI.Toolkits.GalleryBase |
启动与注册 |
src/AtomUI.Build.Tasks、语言包项目和 GalleryBase Generator 作为跨项目系统的一部分，分别由本地化架构和
对应宿主模块说明；当其形成独立发布边界和维护入口时，再新增模块目录。