# 构建与验证

[协作索引](LLM.MD) · [构建脚本](../../../tools/build.ps1)

## 原生工程

```powershell
powershell -ExecutionPolicy Bypass -File tools/build.ps1
python -m unittest discover -s tests -p test_debug_client.py
python tools/check_api_parity.py
```

构建脚本通过 `vswhere` 发现 Visual Studio/MSBuild。可选参数在脚本中定义，包括配置、平台与是否跳过测试。不要写死本机安装路径。构建脚本会处理占用的目标进程，运行前留意当前调试会话。

## 修改边界

- C++ `.h` / `.cpp` 使用 UTF-8 BOM；Markdown 使用 UTF-8 无 BOM。
- 生命周期、UIA、动画、并发问题先定位根因，再提供回归验证；不要用延迟或异常吞噬掩盖问题。
- 不修改没有要求修改的功能和已有用户改动。版本号以 `ZufyUIVersion.h` 为统一来源。
- 文档站是独立 Next.js 子项目，不增加 C++ 使用方的运行依赖。
