安装 Kairo Code 桌面端

Kairo Code 目前以受控的 macOS 桌面端预览版分发。本官方用户手册只围绕签名 DMG，完整说明安装、 日常使用、恢复与安全移除。

当前分发状态

本网站是用户手册，不是下载门户。只有组织管理员提供批准的认证渠道以及与安装包匹配的发布记录 后，才能安装 Kairo Code；目前没有公开下载的备用入口。

桌面端安装等待核验

Kairo Code

应用程序

只移动一个经过核验的应用

Kairo Code.app→应用程序

1. 01装载 DMG
2. 02移入应用
3. 03核验构建

安装前检查

桌面端当前支持 Apple silicon（arm64）Mac。应用已经包含匹配的 Java Host 和浏览器运行时， 使用内置 Browser 不需要另外安装 Java、Node.js 或浏览器扩展。

打开 DMG 前，确认批准的发布记录明确包含：

• 适用于 macOS Apple silicon 的 Kairo Code Desktop；
• 你收到的版本与构建标识；
• Developer ID 签名以及成功的 Apple 公证；
• DMG 校验和或等效的来源身份。

任何字段缺失或与下载文件不一致，都应先停止并联系管理员。

将 Kairo Code 移入“应用程序”

1. 打开批准的 .dmg。
2. 在安装器窗口中，把 Kairo Code 拖到 应用程序。
3. 等待复制完成，然后推出 Kairo Code 安装器卷。
4. 打开“应用程序”并从这里启动 Kairo Code；不要运行仍留在 DMG 挂载卷中的副本。

经过批准的 Developer ID 构建应能由 macOS 正常打开。如果系统报告应用身份未知或文件损坏， 不要关闭 Gatekeeper，也不要执行移除 quarantine 的命令；应与管理员重新核对渠道、校验和、签名 和公证状态。

核验正在运行的构建

Kairo Code 打开后，进入 设置 → 高级 → 关于，把版本、源码修订、可执行文件摘要和构建日期 逐项对照批准的发布记录。原生 Kairo Code → 关于 Kairo Code 面板可以确认应用版本，但“设置” 中的来源字段才是更强的身份检查。

只有安装结果与批准记录一致后，才开始处理真实工作。

完成首次启动

首次启动会运行内置本地 Host 并打开项目启动器。只批准你预期看到的 macOS 权限和工作区目录：

• 选择 打开文件夹，打开允许修改的仓库；
• 添加并测试组织提供的模型连接；
• 在第一个任务前检查权限配置；
• Browser、记忆贡献和外部工具学习应保持关闭，直到你明确需要并主动启用。

Kairo Code 不需要访问 Mac 上的所有文件夹。与当前工作区或你刚发起的操作无关的权限请求，应拒绝 并进一步排查。

更新或回滚

只有管理员配置了批准的发布渠道，桌面端才会显示更新。应用前先完成或停止活动任务，并将目标版本 与渠道中的发布记录对照；Kairo Code 会在激活前暂存并验证匹配的 Desktop/Host 组合。

新版本异常时，进入 设置 → 高级 → 关于；存在经过验证的上一版本组合时，使用界面提供的回滚 操作。没有显示回滚入口时，应停止创建新工作并联系管理员，不要单独替换应用内部文件。

从桌面端返回本手册

使用桌面端左下角常驻的 ? 或 macOS 原生“帮助”菜单：

桌面端命令	打开的页面
Kairo Code 用户手册	产品概览
安装与更新 Kairo Code	本页
版本新特性	版本说明
故障排查	桌面端故障排查

这些入口只打开产品说明，不公开源码，也不能授权某个安装包。

卸载

退出 Kairo Code，把“应用程序”中的 Kairo Code.app 移到废纸篓，并在组织政策允许时清空。 移除应用会有意保留任务、设置、技能、插件和本地证据，避免重新安装时静默销毁工作。

如果还需要清除产品数据，应先在 Kairo Code 中永久删除敏感任务，再遵循组织批准的数据移除流程； 不要手工删除单独的数据库、Browser checkpoint 或 Memory 回执文件。

下一步

继续完成第一个任务。