內建工具參考
工具由執行環境註冊，是否進入目前模型請求取決於工具組、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 權限而失敗。先檢視目前目錄和實際結果，再查工具組和實際能力頁。