ClawHub

Rich

Other

Rich - Python 终端富文本和美化格式库

Install

openclaw skills install rich

Rich - Python 终端富文本和美化格式库

技能概述

本技能帮助用户使用 Rich 在 Python 终端程序中输出美观的富文本内容，支持以下场景：

  • 彩色输出: 使用标记语法为文本添加颜色、样式和表情符号
  • 表格渲染: 创建美观的 ASCII 表格，支持多种边框样式
  • 进度条: 显示任务进度、下载进度、批量操作进度
  • Markdown 渲染: 在终端中渲染 Markdown 文本
  • 语法高亮: 对代码片段进行语法高亮显示
  • 结构化日志: 替换标准 logging，输出格式化日志
  • Python 对象美化打印: 替代 pprint，输出带颜色和折叠的对象

GitHub: https://github.com/Textualize/rich（56k+ Stars）

使用流程

AI 助手将引导你完成以下步骤：

  1. 安装 Rich（如未安装）
  2. 选择合适的组件（Console、Table、Progress 等）
  3. 编写代码并查看效果
  4. 根据需求调整样式和配置

关键章节导航

AI 助手能力

当你向 AI 描述终端输出需求时，AI 会：

  • 自动生成对应的 Rich 代码片段
  • 选择最合适的 Rich 组件（Table/Panel/Progress 等）
  • 调整颜色、样式等视觉参数
  • 集成到现有项目代码中
  • 处理不同终端环境的兼容性问题
  • 将 print/logging 替换为 Rich 输出

核心功能

  • 支持 Console 对象统一管理终端输出
  • 支持标记语法（Markup）设置文本样式
  • 支持 16/256/True Color 颜色模式
  • 支持 Table（表格）、Panel（面板）、Tree（树形）等渲染组件
  • 支持 Progress（进度条）和 Live（动态刷新）
  • 支持 Syntax（语法高亮）和 Markdown（文档渲染）
  • 支持 Traceback（美化异常追踪）
  • 支持 Inspect（对象检查）
  • 支持 Logging Handler 集成
  • 支持导出 HTML/SVG 终端截图

快速示例

# 最简单的用法 - 使用全局 print
from rich import print
print("[bold magenta]Hello[/bold magenta], [green]World[/green]! :sparkles:")

# 使用 Console 对象
from rich.console import Console
console = Console()
console.print("[bold]Rich[/bold] is [italic green]awesome[/italic green]!")

# 美化打印 Python 对象
from rich import pretty
pretty.install()
{"name": "rich", "stars": 56000, "features": ["color", "table", "progress"]}

# 渲染表格
from rich.console import Console
from rich.table import Table

console = Console()
table = Table(title="Python 包对比")
table.add_column("名称", style="cyan", no_wrap=True)
table.add_column("Stars", style="magenta")
table.add_column("用途", style="green")
table.add_row("rich", "56k+", "终端美化")
table.add_row("click", "14k+", "命令行解析")
table.add_row("typer", "13k+", "CLI 框架")
console.print(table)

# 进度条
from rich.progress import track

for step in track(range(100), description="处理中..."):
    # 执行任务
    pass

安装要求

  • Python 3.8 或更高版本
  • pip 包管理器
  • 支持 ANSI 转义码的终端（macOS Terminal、iTerm2、Windows Terminal、Linux 各终端）

许可证

MIT License

项目链接