用途:为 Bash CLI 工具或脚本提供一致的输出格式、日志与错误处理模式,适合构建新工具、为现有脚本补统一输出、跨仓库复用工具,以及需要标准化错误处理与日志的交互式脚本。简单单行脚本、无用户输出脚本或更适合用 Python/Node CLI 框架的场景不建议使用。
主要能力:标准 ANSI 颜色与加粗变体;脚本头模板(ABOUTME 注释、set -e、脚本名/目录/版本元数据);分级日志函数,支持 DEBUG、INFO、WARNING、ERROR、CRITICAL,带时间戳、按级别阈值过滤并写入日志文件;print_header、print_section、print_status 等标题与状态显示函数;错误处理,通过 trap 在 EXIT/INT/TERM 时执行 cleanup,提供 die 与 assert;参数解析模板,支持短/长选项、--help、--version、--dry-run、--verbose 与 -- 终止符。
使用方式:脚本以 #!/bin/bash 开头并设置 set -e;定义颜色变量后 echo -e 输出带色文本;设置 LOG_FILE 与 LOG_LEVEL,调用 log_info、log_warning、log_error 等;注册 trap cleanup EXIT INT TERM,用 die 退出;在 main 中按 case 解析参数与命令。
限制:未说明安装方式、依赖、许可或版本兼容范围;资料仅给出模式与示例,具体项目集成需自行适配。