编程 Agent 管理
Kaya 是为开发者打造的 AI 终端，编程 Agent 管理是其中一项核心能力。你可以集中安装、配置与更新 Claude Code、Codex、OpenCode、Kimi Code，为它们绑定模型，在不同标签页并行运行，并通过 Agent 列表和终端输出跟进工作。AI 大脑在你授权后协助输入指令，操作权限和关键决策由你掌握。
coding 模式与等待确认#
打开顶栏 coding 模式后：
Agent 弹出确认、等待决策时，Kaya 转达内容并询问你的指示。
Agent 跑完空闲时，Kaya 读取结果、总结进展并询问下一步。
每个 tab 的自动回合有 60 秒冷却，对话进行中不插队。
智能调度会在转发前判断目标在忙、空闲或等待确认；重复指令会提醒，写入后读屏确认是否真正提交。
快速决策层默认开启：重复空闲和瞬时运行状态不打扰，简单提问走轻量回合；可在 设置 → 模型 关闭。
coding 开关也是「驾驶」总闸：关闭后，从下一回合起不再注册终端写入工具，只保留被动通知卡片与 tab 角标。自动回合使用你当前选择的模型，并经过同一条脱敏管线。
等待确认时，对话里会出现通知卡片；带选项的确认会在输入框上方形成决策条。你可以输入菜单序号或直接点选项，Kaya 写回前会复验 tab、前台 Agent、菜单和序号，决策始终由你作出。
运行中 Agent 状态栏#
通过 Agent 列表查看谁正在运行、谁在等待你的确认，以及谁已结束当前工作。点开对应卡片，结合终端输出查看结果与下一步。Agent 空闲不等于任务已经验收，任务完成结论见 跨 Agent ToDoList。
coding 模式下，对话面板左缘的可开合侧栏显示：
实例编号、当前状态、所在 tab、工作目录与活动摘要。
当前模型、思考档位、权限模式与 context 用量（各家支持程度不同）；Claude Code 还会补充目录、worktree 和分支。
每个窗格独立的项目标签，用于区分多项目并行。
点卡片会切到对应 tab、绑定当前对话并聚焦输入框，同时让 AI 读屏汇报一次最新进展。等待决策的卡片可直接点选项作答。侧栏可拖宽，窄窗口变抽屉，终端满屏时仍可使用。
运行中实例配置#
本地 Agent 可以按当前实例调整运行时配置。保存后先进入待生效队列，等该实例空闲并经身份复核后，通过 Agent 原生控件生效，无需重启或修改全局默认配置。模型、思考强度和 Permission 分字段执行并读回核验；实例已更换、仍在忙碌、等待决策或无法确认生效时不会写入。远程 Agent 只读。
当前开放范围以生效证据为准：Claude Code 支持模型 / 思考强度 / Permission；Kimi Code 支持模型 / 思考强度，Permission 暂不支持；OpenCode 支持思考强度 / Permission，模型暂不支持；Codex 的三项运行时字段目前均不开放。未接入模型网关的 Agent 只禁用模型字段，不妨碍其它已支持字段。
Coding Agent 工作台#
Coding + chat-focused 视图是三栏工作台：左侧为运行中 Agent，中间 Chat 是主交互入口，右侧只列等待决策与未决授权。常规状态变化只更新本地卡片，不自动发起额外对话回合。切换视图或关闭 Coding 模式时 Chat 不会卸载，输入草稿与待发图片保留。
安装、更新与卸载#
应用菜单 → Agent 会打开设置并直落 编程 Agent 标签页。安装、更新和配置也可以在对话里让 Kaya 完成，两条路径使用同一套引擎。
后台安装 / 更新依次尝试 npm > brew > 官方脚本，失败自动降级，全部失败才报错并列出原因。
npm 网络失败先经 npmmirror 重试一次；每种方式单次整体超时 10 分钟，卡片保留最后 50 行输出。
同一时刻只跑一个安装 / 更新 / 卸载任务；不支持更新的安装方式会禁用按钮并说明原因。
npm / brew 安装支持卸载，带归属校验且保留配置与历史；script 安装按官方文档手动卸载。失败时可复制「在终端安装 / 卸载」的命令手动兜底。
自定义命令名支持逗号分隔；官方二进制的进程别名由内置规则识别。
模型接入与模型库#
模型只在 设置 → 模型 维护。Agent 详情页的「模型网关」卡负责「经网关接入」和默认模型选择：
Claude Code 使用 Anthropic；Kimi Code / OpenCode 使用 Chat 兼容；Codex 默认绑定要求 Responses 或「两者」，接入后也可使用 Responses→Chat 适配模型。
当前托管配置使用本机回环地址、占位 token 与
kaya/<别名>；历史 Agent 配置、接管快照及迁移备份可能保留旧端点与凭据，需要单独检查与清理。模型选择器按供应商分组展示兼容模型，可切换「只显示绑定模型」。
修改供应商与模型后自动同步到已接入 Agent；未接入的 Agent 不受影响。
Codex 默认使用独立 profile；显式开启全局接管才影响裸跑 Codex 与 ChatGPT 桌面版，开启前二次确认。
接管前逐键快照，撤除时合并恢复；配置被外部修改会提示漂移，不会静默覆盖。
配置优化#
在 Agent 详情页的「配置优化」卡点 优化配置。分析只读，AI 建议与 Kaya 内置推荐合并成一张清单：
每条 AI 建议带官方文档、模型元数据或内置键的出处，并经 fail-closed 校验器审核。
建议分为可勾选、需手动处理、被安全闸拦下三组，不会静默丢弃。
勾选后一次性授权写入，带
.bak备份并逐键读回校验；不匹配自动回滚。内置推荐与 AI 项各自执行、各自报错，一路失败不影响另一路。
写入成功不等于语义生效；支持状态栏的键会在 Agent 重启后做后验确认，超时标为未确认，不自动回滚。
撤销前核对文件哈希；如果你之后又编辑过，会保留修改并拒绝覆盖。
模型名、端点、密钥和模型默认思考档位只能由模型库维护，不能借配置优化绕过。
授权模型与 IM 边界#
向某个 tab 写入需要逐 tab 授权。授权绑定当前进程，进程退出或 tab 关闭即失效；点 tab 上的 🤖 角标可随时撤销。普通 shell 提示符永远不接受 AI 输入。
IM 里不开放安装、更新与管理中心状态查询；配置读 / 改（同样有授权卡）和运行中 Agent 的只读状态查询仍可用。终端读取、任务清单与记忆工具的边界见 IM 渠道。