Skip to content

FrameCheck 0.2.1 — First-run demo, agent skill and easier setup

Pre-release
Pre-release

Choose a tag to compare

@lqeleven520-code lqeleven520-code released this 22 Oct 18:02

FrameCheck 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-001 generate 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/bin beside the Windows executable.
  • The Windows package includes an optional interactive 安装FFmpeg.cmd helper. No silent download or bundled FFmpeg.
  • framecheck doctor --json provides 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 open FrameCheck.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.zip or 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.