dsh-bouncing-squares-example：演示 Granular Settings 作用域的示例插件

在開發 DeepSeek Harness (DSH) 插件時，理解不同設置作用域（Scope）的行爲差異是構建複雜配置界面的基礎。爲了直觀演示 session（會話）、workspace（工作區）和 global（全局）三種設置層級在上下文切換時的表現，開發者提供了一個可視化的示例插件。

插件定位¶

這是 DeepSeek Harness 的一個插件，同時也是 dsh-granular-settings 的示例項目。

維護者：joao-paulo-santos
分類：趣味換裝
定位：通過三個在屏幕上跳動的方塊，分別對應三種設置作用域，幫助開發者理解不同作用域下的設置行爲差異。

核心功能¶

該插件演示了以下能力：

作用域可視化：屏幕上顯示三個跳動方塊，分別由 session、workspace 和 global 作用域驅動。
設置類型覆蓋：演示了多種控件類型，包括開關、顏色選擇、文本、滑塊、數字、枚舉和多選。
代碼模式：
- 宿主端：使用 gs.register 調用註冊設置。
- 客戶端：使用 gs.useSetting 獲取設置並綁定到 UI。

安裝與啓用¶

安裝前需確認本地已有 DeepSeek Harness 的檢出代碼（checkout）以及一個配置好的 Profile（此處以 web 爲例）。

    mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
    git clone https://github.com/joao-paulo-santos/dsh-event-relay.git
    git clone https://github.com/joao-paulo-santos/dsh-granular-settings.git
    git clone https://github.com/joao-paulo-santos/dsh-bouncing-squares-example.git

    pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-event-relay
    pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-granular-settings
    pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-bouncing-squares-example

驗證配置：

    pnpm dsh --profile web --dump-config

重啓 Harness 後，控制面板中會出現 Granular Settings 選項，可以實時調整方塊的顏色、速度、大小等屬性。

典型用法¶

通過以下操作可以觀察不同作用域的行爲：

在同一工作區打開兩個會話，分別爲它們設置不同的 Session 顏色。此時每個會話的方塊顏色獨立，而工作區方塊顏色保持一致。
切換到另一個工作區，觀察 Session 和 Workspace 方塊跟隨上下文變化，而 Global 方塊保持不變。
關閉所有會話，此時屏幕上只剩 Global 方塊在跳動，證明全局設置在無會話上下文時依然存在。

注意事項¶

依賴要求：該插件依賴於 dsh-granular-settings 和 dsh-event-relay。
運行環境：這是一個示例插件，並非平臺核心組件。
權限與安全：插件以當前 DSH 進程的權限運行，安裝前建議查閱源碼與許可證。

總結¶

該插件是理解 DeepSeek Harness 設置作用域機制的最佳實踐參考。通過可視化的跳方塊效果，開發者可以直觀地驗證不同層級設置的生命週期和行爲，從而在開發自己的插件時做出正確的架構選擇。

項目主頁：GitHub
目錄頁：SkillHub