用途:把本地图片转成 ASCII 字符画,用于终端预览或纯文本形式的“图像替代”。仅在用户明确提到技能名 ascii-image-to-ascii 时触发。
主要能力:输出两个必需变体——asciiReadable(可读优先,噪声少、轮廓清晰)与 asciiDetail(细节优先,灰阶层次多、纹理丰富);同时给出 paramsGuide(推荐宽度/字符集与预处理建议)和 pitfalls(3–5 个常见失败模式及修复)。默认仅 ASCII,ANSI 着色可选。
输入参数:imagePath(本地路径,必填)、width(默认 100,常用 80/100/120)、charset(默认 " .:-=+*#%@",由浅到深)、mode(readable | detail,同时输出两版时可忽略)、background(light | dark | unknown,默认 unknown)、colorMode(none | ansi256,默认 none)。
使用方式:脚本位于 scripts/image_to_ascii.py,需 Python 与 Pillow(pip install pillow),支持 readable/detail 变体与可选 --ansi256。示例见 examples/readable-vs-detail.md。生成前应先给出预处理建议:裁剪主体、去除无关背景、提高对比度以降低渐变噪声,目标宽度通常 80–120 列。字符集映射方向需一致:空格最浅、@ 最深(或统一反转)。ANSI 仅作提示,须保留无彩色回退方案。
质量检查:每行长度一致且不超过 width;可读变体须保留主体轮廓;无行尾空格,便于复制粘贴。
限制:脚本仅用于本地转换与验证,不得代用户抓取或上传图片;默认输出为纯 ASCII。资料未提供具体性能数据、收费信息或平台支持范围。