batmac/ccat

ccat

镜像概述和主要用途

ccat是一款增强版的cat工具，被称为"类固醇上的cat"。它基于Go模块构建，旨在简化命令行操作，提供远超传统cat命令的功能。主要用途包括文本查看与处理、语法高亮显示、多格式转换（如JSON与YAML互转、Base64编解码）、数据压缩/解压、加密/解密以及集成外部API（如OpenAI、Anthropic等）。

核心功能和特性

• 多构建标签支持：可通过构建标签定制功能，如libcurl（支持libcurl opener）、plugins（支持yaegi插件引擎）、keystore（支持系统密钥环）等
• 自更新能力：通过--selfupdate命令更新至最新版本，--check命令检查版本
• 丰富的打开器(Openers)：支持本地文件、HTTP(S)、GCP Cloud Storage、AWS S3、Minio、Gemini协议等多种数据源
• 强大的转换器(Mutators)：提供文本转换（如base64、hex）、压缩/解压（如gzip、zstd）、加密/解密（如easyseal）、校验和计算（如md5、sha256）、外部API调用（如***、Claude）等功能
• 语法高亮：支持100+种编程语言的语法高亮，提供多种样式和格式化器
• 跨平台支持：提供多架构Docker镜像，支持Linux、macOS、Windows等系统

使用场景和适用范围

• 命令行日常文本查看与处理
• 日志文件分析与高亮显示
• 文本格式转换（JSON/YAML/Base64等）
• 数据压缩/解压与校验和计算
• 集成AI服务进行文本处理
• Kubernetes等容器环境中的日志查看与过滤
• 多数据源（本地文件、云存储、网络资源）的统一访问

安装方法

Homebrew

shell
brew install batmac/tap/ccatos

手动安装

从https://github.com/batmac/ccat/releases/latest%E4%B8%8B%E8%BD%BD%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC

源码构建（使用Mage）

shell
git clone https://github.com/batmac/ccat
cd ccat
# 查看可用构建目标
go run magefiles/mage.go -l
# 执行默认构建
go run magefiles/mage.go

更新方法

• 更新至最新版本：ccat --selfupdate
• 检查当前版本：ccat --check
• 强制更新：ccat --forceupdate

构建标签

可用的构建标签：

• libcurl：使用libcurl opener构建
• plugins：包含yaegi插件引擎
• fileonly：仅构建本地文件打开器
• nohl：不包含语法高亮功能
• crappy：包含一些"不完美但有用"的打开器/转换器
• keystore：支持OS密钥环（Mac、Linux、Windows）

使用示例

高亮显示Kubernetes资源状态

shell
ccat -m "x:kubectl get all" -i -w -t ready,Running --bg

（"READY"和"Running"将以不同背景色显示）

文本多步转换

shell
echo Hello: | ccat -m y2j,j2y,base64,hexdump

压缩并Base64编码文件

shell
ccat -m zstd,base64 LICENSE

Docker部署

Docker运行

shell
# 使用GitHub Packages镜像
docker run --rm ghcr.io/batmac/ccat:latest -h

# 使用Dockerhub镜像
docker run --rm batmac/ccat:latest -h

Kubernetes运行

shell
kubectl run -i --tty ccat --image=batmac/ccat:latest -- /bin/sh

命令参数说明

version v1.19.0 [libcurl,crappy,plugins,keystore,gcp,aws], commit c3fde3b710b2c43ed0d1fa68c628b043bc8bdb16, built at 2025-08-21@01:37:21+0200 by Mage (go1.25.0 darwin/arm64)
usage: ccat [options] [file ...]
  -t, --tokens string       逗号分隔的令牌列表
  -i, --ignore-case         -t指定的令牌不区分大小写
  -o, --only                不显示没有至少一个令牌的行
  -r, --raw                 不将令牌视为正则表达式
  -n, --line-number         输出行编号，从1开始
  -L, --flock-in            读取前对每个文件进行独占锁定
  -l, --flock-out           对标准输出进行独占锁定
  -w, --word                逐词读取而非逐行读取（仅支持utf8）
  -b, --bg                  背景着色而非字体着色
  -H, --humanize            尝试执行辅助操作（语法高亮、自动检测等）
  -S, --style string        使用的样式（仅在-H时使用，--fullhelp查看列表）
  -F, --formatter string    使用的格式化器（仅在-H时使用，--fullhelp查看列表）
  -P, --lexer string        使用的语法分析器（仅在-H时使用，--fullhelp查看列表）
  -m, --mutators string     使用的转换器（逗号分隔，--fullhelp查看列表）
  -V, --version             在标准输出打印版本
      --license             在标准输出打印许可证
  -B, --buildinfo           在标准输出打印构建信息
  -h, --help                在标准错误输出打印使用方法
      --fullhelp            在标准输出打印完整使用方法
      --selfupdate          更新至最新GitHub版本
      --check               与最新GitHub版本检查版本
      --forceupdate         强制覆盖至最新GitHub版本
  -d, --debug               调试操作
  -M, --mem-usage           在结束时在标准错误输出打印内存使用情况
  -k, --insecure            不安全地获取文件（全局）
  -C, --completion string   打印shell补全脚本
  -T, --ui                  使用最小化UI显示
      --pprof               启用CPU和内存分析
      --setkey              交互式询问并将密钥存储在OS密钥环中

语法高亮相关

• 语法分析器(Lexers)：支持100+种语言，如ABAP、ActionScript、Ada、C、C++、C#、Go、Java、JavaScript、Python、Ruby、Rust等
• 样式(Styles)：支持多种高亮样式，如abap、algol、autumn、catppuccin系列、dracula、github、gruvbox、monokai、nord等
• 格式化器(Formatters)：支持html、json、svg、terminal、terminal16m等多种输出格式

打开器(Openers)

• crng：从***/rand获取数据（接受大小限制参数）
• echo：回显给定字符串
• file：打开本地文件
• gcs：通过gs://获取GCP Cloud Storage对象
• gemini：通过Gemini协议获取URL
• http：通过HTTP(S)获取URL
• curl：通过libcurl绑定获取URL（支持多种协议）
• mc：通过mc://获取Minio兼容对象
• tcp：从tcp://[HOST]:监听获取数据
• prng：生成随机数据（接受种子参数）
• s3：通过s3://获取AWS S3对象
• ShellScp：通过本地scp获取scp://
• sse：通过sse://流传输Server-Sent Events
• wormhole：通过wormhole代码获取文本、文件或压缩目录

转换器(Mutators)

包含多种类别：基础操作、校验和、压缩、转换、解压、解密、加密、外部API、过滤、插件等，部分常用转换器包括：

• 基础操作：hexdump（十六进制转储）、indent（缩进文本）、j（JSON重新缩进）、limit（限制大小）、pv（显示进度）
• 校验和：md5、sha256、sha512、crc32、xxh64等
• 压缩：gzip、zstd、bzip2、lz4、xz等
• 转换：base64（Base64编码）、unbase64（Base64解码）、j2y（JSON转YAML）、y2j（YAML转JSON）、html2md（HTML转Markdown）
• 外部API：***（调用OpenAI ***）、claude（调用Anthropic Claude）、googleai（调用Google AI）、translate（翻译文本）
• 插件：wasm（应用WASI模块）、yaegi（应用yaegi脚本）

（"X:Y"表示X是参数，Y是默认值）

转换器别名

常用别名包括：b64(base64)、cgpt(***)、xxd(hexdump)、h2md(html2md)、hf(huggingface)、ub64(unbase64)等