CodeX Skill一分钟快速入门游戏美术和音乐资源生成

如果你已经安装了 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"