大学生黑客松参赛指南
🆕 黑客松时间规划
# 用法
python3 scripts/hackathon_plan.py --hours 24 --team 4
# 交互模式
python3 scripts/hackathon_plan.py -i
> 比赛不是比谁代码好。是比谁把「问题+方案+Demo」讲得最清楚。
选赛道策略
| 你有 | 优先级 | 判断 |
|---|---|---|
| 个人故事 + 技术 | 🏆 最优 | 你经历的痛→你做的方案 |
| 独特数据 | ✅ 好 | 别人没有的信息差 |
| 纯技术能力 | ⚠️ 够用 | 需要补叙事——评委看故事 |
团队角色
| 角色 | 做什么 | 最低要求 |
|---|---|---|
| 码手(1-2人) | 搭 MVP | 能跑就行 |
| PM(1人) | 方案框架、逻辑链 | 逻辑清楚 |
| 路演(1人) | 5分钟讲清楚 | 不紧张 |
| 文案/设计(0-1人) | 提交材料+PPT | 会用模板 |
方案框架
项目名称（6字以内，一眼记住）
↓
一句话（15字以内）
↓
痛点（3句话：数据+现状+机会）
↓
方案（5句话：技术+交互+输出+优势）
↓
Demo（1-2分钟演示核心功能）
↓
为什么是我们（团队背景+个人故事）
5分钟路演脚本
0:00-0:30 钩子——一个画面抓住评委
0:30-1:30 痛点——让评委觉得「这问题确实存在」
1:30-3:00 Demo——直播操作，不是介绍功能
3:00-4:00 方案——技术架构+设计理由
4:00-4:30 团队——为什么是我们
4:30-5:00 结尾——一句话让评委记住你
评委常问
| 问题 | 准备方向 |
|---|---|
| 「跟现有方案有什么区别？」 | 列3个竞品+各1句优势 |
| 「技术可行性？」 | MVP跑通的部分 |
| 「数据从哪来？」 | 数据源+隐私保护 |
| 「为什么是你们？」 | 个人故事+团队背景 |
时间倒排
| 倒计时 | 做什么 |
|---|---|
| 4周 | 定方向+组队+方案一页 |
| 3周 | 搭 MVP（能 Demo） |
| 2周 | 内测+迭代+打磨方案 |
| 1周 | 录Demo+PPT+预路演 |
| 3天 | 逐字稿+模拟提问 |
换方向决策会（已确定方向可跳过）
比赛中途想换主题（话题私密/难落地/团队意见不合）时的会议实施方案，35 分钟出结果：
决策原则：
1. 换场景不换架构：多模态技术栈（视觉+语音+对话）是通用的，换主题只改场景/知识库，不要推翻重来
2. 打分决策法防争论：准备 3-6 个候选方向 + 8 维度评分表（赛道契合/社会价值/技术复用/演示冲击/落地难度低/差异化/评委记忆点），每人 1-5 分打分合计取最高——避免"我觉得A好/我觉得B好"循环 30 分钟
3. 收尾决策问题："哪个故事你们团队想讲 8 分钟？"——两个方向分数接近时用这个收尾
会议 6 议题（35 分钟）：
| 议题 | 内容 | 用时 |
|---|---|---|
| 1 方向选择 | 每人 1 分钟直觉 → 评分 → 前二讨论 → 投票 | 12 分钟 |
| 2 可行性 | 技术/内容/时间/数据 4 问（DDL 能完成吗） | 5 分钟 |
| 3 MVP 范围 | 演示支柱功能 1-2 个 + 砍二期 | 5 分钟 |
| 4 分工 | AI/前端/后端/内容/演示 认领 | 5 分钟 |
| 5 时间线 | DDL 确认 + 里程碑倒排 | 3 分钟 |
| 6 Demo | 主讲人/脚本/风险预案 | 2 分钟 |
8 分钟 Demo 脚本框架（故事>技术）：
0-1 分 开场钩子：数据冲击（"1700万视障人士也想化妆，没人教"）
1-2.5 分 用户故事：一个具体的人（小雨/王阿姨）
2.5-5.5分 现场演示：核心功能实拍（蒙眼演示/真实用户最有冲击力）
5.5-7 分 技术亮点：架构一页图
7-8 分 收尾金句 + 社会价值 + 未来扩展
换方向的心理考量（对用户）：如果原主题触碰用户隐私（如家暴/个人创伤），换方向是完全正当的——技术积累不浪费，比赛不值得心理负担。新主题选"赋能型"（帮助被忽视群体）既保留价值感又心理轻松。
v1.1.1 Changelog
- 修复交互模式非整数输入崩溃。
- 拒绝小时数或团队人数小于等于 0 的无效参数，并返回可诊断退出码。
