v0.4.11 — CLI installation repair preview

CLI installation repair preview

This prerelease fixes the missing-Bun installation path for macOS Apple Silicon. It is a CLI / portable release, not a new Windows EXE or macOS DMG.

Changes

• If no compatible Bun is available on macOS arm64, the installer downloads the fixed official Bun 1.4.2 asset and verifies its SHA-256 before activating it under the product's private directory.
• The stable launcher reuses the validated executable, including in a later process without a system Bun on PATH.
• Existing compatible Bun is reused; mismatched cache bytes, unknown files and unconfirmed process termination fail closed.
• Downloads and activation preserve the previous Runtime on failure. Global Bun and shell configuration are not modified.

Install this preview

Prerequisites: Node.js 20+ or an existing Bun, curl, and access to GitHub Releases. Download install.sh, install.cjs, and SHA256SUMS.txt from this same release, review the scripts and verify their checksums before running sh install.sh. The shell installer also verifies the downloaded install.cjs and the Runtime archive.

The short command in the versioned README selects this release explicitly; latest and the Plugin's stable channel are not promoted by this preview.

Validation and limits

• Installer regression: 84 passed, 0 failed, 2 Windows-only tests skipped.
• Release contract: 7 passed. Build, package validation, exact CLI asset inventory, checksums and extracted archive scans passed.
• Fresh public-download testing on an actual Mac Mini arm64 with no Bun passed: the public shell installer downloaded and verified private Bun and Runtime; repeat installation reused the same active Runtime, launcher and Bun cache; an empty-PATH process returned version 0.4.11; foreground health identified the owned process and version, the homepage returned HTTP 200, and explicit shutdown was verified.
• Network limits remain visible: the first official Bun download hit the 120-second timeout; one new-directory retry succeeded. The test host's anonymous GitHub metadata API was rate-limited, so public Release metadata was read on the coordinating host; all installer, Bun and Runtime software downloads still happened directly on the test Mac via public HTTPS. No credentials or local software bundle were transferred. This is not a guarantee of first-attempt success on every network.
• This preview does not validate Intel Mac/Windows auto-Bun installation, Desktop installers, launchd/background-service lifecycle, FFmpeg provisioning, animation, editing or export. Media work still needs its own dependencies and acceptance.
• Full typecheck is not claimed passed: the existing dependency tree has broken executable/type resolution. A same-environment comparison reproduces missing Bun declarations on the 0.4.10 base; the candidate adds three occurrences of that same missing-type diagnostic in its new test and no new production-source diagnostic.
• This is based on Runtime 0.4.10 and does not add the newer independent Xiaohei Skill's >=0.5.9 APIs.

All assets are new versioned output; previous tags and Release assets are retained unchanged.

v0.4.10 Windows Chrome discovery fix

v0.4.10 prerelease — Windows Chrome discovery

This release carries the Windows export renderer fix from the v0.4.9 baseline.

• The CLI export renderer now discovers Google Chrome in machine-wide and per-user Windows installations.
• CHENGFENG_VIDEOCUT_CHROME_PATH may explicitly select an existing absolute Chrome executable.
• Invalid overrides fail closed instead of silently falling back to another browser.
• macOS and Linux discovery remains covered by regression tests.

Windows installation and final subtitle/HTML-layer export must still be verified on the target machine after installing this release.

chengfeng-videocut Runtime 0.5.9 Windows Beta 1

Windows x64 public beta for the chengfeng-videocut Codex Plugin.

• Managed Runtime, Bun, FFmpeg and FFprobe are bundled; user PATH is not required.
• This installer is unsigned. Windows may show an unknown-publisher or SmartScreen warning; continue only if you intend to test this beta.
• The Plugin pins the release asset by SHA-256: eb565ffbec98620161e3f69a3db92510c01d8f5846f54a1afc91613895412ded.
• The release is not a macOS release and does not claim a real export test.

v0.4.9 prerelease — canonical CutRange repair

v0.4.9 prerelease — canonical CutRange repair

Prerelease / controlled test only. This patch keeps the Windows Desktop
controlled-test distribution boundary introduced in v0.4.8. It does not make
a general-availability claim.

What changed

• New projects now write their natural-pause cutRanges through the same
  canonical range builder that validates projects.
• During an ordinary project prepare, a legacy cuts-derived project is
  repaired only when its saved ranges exactly prove the old range shape and its
  word IDs still resolve against the current transcript. The resulting ranges,
  edit list, and preview projection are regenerated together.
• Manual timelines, unknown range shapes, duplicate or unknown word IDs, and
  projects that cannot be proved to be the legacy form are left untouched and
  continue to fail closed for review.

Validation boundary

This release has automated coverage for fresh natural-pause projects, provable
legacy cuts-derived migration, mixed semantic selections, and fail-closed
manual or unprovable projects. It does not claim a real Studio interaction,
an exported video, or human listening review has been validated by this change.

