EunChae1110/mmforge-platform
多媒体与设计用 AI 代理和本地画布设计、预览游戏作弊菜单与 HUD 组件。
项目介绍
MMForge 是一个游戏作弊菜单和 HUD 组件的设计环境。它先以 Agent skill 的形式安装,再配合 Cursor、Claude Code、Codex 或其他 AI 代理使用:可以用文字描述生成菜单,从截图复刻菜单,或者选中本地画布里的控件让 AI 修改。所有内容都在浏览器中预览,HUD 读数和控件使用演示数据,不会连接真实游戏。
适合想快速迭代覆盖层和菜单布局、又不想自己搭预览工具的人。仓库主体是 TypeScript 画布应用,同时包含教代理理解文件与组件约定的 skill 定义。
安装与运行
用 Agent Skills CLI 安装 skill:
npx skills add EunChae1110/mmforge-platform --skill mmforge-platform
加 -g 可让本机所有项目使用,加 -y 跳过提示。然后在 MMForge 项目根目录安装依赖并启动开发服务器:
npm ci
npm run dev
打开 Vite 输出的地址,在侧栏选择设计,或用 ?design=example.tsx 直接打开某个设计。若要单独运行画布,先把已安装 skill 的 assets/canvas/ 目录复制到工作区。安装后新开一个代理对话,可以尝试“设计一个带侧栏、分组控件和按键行的作弊菜单”或“根据这张截图复刻作弊菜单”,代理会返回设计文件和 localhost 预览链接。
游戏预览与组件
在菜单中切到 Game Preview,用 Load game screenshot 载入游戏截图作为背景。打开 Widgets 启用覆盖组件并拖动到合适位置,取消勾选 Show menu 即可只看 HUD。组件的位置和可见性按菜单分别保存。
组件文件放在与菜单同名的目录里:例如 designs/neverlose.tsx 对应 designs/widgets/neverlose/。每个文件默认导出一个 React 组件,用 widgetTitle 设置选择器中的显示名。具体约定见 HUD 组件设计指南。
编辑状态与更新
代理编辑设计时,画布中央会显示当前阶段和设计名,编辑完成后预览恢复可交互。代理可以在画布项目根目录运行 npm run design-activity -- editing <路径> 和 npm run design-activity -- done <路径> 上报编辑状态。
画布里的下载图标用于检查更新和查看发布说明。应用内更新使用 Git 和 npm,会保留 designs/ 目录并要求重启画布。如果运行的是 skill 仓库的检出副本,更新前先提交或暂存本地改动;独立画布通过自己的仓库更新。发布版本时,需要在 assets/canvas/package.json 及其 lockfile 中设置版本号,然后用匹配的 tag 创建 GitHub release。
使用约束
仓库元数据未声明许可证,分发或集成前需自行确认仓库中的授权信息。画布和开发服务器需要 Node.js 与 npm 环境,代理工作流依赖兼容的代理客户端。菜单内容是设计和演示素材:HUD 读数与控件都不是来自运行中的游戏的数据。
HotRepo 点评
MMForge 出现在 HotRepo 2026-11-16 的 TypeScript 新项目榜:在约 11.5 小时内新增 29 Star、Fork 为 0;此前一天多数整点采样都停在 101 Star。这更像发布前后的一次关注脉冲,而非持续采用;提供的记录中没有全部语言日榜名次,也没有讨论数据,因此除初期关注外可判断的信息有限。技术上值得注意的地方是把设计工具打包成可复用的 Agent skill,并配一个本地 React 画布,改动落在用户可检查的普通文件里。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。