当前位置：首页 > news >正文

软件工程团队第三次作业

news 2026/5/31 12:44:25

校园失物招领助手 - 冲刺总结

📌 基本信息

项目	内容
这个作业属于哪个课程	https://edu.cnblogs.com/campus/gdgy/SoftwareEngineeringDoubleDegree2026
这个作业要求在哪里	https://edu.cnblogs.com/campus/gdgy/SoftwareEngineeringDoubleDegree2026/homework/15665
团队名称	失物招领小分队
团队成员-学号	冯梓轩-3123006640；徐嘉琪-3223009408
这个作业的目标	完成项目冲刺，总结成果与不足

一、是否实现冲刺计划中的改进？

1.1 已完成项目

计划项	是否完成	说明
修复三页面独立布局	✅ 完成	现在“失物登记”“物品广场”“我的”三个页面完全独立，互不干扰
剪贴板填充功能增强	✅ 完成	增加“示例填充”按钮，用户可一键测试格式；解析正则优化，支持多种字段顺序
匹配算法优化	✅ 完成	增加同义词库（伞↔雨伞，水杯↔杯子等），提高召回率
管理员重置功能	✅ 完成	管理员可见重置按钮，一键清空后端并恢复默认用户
测试用例设计	✅ 完成	覆盖登记、匹配、删除、导入导出（已删除）等功能
PPT 与演示文档	✅ 完成	已制作答辩 PPT 和演示视频

二、项目亮点

管理员工具：一键重置所有数据，方便演示前初始化环境。
智能匹配引擎：基于同义词的核心词匹配，不要求字面完全一致，例如“伞”和“雨伞”“水杯”和“保温杯”都能匹配成功。
AI 辅助录入：集成 Coze 官方 SDK，用户可与 AI 对话，AI 按固定格式输出，然后一键填充到表单，降低录入门槛。
隐私保护：联系方式仅在匹配成功后对双方可见，平台不公开存储。
多用户协同：通过不同浏览器/隐身窗口登录不同账号，数据实时共享，可演示完整的匹配流程。

三、项目目前不足

AI 不能自动填表：受限于 Coze SDK 无法获取对话内容，用户仍需手动复制粘贴。我们通过“示例填充”按钮降低了理解成本。
匹配算法较简单：目前仅支持预定义的同义词，无法理解语义相近的短语（如“黑色长柄伞”和“黑色折叠伞”）。若需更精准可接入 Coze 的语义相似度 API（但有成本）。
界面适配性一般：主要针对手机竖屏尺寸设计（最大宽度 500px），在大屏幕或横屏上显示不够美观。
部署复杂：需要本地运行 json-server 和 http-server，且浏览器必须禁用跨域安全策略，不利于真正上线的多用户使用。若要上线，需将前端部署到静态服务器，后端使用真正的数据库。

四、每位成员的过程体会

冯梓轩

在整个项目中，我主要负责前后端开发。刚开始遇到的最大困难是 跨域问题（浏览器阻止前端直接调用 Coze API），尝试了代理方案但配置复杂。最后采用官方 SDK 直接嵌入，完美解决了跨域，并且开发效率大大提高。
另一个挑战是 页面布局的独立性：最初“我的”页面也显示了手动登记表单，导致用户困惑。经过两次重构，最终实现了三个页面完全独立。
通过这次项目，我深入理解了前后端分离、REST API、同义词匹配算法以及如何快速集成第三方 AI 服务。虽然熬夜改 Bug 很辛苦，但看到匹配成功弹出卡片的那一刻很有成就感。

工作量比例：50%

徐嘉琪

我主要负责编写智能体AI 集成、后端开发和测试。一开始对项目的业务流程不熟悉，导致测试用例覆盖不全。后来结合用户场景设计了 20 多个测试点，包括正常流程、异常输入、匹配触发、跨用户交互等。
通过这次合作，我学会了如何编写规范的测试报告，如何用 json-server 模拟后端，以及如何录制剪辑演示视频。虽然时间紧张，但团队配合默契，最终按时完成所有材料。

工作量比例：50%