2026-05-19-22-59-07 建立代码编纂工作流

工程分析/实现方案-2026-05-19-22-59-07.md

@@ -0,0 +1,55 @@
+# 实现方案-2026-05-19-22-59-07
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-19-22-59-07.md`
+
+## 修改目标
+
+建立并固化项目级代码编纂工作流，使后续项目修改必须留下需求分析、实现方案、测试方案、经验记录、备份 commit 与部署验证。
+
+## 涉及路径
+
+- `工程分析/工程整体分析.md`
+- `工程分析/代码编纂工作流.md`
+- `工程分析/需求分析-2026-05-19-22-59-07.md`
+- `工程分析/实现方案-2026-05-19-22-59-07.md`
+- `工程分析/测试方案-2026-05-19-22-59-07.md`
+- `工程分析/经验记录.md`
+- `AGENTS.md`
+
+## 技术路线
+
+1. 记录本次开始时间 `2026-05-19-22-59-07`。
+2. 阅读项目 README、`WebSite/README.md`、`package.json`、`server.ts`、API 封装和主要 React 组件。
+3. 从 Git 中读取旧 `工程分析/工程整体分析.md`、`代码编纂工作流.md`、`经验记录.md`，保留旧知识库。
+4. 恢复并更新三个核心文档，只处理本次必要文件。
+5. 新增本次需求分析、实现方案、测试方案。
+6. 新增根目录 `AGENTS.md`，提醒后续进入仓库的助手优先执行该工作流。
+7. 执行静态检查和构建。
+8. 使用 `tmux` 重新部署 `WebSite` 服务到 `0.0.0.0:4000`。
+9. 验证 HTTP 健康检查和页面响应。
+10. 仅暂存本次相关文档和 `AGENTS.md`，创建包含时间戳和简要描述的 commit，并尝试推送到 Gitea。
+
+## 兼容性与回滚方案
+
+- 本次不修改业务代码，不改变 API、前端页面和运行态数据结构。
+- 若文档内容需要回滚，可回退本次 commit。
+- 若部署失败，可保留当前代码构建结果，检查 `tmux` 会话日志和端口占用后重新启动。
+- 若 Gitea 推送失败，本地 commit 仍保留，可稍后网络恢复后执行 `git push origin main`。
+
+## 预计文件变更
+
+- 更新：`工程分析/工程整体分析.md`
+- 更新：`工程分析/代码编纂工作流.md`
+- 更新：`工程分析/经验记录.md`
+- 新增：`工程分析/需求分析-2026-05-19-22-59-07.md`
+- 新增：`工程分析/实现方案-2026-05-19-22-59-07.md`
+- 新增：`工程分析/测试方案-2026-05-19-22-59-07.md`
+- 新增：`AGENTS.md`
+
+## 提交与部署策略
+
+- 暂存时显式列出本次文件，避免把工作区已有历史删除状态混入 commit。
+- commit message 使用：`2026-05-19-22-59-07 建立代码编纂工作流`
+- 部署方式沿用项目约定：`tmux` 会话 `revoxelseg-dicom` + `npm run serve -- --host 0.0.0.0 --port 4000`。