DeepSeek Harness 爆紅幾週了：把外掛讀懂之前，先把自己這個「主體」顧好

這篇文章回顧的事件發生在 2026 年 9 月中旬。9 月 14 日，掘金出現了一篇由古茗前端團隊李天生撰寫的《Deepseek Harness 架構解析和應用》，討論的是 DeepSeek 開源的 agent harness 框架（簡稱 dsh）。這個專案在 GitHub 上短短幾週累積了超過 20 萬顆 star，在已經很擁擠的 agent 框架賽道裡殺出重圍，靠的是一句口號式的設計哲學：Everything is a plugin，一切皆插件。

如果你是工程師或重度技術學習者，這幾週你的書籤列和分頁大概又腫了一圈。之前我們聊過DeepSeek 和 OpenAI 開源 harness 時，追新框架的你該把眼睛和作息排進時程表，這次架構解析文章出來，等於是把誘惑又升了一級：別人只是喊你來用，這篇是喊你來讀原始碼。

先說結論：讀原始碼是好事，但這件事不需要用熬夜來證明熱情。我們把這篇文章講了什麼、你可以從中學到什麼、以及讀的過程中身體會遇到什麼，分成三塊說清楚。

它到底紅在哪：把「一切皆插件」翻成白話

dsh 是 DeepSeek AI 開發的開源 agent 框架，底層由 Cordis 驅動。所謂「一切皆插件」，意思是從 UI 介面、API 呼叫、語言模型對接、shell 執行，到最核心的 agent loop（也就是 AI 代理反覆思考、呼叫工具、再思考的那個循環），全部被拆成一個個獨立的插件包。想要什麼能力就裝什麼，不想用的就拔掉，客製化彈性非常高。

原始碼結構也反映了這個思路：packages/ 目錄下每個子資料夾是一個獨立的 npm workspace package，統一命名為 @deepseek-ai/dsh-，按能力分組，例如 core（核心 agent 能力）、api、llm、shell、client 等等。倉庫裡還有 Python SDK、原生擴展、VitePress 文件站，以及給 agent 自己用的工作流目錄。

插件的寫法有三種：函數形式、物件形式、類形式。大多數情境用函數形式就夠了，寫一個匯出 apply 函數的 TypeScript 模組，框架載入時呼叫 apply、傳入上下文物件 ctx，你透過 ctx 註冊能力。當插件需要向其他插件提供服務時，才考慮用繼承 Service 的類形式。

這些是文章裡的技術事實，屬於「別人整理好、有原始碼可查」的層次，可信度比二手轉述高。但接下來要聊的部分，證據強度就不一樣了：關於你自己的眼睛、肩膀和睡眠，多半是通用的生理常識與經驗觀察，不是針對「讀 dsh 原始碼」這件事做過的臨牀研究。分清楚這一點，你才知道哪些建議可以放心用，哪些要自己觀察調整。

讀架構解析的身體成本，往往被低估

一篇「10 分鐘閱讀」的架構文章，實際消化時間很少是 10 分鐘。你會開著編輯器對照目錄結構，會 clone 倉庫跑 pnpm install，會在 packages/ 裡跳來跳去找 ctx 的型別定義，然後不知不覺兩三個小時過去。這段時間裡，幾件事正在悄悄發生。

眼睛是最先抗議的。長時間盯著高對比的程式碼畫面，眨眼頻率會明顯下降，眼睛表面淚液蒸發變快，出現乾、癢、灼熱感。這種狀況有個通俗說法叫數位視疲勞，通常休息後會緩解，但它也是身體在提醒你連續使用的時間已經超標了。一個不花錢的做法是遵循 20-20-20 原則：每 20 分鐘，看 20 英尺外（大約 6 公尺）的東西 20 秒。聽起來老派，做起來有效，因為它強迫睫狀肌放鬆、強迫你眨眼。

