功能描述

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)。提供开箱即用的 Python 接口，支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。

使用说明 (SKILL.md)

\r \r

JianYing Editor Skill\r

Name: Jianying Editor Skill
Author: williamwang21cn-tiger

\r Use this skill when the user wants to automate video editing, generate drafts, or manipulate media assets in JianYing Pro.\r \r Agent execution playbook: docs/agent-playbook.md\r Minimal command SOP: docs/minimal-command-sop.md\r Draft inspector CLI:\r python \x3CSKILL_ROOT>/scripts/draft_inspector.py list --limit 20\r python \x3CSKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName"\r python \x3CSKILL_ROOT>/scripts/draft_inspector.py show --name "DraftName" --kind content --json\r For generic editing requests, always follow the "Quick Edit Runtime Template" and "Acceptance Checklist" in that playbook.\r \r

🚨 重要开发原则 (CRITICAL DEVELOPER RULES)\r

脚本位置：禁止在 Skill 内部目录创建剪辑脚本。所有的剪辑逻辑实现代码（.py 脚本）必须存放在用户当前项目的根目录（或子目录，如 scripts/），以保持 Skill 库的纯净和可移植性。\r
配乐选择：\r
- 简单演示使用默认音乐。实际项目，应优先检索并推荐 data/cloud_music_library.csv 中的相关曲目，或根据视频主题（如“科技”、“温暖”）进行关键词过滤。\r
- 询问用户：“我发现了几首符合主题的云端音乐，要不要试试？（如：Illuminate - 科技感）”。\r \r

规则指南 (Rules)\r

\r Read the individual rule files for specific tasks and constraints:\r \r

rules/setup.md - Mandatory initialization code for all scripts.\r
rules/core.md - Core operations: Saving, Exporting, and Draft management.\r
rules/cli.md - CLI contracts and machine-readable output conventions.\r
rules/media.md - Importing assets & AI Video Analysis Optimization (30m/360p).\r
rules/text.md - Adding Subtitles, Text, and Captions.\r
rules/keyframes.md - Advanced: Adding Keyframe animations.\r
rules/effects.md - Searching for and applying Filters, Effects, and Transitions.\r
rules/recording.md - New: Screen Recording & Smart Zoom automation.\r
rules/web-vfx.md - Advanced: Web-to-Video generation.\r
rules/generative.md - Chain of Thought for generative editing.\r
rules/audio-voice.md - New: TTS Voiceover & BGM sourcing.\r \r

🎯 Agent Quick Routing\r

\r

云端视频 + 云端音乐：rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py\r
旁白与字幕对齐：rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py\r
录屏与智能变焦：rules/recording.md -> tools/recording/recorder.py\r
批量导出/无头导出：rules/core.md + rules/cli.md -> examples/robust_auto_export.py\r
影视解说生成：rules/generative.md -> scripts/movie_commentary_builder.py\r \r

📖 经典示例 (Examples)\r

\r Refer to these for complete workflows:\r

examples/my_first_vlog.py - A complete vlog creation demo with background music and animated text.\r
examples/simple_clip_demo.py - Quick-start tutorial for basic cutting and track management.\r
examples/compound_clip_demo.py - New: Professional nested project (Compound Clip) automation.\r
examples/cloud_video_music_tts_demo.py - Cloud video + cloud BGM + TTS/subtitle alignment.\r
examples/web_to_video_intro_demo.py - Web-to-Video intro demo (HTML animation -> timeline clip).\r
examples/robust_auto_export.py - Stable export workflow and failure handling.\r
examples/auto_exposure_align_demo.py - CV-assisted exposure alignment workflow.\r
examples/video_transcribe_and_match.py - Advanced: AI-driven workflow (Transcribe Video -> Match B-Roll via AI semantics -> Assemble Draft).\r \r

🧠 提示词与集成工具 (Prompts & Integrated Tools)\r

\r Use these templates and scripts for complex tasks:\r

