@baimingtao/lbs-agent 1.0.0

package/extensions/skills/builtin/creative/ascii-art/SKILL.md

@@ -0,0 +1,322 @@
+---
+name: ascii-art
+description: "ASCII 艺术：pyfiglet, cowsay, boxes, image-to-ascii。"
+version: 4.0.0
+author: 0xbyt4, Hermes Agent
+license: MIT
+dependencies: []
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [ASCII, Art, Banners, Creative, Unicode, Text-Art, pyfiglet, figlet, cowsay, boxes]
+    related_skills: [excalidraw]
+
+---
+
+# ASCII 艺术 Skill
+
+满足不同 ASCII 艺术需求的各种工具。所有工具均为本地 CLI 程序或免费的 REST API —— 无需 API keys。
+
+## Tool 1: 文本横幅（pyfiglet — 本地）
+
+将文本渲染为大型 ASCII 艺术横幅。内置 571 种 fonts。
+
+### 配置
+
+```bash
+pip install pyfiglet --break-system-packages -q
+```
+
+### 用法
+
+```bash
+python3 -m pyfiglet "YOUR TEXT" -f slant
+python3 -m pyfiglet "TEXT" -f doom -w 80    # Set width
+python3 -m pyfiglet --list_fonts             # List all 571 fonts
+```
+
+### 推荐 fonts
+
+| 风格 | Font | 最适合 |
+|-------|------|----------|
+| 简洁现代 | `slant` | 项目名称、标题 |
+| 粗体方块 | `doom` | 标题、Logo |
+| 大号易读 | `big` | 横幅 |
+| 经典横幅 | `banner3` | 宽屏显示 |
+| 紧凑 | `small` | 副标题 |
+| 赛博朋克 | `cyberlarge` | 科技主题 |
+| 3D 效果 | `3-d` | 启动画面 |
+| 哥特风格 | `gothic` | 夸张文本 |
+
+### Tips
+
+- 预览 2-3 种 fonts，让用户挑选他们最喜欢的
+- 短文本（1-8 个字符）最适合搭配像 `doom` 或 `block` 这样细节丰富的 fonts
+- 长文本更适合搭配像 `small` 或 `mini` 这样紧凑的 fonts
+
+## Tool 2: 文本横幅（asciified API — 远程，免安装）
+
+将文本转换为 ASCII 艺术的免费 REST API。包含 250+ 种 FIGlet fonts。直接返回纯文本 —— 无需解析。当未安装 pyfiglet 或作为快速替代方案时使用。
+
+### 用法（通过 terminal curl）
+
+```bash
+# Basic text banner (default font)
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello+World"
+
+# With a specific font
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Slant"
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Doom"
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Star+Wars"
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=3-D"
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Banner3"
+
+# List all available fonts (returns JSON array)
+curl -s "https://asciified.thelicato.io/api/v2/fonts"
+```
+
+### Tips
+
+- 在 text 参数中，空格需进行 URL 编码，替换为 `+`
+- 响应为纯文本 ASCII 艺术 —— 没有 JSON 包裹，可直接显示
+- Font 名称区分大小写；请使用 fonts 端点获取准确名称
+- 可从任何带有 curl 的 terminal 中运行 —— 无需 Python 或 pip
+
+## Tool 3: Cowsay（消息艺术）
+
+将文本包裹在带有 ASCII 角色的对话气泡中的经典工具。
+
+### 配置
+
+```bash
+sudo apt install cowsay -y    # Debian/Ubuntu
+# brew install cowsay         # macOS
+```
+
+### 用法
+
+```bash
+cowsay "Hello World"
+cowsay -f tux "Linux rules"       # Tux the penguin
+cowsay -f dragon "Rawr!"          # Dragon
+cowsay -f stegosaurus "Roar!"     # Stegosaurus
+cowthink "Hmm..."                  # Thought bubble
+cowsay -l                          # List all characters
+```
+
+### 可用角色（50+）
+
+`beavis.zen`, `bong`, `bunny`, `cheese`, `daemon`, `default`, `dragon`,
+`dragon-and-cow`, `elephant`, `eyes`, `flaming-skull`, `ghostbusters`,
+`hellokitty`, `kiss`, `kitty`, `koala`, `luke-koala`, `mech-and-cow`,
+`meow`, `moofasa`, `moose`, `ren`, `sheep`, `skeleton`, `small`,
+`stegosaurus`, `stimpy`, `supermilker`, `surgery`, `three-eyes`,
+`turkey`, `turtle`, `tux`, `udder`, `vader`, `vader-koala`, `www`
+
+### Eye/tongue modifiers
+
+```bash
+cowsay -b "Borg"       # =_= eyes
+cowsay -d "Dead"       # x_x eyes
+cowsay -g "Greedy"     # $_$ eyes
+cowsay -p "Paranoid"   # @_@ eyes
+cowsay -s "Stoned"     # *_* eyes
+cowsay -w "Wired"      # O_O eyes
+cowsay -e "OO" "Msg"   # Custom eyes
+cowsay -T "U " "Msg"   # Custom tongue
+```
+
+## Tool 4: Boxes（装饰边框）
+
+在任何文本周围绘制装饰性 ASCII 艺术边框/框架。内置 70+ 种设计。
+
+### 配置
+
+```bash
+sudo apt install boxes -y    # Debian/Ubuntu
+# brew install boxes         # macOS
+```
+
+### 用法
+
+```bash
+echo "Hello World" | boxes                    # Default box
+echo "Hello World" | boxes -d stone           # Stone border
+echo "Hello World" | boxes -d parchment       # Parchment scroll
+echo "Hello World" | boxes -d cat             # Cat border
+echo "Hello World" | boxes -d dog             # Dog border
+echo "Hello World" | boxes -d unicornsay      # Unicorn
+echo "Hello World" | boxes -d diamonds        # Diamond pattern
+echo "Hello World" | boxes -d c-cmt           # C-style comment
+echo "Hello World" | boxes -d html-cmt        # HTML comment
+echo "Hello World" | boxes -a c               # Center text
+boxes -l                                       # List all 70+ designs
+```
+
+### 结合 pyfiglet 或 asciified 使用
+
+```bash
+python3 -m pyfiglet "HERMES" -f slant | boxes -d stone
+# Or without pyfiglet installed:
+curl -s "https://asciified.thelicato.io/api/v2/ascii?text=HERMES&font=Slant" | boxes -d stone
+```
+
+## Tool 5: TOIlet（彩色文本艺术）
+
+类似于 pyfiglet，但具有 ANSI 颜色效果和视觉 filters。非常适合用作 terminal 里的视觉效果。
+
+### 配置
+
+```bash
+sudo apt install toilet toilet-fonts -y    # Debian/Ubuntu
+# brew install toilet                      # macOS
+```
+
+### 用法
+
+```bash
+toilet "Hello World"                    # Basic text art
+toilet -f bigmono12 "Hello"            # Specific font
+toilet --gay "Rainbow!"                 # Rainbow coloring
+toilet --metal "Metal!"                 # Metallic effect
+toilet -F border "Bordered"             # Add border
+toilet -F border --gay "Fancy!"         # Combined effects
+toilet -f pagga "Block"                 # Block-style font (unique to toilet)
+toilet -F list                          # List available filters
+```
+
+### Filters
+
+`crop`, `gay` (rainbow), `metal`, `flip`, `flop`, `180`, `left`, `right`, `border`
+
+**Note**: toilet 输出用于颜色的 ANSI 转义序列 —— 可以在 terminal 中正常工作，但在某些场景下可能无法正常渲染（例如：纯文本文件、部分聊天平台）。
+
+## Tool 6: 图像转 ASCII 艺术
+
+将图像（PNG、JPEG、GIF、WEBP）转换为 ASCII 艺术。
+
+### Option A: ascii-image-converter（推荐，现代）
+
+```bash
+# Install
+sudo snap install ascii-image-converter
+# OR: go install github.com/TheZoraiz/ascii-image-converter@latest
+```
+
+```bash
+ascii-image-converter image.png                  # Basic
+ascii-image-converter image.png -C               # Color output
+ascii-image-converter image.png -d 60,30         # Set dimensions
+ascii-image-converter image.png -b               # Braille characters
+ascii-image-converter image.png -n               # Negative/inverted
+ascii-image-converter https://url/image.jpg      # Direct URL
+ascii-image-converter image.png --save-txt out   # Save as text
+```
+
+### Option B: jp2a（轻量级，仅限 JPEG）
+
+```bash
+sudo apt install jp2a -y
+jp2a --width=80 image.jpg
+jp2a --colors image.jpg              # Colorized
+```
+
+## Tool 7: 搜索预制 ASCII 艺术
+
+从网络搜索精选的 ASCII 艺术。结合 `terminal` 和 `curl` 使用。
+
+### Source A: ascii.co.uk（推荐用于获取预制艺术）
+
+按主题分类的大量经典 ASCII 艺术合集。艺术内容位于 HTML 的 `<pre>` 标签内。使用 curl 抓取页面，然后用一小段 Python 脚本提取艺术内容。
+
+**URL 模式：** `https://ascii.co.uk/art/{subject}`
+
+**Step 1 — 抓取页面：**
+
+```bash
+curl -s 'https://ascii.co.uk/art/cat' -o /tmp/ascii_art.html
+```
+
+**Step 2 — 从 pre 标签中提取艺术内容：**
+
+```python
+import re, html
+with open('/tmp/ascii_art.html') as f:
+    text = f.read()
+arts = re.findall(r'<pre[^>]*>(.*?)</pre>', text, re.DOTALL)
+for art in arts:
+    clean = re.sub(r'<[^>]+>', '', art)
+    clean = html.unescape(clean).strip()
+    if len(clean) > 30:
+        print(clean)
+        print('\n---\n')
+```
+
+**可用主题**（用作 URL 路径）：
+- Animals: `cat`, `dog`, `horse`, `bird`, `fish`, `dragon`, `snake`, `rabbit`, `elephant`, `dolphin`, `butterfly`, `owl`, `wolf`, `bear`, `penguin`, `turtle`
+- Objects: `car`, `ship`, `airplane`, `rocket`, `guitar`, `computer`, `coffee`, `beer`, `cake`, `house`, `castle`, `sword`, `crown`, `key`
+- Nature: `tree`, `flower`, `sun`, `moon`, `star`, `mountain`, `ocean`, `rainbow`
+- Characters: `skull`, `robot`, `angel`, `wizard`, `pirate`, `ninja`, `alien`
+- Holidays: `christmas`, `halloween`, `valentine`
+
+**Tips：**
+- 保留艺术家的签名/姓名首字母 —— 这是一项重要的网络礼仪
+- 每个页面包含多件艺术作品 —— 为用户挑选最好的一件
+- 通过 curl 可靠运行，无需 JavaScript
+
+### Source B: GitHub Octocat API（有趣的彩蛋）
+
+返回带有智者名言的随机 GitHub Octocat。无需身份验证。
+
+```bash
+curl -s https://api.github.com/octocat
+```
+
+## Tool 8: 趣味 ASCII 实用工具（通过 curl）
+
+这些免费服务可直接返回 ASCII 艺术 —— 非常适合用作趣味扩展。
+
+### 作为 ASCII 艺术的 QR Codes
+
+```bash
+curl -s "qrenco.de/Hello+World"
+curl -s "qrenco.de/https://example.com"
+```
+
+### 作为 ASCII 艺术的天气
+
+```bash
+curl -s "wttr.in/London"          # Full weather report with ASCII graphics
+curl -s "wttr.in/Moon"            # Moon phase in ASCII art
+curl -s "v2.wttr.in/London"       # Detailed version
+```
+
+## Tool 9: LLM 生成的自定义艺术（回退方案）
+
+当上述工具无法提供所需内容时，直接使用这些 Unicode 字符生成 ASCII 艺术：
+
+### 字符调色板
+
+**Box Drawing:** `╔ ╗ ╚ ╝ ║ ═ ╠ ╣ ╦ ╩ ╬ ┌ ┐ └ ┘ │ ─ ├ ┤ ┬ ┴ ┼ ╭ ╮ ╰ ╯`
+
+**Block Elements:** `░ ▒ ▓ █ ▄ ▀ ▌ ▐ ▖ ▗ ▘ ▝ ▚ ▞`
+
+**Geometric & Symbols:** `◆ ◇ ◈ ● ○ ◉ ■ □ ▲ △ ▼ ▽ ★ ☆ ✦ ✧ ◀ ▶ ◁ ▷ ⬡ ⬢ ⌂`
+
+### 规则
+
+- 最大宽度：每行 60 个字符（适配 terminal）
+- 最大高度：横幅 15 行，场景 25 行
+- 仅限 Monospace：输出必须在等宽字体中正确渲染
+
+## 决策流程
+
+1. **将文本作为横幅** → 如果已安装则用 pyfiglet，否则通过 curl 使用 asciified API
+2. **将消息包裹在趣味字符艺术中** → cowsay
+3. **添加装饰边框/框架** → boxes（可与 pyfiglet/asciified 结合使用）
+4. **特定事物的艺术**（猫、火箭、龙）→ 通过 curl 解析 ascii.co.uk
+5. **将图像转换为 ASCII** → ascii-image-converter 或 jp2a
+6. **QR code** → 通过 curl 访问 qrenco.de
+7. **天气/月亮艺术** → 通过 curl 访问 wttr.in
+8. **自定义/创意内容** → 使用 Unicode 调色板的 LLM 生成
+9. **任何未安装的工具** → 安装它，或者回退到下一个选项

