安装与首次启动

安装前确认

• 当前只有 Windows x64 的 NSIS 安装程序：没有 macOS、Linux、ARM、便携版或差异更新包。
• 安装包为 NM-Codex_Setup.exe，版本 1.0.3，大小 306,067,116 字节（约 291.9 MiB）。
• 最低系统版本与安装后体积尚未在干净环境实测，官网不给出未验证的数值。
• 该构建未配置代码签名，安装或首次运行时 Windows 可能提示未知发布者，请先完成下面的校验。

下载与校验

1. 打开官网下载页，获取 NM-Codex_Setup.exe。
2. 确认文件大小为 306,067,116 字节。
3. 在文件所在目录执行下面的命令，得到实际 SHA-256。
4. 与下载页给出的哈希逐位比对；不一致就不要安装，请重新下载后再核对。

Get-FileHash -Algorithm SHA256 .\NM-Codex_Setup.exe
# 期望值
# 4a0dfa31b57804ab3cc4bfde0d177a28e240d844633eb4a7fb8795a28dbb0343

安装向导

1. 双击 NM-Codex_Setup.exe 启动向导。
2. 选择安装目录；安装按当前用户进行，不需要管理员权限。
3. 等待安装完成，向导会创建桌面与开始菜单快捷方式。
4. 从快捷方式启动 NM-Codex，确认主窗口可以打开。

首次安装会写入什么

首次安装会把内置的 codey 模板数据复制到 %APPDATA%\NM-Codex\codey，用于保存配置、Provider、Skills、记忆与工作区数据。

如果当前 Windows 帐户不能写入 %APPDATA%\NM-Codex，安装会中止并给出提示，请确认可写后重新运行安装程序。

若检测到旧版安装在程序目录下的 codey 数据，安装程序会先迁移到 %APPDATA%\NM-Codex 再继续。

卸载与数据保留

卸载时会询问是否保留 Codey 数据：选择“是”保留配置、模型提供商、Skills、记忆和工作区数据；选择“否”会删除 %APPDATA%\NM-Codex 与 %LOCALAPPDATA%\NM-Codex。

程序目录会被卸载程序清理，用户数据不会留在安装目录里。

下一步

启动后先配置模型提供商，再用一个可丢弃的工程验证一次只读请求。