文件结构说明

note/ ：为组里所有人博客的汇总
test/ ：放测试代码

计网小组开发规范

文件存放规范

• note/:放个人的学习笔记，思考，博客;(也就是自己没有搞懂的不要放进去)
• ai-attachments/:放ai写的需要参考的聊天记录

git规范

• main分支受保护，每个人自己新建一条分支，不要push force到主分支
• commit请小步一点,可以函数为颗粒度提交代码

合并规范

• 各部分代码在合入主分支前，应在note文件夹里讲讲自己的编码思路，确保是理解代码的
• 为自己的代码写验证脚本，宁可慢一点不最后屎山赶工

ai规范

• 让自己的ai开始各个部分工作前，阅读一下已有的ai-attachments，减少幻觉率

环境规范

根目录下

python -m pip install -r requirements.txt

评测接口规范

编码器

命令:

./encode in.bin out.mp4 1000

参数:

• argv[1]: 输入二进制文件（默认限制 <= 10MB）
• argv[2]: 输出视频文件名
• argv[3]: 视频最大时长（毫秒）

约束:

• argv[3] 只约束“有效数据帧”的总时长（不含 2 秒前导白帧）
• 若输入数据在该预算内放不下，将自动截断输入，只编码前 N 字节
• 编码过程只生成文件，不在终端播放视频

解码器

命令:

./decode recorded.mp4 out.bin out.val

参数:

• argv[1]: 输入视频文件
• argv[2]: 解码输出二进制文件
• argv[3]: 位正确性标记文件（.val，二进制）

.val 格式

• 二进制位打包格式，标记 out.bin 每个位是否正确
• 1 表示正确，0 表示错误
• 当前实现中，CRC 通过且完整恢复时，对应位全部置 1（即字节为 0xFF）