Back to Details

ascii-progress-and-spinner

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

When to use this skill

何时使用此Skill

CRITICAL TRIGGER RULE
  • Use this skill ONLY when the user explicitly mentions the exact skill name: 
    ascii-progress-and-spinner
    .
Trigger phrases include:
  • "ascii-progress-and-spinner"
  • "use ascii-progress-and-spinner"
  • "用 ascii-progress-and-spinner 生成 ASCII 进度条"
  • "使用 ascii-progress-and-spinner 做 spinner / loading"
核心触发规则
  • 仅当用户明确提及确切的Skill名称：
    ascii-progress-and-spinner
    时，才可使用此Skill。
触发短语包括：
  • "ascii-progress-and-spinner"
  • "使用ascii-progress-and-spinner"
  • "用 ascii-progress-and-spinner 生成 ASCII 进度条"
  • "使用 ascii-progress-and-spinner 做 spinner / loading"

Boundary

边界限制

  • Do not integrate a specific UI framework; output styles + refresh rules + fallback protocol + examples.
  • Must cover:
    • determinate progress bars
    • indeterminate spinners
    • non-TTY / redirected-output fallback (log lines, no carriage-return updates)
  • 请勿集成特定UI框架；输出样式 + 刷新规则 + 降级协议 + 示例。
  • 必须覆盖以下内容：
    • 确定型进度条
    • 不确定型加载动画（spinner）
    • 非TTY/重定向输出降级方案（日志行形式，无回车更新）

How to use this skill

如何使用此Skill

Inputs

输入参数

  • mode (determinate | indeterminate)
  • width (default 40)
  • showPercent (default true)
  • showEta (optional)
  • multiTask (optional)
  • colorMode (none | ansi256, default none)
  • mode（确定型 | 不确定型）
  • width（默认值40）
  • showPercent（默认值true）
  • showEta（可选）
  • multiTask（可选）
  • colorMode（无 | ansi256，默认值无）

Outputs (required)

输出要求（必填）

  • progressBarStyles (>= 3)
  • spinnerStyles (>= 2)
  • renderRules (TTY single-line refresh vs logLines)
  • fallbackRules (non-interactive / redirected output)
  • progressBarStyles（至少3种）
  • spinnerStyles（至少2种）
  • renderRules（TTY单行刷新 vs 日志行模式）
  • fallbackRules（非交互式/重定向输出处理规则）

Recommended render rules

推荐渲染规则

  • TTY (interactive): single-line refresh (overwrite previous line), avoid log spam
  • Non-TTY (logs): print log lines (no overwrite). Each line may include task name + percent.
  • TTY（交互式）： 单行刷新（覆盖上一行），避免日志刷屏
  • 非TTY（日志模式）： 打印日志行（不覆盖），每行可包含任务名称 + 百分比

Script

脚本

  • scripts/demo.py
    : local demo for progress bar + spinner shapes
  • scripts/demo.py
    ：本地演示进度条 + 加载动画样式

Examples

示例

  • examples/styles.md
  • examples/styles.md

Quality checklist

质量检查清单

  1. Fixed width (percent field is fixed-width to avoid jitter)
  2. Log mode is grep-friendly (no overwrite)
  3. ASCII-only defaults are available (avoid ambiguous-width Unicode)
  1. 固定宽度（百分比字段为固定宽度以避免抖动）
  2. 日志模式支持grep检索（无覆盖操作）
  3. 提供纯ASCII默认样式（避免使用宽度模糊的Unicode字符）

Keywords

关键词

English: ascii-progress-and-spinner, progress bar, spinner, loading, tty, non-interactive, log output, ascii 中文: ascii-progress-and-spinner, 进度条, Spinner, Loading, 终端, TTY, 日志降级, ASCII
英文： ascii-progress-and-spinner, progress bar, spinner, loading, tty, non-interactive, log output, ascii 中文： ascii-progress-and-spinner, 进度条, Spinner, Loading, 终端, TTY, 日志降级, ASCII