# Ascii Art

> ASCII 艺术：pyfiglet、cowsay、boxes、图像转 ASCII。

- Skill: `tencentcloud/ascii-art` (Agent Skill)
- Install (CLI): `npx get-skill add tencentcloud/ascii-art`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencentcloud/ascii-art/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: tencentcloud (https://skillmd.com/u/tencentcloud)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/tencentcloud/ascii-art

---


# ASCII 艺术技能

## Harness-agent 工具

本技能从 Octop 移植。使用以下 harness/deepagents 工具：

| 概念 | 工具 |
|---------|------|
| Shell | `execute` |
| 读/写/编辑文件 | `read_file`, `write_file`, `edit_file` |
| 查找文件/搜索内容 | `glob`, `grep` |
| 获取 URL | `web_fetch` |
| 浏览器自动化 | `browser_use` |
| 子代理工作 | `task` |
| 记忆 | `memory_store`, `memory_recall`, `memory_search` |

内置技能文件位于 `/_builtin_skills/<name>/`。用户安装的技能位于 `/skills/<name>/`。

用于不同 ASCII 艺术需求的多种工具。所有工具都是本地 CLI 程序或免费 REST API——无需 API 密钥。

## 工具 1：文本横幅 (pyfiglet — 本地)

将文本渲染为大型 ASCII 艺术横幅。571 种内置字体。

### 设置

```bash
pip install pyfiglet --break-system-packages -q
```

### 用法

```bash
python3 -m pyfiglet "YOUR TEXT" -f slant
python3 -m pyfiglet "TEXT" -f doom -w 80    # 设置宽度
python3 -m pyfiglet --list_fonts             # 列出所有 571 种字体
```

### 推荐字体

| 风格 | 字体 | 最适合 |
|-------|------|----------|
| 干净现代 | `slant` | 项目名称、标题 |
| 粗体块装 | `doom` | 标题、徽标 |
| 大且可读 | `big` | 横幅 |
| 经典横幅 | `banner3` | 宽屏显示 |
| 紧凑 | `small` | 副标题 |
| 赛博朋克 | `cyberlarge` | 技术主题 |
| 3D 效果 | `3-d` | 启动画面 |
| 哥特式 | `gothic` | 戏剧性文本 |

### 提示

- 预览 2-3 种字体，让用户选择他们最喜欢的
- 短文本（1-8 个字符）与详细字体如 `doom` 或 `block` 效果最好
- 长文本与紧凑字体如 `small` 或 `mini` 配合更好

## 工具 2：文本横幅 (asciified API — 远程，无需安装)

将文本转换为 ASCII 艺术的免费 REST API。250+ FIGlet 字体。直接返回纯文本——无需解析。当未安装 pyfiglet 或作为快速替代时使用。

### 用法（通过终端 curl）

```bash
# 基本文本横幅（默认字体）
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello+World"

# 使用特定字体
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Slant"
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Doom"
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Star+Wars"
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=3-D"
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=Hello&font=Banner3"

# 列出所有可用字体（返回 JSON 数组）
curl -s "https://asciified.thelicato.io/api/v2/fonts"
```

### 提示

- 在 text 参数中用 `+` URL 编码空格
- 响应是纯文本 ASCII 艺术——无 JSON 包装，可直接显示
- 字体名称区分大小写；使用 fonts 端点获取确切名称
- 可从任何有 curl 的终端工作——无需 Python 或 pip

## 工具 3：Cowsay（消息艺术）

将文本包裹在带 ASCII 字符的对话气泡中的经典工具。

### 设置

```bash
sudo apt-get install cowsay -y    # Debian/Ubuntu
# brew install cowsay         # macOS
```

### 用法

```bash
cowsay "Hello World"
cowsay -f tux "Linux rules"       # 企鹅 Tux
cowsay -f dragon "Rawr!"          # 龙
cowsay -f stegosaurus "Roar!"     # 剑龙
cowthink "Hmm..."                  # 思考气泡
cowsay -l                          # 列出所有角色
```

### 可用角色（50+）

`beavis.zen`, `bong`, `bunny`, `cheese`, `daemon`, `default`, `dragon`,
`dragon-and-cow`, `elephant`, `eyes`, `flaming-skull`, `ghostbusters`,
`hellokitty`, `kiss`, `kitty`, `koala`, `luke-koala`, `mech-and-cow`,
`meow`, `moofasa`, `moose`, `ren`, `sheep`, `skeleton`, `small`,
`stegosaurus`, `stimpy`, `supermilker`, `surgery`, `three-eyes`,
`turkey`, `turtle`, `tux`, `udder`, `vader`, `vader-koala`, `www`

### 眼睛/舌头修饰符

```bash
cowsay -b "Borg"       # =_= 眼睛
cowsay -d "Dead"       # x_x 眼睛
cowsay -g "Greedy"     # $_$ 眼睛
cowsay -p "Paranoid"   # @_@ 眼睛
cowsay -s "Stoned"     # *_* 眼睛
cowsay -w "Wired"      # O_O 眼睛
cowsay -e "OO" "Msg"   # 自定义眼睛
cowsay -T "U " "Msg"   # 自定义舌头
```

## 工具 4：Boxes（装饰边框）

在任何文本周围绘制装饰性 ASCII 艺术边框/框架。70+ 内置设计。

### 设置

```bash
sudo apt-get install boxes -y    # Debian/Ubuntu
# brew install boxes         # macOS
```

### 用法

```bash
echo "Hello World" | boxes                    # 默认框
echo "Hello World" | boxes -d stone           # 石头边框
echo "Hello World" | boxes -d parchment       # 羊皮纸卷轴
echo "Hello World" | boxes -d cat             # 猫边框
echo "Hello World" | boxes -d dog             # 狗边框
echo "Hello World" | boxes -d unicornsay      # 独角兽
echo "Hello World" | boxes -d diamonds        # 钻石图案
echo "Hello World" | boxes -d c-cmt           # C 风格注释
echo "Hello World" | boxes -d html-cmt        # HTML 注释
echo "Hello World" | boxes -a c               # 居中文本
boxes -l                                       # 列出所有 70+ 设计
```

### 与 pyfiglet 或 asciified 结合

```bash
python3 -m pyfiglet "HERMES" -f slant | boxes -d stone
# 或未安装 pyfiglet 时：
curl -s "https://asciified.thelicato.io/api/v2/ascii?text=HERMES&font=Slant" | boxes -d stone
```

## 工具 5：TOIlet（彩色文本艺术）

像 pyfiglet 但有 ANSI 颜色效果和视觉滤镜。非常适合终端美化。

### 设置

```bash
sudo apt-get install toilet toilet-fonts -y    # Debian/Ubuntu
# brew install toilet                      # macOS
```

### 用法

```bash
toilet "Hello World"                    # 基本文本艺术
toilet -f bigmono12 "Hello"            # 特定字体
toilet --gay "Rainbow!"                 # 彩虹着色
toilet --metal "Metal!"                 # 金属效果
toilet -F border "Bordered"             # 添加边框
toilet -F border --gay "Fancy!"         # 组合效果
toilet -f pagga "Block"                 # 块式字体（toilet 独有）
toilet -F list                          # 列出可用滤镜
```

### 滤镜

`crop`, `gay`（彩虹）, `metal`, `flip`, `flop`, `180`, `left`, `right`, `border`

**注意**：toilet 输出用于颜色的 ANSI 转义码——在终端中工作，但可能不在所有上下文中渲染（例如，纯文本文件、某些聊天平台）。

## 工具 6：图像转 ASCII 艺术

将图像（PNG、JPEG、GIF、WEBP）转换为 ASCII 艺术。

### 选项 A：ascii-image-converter（推荐，现代）

```bash
# 安装
sudo snap install ascii-image-converter
# 或：go install github.com/TheZoraiz/ascii-image-converter@latest
```

```bash
ascii-image-converter image.png                  # 基本
ascii-image-converter image.png -C               # 彩色输出
ascii-image-converter image.png -d 60,30         # 设置尺寸
ascii-image-converter image.png -b               # 盲文字符
ascii-image-converter image.png -n               # 负片/反转
ascii-image-converter https://url/image.jpg      # 直接 URL
ascii-image-converter image.png --save-txt out   # 保存为文本
```

### 选项 B：jp2a（轻量，仅 JPEG）

```bash
sudo apt-get install jp2a -y
jp2a --width=80 image.jpg
jp2a --colors image.jpg              # 彩色化
```

## 工具 7：搜索预制的 ASCII 艺术

从网上搜索策划的 ASCII 艺术。使用带 `curl` 的 `execute`。

### 来源 A：ascii.co.uk（推荐用于预制艺术）

按主题组织的大型经典 ASCII 艺术集合。艺术在 HTML `<pre>` 标签内。用 curl 获取页面，然后用一小段 Python 代码片段提取艺术。

**URL 模式：** `https://ascii.co.uk/art/{subject}`

**步骤 1——获取页面：**

```bash
curl -s 'https://ascii.co.uk/art/cat' -o /tmp/ascii_art.html
```

**步骤 2——从 pre 标签提取艺术：**

```python
import re, html

with open("/tmp/ascii_art.html") as f:
    text = f.read()
arts = re.findall(r"<pre[^>]*>(.*?)</pre>", text, re.DOTALL)
for art in arts:
    clean = re.sub(r"<[^>]+>", "", art)
    clean = html.unescape(clean).strip()
    if len(clean) > 30:
        print(clean)
        print("\n---\n")
```

**可用主题**（用作 URL 路径）：
- 动物：`cat`, `dog`, `horse`, `bird`, `fish`, `dragon`, `snake`, `rabbit`, `elephant`, `dolphin`, `butterfly`, `owl`, `wolf`, `bear`, `penguin`, `turtle`
- 物体：`car`, `ship`, `airplane`, `rocket`, `guitar`, `computer`, `coffee`, `beer`, `cake`, `house`, `castle`, `sword`, `crown`, `key`
- 自然：`tree`, `flower`, `sun`, `moon`, `star`, `mountain`, `ocean`, `rainbow`
- 角色：`skull`, `robot`, `angel`, `wizard`, `pirate`, `ninja`, `alien`
- 节日：`christmas`, `halloween`, `valentine`

**提示：**
- 保留艺术家签名/首字母——重要的礼仪
- 每页多个艺术作品——为用户挑选最好的一个
- 通过 curl 可靠工作，无需 JavaScript

### 来源 B：GitHub Octocat API（有趣的彩蛋）

返回带智慧引言的随机 GitHub Octocat。无需认证。

```bash
curl -s https://api.github.com/octocat
```

## 工具 8：有趣的 ASCII 实用程序（通过 curl）

这些免费服务直接返回 ASCII 艺术——非常适合有趣的附加内容。

### QR 码作为 ASCII 艺术

```bash
curl -s "qrenco.de/Hello+World"
curl -s "qrenco.de/https://example.com"
```

### 天气作为 ASCII 艺术

```bash
curl -s "wttr.in/London"          # 带 ASCII 图形的完整天气报告
curl -s "wttr.in/Moon"            # ASCII 艺术中的月相
curl -s "v2.wttr.in/London"       # 详细版本
```

## 工具 9：LLM 生成的自定义艺术（后备）

当上述工具没有所需内容时，使用这些 Unicode 字符直接生成 ASCII 艺术：

### 字符调色板

**方框绘制：** `╔ ╗ ╚ ╝ ║ ═ ╜ ╤ ╬ ┌ ┐ └ ┘ │ ─ ├ ┤ ┬ ┴ ┼ ╭ ╮ ╰ ╯`

**块元素：** `░ ▒ ▓ █ ▄ ▀ ▌ ▐ ▖ ▗ ▘ ▝ ▞ ▟`

**几何与符号：** `◆ ◇ ◈ ● ○ ◉ ■ □ ▲ △ ▼ ▽ ★ ☆ ✦ ✧ ◀ ▶ ◁ ▷ ⬡ ⬢ ⌂`

### 规则

- 每行最大宽度：60 个字符（终端安全）
- 横幅最大高度：15 行，场景最大高度：25 行
- 仅等宽：输出必须在固定宽度字体中正确渲染

## 决策流程

1. **文本作为横幅** → 如果已安装 pyfiglet，否则通过 curl 使用 asciified API
2. **用有趣角色艺术包裹消息** → cowsay
3. **添加装饰边框/框架** → boxes（可与 pyfiglet/asciified 结合）
4. **特定事物的艺术**（猫、火箭、龙）→ 通过 curl + 解析的 ascii.co.uk
5. **将图像转换为 ASCII** → ascii-image-converter 或 jp2a
6. **QR 码** → 通过 curl 的 qrenco.de
7. **天气/月亮艺术** → 通过 curl 的 wttr.in
8. **自定义/创意内容** → 带 Unicode 调色板的 LLM 生成
9. **任何未安装的工具** → 安装它，或回退到下一个选项

