跳到主要内容

下载 Helix

选择适合你的方式，几分钟完成首次启动配置。

最新版本

1.5.4

选择你的方式​

桌面应用（推荐）​

适合完整的本地工作流：工作区文件、终端集成、完整的编码工具体验。

后端服务​

适合浏览器使用、远端环境或自托管部署。

Web 应用​

适合即时体验。受浏览器沙箱限制，本地工具能力有限。

桌面应用​

macOS​

下载 macOS 版

 Loading checksum...
  • 通用二进制（同时支持 Apple Silicon 与 Intel）
  • 需要 macOS 11.0 及以上
  • 安装包大小约 150 MB

安装步骤

  1. 打开 .dmg 文件
  2. 将 Helix 拖入 Applications
  3. 启动 Helix

Windows​

下载 Windows 版
  • Windows 10/11（x64）
  • 安装包大小约 27 MB

安装步骤

  1. 运行 .exe 安装程序
  2. 跟随安装向导完成安装
  3. 从开始菜单启动 Helix
Windows 安全提示

如果 Windows Defender 弹出警告，点击 更多信息 → 仍要运行。

Linux​

开发中

原生 Linux 桌面安装包仍在开发中。

你可以先使用以下方式：

Android​

下载 Android 版
  • Android 6.0 及以上
  • 安装包大小约 89 MB

安装步骤

  1. 下载 .apk 文件
  2. 在系统设置中开启「允许安装未知来源应用」
  3. 打开 .apk 完成安装

iOS（侧面安装）​

下载 iOS 版（未签名）
  • 需要 iPhone / iPad（iOS 15.0 及以上）
  • 未签名 IPA，需使用 AltStore 或 SideStore 侧面安装
  • 也可使用爱思助手等工具签名安装

安装步骤

  1. 在电脑上安装 AltStore / SideStore
  2. 将 iPhone 连接到电脑
  3. 下载本 IPA 文件
  4. 用 AltStore / SideStore 导入安装
为什么是未签名版本？

Helix 未加入 Apple Developer Program，因此 IPA 未经过 Apple 签名。 你需要使用侧面加载工具自行签名安装。这不需要越狱。

后端服务​

适合远端使用、Web 模式与自托管部署。

macOS 二进制​

Intel（x64）Loading checksum...
Apple Silicon（ARM64）Loading checksum...

Linux 二进制​

Linux x64Loading checksum...
Linux ARM64Loading checksum...

Windows 二进制​

Loading checksum...

启动后端​

# macOS / Linux
chmod +x helix-agent-*
./helix-agent-macos-arm64  # 替换为你下载的二进制

# Windows
helix-agent-windows-amd64.exe

默认端点：http://localhost:8080

Linux 运行时依赖（用于网页抓取相关工具）​

如果在 Linux 上运行后端，请先安装浏览器运行时依赖。

sudo apt-get update && sudo apt-get install -y --no-install-recommends \
  libglib2.0-0 libnss3 libnspr4 libdbus-1-3 \
  libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libatspi2.0-0 \
  libx11-6 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 \
  libgbm1 libpango-1.0-0 libcairo2 libasound2 libxshmfence1 libxkbcommon0 \
  fonts-liberation

Web 应用​

启动 Helix Web
Web 模式的限制
  • 无法直接访问本地文件系统
  • 无法集成本地终端
  • 适合体验与远端使用场景

将 Web 应用安装为 PWA（可选）​

Chrome / Edge

  1. 打开 Helix Web
  2. 点击地址栏中的安装图标
  3. 确认安装

Safari（macOS）

  1. 打开 Helix Web
  2. 文件 → 添加到 Dock
  3. 确认添加

校验下载文件​

当前版本所有文件的校验值：

Loading checksums...

手动校验：

# macOS / Linux
shasum -a 256 Helix-*.dmg
sha256sum helix-agent-*

# Windows PowerShell
Get-FileHash helix-agent-windows-amd64.exe -Algorithm SHA256
查看原始 checksum 文件

安装常见问题​

macOS：「无法验证开发者」​

桌面应用

  1. 在应用上右键 → 打开
  2. 在弹窗中确认打开
  3. 或在 系统设置 → 隐私与安全性 中允许运行

服务端二进制

xattr -d com.apple.quarantine helix-agent-macos-*
chmod +x helix-agent-macos-*

Windows：「Windows 已保护你的电脑」​

  1. 点击「更多信息」
  2. 点击「仍要运行」
  3. 可选：右键属性 → 解除锁定

Linux：权限不足​

chmod +x helix-agent-linux-*

安装后：首次启动清单​

  1. 在设置中配置一个模型供应商
  2. 添加一个工作区（项目路径）
  3. 跑一个真实任务，端到端验证
  4. 阅读核心文档，了解架构与工作流

继续阅读：