前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，進程常會停在工具審批、計劃確認或結構化提問上。若你正專注在編輯器或終端裏，切回 Harness 主界面才能點「允許 / 拒絕」，上下文容易被打斷。JingleNotch（npm 包名 dsh-jingle-notch）把這類待決策事項推到 macOS 劉海區域，並提供瀏覽器面板，讓你在不必離開當前工作區的情況下完成響應。下面介紹它是什麼、能做什麼，以及如何按官方步驟安裝啓用。
這是什麼¶
JingleNotch 是面向 DeepSeek Harness 的 AI Agent Approval Notifier：鯨鈴 Jingle 作爲 macOS notch companion，在 Harness 因工具審批、計劃審閱或結構化問題暫停時，把請求帶到劉海 UI，並支持從瀏覽器儀表盤操作。
- 維護者：5ysy（GitHub：
5ysy/dsh-jingle-notch） - 分類：客戶端（社區目錄 SkillHub 插件頁）
- 許可證：MIT（見倉庫 LICENSE）
- 當前包版本（package.json）：
0.1.0 - 運行方式：與 DeepSeek Harness Desktop 和 Web 配合；同一套請求控件也可在專注的瀏覽器儀表盤中使用
插件以當前 DSH 進程權限運行；安裝前請自行查看源碼與許可證，確認符合你的環境與合規要求。
核心功能¶
以下能力均來自項目 README，未在資料中出現的細節不作延伸。
審批與決策
- 工具審批：可快速審閱工具調用，並選擇 Allow once、Deny 或 Always in this session。
- 完整計劃審閱：在智能體繼續前閱讀完整計劃及精確的審批選項。
- 結構化提問：在同一表單中回答單選、多選與自由文本；輪詢期間草稿可保留。
會話與文件活動
- 多會話感知：在緊湊的劉海視圖中跟蹤活躍會話、當前工具、工作區與並行調用。
- 可操作的文件活動：查看有界的前後預覽，以及增刪行數統計。
界面與本地運行
- 原生 macOS 劉海 UI：懸停概覽、展開詳情、滾動瀏覽會話，新請求仍可進入面板。
- 瀏覽器儀表盤：在 Harness 服務地址訪問
/jingle，在瀏覽器中處理審批與提問。 - 本地運行：內置美術資源，不額外發起模型請求、不增加遙測服務；回顧歷史僅存儲數值聚合（隱私與通知開關見 configuration）。
- 鈴聲與系統通知：審批、提問與回合完成可告警，各項可單獨開關並支持自定義音頻。
- Jingle 角色狀態：內置動畫對應 idle、thinking、working、attention、finished、error 等狀態，含 reduced-motion 海報。
兼容性¶
插件聲明與下列 Harness 發行版兼容（README 兼容表）：
| Host | 已驗證發行版 | 覆蓋範圍 |
|---|---|---|
| Official macOS Desktop | 0.2.1-rc.5 |
捆綁 CLI 安裝、打包 Host、原生 overlay |
| Released Web | 0.2.1-rc.5 |
Web profile、儀表盤、原生 overlay |
| Source Web | 0.2.2-alpha.2 |
源碼構建 Host、儀表盤、原生 overlay |
原生 overlay 需要 macOS、圖形會話以及 Electron 可執行文件。Desktop 側會安裝獨立 Electron runtime 以便 Desktop Host 啓動 overlay；Web / 源碼 Host 可配置 Electron 或使用文檔中的 npm 回退方案，詳見 installation.md。
安裝與啓用¶
前提：已安裝 DeepSeek Harness。Desktop 與 Web 使用 獨立的 profile，你用到哪種 Host，就在對應 profile 裏安裝一次。
macOS Desktop¶
先打開 DeepSeek Harness 完成初始化，再 完全退出 應用，然後在終端執行：
'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
plugin --profile desktop add dsh-jingle-notch
重新打開應用並啓用插件後，notch companion 會隨 Desktop Host 自動啓動。
Web¶
dsh plugin --profile web add dsh-jingle-notch
dsh web
若 Web 服務已在運行，安裝後需重啓。Host 啓動且插件啓用時 overlay 會自動起來；在 Harness 服務地址訪問 /jingle 可打開瀏覽器面板。
典型用法¶
查看插件狀態
Harness 內可用 slash 命令（README）：
/jingle Show JingleNotch status
配置項
profile 補丁行名爲 jingle-notch。完整配置、存儲路徑與隱私控制見 docs/configuration.md。
npm 包
也可從 npm：dsh-jingle-notch 安裝；Quick start 以 dsh plugin ... add dsh-jingle-notch 爲準。
適用場景與注意¶
適合誰
- 在 macOS 上使用 DSH Desktop 或 Web，且希望工具審批、計劃確認、結構化問答 常駐可見 的開發者。
- 需要 一眼看多會話、當前工具與並行調用，並在劉海或
/jingle面板裏統一處理的場景。
務必注意
- 原生劉海 overlay 僅 macOS + 圖形會話；非 macOS 或純無頭環境應依賴 Web 儀表盤
/jingle，並按要求配置 Electron（見 installation 文檔）。 - 插件與 Harness 同進程權限運行；添加 npm 插件前請審查倉庫源碼與 MIT 許可證及 THIRD_PARTY_NOTICES.md。
- 社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件由社區維護者發佈，非官方應用商店條目。
結尾¶
JingleNotch 把 DSH 暫停時的決策點從「切回主界面」變成劉海或瀏覽器上的即時操作，並附帶多會話與文件活動概覽，適合長時間在 macOS 上驅動智能體的用法。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫；問題與貢獻見倉庫 Issues 與 development.md。
