408小组ALPHA冲刺计划

2026秋软工实践 408小组——Alpha 冲刺总结

项目 内容
作业所属课程 2026秋软件工程与软件工程实践
这个作业要求在哪里 团队第三次作业Alpha 冲刺
作业的目标 用两周时间把系统从"功能做出来了"推进到"能演示、能讲清、能接手"
团队名称 408小组
团队成员 102401614-林志涛;102401512-任奥辉;102401509-吴瑞鹏;102401625-朱铮睿;102401635-尼玛顿珠;102401510-林富强;102401525-丁鑫河;102401526-林鹏远;102401511-何锦宏;102401519-曾林远见;102401623-杜佳伟;102401632-翁斌;102401633-严科儒
冲刺周期 2026-11-09 — 2026-11-22(共 14 天,11-21 上台演示,11-22 00:00 提交)
代码仓库 fzu-404-team/kaoyan-agent-platform
演示站 https://47.83.150.142

1. 冲刺目标达成情况

本次 Alpha 冲刺的核心目标是把系统从"能跑"推进到"好用":页面看得懂、点得下去,不报错。经过 14 天密集开发,冲刺前梳理的 6 类问题大部分已解决,核心演示动线已可走通。

✅ 已实现的改进项

(1)页面结构与前端优化

  • 首页:从 "功能入口罗列" 变成 "任务驱动"。学情页:术语黑话全部改成看得懂的数字和图例
  • 整体视觉与体验统一:全站从蓝白冷色切换为米白暖色卡片风格,核心逻辑是不让用户自己找功能、猜术语—— 打开就知道今天该做什么、哪里最弱、点哪个按钮去练。

(2)Agent 容错与降级,检索质量与流式输出
这轮让 Agent "挂了不崩、找得更准、说话更稳":

  1. 挂了不崩:检索工具断连、超时或限流时,直接回一句 "暂时不可用",不再整个对话报错;模型返回异常也有兜底,内部代号不会露给用户。
  2. 找得更准:不再让一篇长文档的多个片段占满名额,先按文档去重再挑结果;同时修好了排序算法里高频词权重被算成负数的毛病,相关内容不会再被错误排掉。
  3. 说话更稳:回答先过引用和数字核查,没核查的内容不先吐给用户;通过后再逐句推送,保留打字机效果;另外换了个模型厂商真正认的参数,输出长度限制现在确实卡得住。

(3)Token 计量与日志

  • Token 词表:防止对话历史被悄悄裁光
  • 原来 cl100k 词表只从系统临时目录读,一旦缺失不报错,静默退化为按字节估算 —— 光是意图解析的固定开销就占 7468/8000,对话历史几乎全被裁掉,模型实际看不到上下文。现在按 " 环境变量目录 → 项目 .cache/tiktoken → 临时目录 " 顺序查找,每份词表做 SHA-256 校验防损坏;/health 可直接查看当前计量模式;另附 prepare-tokenizer.py 提前下载好词表,服务进程本身保持不联网。
    日志:把 LOG_LEVEL 的控制权拿回来
  • 第三方框架导入时会强制把日志钉死在 INFO,导致设了 LOG_LEVEL 无效、无时间戳、第三方库日志刷屏。
  • 现在由项目代码接管日志配置:自有模块按设定级别输出,第三方库只放 WARNING 以上,级别填错则直接拒绝启动,避免带着错误配置运行。

(4)业务链路与数据

  • 开练 → 答题 → 判分 → 错题 → 收藏 → 统计全流程走通,此前 11 个不可用接口随接口按域重组(/practice、/marks、/schools 等)恢复;刷题改为优先随机抽取本人未做过的题目。
  • 新增真题分析、择校推荐(接入院校分数统计与独立推荐)、院校分数对比、单选诊断四个页面;API 保留 Spring MVC 标准异常的响应状态。

⚠️ 未完成的计划项

Agent 服务端任务:丰富 RAG 检索语料,提升问答的可召回率与覆盖完整性在Alpha阶段未达成目标效果。此外,前端目标视觉效果未完全实现。

总体看,P0/P1 级核心改进已按计划落地,低优先级项按敏捷"精益交付"原则顺延至 Beta。

2. 项目亮点

