lemon8工作流
- Python 80%
- HTML 20%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| assets | ||
| backend | ||
| docs | ||
| frontend | ||
| scripts | ||
| tests | ||
| .env | ||
| .env.example | ||
| .gitignore | ||
| build.py | ||
| conftest.py | ||
| DEVELOPMENT.md | ||
| lemon8.spec | ||
| LICENSE | ||
| probe_patch_min.py | ||
| probe_pipeline_patch.py | ||
| probe_ref_stickers.py | ||
| probe_refs_order.py | ||
| publish.py | ||
| README.md | ||
| requirements-build.txt | ||
| requirements-dev.txt | ||
| requirements.txt | ||
| run.py | ||
| start.bat | ||
| test_0731_181943_integration.py | ||
| test_pyjianying.py | ||
| test_th.json | ||
| test_th_tts.json | ||
| test_timeline.py | ||
| THIRD_PARTY_NOTICES.md | ||
| UPDATE.md | ||
| version.json | ||
🍋 Lemon8 视频装配工作流
一款面向本地设计师的剪映专业版自动化装配工具：输入参考文案 → AI 生成差异化文案 → 配音 → 自动铺成剪映草稿（多条独立时间线，多层轨道），在剪映里直接打开即可进一步编辑。
快速开始（约 3 分钟）
- 下载
lemon8.exe（Windows） - 双击运行，浏览器自动打开
http://127.0.0.1:8010 - 首次启动弹出配置向导：按提示在 ⚙ 设置中补齐 LLM / TTS 密钥，保存后自动重启
- 三步走：① 生成文案 → ② 生成配音 → ③ 装配草稿
- 打开剪映专业版，在草稿列表中找到刚生成的草稿即可编辑
⚠️ 首次双击若出现 Windows SmartScreen 安全提示：点击「更多信息 → 仍要运行」（程序未购买代码签名证书）。
系统要求
| 依赖 | 说明 |
|---|---|
| Windows 10/11 | 仅支持 Windows |
| 剪映专业版 | 已安装即可，安装目录会被自动检测（用于草稿加密） |
| 网络 | 必须联网（TTS / LLM 均在线调用） |
ffmpeg、jy-draftc 已随包内置，无需单独安装；首次启动会自动部署到 exe 同级
bin/目录。
配置（⚙ 设置）
LLM 文案引擎
- RINGS（推荐）：填
RINGS_API_KEY - OpenAI / DeepSeek：填接口地址 +
LLM_API_KEY+ 模型名 - mock：演示模式，产出占位文案
TTS 配音引擎
- Edge-TTS（推荐，免费零注册）：选择音色短名（
xiaoxiao女 /yunxi男 …） - RINGS TTS：CLI 已随包内置。在 ⚙设置 → 配音引擎选 RINGS 模型后，点「🔐 浏览器登录」用共享账号完成一次授权（约 30 天内使用过即可保持登录，到期重新登录一次）
剪映相关（默认自动检测，通常无需手改）
- 剪映安装目录：自动扫描本地安装与注册表
- jy-draftc 路径：打包版已自动部署在
bin/下 - 草稿输出目录：默认
%LOCALAPPDATA%\JianyingPro\User Data\Projects\com.lveditor.draft
密钥留空表示「保持当前值」；修改密钥/引擎后点「保存密钥并重启」立即生效。
素材准备
- 视频素材：放入 ⚙ 设置中指定的素材目录（默认
assets/materials/，支持.mp4/.mov等） - BGM：放入 BGM 目录（默认
assets/bgm/，支持.mp3/.wav等）
常见问题
剪映 11 打开草稿是空白？
生成后在结果里若看到黄色警示「未检测到 jy-draftc / 剪映安装目录」即说明加密未生效。请到 ⚙ 设置确认「剪映安装目录」已正确填写（含 videoeditor.dll），然后重新装配。
TTS 报「RINGS 认证已过期」？ 到 ⚙设置 → 配音引擎 →「🔐 浏览器登录」重新授权一次（或改用 Edge-TTS，无需任何账号）。
自动更新
在 .env 中配置 UPDATE_URL 指向 version.json 后，启动时自动检查更新（带 SHA-256 校验与崩溃回滚）。
安全说明
- 本工具在本机运行，所有配置（含 API Key）保存在本地
.env文件 - 网页仅监听
127.0.0.1，不对外网开放；多人共用可在.env设置API_TOKEN - 自带构建中包含 LLM/TTS 网关令牌，请勿公开分发 exe 以外传播
- RINGS 账号同一时间只保留一个登录会话：在别处登录（另一台电脑、终端
rings auth login、再次点「浏览器登录」）会顶掉当前会话，旧会话会报「认证已过期」——此时到 ⚙ 设置重新登录一次即可 - 请勿同时运行多个 lemon8 实例（如 exe 与开发服务并存）：它们共用同一份 RINGS 登录凭据，并发刷新可能导致登录失效
开发
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe run.py # 启动开发服务
.venv\Scripts\python.exe build.py # 打包 dist/lemon8.exe
.venv\Scripts\python.exe publish.py v0.6.0 "更新说明" # 发布到 Gitea Release（需 GITEA_TOKEN）
详细开发文档见 DEVELOPMENT.md；分发与自动更新的原理、操作流程、自测步骤见 UPDATE.md。