正在整理你需要的资料…
报错日志交给 SaaS,等于把用户数据送出服务器。bicho 跑在 Cloudflare Workers 上,支持 OTLP 与 Sentry 格式上报,证据存在自己的 D1 数据库和 R2 桶里,还能通过 MCP 查。
适合想自托管错误收集、不愿依赖 SaaS 的团队;提供 JavaScript、PHP、Rust、Python、Astro、WordPress 六种 SDK。
下面是把仓库 README 逐节读完后归纳出的中文要点。
Bicho 是跑在 Cloudflare Workers 上的自托管错误追踪服务:通过 OTLP/HTTP 或 Sentry SDK 上报异常与错误日志,用 API 或 MCP 查看归组后的问题,并把捕获到的证据存在你自己的 D1 数据库与 R2 存储桶里;既接受 OTLP 的 JSON 与二进制 protobuf 日志,也接受 Sentry 的错误信封与旧版 store 请求,没有面板也不需要 OpenTelemetry Collector
按语言列出官方 SDK 与集成包:JavaScript 与 TypeScript 用 @bicho-fyi/javascript,支持浏览器自动捕获与 Node.js 显式上报并带队列发送;PHP 用 bicho-fyi/php 需 PHP 8.2+;Rust 用 bicho,在 Tokio 上异步投递并覆盖 Tauri 应用的 Rust 侧;Python 用 bicho-fyi 需 Python 3.11+;另有 Astro 与 WordPress 的可选集成;也可以保留已有 Sentry SDK 只替换 DSN
一键部署按钮会把公开仓库复制到你的账号,开通 D1 与 R2 并配置 Workers Builds,需先在 Cloudflare 账号里启用 R2;提示输入 BICHO_ADMIN_TOKEN 时用 openssl rand -hex 32 生成唯一令牌并保存好供 API 与 MCP 访问;部署脚本会先执行数据库迁移再发布 Worker,实例在 workers.dev 域名上可用,预览域名已关闭
本地开发需 Node 24 与 npm,Worker 依赖 wrangler.jsonc 里的 DB(D1)与 PAYLOADS(R2)绑定,本地开发使用本地存储,部署到已有 Cloudflare 数据库前需替换占位的 D1 ID;把 .dev.vars.example 复制为 .dev.vars 并设置 BICHO_ADMIN_TOKEN,托管实例则用 Cloudflare secret,令牌不可写进 D1、前端代码或 wrangler.jsonc,缺失或为空时管理接口返回 503
在运行中的本地或托管 Worker 上用 MCP 的 create_project 传入名称,或向 POST /api/projects 发同样的 JSON 并带上管理令牌;可选的 hourly_limit 接受 1 到 1000000 的整数,默认 1000,secret: true 会额外要求后端摄取密钥;接口返回 HTTP 201 与项目 ID、上报配置与 Sentry DSN,服务端生成唯一的数字字符串 ID 与随机摄取凭据,只保存摄取密钥的哈希
通过 MCP 或 API 建好 Bicho 项目,把返回的 sentry.dsn 填进现有 Sentry SDK 配置即可,应用原有的错误捕获代码不用动,事件由 Bicho 接收并归组;需要移除的是回放、性能剖析、链路追踪与结构化日志这类集成,因为 Bicho 只存错误与消息事件;发布、环境、标签、自定义指纹、堆栈、面包屑与上下文仍可通过同一套 API 与 MCP 工具获取,但这只是改变新错误的去向,不会导入历史 Sentry 数据,也不复刻其归组规则
uvx --from openapi-spec-validator openapi-spec-validator docs/openapi.json| 主要语言 | JavaScript | 许可 | Apache-2.0 |
|---|---|---|---|
| 创建时间 | 2026-10-15 | 最近提交 | 2026-11-06 |
| 站内采集 | 2026-11-12 起,连续观察 1 天 | 最近一次 | 2026-11-12 |
最近 1 次采集
这个项目刚进入观察名单,还没有足够的历史数据画曲线。
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。