Files
linux_format_docs_check/handoff-2026-05-26-17-14-49-integrate-0005.md
2026-05-26 17:16:30 +08:00

2.6 KiB
Raw Blame History

Handoff - 2026-05-26

Completed Tasks

  • 昨天完成了独立模块 app/review_filler.py 向 FastAPI 主流程的集成:在 Markdown 分析报告生成后,自动调用审查单填充逻辑,生成已勾选的 DOCX 文档审查单。
  • 新增审查单模板路径 REVIEW_DOCX_TEMPLATE,当前沿用 test/附录A文档审查.docx,生成结果写入现有 outputs/ 目录,并通过 /download/{filename} 下载。
  • 扩展分析任务返回值,在原有 markdown 下载项之外新增 review_docx 下载项,同时保留 markdown_filename 并新增 review_docx_filename
  • 更新系统 UI在分析结果区域新增“下载 DOCX 审查单”按钮,并在前端轮询任务完成后绑定 task.downloads.review_docx
  • 补充 Web 集成测试,验证页面包含新下载入口、分析流程生成 DOCX 审查单,并校验 A.2、A.3、A.4 审查表每个序号行均满足三选一互斥勾选。
  • 完成验证:pytest tests/test_web.py tests/test_review_filler.py 通过,pytest 全量测试通过,结果为 24 passedgit diff --check 通过。
  • 启动本地服务并用真实 /analyze 上传流程做了运行验证,确认任务完成后返回 Markdown 和 DOCX 审查单两个下载项。

Blockers

  • 当前审查单模板仍位于 test/附录A文档审查.docx,可运行但不够产品化;后续建议迁移到专门的模板或资源目录。
  • app/review_filler.py 的判定仍依赖 Markdown 自然语言报告和关键词规则,准确性受模型输出格式影响,自动勾选结果仍需要人工复核。
  • 本地启发式分析模式下没有结构化“符合项/不符合项”证据段,审查单可生成并通过互斥校验,但判定质量偏保守。
  • 默认会填写 A.2、A.3、A.4 全部审查单;如果上传文档只对应单一文档类型,后续可能需要在 Web 流程中提供目标审查表选择。

Next Steps

  • 明天计划将审查单模板从 test/ 迁移到正式资源目录,例如 resources/templates/app/templates/docx/,并更新常量和测试。
  • 优化模型分析输出格式,增加结构化审查证据或审查项结果,降低 review_filler 对自然语言关键词匹配的依赖。
  • 在 UI 中评估是否增加“目标审查表”选择项,支持只生成 A.2、A.3 或 A.4 的审查单填写结果。
  • 增加端到端测试,覆盖 /analyze 提交、任务轮询、Markdown 下载和 DOCX 审查单下载的完整 HTTP 流程。
  • 继续抽查真实样本文档生成的审查单,重点确认“未通过”和“不适用”判定是否符合人工审查预期。