# ZufyUI · AI 阅读入口

ZufyUI 是 C++20、Win32、Direct2D / DirectComposition 构建的头文件 UI 框架。本文件是导航，不替代源码、API 或仓库协作规则。先读取 [AGENTS.md](/raw/AGENTS.md)，再按任务进入下面的模块；不要一次加载全部实现。

## 版本与权威来源

- 当前版本以 [ZufyUIVersion.h](https://gitee.com/whrct22/ZufyUI/blob/main/ZufyUIVersion.h) 的 `ZufyUI_VERSION_STRING` 为准；站点构建自动读取它。
- [中文 API](/raw/docs/src/API.md) / [English API](/raw/docs/src/API.en.md)：签名、默认值和使用约定。
- [README](/raw/README.md)：运行第一个窗口；[CHANGELOG](/raw/CHANGELOG.md)：版本变化。
- 签名与说明冲突时检查对应头文件，修正双语 API 并运行一致性检查，不凭名称猜测接口。

## 功能地图

| 任务 | 下一步 | 实现入口 |
| --- | --- | --- |
| 窗口、生命周期、信号、布局、渲染 | [核心索引](/raw/docs/ai/core/LLM.MD) | `ZufyUI.h`、`ZufyUI/detail/` |
| 基础控件、数据视图、图表、主题样式、DSL | [控件索引](/raw/docs/ai/widgets/LLM.MD) | `ZufyUIWidgets.h`、`ZDataViewer.h`、`ZufyUICharts.h`、`ZufyUIDsl.h` |
| 运行状态、JSON 调试、MCP、UIA | [调试索引](/raw/docs/ai/debugging/LLM.MD) | `tools/zufyui_debug.py`、`ZufyUIDebugger/` |
| 构建、回归、文档生成、提交规则 | [协作索引](/raw/docs/ai/contributing/LLM.MD) | `tools/`、`tests/`、`docs-site/` |

## 推荐读取顺序

1. 本入口 → [模块总索引](/raw/docs/ai/LLM.MD) → 对应叶子文档。
2. 查询叶子文档指向的 API 章节与实现。只展开当前任务需要的部分。
3. 修改前检查 [易错点](/raw/docs/pitfalls.md)，修改后运行相应测试。

文档站在构建时生成 `/llms.txt`（索引）、`/llms-full.txt`（完整文档快照）和 `/raw/`（原始 Markdown）。自动构建更新这些快照；模块约定的语义仍需随 API 改动维护。
