曦曦视频工坊

从明日学坊独立出来的本机教学视频工具：资料、讲稿、动态代码与连续画面，整理成可预览、编辑和导出的工程。

打开

需要Node.js 24.14+，在本仓库运行：

npm ci
npm run deps:video
npm run start:local

Windows可双击启动曦曦视频工坊.cmd。入口 **http://127.0.0.1:4285/**。前台运行用npm start，Ctrl+C停止。无需启动或安装明日学坊。

两个入口

通用制作：导入TXT、Markdown、Source JSON或粘贴原文，填写/生成分镜，核对出处，选择风格，预览后导出MP4和工程。手动新建不调用模型；新分镜使用沐曦1492。视频或PDF的提取不在本项目内，可先在资料工具整理后导入source.json。

机制课程：25秒KV素色3D、nano-vLLM素色全课、机制与动态源码、第三课算子工程。准备工程生成交互预览和工程ZIP，审阅后本机导出MP4。这些复用既有讲稿、原文、源码和CPU教学记录，不是新的模型总结或GPU实测。

详见工作流与资源清单。旧成片、个人任务和密钥没有复制进来，原应用保持独立。

放进其他仓库，与其他视频合并

在另一个仓库安装本地接口，即可用命令打开工坊、导出片段、合并已有视频：

npm install -D "file:D:/agent/xixi-video"
npx --no-install xixi-video open
npx --no-install xixi-video merge ./片头.mp4 ./课程.mp4 --out ./成片.mp4

也提供 import {mergeVideoClips, exportVideoClip} from 'xixi-video/interop' 供程序调用。片段包以相对路径保存原视频、SRT字幕、来源和校验值；移动目录后可直接导入。合并时统一尺寸和帧率，保留原声、为无声段补静音，并输出对应字幕与时间线。默认1920×1080、30fps；标准化需要本机编码时间。

接口不要求启动网页，不调用模型或生成声音，只需FFmpeg/ffprobe；open复用这个工坊和它的配置。详细命令、JavaScript示例和边界见片段接口。

视频工具与声音

无声视频需要Chromium、FFmpeg/ffprobe，3D预览需要WebGL2。有声分支还需官方Breeze CLI；旧Motion Canvas兼容依赖可选运行npm run deps:motion。

工具可用环境变量指定，或将程序路径保存在忽略的.local/runtime.json：

{
  "HYPERFRAMES_FFMPEG_PATH":"C:/tools/ffmpeg.exe",
  "HYPERFRAMES_FFPROBE_PATH":"C:/tools/ffprobe.exe",
  "HYPERFRAMES_BROWSER_PATH":"C:/tools/chrome-headless-shell.exe",
  "BREEZE_CLI_BIN":"C:/tools/breeze.exe",
  "BREEZE_RUNTIME_ROOT":"C:/tools/breeze-runtime",
  "PLAYWRIGHT_BROWSERS_PATH":"C:/tools/browsers"
}

BREEZE_RUNTIME_ROOT是官方CLI及校验器所在的可信安装父目录，不填写密钥或启动脚本。npm run runtime:check只核对工具，不生成声音或调用模型。系统字体在本机使用，不分发字体文件。

默认先做无声画面。网页可单独配置沐曦模型和Breeze，默认音色知微导引。无声分支使用HTML/GSAP/HyperFrames，有声分支使用Breeze Video Lab，当前添加声音会切换制作分支；背景音乐默认关闭，不附带游戏音乐。

模型只生成分镜数据，动画由代码模板控制。复杂机制需专门编排；模板不能自动证明源码解释、状态演算或教学结论正确。

智能体与维护

项目内置xixi-video-production Skill，网页“资源与方法”也可下载。Skill是制作指南，网页由程序运行；它不会自动安装到全局技能目录。

可直接向助手说：“读取本仓库 skills/xixi-video-production/SKILL.md，根据我的资料制作中文教学视频，先做无声预览，保留动态源码与出处。”宿主已发现此Skill时，可用 $xixi-video-production 调用。详细调用示例、API与命令、素材与场景、审片与恢复均随Skill下载。

npm run example:prepare -- --list
npm run example:prepare -- kv-plain
node scripts/example.mjs --render <工程UUID>
npm run check
npm test

命令行工程操作前先启动工坊。CPU夹具测试需Python，部分测试需上述视频依赖；实际渲染、画面和付费模型验收分别记录。

data/保存本项目配置和任务，outputs/保存工程与成片，.local/保存本机工具路径和启动日志，均不提交。public/为中文入口，lib/为视频服务，integrations/和templates/为制作资源，examples/保存固定教学依据。没有学习问答、困惑本、课程知识库或曦曦捕手。

抽取记录记录适配前的原文件哈希；第三方依赖与素材保留许可和署名。教学讲义不因代码使用MIT而自动适用同一许可，当前是本机工作仓库。