Asset Search: Find filters, transitions, and animations by Chinese/English name:\r
```
python \x3CSKILL_ROOT>/scripts/asset_search.py "复古" -c filters\r
```\r
```

Movie Commentary Builder: Generate 60s commentary videos from a storyboard JSON:\r

python \x3CSKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"\r
```\r

Sync Native Assets: Import your favorited/played BGM from JianYing App to the Skill:\r
```
python \x3CSKILL_ROOT>/scripts/sync_jy_assets.py\r
```\r
```
README to Tutorial: Convert a project's README.md into a full installation tutorial video script:\r
- Read prompt: prompts/readme_to_tutorial.md\r
- Inject content into {{README_CONTENT}} variable\r

Screen Recorder & Smart Zoom: Record your screen and auto-apply zoom keyframes:\r

python \x3CSKILL_ROOT>/tools/recording/recorder.py\r
# Or apply zoom to existing video:\r
python \x3CSKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"\r
```\r

Auto Exporter: Headless export of a draft to MP4/SRT:\r

python \x3CSKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60\r
# For SRT only:\r
python \x3CSKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"\r
```\r

Template Clone & Replacer: 安全克隆模板并批量替换物料 (防止损坏原模板):\r

# 克隆模板生成新项目\r
python \x3CSKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"\r
```\r

API Validator: Run a quick diagnostic of your environment:\r
```
python \x3CSKILL_ROOT>/scripts/api_validator.py\r
```\r
```

\r

🚀 快速开始示例\r

\r

import os\r
import sys\r
\r
# 1. 环境初始化 (必须同步到脚本开头)\r
current_dir = os.path.dirname(os.path.abspath(__file__))\r
env_root = os.getenv("JY_SKILL_ROOT", "").strip()\r
# 探测 Skill 路径 (支持 Antigravity, Trae, Claude 等)\r
skill_root = next((p for p in [\r
    env_root,\r
    os.path.join(current_dir, ".agent", "skills", "jianying-editor"),\r
    os.path.join(current_dir, ".trae", "skills", "jianying-editor"),\r
    os.path.join(current_dir, ".claude", "skills", "jianying-editor"),\r
    os.path.join(current_dir, "skills", "jianying-editor"),\r
    os.path.abspath(".agent/skills/jianying-editor"),\r
    os.path.abspath(".trae/skills/jianying-editor"),\r
    os.path.abspath(".claude/skills/jianying-editor"),\r
    os.path.dirname(current_dir) # 如果在 examples/ 目录下\r
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)\r
\r
if not skill_root: raise ImportError("Could not find jianying-editor skill root.")\r
sys.path.insert(0, os.path.join(skill_root, "scripts"))\r
from jy_wrapper import JyProject\r
\r
if __name__ == "__main__":\r
    project = JyProject("My Video Project")\r
    assets_dir = os.path.join(skill_root, "assets")\r
\r
    # 2. 导入视频与配乐\r
    project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")\r
    project.add_media_safe(os.path.join(assets_dir, "audio.mp3"), "0s", track_name="Audio")\r
\r
    # 3. 添加带动画的标题\r
    project.add_text_simple("剪映自动化开启", start_time="1s", duration="3s", anim_in="复古打字机")\r
\r
    project.save()\r
```\r
\r
## 🛠️ 初始化与项目规范 (Initialization & Project Rules)\r
\r
在初始化 `JyProject` 时，请务必根据主视频素材的比例设置分辨率。**默认值为横屏 (1920x1080)**。\r
\r
### 🚨 脚本存放位置规范\r
**禁止在 Skill 安装目录下创建你的业务剪辑脚本**。\r
- **正确做法**：将你的剪辑 Python 脚本放在项目的根目录。\r
- **原因**：Skill 目录应该只包含工具集源码，便于后续 `git pull` 升级。业务代码混入会导致版本管理混乱。\r

安全使用建议

