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 插件目录
