能做什么
Limits
XBuckle 模拟的是开发常用的协议与厂商表面,不是完整云。
下面用来对齐预期:能联调什么、哪里会不够用。日常以桌面 Services 面板里的说明为准。
以下偏技术细节,给需要核对兼容面的人与 AI。
仿真的是厂商/协议表面,不是某个应用的业务捷径。任意项目用官方 SDK / 标准 HTTP 指到本机即可联调——见 厂商面接入。
Provider 目录(shared/service-providers.ts)只含本机可打的云 / 事实标准面。长尾 SaaS 不列。
不确定某条 API 在不在时,读该服务的 limits,或用 MCP services.describe / compat.check。
Wire 强(优先用官方 SDK)
| 服务 | 兼容面 | 主要限制 |
|---|---|---|
| Database | Postgres wire + PostgREST /rest/v1 + Realtime CDC(由 REST 写入驱动) | PGlite 扩展子集;wire SQL 暂不扇出 CDC |
| Cache | Redis RESP | 非 Cluster/模块/完整 Lua |
| SMTP / Mail | 本地捕获 | 不外发 |
| Auth | OIDC + GoTrue /auth/v1 | OAuth 为本地 auto-code;非真 Google/GitHub |
Supabase 形适配器
| 表面 | 状态 |
|---|---|
| GoTrue signup/login/refresh/magic link | 可用;用户同步到 auth.users |
PostgREST + RLS (auth.uid()) | 常用 filter/rpc/upsert |
Storage /storage/v1 | bucket/object/signed 子集 |
| Realtime | heartbeat/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