Download verification

Use assets from the exact v0.4.9 GitHub Release and verify each download against
its attached SHA256SUMS.txt. The checksum manifest detects download mismatch;
it is not a publisher signature.

Windows Desktop 受控预发布

v0.4.8 prerelease — Windows Desktop controlled test

Prerelease / controlled test only. This build is for invited Windows
Desktop testers and provides the downloadable Runtime that a subsequently
released matching Chengfeng VideoCut Skills contract may reference. Do not
treat it as a general-availability release.

What is included

• Windows x64 NSIS Desktop installer with the shared managed Runtime payload.
• Version-pinned and stable-name portable Runtime archives.
• Version-pinned and stable-name CLI .tgz archives for diagnostics or
  controlled installation.
• No macOS Desktop DMG is attached to this Release. macOS Desktop testing
  is outside the v0.4.8 controlled-test scope.

Download verification

Download assets only from this exact GitHub Release. Before running an
installer, verify its SHA-256 against the SHA256SUMS.txt attached to the same
Release. The manifest covers both installers, both portable names, both .tgz
names, and the Windows EXE. It detects a download mismatch; it is not a
publisher signature.

Test boundary and known limits

• The EXE is an unsigned prerelease test artifact. Windows reputation or
  security prompts may appear; do not bypass a warning you cannot attribute to
  this exact Release and checksum.
• Code signing, macOS notarization, automatic updating, and the redistribution
  license review for bundled FFmpeg/FFprobe are not complete. This release
  makes no claim that they are complete.
• Test on Windows 10/11 x64 only. The installer is per-user and does not request
  elevation. First launch installs the shared Runtime under the product-managed
  user directory; it does not modify the system PATH.

Feedback requested

Report the exact Release tag, asset filename, SHA-256 result, Windows version,
and whether first launch, Runtime health, and uninstall behaved as expected.

v0.4.7 测试版（桌面预览）

这是预发布测试版，不是正式稳定版。

包含：

• macOS Apple Silicon DMG 测试包
• Windows x64 NSIS 测试包
• Runtime 便携包与 macOS / Windows 安装器

测试版边界：

• 不设为 Latest，不改变稳定版用户的更新目标。
• macOS 尚未完成签名/公证；Windows 尚未完成代码签名。
• 桌面包随带 FFmpeg/FFprobe；仅用于受控测试，正式公开发布前仍需完成再分发许可与第三方通知复核。

首次启动会把 Runtime 与工具安装到 Product 受管目录，并以 macOS launchd / Windows Task Scheduler 启动同一条 Product 服务；Skills 使用同一稳定 launcher。

请将问题反馈为 GitHub Issue，并注明系统、安装包名称和诊断输出。

v0.4.6

v0.4.6

补齐 v0.4.5 旋转修复的最后一个探测器（全仓审计发现的漏网）。

修复

• 预览代理探测器旋转归一（probePreviewProxyMedia）：v0.4.5 只修了主探测器 probeMedia，预览代理链路用的是自己的一份 ffprobe 查询。竖拍源在它眼里仍是横屏：代理生成后的「宽高比不许变」校验必然失败（源报 1.78、产物实际 0.56），正确的竖屏代理被当作损坏删除——竖拍项目永远拿不到预览代理，且每次 prepare 白白转码一遍；Sharp 校验的期望尺寸同样来自这份查询，仍会误拦竖屏预览。本版让它与主探测器同律：读旋转元数据、按显示方向报告宽高。
• 审计确认其余全部 ffprobe 调用点安全（时长/关键帧/帧数探测不读宽高；探测产品自产中间件的天然无旋转标签）。

验证

• 真 ffmpeg 回归测试：竖拍源 ensurePreviewProxy 直达 ready，源/产物按显示方向双双竖屏
• 端到端：此前被误杀（invalid-proxy）的竖拍项目重跑 prepare → 代理 ready 406×720 竖屏
• 443/443 测试、TypeScript 门禁全绿

升级

竖拍用户请升级到本版（0.4.5 不够）：升级 → 对项目跑一次 project prepare → Studio 重试。

v0.4.5

v0.4.5

修复手机竖拍视频的整条画幅链路（真机报障：竖屏 608×1080 预览被产品按横屏 1440×810 期望拦下，Sharp preview validation failed）。

根因

手机竖拍视频存储为横向帧 + 旋转元数据（display matrix / rotate 标签）。probeMedia 此前不读旋转：探测报横屏 1920×1080，而 ffmpeg 转码时自动应用旋转、输出竖屏——画幅推导、Sharp 校验期望、导出计划全部拿到与实际画面相反的方向。

修复

