范智鹏
458647d82e
- 新增 measurement/ 测量协议入口（baseline.md + timing-log.md） - 新增 docs/demo-storyboard.md 演示视频分镜 - README 新增背景与痛点、挂接测量协议/设计文档/分镜链接
35 lines
2.8 KiB
Markdown
35 lines
2.8 KiB
Markdown
# 演示视频分镜脚本（docs/demo.mp4）
|
||
|
||
> 用途：录制 ≤5 分钟演示视频的分镜参考，覆盖大赛规范要求的三个要素——**完整工作流 + IDE 集成效果 + 异常处理**。
|
||
> 成品存放：`docs/demo.mp4`；录完后更新 README「演示视频」节为正式描述。
|
||
|
||
## 录制准备
|
||
|
||
| 项 | 建议 |
|
||
|---|---|
|
||
| 录屏工具 | OBS Studio（免费）或 VS Code 内置屏幕录制 |
|
||
| 分辨率 | 1920×1080，窗口聚焦 VS Code |
|
||
| 示例工程 | `data/efficiency-samples/`（含缺陷的多语言样例，JS/CSS/Java/SQL 混合） |
|
||
| 时长 | ≤5 分钟，按分镜控制 |
|
||
| 语速 | 关键操作配一句口播或字幕说明，不堆话 |
|
||
|
||
## 分镜表
|
||
|
||
| 段 | 时间 | 内容 | 镜头要点 |
|
||
|---|---|---|---|
|
||
| 开场 | 0:00–0:20 | 项目一句话定位：「净码特工——AI 驱动的多语言代码审查一体化 VS Code 插件」；打开含缺陷示例工程 | 标题卡片 3 秒 → VS Code 窗口切入，左侧资源管理器展示四种语言文件 |
|
||
| 工作流①：静态审查 | 0:20–1:50 | 一键审查（`Ctrl+Shift+R`）→ 编辑器波浪线标记 → 「问题」面板结果 → 树形审查面板按严重级分组 | 编辑器 → 问题面板 → Webview 审查面板三个视角切换；圈出英文机器诊断原文 |
|
||
| 工作流②：AI 审查 | 1:50–3:00 | 触发 AI 深度审查：英文诊断翻译为中文 + 修复建议；挖掘语义级问题（安全/逻辑/性能/设计） | 高亮 AI 翻译条目与静态通道的合并展示；点开一条 AI 审查详情 |
|
||
| 工作流③：自动修复 | 3:00–3:40 | 单条 AI 修复 → diff 预览两步确认 → 写入自动保存；演示全部修复与按来源撤销 | diff 预览界面特写（两步确认按钮）；修复后问题数下降 |
|
||
| IDE 集成 | 3:40–4:20 | 方法级 CodeLens 审查按钮；保存自动分析；设置面板配置 AI Provider；导出 Markdown 审查报告 | 四个功能各 8–10 秒快切；CodeLens 按钮悬停特写 |
|
||
| 异常处理 | 4:20–4:50 | 断网或无效 API Key 场景：AI 通道优雅降级（面板 degraded 状态），静态通道独立可用不阻塞 | 面板降级状态标识特写 + 静态诊断仍正常产出 |
|
||
| 收尾 | 4:50–5:00 | 效果数据卡：23 文件 8.6 秒 / 人工 38.1 分钟 / 提速约 266 倍 / 检出率 27%→100%；仓库地址 | 数据卡片定格 5 秒（数据源：`measurement/timing-log.md`） |
|
||
|
||
## 录制后自查
|
||
|
||
- [ ] 三个规范要素均出现：完整工作流（段 2–4）、IDE 集成效果（段 5）、异常处理（段 6）
|
||
- [ ] 总时长 ≤5 分钟
|
||
- [ ] 文件命名 `demo.mp4`（ASCII 小写，无中文无空格），置于 `docs/`
|
||
- [ ] 单文件 ≤50MB（超限时压缩分辨率/帧率）
|
||
- [ ] README「演示视频」节更新为正式描述，删除「进行中」
|