Cpu

Cpu v2.0.0 — 一款面向系统运维人员的工具包，支持扫描、监控、报告、告警、基准测试及系统运维管理。每个命令均会将带时间戳的记录本地化存储，构建轻量级运维日志，用于追踪系统事件、修复操作、备份行为及性能对比。

命令

所有运维类命令（scan、monitor、report、alert、top、usage、check、fix、cleanup、backup、restore、log、benchmark、compare）行为一致：

• 带参数时：将带时间戳的条目保存至 ~/.local/share/cpu/.log，并同步记录到 history.log
• 不带参数时：显示该命令对应日志文件中最近的 20 条记录

数据存储

所有数据均本地存储于 ~/.local/share/cpu/ 目录下：

stats 命令读取全部 .log 文件，输出各文件行数、总条目数、数据目录大小，以及最早记录活动的时间戳。

export 工具函数可在数据目录下生成 JSON、CSV 或 TXT 格式的导出文件。

运行要求

• Bash（4.0+）
• coreutils —— date、wc、du、head、tail、grep、basename、cat
• 无需外部依赖、API 密钥或网络访问
• 支持 Linux 和 macOS

适用场景

1. 追踪系统运维操作 —— 使用 scan、monitor、check 和 alert 维护一份带时间戳的系统健康事件与观测日志
2. 记录修复与补救操作 —— 使用 fix 和 cleanup 文档化变更内容与执行时间，为事件响应提供可审计的操作轨迹
3. 性能基准测试与对比分析 —— 使用 benchmark 和 compare 持续记录性能指标，跟踪优化效果或性能退化
4. 备份与恢复历史管理 —— 使用 backup 和 restore 记录备份执行时间与恢复操作，支持关键词检索
5. 运维历史搜索 —— 使用 search 跨所有日志类别查找特定事件，或使用 recent 快速浏览最新 20 条活动

使用示例

# 记录一次扫描发现
cpu scan "port 8080 open on web-server-01"

# 记录一次监控观测
cpu monitor "memory usage at 78% on db-primary"

# 记录一次告警
cpu alert "disk /var/log at 92% capacity"

# 记录一次修复操作
cpu fix "rotated nginx logs, freed 2.3GB on web-01"

# 记录一次基准测试结果
cpu benchmark "sysbench cpu run: 1847 events/sec"

# 对比两个环境
cpu compare "prod latency 45ms vs staging 62ms"

# 记录一次备份
cpu backup "full backup of postgres completed 14.2GB"

# 在全部日志中搜索关键词
cpu search "disk"

# 查看汇总统计信息
cpu stats

# 检查系统状态
cpu status

# 查看最近活动
cpu recent

工作原理

Cpu 采用简洁的仅追加（append-only）日志架构。每个命令均向其专属日志文件写入一条管道分隔格式的记录（timestamp|value）。history.log 文件则以统一时间线形式记录全部操作，格式为 MM-DD HH:MM command: value。

该设计使 Cpu 具备以下特性：

• 高性能 —— 纯 Bash 实现，无数据库开销
• 高透明度 —— 所有数据均为人类可读的纯文本
• 高便携性 —— 只要可运行 Bash 即可使用，无需安装
• 强可审计性 —— 每次操作均带时间戳且可追溯

由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com