SuperAPI AI 工具集

pwshspectreconsole-terminal-ui

编程与开发

查看项目

更新于 11-12 06:46

技能介绍

用途

该技能用于在用户需要创建、重构或审查使用 PwshSpectreConsole 的 PowerShell 脚本或模块时提供指导。适用请求包括:交互式 PowerShell 菜单、选择提示、确认与文本输入;终端仪表盘、表格、面板、分隔线、树、网格、图表、日历或富格式输出;进度条、状态加载动画、长时间任务反馈或后台任务可视化;用 Spectre.Console 封装替换 Write-Host、Read-Host、手写 ANSI 转义序列或纯文本菜单;使用演示命令构建功能演示脚本;让 PowerShell 工具呈现现代 CLI/TUI 风格。

当脚本需要在 CI/CD、计划任务、Intune 修复脚本、ConfigMgr 基线、Azure Automation 等非交互环境中静默运行时,不应使用该技能,除非同时构建非交互回退路径。

主要能力与覆盖场景

  • 交互提示:Read-SpectreSelection 单选(支持搜索、-ChoiceLabelProperty 显示友好标签)、Read-SpectreMultiSelection 多选(支持 -AllowEmpty)、Read-SpectreConfirm 确认(可设默认答案与成功/失败提示)、Read-SpectreText 短文本输入。
  • 输出展示:Write-SpectreHost 富文本消息;Format-SpectreTable 结构化表格(标题、边框、颜色、行分隔符、-AllowMarkup);Write-SpectreRule 分节标题;Format-SpectrePanel 摘要与警告面板;Format-SpectreException 异常展示。
  • 实时反馈:Invoke-SpectreCommandWithStatus 用于时长未知的任务(可指定 Spinner),Invoke-SpectreCommandWithProgress 用于可度量的任务(ProgressContext 任务、可设不确定任务)。
  • 演示与探索:Start-SpectreDemo、Get-SpectreDemoFeatures、Get-SpectreDemoColors、Get-SpectreDemoEmoji、Open-PwshSpectreConsoleHelp,用于查看模块视觉能力或制作培训/演示内容。

使用方式与设计原则

资料建议以官方文档和本地模块帮助为准,列出官方文档、演示参考、GitHub 仓库、Spectre.Console markup 与 emoji 参考,以及 Get-Command、Get-Help 等本地发现命令。基线假设为 PowerShell 7+,安装命令:

Install-Module PwshSpectreConsole -Scope CurrentUser

建议设置 UTF-8 输出编码,并使用支持较广字符(emoji、图标、线条)的现代终端与字体。

设计原则强调:富终端界面应服务于清晰度而非装饰;提示仅用于有意义的选择;表格用于结构化输出而非单个对象;状态加载动画用于短时未知任务,进度条用于可度量工作;面板、分隔线、figlet 文本节制使用;动态用户或外部数据在插入 Spectre markup 前必须用 Get-SpectreEscapedText 转义;优先可读、可测试的 PowerShell 代码。

技能给出标准实现流程:判断脚本是交互式还是自动化导向;受保护地导入模块;为输出与提示创建小型封装层;业务逻辑与界面渲染分离;为非交互执行添加回退;破坏性操作使用 -WhatIf、ShouldProcess 或确认提示;除非命令明确设计为交互命令,否则避免破坏管道输出;在 Windows Terminal、VS Code 集成终端及基础非交互 shell 中测试。

资料还提供脚本脚手架、提示与输出模式示例、错误处理建议(保留异常细节用于排障)、非交互回退模式(参数化 Mode 与 -NonInteractive)、测试检查清单、常见错误(未转义外部文本、无覆盖的阻塞式提示、过早格式化表格破坏对象、每行日志都高对比 markup)以及审查评分要点,并附一个交互式设备清理 shell 的最小示例。

适用场景与限制

适用于希望让 PowerShell 工具具备现代 CLI/TUI 体验的交互式场景,以及需要规范化 PwshSpectreConsole 用法的代码生成与审查。限制包括:模块面向 PowerShell 7+;交互界面依赖现代终端和较广字形支持;非交互环境需另行实现回退路径,否则不应使用。本资料未提供该技能的收费、价格或授权信息。