# 实现方案

开始时间：2026-05-03-18-27-21

## 本次方案路径

`工程分析/实现方案-2026-05-03-18-27-21.md`

## 实现目标

建立长期有效的项目修改工作流，并将工作流说明放在后续维护者容易读取的位置。

## 涉及文件

- `AGENTS.md`
- `工程分析/工程整体分析.md`
- `工程分析/经验记录.md`
- `工程分析/需求分析-2026-05-03-18-27-21.md`
- `工程分析/实现方案-2026-05-03-18-27-21.md`
- `工程分析/测试方案-2026-05-03-18-27-21.md`

## 执行步骤

1. 创建 `工程分析/` 目录。
2. 编写 `AGENTS.md`，将用户指定的流程固化为仓库级工作流。
3. 编写 `工程分析/工程整体分析.md`，记录当前项目结构、运行方式、测试入口和风险边界。
4. 编写本次需求分析、实现方案和测试方案文档。
5. 初始化 `工程分析/经验记录.md`，记录建立工作流的原因、方案和后续避免方式。
6. 执行文档检查、前端类型检查和构建检查。
7. 将文档变更提交并推送到 Gitea。
8. 重新部署本项目的后端和前端开发服务。

## 回滚思路

如该工作流需要撤销，可删除本次新增的 `AGENTS.md` 和 `工程分析/` 中本次新增文档，并提交一次回滚 commit。若只需调整流程，应优先修改 `AGENTS.md` 和对应工程分析文档，而不是删除知识库。

## 风险控制

- 本次不修改业务代码，降低运行行为变化风险。
- Gitea 密码不写入仓库，不写入提交信息。
- 重新部署前先执行前端检查，确保基础构建链路可用。

## 人工审核状态

本次为建立工作流本身，按用户明确指令直接执行。后续业务代码修改必须等待用户对实现方案进行二次人工审核确认。