前言¶
在 DeepSeek Harness（DSH）里長時間調試智能體或對話時，界面背景往往是純色或靜態圖，和「海洋、生物、隨時間變化的光」這類氛圍很難兼得。社區插件 dsh-whalepaper 把一片實時演算的三維 ASCII 海洋嵌進宿主工作區：三頭虎鯨自主遊動，海面光色隨本地時間變化，聊天區保持透明，不拿遮罩擋正文。下面介紹它是什麼、能做什麼，以及如何安裝與配置。
這是什麼¶
dsh-whalepaper（倉庫 LeriusLei/dsh-whalepaper）由維護者 LeriusLei 發佈，在 SkillHub 社區目錄中歸類爲趣味換裝。當前包版本 0.6.0，許可證 MIT。它不是預錄視頻，而是由壁紙渲染器在 1440×810 畫布上連續繪製的 ASCII 海洋；虎鯨會跳水、翻滾、潛水、換氣噴水，並偶爾追趕會逃離的小魚。插件以 DSH 插件形式運行，安裝後隨 profile 加載客戶端 bundle 與 Cordis patch，獨立、離線可用構建資源，安裝時無需在本地編譯。
核心功能¶
一天裏的海¶
同一片海在一天中有八個時段光色：深夜、凌晨、日出、正午、下午、黃昏、晚霞、傍晚；也可按設備當地時間平滑過渡。README 中提供了各時段預覽圖（wallpaper/previews/）。
構圖與行爲¶
海天構圖可選三種水上空間比例：28%、33%、38.2%。正常模式以巡遊、滑行、近海牀深潛和覓食爲主；躍出是較少發生的背景事件，落水帶冠狀飛濺、泡沫、漣漪與水下氣泡；換氣從露出水面的呼吸孔開始，僅部分換氣有可見霧氣。
原生插件設置（0.6.0）¶
從 0.6.0 起，設置接入 DSH 「設置 → 插件 → 配置 dsh-whalepaper」。插件通過 Config schema 聲明 8 個字段（均爲 .volatile()），宿主據此生成表單；寫入經當前 profile 的 Cordis patch 持久化並熱應用，刷新或重啓後保留。可調整項包括：海洋時刻、海天構圖、亮度、飽和度、柔化、安靜遊動、暫停、顯示壁紙，以及恢復默認。
README 確認的默認值爲：水上 33%、亮度 97%、飽和度 111%、柔化 0.3px，安靜遊動與顯示壁紙開啓，暫停關閉。完整默認值見倉庫內 default-settings.json。
0.6.0 移除了「閱讀方案 preset」與「正文保護 glass」兩個舊開關：正文固定直顯無遮罩；舊配置裏對應字段會被忽略。插件仍保留右下角 ≈ 快速麪板，與原生設置頁共用同一份狀態；每個控件只寫自身字段。
側欄玻璃態（0.6.0）¶
啓用壁紙後，左側導航欄可隨壁紙呈現玻璃態：原生側欄與標題行通過 --dsw-specific-sidebar-fill 保持透明；對自帶側欄表面的第三方插件（例如 @michengai/dsh-codex-ui 的 .dcu-root）會自動啓用 data-we-sidebar-glass 並注入 --we-sidebar-* 參數。關閉壁紙或卸載插件時會恢復原樣式。若左欄仍不透明，可能是其他背景/皮膚插件同時繪製側欄，可先單獨啓用本壁紙對比。
預覽與宿主適配¶
構建資源中的 wallpaper/harness.html 提供單一深海色、無遮蓋的聊天預覽，使用同一份客戶端適配器，僅本地示例、不連接真實會話。有不透明頂部欄時，宿主可設置 CSS 變量 --orca-top-inset 爲實際佔用高度，背景畫布會避開該欄。默認不爲正文和輸入區添加遮蓋，濾鏡僅作用於背景。
若宿主未顯示「配置」卡片，說明客戶端 plugins.bundle.config 卡片未註冊成功，可回退 ≈ 面板，並在插件管理頁檢查客戶端 bundle 是否加載。
安裝與啓用¶
帶完整構建資源，無需本地構建。收錄進 DSH 插件市場後，可在 「設置 → 插件市場」 安裝；也可從 GitHub 倉庫安裝（將 <owner> 換成倉庫屬主 LeriusLei）：
dsh plugin --profile <實際使用的profile> add github:<owner>/dsh-whalepaper
或下載 Release 中的 dsh-whalepaper.tgz 後本地安裝：
dsh plugin --profile <實際使用的profile> add "<tgz 的絕對路徑>"
重啓是否需要由該 profile 的 HMR 設置決定。啓用後，正式配置入口爲 「設置 → 插件 → 配置」；右下角 ≈ 可快速調整光色、構圖、顯示與暫停。插件停用會撤回本包節點、樣式、監聽器並釋放 iframe。
注意： 插件在當前 DSH 進程權限下運行，安裝前應自行查看倉庫源碼與 MIT 許可證，確認可接受後再安裝。
典型用法¶
- 用上述命令爲實際 profile 安裝並啓用插件。
- 打開 「設置 → 插件 → 配置 dsh-whalepaper」，按需要改海洋時刻、海天構圖、亮度、飽和度、柔化、安靜遊動、暫停與顯示壁紙；或點擊右下角
≈做同樣調整。 - 需要驗證渲染與適配時，可在倉庫構建資源中打開
wallpaper/harness.html做本地預覽（默認值與default-settings.json一致）。 - 若與多個背景類插件疊用導致側欄或頂欄異常，建議先單獨啓用本壁紙，再逐步疊加其他插件。
宿主表單可用時設置寫入 profile（原生模式）；預覽頁等無宿主表單的環境回退本地存儲，刷新後均保留。
適用場景與注意¶
適合希望在 DSH 桌面裏獲得低干擾、可配置、隨本地時間變化的 ASCII 海洋背景、又需要聊天工作區保持可讀的用戶。README 說明 0.6.0 曾在 DSH 桌面 0.2.0-rc.2 本地 profile 實裝驗證過靜態路由與 boot 組合；不同宿主版本或其他主題插件可能需要自行調整表面透明度。倉庫要求 Node >= 20，peer 依賴 @deepseek-ai/schemastery ^3.18.4。
社區目錄頁：skillhub.cn/plugins/LeriusLei/dsh-whalepaper（獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）。GitHub 倉庫當前公開 1 star，屬早期社區插件體量。
結尾¶
dsh-whalepaper 把實時 ASCII 虎鯨生態、八時段海洋光色和 DSH 原生插件設置、側欄玻璃態收進一個 MIT 壁紙插件；安裝命令以 README 爲準，配置以 default-settings.json 與設置頁爲準。需要進一步細節時可查閱倉庫 README 與 docs/DSH-HANDOFF.md。
