前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。默認情況下，DSH 僅提供一個 ui-theme.fontSize 設置，且隻影響對話正文。側欄標籤、菜單和設置頁的尺寸是固定的像素值，應用本身也沒有頁面縮放功能（菜單中無 View/Zoom 選項，代碼未暴露 setZoomLevel）。在默認狀態下，Cmd + = 鍵無任何響應。dsh-zoom 插件爲 DSH Web 客戶端添加了全局界面縮放能力，通過 CSS zoom 屬性和鍵盤快捷鍵解決這一問題。

核心功能¶

該插件提供以下能力：

• 全局界面縮放：縮放範圍覆蓋側欄、菜單、設置頁、浮層（如確認彈窗、Toast）以及對話區域。
• 鍵盤快捷鍵控制：支持 Cmd/Ctrl 組合鍵進行縮放。
• 縮放檔位持久化：縮放級別存儲在 localStorage 中，重啓應用後恢復。
• 腳本調試 API：暴露 __dshZoom.get、__dshZoom.set、__dshZoom.step、__dshZoom.reset 接口，供外部腳本調用。
• 視口單位補丁：針對 CSS zoom 不縮放視口單位（如 100vh、100dvh）的特性，注入補丁規則以修復浮層高度問題。

安裝與啓用¶

插件由社區開發者 DC-507 維護，採用 MIT 許可證。

命令行安裝（推薦）：

dsh plugin --profile desktop add github:DC-507/dsh-zoom

應用內安裝：
1. 打開 DSH 客戶端側欄。
2. 進入 插件 菜單。
3. 點擊 Add plugin。
4. 輸入 github:DC-507/dsh-zoom。
5. 安裝完成後點擊 Enable now。

安裝後通常需要重啓 DSH 進程才能完全激活。

典型用法¶

插件提供兩種控制方式：快捷鍵和腳本 API。

鍵盤快捷鍵¶

支持的縮放檔位包括：80% → 90% → 100% → 110% → 125% → 150% → 175% → 200%。

腳本調用¶

在瀏覽器控制台或自定義腳本中，可以直接調用全局對象 __dshZoom：

// 獲取當前縮放級別
const current = __dshZoom.get();

// 設置爲 125%
__dshZoom.set(1.25);

// 手動調整一檔（支持正負數）
__dshZoom.step(1);  // 放大
__dshZoom.step(-1); // 縮小

// 重置爲 100%
__dshZoom.reset();

已知限制¶

使用該插件時請注意以下情況：

• 非官方插件：插件由社區維護，與 DeepSeek 無官方隸屬關係。
• 畫布模糊：基於 Canvas 渲染的面板（如終端 xterm、Monaco 編輯器、PDF/表格預覽）在高倍率下會保持原始分辨率，導致顯示略糊。每次調整縮放會觸發 resize 事件以重新測量。
• 快捷鍵衝突：快捷鍵在 <webview> 或 <iframe> 內部不生效。需先點擊主窗口使其獲得焦點。
• macOS 紅綠燈：窗口左上角的 macOS 紅綠燈按鈕（紅/黃/綠）不參與縮放。在 125% 及以上縮放級別時，請留意頂欄的拖拽區域。
• 瀏覽器縮放衝突：如果在普通瀏覽器而非 DSH 桌面殼中運行，插件會攔截瀏覽器默認的頁面縮放快捷鍵。

參考資料¶

• GitHub 倉庫
• 技能目錄頁