系统要求#

• macOS 12 或更高
• Apple Silicon (M1/M2/M3/M4) 原生,Intel 兼容
• 约 150 MB 磁盘
• 网络:访问 LLM 提供商 API(Ollama 本地推理除外)

安装#

主路径:下载 DMG

1. 打开 kaya 官网或 GitHub Release 页面,下载 kaya-x.y.z-macos-universal.dmg(Apple Silicon 和 Intel 通用)
2. 双击 DMG 挂载,会看到 kaya.app 窗口
3. 把 kaya.app 拖入 /Applications 文件夹
4. 在 Launchpad 或 /Applications 里打开 kaya

首次启动

如果 macOS 提示无法验证应用:

1. 在 Finder 里找到 /Applications/kaya.app
2. 在系统设置的 隐私与安全性 中允许已确认的 kaya 应用
3. 再次打开 kaya

不要关闭 Gatekeeper,也不要执行来源不明的提权命令。

当前官网用户手册只推荐 DMG 安装。命令行版本的预编译 release 已暂停提供；需要 CLI 的高级用户应参考独立 CLI 文档。

---

首次配置#

第一次打开 kaya 后,先做以下配置:

1. 点击右上角 ⚙ 设置 按钮
2. 在 LLM 标签页,选择你的 Provider(服务商):
   • DeepSeek:国内常用,默认模型 deepseek-v4-flash
   • OpenAI:国际通用,需要海外访问
   • OpenRouter:聚合多家模型,可在一个 key 下切换模型
   • Ollama:本地推理,需要先启动 ollama serve
3. 填入 API Key:从你选择的 Provider 官网获取
4. 检查 Base URL:选择预设后会自动填入,通常无需修改
5. 选择 Model:默认模型对大多数任务已够用
6. 根据需要开启 Thinking Mode(思考模式):让 AI 在回答前先展示推理过程
7. 点击保存,回到对话窗口

第一次配置完成后,kaya 会自动记住。下次打开无需重新设置。