用途:为 Svelte 或 SvelteKit 应用接入 Sentry,覆盖错误监控、追踪、会话回放与结构化日志。技能会先探测项目,再给出具体推荐并逐步引导配置。
主要能力:自动识别是否含 @sveltejs/kit、SvelteKit 版本是否 ≥2.31.0、是否已装 @sentry/、是否存在 vite.config、是否已有 hooks 文件,以及 Node 侧日志库和相邻后端目录。据此选择 SvelteKit 现代路径(instrumentation.server.ts + svelte.config.js 开启 instrumentation/tracing)、旧版路径(init 直接放 hooks.server.ts)或纯 Svelte 路径(@sentry/svelte)。支持错误监控(客户端/服务端未处理错误自动捕获)、追踪(客户端导航与请求 span)、会话回放(仅客户端)、日志(Sentry.logger.)。
使用方式:推荐先运行 npx @sentry/wizard@latest -i sveltekit 交互向导;或手动执行 npm install @sentry/sveltekit --save,并按现代路径创建 src/instrumentation.server.ts、src/hooks.client.ts、src/hooks.server.ts,配置 svelte.config.js 与 vite.config.ts(sentrySvelteKit 插件须在 sveltekit() 之前),在 .env 设置 SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT。纯 Svelte 用 npm install @sentry/svelte --save 并在入口文件初始化。各功能参考文件路径为 references/error-monitoring.md、tracing.md、session-replay.md、logging.md。
适用场景:SvelteKit 用户面向应用、含登录或结账页;有 API 调用或需分布式追踪;需要日志与 trace 关联。限制:Vercel Edge Runtime 不支持,Cloudflare 适配器仅部分支持需额外配置;会话回放只能客户端初始化;旧版 wrapLoadWithSentry 等包装器应移除。SDK 版本与 API 以官方文档为准。