🎭 AI 代理的多模态生成媒体技能 (Generative Media Skills)

面向 Claude Code、Cursor 和 Gemini CLI 的终极多模态工具集。 这是一套高性能、基于 Schema 驱动的架构，旨在赋能 AI 代理生成、编辑和展示专业级的图像、视频和音频——由 muapi-cli 提供驱动。

🚀 快速开始 | 🎨 专家库 | ⚙️ 核心原语 | 🤖 MCP Server | 📖 参考文档

---

✨ 核心特性

• 🤖 代理原生设计 (Agent-Native Design) — 提供带有结构化 JSON 输出、语义退出码和 --jq 过滤功能的 CLI 脚本，实现无缝的 AI 代理流水线集成。
• 🧠 专家知识层 (Expert Knowledge Layer) — 针对特定领域构建的技能，内置了专业电影摄影、原子设计 (Atomic Design) 和品牌设计逻辑。
• ⚡ CLI 驱动的核心 (CLI-Powered Core) — 所有原语均委托给 muapi-cli 处理，无需处理 curl、JSON 解析或繁琐的样板代码。
• 🖼️ 直接媒体显示 (Direct Media Display) — 使用 --view 标志，即可自动下载生成的媒体并在系统查看器中打开。
• 📁 本地文件支持 (Local File Support) — 自动将本地的图像、视频、人脸和音频文件上传至 CDN 进行处理。
• 🌈 100+ AI 模型 — 一键访问 Midjourney v7, Flux Kontext, Seedance 2.0, Kling 3.0, Veo3 等顶级模型。
• 🔌 MCP Server — 运行 muapi mcp serve，即可将全部 19 个工具直接暴露给 Claude Desktop、Cursor 或任何支持 MCP 的 AI 代理。

---

🏗️ 可扩展架构

本仓库采用 Core/Library (核心/库) 分离架构，以确保 LLM 的执行效率和高信噪比发现能力：

⚙️ 核心原语 (/core)

这是对 muapi-cli 的轻量级封装，用于底层的 API 访问。

• core/media/ — 文件上传
• core/edit/ — 图像编辑（基于 Prompt）
• core/platform/ — 设置、身份验证及结果轮询

📚 专家库 (/library)

高价值技能库，将创作意图转化为技术指令。

• Cinema Director (电影导演) (/library/motion/cinema-director/) — 专业电影指导与摄影技术。
• Nano-Banana (/library/visual/nano-banana/) — 基于推理能力的图像生成（Gemini 3 风格）。
• UI Designer (UI 设计师) (/library/visual/ui-design/) — 高保真移动端/Web 原型图（基于原子设计）。
• Logo Creator (Logo 创建器) (/library/visual/logo-creator/) — 极简主义矢量品牌设计（几何原语）。
• Seedance 2 (豆包视频) (/library/motion/seedance-2/) — 导演级别的电影级视频生成，支持文生视频、图生视频、视频扩展，并具备原生的音视频同步能力。

---

🚀 快速开始

1. 安装 muapi CLI

核心脚本依赖 muapi-cli。安装一次即可：

# 通过 npm 安装（推荐 — 无需 Python）
npm install -g muapi-cli

# 通过 pip 安装
pip install muapi-cli

# 或者无需安装直接运行
npx muapi-cli --help

2. 配置 API Key

# 交互式配置
muapi auth configure

# 或者直接传入
muapi auth configure --api-key "YOUR_MUAPI_KEY"

# 在 https://muapi.ai/dashboard 获取您的 key

3. 安装技能 (Skills)

# 为您的 AI 代理安装所有技能
npx skills add SamurAIGPT/Generative-Media-Skills --all

# 或者安装特定技能
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-media-generation

# 安装到特定代理
npx skills add SamurAIGPT/Generative-Media-Skills --all -a claude-code -a cursor

4. 生成第一张图像

muapi image generate "a cyberpunk city at night" --model flux-dev

# 自动下载结果
muapi image generate "a sunset over mountains" --model hidream-fast --download ./outputs

# 仅提取 URL（代理友好型）
muapi image generate "product on white bg" --model flux-schnell --output-json --jq '.outputs[0]'

5. 运行专家技能

# 使用 Nano-Banana 推理能力生成 2K 杰作
bash library/visual/nano-banana/scripts/generate-nano-art.sh \
  --file ./my-source-image.jpg \
  --subject "a glass hummingbird" \
  --style "macro photography" \
  --resolution "2k" \
  --view

6. 指导电影场景

cd library/motion/cinema-director

# 创建一个 10 秒的史诗感展示视频
bash scripts/generate-film.sh \
  --subject "a cybernetic dragon over Tokyo" \
  --intent "epic" \
  --model "kling-v3.0-pro" \
  --duration 10 \
  --view

# 将参考图片制作成动画视频
bash library/motion/seedance-2/scripts/generate-seedance.sh \
  --mode i2v \
  --file ./concept.jpg \
  --subject "camera slowly pulls back to reveal the full landscape" \
  --intent "reveal" \
  --view

# 扩展现有的视频
bash library/motion/seedance-2/scripts/generate-seedance.sh \
  --mode extend \
  --request-id "YOUR_REQUEST_ID" \
  --subject "camera continues pulling back to reveal the vast city" \
  --duration 10

---

🤖 MCP Server

将 muapi 作为 Model Context Protocol (MCP) server 运行，从而让 Claude Desktop、Cursor 或任何 MCP 兼容的代理使用上述工具。