2026-04-28-22-55-15 - 建立代码编纂工作流

工程分析/经验记录.md

@@ -0,0 +1,46 @@
+# 经验记录（Knowledge Base）
+
+> 本文件按代码编纂工作流规范，以四段式记录项目修改过程中遇到的关键问题及解决方案。  
+> 格式: A. 具体问题 / B. 产生原因 / C. 解决方案 / D. 后续如何避免
+
+---
+
+## 2026-04-28-22-55-15 — 建立代码编纂工作流
+
+### A. 具体问题
+项目缺少标准化的代码修改流程，导致需求管理、方案设计、测试验证、知识沉淀等环节可能遗漏，影响项目质量和可维护性。
+
+### B. 产生原因
+项目初期以快速原型为主，未建立正式的工程化管理流程；随着功能增加，需要更严谨的变更管理机制。
+
+### C. 解决方案
+建立完整的代码编纂工作流，包含 10 个阶段：时间戳记录、工程分析、需求分析、实现方案（人工审核）、测试方案（人工审核）、执行前准备（阅读经验记录）、方案执行、经验沉淀、Gitea 备份、重新部署。
+
+### D. 后续如何避免问题
+- 后续所有项目修改严格按工作流执行
+- 每次修改前检查工作流检查表
+- 定期回顾经验记录，提取共性预防措施
+
+---
+
+## 2026-04-28-22-55-15 — 执行环境 Node.js 缺失
+
+### A. 具体问题
+执行 `npm run lint` 和 `npm run build` 时提示 `npm: command not found`，当前 Shell 环境未安装 Node.js 运行时。
+
+### B. 产生原因
+AI 助手运行的容器/环境与项目实际开发环境分离，后者才装有 Node.js 和 npm。
+
+### C. 解决方案
+- 文档创建和 git 操作可在 AI 环境中完成
+- 构建验证（`npm run lint`、`npm run build`、`npm start`）需由用户在本地开发环境执行，或 AI 提供精确命令由用户自行运行
+- 在经验记录中标注此限制，提醒后续流程
+
+### D. 后续如何避免问题
+- 每次执行阶段 6 和阶段 9 前，先检查 `which npm`
+- 如 npm 不可用，向用户明确说明需手动执行的命令，并提供复制粘贴格式
+- 考虑在 CI/CD 流程中统一构建环境
+
+---
+
+> 新增经验请追加到文件末尾，保持时间倒序或正序均可，但需确保每条经验包含完整的 A/B/C/D 四段。