怎樣使用這篇速查
- 用瀏覽器的頁面搜尋功能直接找術語。
- 需要準確含義時先讀專業定義。
- 仍然覺得抽象時再看生活化說明。
- 修改權限、安裝擴充功能或發布套件前，再閱讀連結中的詳細指南。
模型、Agent 與 Harness
| 概念 | 專業解釋 | 生活化說明 |
|---|---|---|
| AI 模型 | 根據輸入產生文字、程式碼或其他輸出的統計系統。模型本身不會自動取得電腦存取權。 | 生活化理解：模型像坐在桌前思考的人；桌子、工具、鑰匙和記錄由系統其他部分提供。 |
| Agent | 把模型與指令、上下文、工具和執行循環組合起來，能分多步完成目標的執行角色。 | 生活化理解：它不只回答一次，而是可以查看、操作、檢查結果，再繼續完成任務。 |
| Agent Harness | 協調模型、工具、上下文、權限、會話和互動介面的軟體環境。 | 生活化理解：它像受管理的工作台，決定有哪些工具、哪些門上鎖，以及日誌記錄什麼。 |
| Provider | 把模型接入 Harness 的服務或轉接器，並處理請求格式與認證方式。 | 生活化理解：同一個工作台可接不同供應商，但每一家都有自己的帳戶和連線規則。 |
| Tool | Agent 可以請求的具名能力，例如讀取檔案、修改文字、執行命令或搜尋資料。 | 生活化理解：Tool 是工具櫃中的一件工具；出現在清單中，不代表可以不經批准使用。 |
| Context | 目前模型請求可以看到的資訊，包括指令、選定歷史、檔案與工具結果。 | 生活化理解：它是這次判斷時攤在桌上的資料，不等於永久記住所有事情。 |
工作怎樣組織起來
| 概念 | 專業解釋 | 生活化說明 |
|---|---|---|
| Workspace | 用來指定工作目錄、組織相關任務的專案位置。選擇工作區本身不構成安全隔離邊界。 | 生活化理解：它是工單上的地址；門鎖與存取規則仍由實際執行器及權限設定決定。 |
| Session | 一條持續工作線的長期記錄，包含訊息、模型輸出、工具活動與狀態。 | 生活化理解：它是專案日誌，讓你稍後回來仍看得懂討論和操作。 |
| Turn | 一次使用者輸入觸發的完整回應週期，可能包含多個模型與工具步驟。 | 生活化理解：服務台收到一個要求，內部可能完成多個動作才給出結果。 |
| Step | Turn 內的一次模型請求，以及隨後產生的工具呼叫。 | 生活化理解：Step 是清單上的一個步驟，Turn 是整次要求的完整過程。 |
| Plugin | 可載入 Harness 的軟體單元，用來提供服務、事件、工具、介面部件或其他行為。 | 生活化理解：它像加入工作台的新機器或控制面板。 |
| Profile | 決定哪些 bundle、外掛與設定層一起啟動的具名組合。 | 生活化理解：它是為某類工作保存的一整套工作台設定。DeepSeek Harness 提供 web 與 headless 範本。 |
| Skill | 由指令和輔助資源組成的可重複使用工作方法，教 Agent 完成邊界明確的流程。 | 生活化理解：它像經過審查的操作流程卡，會指導做法，但不會偷偷增加電腦權限。 |
| Runtime | 任務實際執行時使用的軟體程序、相依版本、設定與作業環境。 | 生活化理解：食譜相同，實際廚房仍可能不同；驗證要在真正會使用的廚房進行。 |
| Diff | 以結構化方式顯示檔案或文字在兩個狀態之間有哪些差異，本身不會自動採用任何一個狀態。 | 生活化理解：它是一張標出修改行的前後對照表。閱讀 diff 不等於接受這些修改。 |
| Hook | 為某個事件設定的觸發機制，會在事件之前、之後或發生過程中執行指定動作。 | 生活化理解：它像連接固定回應的門鈴。回應可能執行程式碼，所以要檢查來源與權限。 |
| MCP | Model Context Protocol，讓 Agent 或 Harness 透過 MCP server 連接外部工具與資料的一套標準協定。 | 生活化理解：它是工作台連接另一項服務的標準介面。介面接得上，不代表服務天然可信。 |
| Cloud | 位於本機之外的遠端執行環境，擁有自己的檔案、憑證、網路、持久化和計費邊界。 | 生活化理解：它像租用另一棟樓裡的工作間。交付任務前要檢查鑰匙、儲存、費用和清理規則。 |
權限與安全
| 概念 | 專業解釋 | 生活化說明 |
|---|---|---|
| Permission | 說明某項操作可執行、應拒絕，或需要在執行時決定的規則。 | 生活化理解：它像門上的通行名單；文字提醒小心不等於真正的門禁。 |
| Approval | 特定操作繼續之前，由人或政策作出的允許決定。 | 生活化理解：工作人員在上鎖的櫃子前停下來，先問你能否拿鑰匙。 |
| Sandbox | 限制程序部分影響的技術邊界，實際涵蓋範圍取決於平台與設定。 | 生活化理解：它像有圍欄的工作區；仍要確認圍欄限制檔案、網路、程序，還是只限一部分。 |
| Credential | 向模型服務、網站、倉庫或其他受保護系統證明身分的秘密資訊。 | 生活化理解：它像鑰匙或銀行卡；應放在指定設定或秘密儲存，不要貼進聊天和專案檔案。 |
| 最小權限 | 只給目前任務所需的存取能力，並且只保留必要時間。 | 生活化理解：訪客只需要會議室鑰匙時，不要交出整棟樓的萬用鑰匙。 |
| Rollback | 變更失敗或不再需要時，把系統恢復到先前已驗證狀態的預備操作。 | 生活化理解：替換任何東西前，先保存上一個可用版本並寫清楚返回方法。 |
介面與外觀
| 概念 | 專業解釋 | 生活化說明 |
|---|---|---|
| 語義 Token | 按用途命名的設計值，例如背景或強調色，而不是直接指定固定顏色。 | 生活化理解：它像「牆面漆」或「警示燈」的用途標籤，每個 Theme 可為同一用途提供不同顏色。 |
| Theme | 一組協調的語義外觀值，通常同時涵蓋淺色與深色模式，但不改變產品結構。 | 生活化理解：它更換房間的配色和照明，但牆壁與家具位置不變。 |
| Full Skin | DSH Themes 的發布類別，在更嚴格證據規則下組合語義值、受控圖片與生成樣式。 | 生活化理解：它同時調整配色、照明與部分裝飾；這是 DSH Themes 格式，不是官方原生格式。 |
| Plugin | 改變或增加介面工作流程的擴充功能，而不只是提供外觀數值。 | 生活化理解：它新增控制面板或工作區，所以行為與權限和外觀一樣重要。 |
| Transport | 在 Web 介面與執行中的 Harness 程序之間傳遞請求、事件與狀態的連線。 | 生活化理解：它是控制室與工作台之間的運送通道；頁面能顯示不代表通道已連通。 |
套件與驗證
| 概念 | 專業解釋 | 生活化說明 |
|---|---|---|
| Package | 把程式碼、元資料、資源或設定作為整體安裝的帶版本發布單元。 | 生活化理解：它像密封商品盒；只看貨架名稱不能證明這個盒子裡有什麼。 |
| Artifact | 實際被下載、安裝、測試或發布的精確建置檔案，例如某個確定的套件封存檔。 | 生活化理解：它是送到手裡的實物盒子，不是目錄中的商品介紹。 |
| SHA-256 | 為製品全部位元組計算的密碼雜湊，可作為穩定的檔案指紋。 | 生活化理解：指紋相同表示檔案位元組相同，但不能單獨證明內容安全或授權合格。 |
| Sidecar | 與製品分開存放的機器可讀記錄，用來描述身分、相容性、雜湊或證據引用。 | 生活化理解：它像盒子附帶的檢查卡；卡片與盒子必須互相對應。 |
| Attestation | 記錄檢查項目、環境、精確輸入與結果的簽署或受控證明。 | 生活化理解：它是一份有日期和對象的檢查報告；另一版本的報告不能證明眼前項目。 |
| 認證基線 | 某個項目完成規定驗證流程時所使用的精確 Harness 版本與證據集合。 | 生活化理解：上游軟體可能較新，完成檢查的版本可能較舊；「更新」與「已認證」是兩件事。 |
仍然看不懂術語時怎麼辦
- 01
找到完整術語
複製原文中的完整寫法；如果帶有產品名稱，也要一起保留。
- 02
判斷它屬於哪一層
確認它描述的是智慧、工作組織、權限、介面，還是驗證。
- 03
核對產品中的具體含義
同一個詞在 DeepSeek Harness、Pi、Codex 或其他工具中可能有更窄的含義。
- 04
高風險操作先暫停
如果術語涉及存取、憑據、安裝或刪除，先閱讀連結指南或官方來源。
從剛查到的概念繼續學習
動手練習：從讀取檔案到核對一次修改
用一份小型庫存表，把術語與操作連起來：讀取檔案、核對計算、修改一個值，再檢查哪些狀態會保存。準備空的練習資料夾，並依快速上手指南設定 Harness Web 的工作區與模型。
item,quantity,unit_price
tea,3,12
mug,2,25
bag,1,18- 01
選對工作區
選擇包含 inventory.csv 的資料夾。工作區提供工作目錄；僅選擇目錄，不代表已建立檔案系統或網路沙箱。
- 02
確認執行設定
查看本次會話的模型與權限預設。profile 決定載入的外掛及設定，它不是工作區資料夾，也不是儲存的聊天紀錄。
- 03
傳送讀取任務
複製下方提示詞，展開實際的檔案讀取呼叫及回傳結果，逐行對照本機檔案。流暢的回答本身不能證明真的讀取過檔案。
讀取目前工作區的 inventory.csv，逐項列出 quantity × unit_price 與小計，再給出總額。說明實際讀取的路徑，保持檔案不變。若無法讀取，請指出缺少的工具或權限，不要編造內容。預期為 tea 小計 36、mug 小計 50、bag 小計 18，總額 104。這是在核對算術，不是替模型能力評分。若結果不同，分別檢查原始資料行、乘法與加法。
| 概念 | 專業解釋 | 生活化說明 |
|---|---|---|
| 工作區 | 存放 inventory.csv 的資料夾。 | 對照介面選取的路徑及工具使用的路徑。 |
| 模型與工具 | 模型提出讀取請求，註冊的工具執行並回傳內容或錯誤。 | 查看實際呼叫及回傳值，不要把最終回答當成執行日誌。 |
| 上下文 | 回傳的 CSV 可以提供給下一次模型請求。 | 修改檔案後要求重新讀取，先前的工具結果可能已過時。 |
| 輪次與步驟 | 送出的請求開啟一個輪次，其中可能包含多次模型請求及工具呼叫。 | 數一數實際呼叫，不要把一則使用者訊息等同於一次模型請求。 |
| 會話 | 持續的對話記錄已完成的訊息及工具活動。 | 重新開啟同一會話查看先前讀取紀錄，這與還原檔案不同。 |
區分檔案修改與會話歷史
只把 inventory.csv 中 tea 的 quantity 從 3 改為 4。重新讀取儲存後的檔案，展示確切變更的資料行，並重新計算各項小計與總額。其他資料行保持不變。儲存後應為 tea,4,12，總額 116。請自行開啟檔案，與最初範例對照。重新開啟或分支會話不會自動撤銷檔案變更；要還原範例，明確將該行改回 tea,3,12，再核對 104。若使用 Git，先看差異，再決定還原哪些內容。
- 沒有工具呼叫或找不到檔案：先檢查工作區及檔名，不要用開放全部權限來掩蓋路徑錯誤。
- 操作遭阻止：讀取實際的核准或沙箱錯誤與範圍。profile 名稱和提示詞中的「唯讀」並非技術限制。
- 修改後仍回答 104：要求重新讀取目前檔案，確認是否沿用會話中的舊結果。
閱讀一手官方資料
常見問題
修改前需要了解的事項
關於格式、相容性、證據與回滾的簡明說明。
這篇指南核實哪些範圍？
本指南涵蓋：DeepSeek Harness alpha.1 架構與 Web UI 詞彙；DSH Themes 發布與介面外觀術語；專業定義搭配簡短生活化說明
我應該先做什麼？
遇到陌生術語，先查定義，再用生活化例子理解。想親手試一試，可以跟著文末的 inventory.csv 練習，完成讀取檔案、核對總額、修改一個值和還原檔案。
最需要記住的邊界是什麼？
類比能幫助理解，但不能取代產品的精確行為。涉及權限、沙箱、憑據與相容性時，應以實際設定和驗證證據為準。
設定檔是檔案系統沙箱嗎？
不是。設定檔決定載入哪些外掛與設定；檔案系統及程序的隔離取決於目前使用的執行器和沙箱設定。
回答正確能證明工具有執行嗎？
不能。請查看實際呼叫、回傳內容，並自行檢查檔案。預期總額只能交叉核對，無法單獨證明檔案存取。
重開舊會話會還原檔案嗎？
不會。會話歷史與工作區檔案是不同狀態；需要還原時，先查看目前檔案，再執行明確且經過檢查的操作。
繼續學習
檢視驗證證據並繼續操作
對比已釋出製品，或返回安裝文件。