前言¶
在 DeepSeek Harness（DSH）裏對照截圖、覈對間距或量圖標尺寸時，系統自帶的圖片預覽往往只能縮放瀏覽，很難穩定讀出「指針在第幾像素」或「選中區域佔多少像素」。放大到 183% 時，屏幕像素與圖像像素也不再一一對應，憑目測容易偏差。
下面介紹的 dsh-image-scope（維護者 olivine13）是 DSH 的客戶端類插件：掛在右側邊欄文檔預覽擴展點上，在已有圖片預覽流程裏增加懸停座標、可調虛線測量框，並在任意縮放下始終以圖像像素顯示測量結果。內置 Image 查看器仍可在下拉菜單中選用。
這是什麼¶
- 定位：DSH 側欄圖片預覽上的像素標尺（Pixel Scope）。
- 倉庫：github.com/olivine13/dsh-image-scope
- 包版本（
package.json）：0.0.1 - 許可證：MIT
插件通過 document-preview 擴展點掛載在 sidebar.right.tab.document 槽位；無構建步驟、無運行時依賴。若內置文檔預覽不可用，查看器不會掛載。
核心功能¶
懸停座標¶
指針移到圖像上時，右下角狀態條顯示 X/Y；界面提供十字準星，並高亮當前像素格。
一個可調整的測量矩形¶
拖拽繪製虛線框；在框內拖動可平移，八個手柄可改大小。各邊會貼合圖像邊界。
左下角測量條顯示起始像素、結束像素，以及 width × height（整圖像素）。座標自圖像左上角爲零基；寬高按包含兩端的整像素計數（例如從 x=100 到 x=199 記爲寬 100 px）。
鍵盤與清除¶
查看器獲得焦點時：Ctrl+D（macOS 爲 ⌘D）清除測量框；Esc 取消進行中的繪製、移動或縮放。也可點 Clear，或重新拖一個新框覆蓋舊框。
縮放與像素對齊¶
支持 Fit / 1:1 / − / +，以及 Ctrl/⌘ + 滾輪（或觸控板捏合）。滾輪縮放以指針爲錨點，工具欄縮放以視口中心爲錨點；座標與尺寸仍按圖像像素計，不按屏幕像素。放大到 150% 及以上時，圖像切換爲像素化渲染以利於對齊檢查。
配置¶
顏色、字號、選框樣式、疊加層等寫在插件包內的 config.json。Host 在每次頁面啓動時讀取並注入瀏覽器；改完後刷新頁面。若在插件首次啓用前已打開的頁面，會先用內嵌默認樣式，刷新後纔會用上注入配置。刷新仍不生效時，可重啓 DSH 一次讓 Host 側重載。
配置分區包括：font、canvas、selection、crosshair、pixel、handle、selectionInfo（左下測量條）、hud（右下提示/尺寸條）、toolbar、status。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 上瀏覽源碼並確認 MIT 許可證與行爲是否符合你的環境。
官方安裝命令如下（資料原文）：
dsh plugin add dsh-image-scope
若不在默認 profile，可加上 --profile <name>。市場條目發佈後，也可在 Plugins → Discover 中安裝。
DSH 版本兼容（README 與 package.json engines）：
>=0.2.1-rc.5 <0.3.0-0或>=0.2.2-rc.1 <0.3.0-0（README 註明在0.2.1-rc.5上測試）
典型用法¶
- 在右側邊欄打開圖片（支持 PNG、JPEG、GIF、WebP、BMP、ICO、SVG）。
- 在查看器下拉里選擇 Pixel Scope（未改過時，圖片默認即爲此查看器）。
- 移動指針讀取座標。
- 拖拽繪製虛線矩形；在框內移動或拖動手柄調整大小。
- 用 Ctrl+D / ⌘D、Clear 或新框替換，清除測量。
README 示例：選區從 (0,0) 到 (194,262) 時，左下條顯示 195 × 263 px；指針在 X 174 / Y 282；圖像 512 × 512 px，視圖縮放 183%，數值仍爲圖像像素。
適用場景與注意¶
適合：開發與設計覈對——對比截圖、檢查間距、量圖標或單像素細節。
隱私：全部在本地運行；僅讀取插件自身 config.json 與預覽已提供的圖像字節，不外傳數據、不訪問憑據。
生態說明：DSH 奉行「一切皆插件」；SkillHub 插件目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，不要當作官方應用商店。
結尾¶
dsh-image-scope 在不替換內置 Image 查看器的前提下，爲側欄預覽補上像素級讀數與單區域測量，並在任意縮放下保持圖像像素語義，適合日常 UI 覈對工作流。
