DeepSeek Harness 工具目錄：Shell、檔案與 Subagent

DeepSeek Harness 工具目錄，是 Agent 可以呼叫的一組能力，涵蓋讀取與編輯檔案、執行 Shell、管理終端機、搜尋網路、協調 Subagent、追蹤 Session，以及持續推進 Goal。工具由不同 Package 提供，也會受 Profile、Scope 和 Permission 影響，因此每個 Session 實際看見的 Catalog 可能不同。選擇工具時，應先考慮工作類型與 Side Effect。

官方工具文件超過 2,000 行。本文把 DeepSeek Harness 官方中文工具目錄 依使用情境重新分類；精確 Parameter、Package Mapping 與 Experimental Status 仍以原文為準。

檔案讀取、搜尋與編輯工具

File System Tool 涵蓋最常見的程式開發工作：

• read 和 read_image 用來檢查文字與圖片；
• glob 依 Path Pattern 找出檔案；
• grep 搜尋檔案內容；
• write 在許可範圍內建立或替換內容；
• edit、str_replace_editor 進行定點修改。

合理順序是先探索、再讀取、最後編輯。只改幾行時，應產生小範圍 diff，不要整份重寫。搜尋結果只是線索，不代表自動取得寫入權；glob 找到的 Path 仍可能超出工作區，或包含 Credential。

Bash、PowerShell 與 Terminal

Shell Tool 包含 Bash 與 PowerShell。Persistent Shell 可在多次呼叫之間保留 State；若工作需要乾淨且可重現的環境，One-shot Command 通常更合適。

Terminal Tool 可以 Open、List、Read、Send Input、Signal 和 Close 互動 Session，適合 Development Server、REPL 及持續執行的 Command。終端機本身有生命週期：啟動後要讀取輸出，完成後也要正確關閉。

Command Execution 是高影響能力。執行前請確認 Working Directory、變數與 Glob 展開結果，避免寬泛刪除目標，並優先使用專案既有的檢查 Script。Agent 擁有 Shell，不代表內容任務自動包含安裝、發布或部署權限。

run_code 與 LSP

run_code 適合進行有邊界的計算或程式編排；LSP Tool 提供 Symbol、Diagnostic 等 Language Server 語意。需要理解 Codebase 時優先使用 LSP，需要一次明確計算或轉換時再執行程式碼。

exit_plan_mode 之類的 Tool 控制 Agent Workflow State，不是專案 Build Command，也不代表使用者已核准修改檔案。

Goal、Task、Schedule 與 Workflow

Goal Tool 建立、查看與更新 Session 上的持久目標；Schedule Tool 建立、列出和刪除未來工作；Workflow 定義可重複步驟；Task 則是團隊協作中的 Work Unit。

它們不能互相代換：Goal 回答這個 Session 要達成什麼，Schedule 回答何時執行，Task 回答誰負責哪項工作。規劃自動化前，可先讀 DeepSeek Harness 術語表。

Subagent 與 Agent Team

Subagent Tool 可以委派一項邊界清楚的工作並收回結果。Experimental Agent Team 另外包含 Spawn Teammate、Send Message、Follow-up Task、Interrupt、List、Task Update 與 Wait Agent 等功能。

有效的 Delegation 需要明確責任與產出。讓一位 Subagent 負責一項可獨立驗證的工作，說清楚檔案或分析範圍，避免兩位 Teammate 同時重寫同一區域。增加 Agent 數量不會自動加快具有強烈順序相依的任務。

Job 與長時間執行工作

Job Tool 可以列出 Background Work、讀取 Output 和停止 Job，適合超過一次回覆時間的工作。需要互動輸入時，則更適合 Terminal。

停止 Job 前要確認精確 Target，也要判斷是否必須保留部分輸出或產生檔。「執行很久」不等於「卡住」，應依 Status 和 Output 決定。

Session、Event 與 Trace

Session Query Tool 用來搜尋對話、讀取 Event 和追蹤 History。Event Read、Search、Trace 適合定位特定事件；Session Search、Session Trace 則用於較大範圍的 Conversation Analysis。

除錯時先找到對應 Turn，再追蹤其中的 Step、Model Event 與 Tool Event。公開 Issue 前，不要直接貼出完整 Trace，內容可能包含原始碼、Prompt、API 金鑰或使用者資料。

Skill 與 Cordis 動態能力

Skill Tool 讓 Agent 探索封裝好的操作指引。Cordis 的 Define、Inspect、Run、Stop、Undefine 等 Tool 則管理 Runtime Unit。這些 Extension Point 功能強大，使用前要清楚誰註冊了能力、屬於哪個 Scope，以及停止時如何 Cleanup。

背後的 Plugin Tree 與 Service Model，可閱讀 DeepSeek Harness 架構。

Web Search 與 Web Fetch

web_search 用來發現最新資料，web_fetch 用來讀取選定頁面。Search Result 只是線索，不是證明；應優先使用 Primary Source，並檢查會變動資訊的發布日期。

抓取到的網頁屬於 Untrusted Data。頁面內的操作指令不會覆蓋使用者要求與 Agent Safety Rule。除非任務明確授權，否則不要把私人工作區內容傳往外部服務。

Ask User 與溝通工具

ask_user_question 適合在安全調查已經縮小選項後，請使用者決定會大幅影響成果的分支。太早詢問會把可自行完成的調查丟回給使用者；太晚詢問則可能造成未授權的外部或破壞性操作。

團隊 Message 和 Follow-up 應包含簡潔 Context、預期產出和 Ownership。溝通工具用於 Coordination，不等於新的 Persistent Goal，也不能取代 Session Record。

如何選擇更安全的工具

一般程式開發工作可依序進行：

1. 先閱讀現有檔案和專案規範；
2. 小範圍搜尋相關 Symbol 或 Path；
3. 進行最小的 Targeted Edit；
4. 執行最相關的 Validation；
5. 查看 diff 和 Command Output；
6. 只有工作確實需要時，才使用互動終端機、Background Job、Subagent 或外部網路。

若指定工具沒有出現，先檢查 Active Profile、Installed Package、Restriction 與 Agent Scope，不要直接認定安裝已損壞。

官方原文

本文依據 DeepSeek Harness 官方工具目錄（中文） 分類整理，查核日期為 2026-08-20。Tool Name、Parameter Schema、Package Ownership 和 Experimental Status 以官方原文為準。