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