mirror of
https://github.com/AtomUI/AtomUI.git
synced 2026-10-23 17:59:22 +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` 保留原文 并加取代说明，其余结论继续有效。
1.5 KiB
1.5 KiB
AtomUI.Controls.Shared 模块概览
AtomUI.Controls.Shared 是控件共享契约和跨控件基础能力模块。它依赖 AtomUI.Core 和 AtomUI.Generator，RootNamespace 为 AtomUI.Controls。
职责
- 提供控件通用接口，例如尺寸、状态、方向、操作系统感知、Header/Content 等共享契约。
- 提供异步加载协调器，统一搜索类和展开类控件的 debounce、超时、取消、去重行为。
- 提供集合视图能力，支撑排序、分组、过滤和虚拟化上下文。
- 提供上传调度、媒体断点、WaveSpirit 等跨控件系统。
关键目录
| 目录 | 说明 |
|---|---|
AsyncLoad/ |
AsyncSearchLoadCoordinator、AsyncExpandLoadCoordinator、加载结果状态 |
Data/ListCollectionViews/ |
列表集合视图、排序、分组、过滤描述 |
Net/ |
文件上传调度与传输接口 |
MediaQuery/ |
媒体断点和响应式布局支持，规则见 响应式架构 |
WaveSpirit/ |
点击波纹/动效扩展 |
Converters/、Utils/ |
控件共享工具 |
相关专题
过滤专题中的部分实现位于 AtomUI.Desktop.Controls，但统一契约和共享数据结构属于本模块的重要背景。