摸鱼不队 | Alpha 冲刺总结——《疙瘩瘟》
| 这个作业属于哪个课程 | 202601福大-软件工程实践-W班 |
| 团队名称 | 摸鱼不队 |
| 这个作业要求在哪里 | 软件工程实践团队作业——站立式会议+α冲刺 |
| 这个作业的目标 | 总结 Alpha 冲刺七天的预期计划与实际进展,展示《疙瘩瘟》项目的开发成果,分析八位成员的分工协作与 Alpha 阶段工作量比例,梳理各成员的收获与心得体会,回顾 AI 技术员的贡献并制定下一阶段改进计划 |
| 其他参考文献 | 《构建之法》第2章、第9章、第13章;Ren'Py 官方文档;华为云 CodeArts 流水线与仓库记录 |
目录
- 一、项目背景与 Alpha 冲刺目标
- 二、项目预期计划与实际进展
- 三、Alpha 阶段项目成果展示
- 四、七天冲刺进度与燃尽分析
- 五、团队分工、工作量与协作情况
- 六、各成员的收获与心得体会
- 七、测试工作与项目质量总结
- 八、AI 技术员的工作回顾与贡献分析
- 九、Alpha 阶段存在的问题与反思
- 十、Beta 阶段展望与改进计划
- 十一、答辩准备与 PPT
- 十二、Alpha 冲刺总结
一、项目背景与 Alpha 冲刺目标
1.1 项目背景
摸鱼不队本次软件工程实践开发的项目是 《疙瘩瘟》——一款以明末华北大鼠疫为背景的多视角文字互动游戏,基于 Ren'Py 8.5.3 开发。
题材取自崇祯十四年的那场大疫:连年大旱、蝗蔽天日,饥荒未尽,一种以腋下、股间硬块起病、高热谵妄、皮肤青紫瘀斑为特征的怪病悄然蔓延,史书上只记了一笔「大疫」,而瘟疫中挣扎过的人各自做过怎样的选择,却没有人记录。
我们把这段历史做成了三条视角线:
- 郎中线 · 民间医者——从旧医书走出去,进疫区观察病症,寻找新治法;
- 百姓线 · 京城百姓——关上门守着家人,还是走出去帮别人;
- 武官线 · 守城武官——铁腕封城守住城池,还是开门放进城里的难民。
选择这条「把历史题材做成可交互叙事」的路线,是我们在需求分析阶段做出的判断:同一个历史事件,放进游戏里才存在选择,放进文档里就只剩下结论。
游戏采用 Ren'Py 的 状态变量 + 分支菜单 + 结局注册表 三件套结构:
主菜单 → 序场 → 选线 → 剧情分支(属性 / 道具 / 信任度累积)
→ 结局 label → unlock_ending() 登记 → 结局图鉴 → 返回主菜单
每条线都有 67 个结局、816 个分支菜单,结局是否解锁由累积的数值链决定。例如郎中线的 doctor_vitality(体力)、doctor_infection(感染)、doctor_insight(见识)、doctor_trust(信任)、doctor_medicine(药材)和 doctor_items(道具)共同决定玩家最终走到「著书存道」还是「济世名医」;体力归零则会被 d_status_check 强制改写成「病中殉职」,玩家无法从结局菜单里绕过去。
1.2 Alpha 冲刺的核心目标
根据团队在 Day1 敲定的七天执行计划,本次 Alpha 冲刺采取 「先把主干立起来,再按进度逐步扩展」 的开发策略。
优先级最高的是 P0:三条线能各自完整走通,结局能进图鉴。具体拆成七项:
- 选定并敲定技术主干:数据库接入 Ren'Py 的数据读写层(档案切换、存档创建/读取/删除、游玩与选择写入、结局首次解锁、参数化查询、事务与异常处理);
- 三条剧情线各自实现入口接线、分支菜单、属性与道具;
- 界面与系统层:主菜单、选线、存档读档、设置、结局图鉴、关于、结局卡、字幕、对话、快捷菜单等;
- 美术资源归位并接入:背景、立绘、道具、结局图,遵守「文件名 = 剧情里引用的名字」;
- 结局注册表与通关判定:
ENDINGS注册、unlock_ending()解锁、三档通关判定; - 自动化测试与 CI:能自动跑的测试套件 + 能自动判红绿的流水线;
- 交付物:版本、Issue/PR 记录、每日随笔、燃尽图、冲刺总结与答辩材料。
贯穿全程的一条原则是「接口先行、边推进边对齐」:Day1 就先把数据读写层的分层方案和接口方法签名固定下来,三条线不用互相等待,谁的接口先落地谁先接,联调时再一起校准。
二、项目预期计划与实际进展
2.1 七天冲刺预期计划
本次 Alpha 冲刺从 2026 年 10 月 23 日开始,到 10 月 29 日结束,共七天。团队按功能依赖关系划分为七个阶段:
| 日期 | 计划主题 | 预期完成内容 |
|---|---|---|
| Day1(10-23) | 冲刺启动与目标确认 | 首次站立式会议、Alpha 目标与 7 天计划、技术主干(数据读写层)方案敲定、分工确认、美术归位规范、发布《代码规范、冲刺任务与计划》 |
| Day2(10-24) | 转向实操 | 数据读写层骨架搭建并跑通首次自动建表、接口签名固定、三线试接结局解锁、美术首轮归位、提交规范落地 |
| Day3(10-25) | 并行推进 | 三线持续推进、美术按需制作、剧情与美术命名对齐、代码测试后合仓 |
| Day4(10-26) | 互相接上 | 美术与剧情文件名对齐、界面 13 个改版与关键 bug 修复、结局注册与菜单层重构、分支合并准备 |
| Day5(10-27) | 优化与对接尝试 | 美术正式接入项目、界面优化、三线推进至结局、测试套件成型 |
| Day6(10-28) | 内测打磨与流水线 | 流水线从任意分支拉起测试组件并执行、百姓线运行测试、美术资源补齐与透明通道修复、CI 侧 GLX visual 卡点定位 |
| Day7(10-29) | 全流程回归与冲刺收尾 | 三线全过程运行测试、流水线与自动化测试收尾、13 个界面统一改版、人物立绘透明度处理、道具图与结局图补充、冲刺材料归档 |
2.2 实际开发过程
Day1:把路铺平
第一天没有写多少功能,开了首次站立式会议,重点是四件事:确认「三线剧情 + 数据库 + 界面初稿」推进到「可运行、可存档、可解锁结局的完整可玩版本」这个 Alpha 目标;敲定数据库接入 Ren'Py 的数据读写分层方案;确认三线、界面、美术三条线的分工归属;定下美术资源归位规范——图片统一放 game/images/bg|char|ui,英文命名,图标放 game/gui/window_icon.png,文件名 = 剧情里引用的名字。
当天的实际剩余任务点是 38(计划 35),落后 3 点。PM 在随笔里的解释是:冲刺启动事务多,且三条线都依赖数据读写接口,梳理耗时。
Day2:从「说清楚」到「跑起来」
数据读写层完成骨架搭建并跑通首次自动建表,接口方法签名固定下来,三条线不用再等设计稿就能动手接入;郎中线和武官线完成初稿和第一版 Ren'Py 代码;美术完成首轮归位,game/images 与 game/gui 目录结构成型。
这一天的困难很具体:不同支线的代码规范没有先统一,导致联调时出现冲突,甚至出现无法启动的问题。当天实际剩余 34(计划 30)。
Day3:并行推进与命名对齐
三线持续推进,美术按需制作,代码测试后合仓。当天最有价值的一个决定是 把人物、背景、道具、结局的美术命名与剧情命名合并考虑,便于后期插入美术;同时决定对关键美术保留、对非必要美术删减。
当天实际剩余 27(计划 25),落后 2 点,主要卡在剧情讨论与美术命名冲突。
Day4:从「各自做」到「互相接」
Day4 的重点从「把功能做出来」转向「把做出来的东西接上」。三条线同时推进:武官线的道具与结局美术完成、郎中线的背景与人物美术落地并与剧情代码对接、界面系统完成 13 个界面改版与一批关键 bug 修复、百姓线完成剧情润色与美术资源统筹。
这一天有两件事值得单独记:
- 界面组反馈「进入二级界面后所有按钮都失效」,会议决定先定位根因再继续做新界面,不再靠试。 根因最后落在
ui.interact()的菜单层机制,而不在按钮本身。 - 赫庆国反馈统筹美术资源时没有考虑好预算与工期,会议决定后续按「必需 / 可延后」分层交付。
当天实际剩余 21(计划 20),只落后 1 点,差距在收窄。
Day5:优化与首次对接
界面优化、美术正式接入项目、三线推进至结局、测试套件成型。当天 PM 审验项目时有一句很实在的话:「尽管代码由组员和 AI 进行协同开发,但还是要对项目进行审验。」
当天实际剩余 15,与计划持平,进度正式追平。团队自己的解释是:由于前期准备的规范充分,后期到达达标状态。
Day6:转向可验证的内测
第六天工作重点从「功能实现」转向「可验证的内测和交付准备」。陈宇杰在 CodeArts 上累计完成 26 轮构建,验证了「任意分支都能拉起测试组件并执行测试套件」这条链路;范自亮测试并修改百姓线剧情代码;吴昊完成百姓线背景与人物立绘并修复立绘不透明问题;袁志华优化道具与背景资源;朱熙完成 18 个结局注册表、三档通关判定和菜单层重构,修复二级界面按钮失效、Esc 无效、读档按钮无法点击等 8 个交互问题。
当天的唯一明确阻塞项是 GLX visual——它不影响本地 Ren'Py 工程启动,但影响流水线的视觉检查是否完全通过。实际剩余 10,与 Day6 计划值持平。
Day7:全流程回归与冲刺收尾
三条剧情线分别由范自亮(郎中线)、赫庆国(百姓线)、卢宗园(武官线)完成全过程运行测试,按主要选择路径检查剧情推进、分支跳转、属性变化、道具获取、结局触发和结局图片显示;陈宇杰完成流水线运行和测试工作收尾;朱熙完成 13 个界面的统一改版,并把自动化测试通过率从 56% 提升到 85%;吴昊持续处理人物立绘背景不透明问题;袁志华继续补充道具图与结局图。
当天实际剩余任务数降为 0,进入最终提交和后续维护阶段。
2.3 预期与实际完成情况对比
| 项目内容 | 原定计划 | Alpha 实际进展 |
|---|---|---|
| 技术主干 | 数据库接入 Ren'Py 的数据读写层 | 分层方案与接口签名固定,三条线均按约定接入;数据层实现(6 张业务表 + 19 条测试,全部通过)交付在 feature/user-db 分支的 database/ 目录,尚未合入 master |
| 剧情线 | 三条线各自跑通 | 郎中线 588 行 / 27 标签 / 16 菜单 / 7 结局;百姓线 766 行 / 25 标签 / 12 菜单 / 6 结局;武官线 1125 行 / 14 标签 / 8 菜单 / 6 结局 |
| 界面与系统 | 主菜单到结局图鉴的完整链路 | 界面层共 18 个 screen 定义(ui_screens.rpy 17 + screens.rpy 1),其中 13 个完成统一改版;菜单层从 ui.interact 重构为 call screen 循环 |
| 结局系统 | 结局注册与解锁 | ENDINGS 注册 18 个结局(3 线 × 6),支持到达即解锁,完成三档通关判定 |
| 美术资源 | 背景 / 立绘 / 道具 / 结局图接入 | game/images 59 张(bg 13、char 13、prop 10、ending 7、officer 10、界面底图 6)+ game/gui 2 张图标,合计 61 个图片文件接入 |
| 自动化测试 | 可重复执行的测试套件 | Ren'Py 内置测试框架 6 个 .rpy 文件、25 个 testcase 块,运行期展开 61 条用例,分支适配守卫生效 |
| 工程化 | 流水线自动判红绿 | CodeArts 流水线接通,含 9 个 CI 脚本 2934 行,26+ 轮构建迭代 |
| 交付物 | 版本、博客、总结、PPT、Demo | 7 篇每日随笔 + 燃尽图 + 分支规范 + 本篇冲刺总结 |
整体来看,本次 Alpha 冲刺的实际工作始终围绕「三条线能各自走通、结局能进图鉴」这个 P0 展开,并在 Day4—Day7 补上了界面统一、美术落地与自动化测试三块。计划中「先完成 P0 再按进度扩展」的策略在 Day5 得到了回报——当 P0 提前达标,团队才有余量同时推进界面改版和流水线。
计划与现实最大的两处偏差:
- Day2—Day3 连续滞后(34 / 27,计划 30 / 25)。根因不是技术难度,而是各支线没有统一遵守代码规范,联调时爆发冲突。这条经验后来直接写进了 PM 上传的《Ren'Py 开发与合并规范》。
- 燃尽图的度量口径在 Day1→Day2 之间换过一次基。Day1 的图是 100 分制(实际 92),Day2 起统一为 40 分制,实际线记为 38。本文统一采用 40 分制序列,并在第四节标注换基事实。
三、Alpha 阶段项目成果展示
3.1 项目仓库与运行方式
项目仓库:
本地运行方式(Ren'Py 桌面工程):
- 安装 Ren'Py SDK 8.5.3 或以上版本(测试框架
testsuite/testcase最早出现在 8.5.0); - 用启动器打开仓库根目录,点击「启动项目」;
- 主菜单 →「开始游戏」→ 序场 → 选角界面 → 选择三条线之一。
自动化验证方式:
# 跑全部用例(退出码 0 = 全绿,非 0 = 有失败)
bash test/run_tests.sh
# 只跑某一条线
bash test/run_tests.sh doctor_line
# 先 lint 再跑测试
bash test/run_tests.sh --lint
流水线:
CodeArts 项目内已开通流水线「测试」(pipeline id 699f49d893fb4c9e817783a5f75e70ff),触发方式为 push(master 与 feature/*、feat/*、codearts-pipeline)与 merge_requests(目标分支 master)。流水线定义文件位于 .codearts/workflow/codearts-pipeline.yml。
仓库里的美术资源目录——game/images 按 bg / char / officer / prop / ending 分类归位,文件名与剧情里的 scene / show 引用一一对应:

图 3-1 CodeHub 上的 game/images 目录树(文件名规范化的直观体现)
分支与提交记录——左侧是 feature/art 分支的目录树,右侧是 master 的提交历史与作者归属:

图 3-2 分支目录树与提交记录(左:feature/art;右:master 提交历史)
3.2 主菜单、择路与界面系统(Day4 改版成果)
主菜单按参考图重做,采用团队封面 + 左侧毛笔菜单 + 右下角图标按钮,其余界面统一到同一套视觉语言。
参考图:

改版后的主菜单:

统一后的设置界面:

本地实测的主菜单(引擎驱动采集):封面采用团队绘制的《疙瘩瘟》水墨封面,左侧毛笔菜单五项入口,右下角「设 / 关 / 退」三枚图标按钮,右上角实时显示「版本 1.0」与「结局 0 / 18」:

图 3-3 主菜单(本地实测,feature/doctor-line @ e283a4d,1920×1080)
择路界面——三条线并列,右上角实时显示各线通关状态:

图 3-4 「择路」界面:郎中线 / 百姓线 / 武官线,右上角为三线通关状态
设置界面(引擎驱动采集,可见文字速度、音量、窗口模式等可调项):

图 3-5 设置界面:Esc 呼出的菜单层,默认停在「设置」页
存档与读档——六个槽位、页码切换、元数据与存档名同屏:

图 3-6 存档界面:六槽位 + 三页翻页

图 3-7 读档界面:与存档共用同一套槽位组件
3.3 剧情线与美术对接成果
郎中线剧情与美术对接——把剧情中的 scene / show 与美术实际文件名对齐,补上 unlock_ending() 与 doctor_trust 等分支判断:

武官线道具与结局美术:

郎中线背景与人物美术:



序场——整段序场是黑屏定场白,最后一句落在题字上:

图 3-8 序场:「百姓叫它——『疙瘩瘟』。」
郎中线实景——瘟疫背景、郎中立绘与旁白同时在场,这一帧是「美术文件名 = 剧情引用名」这条规范落地后的直接结果:

图 3-9 郎中线:背景 bg_doctor_epidemic + 立绘 char_doctor_side + 旁白
分支选项菜单——状态变量决定走向的叙事结构,在菜单上直接可见:

图 3-10 郎中线分支选项

图 3-11 武官线分支选项(美术资源仍在 feature/art 分支,尚未归位到 master)
三条线带完整美术的实跑画面——下面是团队在 Day6—Day7 实跑时留下的画面,也是答辩 PPT P22—P24 使用的同一批图:
郎中线 · 药铺问诊与药囊入栏:

图 3-12 郎中线 · 药铺问诊:诊台与药柜前的问诊场景

图 3-13 郎中线 · 药囊入栏:关键道具进入物品栏
武官线 · 城门口令:

图 3-14 武官线 · 城门口令:关键道具触发城门分支

图 3-15 武官线立绘(守城武官 · 沈砚)
百姓线 · 病榻探视、街头获物与灾荒场景:

图 3-16 百姓线 · 病榻探视:入夜茅屋,兄妹与母亲的立绘同屏

图 3-17 百姓线 · 街头获物:巷口获得【线索簿】,可随时回看

图 3-18 百姓线 · 灾荒场景:荒原与倒塌房屋,进入灾后段落
需要对照着看的一件事:上面这批百姓线画面里,美术是完整的;而 9.2 节的图 9-1 里,同一条线的背景在 master 上是缺的。差别不在画得怎么样,而在有没有归位。 这正是 5.2 节「Git 归位失真」和 10.3 节「把资源规范变成机器检查」两处要解决的问题。
其余各线的运行证据(郎中线 / 百姓线 / 武官线全过程测试截图、界面改版证据、流水线执行记录、成员提交记录)保存在每日随笔的附件包中,随 Day1—Day7 博客一并发布。
3.4 三线结局图鉴
结局系统采用「注册表 ENDINGS + 到达即解锁 unlock_ending() + 图鉴按角色分组显示(郎中 / 百姓 / 武官各 6 个结局,带 x/6 进度)」的结构。玩家走完一条线并拿到结局后,回主菜单进「结局图鉴」就能看到该结局的标题、CG 与解锁进度。
这条链路是本次 Alpha 最重要的一条可交付成果——它把「玩到结局」和「看见结局」打通了,而不是只跑出一个 bool 标记。
注册表 ENDINGS 的代码结构(game/definitions.rpy)——十八条结局按角色编号,是整套解锁判定的唯一事实来源:

图 3-19 ENDINGS 注册表定义:每条记录含结局 id、角色与结局名
走到结局的那一刻——郎中线「著书存道」:

图 3-20 郎中线结局画面与「—— 本线终 ——」
未通关时的图鉴——十八个结局全部锁住,只有占位符:

图 3-21 结局图鉴(0 / 18):郎中 / 百姓 / 武官三列,各 6 条
打通郎中线后的图鉴——同一条链路,第一次真的把「玩到结局」和「看见结局」接上:

图 3-22 结局图鉴(1 / 18):「郎中 · 著书存道」已解锁并显示标题
3.5 数据读写层与存档(交付在 feature/user-db 分支)
这一层与前面几节不同:它的代码不在 master 上。 交付目录是 feature/user-db 分支下的 database/:
| 文件 | 大小 | 内容 |
|---|---|---|
database/gedawen.db | 77824 B | SQLite 样例库(含 18 条正式结局目录) |
database/schema.sql | 3588 B | 六张业务表的建表语句与四个索引 |
database/seed.sql | 2571 B | 结局目录种子数据 |
database/test_database.py | 12776 B | 19 条数据层自动化测试 |
database/test_results.txt | 2188 B | 测试运行结果与库文件 SHA256 |
database/README.md | 10320 B | 设计说明与《数据库设计说明书》索引 |
六张业务表:
| 表名 | 职责 |
|---|---|
player_profile | 本地玩家档案(无账号密码),PK profile_id |
game_save | 存档槽位与元数据 |
game_ending | 结局目录(正式 18 条,各角色 6 条) |
ending_unlock | 结局解锁记录,带唯一约束防重复解锁 |
play_session | 一次游玩会话:选择的结局、角色、起止时间 |
choice_history | 选择历史明细 |
测试结果(test_results.txt 原文摘要):
Ran 19 tests in 0.367s
OK
PRODUCTION table counts: {'choice_history': 0, 'ending_unlock': 0, 'game_ending': 18, 'game_save': 0, 'play_session': 0, 'player_profile': 0}
PRODUCTION foreign_key_check: []
PRODUCTION integrity_check: [('ok',)]
PRODUCTION SHA256 unchanged: 303027fa3ee6e348cc14d03a60acfca3c8497dbb93f9d5490db9c844e08d88cc
19 条用例覆盖了表数量精确性、主键约束、两个档案的存档隔离、重复解锁拒绝、外键约束与级联删除等核心路径,全部通过。
为什么必须单独写这一节? 因为这批产出是通过 CodeHub 网页上传的(该分支 README.md 原文:「仓库写入仅通过网页进行,没有使用本地 Git」),在 git log 里完全看不到它的演进过程。如果只按 Git 统计口径汇报,这一块会被当成「没做」。同时它也解释了答辩 PPT P08 为什么把「数据与存档层跑通」当成独立成果展示——从功能角度它确实是成立的;但它尚未合入 master,合入动作已经列进 10.5 的 Beta 计划。
四、七天冲刺进度与燃尽分析
4.1 最终燃尽图

(上图为 Day4 的燃尽图,完整七日曲线见 Day7 随笔附件「燃尽图.png」)
4.2 七天燃尽数据
本次 Alpha 冲刺的燃尽统计口径为 功能点,初始 40 点。Day1 的图曾使用 100 分制(实际 92),从 Day2 起统一为 40 分制,本文采用 40 分制序列。
| 日期 | 计划剩余任务点 | 实际剩余任务点 | 偏差 |
|---|---|---|---|
| 冲刺开始前(Day0) | 40 | 40 | 0 |
| Day1(10-23) | 35 | 38 | +3 |
| Day2(10-24) | 30 | 34 | +4 |
| Day3(10-25) | 25 | 27 | +2 |
| Day4(10-26) | 20 | 21 | +1 |
| Day5(10-27) | 15 | 15 | 0 |
| Day6(10-28) | 10 | 10 | 0 |
| Day7(10-29) | 5 | 0 | −5 |
Alpha 冲刺最终统计:
- 初始计划任务点:40 点;
- 最终实际剩余任务点:0 点;
- 累计完成任务点:40 点;
- 按纳入燃尽统计的任务点计算,完成率 100%;
- Day7 实际剩余比计划少 5 点(计划线保留 5 点作为缓冲,实际提前清零)。
4.3 燃尽情况分析
第一阶段:Day1—Day3(持续滞后,偏差 +3 → +4 → +2)
前三天围绕项目初始化、数据读写层骨架、三线并行开发与美术命名对齐展开。多个模块需要同时建立统一的数据接口,成员不仅要写代码,还要反复沟通接口字段、状态快照与动画时序;Day2 又暴露出「各支线代码规范不统一导致联调冲突」的问题。因此前三天的实际剩余工作量始终高于计划值,Day2 偏差最大(+4)。
第二阶段:Day4—Day6(追平)
Day4 团队开始集中处理「互相接不上」的问题——美术文件名与剧情引用对齐、界面菜单层机制定位、结局注册与解锁打通。当天偏差收窄到 +1。Day5 实际剩余 15,与计划持平,进度正式追平。Day6 实际剩余 10,与计划持平,当天的重心已转向可验证的内测与流水线。
第三阶段:Day7(清零)
最后一天三条剧情线同时完成全过程运行测试、流水线与自动化测试收尾、13 个界面统一改版、美术资源补充,实际剩余降至 0,比计划提前 5 点清空。
4.4 提交节奏与燃尽的交叉验证
冲刺窗口内的每日提交数如下,可以和燃尽曲线互相印证:
| 日期 | 10-23 | 10-24 | 10-25 | 10-26 | 10-27 | 10-28 | 10-29 |
|---|---|---|---|---|---|---|---|
| 当日提交数 | 14 | 14 | 17 | 20 | 39 | 73 | 21 |
10-28 单日 73 次提交、对应 Day6 的流水线 26 轮构建迭代和界面 8 个 bug 修复——燃尽图上「持平」的 Day6,代码层面其实是冲刺中提交最密的一天。这提醒我们一件事:燃尽图上的一条平线,掩盖掉的可能是相当密集的攻坚。
需要说明的是:任务点完成率 100% 表示本次纳入统计的工作量已经燃尽,并不意味着项目不存在可以改进的问题。第七节与第九节列出的测试缺陷、结局 id 体系分叉、CI 门禁未全绿等问题,都是在「燃尽为 0」之后才被系统性地暴露出来的。
五、团队分工、工作量与协作情况
5.1 八位成员的职责分工
本次 Alpha 冲刺共有 8 位成员参与开发。团队把工作划分为三条剧情线、界面与系统、美术、测试与工程化、PM 与交付六个方向。
| 学号 | 成员 | 职责 | Alpha 阶段主要工作 | 实测交付物 |
|---|---|---|---|---|
| 102400227 | 谭培 | PM / 组长 / 交付统筹 | 冲刺目标与 7 天计划、上传《Ren'Py 开发与合并规范》、配置 master 分支保护策略(检视 2 / 审核 2)、梳理全队 14 个分支归属、每日燃尽图与随笔、PR 评审与合并、冲刺材料归档 | 7 篇随笔 + 7 张燃尽图 + 3 份流程规范 |
| 102400212 | 陈宇杰 | 数据读写层 / 测试 / 工程化 | 数据读写层分层方案与接口签名、代码规范整理、Ren'Py 自动化测试套件、CodeArts 流水线自举(图形环境 / glibc 前缀 / SDK 下载 / 看门狗)、26+ 轮构建迭代、CI 证据归档 | 61 条用例 + 9 个 CI 脚本(2934 行)+ 流水线 + 6 张数据表 |
| 102400213 | 范自亮 | 郎中线剧情 | 郎中线剧情撰写与润色、.rpy 兼容修改、补 unlock_ending() 与 doctor_trust 分支、与美术逐个对齐 scene/show、郎中线全过程测试 | 588 行 / 27 标签 / 16 菜单 / 7 结局 |
| 102400214 | 赫庆国 | 百姓线剧情 / 美术统筹 | 百姓线剧情润色与分支扩充、统筹本线所需背景 / CG / 立绘并整理成清单交付美术组、代码编写与交付测试组、联调修改 | 766 行 / 25 标签 / 12 菜单 / 6 结局 |
| 102400223 | 卢宗园 | 武官线剧情 | 武官线剧情与分支逻辑、属性 / 道具 / 选择三者联动分析、剧情道具与任务属性、人物立绘与结局 CG 资源整理、武官线全过程测试 | 1125 行 / 14 标签 / 8 菜单 / 6 结局 |
| 102400235 | 朱熙 | 界面与系统 | 主菜单 / 选线 / 存档读档 / 设置 / 图鉴 / 关于 / 结局卡 / 字幕 / 对话 / 快捷菜单等界面、18 个结局注册表与三档通关判定、菜单层从 ui.interact 重构为 call screen 循环、修复 8 个交互问题、引擎 14 条英文提示中文化、59 张美术图全量接入与显式定义 | 18 个 screen + 18 条结局注册 + 9 张美术图(6 张界面底图 + 背景 / 结局 / 道具各 1) |
| 102400228 | 吴昊 | 场景与人物美术 | 郎中线与百姓线背景(药房 / 渡口 / 灵堂等)、人物立绘、群像素材、透明通道处理与背景融合 | 24 张美术图(bg 11 + char 13,按最早入库计) |
| 102400231 | 袁志华 | 道具 / 结局图 / UI 美术 | 道具图(口粮 / 腰牌 / 求救信 / 伤药等)、三线结局插图、结局图鉴界面设计、图标与封面归位、武官线专属美术 | 28 张美术图(officer 10 + prop 9 + ending 6 + gui 2 + bg 1,按最早入库计) |
从整体分工来看,各成员拥有明确的主要责任,同时也需要在模块接口和最终验收阶段相互配合。
例如,郎中线的剧情由范自亮负责,但结局能否进图鉴取决于朱熙维护的 ENDINGS 注册表和 unlock_ending() 是否被正确调用;郎中线的美术由吴昊和袁志华制作,但文件名必须和范自亮写进 .rpy 的 scene / show 引用完全一致;陈宇杰写的测试套件则直接消费这三条线产出的剧情与资源。 因此团队的开发工作不是八个独立部分,而是通过「结局 id 约定 + 文件命名约定 + 分支保护策略」三条约定连接起来的整体。
5.2 Alpha 阶段工作量比例
| 主线 | 负责人 | 人天 | 占比 |
|---|---|---|---|
| 郎中线 | 范自亮 | 7 | 12.5% |
| 百姓线 | 赫庆国 | 7 | 12.5% |
| 武官线 | 卢宗园 | 7 | 12.5% |
| 界面与系统 | 朱熙 | 7 | 12.5% |
| 数据读写层 / 测试 / 工程化 | 陈宇杰 | 7 | 12.5% |
| 场景与人物美术 | 吴昊 | 7 | 12.5% |
| 道具 / 结局图 / UI 美术 | 袁志华 | 7 | 12.5% |
| PM 与交付 | 谭培 | 7 | 12.5% |
| 合计 | 56 | 100% |
5.3 团队协作方式
本次 Alpha 冲刺采用基于 Issue/分支与 CodeArts 的开发协作流程:
领取任务 → 创建开发分支 → 编写代码 → 本地自测 → Commit → 提交 MR → Code Review → 合并 master → 集成回归
协作中形成的六条具体规则:
(1)统一任务目标
通过每日站会和分支归属表明确各成员的工作内容,减少重复开发和职责不清。
(2)统一公共接口
Day1 就固定数据读写层的接口方法签名,并让三条线共用同一套结局 id 与资源命名约定(「文件名 = 剧情里引用的名字」)。这条规则的价值在 Day2 得到了反面验证:没有统一规范时,联调冲突直接让进度落后 4 点。
(3)统一分支与权限
master 分支保护策略设为 检视 2 人 / 审核 2 人,测试成员作为检视人参与。谭培在 Day4 的随笔里记了一个很有价值的坑:「检视人不是仓库角色,分支策略填的是目标分支不是来源分支」——成员问「要不要新建分支」时,得先把概念讲清楚再动手。
(4)加强代码评审
涉及结局注册表、公共状态和菜单层的修改,由相关模块负责人共同审核。Day4 的界面改动、Day6 的结局注册表接入,都是先在支线上跑通再推远端。
(5)开发与测试并行
测试不是最后一天才开始:从 Day2 起就有成员跑测试,Day5 成型套件,Day6 接流水线,Day7 做全流程回归。测试组从早期就参与接口检查和代码规范整理,这是 Day2—Day3 能快速收敛的技术前提之一。
(6)及时处理风险
对阻断「三线走通」的 P0 问题优先处理;Day4 起对非核心美术按「必需 / 可延后」分层交付,避免美术排期拖住主线。
5.4 协作中最重要的经验
本次冲刺使我们认识到,多人协作的难点不仅是分配任务,更在于保证不同模块之间能正确连接。
《疙瘩瘟》的三线共享同一套结局注册表和图鉴,如果某个结局 label 忘了调 unlock_ending(),那么玩法完全正确、结局画面也做出来了,玩家在图鉴里就是看不到它。这类问题不会被「这段代码跑通了」发现,只能被专门的一致性检查发现。第六节会讲我们怎么发现它的。
因此团队在整个冲刺过程中逐步形成了「公共接口优先、独立开发与集成验证并行、重要修改必须 Review、交付不是『我做完了』而是『别人能用上』」的协作方式。
六、各成员的收获与心得体会
6.1 谭培:PM / 组长
作为组长,本次冲刺最大的收获是对项目协调与概念澄清有了更具体的认识。
开发初期要定目标、排任务、统一接口、定规范;中期要盯进度、管依赖、评 PR;收尾阶段风险已经不是「某个功能没写完」,而是「代码版本、图片资源、测试截图、提交记录和博客内容之间是否一致」。
最实在的一条心得来自 Day4:「组长最重要的不是替大家干活,而是把路铺平——让每个人知道代码写在哪、跑哪个软件、合进哪条分支。」 他在配置分支保护策略时踩的坑(检视人不是仓库角色、分支策略填的是目标分支)也让他意识到,省掉一次概念澄清,就能少一次团队返工。
另外他在 Day5 审验项目时写下的那句话,是本组对 AI 协作最清醒的一次表态:「尽管代码由组员和 AI 进行协同开发,但还是要对项目进行审验。」
6.2 陈宇杰:数据读写层 / 测试 / 工程化
本次冲刺让陈宇杰对「自动化测试的价值不在通过率,而在可复现」**有了切身体会。
Day2 他就发现:各线规范不一致,返工比先写规范更费时间;Day3 他在重新整理代码规范时同样吃力;Day5 他做出判断——测试代码冗余繁杂时,改用测试套件的方式组织。
数据读写层是他这一轮的另一条主线。Day2 站会上他把这件事说得很清楚:「数据读写层接口对齐——数据库文件位置、首次自动建表、接口方法签名同步骨架进度,三线负责人当场核对调用方式,把『接口名对不上』的问题放在今天解决,不留到联调。」 这条决定后来被写进 PPT 的「接口先行」打法——它省下的不是写代码的时间,是联调时互相等待的时间。这一层的最终形态(六张业务表、19 条全部通过的数据层测试、《数据库设计说明书》)交付在 feature/user-db 分支,详见 3.5。
Day6—Day7 是他投入最集中的两天:在 CodeArts 上累计跑了 26 轮构建,逐层拆解「测试组件是否拉起 / 测试套件是否执行 / 视觉检查是否通过」三个阶段,才最终定位到 GLX visual 的真根因是 conda 前缀里 libxcb 的软链被老版本抢占。
他的心得是:「自动化测试不能只看流水线是否启动,还要区分组件拉起、测试套件执行和视觉检查三个阶段,分阶段定位问题比反复重跑更有效。」 这句话在第七节还会再出现一次——因为它同样适用于判断「一次失败到底是谁的锅」。
6.3 范自亮:郎中线剧情
范自亮负责的郎中线是三条线里分支最密的一条:588 行、27 个 label、16 个菜单、7 个结局。
他最有价值的一个心得是:「剧情不是一条线,是一张网。加了 if doctor_trust >= 2: 之后,同一段文字能通向不同结局。」 这句话道出了分支叙事游戏和线性叙事游戏的根本差别——不是把剧情切段,而是让状态变量参与决定。
Day4 他说「一个 scene / show 写错就白屏,比文字错字难查」,这是美术与剧情必须逐个对齐文件名的真实原因;Day7 他总结为:「剧情线测试不能只验证『能不能启动』,还要按完整选择路径走到结局,才能发现分支跳转、状态判定和结局返回方面的问题。」
6.4 赫庆国:百姓线剧情 / 美术统筹
赫庆国在本次冲刺里承担了两份工作:百姓线的剧情与代码,以及本线的美术资源统筹(背景、CG、人物立绘整理成清单交付美术组)。
他的困难很具体:统筹美术资源时没有考虑好预算和时间,导致部分资源排期偏紧;代码编写过程中也出现了一些问题。 他在 Day4 的随笔里同时承担了「提问题」和「提方法」两件事——反馈问题之后,会议决定后续按「必需 / 可延后」分层交付。
他的心得是:「遇到问题要及时解决,必要时向 AI 和其他同学求助,一起商量如何解决问题。」 在 Beta 阶段,他还需要把「清单式交付」变成「有预算有工期的交付」,这是他从这一轮里明确带走的改进点。
6.5 卢宗园:武官线剧情
卢宗园的武官线是三条线里代码量最大的(1125 行),也是分支最少的(8 个菜单)。他 Day4 做的「互动玩法分析」很有特点:不是先写菜单,而是先梳理属性 / 道具 / 选择三者的联动,评估选项对体验的影响。
他的心得是:「玩家能忍受『选错了』,但不能忍受『选了没反应』。设计不是把剧情铺满,而是让玩家看见自己留下的痕迹。」
他在 Day7 提到另一个具体问题:武官线的图片尺寸、比例和透明通道存在差异,运行时可能出现人物比例不一致、背景裁切异常或结局 CG 显示不完整——「美术资源整理不是简单地把图片放入目录」。这一点在 Beta 阶段有直接价值。
6.6 朱熙:界面与系统
朱熙本次承担了 13 个界面的统一改版、18 个结局注册表、三档通关判定和菜单层重构,是「界面好不好看」之外问题最多的一块。
他最大的收获是关于验证方式的:「用合成鼠标点击去测界面,坐标差几十像素就会误判『按钮坏了』。界面好不好看是次要的,点得动、跳得通才是底线。」 Day4 的「进入二级界面后所有按钮都失效」,他最终定位到根因在 ui.interact() 的菜单机制,而不在按钮本身——解法是把菜单层从 ui.interact 重构为 call screen 循环,一次性修掉了二级界面按钮失效、Esc 无效、读档按钮无法点击等 8 个交互问题。
他也因此理解了一件事:界面问题不一定出在按钮本身,也可能出在菜单层的交互机制。 Day7 他把这套认知和自动化测试结合了起来——把测试通过率从 56% 提升到 85%。
6.7 吴昊:场景与人物美术
吴昊主要负责背景与人物立绘,包括郎中线的药房 / 渡口 / 灵堂三张背景和三组立绘、百姓线的背景与群像素材,以及人物立绘的透明通道处理。
他对美术的理解在这一轮里明显深了一层:「背景要『空』才有位置给文字,人物又要画『脏』才符合瘟疫年代。」——背景刻意为文字留白,人物刻意保留补丁与灰尘,「瘟疫年代的人不该是干净的」。
技术层面他最大的收获是:「透明通道不是单纯的图片格式转换,必须结合游戏实际叠加效果检查边缘、黑底和人物遮挡问题。」 他在 Day6 补了一句很实在的话:「人物素材在图片查看器中看起来正常,不代表在 Ren'Py 中叠加到不同背景后没有白边、黑底或边缘不协调问题。」 美术资源的最终质量,必须以游戏内实际显示效果为准。
6.8 袁志华:道具 / 结局图 / UI 美术
袁志华负责道具图、三线结局插图、结局图鉴界面设计和图标封面归位,Day4 一天内完成了武官线 6 张结局插图与 4 张道具图(口粮、腰牌、求救信、伤药)。
他对「结局」的理解在画图的过程中发生了变化:「画结局图时才意识到,『结局』不是文字标签,而是玩家一路选择后唯一能带走的东西。美术不是配图,是把选择的结果提前摆到玩家面前。」
他也意识到结局图鉴的设计不能只考虑视觉:「对结局图鉴的开发不仅要符合代码开发的风格,更要符合故事本身的色彩」;以及「道具在其中的作用明确之后,才能设计出好的道具」。
七、测试工作与项目质量总结
7.1 测试工作安排
测试工作贯穿了本次 Alpha 冲刺的多个阶段:
| 阶段 | 测试工作重点 | 产出 |
|---|---|---|
| Day2—Day3 | 各支线代码规范的整理与初跑测试、结局 id 与标签核对 | 代码规范、接口调用方式核对 |
| Day4 | 界面 13 个改版后的交互回归、二级界面与菜单返回路径检查 | 8 个交互问题的根因定位与修复 |
| Day5 | 测试套件成型,覆盖启动自检 / 三条线 / 结局注册表一致性 | 6 个测试文件、61 条用例 |
| Day6 | 接入 CodeArts 流水线,区分组件拉起 / 套件执行 / 视觉检查三阶段 | 9 个 CI 脚本、26+ 轮构建迭代 |
| Day7 | 三条线全过程运行测试、自动化测试收尾、通过率 56% → 85% | 各线运行证据、流水线记录归档 |
测试内容覆盖:引擎就绪与变量初值、重复 default 检查、美术资源是否真实在磁盘上、三条线的入口接线与完整通关路径、状态重置、结局注册表与剧情解锁的一致性、图鉴界面渲染、菜单与存档读档流程、lint 与资源路径扫描。
7.2 测试工具的选择与运用
| 工具 | 用途 | 选择原因 |
|---|---|---|
| Ren'Py 8.5.3 内置测试框架 | 模拟玩家点击、走菜单、断言 store 与 persistent | 引擎原生,能开真游戏跑真实交互,不用外挂浏览器驱动 |
Ren'Py lint + --error-code | 语法、未定义变量、重复 config、缺失 image 声明 | 最便宜的一道门。但 lint 默认恒返回 0,必须显式加 --error-code,否则是假绿 |
Bash(run_tests.sh) | 建软链、扫孤儿 .rpyc、FIFO 实时日志、看门狗、解析汇总 | 把执行流程统一起来,退出码直接就是红绿 |
| CodeArts 流水线 + CodeArtsBuild 插件 | 每次 push / MR 自动跑套件并判红绿 | CodeArts 的步骤只能调插件,跑任意命令的正规路子只有编译构建任务 |
| Xvfb + Mesa llvmpipe | 给无 X server 的 Linux 构建机提供虚拟显示与 GL 上下文 | Ren'Py 是 SDL 图形程序,没有真 X server 起不来 |
自带 glibc 前缀(ld-linux --library-path) | 启动 Ren'Py ≥ 8.5 引擎 | 引擎要 GLIBC_2.30 而构建机是 2.28;必须用新 loader 显式启动 |
| conda-forge 固定包清单 + 前缀占位符替换器 | 固定图形环境依赖 | 版本漂移是「昨天绿今天红」的常见来源 |
Git(worktree / FETCH_HEAD) | 取测试组件、做隔离对照实验 | 组件只有一份,且能让多个分支同时跑 |
7.3 这套测试真正测出了什么
「Lint 全绿 ≠ 游戏能玩」 是本组测试工作最核心的一条结论。
在 feature/doctor-line 分支上实测(macOS,Ren'Py 8.5.3):
| 跑法 | 用例 | 通过 | xfailed | 失败 | 耗时 |
|---|---|---|---|---|---|
| 整套连跑 | 61 | 38 | 9 | 14 | 123.2 s |
| 整套连跑(移除百姓线 suite) | 52 | 37 | 9 | 6 | 21.2 s |
| 单跑 doctor_line | 6 | 5 | 0 | 1 | — |
| 单跑 citizen_line | 9 | 6 | 0 | 3 | — |
| 单跑 boot | 33 | 30 | 0 | 3 | — |
| 单跑 endings_registry | 4 | 2 | 0 | 2 | — |
几点值得记录:
- 9 条 xfailed 一条误报都没有——在没有武官线的支线上,武官线用例被正确标成「不适用」而不是「失败」。这说明为每条线加
xfail守卫、并且用「这条线在本分支有没有自己的实现」而不是has_label当判据,是对的。 - 整套连跑 14 红,拆开单跑只剩 6 红。8 条红是套件自身的跨 suite 状态污染造成的:百姓线 suite 把游戏状态留在了半路,导致后面的入口步骤到不了。它们不是产品缺陷,不能记进缺陷台账。
- 6 条真失败中,有一条 lint 完全没报:
prop_boiled_cloth.jpg文件确实在磁盘上,但内容是 PNG、扩展名却是.jpg,renpy.loadable()判定不可加载。lint 的检查项和运行时的判据不是同一套。 - 结局 id 体系分叉被测了出来:通用结局模块用
langzhong_*/baixing_*/wuguan_*,而剧情实际解锁的是e_book/e_hold/e_iron这一套;郎中线在 init 阶段用store.ENDINGS.update({...})把自己那批 id 补进了注册表,百姓线和武官线没有这一步,导致它们的结局连unlocked_endings都进不去,图鉴按注册表逐条渲染,画不出来。
7.4 CI 门禁建设
本轮最花力气的一块工程化工作是 CodeArts 流水线接入。踩过的坑按性质分三类:
(1)平台配置的坑
- CodeArts 的步骤只能调插件,YAML 里没有
run:/script:,跑任意命令的正规路子只有编译构建任务; - 服务端 YAML 校验**只认顶层
jobs:**,写成stages:会被直接拒(DEVPIPE.00015005),而控制台界面上只显示一句「yaml 存在错误」,不告诉哪一行错了; - MR 事件只认目标分支上的 YAML,目标分支没有这份文件,MR 一次都不触发。
最后这条是本轮最难缠的一个坑,PM 用一组对照实验把它钉死了——下面这张 MR 详情页把实验设计、结果和修复描述都写在了同一个画面里:

图 7-1 MR「feat(ci): 流水线定义落到 master —— 修『MR 事件拉不起流水线』」:左侧是 MR #5 / #6 / #7 的对照实验表(源分支带 YAML、目标分支带 YAML、流水线运行数),右侧是检视人与审核人
这组对照实验的方法值得单独说:没有靠猜,而是构造了三个 MR,分别控制「源分支带不带 YAML」「目标分支带不带 YAML」两个变量,用「流水线运行数」作为唯一观测量。结论是两个分支都带 YAML 才跑得起来——之前三次修都只改了一边,所以怎么改都不生效。把 bug 变成一张可以填的表,这是本轮 CI 建设中性价比最高的一次投入。
(2)环境的坑
- Ren'Py ≥ 8.5.0 的引擎要 GLIBC_2.30,构建机是 2.28 ⇒ 必须自带一份新 libc 并用新 loader 显式启动(把新 libc 塞进
LD_LIBRARY_PATH会版本错配直接崩); - SDK 太老时引擎解析测试文件会报「expected statement」,那个报错长得像「测试文件写错了」,其实是 SDK 太老;
- conda 前缀里
libxcb的软链被老版本抢占,这是 GLX visual 的真根因。
(3)判据的坑——最危险的一类
- 引擎中途崩掉时,Ren'Py 的报告器会把没跑到的用例记成「not run」却依然报 PASSED、退出码 0 ⇒ 假绿。我们的
run_tests.sh因此自己解析汇总,把not run也算成失败。 - 图形环境装不上时如果退回 SDL dummy 驱动,Ren'Py 会退到纯 Python 的 sw 渲染器,实测卡死 238 秒、0 passed,还会报假的 PASSED。假绿比假红危险得多,所以脚本选择快速失败,绝不退回哑驱动。
- lint 默认恒返回 0,必须显式加
--error-code。
7.5 质量总结
能够确认的:三条线的测试套件都能接进 CI,分支适配守卫可靠无误报;郎中线引用的 21 个美术资源里 20 个可用;结局注册表一致性检查有效,已经把「注了册却永远解锁不了」的结局钉住了。
还不能确认的:本轮结果不能代表项目通过了全面的性能、兼容性或长期稳定性验收;8 条伪红对应的产品行为到底有没有问题尚未判定;百姓线整条线在当前分支还缺 22 处美术,这条线能不能真正玩通没有验证过。
八、AI 技术员的工作回顾与贡献分析
8.1 AI 技术员在七天里的角色演变
本组把 AI 技术员当作团队的一个成员来用,七天里它的角色有清晰的演变:
| 日次 | AI 承担的角色 | 主要工作 | 产出 |
|---|---|---|---|
| Day1 | 规划员 | 协助 7 天任务拆解与认领、数据读写分层架构与接口设计、生成冲刺计划草案 | 任务拆解与分工草案、分层方案草案、提交规范与美术归位规范草案 |
| Day2 | 编码员 / 测试员 | 相关支线 Ren'Py 代码开发与测试 | 初版实现与测试,问题需团队审核修改 |
| Day3 | 编码员 / 测试员 | 持续代码开发与测试 | 「在代码和测试方面实现进一步的自动化」 |
| Day4 | 协助者 | 成员遇到问题时求助的对象 | 赫庆国在心得中直接写到「必要时向 AI 和其他同学求助」 |
| Day5 | 编码员 / 测试员 | 测试套件开发 | 套件初版成型 |
| Day6 | 辅助程序员 / 测试员 / 美术资源检查员 | 拆分流水线问题为三阶段、检查 Ren'Py 资源引用、整理美术资源清单 | 确认前两项链路已通、问题集中在 GLX;新旧文件名并存会引发加载问题的提醒 |
| Day7 | 分析与整理助手 | 协助整理三线回归测试清单、分析界面交互问题、检查流水线与资源交付证据 | 「启动入口—剧情选择—资源显示—属性/道具变化—结局触发—返回主菜单」的回归清单 |
这条线索里有一个值得单独记的转折:AI 的角色从「写代码的人」逐步退到了「分析、清单与交叉核对」的位置。 原因不是 AI 变弱了,而是团队越往后越清楚哪些环节可以让 AI 干、哪些环节必须人来拍。
8.2 AI 的边界:三个被探针推翻的「根因」
这一段是本轮最重要的收获,也是团队对 AI 协作边界的认识。
AI 很擅长给出一个看起来像根因的解释。本轮它给了三个:
- 序场有 10 段
pause合计 24 秒,而用例超时预算是 15 秒 ⇒ 入口用例必然超时; before testcase里的MainMenu全量重启之后,入口点击就失灵了;- 前一条用例失败会污染后续用例,于是后面那批超时全是连带效应。
团队给每个假说都写了一条探针用例去反测,三个全被推翻:
- 探针一:在入口处打点计时,实际从点「从头开始」到出现选角界面只用了 0.2 秒。序场那 24 秒
pause在测试模式下根本不消耗等待。 - 探针二:完整复刻
before testcase的MainMenu钩子,第二次点击依然 0.1 秒通过。全量重启不是元凶。 - 探针三、探针四:故意让前一条用例分别以「断言失败」和「点击超时」收场,后一条用例依然 0.07 秒通过。失败不会污染后续用例。
最后靠一组对照实验才定位到真凶:把百姓线那一个 suite 拿掉再整套连跑,郎中线的 6 条超时立刻降到 1 条——是百姓线的用例把游戏状态留在了半路。
这件事对应教材 13.4.1 的误区三(测试代码本身的质量决定检测效能)和 13.4.3 的「保持批判」,也正是 2.1.2 那句「可以让 AI 工具来写单元测试,但是程序的作者还是要对单元测试负责」的具体含义。
还有一个更朴素的教训:AI 写的归因脚本自己也出过一次假结论——最初按 traceback 归因,把 61 条全算成失败(因为报告器在执行阶段的标记都是同一个 [exc]),而报告器自己的 Detailed 树里明明有 38 条 PASSED。凡是自己做的判据,都得拿已知答案反测一遍再用。
8.3 下一阶段如何更好地利用 AI
结合本轮经验,Beta 阶段团队计划从四个方向改进 AI 的用法:
(1)让 AI 产出判据,而不是产出结论
本轮最有价值的产出是探针用例和守门脚本,不是「根因解释」。下一阶段把 AI 的调用固定成一种形式:先让它写出能证伪某个假说的最小用例,再看用例结果,而不是让它先给解释。
(2)要求 AI 给出「这条判据怎么被证伪」
凡是 AI 提交的结论,一律要求附带一句「如果我错了,会看到什么不一样」。这是本轮三个假说被推翻的直接原因。
(3)把 AI 放在「交叉核对」而不是「最终判断」的位置
Day6、Day7 的随笔里,AI 的角色已经是「拆阶段、列清单、对照命名」,而运行、提交、合并仍然由成员完成。这个分工在 Beta 阶段继续坚持。
(4)把 AI 用在"人不好做"的地方
本轮 AI 在三个地方表现最好:批量场景整理(61 条用例的结构化展开)、重复操作脚本(2934 行 CI 自举)、材料核对(逐日归因、证据归档)。这三件事人做起来慢且容易漏,人做起来快但容易主观。下一阶段把更多「跨文件、跨天、跨来源」的核对任务交给 AI,把「好不好玩、对不对味」的判断留给人。
九、Alpha 阶段存在的问题与反思
9.1 计划与规范执行层面
问题一:各支线代码规范没有先统一,导致 Day2—Day3 联调冲突,进度落后最多 4 点。
反思:规范先行不是形式主义。 三条线并行开发时,如果接口、命名、结局 id 约定没有在 Day1 固定下来,联调成本会成倍放大。团队在 Day2 之后补上了《Ren'Py 开发与合并规范》,此后进度回到计划线。
问题二:燃尽图的度量口径在 Day1→Day2 之间换过基(100 分制 → 40 分制)。
反思:换基这件事本身不算错,但必须记录。 否则 Day1 的「实际 92」和 Day2 的「实际 34」放在一起会让人无法解读。本文已在第二节标注该事实,后续冲刺应保持口径连续。
问题三:燃尽为 0 的时点,晚于缺陷暴露的时点。
反思:「任务点归零」不等于「项目可交付」。 结局注册表的不一致、武官线结局 id 与注册表的分叉、百姓线 22 处美术缺失,都是在燃尽图归零前后才被系统检查暴露的。Beta 阶段应把「缺陷清零」也纳入冲刺收尾的判定条件。
9.2 技术与质量层面
问题一:结局 id 体系分叉,图鉴与剧情对不齐。
通用结局模块用 langzhong_* / baixing_* / wuguan_*,剧情实际解锁的是 e_*。郎中线自己补了注册表,百姓线与武官线没补,导致它们的结局进不了 unlocked_endings,图鉴画不出来;反过来注册表里那批旧 id 又没有任何剧情能走到,是永远解锁不了的死条目。症状就是图鉴里只有郎中线的结局,而且其中一部分是占位空条目。
问题二:资源规范执行不彻底。
prop_boiled_cloth.jpg 实际内容是 PNG,扩展名与真实格式不符,renpy.loadable() 判定不可加载,而 lint 没有报这一条;百姓线有 22 处 image 路径指向磁盘上不存在的文件。根因都是 Day1 定的「文件名 = 剧情里引用的名字」这条规范没有被机器检查。
这个缺陷在运行时是看得见的——下图是引擎驱动采集的百姓线首帧,画面顶部就是引擎自己报的错:

