mcpField
A
ascii-image-to-ascii

ascii-image-to-ascii

github.com/partme-ai创意与媒体71661 次安装3 周前更新
代码仓库

关于 ascii-image-to-ascii

ascii-image-to-ascii 是将本地图片转换为 ASCII 字符画的技能，可生成易读优先和细节优先版本，并提供可选 ANSI 颜色及图片预处理建议。

主要功能

  1. 01将本地图片转换为 ASCII 字符画
  2. 02生成易读版和细节版
  3. 03支持可选 ANSI 256 色输出
  4. 04提供图片预处理和参数建议
  5. 05提供基于 Pillow 的 Python 脚本

适用场景

  1. 01将本地图片制作为 ASCII 字符画
  2. 02对比易读版与细节版效果
  3. 03在终端预览图片转换结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/partme-ai/full-stack-skills --skill ascii-image-to-ascii

安装后在 Claude Code 中输入/ascii-image-to-ascii确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE.txt
examples/
readable-vs-detail.md
scripts/
image_to_ascii.py

详细介绍

使用此技能的时机

关键触发规则

  • 仅当用户明确提及技能的确切名称：ascii-image-to-ascii 时，才使用此技能。

触发短语包括：

  • "ascii-image-to-ascii"
  • "use ascii-image-to-ascii"
  • "用 ascii-image-to-ascii 把图片转字符画"
  • "使用 ascii-image-to-ascii 生成可读优先/细节优先两版"

使用边界

  • 默认输出仅包含 ASCII 字符；可选使用 ANSI 颜色。
  • 附带的脚本仅用于本地转换和验证。不要代替用户获取或上传图片。
  • 生成最终 ASCII 艺术图之前，始终提供预处理建议（裁剪主体、提高对比度、简化背景）。

如何使用此技能

输入
  • imagePath（本地路径，必填）
  • width（默认 100；常用值：80/100/120）
  • charset（默认 .:-=+*#%@，从浅到深）
  • mode（readable | detail；如果同时输出两版，可忽略此项）
  • background（light | dark | unknown，默认 unknown）
  • colorMode（none | ansi256，默认 none）
输出（必需）
  • asciiReadable：可读性优先（噪声较少，轮廓更清晰）
  • asciiDetail：细节优先（层次更多，纹理更丰富）
  • paramsGuide：推荐的 width/charset 和预处理建议
  • pitfalls：3-5 个常见问题及解决方法
步骤
  1. 预处理建议（必需）：
    • 裁剪主体，去除无关背景
    • 提高对比度，减少渐变噪声
    • 目标宽度通常为 80–120 列
  2. 字符集和映射方向：
    • 空格最浅，@ 最深（或始终使用相反的映射）
  3. 生成两个版本：
    • readable：层次更少（噪声更少）
    • detail：层次更多（纹理更丰富）
  4. 可选 ANSI：
    • 颜色仅作提示；保持轮廓清晰可辨
    • 始终提供无颜色的备用版本

脚本

  • scripts/image_to_ascii.py
    • 需要 Python + Pillow（pip install pillow）
    • 支持：readable/detail 版本，可选 --ansi256
示例输出对比

可读性优先版本（层次较少，轮廓更清晰）：

        .:::.
      .=*##*=.
     .+######+.
    .:########:.
    .+########+.
     :*######*:
      .=*##*=.
        .:::.

细节优先版本（层次更多，纹理更丰富）：

        .:=+:.
      .-+*##*+-.
     .=*######*=.
    .:*########*:.
    .=*########*=.
     :+*######*+:
      .-+*##*+-.
        .:=+:.

示例

  • examples/readable-vs-detail.md

质量检查清单

  1. 行宽一致且 <= width
  2. 可读性优先版本必须保留主体轮廓
  3. 不含行尾空格（便于安全复制粘贴）

关键词

英文： ascii-image-to-ascii, image to ascii, ascii art, terminal preview, charset, grayscale, dithering, ansi 中文： ascii-image-to-ascii, 图片转字符画, ASCII 字符画, 终端预览, 字符集, 灰度映射, 降噪, ANSI 彩色

评论

支持 Markdown