前言¶

DeepSeek Harness (DSH) 的字體大小設置僅影響對話正文。如果需要調整整個界面，包括側邊欄、菜單、模態框和圖標，目前沒有現成方案。dsh-plugin-ui-zoom 通過縮放整個文檔根元素，配合寬度補償，讓縮放效果更自然。

插件定位¶

這是一個 DSH 插件，由 1700563146 維護，用於將 DSH Web UI 的整體顯示比例在 70% 到 160% 之間縮放。插件通過操作 document.documentElement 的 zoom 屬性實現，佈局視口、固定定位菜單和覆蓋層都會隨之變化，而不是使用 transform: scale()，避免固定元素被隔離。

核心功能¶

• 整體縮放範圍 70%–160%，涵蓋所有 UI 元素
• 縮放快捷鍵通過 DSH 自身的快捷鍵中心註冊，支持重綁定
• 桌面端使用 Mod+= / Mod+- / Mod+0，Web 端使用 Ctrl+Alt+= / Ctrl+Alt+- / Ctrl+Alt+0
• 鼠標滾輪縮放每次 5%，支持觸摸板連續滑動累積，不會跳變
• 界面右上角顯示當前縮放比例膠囊，點擊可重置到 100%
• 縮放比例保存在 localStorage 的 dsh-ui-zoom 鍵中，不同頁面/源會記住各自設置
• 內容寬度補償：主機限制閱讀列寬度爲 920px，插件按 1 / zoom 縮放該寬度，保持物理寬度不變
• 卸載插件時會清理所有監聽器和註冊的命令，恢復原始狀態

安裝與啓用¶

在 DSH 的「插件」頁面搜索 dsh-plugin-ui-zoom 安裝，或使用命令行：

dsh plugin --profile <profile> add dsh-plugin-ui-zoom

安裝後重啓 dsh web 使快捷鍵生效。

典型用法¶

• 桌面端縮放：按住 Ctrl/⌘ 滾動滾輪，或使用快捷鍵 Mod+= / Mod+-
• Web 端縮放：按住 Ctrl + Alt 滾動滾輪，或使用快捷鍵 Ctrl+Alt+= / Ctrl+Alt+-
• 重置到 100%：點擊界面右上角的百分比膠囊，或按 Mod+0（桌面）/ Ctrl+Alt+0（Web）

快捷鍵可在 DSH 的鍵盤快捷鍵面板（Mod+/）中查看或重新綁定。插件通過 ctx.shortcuts 註冊，重複或衝突的綁定會被 DSH 拒絕。

適用場景與注意¶

適合需要頻繁調整界面顯示比例、在多分辨率屏幕上使用 DSH 的開發者。插件以當前 DSH 進程的權限運行，安裝前建議查看源碼和許可證。

兼容 DSH 引擎 >=0.2.0-rc.2 <0.3.0-0，需要 @deepseek-ai/cordis ^4.0.1。無構建步驟，無額外運行時依賴。

已知限制：
- 如果手動拖動了對話寬度手柄，主機存儲的寬度會覆蓋插件的補償，縮小時列寬會按比例縮小
- Web 端的 Ctrl+wheel 是瀏覽器頁面縮放，無法攔截，必須使用帶 Alt 的組合鍵
- 插件縮放的是文檔根元素，因此主機的控制條等元素也會被縮放，與瀏覽器縮放行爲一致

小結¶

dsh-plugin-ui-zoom 提供了一套完整的界面縮放方案，從快捷鍵到寬度補償都做了針對性處理，適合需要在不同縮放比例下使用 DSH 的場景。更多細節可參考：
- 插件目錄頁：https://www.skillhub.cn/plugins/1700563146/dsh-plugin-ui-zoom
- GitHub 倉庫：https://github.com/1700563146/dsh-plugin-ui-zoom