This package appears internally consistent with a JianYing editing wrapper, but exercise normal caution: 1) Source/homepage is unknown — prefer code review before running. 2) Inspect scripts that perform network I/O (sync_jy_assets.py, cloud-related code) to see whether they require credentials or POST data you don't expect. 3) Run the skill in an isolated environment (container/VM) the first time, and back up any project directories it may modify. 4) Because SKILL.md references JY_SKILL_ROOT and other runtime config not declared in the registry, confirm what environment variables or auth the scripts will actually use. 5) If you will allow the agent to invoke this autonomously, remember it will have the ability to run the included Python scripts which read/write files and contact external URLs — only grant that if you trust the package and have reviewed the network behaviors.

功能分析

Type: OpenClaw Skill Name: jianying-editor-skill Version: 1.0.0 The skill bundle contains high-risk capabilities that, while aligned with the stated goal of video automation, provide a significant attack surface. Specifically, 'tools/recording/recorder.py' implements a full screen recorder and input logger (using pynput) to capture mouse and keyboard events. Additionally, 'scripts/vendor/pyJianYingDraft/jianying_controller.py' uses the uiautomation library to programmatically control the host's UI. Other concerning patterns include harvesting device identifiers from local application logs and config files ('scripts/universal_tts.py') and providing an option to bypass TLS verification via the 'JY_TTS_INSECURE_SSL' environment variable.

能力标签

crypto

能力评估

✓ Purpose & Capability

Name/description align with the included files: many Python scripts, examples, CLI helpers and data/asset manifests for JianYing-style editing, TTS, recording, exporting and asset sync. The repository contents reasonably match the stated capabilities.

ℹ Instruction Scope

SKILL.md gives concrete runtime commands (many python scripts) and directs the agent to read/write project drafts, run recorder, sync assets, and call cloud asset URLs. This is consistent with an editor skill, but it means the agent will perform filesystem operations and network downloads at runtime; SKILL.md also references environment variables (e.g., JY_SKILL_ROOT) and runtime config files that are not declared in registry metadata.

✓ Install Mechanism

There is no install spec — this is instruction/code-only. No archive downloads or external installers are declared. Note: many included scripts perform network I/O at runtime (e.g., sync_jy_assets, cloud asset URLs), but those are runtime behaviors, not install-time downloads.

ℹ Credentials

Registry requires no environment variables or credentials, but SKILL.md and scripts reference JY_SKILL_ROOT and include asset-sync and cloud-URL usage. That is a mild inconsistency: the skill may require user configuration or authentication at runtime (for syncing native assets or accessing private cloud APIs) even though no credentials are declared up front.

✓ Persistence & Privilege

always is false and the skill does not request to be always-present or to modify other skills. The repository contains scripts that will read/write projects and may create files in the user's project root (the README/CRITICAL RULES explicitly direct storing user scripts in the project root), which is expected for an editor tool.

版本历史

v1.0.0

Initial release of the jianying-editor-skill — a powerful Python API for JianYing Pro AI video editing automation. - Offers an easy-to-use interface for screen recording, media import, subtitle generation, web animation synthesis, and project export. - Includes mandatory development principles to keep business scripts outside the skill directory for better maintainability. - Provides detailed rule files for core operations, media handling, subtitles, effects, keyframes, recording, Web VFX, TTS, and audio management. - Features ready-to-use CLI tools and example scripts for typical workflows: vlog creation, batch export, commentary generation, and more. - Offers agent routing guides and usage templates to streamline video editing automation tasks.

元数据

Slug jianying-editor-skill

版本 1.0.0

许可证 MIT-0

累计安装 2

当前安装数 2

历史版本数 1

常见问题

Jianying Editor Skill 是什么？

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)。提供开箱即用的 Python 接口，支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 535 次。

如何安装 Jianying Editor Skill？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install jianying-editor-skill」即可一键安装，无需额外配置。

Jianying Editor Skill 是免费的吗？

是的，Jianying Editor Skill 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Jianying Editor Skill 支持哪些平台？

Jianying Editor Skill 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Jianying Editor Skill？

由 williamwang21cn-tiger（@williamwang21cn-tiger）开发并维护，当前版本 v1.0.0。

Jianying Editor Skill