产教融合训练营 · 项目提交模板

四大赛道通用：华为 / 中软 / 科大讯飞 / 览众科技

本模板用于训练营各小组提交实训成果。git clone 本仓库后，按下方规范把成果放到对应目录即可。

快速开始（每组首次使用）

git clone 本模板仓库，作为你组仓库的起点。
打开 README.md，填写下方"组别信息"段。
按目录用途把成果放到对应文件夹，按命名规范命名。
首次提交：git add . → git commit -m "feat: 初始提交" → git push。
后续每次提交成果：git add . → git commit -m "<前缀>: <说明>" → git push。

模板自带的各目录 README.md 是说明文件，可保留；如不需要可删除。

一、组别信息（每组必填）

clone 后请把本段替换为你的组别信息。

赛道：览众科技赛道
组号：6
组员：黎钊恺、吴锐锋、贾天宇、康奕
指导老师：
校内老师：

二、目录用途

目录	放什么	不放什么
`文档/`	需求文档、操作手册、过程记录、每日进度、指标字典、复盘报告、运营方案、追问应答	PPT、视频、简历、个人实训报告
`代码/`	清洗、指标计算、推荐、可视化、工具脚本	依赖目录、`__pycache__`、编译产物、大数据
`答辩/`	答辩 PPT、演示视频外链、答辩素材	文字报告（去 `文档/`）、视频草稿
`简历/`	每位组员个人简历（PDF 优先，每人一份）	实训报告、组级文档
`实训报告/`	每位组员个人实训报告（结营总结，每人一份）	简历、组级复盘报告
`其他/`	外链登记、数据质量检查、过程截图、看板截图、数据样本、临时素材	超大文件（走外链）

简记：文字 → 文档/，程序 → 代码/，PPT与视频 → 答辩/，其余 → 其他/。

三、命名规范

组级文件名格式： {赛道简称}-{组号}_{成果名}_v{版本}.{ext}

个人文件名格式： {赛道简称}-{组号}_{姓名}_{成果名}_v{版本}.{ext}（简历、实训报告等每人一份）

赛道简称对照：

赛道	简称
华为	`HW`
中软	`CS`
科大讯飞	`IFLY`
览众科技	`LZ`

组级示例： - LZ-组1_用户行为复盘报告_v1.docx - HW-组2_鸿蒙Demo演示视频_v1.mp4 - IFLY-组3_语音识别模型训练脚本_v2.py - CS-组1_需求规格说明书_v1.docx

个人示例： - LZ-组1_张三_简历_v1.pdf - LZ-组1_张三_实训报告_v1.docx

代码目录内用子目录承载项目，如 代码/LZ-组1_清洗脚本/，内部文件不限命名。版本号从 v1 起，迭代递增。

四、提交规范

成果就绪后：git add . → git commit -m "<前缀>: <说明>" → git push
commit message 前缀建议：
feat: 新增交付物
fix: 修改已有交付物的问题
docs: 文档更新
示例：feat: 新增览众组1用户行为复盘报告v1

五、大文件处理

大数据集（超 5MB 的 csv/xlsx、zip、parquet 等）：不要直接提交。放网盘或天池/Kaggle 链接，在 其他/README.md 注明下载方式与数据来源。
大视频（超 100MB）：走网盘或 Gitea Release 附件，答辩/README.md 留链接。
仓库只保留裁剪后小样本、质量检查表、文档、代码、导出产物。
.gitignore 已默认忽略压缩包、视频、缓存等；csv/xlsx 不全局忽略，但单文件 > 5MB 一律不提交。

六、目录速查

项目提交模板/
├── 文档/        需求、手册、过程、指标、报告、方案
├── 代码/        清洗、指标、推荐、可视化脚本
├── 答辩/        PPT、演示视频外链、答辩素材
├── 简历/        个人简历(每人一份)
├── 实训报告/     个人实训报告(每人一份)
└── 其他/        外链·数据质量·截图·样本·素材

每个子目录下都有 README.md，进入查看具体说明。