SuperAPI AI 工具集

beautiful-cli-design

设计与创作

查看项目

更新于 10-15 20:30

技能介绍

用途:把命令行界面当作正式用户界面来设计,让 CLI 工具在功能之外具备清晰、美观、可用的视觉与交互体验。

主要能力:覆盖 ANSI 颜色系统(16/256/truecolor 及优雅降级)、CLI 框架选型决策树、进度指示器选择、常见失败模式识别与修复、错误信息改写、质量检查清单。

框架选型:简单提示/向导可选 Clack(TypeScript)、Huh/Survey(Go)、inquire(Rust);仅需富文本输出可选 chalk + ora(TypeScript)、Rich(Python)、lipgloss(Go)、owo-colors + indicatif(Rust);完整 TUI 可选 Ink(React)、Bubble Tea(Go)、Ratatui(高性能)、Textual(Python)。

颜色策略:CI/服务器等基础环境检测 NO_COLOR、非 TTY 时输出纯文本,仅用 4 种基础色;现代终端检测 COLORTERM 使用 24 位真彩并降级到 256 色与 16 色;系统级工具先探测终端能力,提供 --no-color 覆盖,默认最小配色。

进度指示:已知时长时,超过 30 秒用带 ETA 的完整进度条,5–30 秒用简单进度条,5 秒内用 150ms 延迟的 spinner;未知时长按网络/IO、CPU 密集、并行任务分别处理;流式输出可用前缀状态、分屏或实时仪表盘。

常见反模式:彩虹呕吐(单屏超过 5 种颜色)、浅色主题下不可读、管道输出崩溃或残留 ANSI 码、隐藏光标后未恢复、CJK 与 emoji 导致表格错位。修复方式包括限制语义色、使用语义 ANSI 码、检测 TTY、注册退出处理器、使用 Unicode 宽度计算。

质量门槛:在多种终端测试、验证颜色降级、适配 40/80/120 列宽、清理光标、校验 Unicode、限制刷新率、语义化配色、提供 --json 机器可读输出、统一视觉语言、错误信息可操作。

适用场景:CLI 工具的安装向导、构建流水线仪表盘、错误提示优化等终端界面设计。

限制:不适用于浏览器界面、桌面 GUI、移动应用、API 响应格式、Shell 脚本逻辑、数据库设计;涉及浏览器、移动端、Web 服务或 GUI 窗口时应转交相应专家。具体安装命令与代码示例资料中暂未提供。