• probeMedia 按显示方向报告宽高：读取 side_data_list.rotation 与旧式 tags.rotate，±90°/270° 时交换宽高。整条链路（画幅推导、画布、Sharp 期望、导出计划）自动改正。
• project prepare 自动校正存量错档：探测到源显示比例与档案声明不符（>2%）时，用推导值覆盖 config.aspectRatio 并随 prepare 写回。删词选择、账本、字幕全部不动。老项目升级后跑一次 project prepare <项目目录> 即修复。

升级即修复的路径

1. 升级 Runtime 到 0.4.5（新会话说「安装剪辑环境」，或重新跑安装命令）
2. 对受影响项目执行 chengfeng-videocut project prepare <项目目录>
3. 回 Studio 点「重试」——竖屏预览按竖屏期望校验，通过

验证

• 1920×1080+rotate90 探测归一为 1080×1920；无旋转文件不受影响（新增真 ffmpeg 回归测试）
• 端到端：竖拍建档推导 9:16（修复前错推 16:9）；手写错档 16:9 → prepare 自动校正回 9:16
• 442/442 测试、TypeScript 门禁全绿

v0.4.4

v0.4.4

两组改进：画幅比自动化 + Studio 预览可诊断化（Issue #3 全套修复）。

画幅比：由视频定义

• project create 的 --aspect-ratio 不再必填、不再限 3:4/4:3/16:9：省略时从视频实际尺寸自动推导（1080×1920→9:16，方形→1:1，非标尺寸如实化简）。显式传入仍可覆盖，接受任意 W:H。
• 工作台画布统一律：短边 1080、按比例放大、取偶——旧查表全部是特例，任意比例同样成立。

Studio 预览（Issue #3）

真机根因：常驻服务进程的环境是启动那一刻的快照——ffmpeg 装晚了，服务进程一直看不见它；终端 doctor 全绿也无济于事。本版让这件事被说出来、能恢复：

• 服务启动预检 ffmpeg/ffprobe（含 PATHEXT），缺失时写启动日志并在 /api/health 报 mediaToolsMissing。
• 错误透传：预览请求因找不到 ffmpeg/ffprobe 失败时，返回 media_tools_missing 与修复指引（service restart）；Studio 界面直接展示失败原文，不再让用户猜。
• 相位诚实化：新增 pending 相位——「从未生成/正在准备」不再冒充「剪辑已过期」「无单一媒体源」。
• 首个预览请求不再挂起：ledger 构建改 single-flight + 800ms 同步预算，缓存命中行为不变，首次构建立即返回 generating，由轮询追平；失败粘住并保留原文，重试按钮从头再来。
• 全仓 ffmpeg 输出显式 -f（7 处遗漏收口，新增 ffmpegOutputArgs 辅助函数）：把 v0.4.3 转录修复的同族问题一次清完。

验证

• 441/441 后端测试、TypeScript 门禁全绿；studio 前端测试与基线完全一致。
• Windows VM 复现实验：藏起 ffmpeg → 精确复现 Issue #3 双消息；service restart 自愈。
• 新增回归测试：画幅比推导/校验/画布律 6 条，预览预算竞速/失败透传 2 条。

升级

codex plugin marketplace remove chengfeng-videocut && codex plugin marketplace add Agentchengfeng/chengfeng-videocut-skills --ref <0.10.3 pin> && codex plugin add chengfeng-videocut@chengfeng-videocut

装完开新会话说「安装剪辑环境」即可升级 Runtime；已有 Runtime 用户也可直接 chengfeng-videocut service restart 解锁被 PATH 快照卡住的预览。

v0.4.3

v0.4.3

修复 Windows 上云端转录失败（第二例真机报障：ffmpeg … Unable to choose an output format for file:C:/Users/…audio.mp3）。

修复

• 转录音频提取不再依赖 ffmpeg 的输出格式推断。v0.4.2 把 file: 参数统一成正斜杠后，部分 Windows ffmpeg 构建仍推断不出输出格式。现在所有音频提取命令显式写 -f（-f mp3 / -f wav），格式推断这一步彻底不存在了。
• 编码器档位回退：libmp3lame（外部库，精简构建可能缺）不可用时自动降到 wav/pcm_s16le（任何 ffmpeg 内置），并重采样 16 kHz 单声道，与 ASR 声明参数一致。
• 格式声明贯通：实际用上的音频格式一路传到火山 ASR 请求体的 audio.format 字段，不再硬编码 mp3。
• 提取全部失败时，逐档报出具体错误并附安装指引（Windows: winget install Gyan.FFmpeg；macOS: brew install ffmpeg）。

其他

• cuts set 新增 --full-selection：按 Studio 复选框语义提交，允许放回停顿。

验证

• 本机（macOS ffmpeg）与 Windows 11 VM（gyan.dev ffmpeg 8.1.2，中文+空格+% 路径）三档提取命令全部通过。
• 全量测试套件通过；新增 3 条回归测试钉住显式 -f 与格式贯通。