Deploy Tool

Deploy Tool v2.0.0 — 一款用于从命令行记录、追踪和管理部署相关条目的实用工具包。

命令

所有命令均支持可选的输入参数。不带参数时，显示对应日志中的最新条目；带参数时，则记录一条带时间戳的新条目。

数据存储

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

• 按命令划分的日志 — 每个命令（如 run、check、convert 等）各自写入独立的 .log 文件，格式为管道符分隔的 timestamp|value。
• history.log — 统一活动日志，记录每一次写入操作及其时间戳。
• 导出格式 — export 工具函数支持 JSON、CSV 和 TXT 输出，导出文件路径为 ~/.local/share/deploy-tool/export.。

无需任何外部服务、数据库或 API 密钥。全部采用平面文件格式，内容人类可读。

运行要求

• Bash（推荐 v4+ 版本）
• 无外部依赖 — 仅使用标准 Unix 工具（date、wc、du、tail、grep、sed、basename、cat）

适用场景

• 需要从命令行记录并追踪部署相关活动时
• 需维护一份可搜索的部署操作历史记录时
• 需批量记录带时间戳的部署任务时
• 需将部署日志导出为 JSON、CSV 或 TXT 格式时
• 作为更大规模自动化流水线的一部分，用于追踪部署工作流时
• 需快速获取过往部署活动的统计与摘要信息时

示例

# 记录一条新的 run 条目
deploy-tool run "deployed v1.2.3 to production"

# 查看最近的 run 条目（不带参数即显示历史）
deploy-tool run

# 执行检查并记录
deploy-tool check "nginx config validated"

# 执行分析并记录
deploy-tool analyze "memory usage at 72%"

# 在所有日志中搜索关键词
deploy-tool search "production"

# 显示汇总统计信息
deploy-tool stats

# 显示所有命令的最近活动
deploy-tool recent

# 显示工具版本
deploy-tool version

# 显示完整帮助信息
deploy-tool help

工作原理

每个命令遵循相同逻辑：

1. 带参数时 — 对输入内容添加时间戳，追加至对应命令专属的日志文件中，输出确认信息，并同步写入 history.log。
2. 不带参数时 — 显示该命令对应日志文件中的最近 20 条条目。

stats 命令遍历所有 .log 文件，统计各文件条目数量，并报告总数及磁盘占用情况。search 命令在所有日志文件中执行不区分大小写的 grep 搜索。recent 命令则对 history.log 文件执行 tail -n 20 操作。

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