在 DSH 工作流中,保持對會話狀態的可見性往往需要頻繁切換上下文。DSH Notch 旨在將這種上下文切換最小化,通過屏幕邊緣的原生窗口展示運行狀態和待處理任務。
插件介紹¶
DSH Notch 是一個爲 DeepSeek Harness 設計的 macOS 插件,由 aa2246740 維護,基於 MIT 許可證。它由兩部分組成:負責同步會話狀態的 Host 插件,以及負責顯示和交互的原生 macOS 應用。通過這兩部分的配合,用戶可以在不進入 DSH 界面的情況下,通過屏幕邊緣的 Notch 查看任務進度、回答問題或查看完成結果。
安裝與啓用¶
在安裝前,請確保環境滿足以下要求:macOS 14+、Apple Silicon 芯片,以及 DeepSeek Harness 0.2.0-rc.2 版本。
1. 安裝插件包¶
在終端中執行以下命令安裝 Host 插件和客戶端同步助手:
dsh plugin --profile web add dsh-notch@0.3.4
dsh plugin --profile web add dsh-notch-focus@0.1.2
2. 啓動原生程序¶
插件包安裝完成後,需要下載並啓動原生程序。原生程序版本爲 0.3.3。
- 從 GitHub Releases 下載
dsh-notch-0.3.3-macos-arm64.tar.gz並解壓。 - 進入解壓目錄並啓動程序:
cd dsh-notch-0.3.3-macos-arm64
./dsh-notch --verify-idle-resources
./dsh-notch
3. 環境配置¶
原生程序與 Host 插件必須指向相同的 DSH_HOME 目錄。原生程序依賴 OpenBotMotion 提供機器人資源,首次運行時請確保資源完整。
核心功能¶
插件在屏幕邊緣提供狀態指示和交互功能,幫助開發者高效管理 DSH 會話。
狀態指示¶
Notch 窗口通過顏色和數字顯示當前會話狀態:
* 藍色數字:表示正在運行的會話數量。
* 黃色感嘆號:表示有待處理的問題或決定。
* 綠色數字:表示未讀的完成結果。
* 紅色數字:表示失敗結果。
交互操作¶
- 直接回答:點擊 Notch 上的問題選項可直接提交答案;點擊問題標題可跳轉回 DSH 查看完整上下文。
- 彈性收納:拖動 Notch 後鬆手,它會彈性收納到屏幕邊緣;再次拖出即可恢復。
- 自動彈回:隱藏狀態下,若出現新的完成、錯誤或待審批問題,它會自動彈回正常緊湊狀態;同一提醒不會因輪詢反覆彈出。
- 空閒狀態:當所有任務結果讀完後,Notch 會顯示待機機器人。
注意事項¶
- 計數規則:計數以用戶的主對話爲單位,嵌套的子代理歸入主對話統計,不會各自增加藍色數字或生成完成、失敗燈。
- 日誌記錄:詳細的交互日誌記錄在
~/.dsh/dsh-notch/presentation.l,可用於排查狀態燈疊影或動畫異常等問題。 - 資源要求:插件運行需要 Apple Silicon 芯片支持,且原生程序必須與 Host 插件共享
DSH_HOME。