前言¶
DSH（DeepSeek Harness）的 Web 界面默認是乾淨的系統主題，若想在本地開發環境里加一層個人化的全屏背景，常見做法是改主題 CSS 或手動換資源文件，手機和電腦不在同一條鏈路上時尤其麻煩。插件 dsh-wechat-bg（維護者 XinpengWei）走另一條路：在 DSH 設置裏打開「背景圖」，用手機微信掃二維碼，從相冊選一張照片，電腦上的 DSH 會在幾秒內換上該背景，並支持圖庫、濃度滑桿、裁剪與顯示方式切換。下文按「是什麼 → 能做什麼 → 怎麼用 → 實現要點與注意」介紹，事實以 GitHub README 爲準。
這是什麼¶
dsh-wechat-bg 是面向 DSH Web 客戶端的社區插件（package.json 版本 1.1.0，許可證 MIT）。它解決的是：在不變更 DSH 核心的前提下，用局域網 + 微信掃碼，把手機相冊裏的圖片設爲 DSH 全屏背景，並在設置頁裏管理圖庫、透明度與裁剪。
插件歸屬社區生態：SkillHub 目錄頁與 GitHub 倉庫相互引用；DSH 本身秉承「一切皆插件」，社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
微信掃碼上傳¶
- 手機與電腦須連接同一 Wi-Fi。
- 插件在宿主機上除 DSH 本機監聽外，另起監聽
0.0.0.0的隨機端口服務，僅接受帶隨機 token 的/p/<token>路徑；二維碼由服務端用內聯 SVG 生成（qrcode-generator已 vendored 到vendor/，不依賴 CDN）。 - 照片在手機上先壓到長邊 2560 px 的 JPEG 再上傳，原圖不離開手機；上傳後保存在這臺電腦的
$DSH_HOME/wechat-bg/photos/，重啓 DSH 後仍生效。
設置頁「背景圖」¶
入口在 DSH 設置 → 背景圖（settings.section），不再佔用側邊欄底部或主界面其它位置。
瀏覽器側（client.js）通過 shell.overlay 注入全局樣式，把照片鋪在 html 上，並調節 --dsw-alias-bg-base 等主題 token，使會話區、側欄透出背景形成磨砂觀感；不寫 DOM、不操作 document.body、不用 iframe。
圖庫與刪除¶
傳過的照片留在「照片庫」：點縮略圖即可切換背景；懸停右上角 × 第一次進入待確認（紅色 !），再點一次才刪除。「移除背景」僅撤下當前顯示、恢復頁面原樣，圖庫文件仍保留。
索引寫在 $DSH_HOME/wechat-bg/library.json；裁剪結果以 <id>.crop.jpg 等形式寫入 $DSH_HOME/wechat-bg/，原圖文件保持不動。
濃度與顯示方式¶
兩根滑桿配置保存在瀏覽器本地，下次打開保留上次檔位：
- 背景濃度（默認 60%）：0 爲完全不透明（看不到照片），100 爲完全透明（照片原樣，含漸變處理）。
- 側欄濃度（默認 60%）：僅作用於左側導航，與背景濃度獨立。
顯示方式：「鋪滿」對應 background-size: cover；「完整」對應 background-size: contain，兩側留深色底。可在頁內「裁剪」裏用取景框調整構圖；取景框默認「窗口比例」，也可切爲「整張照片」並聯動顯示方式爲「完整」。
裁剪¶
裁剪界面展示手機上傳的整張原圖：滾輪或觸控板雙指縮放，拖動白色取景框；方向鍵微調（Shift 加大步長），或用「− / +」縮放，點「用框內區域」設爲新背景。每次從原圖重新裁，避免反覆裁切變糊；「用整張原圖」放棄本次裁剪。需重新上傳時可再掃碼。
同源 API¶
DSH 同源註冊路徑包括：/api/dsh-wechat-bg/{state,image,source,select,delete,clear,crop,rotate}，與手機頁、圖庫狀態協同。
安裝與啓用¶
已抓取資料中未給出獨立的 CLI 安裝命令行原文。添加插件時應通過你當前 DSH 版本文檔中認可的插件安裝方式，從 GitHub 倉庫 獲取源碼並覈對 package.json 中的 dsh.bundle.patch（cordis.patch.yml）與 dsh.client 注入項。
安裝前建議：插件以當前 dsh 進程權限運行，會監聽局域網端口並讀寫 $DSH_HOME/wechat-bg/；請自行審閱 index.js、client.js 等源碼及 MIT 許可證條款。
典型用法¶
按 README 可復現的完整流程如下：
- 確保手機和電腦在同一 Wi-Fi。
- 打開 DSH「設置」，左側點「背景圖」。
- 手機微信「掃一掃」，打開插件提供的上傳頁。
- 選照片，點「設爲 DSH 背景」；頁面約 2 秒內自動刷新，背景生效。
上傳後可按需調節「背景濃度」「側欄濃度」、切換「鋪滿 / 完整」、在圖庫中點選歷史照片，或使用「裁剪」精調構圖。
適用場景與注意¶
適合誰：長期在本地跑 DSH Web、希望用個人照片做全屏背景、且習慣用手機傳圖的開發者。
環境注意（來自 README「注意」一節）：
- macOS 首次運行可能彈出是否允許「DeepSeek Harness」接受傳入連接，須允許，否則手機無法打開上傳頁。
- 多網卡（VPN、虛擬網橋）時，插件優先選
192.168.*/10.*地址；若手機打不開，可在面板點「換一個二維碼」重試。 - 手機上傳頁由插件自管，與 DSH 登錄態無關；刷新二維碼會更換 token。
結尾¶
dsh-wechat-bg 把「手機選圖 → 局域網上傳 → Web 全屏背景 + 圖庫管理」收成設置裏的一頁流程，實現上分 Host（index.js）與瀏覽器（client.js）兩半，並遵循 DSH 主題 token 約束。
