详细说明: - 升级 pnpm 到 10.15.1 版本以满足项目要求 - 安装所有项目依赖 - 成功构建 n8n 项目 - 启动 n8n 服务器在 localhost:5678 - 创建 CLAUDE.md 文件记录开发规范 - 配置 Serena 项目管理和记忆系统 - 修改文件: CLAUDE.md, .serena/*, build.log, lefthook.yml - 影响模块: 开发环境配置和项目运行
1.2 KiB
1.2 KiB
n8n 项目开发规范
项目路径
- 项目根目录: /Users/xiaoqi/Documents/Dev/Project/2025-09-08_n8nDEMO演示
- n8n源码目录: n8n-n8n-1.109.2/
运行方式偏好
- 首选: 使用
pnpm dev开发模式运行(支持热更新) - 备选:
pnpm build后使用pnpm start运行 - 不使用
npx n8n(会下载最新版本而非本地代码)
Git 提交规范(必须严格执行)
分支管理
- 工作分支:
My_N8N - 每次任务完成后必须自动提交到此分支
提交信息格式
[任务类型]: 任务描述(50字符以内)
详细说明:
- 完成的具体工作内容
- 修改的文件列表
- 影响的功能模块
任务类型
- feat: 新功能
- fix: 修复
- docs: 文档
- style: 格式
- refactor: 重构
- test: 测试
- chore: 杂项
自动提交流程
- 切换到项目根目录
- 确保在 My_N8N 分支
- git add .
- git commit -m "规范化的提交信息"
- 查看提交历史确认
开发注意事项
- 始终使用 pnpm 而不是 npm 或 yarn
- 在 n8n-n8n-1.109.2 目录下执行命令
- 运行测试前先进入对应的包目录
- 提交代码前运行 lint 和 typecheck
- 构建命令输出重定向到日志文件以便查看错误