oh-my-logo-cjk：将输入的中、日、韩文本渲染为 CLI 中的像素风 ASCII 图，支持多种渐变色板

本文最后更新于 2025年9月16日 by 阿喵

该项目能将输入的中、日、韩文本渲染为 CLI 中的像素风 ASCII 图，支持多种渐变色板。

启发自只能输入 ASCII 的 oh-my-logo

• CJK 友好：基于像素字体采样（非预制 ASCII），支持中、日、韩等多语种
• 从 oh-my-logo 偷了多种渐变色板与方向，支持 24-bit ANSI 颜色
• 多种像素输出模式与样式（half/full、block/shade 等）
• 开箱即用，跨平台（Windows 通过 colorama 兼容 ANSI）

项目截图

安装与运行

• 安装 Python >= 3.9
• 推荐使用 uv 运行本地项目

不安装到全局环境，直接在仓库根目录运行：

uv run oh-my-logo-cjk "你好世界" 7px grad-blue --color

也可安装为包后使用：

pip install -e .
oh-my-logo-cjk "你好世界" 7px grad-blue --color

如何使用

在目录下运行：

uv run oh-my-logo-cjk "你好世界" 7px grad-blue --color

这个玩具的命令组合为：

oh-my-logo-cjk <text> [font] [palette] [options]

• text – 必填，用英文双引号包裹，例如：”你好世界”
• font – 项目自带了两种字体配置： 7px 和 9px。你可以通过 fonts/fonts.json 添加更多字体和配置。项目默认使用了 丁卯点阵体 的 demo 版，能输出的文字有限，你可以购买完整版字体进行替换、以获得完整输出字库；
• palette – 渐变调色盘：
  • 通过命令 --gallery --color，可以一次性预览所有色板，方便直接选一个最喜欢的：uv run oh-my-logo-cjk “你好世界” –gallery –color

• option – 值得一试的额外可选项
  • -s, --style <style>：字符画样式
    • none | simpleBlock | shade | block（默认）
  • -pw, --pixel-width <h|f|hf>：像素宽度模式
    • h：半角（默认，扁扁的）
    • f：全角（方块字）
    • hf：两个半角营造全角视觉（兼容性更佳）
  • -d, --direction <dir>：颜色渐变方向
    • vertical（默认）| horizontal | diagonal
  • --reverse-gradient：反转渐变
  没那么值得一试的选项：
  • --letter-spacing <n>：字符间距（像素网格单位，整数，默认 1）
  • -l, --list-palettes：列出色板
  • --color/--no-color：强制开/关颜色（管道场景有用）
  • --color-space <rgb|oklab>：插值色彩空间（默认 rgb）

获得满意的结果后，可以将输出结果重定向保存，使用到其他 CLI 项目之中（保留颜色的终端可还原）：

uv run oh-my-logo-cjk run "你好世界" 7px grad-blue --color > art.txt

cat art.txt

项目地址