前言¶
在 DeepSeek Harness(DSH)裏讓 Agent 跑長任務時,主工作區往往長時間停在會話或進度界面。等待期間如果只能盯着日誌,體驗比較單調。DSH Game Market 是維護者 heswy 發佈的工作流類插件:把主工作區交給小遊戲,右下角用「小鯨魚」同步 Agent 狀態,任務完成或需要你介入時再提醒,且不強制打斷當前一局。下面介紹它是什麼、能做什麼,以及如何安裝與典型用法。
這是什麼¶
插件倉庫爲 heswy/dsh-game-market,在 SkillHub 目錄分類爲「工作流」。README 中的定位是:DeepSeek Harness 裏的遊戲市場與運行時(Game marketplace and runtime for DeepSeek Harness)。當前發佈版本爲 v1.5.6(2026-11-02),許可證 MIT,要求 DSH >=0.2.0 <0.3.0、Node >= 20。
社區遊戲目錄獨立於插件本體,內容倉庫爲 heswy/dsh-game-registry;與 DeepSeek / 幻方無官方從屬關係,不宜理解爲官方應用商店。
核心功能¶
主工作區與 Agent 並行¶
Agent 執行長任務時,遊戲可以佔滿 DSH 主工作區。頂部提供返回、暫停;暫停菜單支持繼續、保存並返回工作。從會話切迴游戲時,進度停在離開時的狀態。
小鯨魚與狀態¶
右下角小鯨魚反映 Agent 狀態,例如:運行中(可繼續上一局或選遊戲)、等你(提示處理審批或提問)、完成(任務完成提醒,不暫停遊戲)、出錯(提示回會話查看原因)。會話 tab 行還有「等你 / 完成 / 出錯 / 已暫停」等狀態 pill。
內置遊戲與市場¶
插件打包 5 款內置遊戲,安裝後即列出,均帶「內置」徽標:
| 遊戲 | 類型 | 玩法概要 |
|---|---|---|
| Snake | 街機 | 方向鍵或 WASD,喫食物、避自身 |
| 軌道信使 Orbit Courier | 街機 | 三條軌道間穿梭收發貨,約 120 秒一局 |
| 2048 | 益智 | 4×4 滑動合併,每局一次撤銷 |
| Jump | 街機 | 縱向平臺跳躍 |
| Breakout | 街機 | 擋板反彈球,5 關 |
市場還支持首頁、我的遊戲、詳情、搜索、分類;官方目錄另收錄社區遊戲(資料中示例爲 Little Leviathan,用於驗證投稿審覈鏈路)。可從本地安裝 .html 或 .dshgame.zip。
存檔、分數與問答¶
進度在暫停、切後臺、離開遊戲或 Agent 等待時自動保存;關閉 DSH 再打開可 Continue。每款遊戲 manifest 僅可使用 storage 與 score,配額爲 32 個鍵、單值 256 KiB、單遊戲 1 MiB。進度可導出 JSON 後在另一臺機器導入。
遊戲結束時提交分數,最高分與歷史在「我的遊戲」中查看。Agent 提出普通問題時,遊戲暫停並在畫面上方展示問題面板;危險工具授權仍走 DSH 原生審批,不在遊戲內處理。
平臺更新與安全¶
設置中的「版本與更新」展示 Host / Client 版本與發佈通道;更新時會暫停並保存正在運行的遊戲,由 DSH 插件管理器按官方索引安裝,雙端覈驗一致後完成。
遊戲運行在 sandbox iframe 中,入口 CSP 爲 default-src 'none'、connect-src 'none' 等,不能發起網絡請求,也讀不到 DSH 頁面數據。本地安裝未校驗來源的包時,只應安裝你信任的文件。
安裝與啓用¶
官方 README 給出的步驟如下:
- 側欄「插件」→「添加插件」,填入倉庫地址:
https://github.com/heswy/dsh-game-market
- 裝完後重啓 DSH。
- 側欄出現「遊戲市場」。
安裝的是最新發布版(資料中當前爲 1.5.6)。若從市場安裝社區遊戲時出現 GM-5035(下載超時),可點「重試」;插件會自動重試 2 次,多爲到 GitHub 的連接超時而非包損壞。
典型用法¶
玩家側¶
從側欄進入「遊戲市場」,選一款內置或社區遊戲開始;Agent 在後臺跑任務時,通過右下角鯨魚留意狀態。需要處理 Agent 提問時在遊戲內作答;需要批准危險操作時回到 DSH 會話。
開發者側(SDK 與 CLI)¶
遊戲開發者可使用 SDK v1 與 dsh-game CLI。SDK 握手與存檔示例(摘自 README):
const game = DSH_GAME_SDK.createGameSDK();
game.lifecycle.on('before-save', () => saveNow());
const info = await game.ready();
const saved = await game.storage.load('current');
await game.session.start();
await game.score.submit(score);
await game.session.end({ outcome: 'completed', score });
本地工程常用命令:
dsh-game create my-game --template vanilla
cd my-game
npm run build && npm run validate && npm run pack
npm run dev
npm run dev 啓動本地 Runtime Simulator,無需真實 Agent。社區投稿需按倉庫內投稿指南準備包與 submission.json,在 dsh-game-registry 使用 Issue Form 或 PR 提交,維護者校驗通過後合併目錄。
更完整的 manifest、安全區與發佈說明見倉庫內 docs/developer-guide.md、docs/developer-cli.md。
適用場景與注意¶
適合誰: 經常在 DSH 裏跑長 Agent 任務、希望在同一界面內消磨等待時間的使用者;以及希望把 HTML 小遊戲上架到 DSH 生態的開發者。
安裝前注意: 插件隨 DSH 插件機制加載,以當前 DSH 進程權限運行。安裝前應閱讀倉庫源碼與 MIT 許可證,確認符合你的安全策略。社區目錄與插件本體分屬不同 GitHub 倉庫,更新與審覈流程以各倉庫文檔爲準。
路線圖明確暫不做多人聯網、賬號、付費、雲排行榜與雲存檔同步;遊戲內也不處理危險操作審批。
結尾¶
DSH Game Market 把「等待 Agent」變成可在主工作區進行的遊戲體驗,並用小鯨魚與存檔把任務狀態和遊戲進度綁在一起。開發者還可通過 SDK、CLI 與獨立內容倉庫擴展社區遊戲。