优雅控制台日志
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/pvdn20260237。
技能介绍
为什么需要优雅的控制台日志
在 CRM Demo 调试或批量执行工具箱脚本时,满屏的 console.log 会迅速淹没关键报错。这里存在的几个具体问题:输出缺乏语义化级别,导致搜索困难;多模块并发调用时,日志来源难以追溯;更严重的是,无差别的打印极易将完整手机号或卡号等敏感字段暴露在控制台。
技能如何工作
本技能受热门轻量库 consola 启发,提供了一套标准化的控制台日志方案。核心运作逻辑如下:
- 模块标签(Tag)机制:通过
createConsola({ defaults: { tag } })为不同业务模块创建独立实例。这允许在输出时直观区分请求回调、数据保存等不同来源的日志。 - 分级输出样式:废弃单一的无级别打印,改用
info、success与error三种级别。在开发期,开发者能通过视觉样式快速过滤并定位异常堆栈。 - 生产环境抑制:在部署到生产环境时,可以通过调高
level参数来一键抑制低级别的噪声输出,保持客户端控制台清爽。 - 实现要点约束:Agent 在生成代码逻辑时,会严格遵循小四原创的实现建议进行自测,确保敏感字段不在日志层被直接刷出。
适用边界与注意点
该技能专为前端控制台调试设计,不做 ELK/远程日志平台集成。请勿将其用于替代正式的线上审计系统。前端优先引入 consola/browser 主要是为了控制打包体积,但在涉及到极其严格的敏感信息脱敏场景下,依然需要在业务代码层前做好前置过滤,因为日志库本身无法预知什么是隐私数据。
使用场景
- 在前端项目调试时,需要统一多个模块的日志输出格式,区分info/error级别
- 处理工具箱脚本时,需要按模块tag输出日志,方便追踪请求和保存操作
- 在CRM系统开发中,需要抑制生产环境低级别日志,同时保留关键错误信息
- 团队协作开发时,需要通过日志区分不同来源模块的输出,避免混淆
适合人员
- 前端开发工程师需要统一团队日志规范,方便调试和问题排查
- 技术负责人需要控制生产环境日志量,避免敏感信息泄露和性能问题
- 工具箱脚本开发者需要模块化日志输出,提升脚本可维护性和可读性
- 全栈开发者需要在前端集成轻量级日志方案,不引入额外体积