肩頸是第二個受害者。讀原始碼時人很容易往前傾，頭部每往前移一公分，頸椎承受的負荷就往上加。等到你發現脖子轉不動的時候，通常已經坐了很久。簡單的對策是計時器：每 45 分鐘到一小時站起來一次，倒杯水、走動個兩分鐘。不是為了運動量，是為了打斷靜態姿勢。

然後是睡眠。這種「再追一個檔案就睡」的迴圈，和之前我們在DeepSeek Flash 降價時，刷價格表比價的你順便也被看一下裡聊過的狀態很像：技術內容的即時滿足感，會讓你低估時間、延後入睡。藍光本身對睡眠的影響在研究上有爭論，但「精神還很興奮所以睡不著」這件事沒有爭論。給自己一個明確的停損點，例如晚上十一點後只讀文件、不碰終端機，會比依賴意志力有用。

三種插件寫法的啟發：也把自己拆成可組裝的單元

架構文章裡有個細節值得多想一下：插件有三種寫法，多數情況函數形式就夠了，需要對外提供服務時才用類形式。這背後是一個工程判斷：不要為了炫技增加複雜度，夠用就好。

這個判斷搬到身體照顧上意外地合用。你不需要一次到位地改造生活，不需要立刻辦健身房會員、買升降桌、換人體工學椅。把「照顧自己」拆成最小可運行單元：一個 45 分鐘的計時器、桌邊放一杯水、螢幕高度調到視線自然落下的位置。這些是函數形式的小插件，成本低、見效快。等這些跑穩了，再考慮要不要疊更大的服務上去，例如規律運動或視力檢查。

同樣的道理也適用於學習節奏。20 萬顆 star 的專案不會明天消失，架構解析文章也不會。你可以分次讀：第一遍只看目錄結構和前言，第二遍跑起 web 介面玩一玩，第三遍才進 packages/ 看插件機制。分段消化不但對大腦友好，對眼睛和睡眠也更友善。

幾個值得留意的身體訊號

大多數讀原始碼帶來的不適是暫時的，休息就好。但有幾個訊號出現時，建議不要只靠休息硬撐。

眼睛如果出現持續的視力模糊、看燈光有光暈或彩虹圈、伴隨眼睛脹痛或頭痛，這可能超出單純視疲勞的範圍，建議找眼科醫師檢查，量個眼壓、看看視神經，排除青光眼這類需要及早處理的問題。下一次的具體行動：掛眼科門診，而不是先買一堆葉黃素。

頸部或手臂如果出現持續的麻、無力，特別是麻感延伸到手指，這可能涉及神經壓迫，值得找復健科或神經科評估，而不是自己加強拉筋。突然的劇烈頭痛、說話或肢體無力，則屬於需要盡快就醫的紅旗，直接去急診。

睡眠方面，如果連續兩週以上入睡困難或半夜醒來睡不回去，白天功能已經受到影響，這時候可以考慮就診，讓醫師評估是單純作息問題還是需要進一步處理。偶爾一晚追框架追到兩點，和長期失眠，是兩回事，不需要因為前者恐慌，也不要用「工程師都這樣」把後者合理化。

追熱鬧之餘，把節奏拿回來

20 萬顆 star 是一個漂亮的數字，但它量測的是 GitHub 上的按讚行為，不是你非學不可的義務。agent 框架這條賽道每幾個月就有新寵兒，去年爆紅的專案和今年爆紅的專案，核心問題常常是同一批：怎麼讓 AI 代理穩定地用好工具。dsh 用插件化給了一個優雅答案，值得讀，值得玩，但不值得用健康去換。

比較務實的做法是把它排進行事曆，像排會議一樣排一段「讀框架時間」，時間到就停。架構不會跑，原始碼就在那裡，倉庫也不會因為你晚三天 clone 就少一顆 star。會跑掉的只有你的視力餘裕、肩頸狀態和今晚的睡眠，這三樣才是真正不可再生的資源。

追技術的熱情是好事，讓熱情燒得久一點的方法，往往不是燒得更猛，而是燒得有節奏。插件可以隨插隨拔，你的眼睛和睡眠不行。