SuperAPI AI 工具集

r-cli

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:该技能面向使用 R 包 cli 进行命令行界面样式设计、语义化消息与用户沟通的场景,帮助在 R 代码中输出格式化的错误、警告、信息和进度提示。

主要能力:

  • 内联标记:用 {.class content} 语法格式化文本,如 {.code}、{.fn}、{.file}、{.pkg}、{.var}、{.val}、{.cls}、{.arg}、{.emph}、{.strong}、{.field} 等;向量会自动用逗号和 "and" 折叠。
  • 单复数:{?s}、{?y/ies},以及零/一/多三态 {?no/the/the};辅助函数 no() 与 qty()。
  • 条件消息:cli_abort()、cli_warn()、cli_inform(),配合项目符号 "x"、"!"、"i"、"v"、"*"、">" 提供上下文。
  • 进度指示:cli_progress_bar(total=...) 配合 cli_progress_update(),或 cli_progress_step();函数退出时自动关闭。
  • 语义元素:标题 cli_h1/h2/h3;警报 cli_alert_success/danger/warning/info;列表 cli_ul/ol/dl 配合 cli_li;文本与代码 cli_text、cli_code、cli_verbatim。

使用方式:在 R 代码中加载 cli 后直接调用上述函数;转义字面大括号用双大括号 {{ 与 }}。可参考 references/inline-markup.md、conditions.md、progress.md、themes.md、ansi-operations.md 获取完整标记表、错误设计、进度定制、主题与 ANSI 操作等细节。

适用场景:R 包开发与脚本中需要清晰、结构化的终端反馈,如输入校验错误、数据质量问题警告、处理进度展示。

限制:资料未提供具体版本要求、安装命令、性能指标、许可与收费信息,暂未提供。