DSH Desktop 的理念是「一切皆插件」。開發者在調試或運行智能體時，常遇到權限請求需要切回主窗口、對話需要打開特定工具打斷工作流的場景。賈維斯是一款常駐桌面的懸浮窗助手，也是一隻有狀態的桌面寵物。它以 Metal 粒子光球爲載體，允許用戶快速審批權限、使用全局快捷鍵隨時喚出對話面板，實現桌面層面的交互閉環。該項目由 CroissanTTs 維護，當前版本爲 0.7.1，採用 MIT 許可證。
核心功能¶
權限審批
當 DSH 彈出權限請求時，懸浮窗會出現審批卡片。面板與 DSH 主窗口競答，先到者生效。支持一鍵選擇「允許 / 拒絕 / 總是允許（此工作區）」。
懸浮式對話
默認全局快捷鍵 ⌃⌥J 可喚出快速輸入條，隨時開始對話。對話記錄內嵌在面板中，展開輸入區即可查看。
語音問候
啓動時賈維斯會出聲打招呼。問候語與發音人可配置。懸停光球可靜音。
桌面形象
本體爲 Metal 粒子光球。具備五種狀態動效（待機、思考、說話、等待、出錯）。支持貼邊融變收納，懸停喚醒。
安裝與啓用¶
插件提供源碼安裝方式。宿主環境建議 Node.js 22.18+，面板需要 macOS 14+ 與 Swift 6 工具鏈。
- 從倉庫根目錄構建項目：
npm ci
npm run build
(cd macos && ./build.sh)
- 在你使用的 DSH profile 的
package.json中合併以下條目（把路徑換成此倉庫的絕對路徑）：
{
"dependencies": {
"dsh-harness-jarvis": "link:/absolute/path/to/dsh-harness-jarvis"
},
"dsh": {
"profile": { "bundles": ["dsh-harness-jarvis"] }
}
}
- 在 profile 目錄執行
pnpm install解析link:依賴。
典型用法¶
重啓 DSH 後，屏幕上會出現懸浮光球。按 ⌃⌥J 喚出輸入條即可開始對話。當 DSH 彈出權限審批時，面板會出現審批卡片，點擊即可處理。懸停光球可控制聲音；展開輸入區可查看對話記錄。
適用場景與注意¶
本插件原生面板僅面向 macOS 14+。安全審查與真機驗收未完成，暫不聲稱已通過發佈安全驗收。
數據存儲
審批記錄、日誌與語音緩存默認保存在本機 ~/.dsh/jarvis，沒有云端存儲。
隱私與權限
本機存儲不等於離線處理：所配置的模型服務會收到對話上下文，內置 edge-tts 會把播報文本發給 Microsoft 語音服務。插件不申請 danger-full-access；快捷鍵走 Carbon RegisterEventHotKey，不需要輔助功能按鍵監聽；當前沒有麥克風錄音。
結語¶
賈維斯旨在通過懸浮窗與桌面寵物形態，降低 DSH 日常交互中的切換成本。它不改變 DSH 的核心邏輯，而是提供一種常駐的、可視化的交互層。相關文檔與源碼可在其目錄頁與 GitHub 倉庫查看。
