[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-85136":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":9,"rankLanguage":9,"license":16,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":9,"trendingCount":14,"starSnapshotCount":14,"syncStatus":23,"lastSyncTime":24,"discoverSource":25},85136,"ai_game_workbench","kazusa000\u002Fai_game_workbench","kazusa000","Local-first AI game asset workbench for 2D character workflows",null,"TypeScript",55,13,51,0,39.34,"MIT License",false,"main",true,[],"2026-06-15 10:04:44","# AI Game Workbench\n\nAI Game Workbench 是一个本地优先的 AI 游戏素材工作台。当前主要用于生成、处理和导出 2D 角色动画素材，适合先在本机启动网页使用，再按需要接入自己的 AI API key。\n\n项目目前包含两个主要模块：\n\n- 模块 01：高清 2D 角色制作\n- 模块 02：像素角色制作\n\n本项目不内置任何私人 API key。普通用户启动后进入网页，在「API 设置」里选择服务商并填写自己的 key 即可使用。\n\n## 当前能力\n\n### 模块 01：高清 2D 角色制作\n\n模块 01 面向高清 2D 角色动画流程，支持：\n\n- 一键生成基础角色素材\n- 角色基准模板生成和上传\n- 步行、待机、跑步、跳跃、攻击 1 流程\n- 图片生成和视频生成分步处理\n- 步行、待机、跑步、攻击、跳跃分别保存模型设置\n- 攻击 1 支持起始帧、中间帧和视频生成\n- 视频生成后抽帧、绿幕抠图、循环处理\n- 角色预览\n- Godot 导出\n- 模块设置页统一管理提示词、参考图、模型、处理参数\n\n当前模型策略：\n\n- 图片模型：APIMart GPT-Image-2、OpenRouter GPT-Image-2、Nano Banana 2、本地 GPT Image 2 等按服务商配置显示\n- 视频模型：Seedance 2.0\n- APIMart 的 Seedance 1.0 Pro Quality 可用于步行、跑步、跳跃，但攻击 1 不允许选择该模型\n\n### 模块 02：像素角色制作\n\n模块 02 面向像素角色素材，支持：\n\n- 角色基准模板\u002F待机\n- 步行图\n- 一键处理\n- 像素角色预览\n- 模块设置页管理参考图、提示词、模型、处理参数\n- 固定角色规格处理：64 x 128，角色高度 96px\n- 绿幕抠图、切格、居中、输出透明帧\n\n## 推荐使用方式\n\n### 方式一：下载便携压缩包\n\n如果你只是想使用工具，推荐下载已经打好的便携压缩包。\n\n解压后优先双击根目录启动脚本：\n\n```text\nStart AI Game Workbench.bat\n```\n\n这个脚本使用相对路径调用真正的启动器，移动到别人的电脑或不同目录后也能正常启动。\n也可以直接运行：\n\n```text\ntools\\launcher\\release\\AiGameWorkbenchLauncher.exe\n```\n\n启动器会自动：\n\n1. 启动本地 API 服务\n2. 启动网页前端\n3. 启动 Cloudflare Quick Tunnel\n4. 等待公网地址可用\n5. 打开浏览器进入工作台\n\n终端窗口需要保持打开。关闭终端或按 `Ctrl+C` 会停止后端、前端和 Cloudflare tunnel。\n\n### 方式二：源码开发启动\n\n先安装依赖：\n\n```bash\nnpm install\n```\n\n启动整套工作台：\n\n```bash\nnpm run dev:workbench\n```\n\n单独启动：\n\n```bash\nnpm run dev:server\nnpm run dev:web\n```\n\n默认地址：\n\n- API 服务：`http:\u002F\u002F127.0.0.1:8787`\n- 网页前端：Vite 启动后会在终端输出地址，通常是 `http:\u002F\u002F127.0.0.1:5173`\n\n## API 设置\n\n进入网页首页后，打开「API Settings \u002F API 设置」。\n\n目前用户侧主要选择一个服务商：\n\n- APIMart\n- OpenRouter\n\n选择服务商后填写该服务商的 API key 并保存。后续模块里的模型下拉只会显示当前服务商可用的模型，以及无需 key 的本地模型。\n\nAPI key 存在浏览器本地 `localStorage`，不会写进源码。\n\n## Cloudflare Quick Tunnel\n\n视频模型通常需要能被云端访问的 HTTPS 图片地址。工作台启动时会自动创建 Cloudflare Quick Tunnel，把本地素材服务临时暴露成一个 `https:\u002F\u002Fxxxx.trycloudflare.com` 地址。\n\n启动脚本查找 `cloudflared.exe` 的顺序：\n\n1. 环境变量 `CLOUDFLARED_PATH`\n2. `tools\u002Fcloudflared\u002Fcloudflared.exe`\n3. `tools\u002Fcloudflared.exe`\n4. `apps\u002Fserver\u002Fstorage\u002Fruntime\u002Fcloudflared\u002Fcloudflared.exe`\n\n如果都找不到，脚本会自动下载 Cloudflare Quick Tunnel runtime。\n\n如果便携包里已经带了 `tools\\cloudflared\\cloudflared.exe`，第一次启动时就不需要再下载 cloudflared。\n\n不启动公网 tunnel：\n\n```powershell\ntools\\launcher\\release\\AiGameWorkbenchLauncher.exe -NoTunnel\n```\n\n仅检查启动条件：\n\n```powershell\ntools\\launcher\\release\\AiGameWorkbenchLauncher.exe -Check -NoTunnel\n```\n\n## 目录说明\n\n```text\napps\u002Fserver        Fastify API 服务、素材存储、AI\u002Fprovider 调用、图片\u002F视频处理\napps\u002Fweb           React + Vite 前端\npackages\u002Fcore      共享类型、模型配置、纯逻辑工具\npresets            默认提示词、默认参考图和模块配置\nscripts            启动和测试脚本\ntools\u002Flauncher     Windows 启动器源码和 release exe\n```\n\n运行时生成内容主要在：\n\n```text\napps\u002Fserver\u002Fstorage\n```\n\n这里会保存：\n\n- 用户创建的角色文件夹\n- 上传图片\n- AI 返回图片和视频\n- 抽帧结果\n- 导出结果\n- provider 设置和运行配置\n- Cloudflare tunnel 配置\n\n`apps\u002Fserver\u002Fstorage` 是运行数据。生成过的角色、图片、视频和导出结果都会在这里。\n\n## presets 说明\n\n`presets` 是默认配置和默认素材位置。\n\n用户在网页端覆盖提示词或参考图时，应覆盖到当前项目使用的 presets 位置。这样开源压缩包里可以直接带完整默认 presets，用户也能在本地替换成自己的版本。\n\n不要把 API key 放进 presets。\n\n## 环境变量\n\n普通用户使用网页 API 设置即可，不一定需要 `.env`。\n\n开发或服务端 fallback 可复制 `.env.example` 为 `.env`：\n\n```text\nOPENROUTER_API_KEY=\nOPENAI_COMPATIBLE_BASE_URL=\nOPENAI_COMPATIBLE_API_KEY=\nADMIN_SETTINGS_TOKEN=\nPUBLIC_ASSET_BASE_URL=http:\u002F\u002Flocalhost:8787\u002Fassets\nFFMPEG_PATH=ffmpeg\nSTORAGE_DIR=.\u002Fstorage\nPRESETS_DIR=.\u002Fpresets\nPORT=8787\n```\n\n说明：\n\n- 相对 `STORAGE_DIR` 会从 `apps\u002Fserver` 解析，所以默认 `.\u002Fstorage` 实际是 `apps\u002Fserver\u002Fstorage`\n- 相对 `PRESETS_DIR` 会从仓库根目录解析，默认是 `.\u002Fpresets`\n- `PUBLIC_ASSET_BASE_URL` 通常由启动脚本写入 Cloudflare tunnel 地址，不需要手动填\n- `.env` 不要提交\n\n## 常用命令\n\n```bash\nnpm test\nnpm run typecheck\nnpm run build\nnpm run dev:workbench\nnpm run dev:server\nnpm run dev:web\nnpm run test:launcher\nnpm run test:workbench-startup\n```\n\n按工作区运行：\n\n```bash\nnpm run test -w apps\u002Fserver\nnpm run test -w apps\u002Fweb\nnpm run test -w packages\u002Fcore\nnpm run typecheck -w apps\u002Fserver\nnpm run typecheck -w apps\u002Fweb\nnpm run typecheck -w packages\u002Fcore\n```\n\n## 已知限制\n\n- 当前仍是本地工作台，不是多用户在线 SaaS\n- API key 保存在浏览器本地，适合个人本机使用\n- Cloudflare Quick Tunnel 是临时公网地址，每次启动可能变化\n- AI 生成质量取决于所选模型、服务商、账号权限和提示词\n- 视频模型需要公网 HTTPS 图片 URL，本地 `127.0.0.1` 图片只能网页预览，云端模型无法直接访问\n",2,"2026-06-15 02:30:07","CREATED_QUERY"]