Open Sea Skin:給 DeepSeek Harness 換上 WebGPU 即時海洋皮膚

前言

用 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 主題,並提供四種接入方式:

  1. DSH 插件(官方 README 推薦,一行命令安裝)
  2. 僅作用於 Harness 的 Chrome / Edge 擴展
  3. 無需編譯源碼的 靜態 dist 安裝腳本
  4. 寫入 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 檔位,標籤頁隱藏時暫停渲染。
  • 擴展僅申請 storage127.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 後,日常調節可以全部在界面完成:

  1. 打開本機 Harness(通常爲 http://127.0.0.1http://localhost 對應端口)。
  2. 點擊左下角 皮膚設置,調整 波浪大小(README 示例基準值爲 56)、日光(如「下午 55」)、玻璃不透明度(動圖統一以 40% 展示)。
  3. 需要氛圍變化時開啓 自動晝夜循環;若手動拖動日光滑塊,循環會暫停,直到再次啓用自動模式。
  4. 想恢復默認外觀時執行 dsh plugin --profile web remove open-sea-skin;瀏覽器裏殘留的 ossEnabledossSea 等 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、無遙測的設計也比較乾淨。

如果你已經在用 DSH 裝了一堆實用插件,不妨再加這一個「趣味換裝」——寫代碼累了抬頭看一眼海,也許比換主題色更解壓。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