安装指南
绿色安装，简单便捷,人人都能快速上手。
一、安装步骤（Windows）
OmniAgent 为便携（绿色）安装：下载 ZIP → 解压 → 运行，即可使用。
下载安装包
若尚未下载，请前往 客户端下载，获取最新安装包。
安装包类型说明
提供两个 Windows 安装包：cc.zip（简易安装包，约 20MB）与 cc-full.zip（完整安装包，约 150MB）。
简易安装包（cc.zip）适合升级安装；首次安装请选择完整安装包（cc-full.zip）。
Windows 运行依赖
部分系统如未安装 Microsoft Edge WebView2 Runtime，客户端可能无法正常启动。请先安装：
WebView2 Runtime 下载页
解压到本地目录
将压缩包完整解压到您希望存放程序的文件夹（例如 D:\Tools\OmniAgent）。
避免解压到系统盘（C 盘）或者系统目录，以减少权限问题。
必须先解压
不要直接在压缩包内双击运行 CcLaucher.exe，会导致后续组件安装与配置失败。请先将压缩包解压到本地目录，再运行程序。
运行安装程序（关键步骤）
进入解压后的目录，找到 CcLaucher.exe，右键 → 以管理员身份运行。
必须以管理员身份运行
若未以管理员权限启动，OmniAgent 无法完成组件安装与环境配置，后续步骤将无法继续。若出现 Windows Defender 提示，可先点「更多信息」，再选择「仍要运行」。
二、首次运行配置
首次启动OmniAgent，仅需完成 3 步，即可开始使用：自动安装组件 → 设备授权 → 设置工作目录。下面逐步说明。
自动安装组件（安装向导引导）
首次启动后，系统会自动检测运行环境，并展示组件状态：
- 黄色「待安装」：该组件尚未安装，需要补齐；
- 绿色「已就绪」：该组件已就绪，无需再装。
只需点击 「开始自动安装」，其余全部交给系统完成。 OmniAgent 共需 5 个基础组件，安装过程中如有弹窗，直接点击 「确定」 即可。
简单补充
如果中途关闭或被打断，重新打开客户端，再点一次「开始自动安装」即可继续，无需重头再来。
安全软件提示（常见）
安装过程中，360 等安全软件可能弹出拦截提示（例如「有程序正在修改受信证书发行者」）。这是正常的系统配置操作，请在弹窗中选择 允许全部 / 允许所有操作，否则组件可能无法完整安装。
设备授权（1分钟完成）
组件安装完成后，重启客户端，将提示进行设备授权。请在界面中点击 「在线申请」，按提示填写设备信息并完成授权绑定。
完成设备授权后，才能启动 Agent 执行任务。
版本与申请流程
各版本差异及完整授权申请步骤，请参阅 设备授权指南。
设置工作目录
首次进入客户端时，系统会提示您选择一个本地文件夹作为 工作目录。工作目录是 智能体活动目录，是所有处理和被处理文件的集中存放处。
图示：首次进入时的「选择工作目录」弹窗。
目录路径必须全为英文
工作目录路径（含所有上级文件夹名称）不得包含中文等字符，否则会导致环境配置异常。请使用纯英文路径，例如 D:\WorkSpace\OmniAgent，不要使用 D:\工作区\OmniAgent。
三、卸载与清理
OmniAgent 为便携（绿色）版，无需复杂卸载流程，卸载步骤如下：
- 退出程序：先完全退出 OmniAgent，避免文件被占用。
- 删除安装目录：删除解压后的软件文件夹即可移除主程序。
- 删除工作目录（可选）：若不再需要任务产出与缓存数据，可一并删除首次配置时指定的工作目录。
环境组件说明（可选处理）
首次运行过程中，可能安装了 Python、Node.js、Git 等运行环境。
👉 这些组件属于通用开发环境，不会影响系统使用：
可保留：不影响系统，也可供其他软件使用 可卸载：如不再需要，可自行删除
📍 卸载路径： 设置 → 应用 或 控制面板 → 程序和功能