mcpField
E
error-tracking-nuxt

error-tracking-nuxt

github.com/posthog开发7693 次安装今天更新
代码仓库

关于 error-tracking-nuxt

面向 Nuxt 应用的 PostHog 错误跟踪技能,指导在保留现有错误处理的基础上接入 SDK 自动捕获、source map 和手动异常捕获。

主要功能

  1. 01Nuxt 错误跟踪配置
  2. 02异常自动捕获指导
  3. 03source map 上传指导
  4. 04手动捕获异常
  5. 05使用环境变量配置

适用场景

  1. 01为 Nuxt 应用添加 PostHog 跟踪
  2. 02借助 source map 改善堆栈信息
  3. 03捕获全局处理器未处理的错误

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/posthog/skills --skill error-tracking-nuxt

安装后在 Claude Code 中输入/error-tracking-nuxt确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
alerts.md
assigning-issues.md
fingerprints.md
monitoring.md
nuxt.md
upload-source-maps.md

详细介绍

Nuxt 的 PostHog 错误跟踪

此技能可帮助你为 Nuxt 应用添加 PostHog 错误跟踪。

参考文件

  • references/nuxt.md - Nuxt 错误跟踪安装(v3.7 及以上)- 文档
  • references/fingerprints.md - 指纹 - 文档
  • references/alerts.md - 发送错误跟踪警报 - 文档
  • references/monitoring.md - 监控和搜索问题 - 文档
  • references/assigning-issues.md - 将问题分配给队友 - 文档
  • references/upload-source-maps.md - 上传源映射 - 文档

请查阅文档,了解 API 详情和框架特定模式。

关键原则

  • 环境变量:PostHog 密钥和主机 URL 始终使用环境变量。切勿将其硬编码。
  • 尽量减少改动:在现有错误处理旁添加错误跟踪。不要替换或重构现有错误处理代码。
  • 优先使用自动捕获:在添加手动捕获之前,先在 SDK 初始化时启用异常自动捕获。
  • 源映射:上传源映射,使堆栈跟踪能够解析到原始源代码,而不是压缩后的包。
  • 在边界处手动捕获:对于不会传播到全局处理程序的错误,在错误边界和 catch 代码块中使用 captureException()。

框架指南

无特定框架指南。

评论

支持 Markdown