关于 convex-sentinel
convex-sentinel 是用于捕获和分诊 Convex 部署中生产错误的技能。错误数据在写入时脱敏并保存在该部署中，还可将反复出现的非暂时性问题交给 ai-runner 创建修复 PR。
主要功能
- 01捕获服务端和客户端错误
- 02记录 OCC 与扩展信号
- 03写入前对数据脱敏
- 04监控新的生产错误
- 05可选分诊并移交修复 PR
适用场景
- 01检查生产函数故障
- 02跟踪客户端崩溃
- 03响应反复出现的错误模式
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/convex-sentinel确认已加载。
详细介绍
在你自己的部署中捕获生产环境错误
安装 @convex-dev/sentinel，将生产环境错误（服务端函数失败、客户端 JS/React 崩溃、OCC 和扩缩容信号）捕获到用户自己的部署中的一个表内，在写入时进行脱敏，然后对新错误作出响应。数据绝不会离开用户的部署。
工作流
- 安装该组件：在
convex/convex.config.ts中使用app.use(sentinel)。 - 接入客户端 SDK：添加 React 错误边界，以及
window.onerror/unhandledrejection和面包屑。 - 脱敏在写入时执行，且默认启用（默认拒绝包含机密的键名和匹配机密的值模式）。
- 使用 Convex CLI（
convex data、run-once-query）读取近期错误；通过监控器的prod_error事件对新错误作出响应。 - 可选启用自愈 cron：
triage会对每个错误进行分类，并将反复出现的非瞬时错误交给 ai-runner，以创建修复 PR。
规则
- 脱敏是强制要求，且默认启用——绝不存储未经处理的机密；Agent 读取到的内容会传给模型提供商。
- 数据留在用户的部署中；绝不发送给第三方。
- 对数据进行采样并设置上限，以控制数据量和成本。
- 捕获 PROD 错误需要已部署的云应用；安装可以匿名进行。
评论
支持 Markdown