跳转到内容

安装与首次使用

在 GitHub Releases 下载对应系统和架构的安装包。暂无对应产物时,请从源码运行。

当前已在 macOS 完成本机构建。Windows、Linux 和 macOS Intel / Apple Silicon 的发布工作流已配置,其他平台仍需实机验证。当前构建未配置正式代码签名与 Apple 公证。

需要 Node.js 22.12+、Rust stable,以及 Tauri 2 的系统依赖。

终端窗口
git clone https://github.com/yemaster/OiAgent.git
cd OiAgent
npm ci
npm run desktop

只预览前端时运行 npm run dev,访问 http://127.0.0.1:1420。浏览器使用演示数据;真实任务、文件、终端和配置管理需要桌面版。

  1. 安装并登录 Agent

    安装需要使用的 CLI,按其说明完成登录。在系统终端确认程序可以启动。

  2. 确认程序已被发现

    打开 Agent 程序。未发现时重新扫描,或手动添加可执行文件。

  3. 选择项目和任务内容

    点击 新建任务,选择已有目录或 临时项目,再选择 Agent,填写任务内容。

  4. 设置权限并启动

    默认权限为只读或计划模式。需要修改代码时,选择对应的写入权限。在 当前任务 中打开任务,查看回复、执行记录和状态。