Skip to content

blueskyxn/notetofilm-local

v0.3.0

以本地 Skill 编排材料、分镜、图像、视频、Edge TTS 和混合成片,项目与媒体保存在本机。

更新记录

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 提供。