前言¶
在 DeepSeek Harness（DSH）里長時間用 Web UI 或桌面客戶端時，系統或瀏覽器默認字號未必合適：窗口偏小會顯得擠，高分辨率屏上又可能偏小。瀏覽器自帶頁面縮放可以湊合，但和 DSH 自身佈局、多 profile 配置不一定一致；桌面端也沒有統一的「界面比例」入口。下面介紹的 dsh-ui-scale 是社區插件，在 DSH 設置裏提供 50% 到 200% 的界面縮放，並寫入 profile 配置，重啓後仍生效。
這是什麼¶
dsh-ui-scale（維護者 juliankang4）屬於 DSH 插件目錄中的客戶端類插件。它針對 DeepSeek Harness 的 Web UI（dsh web）與 Desktop 應用，在同一套設置項下調整整個窗口內界面元素的顯示比例，而不是隻改某一頁 CSS。
社區插件目錄託管在獨立站點（如 SkillHub 上的條目），與 DeepSeek / 幻方無官方從屬關係；安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證。插件在當前 dsh 進程的權限下運行，與其它 DSH 插件相同，啓用前請確認你信任該來源。
核心功能¶
縮放範圍與持久化¶
- 界面比例可在 50% 至 200% 之間設置，配置字段爲整數百分比，默認 100。
- 數值保存在 profile 配置中，重啓後仍保留；主窗口出現前即應用縮放。
web與desktop兩個 profile 各自獨立保存；同一 profile 下登錄的瀏覽器會共享該值。
縮放覆蓋範圍¶
窗口內可見內容整體參與縮放：側欄、會話區、輸入區、各頁面、Settings 與其它對話框，以及附着在其上的菜單、工具提示與彈出層。佈局行爲接近瀏覽器 zoom：例如高縮放、小窗口時左側欄會收起，分欄仍按窗口比例分配，拖拽分隔條時指針與佈局一致。
Desktop 應用裏原生菜單與窗口控件保持系統默認尺寸，不隨插件縮放。
桌面窗口位置與大小¶
啓用插件後，Desktop 會在啓動時恢復上次關閉時的窗口大小與位置（插件未啓用時則每次使用相同默認尺寸）。窗口不會被放大到超出屏幕；若上次位置在副屏，則會在主屏以保存的尺寸打開。全屏狀態不會寫入恢復邏輯。
實現邊界（Limits）¶
插件通過 CSS zoom 並對頁面測量值做換算（元素位置與尺寸、視口、指針、部分 media query 與 viewport 單位等）。以下情況 README 中明確說明未完全換算或仍用真實窗口尺寸：
- 部分通過腳本動態插入、Shadow DOM、MathML 等路徑寫入的
vw/vh規則可能未換算，個別元素可能超出窗口視覺範圍。 IntersectionObserver矩形與觸摸座標仍基於真實窗口尺寸。- 同一步腳本里剛寫入的內聯 viewport 尺寸，當步可能仍讀到未換算值，下一步才一致。
- 頁面上其它腳本（含其它插件）一般讀到換算後的值；Desktop 賬戶 Usage / Top up 區域爲例外，仍按窗口像素定位。
- 已打開的 PDF 在改縮放後可能保持改前清晰度，需重新加載、再次打開或在預覽裏 zoom 後才更新。
在瀏覽器中，瀏覽器自帶縮放與插件縮放會相乘。
安裝與啓用¶
Web（profile web）¶
在資料給出的命令下爲 web profile 添加插件：
dsh plugin --profile web add dsh-ui-scale
Desktop¶
在 Desktop 應用中打開 Plugins，選擇 Add plugin，輸入 dsh-ui-scale 並安裝。
典型用法¶
安裝後打開 Settings > General > Interface scale，可用三種方式設比例：
- 拖動滑塊：以 5% 爲步進，鬆手後生效。
- 輸入百分比：在輸入框填數字後按 Enter 或點擊其它區域；會四捨五入爲整數，低於 50 或高於 200 會鉗制到邊界。
- 點預設：100、110、125、150、175、200%。
若需直接改 profile 配置，可在該 profile 的 cordis.patch.yml 中寫入（與 README 示例一致）：
- id: ui-scale
name: dsh-ui-scale
config:
scale: 125
| 字段 | 默認值 | 說明 |
|---|---|---|
scale |
100 |
界面縮放百分比，50–200 的整數 |
版本說明（來自 README）：在 dsh 0.2.0 中，從另一臺計算機打開的頁面可以臨時改縮放且僅影響該頁，直到刷新；該版本不會把這類頁面的設置寫回持久配置。更高版本行爲以你實際使用的 dsh 發行說明爲準。上游 README 記載在 dsh 0.2.1-rc.2（Web Chrome + macOS Desktop）與 dsh 0.2.0-rc.2（Web Chrome）下做過驗證；插件包版本爲 0.1.5。
適用場景與注意¶
- 適合：需要在固定 DSH 環境內統一界面比例的用戶；高 DPI 或小筆記本窗口下希望放大側欄與會話區；Desktop 用戶希望記住窗口大小與位置。
- 注意：插件改動的是客戶端展示與部分測量語義，與其它依賴像素或視口尺寸的插件疊加時，應留意 Limits 一節中的例外；啓用前閱讀源碼。目錄頁星標等元數據以社區站點爲準（當前條目爲 0 star，不代表質量結論）。
結尾¶
dsh-ui-scale 把 DSH Web 與 Desktop 的界面縮放收到 Settings 與 profile 配置裏，範圍 50%–200%，並擴展 Desktop 窗口幾何記憶。若要安裝或貢獻代碼，可訪問目錄頁 https://www.skillhub.cn/plugins/juliankang4/dsh-ui-scale 與倉庫 https://github.com/juliankang4/dsh-ui-scale。
