HRuiCcc/RuiC-card-skill

Public

全息闪卡通用 Agent Skill,不挑宿主、多模态模型都能用:一句话生成可拖转、会流光、带层次景深的 3D 闪卡网页,附可编辑 Blender 工程 · A host-agnostic Agent Skill: turn one sentence into an interactive 3D holographic card page with layered parallax, plus an editable Blender project.

  • Stars621+48 tuần này
  • Forks50
  • Watchers1
  • Issues15
  • Ngày tạo07/09/2026
  • Cập nhật gần nhất30/09/2026
  • Ngôn ngữJavaScript
  • Giấy phép—
README.md16.6 KBRaw

✦ RuiC Card Skill

一个通用 Agent Skill:不挑宿主,多模态模型都能用——把小时候文具店门口那种会闪的全息卡复刻到浏览器里。 说一句话,就得到一张会随视角流光、带层次景深的 3D 闪卡网页,外加一个可以随便改的 Blender 工程。

小时候买不起的闪卡,现在你想印谁就印谁。这是你的私人卡牌工坊。

它是一台全自动闪卡生产线:你给一句话或一张参考图,剩下全交给模型——

  1. 画四层图:主体、背景、线稿、文字,画在同一块画布、同一套坐标里
  2. 搭 3D 场景:Blender 建卡牌几何,把四层图按景深在空间里"撑开"——主体前凸、背景后缩
  3. 铺全息材质:镭射彩虹的相位跟着视角走,转到哪闪到哪;烫金 / 银箔 / 珠光 / 原画四种质感
  4. 组装网页:Three.js 查看器打包成单文件,起本地服务,打开页面实测拖拽、翻面、滑块、手机布局
  5. 交付:网页链接 + card.blend 源工程 + 四层透明 PNG + card-config.json 配置 + 渲染图

技术栈就三样:Blender(官方便携版自动安装,不碰系统环境)+ Three.js(按同一套 UV 公式重建材质)+ Python 流水线(画完图之后一步到位)。skill 本体只有代码和文字,装上就能用;你生成的画作、工程、模型全部待在你自己的项目目录里。


🎬 演示

调整前 · 图层分散

初版层距:主体、特效、文字隔得较开,转动时明显"散开":

调整前效果

▶ 观看调整前完整视频

演示效果由 DeepSeek V4.1 Flash 实现。

调整后 · 层距收紧(现默认)

调整后:各层收近一档,卡片整体更紧凑,仍保留层次景深——这是当前出厂默认效果:

调整后效果

▶ 观看调整后完整视频

演示效果由 DeepSeek V4.1 Flash 实现。


✨ 特性

  • 一句话出卡:描述或参考图 → 分层图 → 配置 → 流水线 → 网页,全程自动,你只负责想
  • 不挑宿主、不挑模型:不绑定某一家——流水线里模型要自己画四层图、自己打开渲染帧判断对不对,所以只要是多模态模型(能出图、能看图),配任何读 SKILL.md 的宿主都能跑通
  • 真 3D 层次景深:主体前凸、背景后缩,层与层随视角错开,不是一张平面贴图
  • 视点流光:镭射彩虹的相位跟着视角走,转到哪闪到哪;烫金 / 银箔 / 珠光 / 原画四种卡面质感
  • 浏览器里随便玩:拖拽旋转、翻面、景深/光泽/画面比例滑块,手机横竖屏都适配
  • 出厂自带验收:node scripts/verify_web.mjs <项目> 自己拉起无头浏览器和本地服务,把拖拽、翻面、缩放、键盘、五个滑块、四种质感、截图下载、390px 窄屏、减动效逐项跑完,并且比对真实画面帧(不是只看滑杆读数变没变),报告和截图落进 verification/。macOS / Windows / Linux 都能跑,无 GUI 的容器与 root 环境同样直接可用
  • 免装 Blender:官方便携版自动下载、SHA-256 校验后装进项目目录,不污染系统环境
  • 网页零依赖请求:查看器打包成单文件(three + 图标全部内联),广告拦截插件无从下手;即使浏览器关了硬件加速,也有 CSS-3D 分层兜底,绝不会白屏
  • 可编辑交付:card.blend 真工程 + 透明分层 PNG + card-config.json,想改哪层改哪层
  • 纯文本 skill:本体只有代码和文字,一键打包 ZIP 交付,无二进制、无凭据、无缓存

🚀 快速开始

安装

skill 本体就是 SKILL.md + Markdown + 纯 Python/Node 脚本,不绑定任何宿主,也不绑定任何一家模型——只要宿主能读 SKILL.md、并且跑的是多模态模型(能生成图像、能看图),把它放进宿主的 skills 目录就能用(目录名即 skill 名;通用约定是 ~/.agents/skills/,别的宿主换成自己的 skills 目录即可)。

环境

  • 模型:多模态(要能出图、也要能看图判断渲染帧;纯文本模型做不了这两步)
  • Python 3.9+ + Pillow(ensure_blender.py 用了 Path.is_relative_to,3.6 / 3.8 上会直接报错)
  • Node.js + npm
  • Blender 不用自己装——流水线自动把官方便携版放到 <project>/tools/,校验 SHA-256。官方源在你的网络里被墙时,用 RUIC_BLENDER_BASE 指向镜像即可(例:RUIC_BLENDER_BASE=https://mirrors.aliyun.com/blender/Blender4.5/);校验值取自同一个源,所以镜像要自己信得过
  • 验收脚本需要一个 Chromium 内核浏览器:系统装的 Chrome / Edge / Chromium 都行,Playwright 缓存里的 Chromium 也认,还可以用

Nội dung README thuộc về HRuiCcc và cộng đồng đóng góp, giấy phép Không có giấy phép. Nguồn: github.com/HRuiCcc/RuiC-card-skill