前言¶
DeepSeek Harness (DSH) 提供了基於插件的架構，其中 dsh web 是主要的圖形界面。雖然功能完備，但在終端中運行時，它看起來仍然像瀏覽器標籤頁，且調試可能很棘手。dsh-macos-skin 解決了這兩個問題：它提供了原生的 macOS 視覺風格，併爲整個會話（瀏覽器和服務器）提供了一個集中式的錯誤日誌面板。
功能¶
該插件主要包含兩部分功能：
macOS 桌面皮膚¶
將網頁版界面模擬爲 macOS 桌面應用，包括：
* 毛玻璃菜單欄：包含文件/顯示/窗口/幫助菜單及實時時鐘。
* 浮動應用窗口：窗口左上角帶有紅綠燈按鈕，分別對應最小化到 Dock、顯示 Dock、全屏。
* 底部 Dock：圖標支持懸停放大效果。
* 明暗主題：自動跟隨系統的明暗主題切換。
實時報錯日誌¶
在 Dock 欄增加日誌圖標（或使用快捷鍵 ⌘L）打開日誌面板，支持：
* 瀏覽器端錯誤：捕獲 window.onerror、未處理 Promise、console.error/warn 等。
* 服務端運行日誌：輪詢讀取 ~/.dsh/logs/web.log。
* 插件安裝日誌：輪詢讀取 ~/.dsh/logs/install.log。
* 日誌操作：支持按級別過濾、自動滾動、清空、導出爲 .log 文件；檢測到錯誤時，Dock 和標題欄會顯示紅色角標。
安裝與啓用¶
安裝前請確保環境已安裝 pnpm。
dsh plugin --profile web add "dsh-macos-skin@github:hero-goblins/dsh-macos-skin"
插件通過 dsh.bundle.patch 自動加入 profile 層，通過 dsh.client 聲明注入 window.__DSH_BOOT__。安裝後重啓 dsh web 並刷新瀏覽器即可生效。
典型用法¶
- 查看日誌：按
⌘L或點擊 Dock 中的日誌圖標打開日誌面板。 - 服務端日誌同步：爲了讓日誌面板顯示服務端輸出，啓動命令需將日誌重定向到文件：
dsh web 2>&1 | tee -a ~/.dsh/logs/web.log
插件通過 `/dsh-logs/` 路由讀取 `~/.dsh/logs/*.log`，日誌內容由啓動方式決定。
- 卸載：
dsh plugin --profile web remove dsh-macos-skin
注意事項¶
- 依賴環境：需要
pnpm環境。 - 權限與讀取：Host 半端只負責提供
~/.dsh/logs/*.log的讀取路由，日誌文件的實際內容由啓動時的命令決定（如是否使用tee命令）。 - 代碼審查：插件使用 MIT 許可證，安裝前建議檢查源碼。
總結¶
dsh-macos-skin 通過視覺僞裝和日誌聚合，顯著提升了 dsh web 的使用體驗。它不僅讓界面更接近原生應用，還通過集中管理服務端和客戶端日誌，簡化了開發調試流程。
