搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

xikhar/papercraft

开发工具

教编程 Agent 制作立体纸艺风格的游戏、互动场景、网页和动画的 Agent Skill。

这是一个 Agent 技能包 · 1 个技能看技能清单和安装方法 →
105
9
JavaScript
MIT
创建于 1 天前

项目介绍

papercraft 是一个 Agent Skill,教编程 Agent 用统一的立体纸艺(pop-up papercraft)风格制作游戏、互动场景、网页、动画和视频。目标是让画面读起来像拍摄下来的纸质模型:印刷卡纸、细切边、从印刷地面折起的铰链、被环境染色的柔和阴影、移轴微距镜头、克制的铰链运动以及纸张声效。适合想获得一致手工纸艺视觉、又不想自己从零搭建渲染层的开发者和设计师。

技能内容来自一款已上线的 three.js 立体纸艺游戏:如何让一帧画面像纸模照片、如何用可扩展的结构类型搭建物件(插接十字、分层平面、折盒与棱柱、穹顶、印刷水面,以及供行走的甲板、桥和楼梯),以及纸如何运动和发声 (2)。提示词和可选参考决定世界的配色、地面、建筑、生物和天气;调用方可以让 Agent 只用代码完成,也可以要求先生成概念图。仓库内的代码负责纸张材质、卡片、分层印刷、铰链、光照、镜头、行走和生命效果这些底层能力,具体主题的纸片造型由 Agent 自行设计。

快速使用

通过 Agent Skills CLI 安装,或把 skills/papercraft/ 复制到 Agent 的 skills 目录。它适用于支持 Agent Skills 的 Agent,例如 Claude Code、Codex、Cursor、Gemini CLI 和 OpenCode (2)。

npx skills add xikhar/papercraft

安装后直接用自然语言描述需求,例如折起式港口小镇的 three.js 场景、渲染成 MP4 的纸艺动画,或清晨灯塔小镇的竖屏 Reel。想先看模板效果,可以把资源目录通过 HTTP 提供出去:

npx serve skills/papercraft/assets

然后打开 /templates/popup-3d/ 或 /templates/popup-2d/,structures.html 展示所有结构类型。两个模板都支持 WASD 或方向键移动主角,加 ?still 切换为固定俯瞰视角 (2)。在自己的项目里,复制 assets/lib/ 和模板的 harness(3D 用 harness.js,2D 用 harness-2d.js),编写自己的 scene.js,并把页面 import map 中的 "papercraft/" 指向存放 lib/ 的目录。

输出尺寸与截图

同一场景可以输出 16:9 影片、9:16 Reel、方形或 4:5 帖子、4K 母版、超宽静态图和手机页面。镜头按画幅短边计算,竖屏会自动拉近并把主体避开平台字幕区域,印刷细节和模糊随分辨率调整 。在模板地址后加 ?size=1080x1920 或 ?aspect=9:16 可以预览其他画幅。capture.py 通过 Playwright 无头渲染标准尺寸的静帧和 MP4 片段,并报告构建耗时、最慢的印刷、主角卡片是否互相穿插以及页面错误 (2)。

使用约束

需要 Agent 支持 Agent Skills 格式;交互演示需要支持 WebGL 的浏览器来运行 three.js 模板,资源应通过 HTTP 提供而非直接打开本地文件。图像生成是可选项,只在调用方要求时使用。仓库采用 MIT 许可证 (2)。仓库内代码是底层设施和示例,最终视觉效果取决于 Agent 是否遵循技能里的参考和评审循环,结果会因 Agent 和提示词而异。

HotRepo 点评

该项目于 2026-11-22 出现在 HotRepo 的 JavaScript 新项目榜上,在约 1.5 小时的观察窗口中新增 4 Star、1 Fork,累计 105 Star。样本很小,只能证明早期上榜这一事实,不足以判断趋势。更有参考价值的是它的覆盖范围:它不是泛化的提示词合集,而是打包了具体的材质模型、结构库、运动与声效模块,以及截图和度量循环,这在 Agent 技能里比较具体。

本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. vercel-labs/agent-skills把 Vercel 的 React、Next.js 与部署约定打包成技能,让 AI 编程助手按需加载。JavaScript32,947
  2. android/skillsGoogle 官方出品的 Android 技能文件,专门补上大模型最容易做错的那类 Android 开发任务。Kotlin9,568
  3. google-gemini/gemini-skills为编程助手提供关于 Gemini API、SDK 和实时接口的上下文技能,帮助生成更准确的调用代码。Python4,396
  4. GoogleChrome/modern-web-guidance-src把精选的现代 Web 平台知识注入编码 Agent 的技能,让 Agent 在写网页时少用旧模式。TypeScript7,970
  5. expo/skillsExpo 官方给编程助手用的技能集,教它按 Expo Router、EAS 与 SDK 升级的约定写代码,而不是自己猜。Shell3,338