# pm

**Repository Path**: sentop/pm

## Basic Information

- **Project Name**: pm
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 进程管理器 (Process Manager)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Go Version](https://img.shields.io/github/go-mod/go-version/renyaoxiang/process-manager)](go.mod)
[![Go Report Card](https://goreportcard.com/badge/github.com/renyaoxiang/process-manager)](https://goreportcard.com/report/github.com/renyaoxiang/process-manager)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

一个使用 Go 编写的现代化进程管理工具，类似于 PM2，但性能更好、部署更简单。

## 功能特性

- ✅ **简单的进程管理** - 使用简单的命令启动、停止、重启和监控进程
- ✅ **CLI 界面** - 直观的命令行界面，支持自动补全
- ✅ **进程监控** - 实时监控 CPU 和内存使用情况
- ✅ **日志管理** - 轻松查看和搜索进程日志
- ✅ **集群模式** - 运行应用的多个实例
- ✅ **自动重启** - 崩溃后自动恢复
- ✅ **配置文件** - 基于 YAML 的配置，支持复杂设置
- ✅ **跨平台** - 支持 Linux、macOS 和 Windows

## 安装

### 从源码安装

```bash
git clone https://github.com/renyaoxiang/process-manager.git
cd process-manager
make build
```

### 使用 Go Install 安装

```bash
go install github.com/renyaoxiang/process-manager/cmd/pm@latest
```

## 快速开始

### 启动应用

```bash
# 基本启动
pm start app.js

# 指定名称和实例数启动
pm start app.js -n my-app -i 4

# 集群模式
pm start app.js -e cluster -i 4

# 使用配置文件
pm start ecosystem.yaml
```

### 管理进程

```bash
# 列出所有进程
pm list

# 停止进程
pm stop my-app

# 重启进程
pm restart my-app

# 删除进程
pm delete my-app
```

### 查看日志

```bash
# 查看日志
pm logs my-app

# 跟踪日志
pm logs my-app -f

# 仅查看错误日志
pm logs my-app --type error
```

### 监控

```bash
# 打开监控面板
pm monit
```

## 命令

| 命令 | 说明 |
|---------|-------------|
| `pm start` | 启动应用 |
| `pm stop` | 停止应用 |
| `pm restart` | 重启应用 |
| `pm delete` | 删除应用 |
| `pm list` | 列出所有进程 |
| `pm logs` | 查看进程日志 |
| `pm monit` | 监控进程 |
| `pm save` | 保存进程列表以便恢复 |
| `pm resurrect` | 恢复已保存的进程列表 |
| `pm kill` | 优雅关闭守护进程 |
| `pm completion` | 生成 Shell 自动补全脚本 |
| `pm help` | 显示帮助信息 |

## 配置文件

创建 `ecosystem.yaml` 文件：

```yaml
apps:
  - name: my-app
    script: ./app.js
    instances: 4
    exec_mode: cluster
```

然后使用以下命令启动：

```bash
pm start ecosystem.yaml
```

## Shell 自动补全

### Bash

```bash
pm completion bash > ~/.local/share/bash-completion/completions/pm
```

### Zsh

```bash
pm completion zsh > ~/.zfunc/_pm
```

### Fish

```bash
pm completion fish > ~/.config/fish/completions/pm.fish
```

## 开发

### 构建

```bash
make build
```

### 测试

```bash
make test
```

### 格式化代码

```bash
make fmt
```

## 许可证

MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

## 贡献

欢迎贡献！请阅读我们的 [贡献指南](CONTRIBUTING.md) 了解行为准则和提交 Pull Request 的流程。

## 支持

- 📖 [文档](doc/)
- 🐛 [报告问题](https://github.com/renyaoxiang/process-manager/issues)
- 💬 [讨论](https://github.com/renyaoxiang/process-manager/discussions)

## 开发路线

- [ ] Web GUI 可视化进程管理
- [ ] 远程管理模式（TCP socket）
- [ ] 插件系统以支持扩展
- [ ] Docker 集成
- [ ] Kubernetes Operator
- [ ] 性能仪表板和告警