2.1 技术与产品亮点

  • Agent 挂了不崩:检索断连、超时、限流或模型返回异常时自动降级,给用户明确的中文提示而非整单报错,内部代号不外泄。
  • 检索找得更准:先按文档去重再挑结果,长文档不再挤占名额;修复 BM25 高频词权重算成负数的问题,相关内容不再被错误排掉。
  • 回答说话更稳:引用和数字核查通过前不流出正文,通过后逐句推送、保留打字机效果;输出上限换了厂商认可的参数,长度真正卡得住。
  • 运行状态可控:词表多级查找并做 SHA-256 校验,防止对话历史被悄悄裁光,健康检查可查看计量模式;LOG_LEVEL 接管日志配置,级别真正生效、填错即拒启动。
  • 产品体验闭环:首页改为任务驱动,打开即见今日任务和薄弱点、点按钮直接去练;学情页术语白话化、全站米白暖色统一;开练到择校全链路走通,11 个失效接口恢复并新增四个页面,刷题优先抽本人没做过的题。
  • 职责底线清晰:判分由 Java 做确定性计算,AI 只解释不改分;模型默认关闭、需授权启用,修复与重构中这条边界未被破坏。

2.2 团队管理亮点

  • 六条线分工无闲人:13 人按缺陷修复、回归验收、计划、总结、演示、Vlog 六条线组织,每条线设主笔加协作,每个成员都有明确产出。
  • 采用 "核心开发 + 多人测试" 的协作模式:实行核心开发与多人测试机制:核心成员专注架构与关键编码,保证实现一致性;多名成员按用户路径并行开展场景化测试,问题发现与修复复验形成闭环,提升交付稳定性。

3. 项目不足与改进方向

不足维度 具体问题 影响程度 改进措施
功能验收 功能写完只过单测和接口,没人按用户路径在真实站点走一遍 高 每个功能合并前,必须有人在演示站走一遍主流程并截图
信息架构 先堆页面后想导航,入口一度平铺到 16 条 中 新页面先定"放在哪个分组、给谁看"再动工
文案体验 术语(蓝图覆盖等)写给自己看,新手看不懂 中 少用术语,多使用简明的语言
测试覆盖 验证记录仍有未运行项,端到端质量较多依赖人工回归 中 补齐未运行测试,引入接口契约测试,降低人工回归依赖
数据维护 测试账号无人维护,演示前才发现页面是空的 中 演示账号专人维护,每次改动后补样例数据

根本原因分析:

  1. 验收视角缺失:项目刚开始时验收停在单测和接口层,缺少端到端用户走查,导致"做了但打不开";Agent 侧多个问题(词表缺失、参数名不生效)也是真实请求才暴露。
  2. 架构补课滞后:先堆功能再补信息架构,导航、文案和文档的债累积到冲刺前才还。
  3. 静默失败太多:词表退化、日志配置被框架覆盖等问题没有显式警告,问题发生后难以第一时间发现,催生了健康检查与 WARNING 机制。

4. 团队成员贡献与体会

4.1 工作量分布

姓名 学号 冲刺任务 核心贡献 贡献占比
林志涛 102401614 项目管理与前端UI优化 统筹项目进度,分配任务,参与前端优化 11%
严科儒 102401633 演示主讲、接口重组,bug修复 接口按域重组的方案与实施,学情画像、诊断链路,串起前后端联调 11%
翁斌 102401632 bug修复与数据库知识库重构 数据结构与迁移脚本核对,补充RAG检索语料 12%
朱铮睿 102401625 Vlog 拍摄与剪辑 分镜设计、每日拍摄、剪辑成 3–5 分钟成片 9%
尼玛顿珠 102401635 冲刺计划主笔 撰写冲刺计划与流程表,跟踪每日进度,汇总缺口 7%
何锦宏 102401511 PPT制作 设计演示结构与讲稿 9%
任奥辉 102401512 Vlog 协作 收集每日素材与协作画面,负责字幕、配乐与导出 7%
曾林远见 102401519 计划协作与记录 组织阶段站立会,整理冲刺日志与关键截图 6%
林富强 102401510 冲刺总结主笔 撰写冲刺总结博客,按问题逐条对应证据 6%
吴瑞鹏 102401509 冲刺总结协作 整理前后对比截图、链接与数据表,排版与校对 6%
丁鑫河 102401525 演示材料协作 制作演示图表与架构页,统一版式并导出 5%
林鹏远 102401526 数据核对 核对演示数字、口径与页面是否一致,准备问答口径 6%
杜佳伟 102401623 回归与验收 每天按主流程点一遍全站,记录问题清单与修复复验结果 5%

