Back to Details

cli-ascii-logo

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CLI ASCII Logo

CLI ASCII Logo

目标

Goals

生成可直接在终端输出的 ASCII 艺术 Logo（含边框与渐变色）
输出“可复制粘贴”的结果（纯文本/带 ANSI 颜色），并提供在 CLI 启动时展示的集成方式
提供可运行的生成脚本：
```
scripts/generate_logo.py
```

Generate ASCII art Logo (with borders and gradient colors) that can be directly output in the terminal
Output "copy-paste ready" results (plain text/with ANSI colors), and provide integration methods for displaying when the CLI starts
Provide a runnable generation script:
```
scripts/generate_logo.py
```

工作流

Workflow

明确输入
- 名称：如
```
auto-cli
```
- 副标题：如
```
Command Line Interface
```
- 终端宽度：默认 80（可根据项目/CI 输出调整）
- 风格：粗块（
```
█
```
  ）/ 细线条（
```
#
```
  /
```
*
```
  ）/ 无颜色
- 边框：
```
╔═╗║ ║╚═╝
```
  或纯文本
- 配色：青 → 紫（Spec Kit 风格）、青 → 蓝、橙 → 粉等
生成结果
- 直接运行脚本生成（最可靠）：见下方“快速开始”
- 或按需在目标语言里生成（Node/Python/Go），核心是：
  - 先得到“等宽字符画”（多行字符串）
  - 再做边框拼接
  - 再做逐字符渐变（输出 ANSI TrueColor 序列）
集成到 CLI
- 运行入口（
```
main
```
  /
```
bin
```
  /
```
__main__
```
  ）启动时输出一次
- 支持禁用颜色：
  - 尊重
```
NO_COLOR=1
```
  - 提供
```
--no-color
```
    参数
  - CI 环境默认关闭（可按需打开）

Clarify input
- Name: e.g.,
```
auto-cli
```
- Subtitle: e.g.,
```
Command Line Interface
```
- Terminal width: default 80 (adjustable according to project/CI output)
- Style: bold blocks (
```
█
```
  )/thin lines (
```
#
```
  /
```
*
```
  )/no color
- Border:
```
╔═╗║ ║╚═╝
```
  or plain text
- Color scheme: Cyan → Purple (Spec Kit style), Cyan → Blue, Orange → Pink, etc.
Generate results
- Generate by running the script directly (most reliable): see "Quick Start" below
- Or generate in the target language as needed (Node/Python/Go), the core steps are:
  - First get the "monospace character art" (multi-line string)
  - Then do border splicing
  - Then apply character-by-character gradient (output ANSI TrueColor sequences)
Integrate into CLI
- Output once when the entry point (
```
main
```
  /
```
bin
```
  /
```
__main__
```
  ) starts
- Support disabling color:
  - Respect
```
NO_COLOR=1
```
  - Provide
```
--no-color
```
    parameter
  - Disable by default in CI environment (can be enabled as needed)

快速开始（脚本）

Quick Start (Script)

在支持 TrueColor 的终端（macOS Terminal / iTerm2 / VS Code 终端）效果最佳。

bash

python3 scripts/generate_logo.py --text auto-cli --subtitle "Command Line Interface"

常用参数：

bash

python3 scripts/generate_logo.py \
  --text auto-cli \
  --subtitle "Command Line Interface" \
  --width 46 \
  --palette spec-kit \
  --frame box

Works best in terminals that support TrueColor (macOS Terminal / iTerm2 / VS Code Terminal).

bash

python3 scripts/generate_logo.py --text auto-cli --subtitle "Command Line Interface"

Common parameters:

bash

python3 scripts/generate_logo.py \
  --text auto-cli \
  --subtitle "Command Line Interface" \
  --width 46 \
  --palette spec-kit \
  --frame box

交付格式

Delivery Format

纯文本（无颜色）：适合 README / 日志 / 不支持 ANSI 的环境
ANSI 颜色文本：适合 CLI 启动页（建议提供
```
--no-color
```
切换）
建议同时提供：
- ```
banner.txt
```
  （无颜色）
- ```
banner.ansi.txt
```
  （带颜色）
- ```
renderBanner()
```
  （在你的 CLI 里按环境输出）

Plain text (no color): suitable for README / logs / environments that don't support ANSI
ANSI color text: suitable for CLI startup pages (it is recommended to provide
```
--no-color
```
switch)
It is recommended to provide all of the following:
- ```
banner.txt
```
  (no color)
- ```
banner.ansi.txt
```
  (with color)
- ```
renderBanner()
```
  (output according to environment in your CLI)

参考

References

配色与兼容性建议见 palettes.md

For color scheme and compatibility suggestions, see palettes.md