前言¶
DeepSeek Harness (DSH) 採用插件化架構，社區開發者常需要爲特定場景擴展功能。dsh-context-badge 是一個本地優先的插件，專注於解決 DSH 會話中的上下文記錄與任務追蹤問題。它不依賴遠程同步或模型調用，通過瀏覽器本地存儲和可選的 macOS 伴侶應用，爲開發者提供輕量級的狀態管理能力。
核心功能¶
-
界面集成
在 DSH 編寫器的 Dock 欄增加一個小型的上下文徽章。 -
本地存儲
利用瀏覽器localStorage爲每個 DSH 會話或工作區保存筆記和待辦事項，支持自動版本遷移。 -
信息展示
在徽章中顯示當前 DSH 會話名稱、工作區基名、對話輪數/步數以及 Token 摘要（如可用）。 -
上下文管理
支持在“會話上下文”和“工作區上下文”之間切換，查看保存狀態，清除已完成的待辦事項，並回顧最近更新的 8 個上下文。 -
自動摘要
自動保留每個會話的前 5 條加載的用戶或引導消息，並從中推導出本地用途行，無需調用模型或進行遠程同步。 -
macOS 伴侶應用
提供可選的菜單欄/始終置頂應用，僅跟蹤前臺應用名稱和窗口標題，並記錄最近 8 個前臺上下文。
安裝與啓用¶
在插件的倉庫根目錄下執行以下命令即可安裝：
dsh plugin add ./
對於本地開發配置，可以通過編輯 DSH 的插件配置文件進行鏈接，然後重啓 DSH 網頁服務。插件的 Bundle ID 爲 dsh-context-badge。
使用示例¶
安裝完成後，插件會自動在 DSH 界面中生效。如果需要使用 macOS 伴侶應用，請確保系統環境滿足要求（macOS 13+ 和 Swift 5.9+）。
運行伴侶應用：
npm run run:macos
安裝伴侶應用開機自啓：
npm run install:macos
注意事項¶
- 數據隔離：插件不涉及截圖、按鍵記錄、網絡請求、模型調用或遠程同步，所有數據存儲在本地。
- 伴侶應用存儲路徑：macOS 伴侶應用的數據存儲在
~/Library/Application Support/ContextBadge/contexts.json。 - 隱私設置：首次運行伴侶應用時，可能需要在 macOS 的隱私設置中允許其觀察窗口元數據。如果無法獲取標題，應用仍可使用前臺應用名稱。
- 功能邊界：該插件是一個獨立的上下文工具，不會改變 DeepSeek Harness 的模型路由、提示詞、權限、計費或代理預設。
總結¶
該插件爲 DSH 用戶提供了無需聯網、不消耗模型 Token 的上下文管理方案，適合需要頻繁切換工作區或管理多輪對話任務的場景。更多細節可查看插件目錄頁或GitHub 倉庫。
