DeepSeek Harness 桌面版到 2026 年 9 月 29 日的 0.2.0-rc.2 已自帶執行環境，同一個視窗就能修程式、產報表、排任務。 四天後的 0.2.1-alpha.1 又把自動化任務從選用外掛改成內建。依 DeepSeek 在 GitHub 的版本紀錄，兩版都標為 pre-release。若已更新到 0.2.1-alpha.1 或之後的版本，rc.2 教學裡有一步就對不上，動手前先核對自己裝的是哪一版。排程頁的交付紀錄也只代表訊息送進對話，Agent 有沒有做完要另外查。
Harness 是包在模型外面的應用程式。模型決定下一步，Harness 提供讀檔、改程式、執行指令和檢查結果的工具。少了任何一邊，聊天回覆都變不成電腦上的實際工作。
以下流程取自一份用 rc.2 Mac 版錄製的公開實測：修一支算錯營收的腳本、產生 HTML 報表、追加篩選功能、自製外掛，最後排一個定時任務。測試數字是那份實測的紀錄，Tenten 沒有重跑。版本、指令、價格與限制，則以 2026 年 10 月 5 日的官方文件為準。
桌面版自帶執行環境，Linux 仍要自己裝 Node
截至 2026 年 10 月 5 日，DeepSeek Harness 官方產品頁提供兩個下載：macOS（Apple silicon）與 Windows（64-bit）。依 桌面版 README，安裝檔自帶獨立的 Python、Node.js 與 pnpm。0.2.0-rc.2 另外把 dsh 指令包進 Mac 與 Windows 桌面版。從選單列的 Manage dsh command 安裝後，管理外掛不必再裝 Node 或 pnpm。
Linux 沒有安裝檔，官方給的是 Web 介面：
npx @deepseek-ai/dsh web
npx @deepseek-ai/dsh web --no-open
第二行的 --no-open 會啟動服務但不開瀏覽器分頁。依 專案 README，Web 介面預設位址是 http://127.0.0.1:3080。package.json 的 engines 欄位要求 Node ^22.19.0 || >=24.0.0，也就是 22 系列的 22.19 以上，或 24 以上。依 Node.js 官方版本表，2026 年 10 月時 v22 與 v24 都是 LTS，v26 是 Current，三者都符合條件。
3080 這個連接埠只屬於 Web 介面。0.2.1-alpha.1 起，桌面版預設由作業系統指派連接埠，原因是 Windows 的保留連接埠範圍會讓程式無法啟動。要連桌面版時，不要假設它在 3080。
送出第一個任務前，先核對金鑰、檢視與工作區
DeepSeek Harness 桌面版送出第一個任務前要核對三件事：模型來源、Show coding view 與工作區。在 Settings 的 Models 填入 DeepSeek API Key，走的是 API 計費。桌面版另有 DeepSeek 帳號登入，額度與扣款分開計算。2026 年 9 月 24 日的 0.1.7-rc.2 已把兩種來源拆成各自的模型選項，額度警告也會對應目前任務，避免用 API Key 的人誤儲值到登入帳號。金鑰不要出現在截圖或要分享的專案檔案裡。
第二項是 Show coding view。依實測，它在 General 設定裡，打開後才會看到程式開發軌跡、程式碼變更與 Agent preset。0.2.1-alpha.1 的版本說明補了一條：關閉這個檢視時，標準、創造與自訂模式仍可選，內建的 PTC 或極簡預設值會改回標準。畫面比教學簡單時，先查這個開關。
第三項是工作區。用側欄的加號加入專案資料夾，再到輸入框上方選定它。加入和選定是兩個動作，送出前看一眼資料夾名稱。
實測使用的組合是 DeepSeek V4.1 Flash、Max 思考強度、Workspace write 權限與標準模式。Max 會影響回應時間和用量，拿自己的結果跟別人比較時要先對齊這一項。依實測的說明，Workspace write 允許改檔與執行專案檢查；Read only 只供檢視，Full access 範圍更大。跳出核准提示時，先讀它要執行的操作。
一支把 662 美元算成 977 美元的腳本
實測準備了一間虛構的周邊商店 Northstar：一份 16 筆訂單的 CSV、一支 Python 報表腳本，以及驗證計算規則的測試，沒有真實顧客資料。腳本有兩個錯：把取消的訂單算進去，也沒有正確扣掉退貨數量。
規則寫得很死。取消的訂單不計入任何數字。完成與退款的訂單都算一筆，全額退款也算。實際退貨量來自退貨件數（refunded units）欄位，營收與件數都要反映它。金額一律用整數美分計算。稅、運費與折扣不在範圍內，Agent 不需要自己發明規則。
依這些條件，修正提示詞可以這樣寫：
請檢查這個專案，說明報表腳本算錯的原因，然後修正彙總邏輯。
規則：
1. 已取消的訂單不計入任何數字。
2. 已完成與已退款的訂單都算一筆訂單，全額退款也算。
3. 實際退貨數量以退貨件數（refunded units）欄位為準，營收與件數都要反映這個數量。
4. 金額一律用整數美分計算。
5. 稅、運費與折扣不在這次範圍內，不要自行加入規則。
限制：不得修改來源 CSV，也不得修改或放寬既有測試。
完成後執行既有測試，並印出修正後的總數。
依實測紀錄，Harness 讀完專案後重現了失敗，只做兩處小修改：略過取消的資料列，改用實際的退貨數量。原本的 4 個測試全數通過，CSV 與測試檔都沒有變動。修正後是 14 筆訂單、退款 141 美元、淨營收 662 美元、淨銷售 41 件。原腳本顯示的是 977 美元。
重跑檢查的指令如下。依 Python 官方 unittest 文件，不帶模組名稱時會自動搜尋測試，-v 則逐一列出每個測試的結果。
python3 -m unittest -v
這個任務好驗收，是因為成功條件在動手前就寫完了。依實測，操作者在 Agent 回報後自己重跑了一次測試，也確認 CSV 與測試檔沒有被改動。值得照抄的是這個順序，Northstar 的數字只是示範。
同一段對話產出 HTML 報表，Agent 兩度需要喊停
計算修好後，實測在 DeepSeek Harness 的同一段對話要求產出 HTML 報表。產出的檔案是 report.html、build_report.py 與 calculations.md，提示詞如下：
用同一份 CSV 產生一份響應式 HTML 報表，計算要重用剛才修正過的函式。
內容包含：日期範圍、訂單數、營收毛額、退款、淨營收、淨銷售件數、各商品營收圖表，以及圖表背後的商品明細表。
另外說明 CSV 更新後如何重新產生報表。
報表必須是單一獨立檔案，不使用外部函式庫，也不下載任何素材。
依實測，從右側邊欄的 Workspace files 點選 report.html，就能在桌面版裡直接預覽，還有全螢幕按鈕。頁面顯示淨營收 662 美元、淨銷售 41 件，與實測者另行計算的結果一致。CSV 更新後執行下面這行即可重建；產生器 build_report.py 重用修正後的計算函式，報表與原腳本走同一套規則。
python3 build_report.py
這一段並不順。Agent 先修了產生器裡的一個語法錯誤，接著卡在很慢的瀏覽器截圖和重複檢查上。操作者已經確認桌面預覽正常，於是要它停掉截圖、把交付物收尾。依實測，General 設定裡的 Send behavior while busy 決定執行中再送訊息會怎樣。操作者設為 Queue：排隊中的訊息可以編輯、移除或 Steer。Queue 適合交代下一步，Steer 適合修正正在跑的任務。
預覽也有邊界。依官方的文件預覽說明，Word 與 PowerPoint 會在本機轉成 PDF 顯示。試算表只顯示已儲存的公式結果，不會重新計算；圖表、圖片、圖形與條件式格式不顯示，檢視器會提示改用系統應用程式開啟。預覽用來檢查，交付物仍是那個可編輯的檔案。
接著追加一個需求：
在報表加入商品篩選下拉選單、清楚的重設按鈕，並在圖表與表格標示被選取的商品。
全店總數必須保留，且清楚標示為全店數字，不可與單一商品的數字混淆。
最後一句不能省。選了商品後，如果一個數字變了、另一個還停在全店總數，介面能動卻會誤導人。依實測，選 Launch Tee 顯示淨營收 200 美元、8 件；選 Studio Hoodie 顯示 180 美元、3 件；重設後回到全部商品。全店區塊維持 14 筆訂單與 662 美元。實測者另行核對了 5 項商品，原測試仍然通過。
安裝外掛等於執行程式碼，創造模式要從小題目開始
依實測，Plugins 頁的 Official 分頁列出隨 Harness 出貨的選用組合包，仍需手動啟用；Installed 是另外加裝的外掛。依 官方外掛發布文件，來源可以是本機路徑、npm 套件、Git 儲存庫或 tarball。同一份文件提醒，允許 Git 套件執行 prepare 腳本，等於同意它在沙箱之外、於安裝當下執行程式碼。實測另外提醒，下載完成不等於啟用，裝完要回清單確認狀態。來源不認識的套件，先查再裝。
創造模式（Creator）讓 Agent 自己寫外掛。實測在新對話裡要了一個報表檢查清單面板，原始需求可以整理成：
建立一個「報表檢查清單」側欄面板，包含三項：
1. 確認來源資料
2. 複核計算
3. 開啟最終報表
顯示已完成數量，並提供重設按鈕。
先把原始碼寫到資料夾，不要自行安裝。
依實測，創造模式一開始花很多時間檢查執行環境。操作者把指令收窄，要它用已經查過的 API 完成這個小面板。檢查過產生的檔案後，在 Plugins 按 Add plugin、填入本機資料夾路徑，再按 Enable，側欄就出現按鈕，不必重新啟動。三項都勾完，計數變成 3/3；切到別的面板再回來，狀態還在；重設後歸零。這個外掛把狀態放在記憶體，整個程式重新載入後不會保留。
0.2.1-alpha.1 在外掛管理頁加了「讓 Agent 建立外掛」入口。它會帶著草稿進入創造模式，送出需求後才開始執行。創造模式仍是實驗功能，外掛可能立即載入，也可能要重啟。
rc.2 教你先啟用排程外掛，新版已經內建
DeepSeek Harness 的自動化任務在 2026 年 10 月 3 日的 0.2.1-alpha.1 改成 Web 內建。rc.2 教學裡「先到 Official 外掛清單啟用 Automation tasks」這一步因此過時。這一步在 0.2.0-rc.1 與 rc.2 是對的。新版會自動清掉舊的實驗組合包選項，既有任務保留。官方產品頁在 10 月 5 日仍寫著 Enable the Scheduled tasks plugin，頁面文案還沒跟上。官方下載連結目前提供哪一版，本文沒有查證。裝的若是 rc.2，照舊啟用組合包；0.2.1-alpha.1 之後直接使用。
| 版本 | 發布日 | 排程怎麼開 |
|---|---|---|
| 0.1.7-rc.2 | 2026 年 9 月 24 日 | 內建但預設關閉，需手動開啟 |
| 0.2.0-rc.1、rc.2 | 2026 年 9 月 28、29 日 | Official 外掛清單裡的選用組合包 |
| 0.2.1-alpha.1 | 2026 年 10 月 3 日 | Web 內建；標準、創造、PTC 模式有提醒工具，極簡模式與子 Agent 沒有 |
依 官方排程文件，可用的時間規則有六種：以整數秒計的一次性延遲、指定日期時間、至少一分鐘的固定間隔、每日、每週，以及五欄 cron。每日、每週與 cron 都帶 IANA 時區。瀏覽器會提供自己的時區來解讀口語請求，文件仍建議明講，例如寫 America/New_York 或 Asia/Taipei。
實測用一個 90 秒後觸發的一次性任務示範。任務要讀銷售資料、執行既有彙總，再把查核過的營收與件數寫進提醒檔。觸發後，Delivery records 分頁出現那則指令，原對話產出 tutorial-reminder.md，內容是 662 美元與 41 件。一次性任務隨後變成 inactive，沒有殘留的重複工作。
動手前先記住四個限制：
- 交付紀錄只確認訊息已寫入對話收件匣，文件明說它不代表模型完成工作，也不保證恰好送達一次。
- Host 關閉期間不會排程。關掉桌面版視窗只是隱藏，Host 與任務繼續跑；完整結束程式才會停，而且結束前會提示將中斷哪些任務。
- 重新啟動後，逾期的一次性任務會補送；重複任務只補最近錯過的那一次。
- 不支援暫停，也不支援每次執行開新對話。指令一律回到原本那段對話。
真要每週產報表，請選重複規則，存檔後回 Automation tasks 核對頻率與時區，再打開實際產出的檔案確認。
四種模式決定工具組，OAuth 訂閱接不進模型選單
DeepSeek Harness 有標準、PTC、極簡、創造四種模式，0.2.1-alpha.1 起只有極簡模式拿不到排程提醒工具。
| 模式 | 用途 | 排程提醒工具（0.2.1-alpha.1） |
|---|---|---|
| 標準 Standard | 程式、檔案與研究的一般起點，可用子 Agent 處理有邊界的工作 | 有 |
| PTC | Programmatic tool calling，讓 Agent 寫 TypeScript 協調多次工具呼叫 | 有 |
| 極簡 Minimal | 接近實驗基準，保留持續的 shell，標準功能較少 | 沒有 |
| 創造 Creator | 加上擴充 Harness 所需的工具與指引 | 有 |
PTC 適合成批操作，但沒有保證更省錢或更快。preset 要在開新任務時選；改預設值不會換掉執行中對話的工具。依實測，選用的 Agent Teams 組合包提供隊友、訊息與共享任務，仍屬實驗功能，隊友共用同一個工作目錄，檔案重疊時要先分清責任。Workflow 與 Agent Teams 的差別，以及執行迴圈都能替換的外掛架構，本站另有專文，這裡不重複。
模型選單可以接其他供應商。依 官方模型設定文件，內建目錄有 anthropic、openai、moonshotai、zai 等供應商 ID，填 API Key 即可。自訂端點支援 OpenAI Chat Completions、OpenAI Responses 與 Anthropic Messages 三種協定。同一份文件也寫明，用 OAuth 登入的供應商（例如 Codex）目前不支援。手上的訂閱方案不一定接得進來。
Harness 免費，V4.1 Flash 的尖峰時段剛好是台灣上班時間
Harness 以 MIT 授權開源，模型呼叫另外計費。程式裝在自己的電腦，不代表模型在本機執行。以下是 DeepSeek API 官方價格頁在 2026 年 10 月 5 日的價格。deepseek-flash 由 DeepSeek-V4.1-Flash 提供服務，單位是每百萬 token：
| 計費類別 | 離峰（USD） | 尖峰（USD） |
|---|---|---|
| 輸入，快取命中 | $0.003 | $0.006 |
| 輸入，快取未命中 | $0.15 | $0.30 |
| 輸出 | $0.60 | $1.20 |
尖峰是週一到週五 UTC 01:00–04:00 與 06:00–10:00，中國國定假日除外。換成台北時間是 09:00–12:00 與 14:00–18:00，幾乎就是上班時段。在台灣白天跑 Agent，多半吃到兩倍價。
一次 Agent 任務會發出多個模型請求，還包含推理、工具呼叫與委派，一則提示詞不等於一次計費。用一組假設值試算：累計輸入 200 萬 token、九成命中快取、輸出 10 萬 token。離峰是 0.0054 + 0.03 + 0.06，約 0.095 美元；尖峰約 0.19 美元。這是算式示範，不是實測帳單，實際用量要看任務結束後的用量統計。
這份實測只證明小專案走得通。Agent 修好了計算、產了報表、做了篩選、跑完一次性任務，也載入了自製外掛；同時有兩處要人介入。它說明不了大型正式程式碼庫上的表現。
FAQ
DeepSeek Harness 桌面版需要先安裝 Node.js 嗎？
DeepSeek Harness 桌面版不需要另外安裝 Node.js，Mac 與 Windows 安裝檔自帶 Python、Node.js 與 pnpm。只有用 npx @deepseek-ai/dsh web 啟動 Web 介面時才要自備 Node，版本須符合 ^22.19.0 || >=24.0.0。官方產品頁在 2026 年 10 月 5 日沒有提供 Linux 安裝檔。
DeepSeek Harness 的自動化任務在哪個版本變成內建？
DeepSeek Harness 的自動化任務在 2026 年 10 月 3 日的 0.2.1-alpha.1 變成 Web 內建功能。0.2.0-rc.1 與 rc.2 仍要到 Official 外掛清單啟用選用組合包。升級後既有任務會保留，極簡模式與子 Agent 拿不到提醒工具。
DeepSeek Harness 關掉視窗後，排程任務還會執行嗎？
DeepSeek Harness 桌面版關掉視窗後，排程任務仍會執行，因為視窗只是隱藏，Host 繼續運作。完整結束程式就會停止排程。依官方排程文件，重新啟動後會補送逾期的一次性任務，重複任務只補最近錯過的一次。
DeepSeek Harness 可以接 ChatGPT 或 Codex 訂閱帳號嗎？
DeepSeek Harness 目前不能用 OAuth 登入的訂閱帳號，官方模型設定文件點名 Codex 尚不支援。可行的做法是填入各供應商的 API Key，或設定自訂端點。自訂端點支援 OpenAI Chat Completions、OpenAI Responses 與 Anthropic Messages 三種協定。文件沒有寫 OAuth 支援的時程。
權威來源
- DeepSeek AI — DeepSeek Harness releases
- DeepSeek AI — DeepSeek Harness README
- DeepSeek — DeepSeek Harness 官方產品頁
- DeepSeek AI — DeepSeek Harness Desktop README
- DeepSeek AI — Schedule reminders
- DeepSeek AI — Configure models
- DeepSeek AI — Document preview README
- DeepSeek Harness — Package and install a plugin
- DeepSeek API Docs — Models & Pricing
- Node.js — Previous Releases
- Python Software Foundation — unittest
Author Insight
排程的啟用方式在九天內換了三種：9 月 24 日內建但預設關閉，9 月 28 日改成選用組合包，10 月 3 日又收回內建。在穩定版出現之前，沒人盯著的每週報表不該只靠桌面版排程，除非另有一道檢查會打開產出的檔案核對數字。交付紀錄只證明訊息送到了。
適合現在就試的是另一種人：手上有一個小專案，而且寫得出像 4 個測試、662 美元這樣能自動驗證的答案。寫不出成功條件的任務，換哪個 Harness 都一樣驗收不了。
術語表
| 術語 | 本文用法 |
|---|---|
| Harness | 包在模型外、提供讀檔、改程式、執行指令等工具的應用程式 |
| Host | 桌面版背後持續運作的服務；視窗關閉後仍在，完整結束程式才停止 |
| preset | 一組 Agent 模式設定，決定對話可用的工具 |
| PTC | Programmatic tool calling，以 TypeScript 協調多次工具呼叫的模式 |
| 交付紀錄 | Delivery records，確認排程訊息已寫入對話收件匣的紀錄 |
| 快取命中 | 輸入 token 重用既有快取，按較低費率計價 |
| IANA 時區 | 形如 Asia/Taipei 的時區名稱，排程規則用它固定當地時間 |
