SuperAPI AI 工具集

cli-logging-ux

通用与其它

查看项目

更新于 10-16 00:30

技能介绍

用途:在 APM 代码库中编辑或新增 CLI 输出、日志、警告、错误信息、进度指示与诊断摘要时使用,统一开发者体验。

主要能力:提供三项判断标准——So What 测试(警告必须可操作,否则降级为 --verbose 或删除)、交通灯规则(绿=成功、黄=需用户操作、红=失败、蓝=信息、暗色=次要细节)、报纸测试(顶层为结果,细节可下钻)。区分内联输出与延迟诊断:成功确认、进度、阻断性错误用内联;跨包冲突、覆盖、循环中重复的问题用 DiagnosticCollector 收集后统一渲染。

使用方式:统一使用 apm_cli.utils.console 中的 _rich_success、_rich_error、_rich_warning、_rich_info、_rich_echo,禁止裸 print() 或 click.echo();禁止使用 emoji,仅用 STATUS_SYMBOLS 中的 ASCII 符号。命令层通过 CommandLogger(及 InstallLogger 子类)调用 start、progress、success、warning、error、verbose_detail、tree_item、package_inline_warning、dry_run_notice、auth_step、render_summary 等方法,verbose 与 dry-run 判断由 logger 内部处理。多包操作遵循固定视觉层级:包行为顶层锚点,verbose 元数据缩进暗色,树形子项用 └─,诊断摘要置于所有包之后。

适用场景:APM 各命令(install、pack、audit 等)的输出实现与重构,新增输出模式时向 CommandLogger 添加方法,新增集成器时接收 diagnostics 参数。

限制:资料未提供该技能的安装命令、收费、平台与效果信息;内容仅针对 APM 代码库,不适用于其他项目。