How mcncarl/jianying-headless works
Jianying Headless is a local editing automation tool: users provide media and a structured plan, generate an editable Jianying draft, verify it, optionally register it in the local Jianying home page, and export a verified snapshot. Existing-project editing is a separate private-copy workflow; Windows FFmpeg export is a separate, non-editable backend. The map preserves documented fonts, motion, effects, compound edits, environment checks, and Agent entry points. Some subsystem links are based on README descriptions because their implementations were not sampled; uncertain call wiring is omitted.
Main entry points: headless_draft.py Headless CLI · jy14_headless.py Draft Builder · jy14_codec.cpp Draft Codec · native_edit.py Private Copy Editor
Components 21
Plan and Draft
- Headless CLI
skills/yichen-jianying-edit/scripts/headless_draft.py - Edit Plan
skills/yichen-jianying-edit/references/plan-format.md - Draft Builder
engine/jy14_headless.py - Media Validation
engine/jy14_headless.py - Draft Codec
bridge/jy14_codec.cpp - Secure Runtime I/O
bridge/runtime_io.py - Local Draft Registration
engine/headless_runtime.py
Editing Features
- Local Fonts
engine/native_fonts.py - Keyframe Motion
engine/native_motion.py - Native Effects
engine/native_effects.py - Visual Effects
engine/native_visual_effects.py - Compound Timelines
engine/native_compound.py - Private Copy Editor
engine/native_edit.py
Export Backends
- Native Export
engine/native_export.py - Jianying Engine
- Windows Snapshot
engine/windows_portable.py - FFmpeg Tools
engine/ffmpeg_tools.py
Agent and Checks
- Environment Check
engine/runtime_profiles.py - Agent Skill
skills/yichen-jianying-edit/SKILL.md - First-Run Helper
tools/start_here.py
Other components
- Editor / Agent
Connections 22
- Editor / Agent → Headless CLI: runs commands
- Headless CLI → Edit Plan: reads plan
- Headless CLI → Environment Check: checks environment
- Headless CLI → Draft Builder: builds draft
- Draft Builder → Media Validation: validates media
- Draft Builder → Local Fonts: collects fonts
- Draft Builder → Native Effects: audits effects
- Draft Builder → Visual Effects: applies effects
- Draft Builder → Keyframe Motion: applies motion
- Draft Builder → Draft Codec: encodes draft data
- Draft Codec → Secure Runtime I/O: uses I/O primitives
- Headless CLI → Private Copy Editor: edits private copy
- Private Copy Editor → Compound Timelines: handles compounds
- Headless CLI → Local Draft Registration: registers draft
- Headless CLI → Native Export: exports snapshot
- Native Export → Jianying Engine: invokes renderer
- Headless CLI → Windows Snapshot: selects Windows export
- Windows Snapshot → FFmpeg Tools: renders snapshot
- Editor / Agent → Agent Skill: uses guidance
- Agent Skill → Headless CLI: invokes workflow
- Editor / Agent → First-Run Helper: starts setup
- First-Run Helper → Headless CLI: prepares commands