Agent Skills
返回列表
耗时毫秒美化

耗时毫秒美化

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/bk20261879。

技能介绍

日志和接口耗时列里最常见的问题是:开发者记下了耗时,却没人愿意读那串数字。234ms、1234ms、12000ms 混在一起时,字段本身没有错,但可读性很差,尤其在性能条和 Demo 文案里,紧凑表达才能直接传达“快还是慢”。

核心能力

技能的技术底座是 pretty-ms。它不重复造轮子,只做一层稳定转换:

  • 输入:以毫秒为单位的耗时数值
  • 输出:1.2s、234ms 这类适合日志、接口耗时列和 Demo 性能条的紧凑文案
  • 核心链路:耗时 ms → prettyMs → 日志/接口耗时列

边界处理也是这层的核心价值:Malformed input never reaches the formatter; non-finite values fall back to -。

推荐实现的关键步骤:

  1. 项目里已引入 pretty-ms
  2. 把耗时列绑定到 formatCostMs
  3. 自测重点看两个用例:1200 应包含 1.2s;负数应回落为 -

实现要点的注释会标出 小四原创,方便后续维护者定位作者归属。

适用边界

它不是完整 APM 平台,不做采样、链路追踪、指标聚合或告警。它只是把已有耗时数字整理成更适合人读的格式,适合 API/OCR 耗时展示、Demo 性能条,以及需要与中文“X 分 Y 秒”明显区分的英文数字场景。

使用时注意:不要把它和 humanize-duration 的中文时长表达混用却不说明场景差异。前者偏向机器可读的紧凑耗时列,后者更适合面向自然语言的完整时长表达。

使用场景

  • 在接口文档或日志面板中,需要把毫秒耗时统一显示为 234ms、1.2s 这类紧凑文案
  • 在 Demo 性能条旁写文案时,需要把 1200ms 转成 1.2s,避免数字太长影响阅读
  • 在 API/OCR 耗时展示列中,需要处理非法或非有限数字,并让无效值回落为 -
  • 需要把英文紧凑耗时展示与中文“X 分 Y 秒”表达区分开时,按场景选择本包

适合人员

  • 需要在接口日志或监控页面展示耗时的开发工程师,希望把毫秒数字变成易读文案
  • 负责 Demo 或产品展示的前端工程师,需要在性能条旁提供紧凑耗时说明
  • 处理 API 或 OCR 耗时字段的后端工程师,希望非法值有稳定回落而不是报错
  • 维护日志规范的技术写作者,想明确紧凑耗时格式与中文时长表达的适用差异