ECC /pm2 命令实战指南自动检测多服务项目并生成 PM2 进程配置与 Claude 命令文件【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC本文以 ECC 仓库中/pm2命令的定义文档为主线详解其项目分析 → 服务检测 → 配置生成的完整工作流覆盖 7 类服务类型的检测规则与默认端口、生成文件清单、以及 Windows 环境下ecosystem.config.cjs的编写要点。读完你可以理解如何用该命令为一个多服务项目补齐完整的 PM2 进程生命周期管理能力启动 / 停止 / 重启 / 日志 / 监控面板并获得一套可被直接执行的 Claude 自定义命令。/pm2 命令是什么/pm2是 ECC 仓库定义的一个 general 类型命令官方描述为Analyze a project and generate PM2 service commands for detected frontend, backend, or database services分析项目为检测到的前端 / 后端 / 数据库服务生成 PM2 服务命令。该定义注册在 docs/COMMAND-REGISTRY.json{ command: pm2, description: Analyze a project and generate PM2 service commands for detected frontend, backend, or database services., type: general, path: commands/pm2.md }也就是说命令主体是 markdown 文件 commands/pm2.md本文所依据的 docs/es/commands/pm2.md 是它的西班牙语本地化版本两者共享同一套核心工作流规范英文版比西语版多出命令文件模板与CLAUDE.md 更新规则两个章节后文会结合它做补充。在仓库的目录总览中README.md 将该命令定位为/pm2 - PM2 service lifecycle managementCOMMANDS-QUICK-REF.md 的命令速查表中也将其列为 PM2 process manager initialisation。工作流三步完成初始化/pm2命令的完整工作流分三步检查 PM2 是否可用若机器上没有 PM2先执行npm install -g pm2扫描项目识别服务把检测到的组件归类为前端、后端、数据库三类生成配置文件与单独命令文件包括 PM2 主配置ecosystem.config.cjs和.claude/下的 Claude 命令文件 / PowerShell 脚本。全部生成完成后命令会输出一个完成摘要见Post-Init 摘要一节。服务检测规则与默认端口各服务类型的检测规则是/pm2命令的核心它依据以下文件的存在性判断要启动哪些进程、监听哪个端口类型检测依据默认端口Vitevite.config.*5173Next.jsnext.config.*3000Nuxtnuxt.config.*3000CRApackage.json 中的react-scripts3000Express/Nodeserver/backend/api目录 package.json3000FastAPI/Flaskrequirements.txt/pyproject.toml8000Gogo.mod/main.go8080如果项目显式声明了端口则不必依赖默认值。命令给出了明确的端口检测优先级用户指定 .env 配置文件 scripts 参数 默认端口例如一个 Vite 项目如果在.env中写了PORT4000或scripts里的 vite 脚本带了--port 4000生成配置时就会采用相应端口而不是默认的 5173。生成的文件清单执行/pm2后会在目标项目注意不是本仓库仓库只定义生成规则中产生如下文件project/ ├── ecosystem.config.cjs # PM2 配置 ├── {backend}/start.cjs # Python wrapper如适用 └── .claude/ ├── commands/ │ ├── pm2-all.md # 启动全部 monit │ ├── pm2-all-stop.md # 停止全部 │ ├── pm2-all-restart.md # 重启全部 │ ├── pm2-{port}.md # 启动单个 日志 │ ├── pm2-{port}-stop.md # 停止单个 │ ├── pm2-{port}-restart.md # 重启单个 │ ├── pm2-logs.md # 查看全部日志 │ └── pm2-status.md # 查看状态 └── scripts/ ├── pm2-logs-{port}.ps1 # 单个服务日志 └── pm2-monit.ps1 # PM2 监控面板两个设计点值得注意命令文件按端口命名如pm2-3000.md生成后你只需调用/pm2-3000即可定位要操作的服务监控面板与日志查看被单独拆成 PowerShell 脚本.claude/scripts/因为 Claude 命令文件内容被刻意保持极简见关键规则重量级的终端操作直接走脚本更可靠。Windows 配置要点为什么必须用 ecosystem.config.cjs西语文档将这一章节标注为 IMPORTANTE它也是整个命令中踩坑最多的地方。核心要求是配置文件必须使用.cjs扩展名而不是.js。这样做是为了避免项目package.json中type: module与 PM2 惯用的 CommonJS 式module.exports配置写法发生冲突。基础配置示例Node.js 前端服务module.exports { apps: [ // Node.js (Vite/Next/Nuxt) { name: project-3000, cwd: ./packages/web, script: node_modules/vite/bin/vite.js, args: --port 3000, interpreter: C:/Program Files/nodejs/node.exe, env: { NODE_ENV: development } } ] }规范英文版 commands/pm2.md 进一步给出了包含 Python 服务在内的完整配置示例和框架脚本路径对照表当你需要手写或核对生成配置时可直接参考module.exports { apps: [ // Node.js (Vite/Next/Nuxt) { name: project-3000, cwd: ./packages/web, script: node_modules/vite/bin/vite.js, args: --port 3000, interpreter: C:/Program Files/nodejs/node.exe, env: { NODE_ENV: development } }, // Python { name: project-8000, cwd: ./backend, script: start.cjs, interpreter: C:/Program Files/nodejs/node.exe, env: { PYTHONUNBUFFERED: 1 } } ] }框架scriptargsVitenode_modules/vite/bin/vite.js--port {port}Next.jsnode_modules/next/dist/bin/nextdev -p {port}Nuxtnode_modules/nuxt/bin/nuxt.mjsdev --port {port}Expresssrc/index.js或server.js-这张表对应着两条关键规则Node.js 服务的script直接指向框架 bin 文件并显式用interpreter指定 Node 可执行文件绝对路径以此规避 PM2 在 Windows 下解析npm run类脚本的不可靠行为Python 服务不直接指向.py文件而是指向一个 Node.js wrapper 脚本start.cjs。英文版给出了 wrapper 的实现const { spawn } require(child_process); const proc spawn(python, [-m, uvicorn, app.main:app, --host, 0.0.0.0, --port, 8000, --reload], { cwd: __dirname, stdio: inherit, windowsHide: true }); proc.on(close, (code) process.exit(code));其中windowsHide: true用于隐藏子进程黑窗stdio: inherit保证 uvicorn 的日志能被 PM2 收集proc.on(close)转发退出码让 PM2 能正确感知 Python 服务崩溃并触发重启策略。关键规则Reglas Clave文档归纳了六条关键规则它们本质上是生成文件必须能直接跑的 Windows 落地清单配置文件ecosystem.config.cjs不是 .jsNode.js直接指定 bin 路径 interpreterPythonNode.js wrapper 脚本 windowsHide: true打开新窗口start wt.exe -d {path} pwsh -NoExit -c command内容极简每个命令文件只有 1-2 行描述 一个 bash 代码块直接执行无需 AI 解析直接运行 bash 命令即可。第 5、6 条决定了生成的.claude/commands/*.md文件形态每个文件就是一两句话 一个 bash 块。英文版给出了全部模板例如pm2-all.md启动全部服务并打开监控Start all services and open PM2 monitor. bash cd {PROJECT_ROOT} pm2 start ecosystem.config.cjs start wt.exe -d {PROJECT_ROOT} pwsh -NoExit -c pm2 monit pm2-{port}.md启动单个服务并打开日志Start {name} ({port}) and open logs. bash cd {PROJECT_ROOT} pm2 start ecosystem.config.cjs --only {name} start wt.exe -d {PROJECT_ROOT} pwsh -NoExit -c pm2 logs {name} 其余pm2-all-stop.md/pm2-all-restart.md/pm2-{port}-stop.md/pm2-{port}-restart.md/pm2-logs.md/pm2-status.md模板结构相同分别执行pm2 stop all/pm2 restart all/pm2 stop {name}/pm2 restart {name}/pm2 logs/pm2 status均以cd {PROJECT_ROOT} 开头。两个 PowerShell 脚本同样极简# pm2-logs-{port}.ps1 Set-Location {PROJECT_ROOT} pm2 logs {name}# pm2-monit.ps1 Set-Location {PROJECT_ROOT} pm2 monit规则 4 中start wt.exe -d {PROJECT_ROOT} pwsh -NoExit -c ...的作用是在 Windows Terminal 中打开一个独立 PowerShell 窗口运行需要常驻的命令monit / logs-NoExit让命令结束后窗口保持打开主会话不被阻塞。补充生成后更新项目 CLAUDE.md 并输出摘要规范英文版 commands/pm2.md 还定义了文件生成完成后的两个动作更新目标项目的CLAUDE.md追加一个## PM2 Services小节内容为服务表Port / Name / Type加常用终端命令若该小节已存在则替换不存在则追加到文件末尾且保持内容最小化输出完成摘要。西语版给出的摘要格式如下## PM2 Init Completado **Servicios:** | Puerto | Nombre | Tipo | |--------|--------|------| | {puerto} | {nombre} | {tipo} | **Comandos Claude:** /pm2-all, /pm2-all-stop, /pm2-{puerto}, /pm2-{puerto}-stop, /pm2-logs, /pm2-status **Comandos de Terminal:** pm2 start ecosystem.config.cjs # Primera vez pm2 start all # Después de la primera vez pm2 stop all / pm2 restart all pm2 logs / pm2 status / pm2 monit pm2 resurrect # Restaurar lista guardada英文版摘要的终端命令部分更完整把首次与此后分开并额外给出pm2 save提示首次启动后执行pm2 save持久化进程列表之后即可用简化的pm2 start all/pm2 resurrect命令pm2 start ecosystem.config.cjs pm2 save # First time pm2 start all / pm2 stop all / pm2 restart all pm2 start {name} / pm2 stop {name} pm2 logs / pm2 status / pm2 monit pm2 save / pm2 resurrect适用前提与范围说明为避免误用该命令需要注意以下前提目标平台是 WindowsPowerShell / Windows Terminal文档中的.cjs要求、interpreter绝对路径、start wt.exe、.ps1脚本等模板全部面向 Windows 环境设计PM2 需预先可用命令仅在缺失时通过npm install -g pm2自动安装生成文件落在目标项目而非本仓库本仓库提供的是命令定义检测、配置与生成规则。你在业务项目中实际运行/pm2后生成的ecosystem.config.cjs与.claude/commands/目录位于该业务项目中。若想继续深入建议的入口西语版本文档 docs/es/commands/pm2.md、含全部模板与 CLAUDE.md 更新规则的规范英文版 commands/pm2.md、命令注册信息 docs/COMMAND-REGISTRY.json以及命令速查表 COMMANDS-QUICK-REF.md。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考