前言¶
用 DeepSeek Harness(DSH)跑智能體時,Web 界面往往就是長時間盯着的「工作臺」:功能夠用,但視覺千篇一律。社區裏有人做任務看板、有人做成本統計,也有人專門在「好看」這件事上發力——把聊天窗口背後換成即時渲染的海面,對話時波浪起伏、日光流轉,Harness 立刻有了辨識度。
今天要介紹的是維護者 d-dev0101 開源的 Open Sea Skin(倉庫名 open-sea-skin)。它在 SkillHub 插件庫 中歸類爲「趣味換裝」,GitHub 上截至覈實已有約 188 顆星。插件用 WebGPU 在 Harness 背後繪製五組 Gerstner 波浪海面,並保留半透明玻璃 UI,不擋操作,只換氛圍。
需要說明的是:DSH 的核心理念是「一切皆插件」,SkillHub 等社區目錄由愛好者維護,與 DeepSeek / 幻方並無官方從屬關係;安裝任何插件前,建議自行閱讀源碼與許可證。
這是什麼¶
Open Sea Skin 是一套面向 DeepSeek Harness 的自包含 WebGPU 海洋皮膚方案。它保留原版五波 Gerstner/TSL 海面視覺,疊加半透明 Harness 主題,並提供四種接入方式:
- DSH 插件(官方 README 推薦,一行命令安裝)
- 僅作用於 Harness 的 Chrome / Edge 擴展
- 無需編譯源碼的 靜態 dist 安裝腳本
- 寫入 Harness 源碼樹的 原生集成(設置項出現在「通用設置」裏)
一句話定位:讓本地運行的 dsh web 界面背後出現可交互、可調的即時海洋,而不是靜態壁紙。
核心功能與亮點¶
根據 GitHub 倉庫 與中文 README 的說明,已覈實的主要能力如下。
渲染與視覺
- 基於 WebGPU + three.js 0.178.0 + TSL,五組 Gerstner 波、解析法線、FBM 細節、Fresnel 天空反射、太陽閃爍、浪尖泡沫、地平線霧、天空雲帶,以及 bloom 與 ACES 色調映射。
- 默認 40% 玻璃不透明度,Harness 三欄佈局保持可用;超寬窗口下設置對話框會疊在輸入框之上,海洋始終位於界面之後。
交互與控制
- 左下角 「皮膚設置」 快捷入口,可調波浪大小、日光、玻璃不透明度,以及 12 分鐘自動晝夜循環(手動拖動日光會固定當前時間,可再開啓自動循環)。
- 中英雙語 UI,支持鍵盤焦點循環、Esc 關閉、
prefers-reduced-motion降級。
性能與隱私
- 資源全部本地化:three.js 與 Geist 字體已 vendored,擴展與安裝器 不請求 CDN、不含分析遙測。
- 256×256 網格(低端/減少動態模式 160×160),DPR 上限 1.5,自適應分辨率 0.5–1.0,60/30/20 FPS 檔位,標籤頁隱藏時暫停渲染。
- 擴展僅申請
storage與127.0.0.1/localhost權限;項目聲明 不收集、不上傳任何數據。源碼採用 MIT 許可證。
多種安裝路徑
- 普通 DSH 用戶優先用插件命令;不想動
dsh plugin可用瀏覽器擴展或curl | bash靜態安裝;需要設置頁原生入口的開發者再走源碼集成。各路徑有重複渲染防護,但 README 建議 只選一種,便於更新與卸載。
安裝與啓用¶
推薦:DSH 插件方式¶
在已安裝 DeepSeek Harness CLI 的環境中執行(安裝命令以倉庫 README 爲準):
dsh plugin --profile web add 'github:d-dev0101/open-sea-skin#v1.2.1'
然後重啓 Web 服務:
dsh web
該包在 DeepSeek Harness 0.1.0-rc.6 上實測通過。安裝完成後,瀏覽器打開 Harness 頁面,背景應出現海洋皮膚;左下角可見 Skin settings / 皮膚設置 按鈕。
卸載命令:
dsh plugin --profile web remove open-sea-skin
若需固定某一版本,可在 add 時帶上 release tag(如上文的 #v1.2.1);更新時重新執行帶新 tag 的 add 即可。
驗證是否加載成功¶
DSH 插件安裝指南 建議確認 profile 中出現 open-sea-skin 行,且以下同源 URL 返回 HTTP 200:
/plugins/open-sea-skin/client.js
/open-sea-skin/skin.html
/open-sea-skin/styles.css
/open-sea-skin/ocean.js
若按鈕未出現,先確認 dsh plugin add 使用的 --profile web 與當前 dsh web 一致,重啓 Web 進程後再刷新頁面。
其他安裝方式(按需選用)¶
Chrome / Edge 擴展:下載 Release 中的 open-sea-skin-extension-*.zip 或克隆倉庫,在 chrome://extensions 開啓開發者模式後加載 extension/ 目錄,再訪問本機 Harness 並刷新。擴展會校驗頁面標題與 Harness 啓動標記,避免誤改其他本地站點。
靜態 dist 注入(無需編譯 Harness 源碼):
curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash
執行前需停止 Harness;完成後重新 dsh web 並保持終端進程運行,再刷新瀏覽器。Harness 升級後應加 --update 重跑;卸載用 --uninstall。
原生源碼集成(控制項進入「設置 → 通用設置」):
git clone https://github.com/deepseek-ai/deepseek-harness.git
bash harness-plugin/install-into-harness.sh /絕對路徑/deepseek-harness
cd /絕對路徑/deepseek-harness
corepack pnpm install
corepack pnpm run build
corepack pnpm dsh web
該路徑針對 Harness 特定提交做過錨點校驗(README 記載爲 47f943859bef),上游結構變化時安裝腳本會主動停止,避免盲目改文件。
典型用法示例¶
完成 DSH 插件安裝並重啓 dsh web 後,日常調節可以全部在界面完成:
- 打開本機 Harness(通常爲
http://127.0.0.1或http://localhost對應端口)。 - 點擊左下角 皮膚設置,調整 波浪大小(README 示例基準值爲 56)、日光(如「下午 55」)、玻璃不透明度(動圖統一以 40% 展示)。
- 需要氛圍變化時開啓 自動晝夜循環;若手動拖動日光滑塊,循環會暫停,直到再次啓用自動模式。
- 想恢復默認外觀時執行
dsh plugin --profile web remove open-sea-skin;瀏覽器裏殘留的ossEnabled、ossSea等 localStorage 鍵可選手動清理。
倉庫 README 提供了深色/淺色 Harness 全景、調波浪、從正午到黃昏等 GIF 演示,也可訪問 交互式展示站 預覽效果。
適用場景與注意事項¶
適合誰用
- 長期在本地跑
dsh web、希望工作臺有點「活」的視覺反饋的開發者。 - 做 Harness 主題/插件生態探索、需要參考 WebGPU 皮膚接入方式的貢獻者。
- 接受適度 GPU 佔用、且瀏覽器支持 WebGPU 的環境(README 面向 Chrome/Edge 場景設計)。
注意事項
- 插件與 DSH 進程權限一致,安裝前應閱讀 GitHub 源碼 與 MIT 許可證,確認可接受其文件注入與本地存儲行爲。
- 不要混用多種安裝路徑(插件 + 擴展 + 靜態注入同時存在),雖有重複渲染防護,但更新和排障會複雜得多。
- 靜態安裝或卸載後若頁面提示 Failed to load plugins,先確認
dsh web是否仍在運行——安裝器只改前端文件,不會替你維持服務進程。 - 若需要控制項嵌入 Harness 原生「通用設置」頁,應選源碼集成;僅換背景、快速嚐鮮則 DSH 插件方式最簡單。
- WebGPU 即時渲染對顯卡與驅動有一定要求;低端設備會自動降檔,也可依賴
prefers-reduced-motion走簡化模式。
結尾¶
Open Sea Skin 把 DeepSeek Harness 從「純工具界面」拉向「可定製的沉浸式工作臺」:一行 dsh plugin 命令就能在聊天窗口背後鋪開即時海面,左下角隨時調波浪與日光。對注重本地隱私的用戶來說,全程無 CDN、無遙測的設計也比較乾淨。
- 插件目錄頁:https://www.skillhub.cn/plugins/d-dev0101/open-sea-skin
- GitHub 倉庫:https://github.com/d-dev0101/open-sea-skin
- DSH 安裝與排障:docs/dsh-plugin.md
如果你已經在用 DSH 裝了一堆實用插件,不妨再加這一個「趣味換裝」——寫代碼累了抬頭看一眼海,也許比換主題色更解壓。