工具能力
Kaya 通过一组受限的独立工具让 AI 与你的系统交互。工具调用经过输入保护、命令策略、安全检查、隔离执行和输出脱敏；具体可用工具会随 coding 模式、渠道、授权和功能开关变化。
主要能力#
run_shell：在独立子进程里执行白名单内的查询命令。
list_dir / probe_env：查看目录元数据、当前系统、磁盘与进程等信息。
terminal_read：读取终端输出和运行中 Agent 的状态，结果经过脱敏。
terminal_write：向受支持的编程 Agent 写入输入；只在 coding 模式开启且该 tab 已授权时可用。
task_list：查看任务清单，并在你要求时受控创建任务。
跨 Agent ToDoList：创建、派发和验收 Agent 间交接任务。
定时任务：创建、启停或删除与设置页相同的定时任务。
agent_config / agent_manage / agent_config_analyze：读取或经授权修改 Agent 配置，管理安装更新，分析配置优化建议。
记忆工具：检索已生效的记忆；「记住」按证据自动裁决，合格内容直接生效，归档或拒收会如实说明。归档、被取代或已丢弃的条目不进入默认检索。
tavily_search / tavily_extract（可选）：联网搜索与网页抓取，需配置 Tavily API Key。
读取 ~/.kaya/ 下的文件正文通过 run_shell 里的受控读取命令完成，详见 让 AI 读取文件。
默认不开放的操作#
修改或删除你电脑上的已有文件。
安装系统级软件或修改系统配置、环境变量。
读取
~/.kaya/之外的文件正文。在你的 PTY 里运行交互式程序。
未经过 coding 模式总闸和逐 tab 授权就向终端写入。
唯一写入例外是把命令输出重定向到 ~/.kaya/ 下带安全扩展名的文件；Agent 配置修改走独立的授权卡体系，不等同于放开文件写入。
命令策略与隔离执行#
命令在白名单之外默认拒绝。破坏性、交互式和系统修改类命令会被单独识别，UI 显示拒绝原因，AI 可以换用等价的安全方式。
AI 触发的命令由独立子进程执行，不经过你的 PTY，不影响你正在进行的终端工作。默认 8 秒超时，输出上限 100KB，超出会截断并标记。
任务清单（Task）#
任务清单记的是你的长期待办，与跨 Agent ToDoList 是两套独立数据：
顶栏待办开关打开任务面板，可以查看、勾选和管理任务。
「添加任务 …」「修改任务 …为 …」「删除任务 …」「清空任务清单」由客户端本地识别执行，不经过 LLM。
「提炼任务」让 AI 草拟任务，经你确认后入清单。
暂时不做的任务可以归档到面板底部，随时恢复；归档任务不进入 AI 可见的快照。
AI 可以读取清单，并在你要求时受控创建任务：标题经客户端校验，同名未完成任务自动跳过。
AI 不能替你勾选完成、删除或归档。
渠道差异#
IM 不开放定时任务管理、跨 Agent 任务队列和 AI 创建任务；记忆检索与「记住」按各自边界开放。跨机对话只开放圈定范围内的只读状态工具与经授权的指令转达。
**IM 的文件读取有额外边界：**即使文件在 ~/.kaya/ 中，也不能通过 IM 的命令读取记忆、审计、会话、网关隐私明细、凭据配置等敏感内部存储；记忆内容只能经记忆工具脱敏后返回。云端上传状态及其临时文件不可读，用量事件文件仍可按原边界读取。这是 IM 渠道回合的专门限制，不能把它套到浏览器远程或跨机对话：浏览器远程复用桌面上下文，跨机对话本就不开放 shell 读取工具。