安装与首次启动

请始终从 OmniStudio 官网下载页 获取安装包。Windows 文件名形如 OmniStudio_<版本>_x64-setup.exe，Apple Silicon Mac 文件名形如 OmniStudio_<版本>_aarch64.dmg。

安装前确认

平台	正式支持范围	安装包状态
Windows	Windows 10/11 x64；至少 8 GB 内存，建议 16 GB	当前安装包尚未 Authenticode 签名
macOS	Apple Silicon；macOS 12 及以上	Developer ID 签名、Apple 公证并附带 ticket

模型会额外占用磁盘空间。下载前以模型详情中的 Total download 为准，不要用模型参数量直接估算文件大小。

Windows 安装

1. 在官网下载页点击 Windows 客户端。
2. 下载完成后双击安装包并按向导安装。
3. 如果 SmartScreen 显示“未知发布者”，先确认下载来自官网跳转地址，再查看系统提供的文件信息。
4. 如果 Microsoft Defender 报告恶意软件，请不要关闭 Defender、添加排除项或强行恢复文件；记录威胁名称和安装包版本，通过应用内反馈联系我们。

Windows 运行界面依赖 Microsoft Edge WebView2 Runtime。Windows 10/11 通常已经安装；若应用窗口无法正常打开，可先通过 Windows Update 或微软官方渠道修复 WebView2。

macOS 安装

1. 在官网下载页点击 MacOS 客户端。
2. 打开 DMG，将 OmniStudio 拖入 Applications。
3. 从 Applications 启动。正式包应通过 Gatekeeper，不需要关闭系统安全设置。
4. 如果 Gatekeeper 拒绝打开，请保留原始提示并提交反馈，不要移除 quarantine 属性绕过检查。

第一次启动

OmniStudio 会检查本机推理服务和基础后端。Windows 正式包已包含 CPU 后端，Apple Silicon Mac 正式包已包含 Metal 后端，因此这一步通常只需要几秒；模型本身仍需要你随后选择并下载。

看到设备推荐后，可以查看推荐模型，也可以暂时跳过。推荐完成不代表模型已经下载：只有下载中心出现实际字节、速度和剩余时间时，才进入了模型下载阶段。

数据保存位置

• Windows 正式版将客户端数据放在安装目录旁的 .omnistudio，模型目录可以在设置中更改。
• macOS 正式版将 .omnistudio 放在系统分配的应用本地数据目录，不写入 DMG 或 /Applications。
• OmniInfer 的 runtime 与 state 使用系统应用本地数据目录。

不建议手工编辑这些目录。需要查看或更改模型目录时，请使用 Settings → Model directory。

下一步：五分钟完成首次对话。