耗时毫秒美化
将以下提示词粘贴到你的 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 -。
推荐实现的关键步骤:
- 项目里已引入
pretty-ms - 把耗时列绑定到
formatCostMs - 自测重点看两个用例:
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 耗时字段的后端工程师,希望非法值有稳定回落而不是报错
- 维护日志规范的技术写作者,想明确紧凑耗时格式与中文时长表达的适用差异