系统要求#

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

安装#

kaya 分**国内版(cn)与国际版(intl)**两个构建变体:国内版官网为 yunhouai.com(微信扫码登录、微信支付);国际版官网为 yunhou.ai(GitHub 登录、PayPal 支付)。两个变体的安装包都发布在 GitHub Releases,功能一致。

macOS 主路径:下载 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

Windows 主路径:下载安装包(x64)

1. 打开 kaya 官网或 GitHub Release 页面,下载 kaya-x.y.z-windows-x64.exe(NSIS 安装包;同版本也提供 .msi,任选一个)
2. 双击运行安装向导,按提示完成安装
3. 从开始菜单打开 kaya

首次启动(macOS)

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

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

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

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

---

首次配置#

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

方式 A(默认,免 API Key):内置模型 + 微信登录

kaya 出厂默认走内置模型(yunhou /chat 代理,服务端持 DeepSeek key 代答),无需自己申请 API Key,只需登录 yunhou 账号:

1. 点击右上角 ⚙ 设置,或在对话窗口点 微信扫码登录(顶栏账户图标 / 登录按钮)
2. 系统浏览器打开微信扫码页 → 扫码 → 自动跳回 kaya 完成登录(令牌写入系统钥匙串(macOS Keychain / Windows 凭据管理器))
3. 回到对话窗口即可直接提问。订阅/试用状态在 ⚙ 设置 → 账户 标签页查看

国际版(intl build)的登录与支付入口见上方构建变体说明;其余流程与国内版一致。

方式 B(自备 API Key):OpenAI 兼容

如果你想用自己的 LLM key:

1. 点顶栏模型切换器,一键切到 我的模型(与「内置模型」随时互切)
2. 打开 ⚙ 设置 → 模型 标签页,新增或编辑一条模型库条目:
   • Provider(服务商):DeepSeek / OpenAI / OpenRouter / Ollama / 自定义(OpenAI 兼容)等预设
   • API Key:从服务商官网获取,统一存入系统钥匙串
   • Base URL / Model:选择预设后自动填入,通常无需修改
   • 一条条目可同时带对话 / Anthropic / OpenAI 三种端点,配一次各处都能用
3. 如需在某个编程 agent 里用这条模型,打开 Agents 面板展开它的模型列表,点「使用」完成绑定
4. 回到对话窗口即可使用

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