工具
挂载的工具来自已发布的 Harness 插件和会话的 Agent preset;omdsh 增加的是终端呈现层,而不是第二套工具注册表。/tools 精确列出当前会话暴露的内容,列表随你用 /agent 选择的 preset 变化。对可写工具而言,Access 仍然决定它能够触及的范围。
Shell
| 工具 | 行为 |
|---|---|
bash / pwsh | 在宿主对应的受限 shell 中执行一次性命令。调用带有 120 秒超时;模型可以按调用提高限制,或改为后台运行。 |
terminal_open、terminal_send、terminal_read、terminal_signal、terminal_close、terminal_list | 持久终端会话,跨调用保留 cwd、环境与交互式子进程。 |
文件与搜索
read、write、edit 与 str_replace_editor 处理文件内容,grep 与 glob 搜索工作区。可写工具遵守会话的 Access preset,沙箱之外的写操作返回权限与 Access中描述的共享拒绝。超过上下文预算的结果会溢写到私有文件,转录中只保留有界预览;原始内容仍可用 read 或 grep 读取。
Web
web_fetch 抓取公开网页。web_search 通过与对话路由相同的凭据走 DeepSeek 托管搜索;一次搜索是一次完整的辅助模型请求,默认每次请求最多使用 5 次服务端工具调用,provider 的 endpoint、model 与 token 上限可在 web-search-deepseek 设置段中调整。不需要搜索的部署在自己 overlay 的 tool-web 行上关闭 search。
代码智能
只读的 lsp 工具为已配置的语言服务器提供定义、引用、实现与悬停查询。在 lsp.json 注册服务器之前不会出现 lsp 工具;见语言服务器。
任务与会话
todo_write 跟踪实现项;当检查无法决定属于用户的取舍时,ask_user_question 会来问你;present 记录已完成的交付物,使它们在回合结束后仍可被找到;skill 按需加载匹配的 SKILL.md。
五个只读工具让 agent 能取到它自己早先会话里做过的工作:session_search 与 session_event_search 负责查找,session_trace 与 session_event_trace 追溯谱系与关联,session_event_read 返回精确的事件数据。没有它们,一个曾经解决过某问题的模型只能被重新告知一遍,因为 /sessions 与 /resume 是你才能触及的能力,而不是 agent 的。
它们按工作区授权:跨会话读取只在目标会话的工作目录与调用方完全一致时才被授权,而没有工作目录的会话只能检查自己。在 home overlay 里写 disabled: true 关掉这一行,即可移除全部五个工具及其引导语。
运行时检查
cordis preset 在原生目录之外增加只读的运行时检查:cordis_inspect_list 发现 provider,cordis_inspect_query 读取精确的 Service、Event 与 Tool API。改变运行时意味着编辑组合文件,而不是调用工具。
委派
subagent、subagent_fork 与 subagent_isolated 把工作委派给子代理,workflow_run 用脚本把工作扇出到多个子代理。ralph 用一茬茬新 agent 迭代同一个目标,但默认关闭,与上游 base bundle 一致;home overlay 在其行上写 disabled: false 即可恢复。code preset 会 deny workflow_run,因此 PTC 会话只通过 run_code 编写编排。见子智能体与委派。
相关
- 命令 ——
/tools及其余命令目录 - 权限与 Access —— 沙箱实际限制的范围
- Skills 与 MCP —— 用 Skills 与 MCP 工具扩展目录