摸鱼不队 | Alpha 冲刺总结——《疙瘩瘟》

moon-star-art moon-star-art 墨衍会员 · AI 创作全网分发 墨衍智能分发 通过墨衍一键同步至各平台 可同步平台 CSDN微信公众号微博知乎掘金百家号博客园抖音小红书 你的文章也可以这样分发 墨衍会员 ¥399起/年,写一次发全网 我也要 + 加入社区
这个作业属于哪个课程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:三条线能各自完整走通,结局能进图鉴。具体拆成七项:

  1. 选定并敲定技术主干:数据库接入 Ren'Py 的数据读写层(档案切换、存档创建/读取/删除、游玩与选择写入、结局首次解锁、参数化查询、事务与异常处理);
  2. 三条剧情线各自实现入口接线、分支菜单、属性与道具;
  3. 界面与系统层:主菜单、选线、存档读档、设置、结局图鉴、关于、结局卡、字幕、对话、快捷菜单等;
  4. 美术资源归位并接入:背景、立绘、道具、结局图,遵守「文件名 = 剧情里引用的名字」;
  5. 结局注册表与通关判定:ENDINGS 注册、unlock_ending() 解锁、三档通关判定;
  6. 自动化测试与 CI:能自动跑的测试套件 + 能自动判红绿的流水线;
  7. 交付物:版本、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、Demo7 篇每日随笔 + 燃尽图 + 分支规范 + 本篇冲刺总结

整体来看,本次 Alpha 冲刺的实际工作始终围绕「三条线能各自走通、结局能进图鉴」这个 P0 展开,并在 Day4—Day7 补上了界面统一、美术落地与自动化测试三块。计划中「先完成 P0 再按进度扩展」的策略在 Day5 得到了回报——当 P0 提前达标,团队才有余量同时推进界面改版和流水线。

计划与现实最大的两处偏差:

  1. Day2—Day3 连续滞后(34 / 27,计划 30 / 25)。根因不是技术难度,而是各支线没有统一遵守代码规范,联调时爆发冲突。这条经验后来直接写进了 PM 上传的《Ren'Py 开发与合并规范》。
  2. 燃尽图的度量口径在 Day1→Day2 之间换过一次基。Day1 的图是 100 分制(实际 92),Day2 起统一为 40 分制,实际线记为 38。本文统一采用 40 分制序列,并在第四节标注换基事实。

三、Alpha 阶段项目成果展示

3.1 项目仓库与运行方式

项目仓库:

摸鱼不队《疙瘩瘟》CodeHub 仓库

