桌面应用
IaC Code 桌面应用把 CLI 和 Web 应用中的同一套智能体、模型服务、云服务集成、项目与会话封装成可安装的原生应用。Tauri 宿主会启动随应用打包的 Python 运行时，并通过回环连接加载本地 IaC Code 界面，不会对外提供公开的 Web 服务。
支持的安装包
请从 GitHub Releases 下载与你的平台对应的安装包。
| 操作系统 | 架构 | 安装包 | 更新方式 |
|---|---|---|---|
| macOS | Apple 芯片 | .dmg | 应用内更新 |
| Windows | x64 | .exe 安装程序 | 应用内更新 |
| Linux | x64 | .AppImage | 应用内更新 |
| Debian / Ubuntu | x64 | .deb | 安装新版软件包 |
每个版本还会提供 SHA256SUMS、软件物料清单（SBOM）和第三方软件声明。
安装
macOS
- 下载并打开
.dmg，将 IaC Code 拖入应用程序目录。 - 从“应用程序”中打开 IaC Code。
- 当前安装包尚未使用 Apple Developer ID 签名，也未经过公证，因此 macOS 可能阻止首次启动。核对校验和后，可以按住 Control 键点按应用并选择打开，或前往系统设置 > 隐私与安全性允许打开。
Windows
- 下载并运行
.exe安装程序。IaC Code 会安装到当前用户，并创建应用快捷方式。 - 如果 Microsoft Defender SmartScreen 提示发布者未知，请先核对
SHA256SUMS，然后选择更多信息；只有校验和与版本页面一致时才继续安装。 - 安装包带有界面运行所需的 WebView2 引导支持。IaC Code 首次启动时还会检查 Git Bash；如果尚未安装，会提供安装引导。
Linux AppImage
为下载的文件添加执行权限，然后运行：
chmod +x iac-code_*.AppImage
./iac-code_*.AppImage
首次运行后，桌面环境可能会提供创建启动器的选项。发现带签名的新版本时，AppImage 可以自行更新。
Debian 或 Ubuntu
请使用 APT 安装 deb 包，以便系统自动处理依赖：
sudo apt install ./iac-code_*_amd64.deb
安装后可从应用菜单启动 IaC Code。deb 版本不使用应用内更新；升级时请下载并安装新版 deb 包。
首次启动
IaC Code 首次启动时会要求选择项目目录。该目录将作为文件访问、模板生成、工具执行和会话的工作区。之后可以通过项目选择器切换项目。
如果你已经用过 CLI 或 Web 应用，桌面应用会复用 ~/.iac-code/（或 IAC_CODE_CONFIG_DIR）中的配置，包括模型服务、阿里云凭证、应用设置和已保存的会话。若此前没有配置，请先在设置中添加模型服务和云凭证，再开始任务。
界面支持 English、简体中文、日本語、Français、Deutsch、Español 和 Português。可以在设置 > 常规中修改语言和配色主题。
更新与安装包签名
macOS、Windows 和 AppImage 版本会定期读取稳定版更新信息，并可下载和安装新版本。每个更新包在安装前都会使用 IaC Code 的更新公钥进行验证。deb 版本则沿用 Linux 常规的软件包更新方式。
更新签名与操作系统的发布者签名并不是一回事：前者用于确认更新确实由 IaC Code 发布；macOS 公证和 Windows 代码签名则用于向操作系统表明发布者身份。目前发布的安装包尚未使用商业发布者证书签名，因此出现平台警告属于预期情况。请始终从官方版本页面下载安装包，并核对 SHA256SUMS。
故障排查
- **应用一直停留在启动页：**使用恢复操作重试启动或打开诊断目录。日志会指出运行时文件缺失、回环端口占用或 sidecar 启动失败等问题。
- **Windows 提示缺少 Git Bash：**按照安装引导完成安装，重启 IaC Code 后再次检查。Windows 上基于 Shell 的智能体工具依赖 Git Bash。
- **Linux 双击 deb 后显示压缩包内容：**不要用归档管理器打开，请改用上面的 APT 命令安装。
- **Linux 上无法打开资源栈或外部链接：**先为当前桌面会话设置默认浏览器，然后重试。
- **桌面应用没有与 CLI 共用设置或会话：**确认两者使用相同的
IAC_CODE_CONFIG_DIR，并由同一个操作系统用户运行。