跳转至

PM2 初始化

自动分析项目，并生成 PM2 服务命令。

命令: $ARGUMENTS

工作流程

  1. 检查 PM2(如果缺失，则使用 npm install -g pm2 安装)
  2. 扫描项目并识别服务(前端/后端/数据库)
  3. 生成配置文件和单独的命令文件

服务检测

类型 检测 默认端口
Vite vite.config.* 5173
Next.js next.config.* 3000
Nuxt nuxt.config.* 3000
CRA package.json 中的 react-scripts 3000
Express/Node server/backend/api 目录 + package.json 3000
FastAPI/Flask requirements.txt / pyproject.toml 8000
Go go.mod / main.go 8080

端口检测优先级: 用户指定 > .env > 配置文件 > 脚本参数 > 默认端口

生成的文件

project/
├── ecosystem.config.cjs              # PM2設定
├── {backend}/start.cjs               # Pythonラッパー(該当する場合)
└── .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モニター

Windows 设置(重要)

ecosystem.config.cjs

必须使用 .cjs 扩展名

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' }
    }
  ]
}

框架脚本路径:

框架 script args
Vite node_modules/vite/bin/vite.js --port {port}
Next.js node_modules/next/dist/bin/next dev -p {port}
Nuxt node_modules/nuxt/bin/nuxt.mjs dev --port {port}
Express src/index.js 或 server.js -

Python 封装脚本(start.cjs)

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));

命令文件模板(最小内容)

pm2-all.md(全部启动 + monit)

すべてのサービスを起動し、PM2モニターを開きます。
```bash
cd "{PROJECT_ROOT}" && pm2 start ecosystem.config.cjs && start wt.exe -d "{PROJECT_ROOT}" pwsh -NoExit -c "pm2 monit"
```

pm2-all-stop.md

すべてのサービスを停止します。
```bash
cd "{PROJECT_ROOT}" && pm2 stop all
```

pm2-all-restart.md

すべてのサービスを再起動します。
```bash
cd "{PROJECT_ROOT}" && pm2 restart all
```

pm2-{port}.md(单个启动 + 日志)

{name}({port})を起動し、ログを開きます。
```bash
cd "{PROJECT_ROOT}" && pm2 start ecosystem.config.cjs --only {name} && start wt.exe -d "{PROJECT_ROOT}" pwsh -NoExit -c "pm2 logs {name}"
```

pm2-{port}-stop.md

{name}({port})を停止します。
```bash
cd "{PROJECT_ROOT}" && pm2 stop {name}
```

pm2-{port}-restart.md

{name}({port})を再起動します。
```bash
cd "{PROJECT_ROOT}" && pm2 restart {name}
```

pm2-logs.md

すべてのPM2ログを表示します。
```bash
cd "{PROJECT_ROOT}" && pm2 logs
```

pm2-status.md

PM2ステータスを表示します。
```bash
cd "{PROJECT_ROOT}" && pm2 status
```

PowerShell 脚本(pm2-logs-{port}.ps1)

Set-Location "{PROJECT_ROOT}"
pm2 logs {name}

PowerShell 脚本(pm2-monit.ps1)

Set-Location "{PROJECT_ROOT}"
pm2 monit

重要规则

  1. 配置文件: ecosystem.config.cjs(不是 .js)
  2. Node.js: 直接指定 bin 路径 + 解释器
  3. Python: Node.js 封装脚本 + windowsHide: true
  4. 打开新窗口: start wt.exe -d "{path}" pwsh -NoExit -c "command"
  5. 最小内容: 每个命令文件仅包含 1-2 行说明 + bash 代码块
  6. 直接执行: 无需 AI 解析，只需执行 bash 命令

执行

基于 $ARGUMENTS 执行初始化:

  1. 扫描项目服务
  2. 生成 ecosystem.config.cjs
  3. 为 Python 服务生成 {backend}/start.cjs(如适用)
  4. 在 .claude/commands/ 中生成命令文件
  5. 在 .claude/scripts/ 中生成脚本文件
  6. 使用 PM2 信息更新项目的 CLAUDE.md(参见下文)
  7. 显示包含终端命令的完成摘要

初始化后: 更新 CLAUDE.md

文件生成后，在项目的 CLAUDE.md 中添加 PM2 部分(如果不存在则创建):

## PM2サービス

| ポート | 名前 | タイプ |
|------|------|------|
| {port} | {name} | {type} |

**ターミナルコマンド:**
```bash
pm2 start ecosystem.config.cjs   # 初回
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                    # 保存したリストを復元
```

CLAUDE.md 更新规则: - 如果存在 PM2 部分，则替换 - 如果不存在，则追加到末尾 - 内容仅保留最小且必需的部分

初始化后: 显示摘要

所有文件生成后，输出以下内容:

## PM2初期化完了

**サービス:**

| ポート | 名前 | タイプ |
|------|------|------|
| {port} | {name} | {type} |

**Claudeコマンド:** /pm2-all, /pm2-all-stop, /pm2-{port}, /pm2-{port}-stop, /pm2-logs, /pm2-status

**ターミナルコマンド:**
## 初回(設定ファイル使用)
pm2 start ecosystem.config.cjs && pm2 save

## 初回以降(簡略化)
pm2 start all          # すべて起動
pm2 stop all           # すべて停止
pm2 restart all        # すべて再起動
pm2 start {name}       # 単一起動
pm2 stop {name}        # 単一停止
pm2 logs               # ログを表示
pm2 monit              # モニターパネル
pm2 resurrect          # 保存したプロセスを復元

**ヒント:** 初回起動後に`pm2 save`を実行すると、簡略化されたコマンドが使用できます。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC