工具参考
精选查阅 DeepSeek Harness 暴露给模型的工具，按用途与典型场景分组
本页精选了 agent（智能体）向模型暴露、用户与插件开发者最常需要了解的工具。完整且权威的来源是生成式的工具目录，它会在真实上下文中启动每个工具插件，记录模型收到的确切 name、description 与 JSON Schema。
本页只用平实语言说明用途，刻意不复制签名与 schema。注册名称可以是加载时配置（例如 @deepseek-ai/dsh-tool-subagent 的 toolName），因此部署可能以不同名称或额外名称暴露某个包；存在随产品发布的别名时（subagent_fork 是 subagent 绑定到 fork 后端的形态），本页会一并列出。
某个会话实际能看到哪些工具取决于它的组合：agent preset 会贡献自己的工具行，因此极简 preset 暴露的工具远比默认 web 组合少。
工具速查
| 工具 | 用途 | 典型场景 |
|---|---|---|
skill | 按需加载某个 skill（技能）的完整指令 | 动手前读取可复用指令包 |
create_goal · get_goal · update_goal | 创建、读取、推进同一会话的完成目标 | 让会话围绕长期目标多轮推进 |
todo_write | 维护结构化的任务清单 | 跟踪多步工作的进度 |
read | 读取 UTF-8 文本文件并带行号 | 查看源码或配置文件 |
write | 新建文件或完全替换其内容 | 写入新文件 |
edit | 替换现有文件中的字面文本 | 做精确修改 |
read_image | 读取 PNG/JPEG/WebP/GIF 图像 | 让模型查看图像 |
glob · grep | 按路径模式找文件、搜索内容 | 快速定位文件与符号 |
bash | 在新进程中执行 shell 命令 | 运行命令、测试与 git 操作 |
web_search | 搜索网页获取当前信息 | 查明事实并收集来源 URL |
web_fetch | 抓取某个网页的内容 | 阅读搜索出来的页面 |
subagent | 把自包含工作委派给可续期子 agent | 后台并行扇出独立任务 |
subagent_fork | 委派给继承当前对话的子 agent | 继续上下文相关的子任务 |
report | 把自包含结果回报给父 agent | 子 agent 交回结论 |
send_message · list_agents · interrupt_agent | 管理可续期的后台 subagent | 给子 agent 追加消息、列出或中断 |
workflow | 运行编排大规模 subagent 的脚本 | 大批量独立工作扇出 |
ralph | 面向一个不可变目标的前台全新 agent 循环 | 明确的 Ralph / fresh-agent 迭代 |
ask_user_question | 向用户提一个简洁问题 | 确认选择或索要缺失信息 |
job_output · job_kill · job_list | 读取、终止、列出后台任务 | 管理后台 bash 命令与 subagent |
exit_plan_mode | 提交计划供审阅并退出 plan mode | 退出规划、获批后继续 |
cordis_define · cordis_run · cordis_stop · cordis_undefine | 定义、运行、停止、删除动态 Cordis 插件 | 临时扩展当前运行时的能力 |
cordis_inspect_list · cordis_inspect_query · cordis_inspect_self | 只读检查服务、事件、插件与诊断 | 写插件代码前确认能力 |
由启动后的运行时生成
该目录不是静态源码扫描：它会启动每个工具插件并读取 ctx.tools.schemas()，因为工具 schema 无法静态确定（运行时展开的枚举、由配置决定的名称、原始 MCP schema）。请把本页的名称当作随附默认值。
各组如何配合
下面的分组是有意重叠的：report 与 job_* 工具跨委派与命令执行共用，exit_plan_mode 则位于规划与交互的交界处。
文件操作
read、write、edit、read_image、glob、grep 构成文件工具集。先读后写／编辑观测策略支撑 write 与 edit；glob 和 grep 通过 subprocess seam spawn 随包提供的 ripgrep 二进制文件，因此无需宿主机 rg，也不经过 shell 层。
命令执行
bash 每次调用都在新进程中运行。传入 run_in_background: true 会把运行注册到 job 运行时，由 job_output/job_kill/job_list 读取、停止、列出——这 3 个工具同样管理后台 subagent 与 PTY 发送。
委派与编排
subagent 与 subagent_fork 把自包含工作委派给子级；report、send_message、list_agents、interrupt_agent 管理这些子级；workflow 与 ralph 一次编排多个 agent。见 Subagent 与工作流。
目标、清单与计划
create_goal/get_goal/update_goal 驱动持久化的同会话目标，todo_write 跟踪其步骤，exit_plan_mode 把计划交给用户审批。见技能与目标。
插件开发
cordis_* 工具集需要选择启用：运行中的动态插件会触及真实运行时，因此默认树不随附任何一项，直到组合挂载 @deepseek-ai/dsh-cordis-host-runner。见 Cordis 入门。
交互、网络与规划
ask_user_question 会暂停工具调用，直到有人通过 UI 作答；web_search 与 web_fetch 把提供方选择置于 web seam 之后，换后端时 schema 保持稳定；exit_plan_mode 通过用户交互 seam 提交计划，并在 plan mode 之外拒绝调用。
另有可选启用的工具
若干随附工具不在默认面板中，按需加载——它们各自需要一个提供方、一个平台（Windows 或 PTY 后端）或一次刻意的组合选择。它们都收录在工具目录中，但不在本精选范围内：
- 用于持久 PTY 会话的 6 个
terminal_*工具（terminal_open、terminal_send、terminal_read、terminal_signal、terminal_list、terminal_close）； - 用于语言服务器查询的
lsp； - 用于会话日志检查的 5 个只读工具
session_event_read、session_event_search、session_event_trace、session_search、session_trace； - 提醒工具
schedule_create、schedule_delete、schedule_list； - 代码模式传输
run_code、独立的str_replace_editor，以及 Windows 的pwsh命令工具。
上方速查表中的每一项都属于默认随附面板；这里的可选工具需要显式加入组合。