SuperAPI AI 工具集

ascii-progress-and-spinner

设计与创作

查看项目

更新于 10-16 03:15

技能介绍

用途:为命令行界面设计 ASCII 进度条与加载动画(Spinner),并给出刷新与降级规则。仅在用户明确提到技能名 ascii-progress-and-spinner 时使用。

主要能力:必须覆盖确定型进度条、不确定型 Spinner、非 TTY 或重定向输出的降级方案(输出日志行,不使用回车覆盖)。输出要求包含至少 3 种进度条样式、至少 2 种 Spinner 样式、渲染规则(TTY 单行刷新 vs 日志行)以及非交互/重定向输出的降级规则。

输入参数:mode(determinate 或 indeterminate)、width(默认 40)、showPercent(默认 true)、showEta(可选)、multiTask(可选)、colorMode(none 或 ansi256,默认 none)。

样式示例:进度条有 block 风格 [████████░░░░░░░░░░░░] 42% ETA 3s、hash 风格 [########............] 42% ETA 3s、arrow 风格 [========>-----------] 42% ETA 3s;Spinner 有 braille 风格 ⠋ Loading... → ⠙ Loading... → ⠹ Loading... 和 pipe 风格 | Loading... → / Loading... → - Loading...。非 TTY 日志降级示例:[task-1] 25% complete 等逐行输出,最后一行含耗时。

使用方式:先判断确定型还是不确定型,再从样式库选择样式,定义 TTY 单行刷新与非 TTY 日志行规则,定义重定向输出降级规则,最后校验百分比字段定宽、无抖动、日志模式便于 grep。附带 scripts/demo.py 本地演示和 examples/styles.md 示例。

限制:不集成特定 UI 框架;默认提供纯 ASCII 样式以避免歧义宽度 Unicode;资料未提供具体安装命令、收费或平台信息。