notify/docs/build-and-install.md

构建与安装

Codex 接入示例

在用户级 ~/.codex/config.toml 中加入：

notify = ["E:\\notify\\scripts\\notify.cmd", "codex"]

notify 必须放在用户级配置中，项目目录内的 .codex/config.toml 不会覆盖它。

引导脚本（scripts/notify.cmd、scripts/notify.sh）顶部的 DOWNLOAD_URL 决定从哪拉取 exe；下载用临时文件 + 原子改名 + mkdir 锁，并发触发不会重复下载。

从源码构建（开发）

框架依赖型，依赖已安装的 .NET 10 运行时：

cd Notify
dotnet build -c Release
# 产物：Notify/bin/Release/net10.0-windows/notify.exe + 同目录依赖 DLL

exe 必须和这些 DLL 在一起（.NET 从 exe 所在目录加载依赖）。

发布单文件（维护者）

NativeAOT 静态链接 Skia / HarfBuzz / ANGLE，产出单个无依赖 exe。原生链接需要 MSVC 工具链。

# 从 "Developer Command Prompt for VS" 运行，或用脚本（自动用 vswhere 配 vcvars）
scripts\build.bat
# 产物：bin\notify.exe（未压缩单文件，约 40 MB）

然后把它作为 Release 资产发布，并确保引导脚本的 DOWNLOAD_URL 指向它：

gh release create v0.1.0 bin/notify.exe

AOT 配置在 Notify/Notify.csproj（PublishAot 条件块 + CoreUtils.*.Static 静态库包 + 发布后清理）。源生成 COM / UIAutomation 与静态渲染需真机运行验证，详见 interop.md。

手动烟雾测试

notify host &                                              # 起 Host（托盘出现）
echo {"session_id":"x","prompt":"hi"} | notify save
echo {"session_id":"x"} | notify notify                    # 弹窗

排错

现象	处理
首次触发慢 1~2 秒	首次会下载 exe + Host 冷启动（一次性），之后常驻、瞬时
没弹窗	先用手动烟雾测试确认程序本身正常；看托盘有没有图标
弹双份	同时装了原版 Rust 插件，删除其一
停止 Host	托盘右键 → 退出，或 taskkill /F /IM notify.exe