用途:在用户需求与 TanStack CLI 有效集成选项之间做选择,把生态合作伙伴意图显式映射为可安装的 add-on id。使用前需熟悉脚手架与发现流程,建议先阅读 create-app-scaffold 与 query-docs-library-metadata。
主要能力与用法:
- 发现生态与可安装项: npx @tanstack/cli ecosystem --json npx @tanstack/cli create --list-add-ons --json
- 按类别筛选伙伴: npx @tanstack/cli ecosystem --category database --json
- 选择提供方前查看选项面: npx @tanstack/cli create --addon-details drizzle --json npx @tanstack/cli create --addon-details prisma --json
- 每个互斥类别只选一个,例如: npx @tanstack/cli create my-app --framework react --add-ons clerk,drizzle --deployment cloudflare -y
常见错误:把生态伙伴 id 直接当 add-on id 使用(ecosystem 含非直接可安装伙伴,可能导致 add/apply 后期失败);跳过 addon-details 直接选提供方(带选项的提供方可能静默取默认值,产生错误数据层栈);同时选择多个互斥集成(互斥类别只允许一个有效选择,多选可能丢弃或替换目标提供方);在 --router-only 模式下假设支持部署集成(该模式会忽略部署集成,命令成功但未应用目标)。
限制与张力:兼容模式可能静默剥离集成标志,与 create-app-scaffold 的假设冲突;若为图省事跳过发现元数据,集成选择容易漂移。参考资料涉及认证提供方、数据层提供方与部署目标。