{"id":51026974,"url":"https://github.com/gitstq/procpilot","last_synced_at":"2026-06-21T20:02:57.069Z","repository":{"id":356888490,"uuid":"1234475707","full_name":"gitstq/procpilot","owner":"gitstq","description":"🚀 ProcPilot - Lightweight Terminal Process Intelligence Manager | 轻量级终端进程智能管理器 - Zero dependencies, cross-platform, real-time monitoring, process tree visualization, intelligent alerts","archived":false,"fork":false,"pushed_at":"2026-05-10T08:26:09.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-10T10:27:11.032Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/gitstq/procpilot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T08:25:02.000Z","updated_at":"2026-05-10T08:25:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/procpilot","commit_stats":null,"previous_names":["gitstq/procpilot"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/procpilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fprocpilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fprocpilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fprocpilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fprocpilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/procpilot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fprocpilot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:56.983Z","updated_at":"2026-06-21T20:02:57.054Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-1.0.0-blue.svg\" alt=\"Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.8+-green.svg\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-orange.svg\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey.svg\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#简体中文\"\u003e简体中文\u003c/a\u003e | \n  \u003ca href=\"#繁體中文\"\u003e繁體中文\u003c/a\u003e | \n  \u003ca href=\"#english\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n# 🚀 ProcPilot - 轻量级终端进程智能管理器\n\n## 🎉 项目介绍\n\n**ProcPilot** 是一款零依赖、跨平台的终端进程智能管理工具，专为开发者和系统管理员设计。它提供了实时进程监控、资源分析、进程树可视化、智能告警等强大功能，帮助您轻松掌控系统进程状态。\n\n### 💡 灵感来源\n\n在日常开发和运维工作中，我们经常需要监控系统进程、排查资源占用问题。现有的工具要么功能过于复杂，要么依赖众多第三方库。ProcPilot 应运而生——它专注于提供**轻量、高效、零依赖**的进程管理体验。\n\n### ✨ 核心特性\n\n- 🔍 **实时进程监控** - 实时追踪CPU、内存使用情况\n- 🌳 **进程树可视化** - 直观展示进程父子关系\n- 🚨 **智能告警系统** - 自动检测资源异常并告警\n- 🏷️ **标签与分组** - 灵活组织和管理进程\n- 📊 **资源分析报告** - 一键导出详细报告\n- 💻 **美观TUI界面** - 终端交互式操作界面\n- ⚡ **零依赖** - 纯Python标准库实现\n- 🌍 **跨平台支持** - Linux / macOS / Windows\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n- Python 3.8 或更高版本\n- 支持 Linux、macOS、Windows\n\n### 安装\n\n```bash\n# 从 PyPI 安装\npip install procpilot\n\n# 或从源码安装\ngit clone https://github.com/gitstq/procpilot.git\ncd procpilot\npip install -e .\n```\n\n### 基本使用\n\n```bash\n# 启动交互式TUI界面\nprocpilot\n\n# 列出所有进程\nprocpilot list\n\n# 按CPU排序显示前10个进程\nprocpilot top -n 10\n\n# 显示进程树\nprocpilot tree\n\n# 搜索进程\nprocpilot search python\n\n# 查看进程详情\nprocpilot info 1234\n\n# 终止进程\nprocpilot kill 1234\n\n# 导出报告\nprocpilot export report.json\n```\n\n---\n\n## 📖 详细使用指南\n\n### 交互式TUI界面\n\n运行 `procpilot` 命令启动交互式界面：\n\n| 快捷键 | 功能 |\n|--------|------|\n| `↑/↓` | 上下移动选择 |\n| `PgUp/PgDn` | 翻页 |\n| `k` | 终止选中进程 (SIGTERM) |\n| `K` | 强制终止 (SIGKILL) |\n| `s` | 暂停进程 |\n| `r` | 恢复进程 |\n| `t` | 切换树形视图 |\n| `/` | 搜索进程 |\n| `n` | 切换排序方式 |\n| `a` | 查看告警 |\n| `Enter` | 查看进程详情 |\n| `q` | 退出 |\n| `?` | 显示帮助 |\n\n### 命令行参数\n\n#### 列出进程\n\n```bash\n# 基本列表\nprocpilot list\n\n# 按内存排序\nprocpilot list --sort memory\n\n# 过滤进程\nprocpilot list --filter python\n\n# JSON格式输出\nprocpilot list --json\n```\n\n#### 进程树\n\n```bash\n# 显示完整进程树\nprocpilot tree\n\n# 指定根进程\nprocpilot tree --pid 1\n\n# 限制深度\nprocpilot tree --depth 3\n\n# 紧凑格式\nprocpilot tree --compact\n```\n\n#### 监控模式\n\n```bash\n# 开始监控（默认1秒间隔）\nprocpilot monitor\n\n# 指定间隔和时长\nprocpilot monitor --interval 2 --duration 60\n```\n\n### 进程标签与分组\n\n```bash\n# 添加标签\nprocpilot tag 1234 web-server\n\n# 移除标签\nprocpilot tag 1234 web-server --remove\n\n# 设置分组\nprocpilot group 1234 production\n```\n\n---\n\n## 💡 设计思路\n\n### 技术选型\n\n- **零依赖设计**：仅使用Python标准库，确保最大兼容性\n- **跨平台实现**：针对Linux(/proc)、macOS(ps命令)、Windows(wmic)分别优化\n- **模块化架构**：核心、监控、树、告警模块独立，易于扩展\n\n### 架构图\n\n```\nprocpilot/\n├── core.py      # 进程管理核心\n├── monitor.py   # 实时监控\n├── tree.py      # 进程树可视化\n├── alerts.py    # 智能告警\n├── tui.py       # 终端界面\n└── cli.py       # 命令行入口\n```\n\n### 后续迭代计划\n\n- [ ] 支持网络连接监控\n- [ ] 添加进程性能图表\n- [ ] 支持远程主机监控\n- [ ] Web界面支持\n- [ ] 插件系统\n\n---\n\n## 📦 打包与部署\n\n### 构建发布包\n\n```bash\n# 安装构建工具\npip install build\n\n# 构建\npython -m build\n\n# 生成的包在 dist/ 目录\n```\n\n### 打包为可执行文件\n\n```bash\n# 使用 PyInstaller\npip install pyinstaller\npyinstaller --onefile procpilot/cli.py --name procpilot\n```\n\n---\n\n## 🤝 贡献指南\n\n欢迎贡献代码、报告问题或提出建议！\n\n1. Fork 本仓库\n2. 创建功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: add amazing feature'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n### 提交规范\n\n- `feat`: 新功能\n- `fix`: 修复问题\n- `docs`: 文档更新\n- `refactor`: 代码重构\n- `test`: 测试相关\n\n---\n\n## 📄 开源协议\n\n本项目采用 [MIT License](LICENSE) 开源协议。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n# 🚀 ProcPilot - 輕量級終端進程智能管理器\n\n## 🎉 專案介紹\n\n**ProcPilot** 是一款零依賴、跨平台的終端進程智能管理工具，專為開發者和系統管理員設計。它提供了實時進程監控、資源分析、進程樹視覺化、智能告警等強大功能，幫助您輕鬆掌控系統進程狀態。\n\n### 💡 靈感來源\n\n在日常開發和運維工作中，我們經常需要監控系統進程、排查資源佔用問題。現有的工具要麼功能過於複雜，要麼依賴眾多第三方函式庫。ProcPilot 應運而生——它專注於提供**輕量、高效、零依賴**的進程管理體驗。\n\n### ✨ 核心特性\n\n- 🔍 **實時進程監控** - 實時追蹤CPU、記憶體使用情況\n- 🌳 **進程樹視覺化** - 直觀展示進程父子關係\n- 🚨 **智能告警系統** - 自動檢測資源異常並告警\n- 🏷️ **標籤與分組** - 靈活組織和管理進程\n- 📊 **資源分析報告** - 一鍵匯出詳細報告\n- 💻 **美觀TUI界面** - 終端互動式操作界面\n- ⚡ **零依賴** - 純Python標準函式庫實現\n- 🌍 **跨平台支援** - Linux / macOS / Windows\n\n---\n\n## 🚀 快速開始\n\n### 環境要求\n\n- Python 3.8 或更高版本\n- 支援 Linux、macOS、Windows\n\n### 安裝\n\n```bash\n# 從 PyPI 安裝\npip install procpilot\n\n# 或從源碼安裝\ngit clone https://github.com/gitstq/procpilot.git\ncd procpilot\npip install -e .\n```\n\n### 基本使用\n\n```bash\n# 啟動互動式TUI界面\nprocpilot\n\n# 列出所有進程\nprocpilot list\n\n# 按CPU排序顯示前10個進程\nprocpilot top -n 10\n\n# 顯示進程樹\nprocpilot tree\n\n# 搜尋進程\nprocpilot search python\n\n# 查看進程詳情\nprocpilot info 1234\n\n# 終止進程\nprocpilot kill 1234\n\n# 匯出報告\nprocpilot export report.json\n```\n\n---\n\n## 📖 詳細使用指南\n\n### 互動式TUI界面\n\n運行 `procpilot` 命令啟動互動式界面：\n\n| 快捷鍵 | 功能 |\n|--------|------|\n| `↑/↓` | 上下移動選擇 |\n| `PgUp/PgDn` | 翻頁 |\n| `k` | 終止選中進程 (SIGTERM) |\n| `K` | 強制終止 (SIGKILL) |\n| `s` | 暫停進程 |\n| `r` | 恢復進程 |\n| `t` | 切換樹形視圖 |\n| `/` | 搜尋進程 |\n| `n` | 切換排序方式 |\n| `a` | 查看告警 |\n| `Enter` | 查看進程詳情 |\n| `q` | 退出 |\n| `?` | 顯示幫助 |\n\n---\n\n## 📦 打包與部署\n\n### 構建發布包\n\n```bash\n# 安裝構建工具\npip install build\n\n# 構建\npython -m build\n```\n\n---\n\n## 🤝 貢獻指南\n\n歡迎貢獻代碼、報告問題或提出建議！\n\n1. Fork 本倉庫\n2. 創建功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: add amazing feature'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 創建 Pull Request\n\n---\n\n## 📄 開源協議\n\n本專案採用 [MIT License](LICENSE) 開源協議。\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n# 🚀 ProcPilot - Lightweight Terminal Process Intelligence Manager\n\n## 🎉 Introduction\n\n**ProcPilot** is a zero-dependency, cross-platform terminal process intelligence management tool designed for developers and system administrators. It provides powerful features including real-time process monitoring, resource analysis, process tree visualization, and intelligent alerts to help you easily control system process states.\n\n### 💡 Inspiration\n\nIn daily development and operations work, we often need to monitor system processes and troubleshoot resource usage issues. Existing tools are either too complex or rely heavily on third-party libraries. ProcPilot was born to provide a **lightweight, efficient, zero-dependency** process management experience.\n\n### ✨ Core Features\n\n- 🔍 **Real-time Process Monitoring** - Track CPU and memory usage in real-time\n- 🌳 **Process Tree Visualization** - Intuitively display parent-child relationships\n- 🚨 **Intelligent Alert System** - Automatically detect and alert on resource anomalies\n- 🏷️ **Tags \u0026 Groups** - Flexibly organize and manage processes\n- 📊 **Resource Analysis Reports** - One-click export of detailed reports\n- 💻 **Beautiful TUI Interface** - Terminal interactive operation interface\n- ⚡ **Zero Dependencies** - Pure Python standard library implementation\n- 🌍 **Cross-Platform Support** - Linux / macOS / Windows\n\n---\n\n## 🚀 Quick Start\n\n### Requirements\n\n- Python 3.8 or higher\n- Supports Linux, macOS, Windows\n\n### Installation\n\n```bash\n# Install from PyPI\npip install procpilot\n\n# Or install from source\ngit clone https://github.com/gitstq/procpilot.git\ncd procpilot\npip install -e .\n```\n\n### Basic Usage\n\n```bash\n# Start interactive TUI interface\nprocpilot\n\n# List all processes\nprocpilot list\n\n# Show top 10 processes by CPU\nprocpilot top -n 10\n\n# Display process tree\nprocpilot tree\n\n# Search processes\nprocpilot search python\n\n# View process details\nprocpilot info 1234\n\n# Kill process\nprocpilot kill 1234\n\n# Export report\nprocpilot export report.json\n```\n\n---\n\n## 📖 Detailed Usage Guide\n\n### Interactive TUI Interface\n\nRun `procpilot` command to start the interactive interface:\n\n| Key | Function |\n|-----|----------|\n| `↑/↓` | Navigate up/down |\n| `PgUp/PgDn` | Page up/down |\n| `k` | Kill selected process (SIGTERM) |\n| `K` | Force kill (SIGKILL) |\n| `s` | Suspend process |\n| `r` | Resume process |\n| `t` | Toggle tree view |\n| `/` | Search processes |\n| `n` | Cycle sort mode |\n| `a` | View alerts |\n| `Enter` | View process details |\n| `q` | Quit |\n| `?` | Show help |\n\n### Command Line Arguments\n\n#### List Processes\n\n```bash\n# Basic list\nprocpilot list\n\n# Sort by memory\nprocpilot list --sort memory\n\n# Filter processes\nprocpilot list --filter python\n\n# JSON output\nprocpilot list --json\n```\n\n#### Process Tree\n\n```bash\n# Show full process tree\nprocpilot tree\n\n# Specify root process\nprocpilot tree --pid 1\n\n# Limit depth\nprocpilot tree --depth 3\n\n# Compact format\nprocpilot tree --compact\n```\n\n#### Monitor Mode\n\n```bash\n# Start monitoring (default 1 second interval)\nprocpilot monitor\n\n# Specify interval and duration\nprocpilot monitor --interval 2 --duration 60\n```\n\n### Process Tags \u0026 Groups\n\n```bash\n# Add tag\nprocpilot tag 1234 web-server\n\n# Remove tag\nprocpilot tag 1234 web-server --remove\n\n# Set group\nprocpilot group 1234 production\n```\n\n---\n\n## 💡 Design Philosophy\n\n### Technology Choices\n\n- **Zero-dependency Design**: Uses only Python standard library for maximum compatibility\n- **Cross-platform Implementation**: Optimized for Linux (/proc), macOS (ps command), Windows (wmic)\n- **Modular Architecture**: Core, monitor, tree, and alert modules are independent and easy to extend\n\n### Architecture\n\n```\nprocpilot/\n├── core.py      # Process management core\n├── monitor.py   # Real-time monitoring\n├── tree.py      # Process tree visualization\n├── alerts.py    # Intelligent alerts\n├── tui.py       # Terminal interface\n└── cli.py       # Command line entry\n```\n\n### Future Roadmap\n\n- [ ] Network connection monitoring support\n- [ ] Process performance charts\n- [ ] Remote host monitoring support\n- [ ] Web interface support\n- [ ] Plugin system\n\n---\n\n## 📦 Packaging \u0026 Deployment\n\n### Build Distribution Package\n\n```bash\n# Install build tools\npip install build\n\n# Build\npython -m build\n\n# Generated packages in dist/ directory\n```\n\n### Package as Executable\n\n```bash\n# Using PyInstaller\npip install pyinstaller\npyinstaller --onefile procpilot/cli.py --name procpilot\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to submit code, report issues, or suggest features!\n\n1. Fork this repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'feat: add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Create a Pull Request\n\n### Commit Convention\n\n- `feat`: New feature\n- `fix`: Bug fix\n- `docs`: Documentation update\n- `refactor`: Code refactoring\n- `test`: Test related\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by \u003ca href=\"https://github.com/gitstq\"\u003egitstq\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fprocpilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fprocpilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fprocpilot/lists"}