4.2 成员过程体会

  • 严科儒:接口重组是这次最硬的骨头,旧接口零散又大面积失效,按业务域重新拆分后才真正串起整条链路。最大的体会是后端不能只盯单个接口,得站在整条用户路径上想问题;当主讲也逼着我把技术细节讲成别人听得懂的话。
  • 翁斌:这次主要跟数据打交道,迁移脚本和 RAG 语料看似是体力活,其实每个字段、每份索引都得核对清楚,一个口径错了后面全乱。补语料也让我明白,检索效果好不好,一半功夫在数据质量上。
  • 林志涛:一边盯进度一边做前端,最大的感受是项目管理不是催活,而是把合适的事分给合适的人、把阻塞提前清掉。首页改成任务驱动后,我更确信好产品是让用户 "不用想就会用",而不是把功能堆上去。
  • 尼玛顿珠:写计划前觉得是走形式,真做下来才发现,把目标拆成可判定的任务、每天跟踪缺口,团队才不会乱。计划不是束缚人的,是让大家随时知道 "现在在哪、下一步干嘛"。
  • 曾林远见:组织站立会、整理日志看似都是小事,但坚持记录才发现,冲刺的过程和决策都有据可查。好记录不是事后补的,是每天攒出来的,这也让我更理解协作中 "留痕" 的分量。
  • 林富强:写总结最大的挑战是每个结论都得找到对应证据,不能凭印象写。这逼着我把整个冲刺重新过了一遍,也真正体会到 "用事实说话" 比堆砌形容词有说服力得多。
  • 吴瑞鹏:整理截图和数据看着琐碎,真做起来才发现排版校对特别磨耐心,一个链接错了、一个数字对不上,整篇可信度就打折。细节虽小,却是交付质量的一部分。
  • 何锦宏:做 PPT 和讲稿让我意识到,把复杂技术讲清楚比写出来更难。演示不是功能罗列,而是讲一个完整故事,听众能不能十分钟听懂产品价值,全靠结构和取舍。
  • 丁鑫河:负责架构页和图表,反复调版式的过程让我体会到,可视化不是装饰,而是帮人快速理解信息的手段;统一版式背后,是对整体节奏的把控。
  • 林鹏远:核对数字和口径是个 "找茬" 的活,却让我明白页面上每个数字都要能追溯到来源。问答口径提前备好,现场才不会慌,严谨其实是给自己留底气。
  • 朱铮睿:从分镜到成片,第一次完整跟下一个 Vlog,才知道素材得每天攒、不能临时补。剪辑也是重新理解项目的过程,把十几天的协作浓缩进几分钟,挺有成就感。
  • 任奥辉:做字幕和配乐是慢工活,反复对时间轴特别考验耐心。但看到零散素材最后变成一条完整片子,真切感受到后期给内容赋予的节奏感。
  • 杜佳伟:每天把全站点一遍,起初觉得枯燥,后来发现不少问题都是这样被提前揪出来的。测试不是开发的对立面,而是站在用户角度替团队把好最后一道关,这份 "挑剔" 很有价值。

5. 冲刺计划链接与资产

6. 总结

本次 Alpha 冲刺,408 小组用 14 天把系统从"功能做出来了但打不开"推进到"核心链路可演示、站点门面可接手"。UI大幅改善;更进一步地,给 Agent 补齐了容错降级、检索质量、流式审核与可观测性的短板。尽管时间紧迫,我们还是展现了敏捷开发的软件工程实践素养。
这次实践让我们学到、体会了很多。在软工课程上,空耳听好似无用的理论,在软件工程实践中却是如此重要。身为计科学生我深刻认识到了,当ai洪流碾平了软件开发的门槛,也许实践中培养的开发思维是我们最后的护城河。

posted @ 2026-11-21 16:04  |llin  阅读(17)  评论(0)    收藏  举报