安装

下载 Cordy Desktop,处理 SmartScreen 或 Gatekeeper 警告,在 Linux 上安装,并手动更新。

平台状态

平台最新公开构建安装包
Windows x640.6.0NSIS 安装程序(.exe)
macOS,Apple Silicon0.5.3.dmg 或 .zip
Linux x64 与 arm640.5.3.AppImage 或 .deb
  • 0.5.4、0.5.5 与 0.6.0 只发布了 Windows 版本。macOS 与 Linux 用户停留在 0.5.3,没有此后新增的功能,例如块编辑器笔记。
  • 没有 Windows on ARM 构建,也没有 Intel Mac 构建。
  • Windows 安装程序未做代码签名。macOS 构建未经公证。
  • Cordy Desktop 自 0.5.4 起为专有软件。0.5.3 及更早版本以 MIT 许可证发布。

源码标签不等于发布:只有公开发布仓库中已发布 Release 附带的构建才可下载。Cordy Desktop 不通过任何应用商店分发。

获取构建

Cordy Desktopv0.6.0

发布于 2026-10-22发布说明

平台架构文件大小SHA-256
Windowsx64cordy-desktop-0.6.0-win-x64.exe123.4 MBca2173e23b13

完整校验和见发布页上的 SHASUMS256.txt。

0.6.0 仅提供 Windows x64 版本。macOS(Apple Silicon)与 Linux(x64/arm64)请使用 Cordy 桌面端 0.5.3。没有 Windows on ARM 版本。Windows 安装包未做代码签名,首次运行时 Windows SmartScreen 会弹出警告——见安装文档。

公开构建只来自公开发布仓库。每个 Release 页面(例如 desktop-v0.6.0 或 desktop-v0.5.3)列出其文件和一个 SHASUMS256.txt。

校验下载

运行构建前,把它的 SHA-256 与同一 Release 中的 SHASUMS256.txt 对比。校验指南(英文)给出了各平台的命令,包括用于核验构建证明的 gh release verify。

校验和一致只能证明文件完整、且就是已发布的那个文件,并不证明文件安全。

Windows

需要 Windows x64。完整说明见 Windows 安装指南(English、中文)。

  1. 下载 .exe 安装程序并校验。
  2. 运行安装程序。由于安装程序未做代码签名,Windows SmartScreen 会显示「Windows 已保护你的电脑」。
  3. 选择更多信息,确认应用名就是你校验过的文件,再选择仍要运行。
  4. 在安装程序中保留或更改安装目录。安装程序会创建名为 Cordy 的桌面与开始菜单快捷方式。
  5. 启动 Cordy。

不要为绕过警告而关闭 SmartScreen 或 Microsoft Defender。

macOS(0.5.3)

需要 Apple Silicon Mac。完整说明见 macOS 安装指南(仅英文)。

  1. 下载 0.5.3 的 .dmg 或 .zip 并校验。
  2. 打开 .dmg 并把应用拖到应用程序,或解压 .zip 后把应用移到应用程序。
  3. 打开应用。Gatekeeper 提示 Apple 无法验证其不含恶意软件。选择完成,不要选择移到废纸篓。
  4. 打开系统设置 → 隐私与安全性,滚动到安全性,选择仍要打开。
  5. 警告再次出现时选择打开,然后用密码或触控 ID 确认。

在 macOS Ventura 或 Sonoma 上,按住 Control 点按应用并选择打开也可能有效。macOS 会记住对该构建的批准。不要关闭 Gatekeeper。

Linux(0.5.3)

提供 x64 与 arm64 构建。选择与你机器匹配的文件并校验。

  • AppImage:用 chmod +x 赋予文件可执行权限后运行。
  • deb:用 sudo apt install ./<文件名>.deb 安装,然后从应用启动器启动 Cordy。

0.5.3 在普通 Linux 桌面上的沙箱启动与 AppImage 挂载尚未完整验证。如果 AppImage 无法启动,请改用 .deb 安装包。

首次启动

使用添加仓库、把仓库文件夹拖入首次运行页面,或按 Ctrl+Shift+O。Cordy 需要本地 Git 仓库。它不会替你安装或登录 CLI 智能体;启动预设前请先配置各工具。项目搜索使用的 ripgrep 已随应用捆绑。

更新

Cordy Desktop 没有自动更新器,也不会检查新版本。更新需手动完成:

  1. 关注 Releases 页面上的新 Desktop 版本。侧栏的关于显示已安装版本。
  2. 下载并校验新构建。
  3. 覆盖安装:运行新的 Windows 安装程序、在 macOS 上替换应用程序中的应用、安装新的 .deb,或替换 AppImage 文件。

安装新版本会保留本地数据。只有最新版本会获得安全修复。

部分版本会在首次启动时转换本地数据:0.5.4 转换 worktree 工作区,0.5.5 把 Markdown 笔记转换为块格式。每次转换都会保留备份,但转换后不支持退回更早版本。见疑难排查。

数据位置

公开构建名为 Cordy,数据保存在 cordy 文件夹中:

  • Windows:%APPDATA%\cordy
  • macOS:~/Library/Application Support/cordy
  • Linux:~/.config/cordy

其他 Cordy 发布渠道的构建使用不同的名称和数据文件夹,因此可以并存安装且不共享数据。公开构建不能并存安装两份:新安装程序会替换旧版本,并沿用同一数据文件夹。文件夹内容见隐私与数据。

相关