图 9-1 百姓线运行实况:Couldn't find file 'images/bg/bg_common_home.jpg'——玩家看到的不是瘟疫街巷,而是棋盘格与一行报错
问题三:界面验证方式不可靠。
用合成鼠标点击测界面,坐标差几十像素就会误判「按钮坏了」,也容易把真实的菜单层机制问题当成配置错误。Day4 的 8 个交互问题就是这样被误判了好几轮。
9.3 协作层面
问题一:AI 产出的代码由成员在团队账号下提交,Git 作者字段无法区分 AI 产出与人工修改。
这导致工作量统计无法在 Git 层面自动拆分,只能靠人工判断,也是本篇必须同时给出口径一和口径二的原因。
问题二:跨 suite 的测试状态污染,直到写冲刺总结时才被发现。
整套连跑与单跑结果不一致(14 红 vs 6 红),如果只看「14 条失败」这一个数字,团队会把 8 条伪红当成产品缺陷记进台账。这是本轮最贵的一个教训,也是最有价值的一个。
十、Beta 阶段展望与改进计划
Beta 阶段(11 月)我们准备按以下顺序推进,优先级从高到低:
10.1 先修测试自身的独立性(测试侧第一优先级)
- 每个 suite 独立进程,或每个 suite 前强制 full restart 并自检状态;
- 把「进入主线」抽成可复用的前置步骤,并在前置步骤里做一次状态断言;
- 门禁判据从「整套跑通」改成「整套跑通 且 各 suite 单跑结果一致」,把跨 suite 污染变成门禁拦得住的问题。
10.2 统一结局 id 体系,把图鉴补全
- 把三线 18 个结局 id 统一到一套命名(当前
e_*与wuguan_*并存),补齐郎中线e_epidemic_death的注册与解锁; - 图鉴按角色分组显示(郎中 / 百姓 / 武官各 6 个,带 x/6 进度),并加一条一致性用例,钉住「注册表 ↔ 剧情解锁 ↔ 图鉴」三者永远对齐;
- 补齐百姓线 22 处缺失美术,修掉
prop_boiled_cloth的格式问题。
10.3 把资源规范变成机器检查
- 增加一条用例:扫
game/下所有.rpy的 image 声明,逐条检查「文件真实存在 且 扩展名与真实格式一致」——这条能同时抓住「文件不在」和「格式伪装」两类问题,弥补 lint 的盲区; - 增加一条用例:核对美术资源清单与剧情引用清单的差集。
10.4 让流水线真正成为门禁
- 解决 CI #37 的失败原因,把 lint 的 24 条问题清干净(22 条资源缺失 + 2 条
config.name/config.version重复定义); - 流水线 YAML 保持 master 权威副本 +
codearts-pipeline同步副本逐字节一致,并在合并流程里加一条校验; - 在「设置 → 策略设置 → 合并请求 → 分支策略 → 开启流水线门禁」勾选开闸——这一步目前还不能开,因为 master 上 lint 还有红,开闸只会把所有 MR 挡死。
10.5 把数据读写层合入 master
- 现状:
feature/user-db分支的database/目录已有完整实现——六张业务表(player_profile/game_save/game_ending/ending_unlock/play_session/choice_history)、19 条全部通过的自动化测试、gedawen.db样例库与《数据库设计说明书》——但它没有合入 master,仓库主线目前仍看不到数据层。 - 要做的:走一次规范的 MR 评审,把它合入 master,并在合并后补一条「master 上数据层可用」的冒烟用例,让 CI 每次构建都能看见它;
- 要注意的:该分支的提交全部通过 CodeHub 网页完成,没有走本地 Git,在
git log里看不到这批改动的完整演进过程。合入前需要人工比对分支与 master 的差异,不能只依赖git log; - 交付口径:合并之后,第五节「产出口径」里数据读写层那一行才真正进入主线统计。在此之前,任何以 master 为准的汇报都应该显式标注「数据层尚未合入」。
10.6 内容与体验
- 三条线的剧情密度与分支收束(武官线目前 8 个菜单、14 个标签,相对另外两线偏薄);
- 界面交互的自动化验证方式改进:不再用合成鼠标坐标点击,改用控件 id / 文本选择器定位(这是 Day7 已经暴露的方向);
- 根据试玩反馈继续优化剧情、资源和交互体验。
10.7 组织与协作
- 每条线指定一名「接口负责人」,公共接口(结局注册表、菜单层、资源命名)变更必须由该负责人 Review;
- 把 Day1 的规范落成可执行的检查项而不是文档条目;
- 维护一张「已知问题台账」,每条记录复现路径、影响范围和归属人。
十一、答辩准备与 PPT
11.1 答辩 PPT 的落点
本组的答辩 PPT 已经完稿,共 24 页。对外给出可公开访问的在线链接,同时保留本地文件与仓库文档分支两条落点。
在线答辩 PPT(金山文档):
https://www.kdocs.cn/l/cg9ILkOvu5I4
11.2 答辩 PPT 的实际结构
封面:

