samyost1/3dicon

是什么

/3dicon 是一个小型、可自托管的工具，可将自然语言提示转换为循环动画3D图标（以带有真实透明度的WebP格式导出）。它设计用于从Claude风格的插件或命令行调用，并生成可直接放入UI的资产。

如何工作

1. 提示 → 静态图像 – 用户的文本通过OpenRouter发送到图像生成模型（称为 GPT Image），生成一张3D风格的单张图像。
2. 首帧与末帧 – 同一张静态图像被用作短视频片段的首帧和末帧。
3. 视频模型 – 视频生成模型（命名为 Seedance）生成中间帧，确保运动能无缝回到原始静态图像。
4. 抠像 – 每帧都通过一个抠像模型处理，移除背景（基于已知颜色），从而精确还原原始颜色并实现干净柔和的边缘。
5. 导出 – 处理后的帧被组合成一个保留真实透明度的动画WebP。

关键技巧是将静态图像同时用作起始和结束帧，强制视频模型生成无缝循环。

安装步骤

# 将插件添加到你的Claude/助手环境中
/plugin marketplace add samyost1/3dicon
/plugin install 3dicon

# 本地克隆该技能（显示的路径是Claude存储技能的位置）
cd ~/.claude/skills/3dicon
pip install -r requirements.txt   # 安装Python依赖
cp .env.example .env               # 复制环境模板

编辑 .env 并插入你的OpenRouter API密钥：

OPENROUTER_API_KEY=sk-or-…

确保系统PATH中可用 ffmpeg —— 第一次运行时还会下载约180MB的抠像模型。

使用工具

在Claude聊天中（或任何将命令转发给插件的界面），只需用自然语言提问，例如：

make an animated 3d fire icon using /3dicon

工作流程是交互式的：

1. 系统生成静态图像并显示。
2. 你确认该静态图像（只有当你满意结果时才为动画付费）。
3. 然后系统提出动画运动方案；你再次确认。
4. 最终的动画WebP被返回。

许可与所有权

代码以MIT许可证发布。你生成的任何图标均归你所有，无额外限制。

---

以上所有细节均直接取自仓库的README。