mcpField
A
ascii-ansi-colorizer

ascii-ansi-colorizer

github.com/full-stack-skills设计与 UI577 次安装4 周前更新
代码仓库

关于 ascii-ansi-colorizer

ascii-ansi-colorizer 是一项按需触发的技能,为现有文本添加 ANSI 色彩,适合需要制作终端彩色文字且保留对齐的场景。它同时提供纯文本回退,不负责生成 ASCII 图案。

主要功能

  1. 01为可见字符添加 ANSI 色彩
  2. 02支持彩虹、渐变和品牌色
  3. 03可设置方向、色深和作用范围
  4. 04提供纯文本回退与兼容提示

适用场景

  1. 01为现有 ASCII 标志添加渐变色
  2. 02制作带 ANSI 色彩的终端文字
  3. 03需要保留空格对齐的彩色输出

安装

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

$npx skills add https://github.com/full-stack-skills/ascii-skills --skill ascii-ansi-colorizer

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

包含的文件

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

LICENSE.txt
agents/
openai.yaml
examples/
gradient.md
scripts/
colorize.py

详细介绍

何时使用此技能

关键触发规则

  • 仅当用户明确提及确切的技能名称 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)
步骤
  1. 选择 colorDepth(默认值:ansi256)。
  2. 选择稳定的上色策略:
    • 按列渐变(leftToRight)通常最安全
    • 仅为非空格字符上色
  3. 同时输出 coloredText 和 plainTextFallback。
  4. 提供无颜色使用建议:NO_COLOR / --no-color。

脚本

  • scripts/colorize.py:对标准输入应用 ANSI 256 色渐变或彩虹效果

示例

  • examples/gradient.md

质量检查清单

  1. 移除 ANSI 后,内容仍清晰可读(plainTextFallback)。
  2. 上色后,对齐方式保持不变。
  3. 颜色不应盖过信息内容。

关键词

英语: ascii-ansi-colorizer, ansi, color, gradient, rainbow, terminal, no-color, plain text, ascii 中文: ascii-ansi-colorizer, ANSI, 上色, 渐变, 彩虹, 终端, 无色回退, 纯文本, ASCII

常见陷阱 (Gotchas)

  1. 版本兼容性:注意框架版本与依赖库的兼容性,不同版本 API 可能有差异
  2. 配置文件格式:配置文件格式错误是最常见的问题,建议使用编辑器的语法检查
  3. 环境变量:确保所有必要的环境变量已正确设置,敏感信息不要硬编码
  4. 依赖冲突:多版本共存时注意依赖冲突,使用 lock 文件锁定版本
  5. 性能陷阱:大数据量场景下注意性能优化,避免 N+1 查询等常见问题

使用流程

步骤 1:环境准备

确保开发环境已安装必要的依赖和工具。

步骤 2:配置初始化

根据项目需求进行基础配置。

步骤 3:核心功能使用

按照示例代码实现核心功能。

步骤 4:测试验证

运行测试确保功能正常。

步骤 5:部署上线

完成开发后进行部署和监控。

评论

支持 Markdown