dsh-free-games：DeepSeek Harness Web 的遊戲櫃

下面介紹 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：按最近遊玩時間排序。
播放與嵌入
點擊遊戲封面會打開 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 界面中快速集成遊戲功能的場景。