Communitygithub.com

demoscene-intro

构建一个尺寸编码的Demo场景作品(64k或4k/8k/16k/32k预算),作为一个自包含的HTML文件,包含实时WebGL图形、合成WebAudio音轨,以及精心编排的相机运动与字幕。当用户请求一个演示、片头、demoscene作品、64k/4k intro、demo派对参赛作品、尺寸受限的视听作品、音乐同步3D序列或浏览器中的程序化音乐视频时使用此技能,即使他们仅描述了场景和氛围。

demoscene-intro 是什么?

demoscene-intro 是一个专为开发者和AI代理设计的高度专业化技能,用于生成极简、自包含且富有艺术表现力的浏览器内演示场景作品。它支持多种字节预算(4k、8k、16k、32k、64k),并强制单一HTML文件格式,无外部依赖。该技能通过WebGL2和WebAudio API驱动实时图形与生成音轨,音频时钟作为核心时间轴驱动所有视觉元素。 其独到之处在于提供严格的规范,包括合成音频的离线渲染、相机碰撞检测的可选探测接口,以及一套自动化自检脚本(预算检查、端到端性能、音频质量、空间碰撞)。这些工具使开发者能够在不依赖人工试听或视觉审查的情况下验证作品是否符合技术约束。 技能文档更强调艺术独创性,反对模板化处理。它建议根据艺术方向选择技术(如光线行进SDF用于有机形态、网格用于建筑、单片片段着色器用于极小预算),并在摄影、光照、二次运动和隐藏的‘签名时刻’上分配字节,以在约束内最大化视觉冲击。视频、音频和代码的每一部分都可测量、可测试,确保创意作品既能通过技术校验,又能实现艺术表达。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LukaszDygon/demoscene/tree/HEAD/skill/demoscene-intro

在你喜欢的 AI 中提问

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

文档

Demoscene 作品片头

你正在创作一件碰巧体积很小的艺术品。用户的简要说明就是艺术指导方向。你的工作是在预算范围内,以尽可能多的工艺和创意来实现它:简要说明是底线,而非天花板。

规范

  • 单个HTML文件,无外部请求,在字节预算内(默认65,536)。尊重用户指定的任何大小:4k、8k、16k、32k。音轨代码拥有自己的子预算(默认16,384,或对于较小类别约为总预算的四分之一)。报告原始的、未压缩的大小。仅当用户的派对规则允许时,才可使用自解压打包器,如果使用,请说明。
  • 实时图形(WebGL2)和合成音轨(WebAudio),均由代码生成。文本使用操作系统字体,并为macOS、Windows和Linux提供后备堆栈,因为嵌入字体会超出预算。
  • 大约在点击后一秒钟内开始。 使用短前瞻实时合成。浏览器在没有手势的情况下会阻止音频,因此使启动屏幕成为作品的一部分,而不是通用的“点击开始”。音频时钟驱动视觉效果。
  • 将一切与音乐的小节和节拍同步。首先以小节为单位编写故事板:场景、相机、字幕、音乐部分。

使其独特,而非通用

最常见的失败是僵硬、稳妥的作品:模板化的标题卡、处处平铺着色、预设轨道的相机、仅标注场景的字幕。根据简要说明选择技术:

  • 光线行进SDF和体积光用于水下、云朵、有机形态
  • 网格用于建筑和角色
  • 单个片段着色器用于4k–16k
  • 2D画布技巧、粒子和反馈缓冲区,用于服务于特定外观

将字节花在眼睛关注的地方:

  • 光照:雾、光柱、辉光、反射
  • 纹理和噪声
  • 二次运动:物体漂移、呼吸、对节拍的反应
  • 每件作品有一两个观众能记住的标志性时刻

警惕该类别的第一反应:为该风格最熟悉的进行、节奏、声音调色板或后期效果,例如合成波的Am–F–C–G,或磁带抖动、扫描线和泛光效果。从本简要说明的情感和主题中推导出节奏、调性、和声、音色和后期处理,并至少做出一个听众无法从流派标签中预测的选择。仅从其他作品片头的文件夹结构中汲取惯例,绝不借鉴其外观或声音。

将标题屏幕、转场和结尾卡视为艺术的一部分。如果简要说明内容单薄,请在其精神指导下进行创作,并告知用户你添加了什么。

契约(以便检查工具正常工作)

  • 将音乐保存在其自己的脚本中,该脚本的代码也可以离线渲染:通过在同一调度器上运行OfflineAudioContext来暴露SONG.render() → Promise<AudioBuffer>。这是你测量无法听到的混音的方法。参见references/audio.md。
  • 可选,用于通过几何体的相机飞行: 定义window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]}用于间隙检查。

检查你的工作

python3 <skill>/scripts/budget.py dist/x.html --total 65536 --music src/music.js --music-max 16384
node <skill>/scripts/check.mjs e2e dist/x.html         # 点击→首次发出声音的时间,异常
node <skill>/scripts/check.mjs audio src/music.js      # 离线渲染:峰值、NaN、每4小节的RMS
node <skill>/scripts/check.mjs clearance dist/x.html   # 如果定义了 __probe

不要截取屏幕截图:用户通过观看作品在运动中的声音来评判它,这才是视觉审查。通过推理代码来发现视觉问题:曝光和颜色数学、时间线每个时刻屏幕上显示的内容,以及某个揭示是否过早可见。对于音频,目标是峰值0.5–0.95、无NaN,以及各分段电平遵循编曲结构。

交付

在用户的浏览器中打开作品片头,以便他们观看并收听(open dist/x.html)。告知他们相对预算的大小、时间线、你在简要说明之外新增的内容,以及你无法验证的部分。你尚未听到音乐;你只是测量了它。

常耗时数小时的陷阱

  • 仅增长的音频图。 提前调度整首歌会让数千个死节点保持存活。按小节调度,并在完成后断开节点(references/audio.md)。
  • 固定44.1 kHz的缓冲区在48 kHz实时上下文中会抛出错误。使用ctx.sampleRate。
  • 揭示泄漏。 大型英雄物体会在关键时刻之前就显现在墙壁上或穿过开放屋顶。按时间对其进行门控,或将其隐藏在某物之后。
  • 面部仅能正面读取,需保持一两秒。
  • 字幕需要深色阴影或辉光,以便在明亮场景中保持可读性。
  • -x**2是JS语法错误;应写作-(x**2)。

相关技能