DeepSeek Harness 術語表：Scope、Goal 與 Turn

DeepSeek Harness 對 Scope、Goal、Turn、Step 等字詞有精確的工程定義。如果只按一般語意理解，很容易寫錯設定，也會讓 Bug Report 不夠準確。這份術語表以開發情境說明官方概念，並整理幾組最容易混淆的名詞。

標準定義取自 DeepSeek Harness 官方中文術語表。本文保留技術含義，另外補上範例與方便搜尋的解釋。

Capability Seam

Capability Seam 是一條可替換能力的邊界，包含：

1. Service Definition 描述 Contract；
2. 一個或多個 Provider 實作 Contract；
3. 一個或多個 Consumer 呼叫能力。

Shell Execution 是好理解的例子：Consumer 透過穩定 Service 提出執行需求，本機、遠端或測試 Provider 決定實際作法。Consumer 不需要直接依賴每一種 Provider。

Seam 不只是一個 TypeScript Interface，Provider Registration、Plugin Lifecycle、Selection 與 Error Handling 都包含在內。何時值得建立 Seam，可查看 DeepSeek Harness 架構指南。

Agent Scope

Agent Scope 是替單一 Agent 建立的 Cordis Scoped Context，agent.ctx 就是這個 Context，用來保存 Agent Local Registration 與行為。

Scope Key 採 Object Identity，不是同名字串。Scope Model 刻意維持扁平：Subagent 有自己的 Scope，不會自動繼承一棵深層 Parent Scope Tree。Parent 與 Subagent 關係屬於 Lineage Data，不等於能力自動可見。

系統會先套用 Global Tool Restriction，再合併 Scope Local Tool，讓 Agent 可以加入專屬工具，同時不會暗中取消全域限制。Setup Window 則在 Session 發布前完成 Registration，避免其他元件看到只設定一半的 Agent。

Goal

Goal 是附加在 Session 上的單一持久目標，可以處於 active、paused、blocked、complete 等 Phase。Goal Round 則提供有預算界線的自主工作週期。

Goal 不是另一段 Conversation，也不是通用 Scheduler。對話紀錄仍由 Session 保存；安排未來執行屬於 Schedule Capability。可以在 工具目錄 分別查看 Goal 與 Schedule Tool。

Goal 可以在本機 armed 或 disarmed，但這個開關屬於 Control State，不會當成新的持久 Goal Fact Replay。

Human Command

Human Command 是由 Human Adapter 處理的 Slash Command。它不是送給模型的一般 User Message，也不會自動變成 Shell Command。

這條 Boundary 能避免介面控制污染模型對話。文件說明 Command 時，應清楚標示它是在改變 Adapter、呼叫 Tool，還是加入模型可見訊息，不應讓使用者只靠 / 猜測。

Turn

Turn 是由一次輸入觸發的完整回應週期，可能包含零個或多個模型 Step。它從輸入開始，在 Agent 完成一連串模型與工具工作，或進入終止路徑後結束。

討論對話層級 Trace 與狀態時使用 Turn。一般 Follow-up 會開啟一個 Turn，但其中可能有多次模型呼叫。

Step

Step 是一次模型請求及其相關工作。模型產生 Tool Call 後，Tool Result 可能讓同一 Turn 進入下一個 Step。

統計模型請求、除錯 Prompt Assembly、分析 Provider Error 或 Tool Loop 時，應使用 Step。完整時序請參考 Agent 生命週期詳解。

Goal Round

Goal Round 是追求 Active Goal 時使用的、有界線的自主工作週期，與 Turn、Step 不同：

• Step 是一次模型 Request；
• Turn 是一次 Input-driven Response Cycle；
• Goal Round 是一段具有 Budget 的自主 Goal Work。

把三者分開，Budget 和 Telemetry 才有意義。「三個 Goal Round」不能在沒有證據時直接解讀成三次模型請求。

核心術語速查

術語	主要用途	本身是否持久化
Capability Seam	隔離可替換 Provider	定義屬於 Code 或 Config
Agent Scope	保存 Agent Local Registration	Scope 是 Runtime State
Goal	保存 Session Objective 與 Phase	是
Human Command	控制 Human Adapter	不是模型訊息
Turn	一次輸入驅動的回應週期	相關 Event 可持久化
Step	一次模型請求週期	Result 可按需持久化
Goal Round	有預算的自主目標工作	依 Goal System 紀錄而定

官方原文

本文依據 DeepSeek Harness 官方術語表（中文） 擴充編寫，查核日期為 2026-08-20。若第三方文章使用不同定義，應優先採用官方儲存庫的目前術語。