前言¶
DeepSeek Harness (DSH) 的插件生態強調模塊化擴展。dsh-dream-skin 插件提供了全屏鋪滿的壁紙顯示能力，默認將背景定位在屏幕中心（background-position: center）。當壁紙構圖偏左或偏上時，會遮擋聊天區域，而原插件未提供位置微調功能。dsh-wallpaper-position 旨在解決這一痛點，通過在設置中增加 X/Y 像素位移控制，並按壁紙內容進行記憶，讓用戶可以針對不同圖片單獨調整顯示位置。
插件簡介¶
這是一個爲 dsh-dream-skin 設計的衛星插件。它利用 CSS 變量在純前端層面實現壁紙位移，不修改 dream-skin 的核心文件。插件通過讀取壁紙內容的哈希值來匹配對應的位移記錄，確保換圖時自動恢復上次的調整。項目採用 MIT 協議，由 ArimaKana-Akane 維護。
核心功能¶
- 設置項註冊：在
設置 → 外觀中註冊專門的壁紙位移設置行。 - 像素級微調：提供 X/Y 兩個方向的位移設置，步進 1px，有效範圍 ±5000px。界面包含
−10 / −1 / +1 / +10的快捷按鈕以及“恢復默認位置”功能。 - 按圖記憶：系統會根據當前壁紙的內容哈希（區分 image/url/gradient 類型）存儲位移值。更換壁紙後，會自動加載該圖片對應的記憶值。
- 純前端實現：通過注入 CSS 規則修改
background-position，無需後端支持或重啓 DSH 進程。 - 依賴關係：必須依賴
dsh-dream-skin插件才能工作。
安裝與啓用¶
使用 DSH 內置的插件命令安裝：
dsh plugin --profile web add dsh-wallpaper-position
安裝完成後，重啓 dsh-web-profiled 服務即可生效。
使用步驟¶
- 在
dsh-dream-skin中選擇一張壁紙。 - 進入
設置 → 外觀，滾動到頁面底部找到「壁紙位移（僅對當前這張圖生效）」選項。 - 使用微調按鈕（
−10/−1/+1/+10）或直接輸入數值調整 X/Y 軸位置（X 向右爲正，Y 向下爲正）。 - 切換到其他壁紙，新的壁紙會自動應用其記憶的位移值。
- 點擊「恢復默認位置」可將當前圖片的位移重置爲 0。
依賴與限制¶
- Vibe coding 產物：代碼由 AI 生成並迭代，未經人工逐行審計。請勿將其直接用於生產環境或涉及敏感信息的場景。
- 硬依賴與兼容性：必須安裝
dsh-dream-skin。如果上游修改了壁紙層的 DOM 結構或localStorage鍵名，本插件可能會靜默失效（不報錯，但功能不工作）。 - Host 半限制：Host 半必須導出一個空的
apply()函數，否則會導致 DSH 插件加載失敗，進而引發整個 DSH 進程啓動失敗。 - 功能範圍：僅支持位移，不支持縮放、旋轉或鼠標拖拽。
- 潛在衝突：選擇器會匹配
body下所有position:fixed且帶有background-image的元素。如果同時安裝了其他背景插件，位移設置可能會影響這些插件的背景層。 - 環境要求：需要 Node.js 版本 >= 20。
目錄與源碼¶
- 目錄頁：https://www.skillhub.cn/plugins/ArimaKana-Akane/dsh-wallpaper-position
- 源碼倉庫：https://github.com/ArimaKana-Akane/dsh-wallpaper-position
