dsh-tutorial-video-state-machine

DeepSeek Harness 个人适配声明（Personal Adaptation Notice）

本项目是 DeepSeek Harness 的个人适配产物（personal adaptation），并非 DeepSeek Harness 官方文件（not an official DeepSeek Harness file），随附功能、使用说明与个人产物（bundled with features, documentation, and personal artifacts），可与 DeepSeek Harness 搭配使用，也可独立使用。

This project is a personal adaptation for DeepSeek Harness, and is NOT an official DeepSeek Harness file, bundled with features, documentation, and personal artifacts. It can be used alongside DeepSeek Harness or standalone.

作者 / Author: h565656445

合作 / Collaboration: 如有项目可以一起合作，欢迎联系。微信：wohaishihenshuaide。If you have projects, let's collaborate. WeChat: wohaishihenshuaide.

---

用途 / What this is for

教程视频状态机：教程视频的分阶段状态机、阶段清单与视觉门审批 Schema。

Tutorial video state machine: staged state machine, stage manifests and visual-gate approval schemas.

---

Tutorial Video State Machine / 教程视频状态机

面向已有结构化课程数据、配音资产和 Remotion 工程的确定性本地生产切片。默认兼容路径 content_locked → audio_ready → composition_ready → rendered → waiting_for_approval；可选 Canvas/SVG/React 视觉语法路径额外经过 visual_grammar_ready → styleframe_ready → styleframe_approved → motion_proof_ready → motion_proof_approved，其中 styleframe 与 motion_proof 两处为哈希绑定的人工审批门（每门最多两次尝试）。状态转换只由脚本完成；Worker 或模型只能提交阶段清单，不能自行改状态，也不能替自己批准。

A deterministic local production slice for tutorial videos built from existing structured course data, voice assets and Remotion projects. Default compatible path: content_locked → audio_ready → composition_ready → rendered → waiting_for_approval. The optional Canvas/SVG/React visual-grammar path adds visual_grammar_ready → styleframe_ready → styleframe_approved → motion_proof_ready → motion_proof_approved, with hash-bound human approval gates at styleframe and motion_proof (max two attempts per gate). Transitions are script-only; workers/models submit stage manifests but can neither change state nor approve themselves.

Features / 功能

• 哈希绑定人工审批门：styleframe/motion_proof 暂停等待 SHA-256 绑定批准，最多两次尝试 / Hash-bound human approval gates at styleframe/motion_proof (pause for SHA-256-bound approval; max two attempts)
• 清单真实性校验：每份阶段清单中的文件必须真实存在且 SHA-256 匹配 / Manifest integrity: every listed file must exist and match its SHA-256
• Schema 驱动：schemas/ 五份 JSON Schema 定义状态、阶段清单、运动组件包、场景规格与审批文件 / Schema-driven: five JSON Schemas define state, stage manifests, motion component packs, scene specs and approval files
• Pester 回归测试：tests/TutorialVideoStateMachine.Tests.ps1 / Pester regression tests

What's inside / 目录结构

tutorial-video-state-machine.ps1  状态机入口（Initialize / Advance / Resubmit / Approve / Inspect）
schemas/                           状态、阶段清单、运动组件包、场景规格、审批 Schema
tests/                             Pester 回归测试

Quick start / 快速开始

# 初始化一个运行
pwsh -NoProfile -File .\tutorial-video-state-machine.ps1 -Action Initialize `
  -RuntimeRoot <runtime> -TaskContractPath <contract.json> -EpisodeId S01E03 `
  -CompositionId S01E03-MG-Master -ProjectRoot <project> -Width 1440 -Height 1080 -Fps 30 -AsJson

# 提交阶段清单（Advance / Resubmit / Approve / Inspect 同理）
pwsh -NoProfile -File .\tutorial-video-state-machine.ps1 -Action Advance `
  -RuntimeRoot <runtime> -RunPath <run_path> -ManifestPath <run_path>\manifests\audio-ready.json -AsJson

# 回归测试
Invoke-Pester .\tests\TutorialVideoStateMachine.Tests.ps1

依赖说明：脚本运行依赖 Hermes Ledger 事务模块（HermesLedgerTransaction.psm1）与 harness 的 HermesJsonProjection.psm1；按开源清单未包含在本仓库，独立运行需自行提供等价模块。

DeepSeek Harness 衍生 / DSH Derivative

本项目附带 DeepSeek Harness 衍生包，位于 .dsh/ 目录：

• preset.yml — Agent 预设元数据
• agent.cordis.yml — Cordis 组装（基于 standard 预设，persona 已定制）
• skills/dsh-tutorial-video-state-machine/SKILL.md — 项目专属技能（skill）

安装与接入方式见 .dsh/README.md（双语）。

License / 许可证

MIT

---

---

相关项目 / Related Projects

这是 DeepSeek Harness 个人适配系列（共 31 个仓库）的完整导航。 / This is the complete navigation for the DeepSeek Harness personal-adaptation series (31 repos).

Agent OS 内核 / Kernel

dsh-agent-os-runtime · dsh-agent-os-planning · dsh-agent-os-scheduler · dsh-agent-os-worker-protocol · dsh-agent-os-observability · dsh-agent-os-specs

Harness 基础设施 / Infrastructure

dsh-harness-core · dsh-graph-entry · dsh-async-job · dsh-file-identity · dsh-json-projection · dsh-manual-approval · dsh-observation-writer · dsh-provider-control · dsh-schema-negotiator · dsh-upgrade-governance

规格与文档 / Specs & Docs

dsh-harness-specs · dsh-novel-specs · dsh-architecture-guide · dsh-powershell-patterns · dsh-json-schema-driven-dev · dsh-llm-agent-harness-guide

适配器 / Adapters

dsh-short-story-engine · dsh-tutorial-video-state-machine（本仓库 / this repo） · dsh-governance-kernel · dsh-sports-pipeline · dsh-motion-grammar

DSH 总集成 / Integration

dsh-integration · dsh-presets-pack · dsh-skills-pack · dsh-starter-kit