Repository navigation
FrameCheck 0.2.1 — First-run demo, agent skill and easier setup
Pre-releaseFrameCheck 0.2.1 makes the first run easier: download the Windows app, check dependencies, then run a complete synthetic example without preparing your own videos.
What's new
- Desktop 运行内置示例 and CLI
framecheck demo -o demo-001generate and compare a 24-frame synthetic pair. The intentional FAIL in the report is explained; a successfully completed demo exits 0. - FFmpeg discovery now includes normal per-user WinGet installations and
ffmpeg/binbeside the Windows executable. - The Windows package includes an optional interactive
安装FFmpeg.cmdhelper. No silent download or bundled FFmpeg. framecheck doctor --jsonprovides shareable version information without local paths.- The independent FrameCheck agent skill includes the reviewed Python runtime source and a local entrypoint, so it no longer requires downloading a separate FrameCheck wheel. It supports Codex, Claude Code and other compatible clients. Install with
npx skills add lqeleven520-code/framecheck --skill framecheck, or download the skill ZIP. - A public download page, interactive image example, offline sample report and structured feedback forms are included.
Hardening in 0.2.1
The skill runtime is now shipped as readable source with synchronization checks. A clean skill environment with NumPy/Pillow and FFmpeg, but no installed FrameCheck distribution, completed the demo successfully. Linux CI reuses available FFmpeg and bounds package-manager network waits. Third-party directory ratings remain independent of these checks.
Downloads / 下载
- Windows x64:
FrameCheck-0.2.1-windows-x64.zip. Extract the whole folder and openFrameCheck.exe. - Python 3.10+:
eleven_framecheck-0.2.1-py3-none-any.whl. - Agent skill:
framecheck-skill-0.2.1.zip; contains the public skill, inspectable FrameCheck source, dependency declarations, metadata and MIT license. - Source:
framecheck-0.2.1-source.zipor the source distribution. - Verify files with
SHA256SUMS.txt.
FFmpeg 5.1+ and ffprobe must be installed separately. The Windows app can select an existing ffmpeg.exe.
Verification
36 tests and lint passed on Windows. A clean wheel installation, frozen desktop engine, normal GUI workflow and GUI demo all passed. The frozen app found a real WinGet FFmpeg installation with no FFmpeg PATH entry or explicit override. The skill installed correctly into an isolated Codex project using skills CLI 1.7.4. The local website's images, comparison slider, report navigation and copy button were exercised in a browser. All six hosted CLI/engine checks passed on Windows, Ubuntu 24.04 and macOS Intel with Python 3.10 and 3.12: https://github.com/lqeleven520-code/framecheck/actions/runs/39829329449. The follow-up commit changes only CI setup; the released application and skill code are unchanged.
This remains an early release. It checks SDR pixel/timing evidence, not audio or creative quality. It does not automatically align or resize videos. No independent external user count is claimed. The Windows executable is unsigned; follow your system's security prompts and verify the release source. MIT license; third-party notices are included.
Directory snapshot note: at verification time, skills.sh still displayed the 0.2.0 description and Snyk W012 warning about installing a wheel from a new personal repository. Version 0.2.1 instead bundles the inspectable runtime source. The current GitHub installation and ZIP were tested; a new Snyk approval is not claimed.