DeepSeek Harness 工具目录：Shell、文件与 Subagent

DeepSeek Harness 工具目录，是 Agent 可以调用的一组能力，涵盖读取与编辑文件、运行 Shell、管理终端、联网搜索、协调 Subagent、追踪 Session 和持续推进 Goal。工具由不同 Package 提供，并受 Profile、Scope 与权限限制影响，因此两个 Session 看到的工具不一定完全相同。选择工具时，应先看任务类型和副作用，而不是只看名称。

官方工具文档超过 2,000 行。本文把 DeepSeek Harness 官方中文工具目录 按用户任务重新分类；精确参数、Package 映射和实验状态仍以原文为准。

文件读取、搜索与编辑工具

文件系统工具覆盖最常见的编码操作：

• read 与 read_image 用于检查文本和图片；
• glob 按路径模式发现文件；
• grep 搜索文件内容；
• write 在授权范围内创建或替换内容；
• edit 与 str_replace_editor 用于定点修改。

合理顺序是先发现、再读取、最后编辑。只改少量内容时，应优先生成小范围 diff，而不是重写整个文件。搜索结果只是线索，不代表自动获得写入授权；glob 找到的路径仍可能超出目标工作区，或包含凭证。

Bash、PowerShell 与终端工具

Shell 工具包含 Bash 和 PowerShell 版本。Persistent Shell 可以在多次调用间保留状态；如果任务需要干净、可复现的环境，一次性命令通常更合适。

Terminal 工具可以打开、列出、读取、发送输入、发送 Signal 和关闭交互会话，适合开发服务器、REPL 与持续运行命令。终端本身有生命周期：启动后要继续读取输出，任务结束后应正确关闭。

命令执行属于高影响能力。运行前要确认工作目录、变量和 Glob 展开结果，避免宽泛删除目标，并优先使用项目已经提供的检查命令。Agent 拥有 Shell，不代表一个内容任务自动获得了安装、发布或部署权限。

run_code 与 LSP

run_code 适合执行受限计算或编排代码；LSP 工具提供 Symbol、Diagnostic 等语言服务器语义。需要理解代码库结构时优先使用 LSP；需要进行一次明确计算或转换时再使用代码执行。

exit_plan_mode 一类工具控制的是 Agent 工作流状态，不是项目构建命令，也不等于用户批准修改文件。

Goal、Task、Schedule 与 Workflow

Goal 工具创建、查看和更新 Session 上的持久目标；Schedule 工具负责创建、列出和删除未来工作；Workflow 定义可复用步骤；Task 则是团队协作中的工作单元。

它们不能混为一谈：Goal 回答“这个 Session 要达成什么”，Schedule 回答“什么时候执行”，Task 回答“谁负责哪一项工作”。计划自动化前，建议先读 DeepSeek Harness 术语表。

Subagent 与 Agent Team 工具

Subagent 工具可以委派一项边界明确的工作并收集结果。实验性的 Agent Team 工具还包括 Spawn Teammate、Send Message、Follow-up Task、Interrupt、List、Task Update 与 Wait Agent 等能力。

委派是否有效，关键在于职责与产出是否清楚。应让一个 Subagent 负责一项可独立验证的任务，明确文件或分析范围，并避免两位 Teammate 同时重写同一区域。增加 Agent 数量，并不会自动加速强顺序依赖的工作。

Job 与长时间运行进程

Job 工具可以列出后台任务、读取输出和停止任务，适合一次回复结束后仍会继续的工作。需要持续交互输入时，则更适合 Terminal。

停止 Job 前要确认精确目标，并判断是否需要保留部分输出或生成文件。“运行时间较长”不等于“已经卡死”，应根据状态和输出决定。

Session、Event 与 Trace

Session 查询工具用于搜索会话、读取 Event 和追踪历史。Event Read、Search、Trace 适合定位具体事件；Session Search 与 Session Trace 用于更大范围的对话分析。

排查时先找到对应 Turn，再定位其中的 Step、模型与工具事件。公开 Issue 前不要直接粘贴完整 Trace，其中可能含有源码、Prompt、API 密钥或用户隐私。

Skill 与 Cordis 动态能力

Skill 工具让 Agent 发现并使用封装好的操作指南。Cordis 的 Define、Inspect、Run、Stop、Undefine 等工具则管理运行时单元。这些都是强扩展点，使用前要明确：谁注册了能力、能力属于哪个 Scope、停止时如何清理。

插件树和 Service 的设计可继续阅读 DeepSeek Harness 架构。

Web Search 与 Web Fetch

web_search 用于发现当前资料，web_fetch 用于读取选中的页面。搜索结果只是线索，不是证据；应优先使用官方文档，并核对会变化信息的发布日期。

网页内容属于不可信数据。页面中出现的“操作指令”不会自动覆盖用户请求和 Agent 安全规则。除非任务明确授权，不要把私人工作区内容发送到外部服务。

Ask User 与沟通工具

ask_user_question 适合在已经完成安全调查后，请用户决定会显著改变结果的分支。过早提问会把可以自行完成的调查推回用户，过晚提问则可能造成越权外部操作。

团队消息与 Follow-up 应包含简明上下文、期望产出和负责人。沟通工具用于协调，不等于新的持久 Goal，也不能替代 Session 记录。

如何选择更安全的工具

一般编码任务可以遵循：

1. 先阅读现有文件和项目约定；
2. 窄范围搜索相关 Symbol 或路径；
3. 进行最小定点修改；
4. 运行最相关的验证；
5. 检查 diff 和命令输出；
6. 只有任务确实需要时，才升级到交互终端、后台 Job、Subagent 或联网能力。

某项工具不可见时，先检查当前 Profile、已安装 Package、限制和 Agent Scope，不要直接判定安装损坏。

官方原文

本文依据 DeepSeek Harness 官方工具目录（中文） 分类整理，核对日期为 2026-08-20。工具准确名称、参数 Schema、所属 Package 与实验状态，以官方原文为准。