前言¶
在 DSH 裏做長任務時，一個常見的問題是「上下文在腦子裏、不在界面裏」：任務做到第幾輪、workspace 叫什麼、接下來還有哪些待辦，往往只能憑記憶。把每輪關鍵信息寫進代碼文件再來回翻，既污染工作區又慢。dsh-context-badge 是在 DSH composer dock 上加一個小徽標，把會話/工作區的 notes、todos 和運行狀態存到瀏覽器 localStorage，屬於獨立社區插件，維護者在 README 與 package.json 中署名 YaoleWu，許可證 MIT。
它解決什麼問題¶
- 不改動模型路由、prompt、權限、計費或 agent presets，只做上下文記錄與展示。
- 數據全部留在本地：無截圖、無鍵盤記錄、無網絡請求、無模型調用、無遠程同步。
核心功能¶
1、composer dock 上顯示 context badge。
2、notes 和 todos 按 session 或 workspace 兩個維度存儲，走瀏覽器 localStorage，帶自動的 v1 遷移。
3、徽標顯示當前 DSH session、workspace 基名、turn/step 計數；token summary 在可用時展示。
4、可以切換 session context 與 workspace context，查看保存狀態，清除已完成的 todos，瀏覽最近更新的 8 個上下文。
5、自動保留每個 session 加載後的前 5 條 user/steering 消息，並從第一條消息推導一行本地 purpose 摘要；這一步不調用模型、不同步遠程。
6、可選的 macOS 前臺窗口伴隨應用（menu bar / always-on-top），只跟蹤前臺應用名和窗口標題，不取截圖、不記錄按鍵。伴隨應用把數據寫到 ~/Library/Application Support/ContextBadge/contexts.json。
安裝與啓用¶
在倉庫根目錄執行官方安裝命令：
dsh plugin add ./
如果想在 profile 內做本地開發鏈接，就通過該 profile 的 plugin 配置加入本包，然後重啓 DSH web 服務。包的 bundle id 是 dsh-context-badge。
需要注意：安裝命令來自倉庫 README 原文，是從本地目錄安裝，不是 github:owner/repo 形式；目錄頁鏈接技能市場與 GitHub 倉庫路徑中對維護者的寫法是 YaoleWu，但倉庫內 package.json 的 repository指向 LeslieWylie，以倉庫實際內容爲準。
macOS 伴隨應用¶
要求 macOS 13+、Swift 5.9+。首次運行可能需要在 macOS 隱私設置裏允許應用讀取窗口元數據；如果拿不到窗口標題，徽標仍可用前臺應用名工作。伴隨應用保留最近 8 個前臺上下文，可以從面板重新打開舊上下文。
先從源碼目錄啓動：
npm run run:macos
要登錄後保持運行並在退出時自動重啓，執行：
npm run install:macos
npm 腳本對應的是 ./scripts/run-macos.sh 和 ./scripts/install-macos-launch-agent.sh，前者直接跑，後者裝 LaunchAgent；本機沒有 Swift 工具鏈就先跑 npm run build:macos（會執行 cd macos && swift build -c release）確認環境。
適用場景與注意¶
適合需要在多輪會話、多 workspace 之間切換，又不想把待辦散落在聊天記錄或臨時文件裏的 DSH 用戶和插件開發者。插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證（MIT）。它提供的是上下文輔助，不改變 agent 行爲；立志做「通用智能體操作系統」或追求輕量、可 hack 工具的人可以在上面繼續改。
小結¶
它的價值不在替換現有流程，而在給 DSH 補一個不離開界面、不離開本地的上下文筆記本。目錄頁：https://www.skillhub.cn/plugins/YaoleWu/dsh-context-badge；倉庫：https://github.com/YaoleWu/dsh-context-badge。
