开发者模式会直接打开生成视频的 代码与文件。代码动效视频显示绘制画面的 index.html 及引擎·素材文件,原片剪辑视频显示单条文件夹和制作文件。修改代码 0.5 秒后预览就会更新;出错时可以直接跳到对应行。下方截图来自 Somssii Shorts「8小时的活,怎么缩短?」(8시간 일, 어떻게 줄여요?)·「这抹光泽的由来」(이 광택이 오기까지)以及 KTV「中央厅维修工程」(중앙청 보수공사)。
界面构成
- 文件 — 按文件名搜索、按分组显示的文件列表、+ 添加。
- 代码 — 选中文件后打开的编辑区。顶部有 写入代码 · ↺ 全部恢复 · 保存代码。
- 底部标签页 — 控制台 · 检查 · 渲染 · 版本 · 对比 · 查找 · API · 特效列表 · 旋钮 · 许可证。
- 预览 — 播放、时间输入(
12.3、369f、T.s3+0.5)、区间循环(I/O)、0.25–2 倍速、实时生效、审查、HUD。
在手机上,代码 · 预览 · 文件 · 控制台 · 渲染 每次只显示其中一个。
文件分组
| 分组 | 包含内容 | 修改后 |
|---|---|---|
| 本条(代码动效)/ 单条文件夹(原片剪辑) | index.html、配音·音乐、edit.json·meta.json 等 | 只影响本条视频 |
| 批次引擎 | lib/*.js·css(绘制引擎·品牌) | 只影响本条视频(以副本覆盖) |
| 批次公共素材 | media/ 图片·音频·片段帧 | 只影响本条视频 |
| 制作文件(原片剪辑视频) | 剪辑脚本(build.py 等)·ASS 字幕·图形 | 可执行的脚本(.py·.sh·.js·.html 等)仅运营管理员可以修改 |
| 批次字体 | fonts/ | 仅查看 |
| 编辑图层 | project.json — 在新手·中级·高级模式中所做的全部编辑 | 0.4 秒后作为一步「JSON 编辑」应用 |
修改代码 → 即时预览
- 在文件列表中打开
index.html(或 lib 文件)。 - 修改数字·颜色·大小(例如:批次引擎
brand.js中的颜色名表B.C)。开启 实时生效 时,0.5 秒后预览会重新绘制,播放位置保持不变(CSS 不重新绘制,直接生效)。超过 200KB 的文件会关闭实时生效,请点 ▶ 应用 或按Ctrl+Enter。 - 拖动代码中的 T 时间 胶囊,可以改变该场景的时间数值。
画面文字在哪里改 — 用审查找到它
代码动效视频的 index.html 中有类似 VFX.plan({ facts: […], beats: […] }) 这样写着画面文案的列表,但这个列表是 检查用的(字号·遮挡区域·事实核对),修改它并不会改变画面。真正绘制文字的代码在别处。
- 开启 审查(
Alt+I),指向要修改的文字。会显示绘制该文字的函数和行(例如:B.pillBot · index.html:387),点击 跳转到该行 即可打开那一行。 - 如果那一行直接传入了文案,就在那里修改。如果没有传入,说明绘制的是函数的 默认文案,请在批次引擎(
lib/brand.js等)中找到该函数进行修改。例如:B.pillBot的o.q || '비결은 ‘빨리’일까?'。 - 移动一次播放位置,就能看到修改后的文字。即使修改的是批次引擎,也 只对本条视频 生效。
只修改文案时,用新手模式的大字卡片或中级模式的 代码文字 轨道更简单、更安全(会保留在编辑图层中,可以轻松恢复为公开版)。开发者模式适用于修改卡片中没有出现的文字,或多条视频共用的函数中的文案。
出错时
代码有错误时,画面会停留在最后一次正常绘制的状态,并在红框中显示错误和 跳转到该行。在控制台标签页中点击 文件:行 也能跳到对应位置。
审查 · HUD
开启 审查(Alt+I)并指向预览,会显示绘制该部分的代码行,点击即可跳到该行。HUD(Alt+H)会把场景·时间信息叠加显示在预览上。
自动补全 · 代码片段
用 Ctrl+Space 打开引擎 API 自动补全(含说明·调用形式),插入代码片段(CAP 字幕设置、FX.reveal 文字入场、FX.scenes 场景列表、R.k 旋钮、CAP.at 对齐单词时间、VFX 特效)。还支持查找 Ctrl+F、替换、折叠和 跳转到该行。
替换图片 · 音频 · 字体 · 视频
选中非文本文件时,会显示预览和 ⤒ 替换… 按钮。图片会适配为原来的尺寸·格式(填满·完整显示·保持原样),音频会在重新生成 MP4 时转换为原来的格式;🎞 用视频替换… 会在浏览器中把视频切成相同数量的帧放进去。另有 ↺ 恢复原样(仅将此文件恢复为公开版)、恢复为批次原件、⬇ 下载。
原片剪辑视频的开发者模式
原片剪辑视频的预览是剪辑项目,文件列表中会显示单条文件夹(edit.json·meta.json·配音·音乐)和 制作文件(剪辑脚本·ASS 字幕·图形)。修改制作脚本后重新生成 MP4,脚本会重新运行,视频也会重新生成。可执行的脚本在服务器上运行,因此 仅运营管理员 可以保存·重新生成,其他人会看到「制作脚本(.py·.sh·.js·.html 等)仅管理员可修改」。脚本不读取的记录文件(edit.json·plan.md 等)会带有 ⚠ 标记 — 实际的字幕文案可能写在脚本里,请用 🔎 在 build.py 中查找 来查找。
底部 10 个标签页
| 标签页 | 功能 |
|---|---|
| 控制台 | 筛选日志·信息·警告·错误,点击 文件:行 跳转,清空 |
| 检查 | 当前画面(最小文字 px·安全区域外)· 全片扫描 · 规则检查 · 孤立补丁 → 运行检查 |
| 渲染 | 仅用代码重新生成MP4(使用已保存的代码版本,不含编辑图层,2–5 分钟)· 将此代码版本关联到编辑 · 进度阶段(排队→绘制→音频→编码→校验→发布) |
| 版本 | 加载已保存的代码版本 · 对比 · 用此版本生成MP4 · 恢复为公开版 |
| 对比 | 当前/公开版/已保存版本/历史版本的并排·单栏对比,仅恢复此文件,3-way 对比,画面对比(每秒一帧) |
| 查找 | 正则·区分大小写·全词匹配,范围(本条·引擎·公共素材·制作文件),全部替换,查找符号(Ctrl+Shift+O) |
| API | 引擎 API 列表 — 插入代码·打开定义·复制,代码片段,VFX 特效 |
| 特效列表 | 特效(名称·类型)及其在本条视频中的使用位置,插入/复制代码片段 |
| 旋钮 | 用滑块调整本条视频注册的调节值(R.k)和代码中的数字(const T·大写常量) |
| 许可证 | 代码库·批次字体的许可证全文 |
保存 · 写入代码 · 渲染
- 保存代码 — 在「保存代码版本」窗口中填写名称和「改了什么」后保存。保存前的修改会临时保留在本设备上(恢复·丢弃),↺ 全部恢复 只会清除本设备上的修改。
- 写入代码(代码动效视频)— 把在新手·中级模式中修改的文案·品牌色·声音时间·大小·旋钮数值写进代码,并保存为新版本。其他编辑仍原样保留在编辑图层中。
- 渲染标签页中的“仅用代码重新生成MP4” 只用已保存的代码版本重新生成视频,并替换作品库视频。如需连同编辑图层(文字·特效等)一起生成,请使用顶部的 导出(渲染)(生成MP4)。
无法进行的操作
- 引擎文件只能修改已有的
lib/*.js·css,批次素材也只能替换已有文件。index.html不能删除,也不能新建 html·js·css·svg 文件。 - 一次最多可修改 600 个文件,大小上限为:文本 2MB·图片 15MB·音频 30MB·视频/帧 45MB·字体 10MB。
- 重新生成 MP4 每小时最多 30 次。
- 即使在代码中隐藏法律声明文案或将其缩小,生成 MP4 时也会被拦截。
遇到问题 → 问题排查

