In html-video, each FrameRecord represents a multi-second HTML segment (durationSec, typically 3–30s). However, in standard video production, a "frame" is the smallest temporal unit — a single image, typically 1/24 or 1/30 of a second.
This creates a magnitude inversion that surfaces in user-facing UI text (e.g. the hv-form field frame_count labeled "帧数 / 画面数", and agent-generated steps like "每帧时长 / 帧数"):
- Professional video: 1 second = N frames (frame is a subdivision of a second)
- html-video: 1 frame = N seconds (frame is a multiple of a second)
For users with video production background, "每帧时长" reads as ~0.04s (1/FPS), not 5s — a 120× discrepancy. The project already mitigates this internally by pairing "帧数 / 画面数" in the form label, and FrameRecord comments describe it as "a single rendered HTML frame" rather than a video frame, which suggests awareness of the ambiguity.
Suggestion: keep frame / FrameRecord in engine-level code, but consider using "shot" (镜头) or "segment" (片段) in user-facing strings, since a 3–15s self-contained HTML segment maps naturally to a "shot" in film terminology.
In html-video, each FrameRecord represents a multi-second HTML segment (durationSec, typically 3–30s). However, in standard video production, a "frame" is the smallest temporal unit — a single image, typically 1/24 or 1/30 of a second.
This creates a magnitude inversion that surfaces in user-facing UI text (e.g. the hv-form field frame_count labeled "帧数 / 画面数", and agent-generated steps like "每帧时长 / 帧数"):
For users with video production background, "每帧时长" reads as ~0.04s (1/FPS), not 5s — a 120× discrepancy. The project already mitigates this internally by pairing "帧数 / 画面数" in the form label, and FrameRecord comments describe it as "a single rendered HTML frame" rather than a video frame, which suggests awareness of the ambiguity.
Suggestion: keep frame / FrameRecord in engine-level code, but consider using "shot" (镜头) or "segment" (片段) in user-facing strings, since a 3–15s self-contained HTML segment maps naturally to a "shot" in film terminology.