dsh-godot-play
在 DeepSeek Harness Web GUI 里一键构建并试玩多个 Godot Web 导出的插件，装完即用、零外部进程。
- 浏览器半区：右下角浮动「▶ 试玩游戏」面板，内含「项目」下拉（多项目切换）、
「🔄 构建并加载」按钮、状态芯片与构建日志；
- 宿主（Node）半区：注入
webServer / subprocess / webRuntime / workspaceRegistry
四个宿主服务，直接以 ctx.subprocess.spawn 运行 godot --headless --export-release，
并把当前项目的 web/ 导出以同源前缀路由静态托管（响应带 cross-origin isolation 头）。
不需要 python、不需要独立端口、不需要任何常驻 sidecar。架构参照社区同构插件
dsh-web-shell 的宿主半区模式。
特性
- 多项目：面板下拉列出
workspaceRegistry 里的 Godot 项目（自动过滤含 project.godot 的目录），可「＋」手动登记其它目录；
- 目标优先级：config
projectRoot（锁定）> 上次选择（持久化到 ~/.dsh/dsh-godot-play.json）> 最新创建的 Godot 工作区 > 从 dsh 工作目录向上找 project.godot > 工作目录本身；
- 随手控制：「↻ 重新启动」带缓存戳重载当前游戏 iframe（不重新构建）；「清空日志」把宿主内存尾环与屏幕显示一起清掉（构建进行中也可清，新输出照常追加）；
- 纯 DOM，零框架依赖；iframe 懒加载；构建日志尾环；幂等安装/卸载脚本。
前置（用户责任）
- 本机安装 Godot，且装好 Web 导出模板；
- 目标 Godot 项目里存在 Web 导出预设（编辑器：项目 → 导出 → 添加… → Web，并保存）。
插件自动跟随该预设的
export_path 目录（取其在 export_presets.cfg 里声明的输出目录，
写入 index.html），不再要求与 webRel 手工对齐；也可用 config.webRel 显式覆盖
（默认兜底 <项目>/web）。
安装
# 推荐：官方插件 CLI（npm 发布后）
dsh plugin --profile web add dsh-godot-play
# 本地开发：直接指向仓库目录
dsh plugin --profile web add /path/to/dsh-godot-play
# 或手动装入（等价动作，见 install.sh）
bash install.sh # 默认 profile ~/.dsh/profiles/web
装完重启 dsh web 生效（会话有持久化，可恢复）。
使用
- GUI 右下角「▶ 试玩游戏」打开面板；
- 需要的话在「项目」下拉切换目标（或点「＋」登记新项目目录）；
- 点「🔄 构建并加载」：状态芯片显示进度，展开「日志」看 Godot 输出；
- 成功后 iframe 自动带缓存戳重载，直接试玩；下次打开自动记住上次选的项目；
- 想重新开始当前游戏点「↻ 重新启动」（只重载游戏，不重新构建）；点「清空日志」清掉构建日志（构建中也可清）。
宿主接口（同源路由）
| 路由 | 方法 | 用途 |
|---|
/api/godot-play/workspaces | GET | Godot 项目候选列表（来自 workspaceRegistry，含 current/pinned） |
/api/godot-play/workspaces/add | POST | 登记一个项目目录（{path}，须含 project.godot） |
/api/godot-play/target | POST | 切换目标项目（{path}；config 锁定时返回 400） |
/api/godot-play/build | POST | 对当前目标触发构建（单飞，构建中返回 409） |
/api/godot-play/status | GET | 状态 + 日志尾环（轮询即进度） |
/api/godot-play/logs/clear | POST | 清空内存中的构建日志尾环（构建中也可清，新输出照常追加） |
/api/godot-play/meta | GET | 就绪探测（project / webReady / godot / preset） |
/dsh-godot-play/web/* | GET | 静态托管当前目标的 web/ 导出（带 COEP/COOP 头） |
注：webServer 的 exact 路由按 (kind,path) 唯一、不区分 HTTP 方法，POST 动作因此用独立路径。
配置（cordis.patch.yml 的 config，默认全自动）
| 键 | 默认 | 说明 |
|---|
projectRoot | 空（动态） | 留空 = 面板选择 + 智能默认；填写 = 锁定目标（下拉禁用） |
godotBin | 自动探测 | GODOT 环境变量 → macOS 默认安装路径 → PATH |
exportPreset | 自动 | 从 export_presets.cfg 找首个 platform=="Web" 预设（优先 runnable） |
webRel | 空（自动） | 显式填写 = 覆盖输出目录（相对目标项目根）；留空 = 自动跟随 Web 预设的 export_path 目录，解析不出时兜底 web |
importFirst | true | 导出前先跑一次 --import 保证缓存就绪 |
graceMs | 10000 | 进程终止宽限（毫秒） |
allowRemote | false | 非 loopback 也放行（远程访问 GUI 时按需开启） |
上次选择的项目记录在 ~/.dsh/dsh-godot-play.json（可安全删除，回退到智能默认）。
安全
/api/godot-play/* 写操作带信任围栏：loopback 直通；远端地址须命中
ctx.webRuntime.trustedHosts 或显式开启 allowRemote。- 无任意命令执行面：argv 由插件按固定顺序拼接（仅 Godot 导出参数），不透传用户命令。
- 静态托管有路径穿越防护，只服务当前目标导出目录内文件（目录由
webRel / 预设 export_path 决定）。
跨域隔离说明
Godot 4 Web 导出若开了线程，需要 iframe 文档具备 cross-origin isolation
（响应头已带 Cross-Origin-Embedder-Policy: require-corp）。若游戏在同源 iframe 内
无法启动（控制台报 SharedArrayBuffer / crossOriginIsolated 相关错误），可：
- 在导出预设里关闭线程（单线程构建无需 COI）；或
- 用
window.__GODOT_PLAY_URL__（插件加载前注入）把 iframe 指向外部带 COI 头的托管服务。
开发与测试
本插件无需构建链（浏览器半区手写 lazy-CJS factory 格式，直接可加载）。
node --check lib/index.js && node --check lib/client.js # 语法
node tests/host-smoke.mjs # 宿主端到端冒烟（stub ctx，跑假 Godot，29 断言）
License
MIT © Pidan Workshop
