经验记录

本文件作为项目统一知识库。每次最终执行项目修改前必须阅读；每次执行完成后，如遇到关键问题或形成可复用经验，必须按以下四段式追加记录。

2026-05-03-18-27-21 建立项目修改工作流

A. 具体问题

项目此前缺少统一的修改前分析、人工审核、测试确认、经验沉淀、Gitea 备份和重新部署流程，后续需求容易直接进入代码修改，导致风险不可追踪。

B. 产生问题原因

仓库中已有 README 和运行说明，但没有面向后续代码编纂工作的强制流程文件，也没有统一的 工程分析/ 知识库目录。

C. 解决问题方案

新增仓库根目录 AGENTS.md，明确后续项目修改需求必须记录开始时间、生成需求分析、实现方案、测试方案，并在实现方案和测试方案通过用户二次审核后再修改业务代码。新增 工程分析/工程整体分析.md、本经验记录，以及本次需求、实现、测试方案文档。

D. 后续如何避免问题

后续每次项目修改开始时先阅读 AGENTS.md、工程分析/工程整体分析.md 和 工程分析/经验记录.md，严格使用同一开始时间戳创建三类分析文档，并在用户确认实现方案和测试方案后再执行代码改动。