DeepSeek Harness（DSH）採用插件化架構，允許開發者擴展 WebUI 功能。在開發或使用過程中，有時需要一個輕量級、無依賴的滑塊拼圖功能來測試交互或提供娛樂。下面介紹 dsh-puzzle-plugin，一個專爲 DSH WebUI 設計的滑塊拼圖小遊戲插件。
這是一個集成在 DSH WebUI 中的滑塊拼圖小遊戲。它支持 2x2 到 6x6 的難度切換，具備步數和用時統計，並能通過 AI 工具進行實時交互。該插件由開發者 feverZHONG 維護，採用 MIT 許可證，零第三方依賴。
核心功能¶
- 遊戲機制：採用華容道式滑塊拼圖玩法，支持 2x2、3x3、4x4、5x5、6x6 五種網格尺寸切換。
- 交互與統計：提供新局開始、當前狀態預覽、步數統計和用時統計。拼圖完成後會觸發隨機臺詞的慶祝效果。
- AI 輔助工具：模型可通過以下工具與拼圖面板交互：
puzzle_talk：向面板發送文本提示或鼓勵。puzzle_state：查詢當前局信息（格數、步數、用時、完成狀態、當前圖、可用圖）。puzzle_set_image：更換拼圖圖片，支持指定圖庫名或直鏈 URL。
- 圖片管理：支持三種換圖方式。一是將圖片放入
$DSH_HOME/puzzles/目錄（支持 png/jpg/webp/gif），在設置頁點擊刷新；二是直接在面板或設置頁粘貼圖片 URL；三是通過對話指令puzzle_set_image。
安裝與啓用¶
插件代碼使用 MIT 許可證，文檔使用 CC BY 4.0（需署名）。安裝命令如下：
dsh plugin --profile web add dsh-puzzle-plugin-0.2.0.tgz
安裝後需重啓 WebUI 以加載插件。
典型用法¶
- 查看當前狀態：模型調用
puzzle_state查看當前拼圖的格數、步數、耗時及完成情況。 - 更換圖片：若需要更換拼圖底圖，可在對話中使用
puzzle_set_image命令指定本地文件名或網絡 URL。 - 打包插件：若需從源碼編譯，在項目目錄下運行打包命令：
pnpm pack --pack-destination <你的插件分發目錄>
適用場景與注意¶
- 配置與持久化：插件的配置會持久化保存至
$DSH_HOME/dsh-puzzle-config.json，包含當前圖和默認格數設置。它不依賴 Config schema，安裝後即生效。 - 開發與熱重載：插件代碼使用 MIT 許可證。修改
client/src/源碼後，必須運行node client/build.mjs重新生成client.js產物，刷新頁面即可生效；修改host/目錄下的代碼則需重啓 WebUI。 - 權限注意：插件以當前 DSH 進程權限運行，請確保源碼與許可證符合你的使用規範。
該插件適合需要在 DSH 環境中集成輕量級遊戲或測試面板交互的開發者。完整文檔與源碼位於：
* GitHub
* DSH 插件目錄
