Skip to content

能做什么 ​

Limits

XBuckle 模拟的是开发常用的协议与厂商表面,不是完整云。
下面用来对齐预期:能联调什么、哪里会不够用。日常以桌面 Services 面板里的说明为准。


以下偏技术细节,给需要核对兼容面的人与 AI。

仿真的是厂商/协议表面,不是某个应用的业务捷径。任意项目用官方 SDK / 标准 HTTP 指到本机即可联调——见 厂商面接入。

Provider 目录(shared/service-providers.ts)只含本机可打的云 / 事实标准面。长尾 SaaS 不列。

不确定某条 API 在不在时,读该服务的 limits,或用 MCP services.describe / compat.check。

Wire 强(优先用官方 SDK) ​

服务兼容面主要限制
DatabasePostgres wire + PostgREST /rest/v1 + Realtime CDC(由 REST 写入驱动)PGlite 扩展子集;wire SQL 暂不扇出 CDC
CacheRedis RESP非 Cluster/模块/完整 Lua
SMTP / Mail本地捕获不外发
AuthOIDC + GoTrue /auth/v1OAuth 为本地 auto-code;非真 Google/GitHub

Supabase 形适配器 ​

表面状态
GoTrue signup/login/refresh/magic link可用;用户同步到 auth.users
PostgREST + RLS (auth.uid())常用 filter/rpc/upsert
Storage /storage/v1bucket/object/signed 子集
Realtimeheartbeat/join + postgres_changes(REST 路径)
Edge /functions/v1本机 Deno;需 XBUCKLE_FUNCTIONS_DIR
pgcrypto已加载;pg_net/pg_cron 为 stub

Shape 级 mock(能联调,非全量云) ​

S3、SQS、Secrets Manager、Feature Flags、Search、API Gateway、CDN、Edge Worker rewrite、Billing(Stripe /billing/v1 + Paddle /paddle)、SMS、LLM(echo/stream mock)等。

Billing:

  • Stripe 形:/billing/v1(customers / checkout sessions / invoices)
  • Paddle Billing API 形:/paddle(customers / subscriptions / prices / products / portal-sessions / events + 可选 localhost 签名 webhook)
  • 不模拟 cdn.paddle.com / Paddle.js overlay

LLM:OpenAI 兼容 /llm/v1/chat/completions 与 Anthropic /llm/v1/messages,用于本地 agent 与 edge mock,不是计费云模型。

Explicit non-goals ​

真扣款 / 真短信 / 真邮件外发、SigV4 密码学校验、CF Workers isolate、完整 ES DSL、Redis Cluster 等。见 docs/REALITY-REASSESSMENT.md。

如何自查 ​

  • MCP:services.describe、compat.check
  • 文档站本页
  • 源码:src/data/serviceSim.ts、shared/fidelity.ts