前言¶

在使用 DeepSeek Harness (DSH) 進行開發或調試時，等待模型生成結果往往是耗時最長的環節。此時若只是盯着進度條，容易產生視覺疲勞。DSH 的設計理念是“一切皆插件”，社區成員可以在此框架下擴展功能。HDNRAY 提供的 dsh-plugin-colorguess 正是針對這一場景：不離開當前會話界面，不切換應用，在等待推理完成時進行即時娛樂。

插件定位¶

這是一個由社區成員 HDNRAY 獨立開發和維護的娛樂類插件（MIT 許可證）。它不包含遊戲代碼，而是作爲宿主端，在會話頭部渲染一個“ColorGuess”按鈕。點擊後，通過 iframe 嵌入 GitHub Pages 上託管的遊戲頁面，並提供懸浮窗交互。

核心功能¶

1. 可拖動的懸浮窗：支持通過拖動標題欄移動窗口；左下角和右下角有兩個縮放手柄；使用 ✕ 或 Esc 鍵關閉窗口。
2. 主題同步：遊戲界面的配色會跟隨 DSH 的亮/暗主題。插件通過 postMessage 協議向遊戲頁面發送 { source: 'colorguess-dsh', theme } 消息。
3. 無痕交互：懸浮窗關閉後不會在會話區域留下任何痕跡或殘留元素。

安裝與啓用¶

安裝插件需使用 web profile，通過 git 倉庫安裝：

dsh plugin --profile web add github:HDNRAY/dsh-plugin-colorguess

安裝完成後，重啓 dsh web。在會話頭部（聊天頁右上角操作區）會出現 ColorGuess 按鈕，點擊即可打開懸浮窗。

典型用法¶

在等待模型出結果時，點擊 ColorGuess 按鈕。此時可以玩一局“混色三選一”遊戲。窗口會自動跟隨 DSH 的當前亮/暗主題進行配色。

適用場景與注意事項¶

• 運行環境：插件僅支持 web 平臺（瀏覽器端），無小程序或原生端實現。需要在 DSH 版本 0.1.2-alpha.2 上運行。
• 網絡要求：遊戲頁面託管在 GitHub Pages，必須聯網才能加載。
• 權限與隱私：插件不申請任何特殊權限，不讀寫本地文件、不訪問會話內容、不注入或修改 prompt。
• 匿名統計：遊戲頁面包含匿名訪問統計（Umami），僅記錄頁面訪問與遊戲內事件（開始、作答、結束等），不使用 Cookie 做跨站追蹤，不採集賬號或會話內容。

總結¶

該插件通過簡單的懸浮窗交互，解決了等待模型輸出時的枯燥問題，同時保持了極低的權限侵入性。更多細節可查閱社區目錄或源碼倉庫。