前言¶
DeepSeek Harness（DSH）的 Web 界面在長時間對話、寬表格或高 DPI 屏上，有時需要整體放大或縮小，而不是隻改瀏覽器默認縮放（可能與 Harness 內嵌滾動區行爲不一致）。社區插件 dsh-ctrl-zoom 在客戶端側爲整個 Harness Web UI 提供類似瀏覽器頁級縮放的手勢：按住 Ctrl（macOS 上爲 ⌘）配合滾輪或快捷鍵調整比例，並在非 100% 時在右下角顯示當前級別。下面介紹插件定位、能力與安裝用法。
這是什麼¶
dsh-ctrl-zoom 是 maintainer jinmuxi1 發佈的 DSH profile bundle（純 ESM，無構建步驟、無運行時依賴），在 SkillHub 插件目錄 中歸類爲客戶端。npm 包名與 bundle 標識均爲 dsh-ctrl-zoom（當前資料中版本 1.0.0，許可證 MIT）。Host 側 index.js 的 apply() 爲空，主要作用是讓插件管理器能安裝與切換；縮放邏輯運行在瀏覽器側的 client.js。
核心功能¶
官方 README 中列出的交互如下。
| 手勢 | 效果 |
|---|---|
Ctrl / ⌘ + 滾輪 |
以 10% 爲步進放大或縮小，範圍 50%–200% |
Ctrl / ⌘ + + / - |
與滾輪相同的步進縮放 |
Ctrl / ⌘ + 0 |
恢復 100% |
| 右下角比例膠囊 | − / + 步進；點擊百分比一鍵回到 100% |
縮放級別寫入瀏覽器 localStorage，下次打開頁面會自動恢復。僅在比例不是 100% 時顯示右下角膠囊，默認狀態下不佔用界面。
實現上對 <html> 使用 CSS zoom，使佈局、文字與固定層一起縮放，並保留應用內滾動容器的行爲；滾輪監聽在 window 捕獲階段調用 preventDefault()，避免與瀏覽器原生頁縮放疊加。若其它組件已處理該手勢（event.defaultPrevented，例如內嵌編輯器或地圖自帶的 Ctrl+滾輪縮放），插件不會搶事件。卸載時通過 ctx.effect 清理膠囊、監聽、樣式與 zoom 屬性。
隱私方面：插件不發起網絡請求，僅讀寫一個 localStorage 鍵並設置文檔元素的 zoom。
安裝與啓用¶
推薦從 npm 安裝（資料原文步驟）。
- 在 DSH 側邊欄打開 Plugins。
- 選擇 Add plugin，輸入包名並安裝：
dsh-ctrl-zoom
也可讓 Harness Agent 執行：
plugin_manager action: install_bundle
target: dsh-ctrl-zoom
- 若 Web UI 已在運行，安裝後刷新一次頁面（
Ctrl/⌘+R）。
從 GitHub 或本地目錄、tarball 安裝時，同樣使用 plugin_manager action: install_bundle，target 爲倉庫路徑或 npm pack 生成的 .tgz 絕對路徑；具體命令以 GitHub README 爲準。
若曾安裝舊包 dsh-ctrl-wheel-zoom，需先移除再裝本插件，否則 Web 啓動可能失敗（舊 bundle 的 client 模塊 id 與包名不一致）：
plugin_manager action: remove_bundle
target: dsh-ctrl-wheel-zoom
卸載：
plugin_manager action: remove_bundle
target: dsh-ctrl-zoom
典型用法¶
安裝並刷新後，在 Harness Web 界面中：
- 按住 Ctrl（macOS 爲 ⌘），向上或向下滾動鼠標滾輪，觀察整體界面按 10% 步進在 50%–200% 之間變化。
- 需要精確復位時按 Ctrl+0（或 ⌘+0），或點擊右下角膠囊上的百分比。
- 關閉頁面再打開，確認比例仍爲上次的設置（localStorage 恢復）。
適用場景與注意¶
- 適合：經常在 Harness Web GUI 中工作、希望用熟悉的「Ctrl+滾輪頁縮放」習慣統一放大整個界面（含佈局與固定層）的用戶。
- 兼容性（資料原文）：在 DeepSeek Harness 0.2.1-rc.2 Web GUI（Electron 44）上測試；client 半部需要基於 Chromium 的 Harness shell，非瀏覽器 Host 下不生效。
- 安全與權限：插件以當前 DSH 進程及 Web 客戶端上下文運行；安裝前請自行查看 源碼與 LICENSE，確認符合你的環境與合規要求。SkillHub 目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-ctrl-zoom 用少量客戶端代碼爲 Harness Web UI 補上 Ctrl/⌘ 滾輪與快捷鍵頁級縮放，並持久化比例、在非默認縮放時提供右下角反饋。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
