Skip to content

Repository files navigation

剪蛋

简体中文 | English

剪蛋

简单复制到剪映。 复制或截图一张图片,在剪映素材页按 Ctrl+V,剪蛋会把图片直接加入播放头所在位置,并放在现有画面轨道上方。

官网 · 下载 Windows 正式版 · 快速开始 · v1.1.0 发布页

当前正式版为 v1.1.0,提供免安装的 Jiandan.exe;源码运行方式继续保留。

为什么有剪蛋

剪映不支持把刚刚截好的图片直接粘贴进素材区。

原本为了使用一张截图,你可能要先在网上保存图片,或者把截图粘贴到聊天窗口,再保存到本地,最后拖进剪映。明明图片已经在剪贴板里,却还要绕一大圈。

所以有了剪蛋:截图或复制图片后,回到剪映按下 Ctrl+V,图片就会进入素材区和时间线。少一次保存,少一次寻找,也不需要拖动文件或鼠标。

环境

  • Windows 10 或 Windows 11
  • 源码版需要 Python 3.10 或更高版本;EXE 版无需安装 Python
  • 剪映专业版

启动

普通用户可从官方下载页获取 Jiandan.exe 并直接运行。源码版双击 run.bat

首次启动会在项目目录创建 .venv 并安装依赖,完成后自动打开状态窗口。以后再次双击会直接启动;如果剪蛋已经运行,则只显示已有窗口,不会重复启动服务。

首次使用需要输入邮箱验证码。登录凭据使用 Windows DPAPI 加密后仅保存在当前 Windows 用户下,可保持登录 30 天;同一邮箱在新设备登录后,旧设备会自动退出。剪蛋不会上传图片或剪贴板内容。

使用

  1. 启动剪蛋,确认状态显示“已开启”。
  2. 打开剪映草稿并停留在“素材”页面。
  3. 截图或复制一张图片。
  4. 切回剪映并按 Ctrl+V
  5. 图片会落在播放头位置,并自动放到现有画面轨道上方。

查看实机 Demo

关闭窗口只会隐藏到系统托盘。需要完全退出时,右键托盘图标并选择“退出”。

关闭或退出程序会保留登录,下次启动会在后台恢复登录后直接显示主窗口。只有主窗口邮箱菜单中的“退出登录”会清除登录状态。

项目结构

jy_live_paste/      主程序
assets/brand/       透明底品牌图标
tests/              自动测试
run.bat             Windows 启动入口
requirements.txt    运行依赖

通过 EXE 或 run.bat 启动时,导入图片保存在 %LOCALAPPDATA%\Jiandan\captured,运行日志保存在 %LOCALAPPDATA%\Jiandan\import-debug.log。图片可能被剪映草稿引用,请不要在仍需使用对应草稿时删除。

开发与测试

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pytest -q

当前自动测试覆盖剪贴板安全、剪映前台判断、导入契约、窗口路由和视觉检测逻辑。

工作原理

剪蛋按条件注册 Ctrl+V:只有剪映处于前台且剪贴板包含图片时才接管快捷键。图片先保存到独立短路径,再调用剪映原生导入流程;系统文件选择窗口在显示阶段被设为不可见且不可激活,随后只提交本次图片的精确路径。导入完成后,剪蛋调用素材卡自身的“添加到轨道”命令,由剪映原生逻辑决定播放头位置和上方轨道。文字剪贴板和其他应用中的粘贴保持系统原行为。

About

剪蛋:把截图或剪贴板图片直接粘贴到剪映专业版素材区与播放头的 Windows 工具

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages