Editnado — 照片·视频·感受自动剪辑

Edit？我也是！——一句话，剪辑龙卷风。 （Say a word, and an editing tornado hits.）

用户只需提供 照片·视频文件夹 + 当日感受（语音备忘录） + 想要的风格，说完后通过聊天调整，然后查看结果。计算、渲染、听写由 PC 工具完成（Token 为 0），AI 专注于质量判断（场景与字幕对齐、修正听写错误、检查预览画面）。

执行器就是此文件夹中的 vc.cmd（包含 doctor · setup · auto · build · transcribe · sheet · stills · template）。在 PowerShell 中通过 & "<此文件夹>\vc.cmd" auto … 调用（Git Bash 的 cmd //c 不行）。

0. AI 要遵守的规则

质量优先，Token 其次。 只看判断所需的内容——auto 输出的 JSON 一行、场景拼贴图（sheet_1.png）、检查画面。将计算、重复性任务交给 PC，不读取执行器源码、命令列表或整个文件夹（列表由 media.json 提供）。原始照片·视频仅在场景拼贴图不够用时才打开
安装前要询问。 若是首次运行，执行 vc.cmd setup → 将显示的表（安装什么·多少 MB）展示给用户，获得允许后再执行 vc.cmd setup -Yes。不使用管理员权限
原始文件只读。 结果仅写入 <文件夹>\완성\（或通过 -Out 指定的文件夹）
不编造信息。 标题、字幕、博客文案仅基于感受、照片、拍摄时间中已有的内容。地点价格、营业时间等信息仅使用用户提供的
先看检查画面，然后再说「完成」。如果字幕被截断或画面空白，则修改计划重新渲染
用通俗语言。 对用户只说简单的韩语一两句，只在必要时展示命令、路径、英文
不使用涉及账户、API 密钥、付费积分的功能。 当需要将照片位置等个人资料发送到互联网服务时，每次都要获得用户许可

1. 流程

① 准备   vc.cmd doctor                    → 如果没有 FilmCraft·听写工具，则按规则 0-2 执行 setup
② 草稿   vc.cmd auto <文件夹> -Template <id> [-Title "标题"] [-Out <结果文件夹>] [-Bgm <音乐文件>]
         → 结果文件夹（默认 <文件夹>\완성\）中生成 plan.json · 预览 mp4（半尺寸） · 检查画面 · sheet_1.png（场景拼贴图） · 最后一行 JSON
            {"plan","output","check","seconds_total","scenes":[{n,file,kind,taken,sentence,seconds}],
             "sentences":[{k,at,text}],"warnings":[…]}
③ 精修   质量在这里决定——在展示给用户前，先看三项内容
         a. 场景 ↔ 字幕：通过 sheet_1.png 和 sentences 检查每个场景是否与字幕内容匹配。不一致时，只修改 plan.json 中的
            "align"（每个场景要显示的字句编号，按升序排列）——具体的时间和视频片段由 build 完成
         b. 听写：若有错别字、专有名词（如“헤드는→해 뜨는”），只修正 <结果文件夹>\<录音名>.srt 中的文字，同时设置
            "captions": {"srt": 该文件}（时间戳保持不变——build 会根据片头长度自动偏移）
         c. warnings：若“片头标题超 N 行”，则缩短 title
         修改后执行 vc.cmd build <plan.json> -Preview
④ 展示   查看检查画面（每个场景一格），然后对用户说「32秒 · 场景9个 · 首条字幕 "…" · 预览：<路径>」
⑤ 修改   根据用户反馈 → 修改 plan.json 中对应的值，然后执行 vc.cmd build <plan.json> -Preview
⑥ 确认   vc.cmd build <plan.json>          → 输出原始画质 mp4 + .srt

auto 的工作流程：按拍摄时间顺序排列 · 视频片段取中间区域 · 文件名包含“感受·memo·录音·voice”的音频文件作为我的语音旁白进行听写并生成字幕（在语尾·助词后分为两行） · 每句话与场景对齐（默认：拍摄时间相近的场景归为同一句话，句子之间停顿处切换场景） · 保留视频现场音，说话时降低其音量 · 文件名包含“bgm·music·音乐”的文件（或 -Bgm）作为背景音乐（说话时自动变小） · 模板的片头、色彩、字幕样式
每次只询问一个问题。只要知道文件夹，其余参数按模板默认值设定

2. 选择模板

用户说的话	`-Template`
默认·Vlog·旅行·横屏·YouTube	`default`
Shorts·Reels·TikTok·竖屏·快速	`shorts_fast`
平静·感性·悠闲	`calm_mood`
美食·吃播·食物·咖啡店	`food_quick`
家庭·父母·大字·相册	`family_big`
讲座·评测·演示·说明	`tech_tutorial`

如果不确定则使用 default，仅说“竖屏”则使用 shorts_fast。每个模板的 meta.words 是触发它的关键词
已安装和可下载的模板：vc.cmd template list · 安装：vc.cmd template install <id 或 zip> —— 由用户选择
技能更新（“更新技能”）：vc.cmd update → 向用户展示更改内容并获得许可 → vc.cmd update -Yes。通过 git 获取的文件夹执行 git pull（如果此文件夹中有已修改的文件则停止）；通过 zip 获取的文件夹，验证最新发布版的 SHA256 后覆盖。个人偏好 profiles/local 和已安装的模板保持不变，更改的文件会备份
模板格式与创建方法：templates/README.md

