dsh-godot-live

DSH PLUGIN开发与运行时

仓库 elfgzp/dsh-godot-live

开发与运行时 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件
安装这个插件

把运行中的 Godot 游戏画面以 MJPEG 实时流接入 DeepSeek Harness 面板,支持点击与按键注入,并让 agent 通过工具直接看画面、操控游戏。

一句话选型结论

按资料字段整理

dsh-godot-live 是开发与运行时类的 DSH 可安装插件,未做沙盒验证,暂无安全审查结论,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 0 复刻 0 · 未关闭 issue 未标注
最近更新 2026-10-30 创建于 2026-10-30
README 4.9 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:elfgzp/dsh-godot-live
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-godot-live:在 DeepSeek Harness 中实时查看并操作 Godot 游戏

  • 面板实时查看游戏画面
  • 点击与按键注入游戏
  • 5 个 agent 工具操控游戏
  • 抓帧截图供 agent 查看
  • 可调帧率与推流分辨率

上游标签

deepseek-harnessdshdsh-plugin

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-godot-live当前 未做沙盒验证 未标注 0 未标注 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方elfgzp仓库 dsh-godot-live · 默认分支 未标注
分类开发与运行时dev
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证未标注商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 未标注收录时的数值,非实时
创建 / 更新2026-10-30 · 2026-10-30最后推送 未标注
本站收录2026-11-05首次进入本站目录的时间

README 全文

4.9 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-godot-live

把运行中的 Godot 游戏画面接进 DeepSeek Harness 的 Web GUI —— 一个面板实时看画面、
注入输入、让 agent 用工具直接"看"和"玩"你的游戏。

> 为什么不是 Web 导出:Godot 的 Web 导出只支持 Compatibility 渲染器,且要装
> export templates。Forward+ 项目(比如 2.5D / 3D 游戏)走不通这条路。
>
> 为什么不是 headless:--headless 用 dummy 渲染器,
> get_texture().get_image() 返回 null —— 拿不到画面。
>
> 本插件的做法:开原生 Godot 进程(渲染器、GDExtension、autoload 全部保持原样),
> Godot 端把视口编成 MJPEG,DSH 宿主反代到同源路径,浏览器一个 `` 标签就能显示。

效果

  • 侧栏多一个「游戏」图标 → 点开是主面板,里面是实时游戏画面(默认 20fps / 960 宽)
  • 面板上可以启动 / 停止 / 抓帧 / 全屏
  • 点画面 → 把点击注入游戏(自动换算视口逻辑坐标)
  • Agent 有 5 个工具:godot_live_status / godot_live_start / godot_live_stop /
    godot_live_input / godot_live_screenshot

实测数据(M 系 Mac,1280x720 窗口 → 960x540 推流)

项目 数值
抓帧 get_image() 0.95 ~ 4.7 ms
JPEG 编码 5.6 ~ 9.5 ms
每帧大小 ~40 KB
可达帧率 150 fps(960x540)/ 70 fps(1280x720)/ 35 fps(1920x1080)

默认 20fps 时 CPU 占用很低。

安装

dsh plugin --profile  add /path/to/dsh-godot-live

或手动装进 profile:把本目录加进 package.json 的 dependencies,
并在 dsh.profile.bundles 里加上 dsh-godot-live。

装完重启 DSH。

配置

见 cordis.patch.yml,常用项:

键 默认 说明
godotBin 自动探测 Godot 可执行文件路径
resolution 1280x720 引擎窗口分辨率;降低可提升抓帧速度
width 960 推流宽度(保持纵横比),0 = 原分辨率
fps 20 推流帧率
quality 0.7 JPEG 质量
streamPort 8711 内部串流端口(仅 127.0.0.1)
hideWindow true 启动后把窗口移出屏幕 + 无边框
scene 空 主场景覆盖,空 = 读 project.godot

工具

godot_live_start({ projectRoot?, scene?, width?, fps?, resolution? })
—— 不传 projectRoot 时从 DSH 当前工作目录向上找 project.godot。

godot_live_input({ action, name?, x?, y?, keycode?, down?, duration_ms? })
- press / release / tap:用 InputMap 动作名(action: "actions" 可列出可用动作)
- click / move:视口逻辑坐标
- key:Godot keycode

godot_live_screenshot() —— 返回 JPEG 图片附件,agent 可直接看。

已知限制

  1. 需要真实渲染窗口。Godot 没有"无窗口渲染",所以进程会短暂闪一下窗口
    (hideWindow: true 时会立刻移出屏幕 + 去边框,尽量小)。
  2. MJPEG 是有损 + 有延迟。适合调试和肉眼验证,不适合逐像素比对。
    要逐像素验证仍请用「固定种子 + 帧计数状态机 + save_png」那条路。
  3. 输入注入走 InputMap,不走操作系统级事件。好处是不需要辅助功能权限;
    坏处是对自己读原始 InputEvent 而不走 InputMap 的游戏可能不生效。
  4. 面板画面是 `` 流,浏览器对 MJPEG 的支持是历史遗留特性(Chrome / Safari / Firefox 都支持)。

许可

MIT

踩坑记录(都是实跑踩出来的)

1. InputEventMouse*.position 是窗口像素,不是视口逻辑坐标

本项目 display/window/stretch/mode="canvas_items",视口逻辑尺寸固定 1920x1080,
但引擎窗口可能是 1280x720。InputEventMouseButton.position 按窗口像素解释。

症状:注入点击 (950,754) 毫无反应——死亡界面的「重新开始」点了十几次都不动。
根因:事件落在错误位置,GUI 命中测试打空。

修复:注入前按 window_size / viewport_visible_rect 逐轴缩放(_viewport_to_window)。
修复后同一个逻辑坐标 (1604,164) 成功点中胸腔界面的「关闭」按钮。

2. GUI 按钮需要成对事件 + 先 hover

只发 down/up 时部分控件不动。现在固定顺序:mouse_motion(带 button_mask)→ mouse_down → mouse_up。

3. -- 之后的参数顺序

godot --path P --log-file X --script S -- --port=8711 —— --log-file 必须写在 -- 之前,
否则会被当成 runtime 的用户参数吃掉。

已验证

  • 侧栏「Godot」→ 主面板实时画面(20fps,960x540)
  • 点画面角色走过去(点击移动生效,画面 + 摄像机跟随)
  • 输入动作:cavity(Tab) 打开胸腔界面、esc 关闭
  • 战斗推进:血量 148 → 42 → 死亡界面
  • GUI 按钮准确命中(修复坐标后)
  • 插件卸载时引擎进程被回收,无孤儿进程

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-godot-live 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:elfgzp/dsh-godot-live` 即可。

dsh-godot-live 的验证等级是什么意思?

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-godot-live 安全吗?

未标注。

dsh-godot-live 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-godot-live 有哪些功能?

面板实时查看游戏画面、点击与按键注入游戏、5 个 agent 工具操控游戏、抓帧截图供 agent 查看、可调帧率与推流分辨率。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

elfgzp 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。