DSH 桌面 Widget Center: 原生 macOS 小窗與多實例管理

DSH（DeepSeek Harness）允許在本地運行智能體，常用於處理數據查詢或作爲長期駐留的助手。在開發或使用過程中，用戶往往需要在桌面上獲取實時信息（如股票行情）或查看便籤，而非侷限於對話框。現有的網頁化方案體驗割裂。DSH 桌面 Widget Center 插件提供了一種原生 macOS 小窗解決方案，通過獨立進程在桌面上呈現數據。

插件概況¶

該插件由維護者 NattoCB 開發，名稱爲 nattocb/dsh-widget-center。它是一個 DSH 插件，核心功能是在桌面上管理任意多個原生 macOS 小窗。主要支持兩種 Widget 類型：行情（shares）與便籤（notes）。每個實例擁有獨立的窗口、配置和生命週期，互不干擾。

核心功能¶

原生 macOS 桌面窗¶

Widget 以 NSPanel + WKWebView 的形式運行，表現爲無邊框、無 Dock 圖標的原生窗口。窗口可以跟隨所有桌面空間，支持任意位置拖動。右鍵菜單提供刷新、重置尺寸、置頂開關等操作。窗口是獨立的 detached 進程，即使 DSH 重啓，已打開的窗口也會繼續運行。

多實例管理¶

插件支持多實例獨立管理。用戶可以在 DSH 設置 UI 的側欄「Widget Center」頁創建多個實例。例如，可以同時開多個行情窗口用於監控不同股票，或開多個便籤窗口用於記錄不同事項。實例的狀態（運行中/已隱藏）和配置會即時持久化。

行情數據與工具¶

行情 Widget 支持多源數據提供者（騰訊、東方財富、新浪、Yahoo、Binance），按優先級自動 fallback。它支持 A 股、港股、美股、外匯及加密貨幣符號。
插件集成了 market_quote 模型工具。當會話中詢問特定股票代碼（如“現在 159845 多少”）時，Agent 可以調用此工具獲取標準化報價。行情數據由 host 常駐進程直抓，零 token 消耗。

Type Studio 擴展¶

插件支持使用 Type Studio 創建新的 Widget 類型，爲未來擴展更多功能提供了基礎。

安裝¶

在安裝前，請確保系統已安裝 swiftc（即 Xcode Command Line Tools），否則首次啓動 Widget 時會報錯。

dsh plugin --profile web add github:NattoCB/dsh-widget-center

使用方法¶

安裝完成後，插件會添加到 DSH 的設置界面中。

在 DSH 設置 UI 側欄找到「Widget Center」頁面。
在列表中點擊卡片上的「在桌面顯示」按鈕。
桌面會出現一個原生小窗。對於行情 Widget，會顯示紅漲綠跌的圖表和價格；對於便籤 Widget，會顯示多行文本。
在 DSH 的對話會話中直接詢問數據，例如：
> 現在 159845 多少
Agent 將調用 market_quote 工具返回當前價格。

注意事項與已知限制¶

依賴：必須安裝 Xcode Command Line Tools。
期貨符號：目前不支持期貨符號（如 nf_CU0）。
代理支持：僅支持 socks5 代理。
接口限制：
- 新浪接口需要固定 Referer 頭，否則會 403。
- 東方財富接口在高頻訪問時可能返回 502，插件內置了限頻和重試機制。
License：MIT。

插件將配置文件保存在 $DSH_HOME/storages/widget-center/settings.json，支持通過 API 進行熱更新。