samyost1/3dicon 是一个 Claude Code Skill/插件，用于通过一句自然语言提示生成可循环的 3D 动画图标，输出带真实透明通道的 animated WebP，适合直接放入 App、网页或产品 UI 中。它使用 OpenRouter 调用图像模型生成静态图，再使用视频模型生成首尾闭合的动画循环，并对每一帧进行背景移除以得到透明背景。
适用领域
AI 生成式设计 / UI/UX 设计工具 / 3D 图标生成 / 动画资产生成 / Claude Code 插件生态 / Web/App 前端素材制作
配置难度
中等。对于熟悉 Claude Code、Python 虚拟环境和命令行的开发者，安装和使用较简单；但对普通设计师或非技术用户来说，配置 OpenRouter Key、安装依赖、确保 ffmpeg 可用以及处理模型下载可能有一定难度。
商业价值
该项目的商业价值主要在于显著缩短 UI 动画图标的制作周期，让开发团队或独立开发者无需外包设计、3D 建模或动效制作即可快速生成可用素材。对于早期产品、MVP、SaaS 落地页、AI 应用和移动端界面，它可以降低视觉资产生产成本、提升界面精致度，并加快设计迭代速度。不过它更适合作为辅助生成工具，而不是完全替代专业品牌设计或高精度动效生产流程。
01
技术亮点
- 一句提示词即可生成循环 3D 动画图标，降低设计和动效制作门槛
- 输出 animated WebP，并带真实透明通道，可直接用于现代前端 UI
- 生成流程中先展示静态图并等待用户确认，避免不满意的图像继续进入付费视频生成阶段
- 视频生成前还会提出 motion 方案并再次等待确认，有助于控制成本和结果质量
- 通过将同一静态图作为首帧和尾帧，让视频模型生成首尾闭合的循环动画，减少明显接缝
- 背景移除针对每帧进行处理，且使用可控背景色以更精确地还原原始颜色，减少边缘光晕
- MIT 许可证，项目本身可自由使用、修改和分发
- README 明确说明生成的图标归用户所有且无使用限制
02
目标用户
- 前端开发者
- 独立开发者
- App 开发者
- UI/UX 设计师
- 产品原型设计人员
- 需要快速生成动效素材的创业团队
- 使用 Claude Code 作为开发工作流的开发者
03
配置要求
- 需要 Claude Code 环境，并支持 /plugin 和 skill 使用方式
- 需要 OpenRouter API Key，用于调用图像模型和视频模型
- 需要 Python 环境并能安装 requirements.txt 中的依赖
- 需要安装 ffmpeg，并确保 ffmpeg 位于系统 PATH 中
- 需要网络访问 OpenRouter 以及模型下载地址
- 首次运行需要额外下载约 180MB 的背景抠图模型
- 运行过程中会产生图像/视频模型调用费用，尤其是视频生成阶段成本可能更高
04
适用场景
- 为移动 App 或 Web 应用快速生成带透明背景的 3D 动画图标
- 为登录页、空状态页、引导页、Loading 场景生成循环动效
- 为 SaaS 产品、开发者工具、AI 应用生成品牌化小图标
- 在产品原型阶段快速探索不同风格的视觉资产
- 为营销页面、演示 Demo、落地页生成轻量级动画素材
- 无需手动建模和抠图，快速产出可直接嵌入 UI 的 animated WebP
05
部署与配置
- 在 Claude Code 中添加插件市场源：/plugin marketplace add samyost1/3dicon
- 安装插件：/plugin install 3dicon
- 进入本地 Skill 目录：cd ~/.claude/skills/3dicon
- 安装 Python 依赖：pip install -r requirements.txt
- 复制环境变量模板：cp .env.example .env
- 在 .env 文件中填写 OpenRouter API Key：OPENROUTER_API_KEY=sk-or-...
- 确保系统 PATH 中可以访问 ffmpeg
- 首次运行时会自动下载约 180MB 的 matting/背景移除模型
06
风险与注意事项
- 依赖 OpenRouter、图像模型和视频模型，服务可用性、价格和模型效果会影响使用体验
- 视频生成和图像生成存在不确定性，复杂提示词可能需要多次尝试才能得到满意结果
- 输出质量依赖上游模型，可能出现形变、风格不一致、循环不自然或细节错误
- 虽然设计了首尾帧闭合机制，但并不能保证所有动画都完全无缝循环
- 背景移除对复杂半透明、发光、毛发、玻璃材质等场景仍可能出现边缘瑕疵
- 需要本地安装 ffmpeg 和 Python 依赖，对非技术用户有一定门槛
- 首次下载约 180MB 模型，对网络环境或磁盘空间有限的用户不太友好
- 该项目是 Claude Code Skill，若团队不使用 Claude Code，集成价值会降低
- 生成的素材虽然声明归用户所有，但实际商用时仍需关注上游模型服务条款和企业合规要求
2026-09-27
第27名
新收录 · github_search
