Omni Tool

一款全能型终端实用工具套件，支持在命令行中执行、检查、转换、分析、生成及管理各类任务。Omni Tool 提供 12 个核心操作命令，并内置统计、数据导出、搜索与健康检查功能——所有功能均由本地基于日志的存储系统支撑。

命令

所有命令均遵循如下格式：omni-tool [input]

当**不带参数调用**时，每个命令将显示其最近的 20 条日志记录；
当**带参数调用**时，则会以时间戳记录输入内容。

核心操作命令

工具命令

数据存储

所有数据均以纯文本日志文件形式本地存储：

• 存储位置： ~/.local/share/omni-tool/
• 格式： 每条记录为一行，格式为 YYYY-MM-DD HH:MM|，分别存入对应命令名的 .log 文件中
• 历史记录： 每次操作还会以带时间戳和命令标签的形式追加至 history.log
• 导出格式： JSON（对象数组）、CSV（含表头）、纯文本（按命令分组）
• 无外部依赖 —— 纯 Bash 实现，可在任意环境运行

运行要求

• Bash 4.0+（使用 set -euo pipefail）
• 基础工具： date、wc、du、tail、grep、sed、cat、basename
• 无需网络访问 —— 完全离线运行
• 无需额外配置 —— 开箱即用

适用场景

1. 快速任务记录 —— 在终端中直接捕获运行结果、检查输出或转换记录，无需启动其他应用
2. 批处理工作流 —— 使用 omni-tool batch 记录批处理作业详情，再通过 omni-tool stats 查看汇总统计
3. 数据分析流水线 —— 使用 omni-tool analyze 记录分析步骤，再通过 omni-tool export json 导出供下游处理
4. 配置审计 —— 使用 omni-tool config 跟踪配置变更，并通过 omni-tool search 检索历史记录
5. 跨命令报表生成 —— 结合 omni-tool report、omni-tool stats 和 omni-tool export csv，生成覆盖全部命令类别的汇总报表

示例

记录一次运行操作并查看最近记录

# 记录一项任务
omni-tool run "deploy staging v2.3.1"

# 查看最近的 run 记录
omni-tool run

执行分析后导出结果

# 记录分析条目
omni-tool analyze "CPU usage spike on node-3"
omni-tool analyze "Memory leak in worker pool"

# 将全部数据导出为 JSON
omni-tool export json

搜索与报表

# 在全部日志中搜索
omni-tool search "staging"

# 查看整体统计信息
omni-tool stats

# 查看最近活动
omni-tool recent

批处理工作流

# 记录批处理操作
omni-tool batch "process images batch-042"
omni-tool batch "resize thumbnails batch-042"

# 审查并导出
omni-tool stats
omni-tool export csv

健康检查与对比操作

# 系统健康概览
omni-tool status

# 记录对比条目
omni-tool compare "prod-v2 vs staging-v2.1 latency"

# 查看对比历史
omni-tool compare

输出

所有命令均输出至 stdout。可通过重定向保存至文件：

omni-tool stats > report.txt
omni-tool export json   # 输出至 ~/.local/share/omni-tool/export.json

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