3dicon

技能简介

3dicon 是一款专为 AI 编程 Agent（Claude Code、Cursor 等）设计的 3D 动态图标生成技能。用户只需用自然语言描述需求，例如「做一个火焰风格的 3D 动画图标」，Agent 即可自动调用 GPT Image 生成静态图，再通过视频模型生成无缝循环的动画，最终输出带真实透明通道的 WebP 格式动画图标，可直接嵌入 App UI 使用。

核心能力

• 一句话生成：用户描述需求后，Agent 自动完成从静态图到动画的全部流程
• 真实透明通道：背景去除算法基于自定义颜色而非 AI 猜色，保留柔和边缘而不产生光晕
• 无缝循环：将同一张静态图同时作为视频模型的首帧和末帧，模型自动闭合循环轨道，输出无跳变的循环动画
• 两阶段确认：先生成静态图供用户审核，确认后才进入付费的视频生成阶段，避免无效消耗
• 全流程零自建模型：调用 GPT Image 做图、Seedance 做视频，完全依赖云端 API，无需本地 GPU

安装配置

环境要求

• OpenRouter API Key（覆盖图像模型和视频模型费用）
• ffmpeg（需在 PATH 中）
• Python 3
• 首次运行自动下载约 180MB 的背景去除模型

安装步骤

1. 在 Cursor 或 Claude Code 的插件市场中安装：

   /plugin marketplace add samyost1/3dicon
   /plugin install 3dicon

2. 进入技能目录安装 Python 依赖：

   cd ~/.claude/skills/3dicon
   pip install -r requirements.txt
   cp .env.example .env

3. 在 .env 中填入 OpenRouter API Key：

   OPENROUTER_API_KEY=sk-or-...

   前往 openrouter.ai/keys 获取。

使用步骤

1. 在 Claude Code 或 Cursor 中对 Agent 说需求，例如： > 用 3dicon 做一个动态火焰图标
2. Agent 生成一张静态图并展示给用户
3. 用户确认满意后，Agent 提交给视频模型进行动画生成
4. Agent 展示动画效果并进行背景去除
5. 最终输出带真实透明通道的 WebP 动画文件到工作目录

适用场景

• App 图标：为移动应用或桌面软件生成动画 Launch Icon
• 营销素材：网站横幅、推广页面中使用的动态图标
• 品牌视觉：品牌动画 logo、吉祥物动态版本
• UI 动效：空状态、加载中、成功/失败等状态的动态图标

适用人群

• UI/UX 设计师：需要快速产出动画图标但不具备 3D 软件操作能力
• App 开发者：需要高质量动态图标但无专业设计资源
• 独立创作者：为个人项目或 SaaS 产品制作品牌视觉

工作原理

3dicon 的技术流程：

用户提示词
    ↓
GPT Image 生成静态图（首帧+末帧为同一张）
    ↓
Seedance 视频模型生成循环动画
    ↓
每帧逐一进行背景去除（基于预设背景色）
    ↓
ffmpeg 合成 WebP 动画（带真实 Alpha 通道）

核心技术细节：背景去除不使用 AI 猜色，而是基于团队预先选择的背景色进行精确色彩求解，因此软边缘（如半透明烟雾）的去背效果远优于传统 AI 去背方案。

官方链接

• GitHub 仓库：https://github.com/samyost1/3dicon
• 作者主页：https://github.com/samyost1