如果你已经安装了 Codex 并运行在 Windows 11 上,那么只需一分钟即可用 AI 生成游戏美术和音乐资源。这套流程经过多次实践与踩坑总结,以下是完整的操作步骤,助你快速上手。
适用环境要求:已安装 Codex,Windows 11
1. 安装 Meowa 游戏资产技能
打开 PowerShell,执行以下命令,将 Meowa 的 game-assets 技能安装到 Codex 中。请务必将 你的用户名 替换为你的实际用户路径。
& "C:\Users\你的用户名\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe" `
"C:\Users\你的用户名\.codex\skills\system\skill-installer\scripts\install-skill-from-github.py" `
--repo Meowa-AI/meowa-skills `
--path skills/game-assets
2. 配置 API 密钥
首先前往 Meowa 官网创建 API Key:meowa.ai/#/api-keys

接着执行以下命令设置环境变量:
[System.Environment]::SetEnvironmentVariable("MEOWART_API_KEY", "你的_meowa_key", "User")
$env:MEOWART_API_KEY = [System.Environment]::GetEnvironmentVariable("MEOWART_API_KEY", "User")
3. 安装 Python 依赖库
技能和 API 密钥都配置完成后,为 Codex 内置的 Python 环境安装 requests 库:
& "C:\Users\你的用户名\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe" -m pip install requests
4. 重启 Codex 使技能生效
安装技能并配置环境变量后,务必重启一次 Codex,否则新添加的技能无法生效。
5. 检查 Meowa 账户余额
先查询 Meowa 账户余额,避免生成资源时因余额不足而失败:
& "C:\Users\你的用户名\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe" `
"C:\Users\你的用户名\.codex\skills\game-assets\meowart_api.py" credits-balance
6. 一键生成测试像素图标
以下命令可一次性生成 7 个猫咪道具像素图标,快速验证技能是否正常工作:
& "C:\Users\你的用户名\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe" `
"C:\Users\你的用户名\.codex\skills\game-assets\meowart_api.py" pixel-gen-run `
--template-name "object" `
--requirement "cat item icons: yarn ball, fish treat, bell collar, paw badge, milk bowl, feather toy, scratch toy, cat bed" `
--output-dir "C:\Users\你的用户名\Documents\Codex\outputs\m"
7. 通过自然语言指令调用
如果你觉得命令行操作不够直观,还可以直接在 Codex 的对话窗口中输入自然语言指令,例如:
用 game-assets skill 生成 8 个像素猫咪道具图标,保存到 outputs/m/icons
Codex 会自动调用对应的 skill 完成生成。
常见问题与解决方案
Python was not found 错误
不要使用系统自带的 Python,其版本和路径可能与 Codex 冲突。请始终使用上述命令中 Codex 内置的 Python 路径。
ModuleNotFoundError: No module named 'requests'
通常是因为未安装依赖库。请执行第 3 步中的 pip install 命令安装 requests 库,之后即可正常运行。
insufficient_credits 余额不足
此错误表示 API 密钥有效,但账户余额不足。请前往 Meowa 平台充值后重试。
[WinError 206] 文件名或扩展名太长
Windows 系统对文件路径长度有限制,将输出目录缩短即可解决。例如:
--output-dir "C:\Users\你的用户名\Documents\Codex\outputs\m"