安装

Windows、macOS、Linux 的环境要求与安装方式。

环境要求

• 操作系统：Windows 10+（x64）、macOS 11+（Apple Silicon / Intel）、Linux（x86_64 / aarch64）
• 磁盘空间：约 500 MB（含 bundled 后端与内置助手）
• 网络：首次使用需联网配置模型 API；日常使用按所选模型供应商要求
• 可选：本机已安装 Claude Code / Codex CLI / Cursor Agent 等 CLI 工具（自动检测，非必须）

Windows

1. 从官网下载 One-Work-{version}-win-x64.exe
2. 双击安装，按向导完成
3. 启动「One Work」即可

macOS

1. 下载对应架构的 .dmg（Apple Silicon 选 arm64，Intel Mac 选 x64）
2. 拖入 Applications 文件夹
3. 首次打开若被拦截：

xattr -cr "/Applications/One Work.app"

或在 系统设置 → 隐私与安全性 中点「仍要打开」。

Linux

1. 下载 .deb 包（x86_64 或 arm64）
2. 安装：

sudo dpkg -i One-Work-{version}-linux-{arch}.deb

3. 从应用菜单启动，或命令行运行 one-work

检查安装

启动后应看到 One Work 主界面。若异常：

1. 确认安装包版本与系统架构匹配
2. 检查 %APPDATA%/One Work（Windows）或 ~/Library/Application Support/One Work（macOS）下是否有日志
3. 返回官网联系获取支持

保持更新

One Work 不提供应用内自动更新（v2.1.40+）。新版本请从官网下载页获取最新安装包，覆盖安装即可，用户数据保留。

卸载

• Windows：设置 → 应用 → One Work → 卸载
• macOS：将 One Work.app 移入废纸篓
• Linux：sudo apt remove one-work

卸载不会自动删除用户数据目录；如需彻底清除，手动删除上述 AppData 路径。