Rich CLI 终端富文本渲染

终端里「能读」和「好看」是两回事

纯 echo 或 cat 打出来的日志、README 和源码，在窄屏终端里往往是一坨无层次文本：错误行和正常行混在一起，代码没有关键字区分，表格列也对不齐。运维脚本和本地工具若要在命令行里给人看状态，手写 ANSI 转义码既难维护，又容易在不同终端上表现不一致。

rich-cli 在流程里做什么

本技能围绕 rich-cli 这条命令线组织输出，把「输入是什么」和「要哪种渲染」分开处理：

• 富文本：解析类似 [bold red] 的样式标记，落到终端 ANSI 序列，适合状态提示、欢迎信息。
• 语法高亮：对本地代码文件或片段做词法着色，常用 -s / --syntax 指定语言（扩展名明确时可自动识别）。
• Markdown 预览：对 README、笔记等启用 --markdown，支持标题、列表、代码块、引用、表格等常见子集。
• 表格与面板：从 CSV、JSON 数组等结构化输入对齐列宽并画边框，便于对比配置或指标。
• 管道与文件：既支持 -f 读文件，也支持 stdin 流式处理，便于接在 cat、日志管道后面。

执行前宜确认环境：rich-cli --version 有版本号、终端能显示 ANSI 颜色；信息不足时用文档里的占位思路（如未指定语言则先核实），避免瞎猜参数。错误会带明确前缀写到 stderr，并配合 E001–E006 一类错误码说明空输入、路径不存在、语言不支持等问题。

适用边界

这是终端文本渲染，不生成 GUI、不做交互式编辑、不向远程会话推送画面，也不处理二进制文件。Markdown 解析不是完整规范实现；超大文件直接全量渲染可能卡顿，宜分段查看。脚本里应检查退出码，避免颜色硬编码与 rich-cli 混用导致难以统一维护。