更新记录
CLI 与 Web 分别编号,版本号遵循语义化版本。
CLI 0.3.0 · 2026-11-18
新增
- CLI 源码(
runtime/notetofilm_local/)、安装器、配置样例和测试纳入仓库,源码入口为scripts/ntf.py。七个 Skill 的唯一源码在.agents/skills/,公共说明从shared/同步。分发包按组件清单收集文件,可在源码目录外安装命令与技能;回归包含真实分发、独立安装与合成。 scripts/build_binary.py:用 PyInstaller 构建dist/ntf(指向dist/ntf-runtime/ntf),审阅服务可从可执行程序启动。ntf sheet:按时间抽帧生成 JPEG 联系表,每格标注实际源时间与镜头 ID,可查看全片、每个剪点前后或指定时段。ntf inspect --scan:报告冻结、黑场和静音区间,可按时间表标注镜头。ntf web-render:把提供window.render(t)的项目内网页逐帧渲染为无声视频并登记采用。支持静帧预览与--text-check(标出文字出界、重叠、过小)、跨渲染顺序的确定性比对、相同输入复用、--dpr、--subframes/--shutter与--grain。需要web可选依赖(Playwright)及 Chromium 或本机 Chrome。- 合成:
subtitles_mode: embed输出可切换的内封字幕轨;audio_tracks: dual输出旁白混音与原声两条音轨;镜头可用native_subtitles_path提供原声字幕,作为第二条字幕轨。Pillow 配字烧录保留全部音轨。 - 连接来源:环境变量优先,其次 NoteToFilm 根目录
.env(启动时读取,不覆盖已有变量)。连接可声明codex_provider,每次请求即时读取 Codex 配置中的地址与令牌,令牌不进入项目快照。ntf routes显示每条路由的地址与凭据来源。 - 视频:
newapi-video支持return_last_frame(尾帧经原厂任务记录取得,登记为last_frame图片素材)与seed;新增 Seedance 2.5 路由样例。 - 图片:
gpt-image-2.6-sunburst路由按 GPT Image 能力声明参数(数量、自定义尺寸规则、质量、透明背景、格式、压缩、审核级别,参考图最多 16 张)。reference_to_image支持mask局部修改,路由用supports_mask与custom_size声明。 - direct:常见默认做法与修正;风格库收录工程蓝图、等距信息图、数据动态、白板讲解、杂志拼贴、铜版画、瑞士网格,每种附在 NoteToFilm 中的制作方式;风格配方模板;音画表加入对标、候选结构、段落卡和转场对。
- prepare 为可讲事实编号,旁白注明依据;video 增加尾帧接力。
- compose:代码动画骨架(同位对照示例、本镜时间表,
motion.js含beats、revealOn)、代码动画手法库与写法、本机工具箱(分屏、画中画、宫格保留指定原声,图文排版与素材加工)。 - 文档:
docs/新增文档索引、工作原理、开发与发版、常见错误与处理;通道配置说明开头增加接入步骤。 - 许可:以 GPL-3.0-or-later 发布(
LICENSE)。改编自 garden-skills(MIT)的内容及位置见THIRD_PARTY_NOTICES.md。
变更
- 对外名称统一为 NoteToFilm CLI(命令
ntf):--version输出NoteToFilm CLI <版本>,帮助说明与请求的User-Agent: NoteToFilm-CLI/<版本>同步。Python 包名、模块名与插件名保持notetofilm-local。 - 2.0 视频路由改用
doubao-seedance-2-0-fast-260128(路由company-seedance-2-0-fast)。内置模型清单加入gpt-image-2.6-sunburst,config-init生成七条路由。CPA+UniAPI 样例的默认路由改为 GPT Image 2.6 Sunburst 与 Seedance 2.5。 - 离线示例默认输出旁挂字幕,烧录需显式选择字幕方式与字体。
- Pillow 字幕与配字换行时,句末标点留在行尾,左括号随后文换行,英文单词和数字不拆开。
- compose 交付检查改为用联系表按时间看全片、剪点和关键变化;video 选片改用联系表定位可用区间。
- README 改为 CLI+Skill 说明,并去掉 Hugging Face Space 配置头(恢复 Web 部署时需加回);Web 使用说明在
WEB.md。 - 源码包加入
CHANGELOG.md。 - 构建后端要求 setuptools 77 及以上。
- CI 在推送和 PR 时只运行 CLI 回归;Web 回归改为手动触发。
Web · 未发布
- 多任务共用生成容量时等待空闲槽位,图片排队期间可继续配音;数据或配置持久化故障后停止新派发。
- 同次生成有作业失败后停止新认领;执行器异常时等待在途素材完成发布,再结束任务。请求准备或素材发布失败会记录作业终态。
- 单镜重做尚未认领时暂停或重启,保留已有素材及确认;已认领请求仍按中断恢复规则处理。
- 恢复时发现上游素材损坏,会为已有下游队列补齐依赖,等待新上游图片发布后再生成。
- 修改上游图片来源时,预演正确计算下游图片请求数及确认失效;多个单镜编辑器可独立预演,取消编辑后忽略过期响应。
Web v0.4.0 · 2026-10-17
- 分镜修改影响规则抽取为服务端纯函数(
app/domain/plan_impact.py、app/domain/references.py),保存与素材发布共用同一份判定;前端删除重复规则。 - 新增只读预演接口
POST /api/v1/tasks/{id}/plan/impact:请求与保存一致,返回每镜图片/配音动作、确认是否保留、上游失效标记和保存后所需生图请求数;不写库、不触发快照、不调用模型,并与保存共享所有权、状态与版本校验。 - 预演接口与保存使用相同请求体限额;前端防抖请求并绑定草稿序号,响应乱序或失败不展示旧结论。
- 数据库升级 schema v10:新增素材生成作业表。每次图音生成先登记持久作业,条件认领(同一操作内每镜每类最多一次)、非秘密输入快照与摘要、发布前素材版本复核;重启时生图作业记
unknown、配音记failed、未派发队列终止。分镜编辑、删镜与重排保留历史作业与付费台账。 - 任务内并发生成上线:
app/scheduler.py进程内调度器按作业依赖图派发,全服务生图并发 1、配音 2、单任务图音合计在途 3(limits.image_concurrency/audio_concurrency/task_inflight,所有生成入口共用)。同操作内生图作业等待前镜持久发布;一个作业失败后本操作停止新认领、在途收尾并保留成功素材,其他任务不受影响。暂停语义为"已认领作业视为在途,完成后暂停"。 progress新增jobs字段(在途镜头/类型列表与完成计数),stage/scene_index按镜头顺序取第一个在途作业以兼容旧客户端。- 旧完整配置缺失并发键时自动补默认,未知字段仍拒绝;保存后需重启生效。
- 升级前按第 6 节留存 v9 快照与配置原件;严格回归 263 项全绿(新增作业台账与调度器并发测试)。
Web v0.3.0 · 2026-10-16
- 完整明文 TOML 独立保存管理员令牌、模型密钥、网关、运行限制和存储设置;已有文件优先,支持一次性导入旧环境配置。
- 新增私有 config bucket 与 data bucket。SQLite 在本地运行,每次写入生成一致性快照,媒体完成上传后才发布快照清单;重建时校验摘要并恢复。
- 保留旧任务、额度、所有者、历史图音和已发布成片;持久化失败暂停新操作,未知付费请求恢复后仍需人工确认。
- 管理页支持编辑模型密钥、遮蔽读取和显式完整导出,运行设置变更提示重启;任务快照保持不含明文凭据。
- Docker Compose 改为独立 config/data 挂载,补充旧配置导入脚本及存量 HF 临时盘迁移要求。
数据库仍为 schema v9。旧 HF 临时盘部署必须先备份完整数据再重建;两个 bucket 使用单实例写入。
Web v0.2.0 · 2026-10-16
- 连续预览支持上一镜、下一镜、镜头跳转、时间位置和定位编辑;缺少图音时停在对应镜头,素材版本变化时暂停。
- 单镜修改显示素材更新范围及配音实际时长;总时长超限时可直接定位到需要修改的镜头。
- 修复图片来源与参考设置回显、换图保存、旧草稿覆盖、上传图重配音和未修改素材确认失效的问题。
- 修复多镜参考链漏生成与请求次数预估;生成时采用任务自身保存的参考协议配置。
- 合成素材清单 v2 记录稳定镜头 ID、图片素材 ID 和实际参考摘要,保留旧清单恢复支持。
- 已完成视频可修改为新版本并保留旧片下载;复制为新草稿明确保留原文、旁白、画面描述及制作要求,清空素材和参考绑定。
- 图片上传的媒体处理移出主事件循环;Docker Compose 补齐参考协议与上传限制配置。
- 增加素材编辑、参考链、清单兼容和前端修改反馈回归测试。
数据库结构维持 schema v9。升级前备份数据目录;模型参数仍在管理面板配置,真实密钥由环境变量或 HF Secrets 提供。