前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者根據需求擴展功能。Whiteboat-dsh 是 Whiteboat 生態在 DSH 平臺上的適配。它引入了“靜水面”作爲第一個功能切片，旨在提供一個在開始真實會話前可以暫停或輸入的空間，同時複用 Whiteboat 的核心視覺與交互能力。
是什麼¶
Whiteboat-dsh 是一個運行在 DSH 上的客戶端插件，由 Circleyan 維護，採用 MIT 許可證。它將 Whiteboat 的水面體驗集成到 DSH 環境中，使開發者可以在不立即發起 AI 調用的情況下，進行構思、觀察或準備。
核心功能¶
靜水面¶
靜水面是當前版本的核心功能。它提供了一個非品牌化的水面視圖，允許用戶在開始真實會話前進行暫停或輸入操作。僅觀看水面不會創建會話、提示詞、AI 調用或寫入任何數據。
視覺與交互¶
- 3D 小船與主題：3D 小船根據亮色 C / 暗色 E 主題渲染，夜間材質與 Obsidian 保持一致。
- 漣漪效果：發送想法時，會隨機扔下一塊石頭，並在編輯器中心產生圓形漣漪擴散。
- 複用能力：水面複用了 Whiteboat 的共享水域、小船、指針導航、手機漫遊、尾跡強度和天體投影。
音頻與生命週期¶
- 水面音效：包含柔和的離線水面錄音，聲音會隨小船移動漸弱。DSH 會記住靜音選擇。
- 原生保持：編輯器、工作區、預設、命令、權限、模型、推理級別、草稿和發送生命週期均保持 DSH 原生狀態。
安裝與啓用¶
安裝前請確保環境滿足要求：Node.js >= 20.19 與 pnpm。
直接將 GitHub Release 中的預構建包安裝到 DSH 的 web profile：
pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add https://github.com/Circleyan/whiteboat-dsh/releases/download/v0.1.2/whiteboat-dsh-0.1.2.tgz
安裝完成後，啓動 DSH：
pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 --profile web
典型用法¶
調整小船速度¶
在 DSH 設置的“白舟”頁面，可以調整“小船跟隨速度”。默認值爲 100%，可在 50% 到 200% 之間調整。修改後立即生效，用於指針跟隨、點擊或觸控目的地以及手機漫遊，設置會保存在 DSH 的設置文檔中。
靜音音效¶
使用右上角的揚聲器按鈕，或在 DSH 設置的“白舟 -> 水面 -> 水面音效”中關閉聲音。如果瀏覽器阻止自動播放，通過點擊、觸摸或按鍵可開始聲音。音頻歸屬在 AUDIO-LICENSE.md 中。
注意事項¶
- 數據安全：僅觀看水面不會創建會話、提示詞、AI 調用或寫入。打開編輯器最多準備一個空白會話，僅非空發送才接受提示詞。
- Canvas 限制：Obsidian 的漣漪是 Canvas 節點上下文，不會變成 DSH 節點視圖。此包不復制 Canvas 節點、邊或漣漪狀態。
- 權限與訪問：不涉及麥克風訪問。安裝預構建包的用戶不需要私有倉庫訪問權限，預構建包包含所需核心代碼，無私有子模塊的運行時依賴。
- 瀏覽器限制：如果瀏覽器阻止自動播放，需通過用戶交互（點擊、觸摸或按鍵）來開始聲音。
- 功能演進：未來功能在
src/features/或適配器中，複用whiteboat-core。功能對等不是自動的。
總結¶
Whiteboat-dsh 通過“靜水面”爲 DSH 提供了一個獨特的思考與準備空間，同時完整保留了 DSH 的原生工作流控制能力。對於需要在 AI 調用前進行環境設置或靈感捕捉的開發者，這是一個實用的工具。
- GitHub: https://github.com/Circleyan/whiteboat-dsh
- 目錄: https://www.skillhub.cn/plugins/Circleyan/whiteboat-dsh
