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 种内置字体。

设置

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

用法

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）

# 基本文本横幅（默认字体）
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 字符的对话气泡中的经典工具。

设置

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

用法

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

眼睛/舌头修饰符

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+ 内置设计。

设置

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

用法

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 结合

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 颜色效果和视觉滤镜。非常适合终端美化。

设置

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

用法

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（推荐，现代）

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

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）

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——获取页面：

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

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

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。无需认证。

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

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

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

QR 码作为 ASCII 艺术

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

天气作为 ASCII 艺术

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. 任何未安装的工具 → 安装它，或回退到下一个选项