| 这个作业属于哪个课程 | https://edu.cnblogs.com/campus/gdgy/SoftwareEngineering24/?page=2 |
|---|---|
| 这个作业要求在哪里 | https://edu.cnblogs.com/campus/gdgy/SoftwareEngineering24/homework/15658 |
| 这个作业的目标 | 对项目和工作进行总结与思考 |
| 学号 | 刘佳浩3124004478 张逸川3124004490 庄伟浩3124003560 章其忠 3124004491 |
SmartOffice AI — 变更记录
日期：2026-06-04
一、概览
本次改动围绕三个目标：
- 修复无用功能 — 将占位性质的"灯光反馈"按钮改造为模式切换开关
- 新增核心功能 — 发票/报销单批量处理（应老师建议）
- 提升稳定性 — Coze 请求超时保护、Electron 启动等待、流中断提示
二、改动详情
2.1 frontend/index.html
| 改动点 | 说明 |
|---|---|
| 模式切换 | 原"灯光反馈"按钮改为"🔄 切换至发票模式"，点击后全局状态 currentMode 在 text 和 invoice 之间切换 |
| 按钮联动 | 切换模式时，"语义碎纸机"按钮变为"📄 批量提取"，textarea 占位符也随之变化 |
| 流中断提示 | 在 SSE 流读取循环中检测到提前结束时，追加黄字警告"⚠ 流式连接已中断，生成可能不完整" |
| CSV 导出 | 发票模式下确认表格后自动下载 CSV 文件（带 BOM，Excel 打开中文不乱码） |
| 请求参数 | startStreaming() 接受 mode 参数，fetch body 中传递 { text, mode } |
2.2 backend/server.js
| 改动点 | 说明 |
|---|---|
| mode 参数 | 读取 req.body.mode，默认 'text'，兼容原有调用方 |
| 双 prompt | text 模式保持原 prompt 不变；invoice 模式使用新 prompt，固定输出表头：序号、类型、发票号、日期、金额、收款方、费用类别、备注 |
| 请求超时 | 使用 AbortController + 40 秒超时，防止 Coze 无响应时请求永久挂起 |
| 断连取消 | req.on('close') 监听客户端断开，自动 abort Coze 请求并清除超时定时器 |
2.3 electron/main.js
| 改动点 | 说明 |
|---|---|
| 启动轮询 | 15 秒超时后不再直接"强行加载"，改为每 1 秒轮询 localhost:4000 最多 20 次，后端就绪后才创建窗口 |
三、改动文件清单
frontend/index.html — 模式切换 UI + CSV 导出 + 流中断提示
backend/server.js — mode 参数 + 发票 prompt + 超时 + 断连取消
electron/main.js — 启动轮询等待后端就绪
不涉及新增文件、不新增依赖、不升级第三方包。
新增发票提取，支持输入图片
识别空白提示
支持网页内语音识别（仅Chrome浏览器支持）
四、使用说明
文本归整（原有功能，不变）
1. 粘贴混乱文本（微信群通知、会议笔记等）
2. 确保左上角模式为"文本归整"，点击"语义碎纸机"
3. AI 流式输出 Markdown → 生成可编辑表格 → 确认
发票报销（新增功能）
1. 切换模式：点击"🔄 切换至发票模式"
2. 粘贴发票/报销单文本（可一次性粘贴多条，用换行分隔）例：差旅报销 张三 2024-03-15 高铁票 553元电子发票 华为云服务 2024-03-20 金额 12800元 发票号 12345678出租车票 2024-03-22 14元
3. 点击"📄 批量提取"
4. AI 流式输出结构化发票表格
5. 编辑确认后自动下载 CSV（Excel 可直接打开）
五、注意事项
- Coze API 超时设为 40 秒，网络不佳时请耐心等待
- 发票识别依赖文本质量，纸质报销单建议手打关键信息后再粘贴
- 如需回退，还原对应文件即可，不改动任何原有数据流
六、自动化单元测试
七、团队协作记录及成员心得
-
本次冲刺核心迭代内容包含三大板块，分别是无用功能改造、发票报销批量处理新功能开发、项目整体稳定性优化。团队提前召开冲刺分工会议，根据前后端、桌面端不同开发模块拆分任务，明确各成员开发、测试、联调职责。其中，前端完成UI功能改造、模式切换逻辑、CSV导出、流式异常提示等功能开发；后端实现模式参数适配、双AI提示词配置、请求超时与断连保护机制优化；Electron端完成项目启动逻辑升级，优化后端服务启动等待机制。
-
开发过程中，团队采用同步开发、实时对接的协作模式，每日同步开发进度，针对SSE流式中断、API请求超时、Electron启动异常、发票文本识别精度等问题共同排查调试。同时完成新功能测试验证，实现发票文本批量提取、结构化表格生成、CSV自动导出、语音识别、空白异常提示等配套功能落地，全程无新增依赖、无代码冲突，完美兼容项目原有文本归整核心功能，最终顺利完成本次Beta版本迭代，项目功能性、稳定性、实用性均大幅提升。
| 成员姓名 | 个人冲刺体会与收获 |
|---|---|
| 张逸川 | 本次Beta冲刺中，我主要负责前端页面功能改造与交互逻辑优化工作，重点完成模式切换功能开发、按钮状态联动、流式连接中断提示、发票模式CSV文件导出等核心前端功能。本次迭代让我收获颇丰，我熟练掌握了前端全局状态切换的联动逻辑开发，理解了SSE流式数据传输的异常处理机制，解决了以往项目中流式生成内容不完整却无提示的问题。同时，针对Excel中文乱码问题，学会了带BOM格式CSV文件的导出方案。在团队协作中，我深刻体会到前后端参数对接的重要性，通过和后端成员同步mode参数传参逻辑，有效规避了接口适配错误。本次迭代不仅提升了我的前端实战开发能力，也让我更加注重功能的细节体验和异常容错设计。 |
| 庄伟浩 | 本次冲刺我主要承担后端服务的迭代优化工作，聚焦server.js核心逻辑升级，完成了mode模式参数适配、双AI提示词配置、Coze接口40秒超时保护、客户端断连自动取消请求等功能开发。通过本次开发，我深入掌握了Node.js服务端请求异常处理、AbortController中断请求的实战用法，解决了项目长期存在的接口请求挂起、无响应卡死的稳定性问题。同时，针对发票识别专属prompt进行定制化优化，规范了结构化表格输出格式，大幅提升了AI识别输出的规范性。在团队协作中，我积极配合前端的功能迭代节奏，实时对接接口参数与返回逻辑，深刻认识到服务端稳定性对整体项目运行的重要性，积累了丰富的后端容错优化和前后端联调经验。 |
| 刘佳浩 | 本次 Beta 冲刺我的核心工作是负责项目启动逻辑与服务适配优化，重构了项目原有加载机制，将原有粗暴的强行加载模式，改造为轮询检测后端服务状态的加载方式，有效解决了后端服务未完全就绪时，网页提前加载、接口请求失败、功能失效的问题。本次迭代让我系统掌握了网页端项目前后端服务的启动时序优化方案，理解了前后端联动适配的核心逻辑，熟练掌握通过定时轮询机制检测后端服务状态、提升项目整体稳定性的开发技巧，大幅提升了 Web 项目的适配调试与性能优化能力。 |
| 章其忠 | 本次冲刺我主要负责项目功能测试、问题排查、文档整理以及新功能效果验证工作，重点对发票批量提取、语音识别、异常提示、CSV导出、模式切换等所有新增及优化功能进行全面测试，同时整理本次冲刺的改动清单、使用说明和变更记录。在测试过程中，我发现了发票空白识别无提示、流式连接中断无反馈等多项细节问题，并协助开发成员快速复现、定位问题，保障了版本迭代质量。通过本次冲刺，我全面熟悉了项目的整体架构与所有功能逻辑，提升了软件测试与问题复盘的能力。在团队协作中，我负责同步整体开发进度、整理迭代资料，让团队的开发流程更加规范高效，也深刻体会到测试与文档梳理是项目稳定迭代不可或缺的关键环节。 |