3. 常见修改 → plan.json

用户说的话	修改位置（`overrides` 为点路径键）
字幕稍微向上 / 向下	`overrides."subtitles.margin"` ± 0.04
字幕变大 / 变小	`overrides."subtitles.size"` （默认约 64）
音乐变小 / 变大	`overrides."audio.bgm_duck_db"` −3 / +3
去掉这个场景 / 调整顺序	从 `timeline` 数组中删除·移动（同时也要删除·移动 `align` 中的对应位置）
场景与字幕不匹配	`align` —— 每个场景对应的字幕编号（例如：`[1,2,2,3,3,4,4,5]`）
最后一个场景更长 / 更短	`tail_seconds` ± 3（话语结束后的余韵，默认 1 秒）
中间场景更长	如果 `align` 存在，则给该场景分配多一句话（确保不因增加秒数而导致话语和画面不同步）。如果没有 `align`，则将该条目的 `seconds` + 3
只显示部分照片 / 裁剪异物	该条目的 `crop`：`[左, 上, 宽, 高]` 比例 0~1（例如去掉右侧 20% = `[0,0,0.8,1]`）—— 原始文件保持不变
去掉色彩	`overrides."video.color_preset": null`
去掉片头	`overrides."intro": null`
更改标题	`title`

「仅此一次」= 像上面一样设置 overrides。「以后一直」= 在 profiles/local/<模板id>.json 中写入相同的键（不修改公共文件）
不存在的键会导致执行器停止并提示「配置文件中有不存在的键（拼写错误？）」—— 键列表参考 references/preset-guide.md

4. 编写感受的方法

用途	方法
我的语音旁白	文件夹中的语音备忘录由 `auto` 自动听写并生成字幕。专有名词错误时，修改 `<文件夹>\완성\<录音名>.srt`，并在计划书中通过 `captions.srt` 引用
机器语音旁白	将文本形式的感受写入计划书 `"narration": {"mode":"tts","lines":[{"text":"…"}]}`（使用 Windows 韩语语音）
标题·字幕文案	将感受简短地润色。一行不超过模板 `subtitles.max_chars` 的限制
博客文章	见下面第 6 节

选择语气： 模板 text.tone（标题·机器语音句子）和 blog.tone（博客）为默认值——습니다 · 해요 · 반말。用户提到语气时，仅此一次则设置 overrides."text.tone"，以后则写入 profiles/local/<id>.json 并用该语气重写句子。用户语音字幕保持原样（确保与声音同步）。

5. 照片·缩略图

照片校正（可选）：lightcraft-cli render <照片> -o <结果文件夹>\_vc_work\photo\<名称>.jpg --set color.vibrance=8 --size 1920（值来自模板 photo.*），计划书中该照片的路径更新为校订版
缩略图：从确认项目中选取片头可见时间点的截图——filmcraft-cli --project <_vc_work 中的 .fcproj> render --seconds 1.5 --out thumb.png
人脸模糊（可选）：deface.cmd <照片·视频> -o <结果> —— 实际检测人脸前，需先用含人脸的素材进行验证

6. 博客草稿

写入 <结果文件夹>\blog\draft.md：依据模板 blog.* 规则（语气·小标题·照片组合）+ 第 4 节的事实规则。照片使用校订版，顺序按拍摄时间。若要从视频中嵌入画面，执行 vc.cmd stills <plan.json> → <结果文件夹>\stills\ 中为每个视频实际使用区间的中间帧（原始画质）。如果用户有专门的博客写作技能（如 blog-writer），则将内容传递给该技能。

7. 参考文档（仅在需要时打开）

references/edit-plan.md — 计划书格式 · references/preset-guide.md — 所有键
references/filmcraft-commands.md — 已验证的 FilmCraft 命令和注意事项（仅在修改执行器时）
references/cli-recipes.md — 照片·缩略图·已打开的工具命令 · references/toolchain.md — 工具来源·许可证·MCP
references/onboarding.md — 新 PC · references/style-extractor.md — 从参考视频提取风格
templates/README.md — 模板格式·销售规则

修订历史

2026-11-12：首次编写 → 同天新增交互式计划书 + 执行器 vc.ps1
2026-11-13：2.0 版 — 自动草稿 auto、安装 setup、6 种模板（片头·色彩）、听写 transcribe、字幕智能换行、现场音闪避、语气选择、公开标准（agentskills.io）头部
2026-11-14：2.3.1 版 — 修复工具安装、备份位置在普通 PC 上显示为相对文件夹「C」的问题（vc_paths Get-InstallRoot），ArtCraft 许可证标注 MIT/Apache-2.0
2026-11-13：2.3 版 — 名称改为 Editnado（原名 video-craft）：文件夹·存储库·发布 zip 名称，介绍语「Edit？我也是！」
2026-11-13：2.2 版 — 技能更新 vc.cmd update（git·发布 zip·直接下载的 zip），发布流程（release.ps1，管理员用）
2026-11-13：2.1 版 — 质量优先原则、场景与字幕对齐（align·tail_seconds）、字幕在语尾·助词后换行、照片裁剪（crop）、博客用单帧（stills）、auto 预览半尺寸·保留现场音·标题溢出警告

Editnado — AI自动视频剪辑助手