安装
下载 Cordy Desktop,处理 SmartScreen 或 Gatekeeper 警告,在 Linux 上安装,并手动更新。
平台状态
| 平台 | 最新公开构建 | 安装包 |
|---|---|---|
| Windows x64 | 0.6.0 | NSIS 安装程序(.exe) |
| macOS,Apple Silicon | 0.5.3 | .dmg 或 .zip |
| Linux x64 与 arm64 | 0.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 |
|---|---|---|---|---|
| Windows | x64 | cordy-desktop-0.6.0-win-x64.exe | 123.4 MB | ca2173e23b13 |
完整校验和见发布页上的 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、中文)。
- 下载
.exe安装程序并校验。 - 运行安装程序。由于安装程序未做代码签名,Windows SmartScreen 会显示「Windows 已保护你的电脑」。
- 选择更多信息,确认应用名就是你校验过的文件,再选择仍要运行。
- 在安装程序中保留或更改安装目录。安装程序会创建名为 Cordy 的桌面与开始菜单快捷方式。
- 启动 Cordy。
不要为绕过警告而关闭 SmartScreen 或 Microsoft Defender。
macOS(0.5.3)
需要 Apple Silicon Mac。完整说明见 macOS 安装指南(仅英文)。
- 下载 0.5.3 的
.dmg或.zip并校验。 - 打开
.dmg并把应用拖到应用程序,或解压.zip后把应用移到应用程序。 - 打开应用。Gatekeeper 提示 Apple 无法验证其不含恶意软件。选择完成,不要选择移到废纸篓。
- 打开系统设置 → 隐私与安全性,滚动到安全性,选择仍要打开。
- 警告再次出现时选择打开,然后用密码或触控 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 没有自动更新器,也不会检查新版本。更新需手动完成:
- 关注 Releases 页面上的新 Desktop 版本。侧栏的关于显示已安装版本。
- 下载并校验新构建。
- 覆盖安装:运行新的 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 发布渠道的构建使用不同的名称和数据文件夹,因此可以并存安装且不共享数据。公开构建不能并存安装两份:新安装程序会替换旧版本,并沿用同一数据文件夹。文件夹内容见隐私与数据。