CineCode.video
简中
开始制作

排错

排查 CineCode 导出失败

从第一个报错环节查起，先确认文件和环境，再重新渲染。

智能体没有加载技能

确认技能装在当前客户端使用的目录。Claude Code 读取 ~/.claude/skills/cinecode，Cursor 读取 ~/.cursor/skills/cinecode。安装或更新后重新开一个会话。

在新建的影片文件夹里明确要求使用 CineCode。若找不到渲染命令，在运行智能体的同一个终端里检查依赖。

git --version
node --version
python3 --version
ffmpeg -version

Chrome 已启动，画面渲染卡住

确认当前机器能正常打开 Chrome 或受支持的 Chromium 浏览器，输出目录可写且磁盘空间充足。让智能体运行 CineCode 的渲染探测，查看它找到的浏览器和渲染方式。

如果探测结果显示使用 CPU，先试一段低分辨率草稿。若首帧能打开，但字体或素材缺失，检查文件是否存在，以及引用路径是否以影片目录为基准。

找不到 MP4，或者没有声音

打开智能体报告的影片目录。草稿和中间文件可能在 renders 或 review 中，最终 MP4 位于影片目录的顶层。

先播放 MP4。如果预期有声音，用 ffprobe 确认文件是否包含音轨，再检查混音和源文件是否齐全。

ffprobe -v error -show_entries stream=codec_type,codec_name,width,height -show_entries format=duration "<title>.mp4"

Windows 提示没有权限或文件被占用

把项目放进单独的可写目录，并关闭正在打开草稿的播放器。上游记录了初始化时的权限错误，以及临时 WAV 重命名时的 EBUSY 错误。可以对照对应 issue 的错误信息和处理进度。

如果要提交新问题，写明系统、智能体版本、CineCode 提交版本、失败阶段和第一条报错。