MIT 授權的 DSH 外掛:在 Windows 10/11 螢幕頂端掛一個始終置頂的瀏海,顯示哪些 DeepSeek Harness 工作階段在執行、哪些在等你、哪些已完成或失敗,並用 Open 直接切到該工作階段。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-15
授權條款
MIT
01它能幫你完成什麼?
在別的視窗工作時,一眼看出哪個 DeepSeek Harness 工作階段正在等你
螢幕頂端一個始終置頂的標籤:工作階段需要你、失敗或完成時短暫展開成附原因的提示,Open 按鈕直接把應用程式切到該工作階段
同時開好幾個 DSH 工作階段、每次都要 alt-tab 逐個讀側邊欄才知道有沒有事在等自己的人
在一個可折疊的面板裡看清每個工作階段的狀態、上下文用量和目前步驟,而不是來回切視窗
面板頂端是最近變化的那個工作階段(標題、專案、存活時間、上下文用量、正在執行的工具或完整的問題),其餘工作階段在下方清單裡捲動查看
把 harness 最小化或丟在系統匣裡、想在不把應用程式叫到前景的情況下掌握全局的人
不用盯著應用程式,也知道工作階段什麼時候完成或失敗
只針對新事件的幾秒鐘提示(需要你、失敗、完成),以及主機端不再回應時變灰並標上最後心跳時間的標籤
讓長時間的 agent 回合自己跑、只想在真的有變化時被打斷的開發者
02如何將外掛接入 DeepSeek Harness?
先決條件
- Windows 10/11 x64 —— 視窗是 WPF 加 Win32 實作,沒有 macOS 或 Linux 版本
- DeepSeek Harness —— 外掛是在 0.2.1-rc.2 上建置並驗證的
- 外掛需要 Node 22 以上(不需要 .NET 執行階段:發行版視窗程式是自成一體的)
- 選用:`session-finished` 外掛,已完成的那一列靠它收掉
安裝步驟
- 01
執行 `dsh plugin --profile web add dsh-agents-notch`;如果 harness 跑在其他 profile 底下,把 `web` 換成那個 profile 的名稱
$ dsh plugin --profile web add dsh-agents-notch
- 02
讓第一次執行把視窗抓下來:它從本儲存庫的 GitHub Release 下載一個 65 MB 檔案,並與已公布的 SHA-256 比對
驗證整合成功
- 沒看到瀏海時,看 `$DSH_HOME\state\agents-notch\host-report.jsonl` 的最後一行:它寫著主機端去哪裡找視窗、下載是否成功,以及修復用的命令
復原
- 用 `dsh plugin --profile web remove dsh-agents-notch` 移除外掛
- 用 `Remove-Item -Recurse "$env:DSH_HOME\state\agents-notch"` 刪掉狀態檔、記錄檔、視窗程式和解壓快取
03DSH 整合程度與能力邊界
用 `dsh plugin` CLI 安裝的原生 DSH 外掛:主機端讀取 DSH 工作階段事件,應用程式內那一半驅動一個獨立的置頂 WPF 視窗
始終置頂的工作階段瀏海
外掛主機端回報的 DSH 工作階段:執行中、需要你、完成、失敗→頂端標籤上每個工作階段一個小機器人 —— 執行中是緩慢轉動的藍色弧線,需要你是琥珀色,完成是綠色,失敗是紅色
從不搶焦點;指標只是經過時標籤變淡,點擊直接穿透到下面的視窗全螢幕應用程式下自動隱藏可展開的面板
指標在標籤上停留 1.6 秒,或把指標推到螢幕頂邊→大機器人上是最近變化的工作階段(標題、專案、存活時間、上下文用量、正在執行的工具或完整的問題),下方是其餘工作階段的捲動清單
單擊一列把該工作階段放到大機器人上;雙擊一列或按 Open ↗ 把 DeepSeek Harness 切到它帶 Open 按鈕的提示
新的需要你、失敗或完成事件→標籤短暫展開的提示,顯示原因(或最後執行的工具與工作階段標題)和 Open 按鈕
只播報新事件;等了一小時的問題留在面板裡,不會彈到面前獨立設定頁與 YAML 設定列
設定 → Agents Notch,或 `$DSH_HOME/profiles/web/cordis.patch.yml` 裡 id 相同的一列→大小、位置、螢幕、列數、不透明度、動效、懸停方式、提示類型和 `contextBudget`,改完下一個 tick 生效,不用重新啟動
設定頁寫進 `$DSH_HOME/state/agents-notch/settings.json` 的值,優先於 profile 裡那一列的 `config:`第一次執行自動下載視窗並比對雜湊
`autoDownload` 為 `true` 時的第一次執行→狀態目錄裡一個自成一體的 WPF 視窗程式,與已公布的 SHA-256 比對
從本儲存庫的 GitHub Release 下載一個 65 MB 檔案,所以第一次執行需要網路`autoDownload: false` 可以關掉下載,`downloadUrl` 指向鏡像或自己建置的視窗
04適合誰?何時不該用?
適合
- 同時開好幾個 DSH 工作階段、每次都要 alt-tab 逐個讀側邊欄才知道有沒有事在等自己的人
- 把 harness 最小化或丟在系統匣裡、想在不把應用程式叫到前景的情況下掌握全局的人
- 讓長時間的 agent 回合自己跑、只想在真的有變化時被打斷的開發者
不適合
- 只支援 Windows:視窗用 WPF 和 Win32 實作(置頂、不搶焦點、全螢幕偵測),package.json 宣告 "os": ["win32"],README 明確寫了沒有 macOS 或 Linux 版本,也沒有閹割版。
- manifest 裡沒有宣告 DSH 版本,裝錯了也不會被攔下來:外掛在 0.2.1-rc.2 上建置與驗證,主機端讀取 session/event、ctx.webServer、ctx.agents 和 sessionQuery,掛載前不做任何檢查。
- 下載的視窗程式沒有簽章,第一次執行時 Windows SmartScreen 會警告;它來自本儲存庫的 GitHub Release 並按已公布的 SHA-256 比對,也可以用 `autoDownload: false` 加上 `tools/install-window.ps1` 手動裝一個視窗。
05相容性、維護與安全提醒
- 只支援 Windows:視窗用 WPF 和 Win32 實作(置頂、不搶焦點、全螢幕偵測),package.json 宣告 "os": ["win32"],README 明確寫了沒有 macOS 或 Linux 版本,也沒有閹割版。
- manifest 裡沒有宣告 DSH 版本,裝錯了也不會被攔下來:外掛在 0.2.1-rc.2 上建置與驗證,主機端讀取 session/event、ctx.webServer、ctx.agents 和 sessionQuery,掛載前不做任何檢查。
- 下載的視窗程式沒有簽章,第一次執行時 Windows SmartScreen 會警告;它來自本儲存庫的 GitHub Release 並按已公布的 SHA-256 比對,也可以用 `autoDownload: false` 加上 `tools/install-window.ps1` 手動裝一個視窗。
MIT · latest release v0.2.1 (2026-11-10)
06常見問題
在 DSH 裡要怎麼安裝 Agents Notch?
執行 `dsh plugin --profile web add dsh-agents-notch`;如果 harness 跑在其他 profile 底下,把 `web` 換成那個 profile 的名稱。外掛本體約 30 KB,第一次執行時會從本儲存庫的 GitHub Release 下載視窗程式(一個 65 MB 檔案),並與已公布的 SHA-256 比對。
macOS 或 Linux 可以用嗎?
不行。視窗是 WPF 加 Win32 實作(置頂、不搶焦點、全螢幕偵測),`package.json` 宣告 `"os": ["win32"]`。README 寫得很直白:沒有 macOS 或 Linux 版本,也沒有閹割版。
對 DeepSeek Harness 版本有要求嗎?
manifest 裡沒有宣告 DSH 版本,所以裝錯了也不會被攔下來。外掛在 0.2.1-rc.2 上建置並驗證:主機端讀取 session/event、ctx.webServer、ctx.agents 和 sessionQuery,應用程式內那一半用 uiWorkspace,舊一點的版本可能缺其中一個。掛載前不做任何檢查,所以缺欄位時是記錄檔說明哪裡失敗,而不是讓主機端停掉。
為什麼看不到上下文百分比?
上下文視窗屬於模型路由,工作階段串流裡不帶這個資訊,所以 `contextBudget` 預設是 `null`:只顯示 token 數,沒有百分比、沒有進度條也不會變成琥珀色。把它設成你這條路由的真實視窗(這個建置的 DeepSeek V4 路由是 `1000000`),百分比和進度條才會出現。
外掛的狀態檔案放在哪?Open 需要應用程式在執行嗎?
狀態檔、記錄檔和視窗程式都在 `$DSH_HOME/state/agents-notch` 下;README 描述的網路步驟只有第一次執行從本儲存庫的 GitHub Release 下載視窗並按已公布的 SHA-256 比對,可以用 `autoDownload: false` 關掉。瀏海從不搶焦點、全螢幕應用程式下自動隱藏;Open 走的是外掛的應用程式內那一半,所以 DeepSeek Harness 必須正在執行 —— 瀏海能把視窗從工作列或系統匣叫回來,但不能啟動應用程式。
07相關的 DSH 工作流程
ds-harness-remote
作者 liguobao
基於 DeepSeek Harness 外掛機制構建的遠端訪問方案,通過低延遲、端到端加密的 P2P 網路,支援使用 PC、移動端 和 Web 隨時訪問本地裝置上的DSH 、CodeX、Cursor、Claude Code等工作區。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自動化外掛,將 CursorTouch/Windows-MCP 接入內建 MCP 客戶端橋接。提供預設關閉的 Computer Use 開關和應用內依賴安裝器。
dsh-desktop
作者 anywhere-labs
為 DeepSeek Harness (DSH) 外掛生態打造的現代化桌面端解決方案。萬物皆「外掛」,桌面本身也是「外掛」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 裝進口袋:手機本機執行,也能遙控你的電腦。
08資料與來源
**An always-on-top notch for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that answers one quest…
dsh plugin --profile web add dsh-agents-notch
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
