返回目錄

dsh-agents-notch

精選清單收錄維護狀態: 活躍

iarxic/dsh-agents-notch

面向 Windows 的 DeepSeek Harness 懸浮狀態列,展示各會話正在執行、等待處理或已完成的狀態。

前往 GitHub
$ dsh plugin --profile web add dsh-agents-notch

19

星數

0

Fork

JavaScript

語言

MIT

授權條款

2026-10-21

建立於

2026-11-10

最近推送

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` 外掛,已完成的那一列靠它收掉

安裝步驟

  1. 01

    執行 `dsh plugin --profile web add dsh-agents-notch`;如果 harness 跑在其他 profile 底下,把 `web` 換成那個 profile 的名稱

    $ dsh plugin --profile web add dsh-agents-notch

  2. 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 整合原生執行環境

用 `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` 手動裝一個視窗。
2026-10-212026-11-10v0.2.1

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 必須正在執行 —— 瀏海能把視窗從工作列或系統匣叫回來,但不能啟動應用程式。

08資料與來源

  • 作者聲明github.com80b0f274ad54…

    **An always-on-top notch for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that answers one quest…

  • 作者聲明github.com80b0f274ad54…

    dsh plugin --profile web add dsh-agents-notch

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。