安装与启动
支持 Windows / Linux / macOS / 信创；本文提供常见 Windows 安装指引。
OmniAgent 客户端已支持 Windows、Linux、macOS 及信创环境。本文档仅提供最常见的 Windows 安装与启动指引；Linux、macOS、信创等其他版本安装包与部署说明，请联系商务获取。
Windows 版安装分两步：先把程序释放到本机，再由向导自动检测并补齐 Node.js / Python / Git / uv 等运行组件。电脑无需预先配置这些环境，双击安装包即可。
其他平台版本
如需 Linux / macOS / 信创 安装包或对应部署指引，请通过官网商务渠道或邮箱 market@sanhan.cc 联系，由商务按现场环境提供。
一、运行环境要求（Windows）
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 64 位（1903 及以上）或 Windows 11，不支持 32 位 / Windows 7 / 8 |
| .NET Framework | 4.8（Win10 通常已有；缺失时安装包会中止并提示先安装） |
| WebView2 Runtime | Win11 一般已内置；Win10 若缺失需先安装 Microsoft Edge WebView2 |
| 内存 / 磁盘 | 建议 8 GB 内存、安装目录预留 2 GB+ 可用空间（安装包界面显示的是程序体积，运行组件另外占用空间） |
欢迎页卡住无法继续？
环境准备向导欢迎页会检测 WebView2。未安装时 「同意并继续」不可用，请先安装 WebView2 Runtime 后再打开安装目录中的 AgentInstall.exe，或重新运行安装包。
二、安装步骤（Windows）
1. 运行安装程序
- 双击收到的 OmniAgent 安装包（
.exe），启动安装向导（版本号以安装包标题为准）。 - 若弹出「用户账户控制」，选择 「是」。
- 在 「选择目标位置」 页确认安装目录（默认为
C:\OmniAgent，可点 「浏览」 修改；界面会提示当前包所需空间），点击 「下一步」。 - 在 「准备安装」 页核对目标路径，点击 「安装」 开始释放文件；如需修改目录，可点 「上一步」 返回。
2. 运行环境准备（自动完成）
文件释放结束后会进入 运行环境准备 向导（AgentInstall.exe）。若弹出管理员授权，请选择 「是」。按下面 4 步完成检测与安装：
| 步骤 | 界面 | 说明 |
|---|---|---|
| 01 欢迎 | 欢迎页 | 查看系统要求（Windows 10/11 64 位、WebView2）与预装组件（Node.js、Python、Git、uv），点击 「同意并继续」 |
| 02 环境检测 | 环境检测 | 自动检测本机组件与安装包内离线包是否齐全；已满足的会跳过 |
| 03 安装组件 | 正在准备运行环境 | 对缺失组件离线安装，显示进度与当前安装项 |
| 04 完成配置 | 环境配置完成 | 可勾选 「创建桌面快捷方式」、「预置智能体初始数据」（有数据包时），点击 「启动应用」 |
运行环境准备：欢迎 → 环境检测 → 安装组件 → 完成配置
安装提示
建议安装时暂时关闭杀毒 / 安全软件，避免误拦组件安装。企业环境可将整个安装目录加入白名单。主组件已内置在安装包中，一般无需联网；若需补装个别运行依赖，请保持网络畅通。请勿单独复制 exe，须保持安装目录完整。
环境准备失败时，可在完成页点 「查看安装日志」，或见 常见问题。日后若提示缺少组件，启动应用时会再次打开本向导。
三、安装后建议
- 确认 授权说明：首次安装已内置试用授权，到期后按机器码申请正式授权。
- 首次启动后，先到 系统设置 → 模型配置 完成大模型 / API 密钥配置，否则无法对话。
- 开始任务前，在输入卡片右下角指定 工作目录（未选时显示「选择目录…」），智能体才能读写项目文件。
- 更完整的界面说明见 功能总览、新任务。
四、卸载（Windows）
推荐从 Windows 设置 → 应用 中卸载 OmniAgent（会清理程序文件与运行环境）。也可以运行安装目录中的 uninstall.bat，按提示停止进程并删除程序文件。
卸载不会删除用户数据（对话、记忆与本地配置默认保留在用户目录）。Git 若由向导装到系统，卸载程序不会移除 Git。
其他平台的卸载与数据目录说明，随对应安装包一并提供，或咨询商务。