ASCII 视频

ASCII 视频：将视频/音频转换为彩色 ASCII 动画

ASCII 视频制作流水线

使用场景

当用户提出以下请求时使用：ASCII 视频、文本艺术视频、终端风格视频、字符艺术动画、复古文本可视化、ASCII 音频可视化、将视频转换为 ASCII 艺术、矩阵风格特效，或任何动画 ASCII 输出。

内部内容

ASCII 艺术视频的制作流水线——支持任意格式。可将视频/音频/图像/生成式输入转换为彩色 ASCII 字符视频输出（MP4、GIF、图像序列）。涵盖：视频转 ASCII、音频响应式音乐可视化、生成式 ASCII 艺术动画、视频+音频混合响应、文本/歌词叠加、实时终端渲染。

创意标准

这是视觉艺术。ASCII 字符是媒介；电影是标准。

在编写任何一行代码之前，先阐明创意概念。氛围是什么？它讲述了怎样的视觉故事？是什么让「这个」项目不同于其他任何 ASCII 视频？用户的提示词只是起点——用创意野心去诠释它，而不是逐字照搬。

首次渲染即达卓越，绝无妥协。输出必须无需多轮修改即具有视觉冲击力。如果画面看起来平庸、平淡，或像「AI 生成的 ASCII 艺术」，那就是错的——在交付前重新思考创意概念。

超越参考词汇表。参考中的特效目录、着色器预设和调色板库只是起始词汇。每个项目都应组合、修改并创造新的模式。目录只是一盒颜料——画作由你来完成。

主动发挥创意。当项目需要时，扩展技能的词汇表。如果参考中没有视觉构想所需的内容，就亲手构建它。至少加入一个用户没有要求但会欣赏的视觉瞬间——一个转场、一个特效、一个能提升整体作品的色彩选择。

美学整体性高于技术正确性。视频中的所有场景必须由统一的视觉语言联系在一起——共享的色温、相关联的字符调色板、一致的运动词汇。一个技术上正确但每个场景都使用随机不同特效的视频，在美学上是失败的。

致密、分层、深思熟虑。每一帧都应值得细看。绝不使用纯黑背景。始终采用多网格构图。始终进行逐场景变化。始终有意图地运用色彩。

模式

技术栈

每个项目使用一个独立的 Python 脚本。无需 GPU。

流水线架构

每种模式都遵循相同的 6 阶段流水线：

INPUT → ANALYZE → SCENE_FN → TONEMAP → SHADE → ENCODE

创意指导

美学维度

逐段落变化

绝不对整段视频使用同一配置。对每个段落/场景：

项目专属创新

每个项目至少创造以下之一：

不要只是从目录中挑选。目录只是词汇——诗由你来写。

工作流程

第 1 步：创意构想

在编写任何代码之前，先阐明创意概念：

将用户的提示词映射为美学选择。一个「轻松的 lo-fi 可视化」与一个「故障赛博朋克数据流」对一切的要求都截然不同。

第 2 步：技术设计

第 3 步：构建脚本

单个 Python 文件。组件（附参考）：

第 4 步：质量验证

关键实现注意事项

亮度 —— 使用 `tonemap()`，而非线性乘数

这是头号视觉问题。黑底上的 ASCII 天生偏暗。绝不使用 canvas * N 乘数——它们会裁剪高光。使用自适应色调映射：

def tonemap(canvas, gamma=0.75):
    f = canvas.astype(np.float32)
    lo, hi = np.percentile(f[::4, ::4], [1, 99.5])
    if hi - lo < 10: hi = lo + 10
    f = np.clip((f - lo) / (hi - lo), 0, 1) ** gamma
    return (f * 255).astype(np.uint8)

流水线：scene_fn() → tonemap() → FeedbackBuffer → ShaderChain → ffmpeg

逐场景 gamma：默认 0.75，负片化（solarize）0.55，色调分离（posterize）0.50，明亮场景 0.85。深色图层使用 screen 混合（而非 overlay）。

字体单元格高度

macOS 上的 Pillow：textbbox() 返回的高度不正确。请使用 font.getmetrics()：cell_height = ascent + descent。参见 references/troubleshooting.md。

ffmpeg 管道死锁

绝不与长时间运行的 ffmpeg 一起使用 stderr=subprocess.PIPE——缓冲区在 64KB 处填满并导致死锁。请重定向到文件。参见 references/troubleshooting.md。

字体兼容性

并非所有 Unicode 字符都能在所有字体中渲染。在初始化时验证调色板——渲染每个字符，检查是否有空白输出。参见 references/troubleshooting.md。

逐片段架构

对于分段视频（引言、场景、章节），将每段渲染为独立的片段文件，以便并行渲染和选择性重渲染。参见 references/scenes.md。

性能目标

参考资料

---

创意发散（仅在用户要求实验性/创意性/独特输出时使用）

如果用户要求创意性、实验性、令人惊喜或非常规的输出，请选择最合适的策略，并在生成代码之前推演其步骤。

强制关联

概念融合

斜向策略