产品指南

为 CLI 应用设计 ASCII 启动画面

为命令行应用加入容易记住的文本 Logo,同时兼顾启动速度、可访问性和窄终端环境。

为什么使用文本 Banner?

CLI Banner 是产品界面的一部分。交互运行时可以展示它,但管道、测试和 JSON 工作流中的机器可读输出不应被装饰内容污染。

产品名称稳定后,生成一次并把结果保存为常量或文本资源。除非用户确实需要动态文字,否则不要在每次启动时加载完整字体引擎。

一个安全的起始模式

if (process.stdout.isTTY && !flags.quiet) {
  console.log(BANNER);
}

// 在管道和自动化任务中跳过装饰输出。

只在交互运行时输出装饰内容

检查标准输出是否连接到终端。用于管道、测试或 JSON 工作流的命令应返回结构化结果,不应包含装饰性开场。

保存最终 Banner

产品名称稳定后,把生成结果复制到常量或文本资源中。这样可以保证快速启动,也不必随 CLI 分发数百种字体。

生成你的版本

打开完整字体库,输入最终文字并设置目标宽度,然后使用适合当前工作流的包装格式复制结果。