本地运行方式(Ren'Py 桌面工程):

  1. 安装 Ren'Py SDK 8.5.3 或以上版本(测试框架 testsuite / testcase 最早出现在 8.5.0);
  2. 用启动器打开仓库根目录,点击「启动项目」;
  3. 主菜单 →「开始游戏」→ 序场 → 选角界面 → 选择三条线之一。

自动化验证方式:

# 跑全部用例(退出码 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 引用一一对应:

img

图 3-1 CodeHub 上的 game/images 目录树(文件名规范化的直观体现)

分支与提交记录——左侧是 feature/art 分支的目录树,右侧是 master 的提交历史与作者归属:

img

图 3-2 分支目录树与提交记录(左:feature/art;右:master 提交历史)

3.2 主菜单、择路与界面系统(Day4 改版成果)

主菜单按参考图重做,采用团队封面 + 左侧毛笔菜单 + 右下角图标按钮,其余界面统一到同一套视觉语言。

参考图:

改版后的主菜单:

统一后的设置界面:

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

img

图 3-3 主菜单(本地实测,feature/doctor-line @ e283a4d,1920×1080)

择路界面——三条线并列,右上角实时显示各线通关状态:

img

图 3-4 「择路」界面:郎中线 / 百姓线 / 武官线,右上角为三线通关状态

设置界面(引擎驱动采集,可见文字速度、音量、窗口模式等可调项):

img

图 3-5 设置界面:Esc 呼出的菜单层,默认停在「设置」页

存档与读档——六个槽位、页码切换、元数据与存档名同屏:

img

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

img

图 3-7 读档界面:与存档共用同一套槽位组件

3.3 剧情线与美术对接成果

郎中线剧情与美术对接——把剧情中的 scene / show 与美术实际文件名对齐,补上 unlock_ending() 与 doctor_trust 等分支判断:

武官线道具与结局美术:

郎中线背景与人物美术:

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

img

图 3-8 序场:「百姓叫它——『疙瘩瘟』。」

郎中线实景——瘟疫背景、郎中立绘与旁白同时在场,这一帧是「美术文件名 = 剧情引用名」这条规范落地后的直接结果:

img

图 3-9 郎中线:背景 bg_doctor_epidemic + 立绘 char_doctor_side + 旁白

分支选项菜单——状态变量决定走向的叙事结构,在菜单上直接可见:

img

图 3-10 郎中线分支选项

img

图 3-11 武官线分支选项(美术资源仍在 feature/art 分支,尚未归位到 master)

三条线带完整美术的实跑画面——下面是团队在 Day6—Day7 实跑时留下的画面,也是答辩 PPT P22—P24 使用的同一批图:

郎中线 · 药铺问诊与药囊入栏:

img

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

img

图 3-13 郎中线 · 药囊入栏:关键道具进入物品栏

武官线 · 城门口令:

img

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

img

图 3-15 武官线立绘(守城武官 · 沈砚)

百姓线 · 病榻探视、街头获物与灾荒场景:

img

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

img

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

img

图 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)——十八条结局按角色编号,是整套解锁判定的唯一事实来源:

img

图 3-19 ENDINGS 注册表定义:每条记录含结局 id、角色与结局名

走到结局的那一刻——郎中线「著书存道」:

img

图 3-20 郎中线结局画面与「—— 本线终 ——」

未通关时的图鉴——十八个结局全部锁住,只有占位符:

img

图 3-21 结局图鉴(0 / 18):郎中 / 百姓 / 武官三列,各 6 条

打通郎中线后的图鉴——同一条链路,第一次真的把「玩到结局」和「看见结局」接上:

img

图 3-22 结局图鉴(1 / 18):「郎中 · 著书存道」已解锁并显示标题

3.5 数据读写层与存档(交付在 feature/user-db 分支)

这一层与前面几节不同:它的代码不在 master 上。 交付目录是 feature/user-db 分支下的 database/:

文件大小内容
database/gedawen.db77824 BSQLite 样例库(含 18 条正式结局目录)
database/schema.sql3588 B六张业务表的建表语句与四个索引
database/seed.sql2571 B结局目录种子数据
database/test_database.py12776 B19 条数据层自动化测试
database/test_results.txt2188 B测试运行结果与库文件 SHA256
database/README.md10320 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)40400
Day1(10-23)3538+3
Day2(10-24)3034+4
Day3(10-25)2527+2
Day4(10-26)2021+1
Day5(10-27)15150
Day6(10-28)10100
Day7(10-29)50−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-2310-2410-2510-2610-2710-2810-29
当日提交数14141720397321

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 阶段工作量比例

主线负责人人天占比
郎中线范自亮712.5%
百姓线赫庆国712.5%
武官线卢宗园712.5%
界面与系统朱熙712.5%
数据读写层 / 测试 / 工程化陈宇杰712.5%
场景与人物美术吴昊712.5%
道具 / 结局图 / UI 美术袁志华712.5%
PM 与交付谭培712.5%
合计56100%

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失败耗时
整套连跑6138914123.2 s
整套连跑(移除百姓线 suite)52379621.2 s
单跑 doctor_line6501—
单跑 citizen_line9603—
单跑 boot333003—
单跑 endings_registry4202—

