winhok/testkit/video-to-issue

缺陷录屏转 Bug / Issue

交付目标是测试人员可以提交和跟进的缺陷单。先确定用户问题、视频来源与时长，读取 video-review.md；编写或提交时读取 issue-contract.md。只生成抽帧文件不算审阅完成。

1. 使用当前可用的媒体读取工具核对视频时长、帧率/时间基准和是否有音轨。工具缺失或无法观察画面就明确报告，不臆测内容。
2. 对短视频完整审阅；长视频先粗定位再加密异常前后区间。记录已审阅区间、采样间隔和未审阅范围。
3. 建立时间线：用户可见操作、页面/系统状态、异常起止、恢复情况。引用具体时间戳和帧。
4. 将观察组织成 issue-draft.md：标题、环境与构建、前置条件、编号复现步骤、预期结果及其来源、实际结果、时间戳证据、影响和待补充信息。复现步骤只写视频可见或用户明确补充的动作；一次录像不代表已独立复现。
5. 预期没有需求或用户依据时标记待确认，仍交付有用草稿。区分建议严重程度与平台优先级，不编造复现率、根因、设备版本或问题 ID。视频时间与日志墙钟时间必须另行校准。
6. 用户只要草稿时交付草稿；用户明确要求提交时，核对平台/项目和必填字段，使用已连接工具创建 Issue，复用已有授权。提交成功后返回平台实际生成的 ID/链接；缺少工具、目标或必填信息时保留草稿并说明具体缺口。附件上传遵守目标平台权限与当前授权。
7. 后续需要独立复现/修复复测时交给 defect-verification；需要证据登记时读取 共享执行契约。

环境已有 ffmpeg/ffprobe 时，可运行 python scripts/sample_video.py --input <video> --output-dir <new-directory> --start 0 --duration 10 --interval 1。每次最多 100 帧/300 秒；实际审阅输出帧后再给视觉结论，sample.json 的 reviewed=false 不能当成已审阅。

不把静态画面当应用卡死、不把页面成功当服务端写入完成。不能由录屏证明网络、数据库或代码级根因。语音仅在问题相关时转录，标记自动转录及不确定片段；不默认 OCR 全部帧。