图 11-1 答辩 PPT 封面:副标题「7 天,从说清楚到跑起来」,右侧是冲刺时间轴
下表按实际页面顺序列出 PPT 内容与它对应的评分点,便于答辩时按页对应:
| 页码 | 页面标题 | 主要内容 | 对应评分点 |
|---|---|---|---|
| P01 | 封面 | 福州大学软件工程实践 W 班 · α 冲刺答辩;副标题「7 天,从说清楚到跑起来」;时间轴 10-23 冲刺启动 → 10-27 正式达标 → 10-28 内测收尾 | — |
| P02 | 项目与团队 | 一页看懂:项目《疙瘩瘟》(明末鼠疫题材 Ren'Py 视觉小说)、三线结构、技术主干、8 人分工一览 | 项目预期计划 / 分工协作 |
| P03 | 冲刺打法 | 冲刺目标 + 三条打法:接口先行 / 规范先行 / 每日对齐 | 项目预期计划 |
| P04 | 燃尽图 | 「落后三天,第五天追平」;D0–D7 计划线与实际线;三个节点(落后区间、转折、清零) | 项目现实进展 |
| P05 | 过程 · D1–D3 | 规划先行、问题提前暴露。D1 代价是「首日几乎不产出功能」;D2 分支规范不一致导致工程起不来;D3 wuguan_* 与 e_* 结局 id 对齐 | 项目现实进展 |
| P06 | 过程 · D4–D6 | 从接得上到达标。D4 保护 master、梳理 14 个分支;D5 界面 / 结局 / 美术接入,燃尽追平;D6 百姓线跑通、CodeArts 第 26 轮构建 | 项目现实进展 |
| P07 | 成果一 | 三条剧情线 × 18 个结局;「到达结局 → 写入注册表与数据库 → 图鉴回看」链路 | 项目运行展示 |
| P08 | 成果二 | 数据与存档层跑通:SQLite 首次自动建表、原生存档增删读、参数化查询 / 事务 / 异常处理、结局首次解锁写入 | 项目运行展示 |
| P09 | 成果三 | 13 个界面统一改版、8 个二级界面交互问题修复、菜单层改为 call screen 循环、14 条英文提示中文化、59 张美术图全量接入 | 项目运行展示 |
| P10 | 问题复盘(上) | 规范与命名三问题:分支规范不一致、结局 id 命名冲突、美术文件名与引用脱节 | 问题与反思 |
| P11 | 问题复盘(下) | 根因与遗留四问题:二级界面按钮全失效、立绘不透明、GLX visual 阻塞 CI、资源预算与排期低估 | 问题与反思 |
| P12 | 我们的解决方式 | 三条方法:定位根因先问问题在哪一层 / 分阶段验证用真实运行说话 / 把一次修复写成一条规范 | 方法论 |
| P13 | 关键数字看板 | 7 天 · 8 人 · 3 线 · 18 结局 · 13 界面 · 59 张美术图 · 85% 通过率 · 14 个分支 | 数字佐证 |
| P14 | 复盘与 β 冲刺改进 | 做对了什么 / 要改什么 / β 冲刺三项(资源命名校验脚本、CI 环境前置验证、按「可验证」拆任务) | 下阶段展望 |
| P15–P21 | 过程展示 · Day1–Day7 | 每日运行截图与说明:Day1 界面雏形跑通 → Day2 分工落到代码与资源 → Day3 三线并行问题暴露 → Day4 界面改版与资源接入 → Day5 剧情代码补齐 → Day6 百姓线跑通 → Day7 全流程回归与收尾 | 项目现实进展 |
| P22–P24 | 剧情线展示 | 郎中线(药铺问诊 / 剖验诊台 / 药囊入栏)、武官线(军营对话 / 城门令牌)、百姓线(病榻探视 / 街头获物 / 灾荒场景) | 项目运行展示 |
PPT 与本文的三处数字差异(答辩时以本文与随笔原文为准):
- Day3 燃尽偏差:PPT P04 写「D1–D4 差距 +3 / +4 / +4 / +1」,其中 D3 写作 +4。Day4 随笔原文写的是「相比 Day3 落后 2 项(实际 27 / 计划 25)」,本文采用 +2,偏差序列为 +3 / +4 / +2 / +1。两个数字都有出处,但 Day4 随笔是更接近现场的一手记录,取它。
- 分支数:PPT P06 / P13 的「14 个分支」是 Day4 的快照;仓库远端现为 16 个分支(
git branch -r输出 17 行,其中origin/HEAD是指向 master 的符号引用)。PPT 的「feature/ui +19、feature/art +41」同样是当日快照——按当前仓库实测,origin/feature/ui相对 master 已无未合入提交,而origin/feature/art相对 master 仍有 82 个提交未合入(其中大量是美术的 PNG 原始版本,见 5.2 节的归位失真实证)。 - 数据读写层的状态:PPT P08 把「数据与存档层跑通」作为成果二展示,这与该分支
README.md的自述一致(六张表、19 条测试全通过)。但要诚实地说清:这层交付在feature/user-db分支上,尚未合入 master。PPT 没有把这一点写出来,本文和 Beta 计划(10.5)都补上了。
11.3 演示脚本(8 分钟)
括号内是对应的 PPT 页码:
- 0:00—1:00 主菜单 → 选角界面 → 说明三线结构与技术选型(P01—P03);
- 1:00—2:30 郎中线观察线走到底,展示属性累积与「著书存道」结局,进入结局图鉴看解锁进度(P22 / P07);
- 2:30—3:30 切结局图鉴,说明「注册表 ↔ 解锁 ↔ 图鉴」的一致性设计,并主动说明当前仍存在的结局 id 分叉问题(P07 / P09);
- 3:30—4:30 燃尽曲线与两种工作量口径,讲清楚「为什么交付物口径和投入口径差这么多」(P04 / P13);
- 4:30—5:30 测试与工程化:61 条用例 → 8 条伪红的发现过程 → 「Lint 全绿 ≠ 游戏能玩」(P10—P12);
- 5:30—6:30 问题复盘与解决方式:四个根因逐条讲,重点讲「不是按钮坏了,是菜单层的交互机制」这一条(P11 / P12);
- 6:30—7:30 Beta 展望:先修测试独立性、再统一结局 id、把数据层合进 master、最后开门禁(P14);
- 7:30—8:00 收尾。
一个需要事先说明的缺口:PPT 里没有单独的 AI 技术员页。AI 的贡献在 PPT 中只以 P12 的一句「AI 出草案,运行验证与取舍由人来做」出现。第八节的三笔账与三个被探针推翻的根因,主要靠口头讲述和本文第八节来承载。如果答辩评委对 AI 协作有专门提问,需要临场补充这一段。
11.4 答辩材料清单
| 材料 | 状态 |
|---|---|
| 本篇《Alpha 冲刺总结》随笔 | 已完成 |
| Day1—Day7 七篇每日随笔(含燃尽图、会议照片、成员运行证据) | 已完成 |
| 《Ren'Py 开发与合并规范》 | 已上传至文档分支 feature-add-docs-ppt |
| 自动化测试套件(61 条用例)与 9 个 CI 脚本 | 已合入仓库 |
| 流水线运行记录(26+ 轮构建、CI #33 / #37) | 已归档 |
| 《α 冲刺总结答辩》PPT(24 页) | 已完成,在线链接见 11.1;PDF 尚未上传至文档分支 |
| 数据读写层(6 张表 + 19 条测试 +《数据库设计说明书》) | 已在 feature/user-db 分支交付,尚未合入 master |
| 项目仓库 | https://devcloud.cn-north-4.huaweicloud.com/codehub/project/fc457d3818b548f781412bb95669fb03/codehub/3096337/home?ref=master |
十二、Alpha 冲刺总结
七天的 Alpha 冲刺,摸鱼不队从一个「有剧本、有原型、有界面初稿」的项目,走到了一个三条线都能各自走通、结局能进图鉴、每次提交都能被自动化测试和流水线复现的可运行版本。
回头看,这七天里最值得记录的其实不是「做了什么功能」,而是三个认知:
第一个认知:交付不是「我做完了」,而是「别人能用上」。 Day4 那天我们才真正明白,美术文件名的约定、菜单层的机制、结局 id 的统一,这些看着像细节的东西,每一个都会让玩家卡住。
第二个认知:绿不等于对,红也不等于错。 Lint 全绿不等于游戏能玩;整套测试 14 红,拆开单跑只剩 6 红——8 条红是我们自己的测试写错了,不是产品有问题。测试的结论必须能被别人用同样方式复现,否则它就不是结论。
第三个认知:AI 最好用的地方,是它不会疲倦的那些事。 61 条用例的结构化展开、2934 行 CI 自举脚本、跨天跨文件的材料核对——这些是 AI 的主场;而「这结局画得对不对味」「这个按钮点了玩家会不会懵」这类判断,必须留给人。Day7 随笔里那句「AI 只提供分析、检查清单和整理建议,没有替代成员进行最终运行、提交或合并」,是我们这七天最诚实的一句话。
Beta 阶段,我们有五件明确要做的:把套件的跨 suite 独立性修掉、把三线 18 个结局 id 统一、把资源规范变成机器可检查的用例、把数据读写层合进 master、把流水线门禁真正打开。 这五件事都不炫,但做完之后,这个项目才算真的可以交给下一个人接着往前走。
我构建,故我在。
相关推荐
chrome-headless-shell-win64-157.0.8103.38(Stable).zip
Chrome for Testing 官方指定版本的 Chrome 浏览器、ChromeDriver 与 Headless Shell 压缩包,适用于 Selenium、Playwright 等自动化测试环境搭建,覆盖 Windows、macOS、Linux 多平台,解压即可使用,无需额外安装或配置。
chrome-win32-159.0.8150.0(Canary).zip
内容概要:Chrome for Testing 官方 chrome 159.0.8150.0 win32 平台(金丝雀版通道),原版未修改,附来源说明。 适合人群:Windows 32 位 上的自动化测试工程师、爬虫开发者、CI 环境搭建者。 使用场景及目标:①Chrome for Testing 官方浏览器本体,供自动化测试使用;②与同版本 chromedriver 配套;③CI/容器环境的浏览器运行时。 其他说明:Chrome for Testing 为 Google 官方发布、允许自由分发的文件;本资源为第三方整理的下载便利服务。
化工MES-石化盈科信息技术有限责任公司.pptx
化工MES-石化盈科信息技术有限责任公司.pptx
chromedriver-win32-160.0.8164.0(Canary).zip
chromedriver-win32-160.0.8164.0(Canary).zip
健康管理服务运营方案.pptx
健康管理服务运营方案.pptx


