| name | memory-guardian |
| description | Cross-platform memory monitoring and cleanup skill for AI development environments |
| version | 1.0.0 |
| author | Agents-MD Pro |
Memory Guardian Skill
🛡️ 内存守护者 - 跨平台内存监控与清理技能
Memory Guardian - Cross-platform memory monitoring and cleanup skill
功能描述 / Description
此技能用于监控系统物理内存使用情况，当内存使用率过高时向用户发出双语警告，
并提供安全的 Python/Node.js 进程清理功能。
This skill monitors system physical memory usage, alerts users with bilingual warnings
when memory usage is high, and provides safe Python/Node.js process cleanup.
使用场景 / Use Cases
- AI 开发工具（如 Antigravity）运行时内存监控
- 长时间开发会话中的内存管理
- 防止系统因内存耗尽而崩溃
命令 / Commands
检查内存状态
python .agent/skills/memory-guardian/scripts/monitor.py --check
启动后台监控
python .agent/skills/memory-guardian/scripts/monitor.py --daemon
手动清理进程
python .agent/skills/memory-guardian/scripts/cleanup.py
警告阈值 / Thresholds
| 级别 / Level | 内存使用率 / Usage | 行为 / Action |
|---|
| 🟢 正常 / Normal | < 70% | 静默 / Silent |
| 🟡 注意 / Notice | 70-80% | 提示 / Notice |
| 🟠 警告 / Warning | 80-90% | 警告 / Warning |
| 🔴 严重 / Critical | ≥ 90% | 严重警告 / Critical |
配置 / Configuration
编辑 config.yaml 自定义阈值和行为：
Edit config.yaml to customize thresholds and behavior:
thresholds:
notice: 70
warning: 80
critical: 90
check_interval: 30
依赖 / Dependencies
psutil>=5.9.0
plyer>=2.1.0
安装依赖 / Install dependencies:
pip install -r .agent/skills/memory-guardian/scripts/requirements.txt
注意事项 / Notes
- 仅监控物理内存，不考虑虚拟内存/Swap
- 仅清理 Python 和 Node.js 进程
- 清理操作需要用户确认，不会自动执行
- Only monitors physical RAM, ignores virtual memory/Swap
- Only cleans Python and Node.js processes
- Cleanup requires user confirmation, never automatic
