Communitygithub.com

hhse/threeui-3d-pages

使用 ThreeUI 社区目录构建精致的 Three.js 落地页、Hero 区域、背景和 UI 控件。适用于高端 3D Web UI 需求,包括液态金属、玻璃、烟雾、粒子、着色器按钮或 ThreeUI 模板选择。

threeui-3d-pages 是什么?

该技能(ThreeUI 3D Pages)旨在帮助开发者和 AI 代理(如 Claude Code)使用 ThreeUI 社区组件构建视觉惊艳、生产就绪的 3D Web 界面。它并非一个简单的提示集合,而是一个结构化的设计工作流,强调从用户需求出发,通过 CLI 工具搜索、筛选并审查合适的 ThreeUI 组件(如落地页、Hero、背景、按钮等)。技能内置了严格的决策规则,要求效果与内容匹配,避免堆砌无关着色器,并优先选择完整页面或 Hero 组件。同时,它强调遵循集成指南、尊重开源许可(MIT),并使用官方 npm 包 `@designcodeio/threeui`,最后必须对项目进行构建、测试与多设备渲染检查。该技能适用于所有支持执行 Node.js 脚本和读取本地文件的 AI 代理平台,特别适合需要高质感 3D UI 的 Web 开发项目。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add hhse/threeui-3d-pages

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ThreeUI 3D 页面

将 ThreeUI 作为精选视觉来源使用,而非盲目粘贴的提示集合。目标是构建一个连贯、可投产的界面,其 Hero 效果、排版、间距、动效和内容均强化同一艺术方向。

工作流程

  1. 根据用户请求确定设计纲要:产品、受众、期望氛围、主要内容以及任何所需的品牌约束。不得捏造产品声明或用演示内容替换所提供的文案。

  2. 搜索捆绑的组件目录:

    node scripts/threeui.mjs search "液态金属启动按钮"
    node scripts/threeui.mjs search "奢侈品香水 落地页 烟雾"
    
  3. 初步筛选两到三个兼容候选,然后审查最合适的那一个:

    node scripts/threeui.mjs show <item-id>
    node scripts/threeui.mjs guide <item-id>
    
  4. 选择一个锚定效果。最多添加一个辅助性的 ThreeUI 元素,且仅当该元素服务于清晰的层级或交互角色时才添加。不要仅仅为了显得页面更复杂而堆叠无关的着色器。

  5. 在修改应用程序代码之前,先阅读 references/integration.md。该文件包含了源代码、资源、组合、性能和验证规则。

决策规则

  • 让效果与内容相匹配。一个平静的产品页面不应自动获得高能量的粒子场,仪表板也不应使用电影级的全屏着色器作为其主要表面。
  • 如果任务是创建一个新网站,优先使用“落地页”和“Hero”类别中的完整页面或 Hero 组件。如果现有 UI 需要增加深度,优先使用背景组件;如果需求范围较小,则使用按钮或 UI 元素。
  • 使用组件目录中的 runtime、interaction、asset 和 variants 元数据来排除与目标技术栈或性能要求冲突的候选组件。
  • 将图像和动效视为设计的一个图层。周围的布局、字号比例、留白、对比度和行动号召仍然决定了最终效果是否看起来精致。
  • 如果组件目录中没有合适的社区组件,请明确说明,并从项目现有技术栈构建最接近的合适解决方案。不得声称使用了 Pro 版或不可用的 ThreeUI 资源。

源代码规则

  • 社区源码采用 MIT 许可证。保留署名和捆绑的许可声明,请参阅 references/THIRD_PARTY_NOTICES.md。请勿重新分发远程的 ThreeUI 缩略图或预览图。
  • 优先使用 npm 包 @designcodeio/threeui 及其文档化的导入名称。请勿将整个模板目录复制到目标项目中。
  • 如果存在实现指南,请先遵循指南,不要自行即兴发挥。该指南指明了规范的源文件、资源、运行时版本和行为。
  • 当确切的源代码可用时,切勿使用粗略的视觉近似替换原创的着色器、几何体或资源。
  • 仅当用户拥有自己的授权访问权限时,才使用 Pro MCP 或 CLI。切勿在生成的项目中请求、存储或嵌入凭证。

完成检查项

在完成之前,运行目标项目现有的构建、测试和 lint 命令。检查桌面端和移动端渲染效果、浏览器控制台输出、减少动效行为以及 WebGL 回退路径(如适用)。报告实际运行的检查项以及任何未能完成的验证。

相关技能