前言¶

在視頻生成開發中，獲取反饋通常意味着調用付費 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 開發者和編碼代理。