前言¶
DeepSeek Harness(以下簡稱 DSH)是 DeepSeek 開源的智能體運行時。官方倉庫 deepseek-ai/deepseek-harness 把它概括成一句話:Everything is a Plugin——模型適配、工具、會話、權限,連網頁界面都可以按 profile 組裝。它目前仍處於開發者預覽階段,官方 README 寫明會有破壞兼容的變更。
智能體跑長了之後,上下文窗口很少只裝「你剛說的那幾句」。系統提示、工具 schema、技能或插件注入、助手回覆、工具返回,都會擠進同一段預算。對話開始變慢、變糊、突然被壓縮時,終端裏往往只剩一個總數,看不出是哪一塊把窗口吃滿的。
dsh-context 做的就是把這件事攤開:在 Web UI 里加一塊上下文洞察面板,並提供 /context 命令,用來看當前窗口由什麼構成、每一輪請求怎麼漲、壓縮和裁剪髮生在哪一步。本文按社區插件目錄頁、GitHub 倉庫 README / package.json、npm 包頁面以及 DSH 官方倉庫交叉覈對後整理。
需要先說明:社區插件目錄 deepseek-harness-plugin.com 是獨立站點,用來檢索帶 dsh-plugin 話題的倉庫,和 DeepSeek / 幻方沒有官方從屬關係,不能當成官方應用商店。
這是什麼¶
dsh-context 是一款會話與消息類 DSH 插件,由 GitHub 用戶 bowenliang123 維護,倉庫地址是 bowenliang123/dsh-context。目錄頁的定位是「上下文洞察儀表盤:看清模型上下文窗口由什麼構成、如何演化。」倉庫 README 寫得更具體:它提供 Context 頁籤和 /context 命令,用來理解上下文是怎麼拼出來的、又是怎麼演化的。
社區目錄於 2026-08-15 收錄該插件,分類爲「會話與消息」,許可證爲 Apache-2.0,主要語言是 TypeScript。npm 包名同樣是 dsh-context,截至 2026-08-17 頁面上的版本爲 0.10.3。package.json 裏把客戶端平臺標成 web,並注入 @deepseek-ai/dsh-client-ui-conversation 等 Web UI 依賴,因此它面向的是 dsh web 這一路,而不是 headless 純命令行。
截至 2026-08-17,GitHub 倉庫星標爲 115;同一天社區目錄頁仍顯示 36,目錄數字可能滯後,星標以倉庫頁面爲準。
核心功能¶
倉庫 README 把界面拆成兩處入口、五塊內容。入口是:
- Context / 上下文頁籤:打開任意會話後點這個頁籤,能看到完整洞察面板,覆蓋組成、按輪歷史、壓縮,以及當前模型可見的消息面。
/context命令:在輸入框輸入/context,或從/菜單裏選中後回車。會彈出居中對話框,展示與頁籤同一套摘要:以服務商數據錨定的佔用標題、六類組成條,以及最近 10 輪的趨勢圖。鼠標懸停或點擊某一根柱,可以看到和頁籤一樣的明細。
頁籤裏能看到的內容如下。
會話統計。 當前會話的輪次、步驟,以及注入、壓縮、裁剪髮生過多少次。用來先判斷這次對話「折騰」過沒有,而不是一上來就盯着某一條消息。
當前組成。 一條六色堆疊條,按模型完整上下文窗口縮放,灰色軌道表示剩餘餘量。六類分別是:系統提示、工具 schema、用戶消息、注入的上下文、助手回覆、工具結果。另外會列出佔用最高的 5 個工具 schema。README 的說法很直接:對話開始變差時,先看是哪一塊把預算喫掉了。
歷史。 按每一次模型請求畫一根堆疊條,粒度比「按消息」更細。可以在 Turn(輪)和 Step(步驟)之間切換,橫向滾動整段會話,懸停看摘要,點擊釘住完整拆分。拆分裏會把估算 token 和服務商回報的實際 prompt / output token 放在一起對照。壓縮或裁剪髮生的位置用 ✂ 標出,柱子會明顯掉一截。
README 給過一個倉庫內的會話示例:大約 48 輪漲到約 56.3 萬 token,隨後一次壓縮回收了 −53.55 萬,對話從很小的窗口繼續。這是維護者寫在文檔裏的示例,不是第三方評測。
在 Step 粒度下,懸停某一根柱會立刻顯示該步驟的輪次/步驟編號、時間戳,以及估算值和供應商回報值。
上下文事件。 每一次壓縮、工具輸出裁剪、技能或插件的上下文注入、模型切換,都會留下事件:token 增減、歸屬的輪次/步驟、時間戳。用來回答「窗口爲什麼突然變了」,而不是隻看到結果。
當前模型可見消息。 此時模型實際看到的消息列表,最新的在前,並帶上每條消息的 token 開銷。它展示的是「現在送進去的面」,不是本地聊天記錄的全集。
安裝與啓用¶
社區目錄頁給出的安裝命令如下,在 DeepSeek Harness 終端中運行即可:
dsh plugin add github:bowenliang123/dsh-context
目錄頁同時說明:如需可復現安裝,可以固定 commit 哈希:
dsh plugin add github:bowenliang123/dsh-context#commit
把 #commit 換成具體提交哈希。插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證。
倉庫 README 和 npm 頁面給出的是另一條命令,按包名裝進 web profile:
dsh plugin --profile web add dsh-context
然後啓動 Web UI:
dsh web
README 寫明這條路徑不需要額外構建,也不需要重啓。官方倉庫裏 dsh web 是 --profile web 的別名,默認把界面開在 http://127.0.0.1:3080。兩條安裝命令指向同一個倉庫/npm 包;目錄頁以 github:owner/repo 爲準,README 以 npm 包名加 --profile web 爲準。已經在用 Web UI 時,按 README 寫進 web profile 更直接。
典型用法¶
裝好並執行 dsh web 之後,用法按 README 只有兩步。
- 打開任意會話,點擊 Context / 上下文 頁籤。先看頂部統計和當前組成條:系統提示、工具 schema、用戶消息、注入內容、助手回覆、工具結果各佔多少,灰色部分還剩多少。如果某次工具特別「貴」,看佔用最高的 5 個 schema。
- 需要在輸入時快速看一眼,不必離開對話區:輸入
/context或從/菜單選擇,回車後彈出居中對話框。標題、六類組成條、最近 10 輪趨勢和頁籤是同一套數據,懸停或點擊柱子即可展開明細。
排查長會話時,可以把三塊對照起來看:
- 歷史圖裏找 ✂,確認壓縮或裁剪髮生在哪一次請求。
- 事件列表覈對原因:壓縮、工具輸出裁剪、技能/插件注入,還是換了模型。
- 消息列表覈對「此刻模型看見的」是哪些條目、各自花了多少 token。
Turn / Step 兩種粒度不要混用:看一輪對話的漲跌用 Turn;要對齊某一次工具調用或某一步壓縮,切到 Step。
適用場景與注意事項¶
比較適合已經在用 dsh web、並且會話經常跨很多輪、帶一批工具或技能注入的人。典型情況包括:
- 對話質量突然下降,想確認是工具結果膨脹、schema 過重,還是注入把窗口占滿。
- 剛觸發過壓縮,想覈對回收了多少、之後窗口從多大繼續。
- 需要把估算 token 和服務商回報的實際用量放在一起看,而不是隻信本地估算。
使用前有幾條邊界需要心裏有數。
- 這是 Web UI 插件。
package.json的dsh.client.platform爲web,README 的啓動方式也是dsh web。不要指望它在 headless 純文本會話裏畫出同樣的儀表盤。 - 社區目錄是獨立站點,不是 DeepSeek 官方應用商店。安裝命令以目錄頁原文和倉庫 README 爲準,不要憑插件名自己拼 GitHub 地址。
- 插件以當前 dsh 進程權限運行,安裝時可能執行代碼。裝之前應閱讀倉庫源碼和 Apache-2.0 許可證;生產環境建議固定 commit,而不是一直追默認分支。
- DSH 本身處於開發者預覽,官方 README 寫明會有破壞兼容的變更。插件版本迭代也很快:npm 上 2026-08-14 才發佈 0.1.0,2026-08-17 已到 0.10.3。界面字段、命令表現以當前倉庫 README 爲準。
- README 里約 56.3 萬 token、一次壓縮回收 −53.55 萬的數字,是維護者文檔中的會話示例,用來說明歷史圖和 ✂ 標記怎麼讀,不能當成自己項目的容量保證。
小結¶
dsh-context 把「上下文窗口裏到底有什麼」從一句總數,拆成組成、歷史、事件和當前可見消息。入口有兩個:會話裏的 Context 頁籤,以及輸入框的 /context。維護者是 bowenliang123,許可證 Apache-2.0,面向 DSH 的 Web UI。
目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-context/
GitHub:https://github.com/bowenliang123/dsh-context