SuperAPI AI 工具集

dotnet-spectre-console

编程与开发

查看项目

更新于 10-16 07:23

技能介绍

用途:Spectre.Console 用于在 .NET 控制台应用中生成富文本输出,Spectre.Console.Cli 用于构建结构化命令行应用。

主要能力:基于 BBCode 风格的标记与样式;表格(含嵌套表格)、树、面板、Columns 组合;进度条与状态旋转器;文本、确认、单选与多选提示;Live 实时刷新显示;Figlet 文本与 Rule 分隔线。Cli 提供命令层级、类型化设置、参数与选项特性、验证、自动帮助,并可通过 ITypeRegistrar 接入 Microsoft DI,支持异步命令。

使用方式:以 .NET 8.0+ 为基线,引用 Spectre.Console 0.54.0;需要 CLI 框架时再引用 Spectre.Console.Cli 0.53.1。仅需富输出时只装 Spectre.Console 即可。通过 AnsiConsole.MarkupLine、AnsiConsole.Write、AnsiConsole.Progress、AnsiConsole.Status、AnsiConsole.Prompt、AnsiConsole.Live 等 API 使用;测试时用 AnsiConsole.Create 配合 StringWriter 或注入 IAnsiConsole。

适用场景:控制台报表、构建与部署日志、交互式命令行工具、进度与状态展示。

限制:不覆盖完整 TUI(窗口、菜单、对话框、视图),也不涉及 System.CommandLine 解析、CLI 架构与分发。重定向输出时不应使用 Markup,CI 环境可能不支持 ANSI,需显式配置;不要混用静态 AnsiConsole 与注入实例;Live 显示非线程安全,只能在回调内修改并 Refresh;非交互上下文不应使用提示。TUI 无障碍与屏幕阅读器限制需另行考虑。