package/extensions/skills/builtin/creative/ascii-video/README.md

@@ -0,0 +1,290 @@
+# ascii-video 说明
+
+将任何内容渲染为彩色 ASCII 字符视频。支持音频、视频、图像、文本或纯数学公式作为输入，输出 MP4/GIF/PNG 序列。每个字符单元支持全 RGB 色彩，默认为 1080p 24fps。无需 GPU。
+
+专为 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 构建。可在任何编程 agent 中使用。权威源码位于此处；通过 PR 同步至 [`NousResearch/hermes-agent/skills/creative/ascii-video`](https://github.com/NousResearch/hermes-agent/tree/main/skills/creative/ascii-video)。
+
+## 这是什么
+
+一项技能，教导 agent 如何从头开始构建单文件 Python 渲染器以生成 ASCII 视频。agent 将掌握完整的处理流程：网格系统、字体栅格化、效果库、shader 链、音频分析和并行编码。它会编写渲染器代码，运行它，并获得视频。
+
+输出的是实际的视频。而不是终端 escape 代码。画面帧被计算为彩色字符网格，与预栅格化的字体位图合成到像素画布上，通过 shader 进行后期处理，最后通过管道传递给 ffmpeg。
+
+## 模式
+
+| 模式 | 输入 | 输出 |
+|------|-------|--------|
+| Video-to-ASCII | 视频文件 | 画面的 ASCII 重构 |
+| Audio-reactive | 音频文件 | 由频段、节拍、能量驱动的视觉效果 |
+| Generative | 无 | 基于数学的程序化动画 |
+| Hybrid | 视频 + 音频 | 带有音频驱动叠加层的 ASCII 视频 |
+| Lyrics/text | 音频 + 定时文本 (SRT) | 带有特效的卡拉 OK 式文本 |
+| TTS narration | 文本引用 + API key | 带有打字机文本和生成语音的旁白视频 |
+
+## Pipeline
+
+每种模式都遵循相同的 6 阶段路径：
+
+```
+INPUT --> ANALYZE --> SCENE_FN --> TONEMAP --> SHADE --> ENCODE
+```
+
+1. **Input** 加载源素材（Generative 模式则为空）。
+2. **Analyze** 提取每一帧的特征。音频提取包含 6 频段 FFT、RMS、频谱质心、平坦度、通量以及带指数衰减的节拍检测。视频提取包含亮度、边缘和动态。
+3. **Scene function** 直接返回像素画布。在不同密度、明度/色相场和像素混合模式下合成多个字符网格。这是生成视觉效果的核心环节。
+4. **Tonemap** 进行基于自适应百分位的亮度归一化，并带有逐场景的 gamma 设置。黑色背景上的 ASCII 本身偏暗。线性乘法不起作用。而这个方法有效。
+5. **Shade** 运行 `ShaderChain`（38 个可组合 shader）以及 `FeedbackBuffer`，用于具有空间变换的时间递归。
+6. **En代码** 通过管道将原始 RGB 帧传递给 ffmpeg 进行 H.264 编码。片段被拼接在一起，并进行音频复用。
+
+## 网格系统
+
+字符在固定大小的网格上渲染。通过叠加不同密度来营造层次感。
+
+| 尺寸 | 字体大小 | 1080p 下的网格 | 用途 |
+|------|------|---------------|-----|
+| xs | 8px | 400x108 | 超高密度数据场 |
+| sm | 10px | 320x83 | 雨滴、星空 |
+| md | 16px | 192x56 | 默认平衡模式 |
+| lg | 20px | 160x45 | 可读文本 |
+| xl | 24px | 137x37 | 大标题 |
+| xxl | 40px | 80x22 | 极简巨幅 |
+
+在 `sm` 和 `lg` 上渲染同一场景，然后进行屏幕混合，会创建自然的纹理干涉。精细细节会透过粗糙字符的间隙显现出来。大多数场景使用两到三个网格。
+
+## 字符调色板 (24)
+
+每一个都按照从暗到亮排序，呈现出不同的视觉纹理。在初始化时针对字体进行验证，因此损坏的字形会被静默丢弃。
+
+| 家族 | 示例 | 感觉 |
+|--------|----------|------|
+| Density ramps | ` .:-=+#@█` | 经典 ASCII 艺术渐变 |
+| Block elements | ` ░▒▓█▄▀▐▌` | 粗犷、数字感 |
+| Braille | ` ⠁⠂⠃...⠿` | 细腻的点彩法 |
+| Dots | ` ⋅∘∙●◉◎` | 平滑、有机 |
+| Stars | ` ·✧✦✩✨★✶` | 闪耀、天体感 |
+| Half-fills | ` ◔◑◕◐◒◓◖◗◙` | 方向性填充递进 |
+| Crosshatch | ` ▣▤▥▦▧▨▩` | 交叉阴影密度渐变 |
+| Math | ` ·∘∙•°±×÷≈≠≡∞∫∑Ω` | 科学、抽象 |
+| Box drawing | ` ─│┌┐└┘├┤┬┴┼` | 结构感、电路风格 |
+| Katakana | ` ·ｦｧｨｩｪｫｬｭ...` | Matrix 雨效果 |
+| Greek | ` αβγδεζηθ...ω` | 古典、学术 |
+| Runes | ` ᚠᚢᚦᚱᚷᛁᛇᛒᛖᛚᛞᛟ` | 神秘、古老 |
+| Alchemical | ` ☉☽♀♂♃♄♅♆♇` | 深奥 |
+| Arrows | ` ←↑→↓↔↕↖↗↘↙` | 方向感、动感 |
+| Music | ` ♪♫♬♩♭♮♯○●` | 音乐感 |
+| Project-specific | ` .·~=≈∞⚡☿✦★⊕◊◆▲▼●■` | 根据项目定制主题 |
+
+为每个项目构建自定义调色板以匹配其内容。
+
+## 色彩策略
+
+| 策略 | 色相映射方式 | 适用场景 |
+|----------|----------------|----------|
+| Angle-mapped | 距中心的位置角 | 彩虹径向效果 |
+| Distance-mapped | 距中心的距离 | 深度、隧道 |
+| Frequency-mapped | 音频频谱质心 | 音色变换 |
+| Value-mapped | 亮度级别 | 热力图、火焰 |
+| Time-cycled | 随时间缓慢旋转 | 环境氛围、放松 |
+| Source-sampled | 原始视频像素颜色 | Video-to-ASCII |
+| Palette-indexed | 离散查找表 | 复古、平面图形 |
+| Temperature | 暖色到冷色混合 | 情感基调 |
+| Complementary | 色相 + 对比色 | 醒目、极具戏剧性 |
+| Triadic | 三个等距色相 | 迷幻、充满活力 |
+| Analogous | 相邻色相 | 和谐、微妙 |
+| Monochrome | 固定色相，改变 S/V | 黑色电影风格、聚焦 |
+
+外加 10 种离散 RGB 调色板（neon、pastel、cyberpunk、vaporwave、earth、ice、blood、forest、mono-green、mono-amber）。
+
+完整的 OKLAB/OKLCH 色彩系统：sRGB↔linear↔OKLAB 转换流水线、感知均匀的渐变插值以及色彩和谐度生成（complementary、triadic、analogous、split-complementary、tetradic）。
+
+## 明度场生成器 (21)
+
+明度场是核心视觉构建块。每个生成器都会生成一个位于 [0, 1] 之间的二维浮点数组，将每个网格单元映射为一个亮度值。
+
+### 三角函数 (12)
+
+| 字段 | 说明 |
+|-------|-------------|
+| Sine field | 分层多正弦干涉，通用背景 |
+| Smooth noise | 对 Perlin 噪声进行多倍频正弦近似 |
+| Rings | 同心圆环，由低音驱动数量和摆动 |
+| Spiral | 对数螺旋臂，可配置臂数/紧凑度 |
+| Tunnel | 无限深度透视（倒数距离） |
+| Vortex | 扭曲的径向图案，距离调制角度 |
+| Interference | N 个重叠正弦波产生莫尔条纹 |
+| Aurora | 水平流动的色带 |
+| Ripple | 从可配置源点发出的同心波 |
+| Plasma | 多个方向/速度的正弦波总和 |
+| Diamond | 菱形/棋盘格图案 |
+| Noise/static | 随机逐格逐帧闪烁 |
+
+### 基于噪声 (4)
+
+| 字段 | 说明 |
+|-------|-------------|
+| Value noise | 平滑的有机噪声，无坐标轴对齐伪影 |
+| fBM | 分形布朗运动——用于云层、地形、烟雾的倍频噪声 |
+| Domain warp | Inigo Quilez 技术——基于 fBM 驱动的坐标扭曲，用于流动的有机形态 |
+| Voronoi | 移动的种子点，支持距离、边缘和 Cell-ID 输出模式 |
+
+### 基于模拟 (4)
+
+| 字段 | 说明 |
+|-------|-------------|
+| Reaction-diffusion | Gray-Scott 模型，包含 7 种预设：coral、spots、worms、labyrinths、mitosis、pulsating、chaos |
+| Cellular automata | 生命游戏 + 4 种规则变体，带有相似色调的淡化轨迹 |
+| Strange attractors | Clifford、De Jong、Bedhead——迭代点系统分箱为密度场 |
+| Temporal noise | 在原位平滑形变的 3D 噪声，无方向漂移 |
+
+### 基于 SDF
+
+7 种带符号距离场基元（circle、box、ring、line、triangle、star、heart），带有平滑布尔组合器（union、intersection、subtraction、smooth union/subtraction）和无限平铺功能。可渲染为实心填充或发光轮廓。
+
+## 色相场生成器 (9)
+
+独立于亮度决定每个单元的颜色：固定色相、角度映射的彩虹、距离渐变、时间循环旋转、音频频谱质心、水平/垂直渐变、Plasma 变换、感知均匀的 OKLCH 彩虹。
+
+## 坐标变换 (11)
+
+在效果计算前应用的 UV 空间变换：rotate、scale、skew、tile（带镜像接缝）、polar、inverse-polar、twist（旋转随距离增加）、fisheye、wave displacement、Möbius conformal transformation。`make_tgrid()` 将变换后的坐标包装成网格对象。
+
+## 粒子系统 (9)
+
+| 类型 | 行为 |
+|------|----------|
+| Explosion | 节拍触发的径向爆发，带有重力和生命衰减 |
+| Embers | 从底部上升，带有水平漂移 |
+| Dissolving cloud | 向外扩散，伴随加速淡出 |
+| Starfield | 3D 投影，具有 Z 轴深度的星星拖着条纹轨迹逼近 |
+| Orbit | 围绕中心的圆形/椭圆路径 |
+| Gravity well | 被可配置的点源吸引 |
+| Boid flocking | 分离/对齐/聚合，使用空间哈希实现 O(n) 邻居查找 |
+| Flow-field | 由任意明度场的梯度引导 |
+| Trail particles | 在当前位置和上一个位置之间淡出的线条 |
+
+14 种主题化粒子字符集（energy、spark、leaf、snow、rain、bubble、data、hex、binary、rune、zodiac、dot、dash）。
+
+## 时间连贯性
+
+10 种缓动函数（linear、quad、cubic、expo、elastic、bounce——in/out/in-out）。带有平滑过渡的关键帧插值。明度场变形（场之间的平滑交叉淡入淡出）。明度场序列（带交叉淡入淡出循环切换场）。时间噪声（在原位平滑演变的 3D 噪声）。
+
+## Shader 流水线
+
+38 个可组合 shader，在字符渲染后应用于像素画布。可针对不同部分进行配置。
+
+| 类别 | Shader |
+|----------|---------|
+| Geometry | CRT barrel、pixelate、wave distort、displacement map、kaleidoscope、mirror (h/v/quad/diag) |
+| Channel | Chromatic aberration (beat-reactive)、channel shift、channel swap、RGB split radial |
+| Color | Invert、posterize、threshold、solarize、hue rotate、saturation、color grade、color wobble、color ramp |
+| Glow/Blur | Bloom、edge glow、soft focus、radial blur |
+| Noise | Film grain (beat-reactive)、static noise |
+| Lines/Patterns | Scanlines、halftone |
+| Tone | Vignette、contrast、gamma、levels、brightness |
+| Glitch/Data | Glitch bands (beat-reactive)、block glitch、pixel sort、data bend |
+
+12 种色彩色调预设：warm、cool、matrix green、amber、sepia、neon pink、ice、blood、forest、void、sunset、neutral。
+
+7 种针对常用 shader 组合的氛围预设：
+
+| 氛围 | Shader |
+|------|---------|
+| Retro 终端 | CRT + scanlines + grain + amber/green tint |
+| Clean modern | Light bloom + subtle vignette |
+| Glitch art | Heavy chromatic + glitch bands + color wobble |
+| Cinematic | Bloom + vignette + grain + color grade |
+| Dreamy | Heavy bloom + soft focus + color wobble |
+| Harsh/industrial | High contrast + grain + scanlines, no bloom |
+| Psychedelic | Color wobble + chromatic + kaleidoscope mirror |
+
+## 混合模式与合成
+
+20 种用于分层画布的像素混合模式：normal、add、subtract、multiply、screen、overlay、softlight、hardlight、difference、exclusion、colordodge、colorburn、linearlight、vividlight、pin_light、hard_mix、lighten、darken、grain_extract、grain_merge。同时支持 sRGB 和 linear-light 混合。
+
+**Feedback buffer.** 时间递归——每一帧与前一帧的变换版本混合。7 种空间变换：zoom、shrink、rotate CW/CCW、shift up/down、mirror。可选的逐帧色相偏移以产生彩虹拖尾。可针对每个场景配置衰减、混合模式和不透明度。
+
+**Masking.** 用于空间合成的 16 种遮罩类型：形状遮罩（circle、rect、ring、gradients）、程序化遮罩（任何明度场都可作为遮罩，文本模板）、动画遮罩（iris open/close、wipe、dissolve）、布尔操作（union、intersection、subtraction、invert）。
+
+**Transitions.** Crossfade、directional wipe、radial wipe、dissolve、glitch cut。
+
+## 场景设计模式
+
+旨在让场景看起来是有意为之而非随机生成的构图模式。
+
+**层级结构。** 背景层（昏暗的氛围、高密度网格）、内容层（主要视觉、标准网格）、强调层（稀疏的高光、粗糙网格）。三种截然不同的分工，而不是三个相互竞争的图层。
+
+**方向性参数弧线。** 每个场景的决定性参数在其持续时间内进行攀升、加速或构建。基于进度的公式（linear、ease-out、step reveal）取代了漫无目的的 `sin(t)` 振荡。
+
+**场景概念。** 围绕视觉隐喻构建的场景（emergence、descent、collision、entropy），带有富有目的性的图层/调色板/反馈选择。不根据其使用的效果来命名。
+
+**构图技巧。** 双反向旋转系统、波浪碰撞、渐进式碎片化（voronoi 单元随时间成倍增加）、entropy（几何被 reaction-diffusion 吞噬）、交错式图层进入（高潮蓄势）。
+
+## 硬件适配
+
+自动检测 CPU 核心数、RAM、平台、ffmpeg。自适应调整 worker 数量、分辨率、FPS。
+
+| Pro文件 | 分辨率 | FPS | 适用情况 |
+|---------|-----------|-----|------|
+| `draft` | 960x540 | 12 | 检查时间/布局 |
+| `preview` | 1280x720 | 15 | 查看效果 |
+| `production` | 1920x1080 | 24 | 最终输出 |
+| `max` | 3840x2160 | 30 | 超高画质 |
+| `auto` | 自动检测 | 24 | 根据硬件和时长自适应 |
+
+`auto` 会预估渲染时间，如果耗时预计超过一小时，则会自动降级。低内存系统会自动降至 720p。
+
+### 渲染耗时 (1080p 24fps, ~180ms/frame/worker)
+
+| 时长 | 4 workers | 8 workers | 16 workers |
+|----------|-----------|-----------|------------|
+| 30s | ~3 min | ~2 min | ~1 min |
+| 2 min | ~13 min | ~7 min | ~4 min |
+| 5 min | ~33 min | ~17 min | ~9 min |
+| 10 min | ~65 min | ~33 min | ~17 min |
+
+720p 的耗时大约减半。4K 的耗时大约翻两番。
+
+## 常见陷阱
+
+**Brightness.** ASCII 字符是黑色背景上的细小亮点。大多数帧像素都是背景。线性的 `* N` 乘法会裁剪掉高光并导致画面泛白。请改用带有逐场景 gamma 设置的 `tonemap()`。默认 gamma 为 0.75，solarize 场景为 0.55，posterize 场景为 0.50。
+
+**渲染瓶颈。** 用于合成字体位图的 Python 逐格循环运行速度约为 100-150ms/帧。如果没有 Cython/C，这是不可避免的。其他所有内容必须使用向量化 numpy。在效果函数中对行/列执行的 Python for 循环会严重拖垮性能。
+
+**ffmpeg 死锁。** 绝不要在长时间运行的 En代码 中使用 `stderr=subprocess.PIPE`。缓冲区在 ~64KB 时会被填满，导致 进程 挂起。请将 stderr 重定向到 文件。
+
+**字体单元高度。** Pillow 的 `textbbox()` 在 macOS 上返回的高度是错误的。对于 `ascent + descent`，请使用 `font.getmetrics()`。
+
+**字体兼容性。** 并非所有 Uni代码 字形都能在所有字体中渲染。调色板在初始化时会进行验证，空白的字形会被静默移除。
+
+## 要求
+
+◆ Python 3.10+
+◆ NumPy, Pillow, SciPy (audio modes)
+◆ ffmpeg on PATH
+◆ 等宽字体 (Menlo, Courier, Monaco, auto-detected)
+◆ 可选: OpenCV, ElevenLabs API key (TTS mode)
+
+## 文件结构
+
+```
+├── SKILL.md                 # 模式、工作流程、创意方向
+├── README.md                # 本文件
+└── references/
+    ├── architecture.md      # 网格系统、字体、调色板、色彩、_render_vf()
+    ├── effects.md           # 明度场、色相场、背景、粒子
+    ├── shaders.md           # 38 个 shader、ShaderChain、色调预设、转场
+    ├── composition.md       # 混合模式、多网格、tonemap、FeedbackBuffer
+    ├── scenes.md            # 场景协议、SCENES 表格、render_clip()、示例
+    ├── design-patterns.md   # 图层结构、方向弧线、场景概念
+    ├── inputs.md            # 音频分析、视频采样、文本、TTS
+    ├── optimization.md      # 硬件检测、向量化模式、并行性
+    └── troubleshooting.md   # 广播陷阱、混合陷阱、诊断
+```
+
+## 使用此技能构建的项目
+
+✦ 85 秒精彩集锦。15 个场景（14×5s + 15s 高潮结尾），随机顺序，方向性参数弧线，分层结构构图。展示了完整的效果词汇表：fBM、voronoi 碎片化、reaction-diffusion、cellular automata、双反向旋转螺旋、波浪碰撞、domain warping、隧道下坠、万花筒对称、boid flocking、火焰模拟、glitch 损坏，以及 7 层高潮蓄势。
+
+✦ 音频反应式音乐可视化工具。3.5 分钟，8 个带有独特效果的部分，节拍触发的粒子和 glitch，循环的调色板。
+
+✦ TTS 旁白推荐视频。23 段引语，每段引语使用 ElevenLabs 声音，15% 宽立体声背景音乐，支持针对每个片段进行重新渲染以便于迭代剪辑。