内置工具参考
工具由运行时注册，是否进入当前模型请求取决于工具组、Exposure、Session 选择与父任务范围。Dashboard → Tools 可以查看当前库存的来源、定义和预算；下面的清单不能替代实例的实际目录。
文件、Shell 与受管进程
| 名称 | Toolset | 操作 |
|---|---|---|
read | file | 读取文本范围或支持的图片 |
ls、find、grep | file | 列目录、按 Glob 找路径、检索内容 |
write、edit | file | 覆盖写入或精确替换 |
bash | terminal | 在工具工作目录运行 Shell |
process | terminal | 操作当前对话拥有的受管后台进程 |
这些操作直接执行，不附加源码语法检查或自动回滚。文件工具遵循普通路径与 Symlink 语义；Workspace 不是操作系统沙箱。apply_patch 不再是额外内置工具，修改使用 write／edit。行为细节见文件与终端。
图片怎样送给模型
read 支持 JPEG、PNG、GIF、WebP、BMP，BMP 转为 PNG；缩放使用内嵌 Photon 编解码，不依赖外部图片处理命令。默认上限是 2000 × 2000 像素、base64 后 4.5 MiB、JPEG 质量 80。
模型配置 providers[].models[].input_limits.images.resize 可设置正整数 maxWidth、maxHeight、maxBytes、jpegQuality，质量最多 100，maxBytes 计 base64 后字节。未配置就使用默认值，不补写配置。
read 按当前所选模型限制读取图片，返回前可能已缩放。其他工具结果送模型前也按当前限制处理；虚拟模型优先采用目录中最近一次成功回复实际使用的模型，无法找到时回到所选模型，不取未来回复的模型。
模型图片可被再次缩放，而 Codemode 仍拿工具原本返回的结构化值；它不保证取得原始磁盘图片。普通工具图片处理失败保留原图片；read 无法满足限制时可能返回省略提示。
搜索辅助程序
本地 grep 使用 rg，find 使用 fd 或 fdfind。先检查所选 Profile 的 bin/，存在就直接使用；再通过 PATH 的 --version 探测，命令成功启动即视为存在，即使退出码非零。fd 优先于 fdfind。
缺失时可从工具官方 GitHub release 下载平台包到 <PROFILE_HOME>/bin/。版本通常由 latest 重定向确定，Intel macOS 的 fd 固定 10.3.0。获取和解包由 Go 完成，rg/fd 本身仍是独立程序，不需要 Node.js。
Anyy 进程环境的 ANYY_OFFLINE=1、true 或 yes 禁止获取，单词不区分大小写；已安装辅助程序仍可运行。Android 也跳过自动获取。版本查询总预算 10 秒、下载 120 秒，各最多立即请求三次，开始传响应体后不重试。其他执行后端使用各自依赖解析。
grep 先解析／获取程序再检查搜索路径，所以不存在的路径也可能先触发获取。依赖不可用时返回 ripgrep (rg) is not available and could not be downloaded 或 fd is not available and could not be downloaded；离线也使用这些文字，不代表一定发过网络请求。
个人信息、任务与消息
| 名称 | Toolset | 用途 |
|---|---|---|
session_search | sessions | 搜索当前范围内过去的 Profile 会话 |
tool_result_read | core | 按逻辑引用分段读取完整可检查的工具证据 |
memory | memory | 增加、替换、删除 USER.md／MEMORY.md 的长期事实 |
task_create、task_list、task_update、task_complete | tasks | 管理持久个人任务 |
automation_list、automation_history | automation | 查看计划和执行历史 |
automation_create、automation_update、automation_delete、automation_run | automation | 修改或触发定时工作 |
messaging_status、notify_user、send_message、message_receipt | messaging | 查看投递路径、通知、发送和查回执 |
Memory 不适合临时进度、整份参考资料或 Secrets。消息与附件投递取决于渠道账号、对话范围、访问策略和适配器能力。
文件交付、媒体和网页
| 名称 | 可用条件 |
|---|---|
artifact_list、artifact_inspect、artifact_pin、artifact_export | Artifact 服务已配置，属于 artifact 组 |
image_generate | 图片生成路由已配置，属于 media_generation |
text_to_speech | TTS 路由已配置，属于 tts |
web_search、web_fetch、web_extract | web 组及所需后端 |
artifact_export 交付 Workspace 相对路径的普通文件作为临时附件，不移动或删除源文件。文件持久性与重开条件见 Artifacts。网页工具查询公开内容；普通个人问题仍可直接由模型回答。
Skill 与子任务
| 名称 | Toolset | 用途 |
|---|---|---|
skill_manage | skills | 当前 Profile 托管包写入、版本和回滚 |
delegate_task | subagents | 本轮等待一个或一批子任务 |
background_job | subagents | 创建独立后台工作 |
subagent_list、subagent_history、subagent_cancel | subagents | 观察或停止子工作 |
Skill 入口通过目录和 read／bash 读取，包括 Codemode 可达的 reader；没有 reader 就不提供模型目录。没有独立 skills_list／skill_view 模型注册。skill_manage 安装只接受本地 ZIP，托管写入提供版本，不授予新工具，也不替代 reader。自动复盘遵守父对话的选择和排除项。详见 Skills及任务委派。
脚本和工具发现
codemode、tool_search 注册时都不活动，可通过工具选择或适用 MCP 自动激活规则启用。
- Codemode 在当前 Session 句柄上运行 JavaScript，提供分支 store、发现和模型 API。
- 工具搜索 找到尚未活动的 deferred／Codemode 工具，为下一次模型请求加入声明。
codemode.mode 选择 on／only，不负责激活；only 改变声明呈现，保留可调用工具和 canonical 记录，不是 Role。只有所选 native model 声明 compat.supportsOpenAIGrammarTools 且 Provider 支持该请求路径时才用原始 grammar 输入；其他模型仍用 JSON code，两者保存相同参数。
MCP 的名称、资源和协议结果
远端工具有原始名和 Anyy 暴露名。运行时按 Server 添加 namespace、规范化字符并处理冲突；脚本应使用发现结果中的标识符，CLI mcp call 使用 SERVER_ID.TOOL_NAME 的原始远端名。不要手工猜模型侧名称。
MCP 不建立 mcp-* 个人工具组，而使用 exposure 与有序 toolExposure。已启用、报告资源能力且基础 Exposure 非 hidden 的 Server 可以提供共享工具：
| 工具 | 输入 |
|---|---|
list_mcp_resources | 可选 server、cursor |
list_mcp_resource_templates | 可选 server、cursor |
read_mcp_resource | 必需 server、uri |
共同暴露方式按 direct、codemode、deferred 优先，能力撤回后隐藏。Prompt 仍是 MCP 客户端协议 API，不生成模型工具；旧逐 Server 资源／Prompt 工具以及 tools.resources／tools.prompts 开关不再接受。远端工具含写入在内直接执行，恢复边界见 MCP 集成。
工具结果如何读取
一次结果至少要区分：给模型的文本、页面显示、供程序使用的结构化返回以及实际保留的证据。输出 Schema 描述程序值，不表示整份值都会进入模型上下文。bash 对象要看 exit_code，产品结果要看状态，MCP 要看 isError；Promise resolve 不自动等于操作成功。
已知凭据在投影与保存前保护。模型／显示预算、工具自身截断和整个会话的上下文预算分别生效。inspectable 表示完整受保护证据可检查；projected 只保留有界投影，artifact 关联文件，不能把它们的预览当作完整结果。
有工具给出的 details_ref／raw_ref 时，可调用：
{"ref":"tr_example","offset":0,"limit":12000}
tool_result_read 不接受主机路径。offset 从零起按字符计数，limit 默认 12000、最多 48000；最终 JSON 封装预算可能继续缩小内容并标记 envelope_clamped:true。用 next_offset 继续，直到 eof；返回还给出 total_chars、source_tool、content_type、storage_kind。
原始结果 token 仅在其当前运行内解析；显式 canonical 持久引用可读同一 Session 较早运行的 inspectable 证据。跨会话返回 out_of_scope，无效／歧义引用为 invalid_ref，缺失为 not_found，完整正文未保留或不可用为 not_available。读取工具不会从摘要重建正文。
外部服务和可用性
没有通用 email_*／calendar_* 内置封装；邮件渠道本身保留。外部邮件、日历等工具由另行配置的服务提供，例如 MCP。
工具可见仍可能因凭据、后端、Scope 或 OS 权限而失败。先查看当前目录和实际结果，再查工具组和具体能力页。