# 需求分析-2026-05-19-22-59-07

## 开始时间

2026-05-19-22-59-07

## 原始需求摘要

用户要求在仔细阅读项目后，新建一套完整的代码编纂工作流。后续凡是项目修改相关需求，都需要按该流程执行：记录开始时间、阅读或创建 `工程分析/`、写入需求分析/实现方案/测试方案、执行前阅读经验记录、执行后按四段式更新经验记录、使用 Gitea 备份 commit，并重新部署项目。

## 业务目标

- 将项目修改流程固化为可追踪、可复用、可审计的工程文档制度。
- 让后续需求从“直接改代码”升级为“先分析、再计划、再测试、再沉淀、再备份、再部署”的闭环。
- 保留已有经验记录中的关键教训，避免重复犯错。
- 让未来进入仓库的助手或开发者能通过项目文档理解必须执行的流程。

## 输入与输出

- 输入：用户给出的 0 到 7 条流程要求、当前项目源码、已有 README、Git 中历史 `工程分析/` 文档。
- 输出：
  - 更新后的 `工程分析/工程整体分析.md`
  - 更新后的 `工程分析/代码编纂工作流.md`
  - 本次 `需求分析`、`实现方案`、`测试方案`
  - 更新后的 `工程分析/经验记录.md`
  - 根目录 `AGENTS.md`，用于提示后续工作必须遵守该流程
  - 文档备份 commit 与重新部署结果

## 影响范围

- 文档治理：`工程分析/` 下核心文档和本次时间戳文档。
- 协作约束：根目录新增 `AGENTS.md`。
- 项目业务代码：本次不修改业务代码。
- 部署：按当前项目部署方式重新启动 `WebSite` 服务。

## 关键约束

- 当前工作区已有大量历史 `工程分析/` 时间戳文档处于删除状态，这些删除不是本次操作产生，不能混入本次提交。
- 必须先阅读旧 `经验记录.md`，尤其是部署端口、tmux 托管、真实源码定位、DICOM/STL 空间基准、不要伪造 Mask 等历史经验。
- 文档备份 commit 必须包含时间戳和本次修改简要描述。
- 重新部署优先使用 `WebSite` 的 `npm run serve -- --host 0.0.0.0 --port 4000`。

## 风险点

- 如果误暂存整个 `工程分析/`，可能把历史文档删除一起提交。
- 如果只创建新经验记录而不保留旧内容，会丢失已有知识库。
- 如果部署时直接占用端口，可能影响正在运行的服务。
- 如果未来助手没有读取项目文档，可能无法自动遵守流程，因此需要 `AGENTS.md` 增强可见性。

## 默认假设

- 用户本次需求本身也按新流程执行，但不需要在实现方案和测试方案阶段停等人工确认，因为历史工作流已有“后续直接搞”的确认。
- “Gitea 备份 commit”理解为在本地 Git 创建 commit，并尝试推送到已配置的 Gitea `origin`。