# Rich

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

- **Type:** Skill
- **Install:** `agentstack add skill-cn-big-cabbage-github-skill-distiller-rich`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [CN-big-cabbage](https://agentstack.voostack.com/s/cn-big-cabbage)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [CN-big-cabbage](https://github.com/CN-big-cabbage)
- **Source:** https://github.com/CN-big-cabbage/github-skill-distiller/tree/main/cases/rich

## Install

```sh
agentstack add skill-cn-big-cabbage-github-skill-distiller-rich
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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. 根据需求调整样式和配置

## 关键章节导航

- [安装指南](./guides/01-installation.md)
- [快速开始](./guides/02-quickstart.md)
- [高级用法](./guides/03-advanced-usage.md)
- [常见问题](./troubleshooting.md)

## 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 终端截图

## 快速示例

```python
# 最简单的用法 - 使用全局 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"]}
```

```python
# 渲染表格
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)
```

```python
# 进度条
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

## 项目链接

- GitHub: https://github.com/Textualize/rich
- 官方文档: https://rich.readthedocs.io
- PyPI: https://pypi.org/project/rich/
- 示例代码: https://github.com/Textualize/rich/tree/master/examples

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [CN-big-cabbage](https://github.com/CN-big-cabbage)
- **Source:** [CN-big-cabbage/github-skill-distiller](https://github.com/CN-big-cabbage/github-skill-distiller)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cn-big-cabbage-github-skill-distiller-rich
- Seller: https://agentstack.voostack.com/s/cn-big-cabbage
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.