搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

ZSeven-W/dsh-game-studio

游戏

用一句话描述小游戏,在 DeepSeek Harness 侧边栏里生成、试玩并导出单个 HTML 文件。

175
23
TypeScript
MIT
创建于 1 天前

项目介绍

DSH Game Studio 是 DeepSeek Harness 的插件:用自然语言描述一个小游戏,它基于 2D 俯视或 3D 体素(three.js)模板改出角色、规则和界面,并在对话旁的侧边栏里直接试玩,每次改动都会重新构建预览。

插件提供 10 个智能体工具,覆盖创建、构建、无头试玩、生成与应用美术、版本回滚、导出单文件 HTML,以及在本机局域网临时分享只读链接。侧边栏的「My games」会列出工作区里的游戏和最近一次试玩截图,还能把它们打包成一个离线游戏墙页面。

美术可以选择用 OpenAI 图片接口或本机已登录的 Codex CLI 按槽位生成候选图;不配置这两者时,游戏使用代码绘制的角色照常可玩。

安装与第一个游戏

前置条件:DeepSeek Harness 0.2.1 及以上(Web 或桌面版)、Node.js 24.11 及以上;无头试玩需要同一台电脑装有 Chrome 或 Edge。AI 美术还需要 OpenAI API Key 或已登录的 Codex CLI。

从 npm 安装到 DSH profile 并启动 Web 界面:

dsh plugin --profile web add @zseven-w/dsh-game-studio@latest
dsh web

在工作区目录打开会话,直接描述游戏,例如 Make a small game: a kitten steals dried fish in a kitchen without bumping into the robot vacuum. 智能体会创建项目、构建并显示在侧边栏,可以立即试玩。后续可以输入 Generate 2 new pieces of art for the hero with AI; I'll pick in the sidebar. 选择美术,或 Export it as a single HTML file. 导出。

每个游戏是一个普通文件夹:game.json 记录标题、美术风格、横竖屏、美术槽位和自由格式规则(以 window.GAME.rules 传给游戏);game.js 是可编辑的游戏代码,暴露 window.__gameState(),可选 window.__autoplay(state) 和 window.__renderSlots(size);assets/ 保存各槽位图片及来源记录 ASSETS.json;dist/index.html 是当前构建产物。

使用约束

OpenAI 图片生成按张计费到你的 API Key 上,生成前会弹出审批卡,显示服务、图片数量和预估费用;confirmSpending 默认开启。Codex 生图消耗 Codex 套餐额度,每张通常需要几分钟。imageProvider、openaiModel、openaiBaseUrl、confirmSpending 等选项在 profile 的 cordis.patch.yml 的 config 下配置。

游戏运行在禁止联网的沙箱 iframe 中,导出的 HTML 也不会发起网络请求;提示词和可选参考图会发送到你选择的图片服务。分享链接为只读、仅监听本地网络,并按设定时间过期(默认 30 分钟)。

对于不用方向键操作的游戏(网格、卡牌、瞄准、节奏等),需要定义 window.__autoplay 才能让试玩覆盖其真实玩法。作者给出的可玩率和耗时数据基于 DeepSeek-V4.1-Flash 下每类 10 个请求的样本,README 注明样本较小。开发流程为 npm ci、npm run build 和 npm test,找不到 Chrome 或 Edge 时相关测试会跳过。

HotRepo 点评

仓库创建于 2026-11-05,2026-11-06 进入 HotRepo 的 TypeScript 新项目榜:在 10:45 至 12:45 UTC 约两小时的统计窗口内净增 7 个 Star,总数达到 108。站内没有该项目在 GitHub 全部语言日榜上的名次记录,也没有 Hacker News 讨论,因此这更像是项目早期一次规模不大的真实增长,而不是持续趋势。

从技术上看,这个项目的价值在于产物可检查:一个带 JSON 规则、可编辑游戏代码和可替换资源的文件夹,加上能报告错误、帧率和截图的试玩流程,使它不只是提示词到演示的玩具。不过它依赖已有的 DSH 环境,AI 美术还依赖付费图片服务。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。