开发者模式 — 代码与文件

直接修改生成视频的代码·文件,并即时预览

开发者模式会直接打开生成视频的 代码与文件。代码动效视频显示绘制画面的 index.html 及引擎·素材文件,原片剪辑视频显示单条文件夹和制作文件。修改代码 0.5 秒后预览就会更新;出错时可以直接跳到对应行。下方截图来自 Somssii Shorts「8小时的活,怎么缩短?」(8시간 일, 어떻게 줄여요?)·「这抹光泽的由来」(이 광택이 오기까지)以及 KTV「中央厅维修工程」(중앙청 보수공사)。

界面构成

开发者界面 — ① 文件 ② 代码 ③ 底部标签页 ④ 预览
  1. 文件 — 按文件名搜索、按分组显示的文件列表、+ 添加。
  2. 代码 — 选中文件后打开的编辑区。顶部有 写入代码 · ↺ 全部恢复 · 保存代码。
  3. 底部标签页 — 控制台 · 检查 · 渲染 · 版本 · 对比 · 查找 · API · 特效列表 · 旋钮 · 许可证。
  4. 预览 — 播放、时间输入(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 编辑」应用

修改代码 → 即时预览

  1. 在文件列表中打开 index.html(或 lib 文件)。
  2. 修改数字·颜色·大小(例如:批次引擎 brand.js 中的颜色名表 B.C)。开启 实时生效 时,0.5 秒后预览会重新绘制,播放位置保持不变(CSS 不重新绘制,直接生效)。超过 200KB 的文件会关闭实时生效,请点 ▶ 应用 或按 Ctrl+Enter。
  3. 拖动代码中的 T 时间 胶囊,可以改变该场景的时间数值。

画面文字在哪里改 — 用审查找到它

代码动效视频的 index.html 中有类似 VFX.plan({ facts: […], beats: […] }) 这样写着画面文案的列表,但这个列表是 检查用的(字号·遮挡区域·事实核对),修改它并不会改变画面。真正绘制文字的代码在别处。

  1. 开启 审查(Alt+I),指向要修改的文字。会显示绘制该文字的函数和行(例如:B.pillBot · index.html:387),点击 跳转到该行 即可打开那一行。
  2. 如果那一行直接传入了文案,就在那里修改。如果没有传入,说明绘制的是函数的 默认文案,请在批次引擎(lib/brand.js 等)中找到该函数进行修改。例如:B.pillBot 的 o.q || '비결은 ‘빨리’일까?'。
  3. 移动一次播放位置,就能看到修改后的文字。即使修改的是批次引擎,也 只对本条视频 生效。

只修改文案时,用新手模式的大字卡片或中级模式的 代码文字 轨道更简单、更安全(会保留在编辑图层中,可以轻松恢复为公开版)。开发者模式适用于修改卡片中没有出现的文字,或多条视频共用的函数中的文案。

出错时

代码有错误时,画面会停留在最后一次正常绘制的状态,并在红框中显示错误和 跳转到该行。在控制台标签页中点击 文件:行 也能跳到对应位置。

故意加入的语法错误 — 红框与跳转到该行

审查 · HUD

开启 审查(Alt+I)并指向预览,会显示绘制该部分的代码行,点击即可跳到该行。HUD(Alt+H)会把场景·时间信息叠加显示在预览上。

审查 — 指向预览,找到代码行

自动补全 · 代码片段

用 Ctrl+Space 打开引擎 API 自动补全(含说明·调用形式),插入代码片段(CAP 字幕设置、FX.reveal 文字入场、FX.scenes 场景列表、R.k 旋钮、CAP.at 对齐单词时间、VFX 特效)。还支持查找 Ctrl+F、替换、折叠和 跳转到该行。

Ctrl+Space — API 自动补全

替换图片 · 音频 · 字体 · 视频

选中非文本文件时,会显示预览和 ⤒ 替换… 按钮。图片会适配为原来的尺寸·格式(填满·完整显示·保持原样),音频会在重新生成 MP4 时转换为原来的格式;🎞 用视频替换… 会在浏览器中把视频切成相同数量的帧放进去。另有 ↺ 恢复原样(仅将此文件恢复为公开版)、恢复为批次原件、⬇ 下载。

选中素材文件时的界面 — 替换·恢复原样·下载

原片剪辑视频的开发者模式

原片剪辑视频的预览是剪辑项目,文件列表中会显示单条文件夹(edit.json·meta.json·配音·音乐)和 制作文件(剪辑脚本·ASS 字幕·图形)。修改制作脚本后重新生成 MP4,脚本会重新运行,视频也会重新生成。可执行的脚本在服务器上运行,因此 仅运营管理员 可以保存·重新生成,其他人会看到「制作脚本(.py·.sh·.js·.html 等)仅管理员可修改」。脚本不读取的记录文件(edit.json·plan.md 等)会带有 ⚠ 标记 — 实际的字幕文案可能写在脚本里,请用 🔎 在 build.py 中查找 来查找。

原片剪辑视频 — 制作文件 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 时也会被拦截。

遇到问题 → 问题排查

最后更新: 2026-10-05

Shorts · Ten looks · Series

短视频、分镜、设计方案、系列,现在就开始

注册即送免费积分,无需绑定信用卡。

订阅邮件简报

第一时间获取新概念包、短视频制作案例、应用案例和生成技巧。

✦创作 ✎咨询

注册即送30积分(可生成3次套图) · 无需信用卡

免费开始