快速上手

环境要求

• Windows 10 / 11
• Excel 2016+ 或 WPS ET
• .NET 6 运行时（安装包方式部署时随包分发）

构建

在 Windows 构建机上执行：

git pull                 # 拉取最新代码
.\build.bat              # 常规构建（x86 + x64，整理 dist）

其他包装器：build.bat full（清空重建全流程）/ clean / verify / smoke / test。

安装

构建完成后，使用 dist 根目录的一键入口：

入口	用途
install_excel_addin.bat	安装到 Excel（自动选 32/64 位 xll，写注册表）
install_wps_addin.bat	安装到 WPS（写加载宏白名单）
uninstall_excel_addin.bat	从 Excel 卸载
uninstall_wps_addin.bat	从 WPS 卸载

安装 / 卸载日志位于 dist\files\logs\。

用户配置

每台机器的路径、工作簿名、打印机等写在用户层配置 config/appsettings.user.json（由 config/appsettings.user.json.example 复制而来，不入库），保存后重载生效。

验证安装

安装完成后打开 Excel / WPS：

1. 功能区应出现「合格证清单」选项卡
2. 单元格输入 =HZZ_VERSION()，返回插件与运行时版本
3. 单元格输入 =HZZ_LOGPATH()，返回日志路径；异常时可据此定位

本地构建本网站

dotnet tool install -g docfx   # 需要 .NET 8 SDK
cd docs-site
docfx --serve                  # 构建并起本地服务，默认 http://localhost:8080