前言¶

在视频生成开发中，获取反馈通常意味着调用付费 API。MiniMax H3 是一项付费服务。在没有实际生成的情况下验证提示词和运动逻辑是一个常见痛点。ASCII H3 Director 旨在解决这个问题，将自由描述编译为结构化的提示词，并提供零依赖的预览引擎。

这是什么¶

ASCII H3 Director 是一个为 MiniMax H3 服务的导演工具。它将自由描述编译为变形链与确定性预览引擎。由 SaltCoffee 维护，既是 DeepSeek Harness（DSH）插件，也是可移植的 Agent Skill。

核心功能¶

该工具提供确定性预览引擎，不依赖 mmx-cli 或网络请求。核心能力包括：

• 零依赖预览引擎：使用内置 5×9 手工点阵字库，可在终端、SVG 和 PNG 中渲染帧。
• 运动语法：支持通过 21 条机制进行结构化运动设计。
• 连续性契约：确保帧与帧之间的逻辑衔接，包括接缝检查。
• 质量闸门：7 项自动检查，根据特定标准对生成的方案进行打分。
• Director Console：为 DSH Web UI 提供的面板。
• Agent Skill：可移植技能包，用于编码代理。

安装与启用¶

通过 npm 安装 DSH 插件：

dsh plugin --profile web add @yankafei/ascii-h3-director

作为 Agent Skill 安装：

mkdir -p ~/.agents/skills
cp -R skill ~/.agents/skills/ascii-h3-director
# 或运行安装脚本
skill/INSTALL.command

典型用法¶

1. 检查环境：

    ascii-h3 doctor

2. 生成导演方案：

    ascii-h3 plan "15s ASCII clip about memory collapsing into language"

3. 终端预览：

    ascii-h3 preview "a brutalist ASCII tunnel..." --cols 100

4. 制作印样：

    ascii-h3 strip "brutalist ASCII tunnel..." --frames 6 --out sheet.png

5. 导出提示词：

    ascii-h3 prompt "..." --out prompt.txt

适用场景与注意¶

• 需要 Node.js 18+ 环境。
• 引擎本身不依赖 mmx-cli；该 CLI 仅用于付费生成步骤。
• H3 视频生成是一项付费服务。
• 适用于需要提示词和运动逻辑结构化的 DSH 开发者和编码代理。