名称: ascii-ansi-colorizer 描述: 为现有的ASCII或纯文本输出添加ANSI颜色层(渐变/彩虹/高亮),并遵循对齐安全规则和必需的无颜色回退。 许可证: 完整条款在LICENSE.txt中 依赖项:
- python>=3.8
何时使用此技能
关键触发规则
- 仅当用户明确提及确切的技能名称时使用此技能:
ascii-ansi-colorizer。
触发短语包括:
- “ascii-ansi-colorizer”
- “use ascii-ansi-colorizer”
- “用 ascii-ansi-colorizer 给 ASCII 上色”
- “使用 ascii-ansi-colorizer 做 ANSI 渐变/彩虹”
边界
- 此技能仅向现有文本添加颜色。它不生成ASCII艺术本身(如果需要,可与
ascii-cli-logo-banner配对使用)。 - 必需输出:
coloredText+plainTextFallback。 - ANSI不得破坏对齐:默认情况下不为空格着色;仅着色可见字符。
如何使用此技能
输入
- textOrAscii(必需)
- palette(rainbow | gradient | brandColors)
- direction(leftToRight | topToBottom,默认leftToRight)
- colorDepth(ansi16 | ansi256 | truecolor,默认ansi256)
- scope(logoOnly | highlightsOnly | fullText,默认logoOnly)
输出(必需)
- coloredText: ANSI着色输出
- plainTextFallback: 无颜色回退(相同内容,无ANSI)
- compatNotes: 复制/粘贴和重定向指导(NO_COLOR / --no-color 建议)
步骤
- 选择
colorDepth(默认: ansi256)。 - 选择稳定的着色策略:
- 列向渐变(leftToRight)通常最安全
- 仅着色非空格字符
- 输出
coloredText和plainTextFallback。 - 提供无颜色指导(语义建议):
NO_COLOR/--no-color。
脚本
scripts/colorize.py: 将ANSI 256渐变或彩虹应用于标准输入
示例
examples/gradient.md
质量检查清单
- 移除ANSI后保持相同的可读内容(
plainTextFallback)。 - 着色后对齐不变。
- 颜色不应压倒信息行。
关键词
英文: ascii-ansi-colorizer, ansi, color, gradient, rainbow, terminal, no-color, plain text, ascii 中文: ascii-ansi-colorizer, ANSI, 上色, 渐变, 彩虹, 终端, 无色回退, 纯文本, ASCII