跳到主要内容
云猴智能体云猴智能体
下载 Kaya
本页内容

设置参考

打开 ⚙ 设置。宽窗口下左侧按组导航：编程（模型 / 编程 Agent / 网关）、通用（通用 / 记忆 / 快捷键 / 定时任务）、连接（IM 渠道 / 远程访问 / 跨机协同）、系统（账户 / 审计 / 日志与调试）。窄窗口降级为顶部标签页，默认打开模型。

模型#

模型库采用左栏供应商、右栏详情：

  • + 添加供应商：从 200+ 目录或自定义 OpenAI 兼容端点添加。

  • 维护 API Key / OAuth、三种协议端点、模型清单、上下文窗口、能力与思考档位。

  • 决策层：快速决策层和指令确认模式立即生效，不影响终端写入授权卡。

  • 用量统计：在「模型库 | 用量统计」之间切换。

详见 模型库与供应商、思考模式 和 Token 用量。

编程 Agent#

编程 Agent 的安装、更新、卸载、自定义命令名、模型接入和配置优化都在这里，原独立 Agents 管理中心已并入设置。详见 编程 Agent 管理。

网关#

  • 启用开关与运行状态；dev / prod 实例互斥。

  • 独立脱敏档位，默认 strict：只自动拦截具名 secret，普通 PII 不自动改写；可显式选择 balanced / aggressive。

  • Claude 是否由 Kaya 托管、未知路径是否拒绝。

  • 命中计数与只读模型目录；第三方工具接入时必须使用目录中的 kaya/<别名>。

  • 用户令牌表，用固定假名替换真名或内部代号。

  • 隐私保护统计：筛选、搜索和清空本地命中明细；原文默认遮罩，仅存本机。

详见 模型网关。

通用#

项说明
Language界面语言
ShellPTY 使用的 shell 路径与重连
保留终端滚动历史重启后是否保留各标签页的终端历史
终端字体大小终端显示字号
联网搜索Tavily API Key 与启用开关
网络代理Kaya 自身出站请求使用的 HTTP / HTTPS / SOCKS5 代理
脱敏用户输入恒 aggressive；工具输出默认 aggressive；网关独立默认 strict（仅具名 secret）

网络代理#

可为 Kaya 自身配置手动 HTTP / HTTPS / SOCKS5 代理，主机填 hostname 或 IP，端口 1–65535，可选用户名与密码；SOCKS5 使用远端 DNS。密码采用 write-only 保存，只进入系统钥匙串，不留 localStorage；留空表示保留旧密码，也可显式清除。直连例外支持 hostname / IP / CIDR，localhost / 127.0.0.1 / ::1 恒直连且不可移除。

**按目标协议配置：**默认使用单个代理端点；开启「按目标协议分别配置」后，可分别保存 HTTP、HTTPS 与 SOCKS5 端点及认证。目标优先使用对应协议端点；未启用时先回退 SOCKS5，最后借用另一类兼容端点。启用代理时至少需要一个可用端点。

**按出口选择代理或直连：**模型（聊天与供应商 OAuth）、网关上游、账号与登录、用量上报（Token 用量与心跳）、联网搜索、IM 渠道、远程访问、更新，这八类出口可分别选择走代理或显式直连。各功能自己发起的令牌刷新跟随该功能的出口设置。

显式直连的范围不读取系统代理、PAC 或进程代理环境变量。其余范围按当前代理配置发送；代理不可用或凭据状态不确定时会停止请求，不会自动回退直连。关闭应用代理会保留配置草稿并显式直连。

Shell 隔离：该设置只影响 Kaya 应用自身的出站请求，不写 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY，不改 shell profile、不注入 PTY 启动参数。Terminal、PTY、AI 的 run_shell 子进程以及你从中启动的 Agent 完全不受影响；终端里的程序如需代理仍由你自行配置。

记忆 / 快捷键 / 定时任务#

  • 记忆：查看核心、语义、情景记忆和「最近自动变更」，管理规则 / 事实与项目作用域，编辑、回滚或彻底删除条目，并可手动巩固和清理。详见 记忆机制。

  • 快捷键：查看 macOS 与 Windows 的终端、分屏、聚焦和对话热键。详见 快捷键。

  • 定时任务：按间隔或每天定点发起回合，可启停、删除和设次数上限。详见 定时任务。

IM 渠道 / 远程访问 / 跨机协同#

  • IM 渠道：配置飞书 / Slack 凭据与 allowlist，启停渠道和管理镜像；渠道需要保持登录，使用自备 API Key、Ollama 或适用的自有 OAuth 时无需有效订阅，订阅到期或取消不会停止渠道，登出仍会停止渠道，使用内置云模型的 IM 路线仍需有效订阅或试用。

  • 远程访问：默认关闭，需登录与有效订阅；管理设备 ID、设备名和 relay 状态。

  • 跨机协同：执行端总开关默认关闭，配置设备白名单、Agent 范围和对话中转权限。

详见 IM 渠道、远程访问 和 跨机协同。

账户#

查看登录、订阅 / 试用、刷新订阅与登出；高级里可手动粘贴登录令牌。

云端 Token 用量默认关闭。确认 kaya-usage-upload-v2 后，只上传 UTC 聚合用量桶与随机设备 ID、OS 家族、Kaya 版本、consent 版本，不上传对话、文件或凭据。旧状态无法核验身份时默认只上传新授权后的用量；符合条件的最近 30 天历史需预览后另行明确确认。可信同账号普通关闭后重开可回填关闭期间的用量；换账号或撤销后的新授权与旧身份隔离，撤销前和未授权期间的记录不会补传。关闭不删除已上传数据，国内版与国际版分别保存同意和设备身份。详见 Token 用量。

使用情况心跳与云端 Token 用量不同。使用情况心跳默认开启：登录后每 5 分钟向 yunhou 发送活跃时长、平台、应用版本、日期及事件标识，不含对话或文件内容；可在 设置 → 账户 单独关闭。它与云端 Token 用量同意是独立开关，使用本地模型不会自动关闭这类统计通道。

审计#

查看已接入审计来源的历史会话，运行规则回放、异常启发式和 AI judge 三层评估。IM / 远程收发行暂未接入审计 JSONL。详见 安全审计。

日志与调试#

查看 App 诊断日志，手动清理 7 天前的旧日志；dev 构建另有调试小节。审计日志、App 日志与网关隐私明细是三套不同记录。

关于与更新#

「关于」和「检查更新…」位于系统菜单，不是设置标签页。macOS 发现新版本后可用「下载并安装」一键更新，签名校验通过并重启后生效；也可以从官网下载安装包手动覆盖。