几点值得记录:

  1. 9 条 xfailed 一条误报都没有——在没有武官线的支线上,武官线用例被正确标成「不适用」而不是「失败」。这说明为每条线加 xfail 守卫、并且用「这条线在本分支有没有自己的实现」而不是 has_label 当判据,是对的。
  2. 整套连跑 14 红,拆开单跑只剩 6 红。8 条红是套件自身的跨 suite 状态污染造成的:百姓线 suite 把游戏状态留在了半路,导致后面的入口步骤到不了。它们不是产品缺陷,不能记进缺陷台账。
  3. 6 条真失败中,有一条 lint 完全没报:prop_boiled_cloth.jpg 文件确实在磁盘上,但内容是 PNG、扩展名却是 .jpg,renpy.loadable() 判定不可加载。lint 的检查项和运行时的判据不是同一套。
  4. 结局 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 详情页把实验设计、结果和修复描述都写在了同一个画面里:

img

图 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 很擅长给出一个看起来像根因的解释。本轮它给了三个:

  1. 序场有 10 段 pause 合计 24 秒,而用例超时预算是 15 秒 ⇒ 入口用例必然超时;
  2. before testcase 里的 MainMenu 全量重启之后,入口点击就失灵了;
  3. 前一条用例失败会污染后续用例,于是后面那批超时全是连带效应。

团队给每个假说都写了一条探针用例去反测,三个全被推翻:

  • 探针一:在入口处打点计时,实际从点「从头开始」到出现选角界面只用了 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 定的「文件名 = 剧情里引用的名字」这条规范没有被机器检查。

这个缺陷在运行时是看得见的——下图是引擎驱动采集的百姓线首帧,画面顶部就是引擎自己报的错:

img

图 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 的实际结构

封面:

img

图 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 与本文的三处数字差异(答辩时以本文与随笔原文为准):

  1. Day3 燃尽偏差:PPT P04 写「D1–D4 差距 +3 / +4 / +4 / +1」,其中 D3 写作 +4。Day4 随笔原文写的是「相比 Day3 落后 2 项(实际 27 / 计划 25)」,本文采用 +2,偏差序列为 +3 / +4 / +2 / +1。两个数字都有出处,但 Day4 随笔是更接近现场的一手记录,取它。
  2. 分支数: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 节的归位失真实证)。
  3. 数据读写层的状态:PPT P08 把「数据与存档层跑通」作为成果二展示,这与该分支 README.md 的自述一致(六张表、19 条测试全通过)。但要诚实地说清:这层交付在 feature/user-db 分支上,尚未合入 master。PPT 没有把这一点写出来,本文和 Beta 计划(10.5)都补上了。

11.3 演示脚本(8 分钟)

括号内是对应的 PPT 页码:

  1. 0:00—1:00 主菜单 → 选角界面 → 说明三线结构与技术选型(P01—P03);
  2. 1:00—2:30 郎中线观察线走到底,展示属性累积与「著书存道」结局,进入结局图鉴看解锁进度(P22 / P07);
  3. 2:30—3:30 切结局图鉴,说明「注册表 ↔ 解锁 ↔ 图鉴」的一致性设计,并主动说明当前仍存在的结局 id 分叉问题(P07 / P09);
  4. 3:30—4:30 燃尽曲线与两种工作量口径,讲清楚「为什么交付物口径和投入口径差这么多」(P04 / P13);
  5. 4:30—5:30 测试与工程化:61 条用例 → 8 条伪红的发现过程 → 「Lint 全绿 ≠ 游戏能玩」(P10—P12);
  6. 5:30—6:30 问题复盘与解决方式:四个根因逐条讲,重点讲「不是按钮坏了,是菜单层的交互机制」这一条(P11 / P12);
  7. 6:30—7:30 Beta 展望:先修测试独立性、再统一结局 id、把数据层合进 master、最后开门禁(P14);
  8. 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、把流水线门禁真正打开。 这五件事都不炫,但做完之后,这个项目才算真的可以交给下一个人接着往前走。

我构建,故我在。

...全文

相关推荐

评论
收藏 已收藏
分享
返回顶部