# luoluoluo22/jianying-editor-skill architecture

> Architecture diagram of the GitHub repository luoluoluo22/jianying-editor-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luoluoluo22/jianying-editor-skill
- Repository: https://github.com/luoluoluo22/jianying-editor-skill

## Overview

This is an AI-assisted Jianying desktop video-editing skill: it builds editable Jianying drafts and optionally automates Windows export; Jianying itself performs preview and final rendering. The main workflow is a natural-language editing request, media/voice/subtitle/effect preparation, timeline assembly, draft saving, then export. The graph also preserves documented recording, web-animation, smart-zoom, semantic rough-cut, and cloud-asset capabilities. Some feature scripts are indexed but not excerpted, so their README-documented links are identified as such rather than inferred from source.

Main entry points: [`scripts/jy_wrapper.py`](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/jy_wrapper.py) (Project API), [`scripts/core/media_ops.py`](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/media_ops.py) (Timeline media), [`scripts/core/text_ops.py`](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/text_ops.py) (Text and subtitles), [`scripts/cloud_manager.py`](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/cloud_manager.py) (Cloud assets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Draft authoring"]
  node_wrapper["Project API<br/>[jy_wrapper.py]"]
  node_projectbase["Draft lifecycle<br/>[project_base.py]"]
  node_mediaops["Timeline media<br/>[media_ops.py]"]
  node_textops["Text and subtitles<br/>[text_ops.py]"]
  node_vfxops["Effects and transitions<br/>[vfx_ops.py]"]
  node_mocking["Keyframes<br/>[mocking_ops.py]"]
end

subgraph group_content["Media and content"]
  node_tts["Voice synthesis<br/>[universal_tts.py]"]
  node_cloud["Cloud assets<br/>[cloud_manager.py]"]
  node_assetsearch["Asset catalog search<br/>[asset_search.py]"]
end

subgraph group_automation["Capture and analysis"]
  node_webrecorder["Web animation capture<br/>[web_recorder.py]"]
  node_screenrecorder["Screen recording<br/>[recorder.py]"]
  node_smartzoom["Smart zoom<br/>[smart_zoomer.py]"]
  node_roughcut["Semantic rough cut<br/>[smart_rough_cut.py]"]
  node_commentary["Movie commentary"]
  node_exporter["UI export<br/>[auto_exporter.py]"]
end

subgraph group_runtime["Runtime support"]
  node_formatters["Draft and media utilities<br/>[formatters.py]"]
  node_normalizer["Media normalization"]
end

node_creator(("Creator"))
node_assistant(("AI editor"))
node_jianying["Jianying editor"]

node_creator -->|"requests edits"| node_assistant
node_assistant -.->|"builds draft"| node_wrapper
node_wrapper -->|"inherits lifecycle"| node_projectbase
node_wrapper -->|"mixes in"| node_mediaops
node_wrapper -->|"mixes in"| node_textops
node_wrapper -->|"mixes in"| node_vfxops
node_wrapper -->|"mixes in"| node_mocking
node_projectbase -->|"uses assets"| node_cloud
node_mediaops -->|"downloads assets"| node_cloud
node_mediaops -->|"normalizes media"| node_normalizer
node_mediaops -->|"reads duration"| node_formatters
node_textops -->|"generates voice"| node_tts
node_textops -->|"adds voice track"| node_mediaops
node_assetsearch -.->|"finds assets"| node_cloud
node_webrecorder -.->|"imports project API"| node_wrapper
node_screenrecorder -.->|"creates draft"| node_wrapper
node_smartzoom -->|"edits recording"| node_wrapper
node_roughcut -->|"assembles edit"| node_wrapper
node_commentary -->|"builds edit"| node_wrapper
node_wrapper -->|"saves draft"| node_jianying
node_jianying -->|"exports through UI"| node_exporter
node_creator -.->|"searches effects"| node_assetsearch
node_assistant -.->|"requests web capture"| node_webrecorder
node_assistant -.->|"requests recording"| node_screenrecorder
node_assistant -.->|"requests footage match"| node_roughcut
node_assistant -.->|"requests narration edit"| node_commentary

click node_wrapper "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/jy_wrapper.py"
click node_projectbase "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/project_base.py"
click node_mediaops "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/media_ops.py"
click node_textops "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/text_ops.py"
click node_vfxops "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/vfx_ops.py"
click node_mocking "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/mocking_ops.py"
click node_tts "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/universal_tts.py"
click node_cloud "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/cloud_manager.py"
click node_assetsearch "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/asset_search.py"
click node_webrecorder "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/web_recorder.py"
click node_screenrecorder "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/tools/recording/recorder.py"
click node_smartzoom "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/smart_zoomer.py"
click node_roughcut "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/smart_rough_cut.py"
click node_commentary "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/movie_commentary_builder.py"
click node_exporter "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/auto_exporter.py"
click node_formatters "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/utils/formatters.py"
click node_normalizer "https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/utils/media_normalizer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_wrapper,node_projectbase,node_mediaops,node_textops,node_vfxops,node_mocking toneBlue
class node_tts,node_cloud,node_assetsearch toneAmber
class node_webrecorder,node_screenrecorder,node_smartzoom,node_roughcut,node_commentary,node_exporter toneMint
class node_formatters,node_normalizer toneRose
class node_creator,node_assistant,node_jianying toneIndigo
```

## Components

### Draft authoring

- [Project API](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/jy_wrapper.py): `scripts/jy_wrapper.py`
- [Draft lifecycle](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/project_base.py): `scripts/core/project_base.py`
- [Timeline media](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/media_ops.py): `scripts/core/media_ops.py`
- [Text and subtitles](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/text_ops.py): `scripts/core/text_ops.py`
- [Effects and transitions](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/vfx_ops.py): `scripts/core/vfx_ops.py`
- [Keyframes](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/core/mocking_ops.py): `scripts/core/mocking_ops.py`

### Media and content

- [Voice synthesis](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/universal_tts.py): `scripts/universal_tts.py`
- [Cloud assets](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/cloud_manager.py): `scripts/cloud_manager.py`
- [Asset catalog search](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/asset_search.py): `scripts/asset_search.py`

### Capture and analysis

- [Web animation capture](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/web_recorder.py): `scripts/web_recorder.py`
- [Screen recording](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/tools/recording/recorder.py): `tools/recording/recorder.py`
- [Smart zoom](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/smart_zoomer.py): `scripts/smart_zoomer.py`
- [Semantic rough cut](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/smart_rough_cut.py): `scripts/smart_rough_cut.py`
- [Movie commentary](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/movie_commentary_builder.py): `scripts/movie_commentary_builder.py`
- [UI export](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/auto_exporter.py): `scripts/auto_exporter.py`

### Runtime support

- [Draft and media utilities](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/utils/formatters.py): `scripts/utils/formatters.py`
- [Media normalization](https://github.com/luoluoluo22/jianying-editor-skill/blob/main/scripts/utils/media_normalizer.py): `scripts/utils/media_normalizer.py`

### Other components

- **Creator**
- **AI editor**
- **Jianying editor**

## Connections

- Creator → AI editor: requests edits (evidence: `README.md`)
- AI editor → Project API: builds draft
- Project API → Draft lifecycle: inherits lifecycle (evidence: `scripts/jy_wrapper.py`)
- Project API → Timeline media: mixes in (evidence: `scripts/jy_wrapper.py`)
- Project API → Text and subtitles: mixes in (evidence: `scripts/jy_wrapper.py`)
- Project API → Effects and transitions: mixes in (evidence: `scripts/jy_wrapper.py`)
- Project API → Keyframes: mixes in (evidence: `scripts/jy_wrapper.py`)
- Draft lifecycle → Cloud assets: uses assets (evidence: `scripts/core/project_base.py`)
- Timeline media → Cloud assets: downloads assets (evidence: `scripts/core/media_ops.py`)
- Timeline media → Media normalization: normalizes media (evidence: `scripts/core/media_ops.py`)
- Timeline media → Draft and media utilities: reads duration (evidence: `scripts/core/media_ops.py`)
- Text and subtitles → Voice synthesis: generates voice (evidence: `scripts/core/text_ops.py`)
- Text and subtitles → Timeline media: adds voice track (evidence: `scripts/core/text_ops.py`)
- Asset catalog search → Cloud assets: finds assets
- Web animation capture → Project API: imports project API
- Screen recording → Project API: creates draft (evidence: `README.md`)
- Smart zoom → Project API: edits recording (evidence: `scripts/smart_zoomer.py`)
- Semantic rough cut → Project API: assembles edit (evidence: `scripts/smart_rough_cut.py`)
- Movie commentary → Project API: builds edit (evidence: `scripts/movie_commentary_builder.py`)
- Project API → Jianying editor: saves draft (evidence: `README.md`)
- Jianying editor → UI export: exports through UI (evidence: `README.md`)
- Creator → Asset catalog search: searches effects (evidence: `README.md`)
- AI editor → Web animation capture: requests web capture (evidence: `README.md`)
- AI editor → Screen recording: requests recording (evidence: `README.md`)
- AI editor → Semantic rough cut: requests footage match (evidence: `README.md`)
- AI editor → Movie commentary: requests narration edit (evidence: `README.md`)
