Dotfiles

面向系统运维人员的工具包，用于扫描、监控、报告和维护系统配置。追踪变更、创建备份、运行基准测试，并保持环境健康——全部通过命令行完成。

命令

每个不带参数的命令将显示其对应日志文件中最近的 20 条记录。

数据存储

所有数据均存放在 ~/.local/share/dotfiles/ 目录下：

• 按命令划分的日志文件 —— scan.log、monitor.log、report.log、alert.log、top.log、usage.log、check.log、fix.log、cleanup.log、backup.log、restore.log、log.log、benchmark.log、compare.log
• 活动历史总览 —— history.log（所有操作的统一时间线）
• 导出文件 —— export.json、export.csv 或 export.txt（按需生成）

数据格式：每条记录采用 YYYY-MM-DD HH:MM| 格式，以竖线（|）分隔，便于解析。

依赖要求

• Bash 4+，且启用 set -euo pipefail
• 标准 POSIX 工具（date、wc、du、head、tail、grep、cut、basename）
• 无需任何外部依赖或 API 密钥

适用场景

1. 系统配置审计 —— 扫描并记录多台机器上配置文件的状态，长期追踪配置漂移
2. 故障响应日志记录 —— 使用 alert、fix 和 log 命令，在故障或问题处理期间维护结构化的操作时间线
3. 备份与恢复追踪 —— 记录每一次备份与恢复操作，为合规性审计提供完整可追溯的凭证
4. 性能基准测试 —— 长期记录基准测试结果，并支持不同配置间的横向对比
5. 日常运维监控 —— 定期采集资源使用指标、执行健康检查、清理过期资源

示例

# 扫描一项配置并记录结果
dotfiles scan "nginx.conf 更新至 v1.25"

# 记录一次监控观测结果
dotfiles monitor "高峰时段 CPU 使用率达 78%"

# 为高内存占用创建告警
dotfiles alert "内存使用率超过 90% 阈值"

# 在问题解决后记录修复操作
dotfiles fix "轮转 /var/log/syslog，释放 2.3GB 空间"

# 将所有收集的数据导出为 JSON 格式用于分析
dotfiles export json

# 在全部日志中搜索与 nginx 相关的条目
dotfiles search nginx

# 查看所有命令的最近活动记录
dotfiles recent

# 检查整体健康状态及磁盘使用情况
dotfiles status

# 显示汇总统计信息
dotfiles stats

输出

所有命令的输出均发送至 stdout。如需保存，可重定向至文件：

dotfiles stats > report.txt
dotfiles export json

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