下面介绍 DeepSeek Harness (DSH) Web 插件生态中的 dsh-free-games。在 Web 框架开发中,除了配置项和工具栏,有时需要集成娱乐入口。该插件通过在侧边栏底部添加一个“Games”按钮,解决了这一需求。
这是什么¶
dsh-free-games 是一个由 Entaum 维护的独立社区插件。它不是 DeepSeek 或 Spawnd 的官方产品,但提供了类似官方体验的界面。该插件的作用是在 Web GUI 的侧边栏中,展示 Spawnd.gg 平台上的已发布游戏柜。
安装与启用¶
安装插件前,请确保当前环境支持 Web 服务器和 Client 槽位。安装命令如下:
dsh plugin --profile web add github:Entaum/dsh-free-games
安装完成后,重启 dsh web,然后刷新 GUI。你会在侧边栏底部看到新增的“Games”按钮,它位于“Settings”按钮上方。
核心功能¶
-
侧边栏控制
插件在sidebar.footer.action中添加了 Games 控制,层级顺序为 80,位于 Settings 之前,样式与 Settings 保持一致。 -
游戏柜展示
展示data/spawnd_game_list.json中的已发布游戏列表。封面和悬停片段的数据通过实时 Spawnd 数据填充,主机端会缓存这些覆盖层,频率约为每 15 分钟一次。 -
排序与搜索
支持按游戏名称搜索。排序方式包括:- Newest(默认):按
published_at排序。 - Name:按名称字母排序。
- Recently played:按最近游玩时间排序。
- Newest(默认):按
-
播放与嵌入
点击游戏封面会打开 16:9 的嵌入播放器。最小化操作会保持 iframe 挂载状态(仅在窄屏设备上隐藏播放器,点击 Games 可恢复)。
导航方面,点击 Spawnd logo 可返回上一页,点击 Next 会随机选择另一款已发布游戏。 -
链接追踪
所有跳转到 Spawnd 的外部链接都会附带utm_source=deepseekplugin参数,并添加rel="noopener noreferrer"属性以保证安全性。
注意事项¶
- 仅限 Spawnd.gg:插件严格限制数据源。页面和嵌入 URL 必须是
https://www.spawnd.gg/或https://spawnd.gg/,封面和片段 URL 必须来自https://assets.spawnd.gg/。拒绝任何非 Spawnd 的 URL。 - 无额外配置:插件不需要额外的配置文件。
- 数据存储:最近游玩的游戏 ID 仅存储在浏览器的
localStorage中,键名为dsh-free-games:recent。 - 第三方代码:游戏 iframe 内部运行的是第三方的 Spawnd 代码,这属于正常行为。
- 兼容性要求:建议在 DeepSeek Harness Web
0.1.0-rc或更高版本(测试过0.1.1-rc.2)以及@deepseek-ai/cordis^4.0.1环境下使用。
总结¶
dsh-free-games 提供了一个轻量级的娱乐入口,符合 DSH “一切皆插件”的理念。它完全依赖 Spawnd.gg 的数据,不涉及复杂的本地配置,适合需要在 Web 界面中快速集成游戏功能的场景。
更多详情请参考项目源码:https://github.com/Entaum/dsh-free-games