TanStack AI 1.0：不锁厂商的开源智能体工具链
2026 年 10 月 23 日 1.0：76 个包一起转正，23 个厂商适配器、9 个前端框架、11 家沙箱，能跑 Claude Code 与 Codex 这类编码智能体；新增子智能体、Portable Agent Skills、上下文压缩与 computer use，唯一实验性的是 agent harness
工具界面
交互式工具即将上线
功能特点
- ✓ 适配器管够：23 个厂商适配器外加 openaiCompatible，任何 OpenAI 风格接口都能接，换模型不用改业务代码
- ✓ 前端框架通吃：React、Vue、Solid、Svelte、Preact、Angular、Octane、Remix 和原生 JS 都有对应包
- ✓ 编码智能体进沙箱：支持 Claude Code、Codex、OpenCode、Grok Build 与任何 ACP 智能体，沙箱供应商 11 家
- ✓ 子智能体与技能复用：chat() 和 useChat 能把回合交给研究员、写手这类具名子智能体，SKILL.md 技能任意工具调用模型可按需加载
- ✓ 可上线才叫 1.0：每个 PR 跑 943 个确定性端到端测试、覆盖 17 个适配器，还提供上下文压缩与 computer use
使用步骤
- 先统一版本线：1.0 的客户端要配 1.0 的服务端，把所有 @tanstack/ai* 包一起升，别分批
- 核对清单：0.x 里标了 deprecated 的 API 在 1.0 已移除，但替代方案在 0.x 就已上线，按弃用警告迁过的基本就到位了
- 把 provider 适配器和沙箱路径先跑通一个最小用例，本地和 staging 各验证一遍再谈迁移全量业务
- 要用 agent harness 就做好心理准备：官方明确它还是实验性 API，小版本里可能变，别把它写进核心链路
常见问题
TanStack AI 1.0 是什么？
TanStack 的开源 AI 与智能体框架，2026 年 10 月 23 日发布 1.0，76 个包同时转正。官方表述是：不到一年前它还只是一个 chat() 函数加四个 provider，如今已是涵盖 chat、工具、媒体、MCP、持久化、沙箱和智能体的工具链，23 个 provider 适配器和八个 UI 框架，超过 140 人参与。官方文章 https://tanstack.com/blog/tanstack-ai-1-0
1.0 相比 0.x 有什么破坏性变化？
官方说法是「1.0 没有新概念」：所有在 0.x 中标记为弃用的 API 被移除，而它们的替代品在 0.x 就已经发布过。所以按弃用警告一路跟下来的人基本不用大改。要提醒的一点是升级必须整条版本线一起动——1.0 的客户端需要 1.0 的服务端。
为什么不直接用某个厂商的 SDK？
它的卖点就是不锁厂商。官方把 1.0 的意义定义为对 API 的正式承诺，并强调 provider、框架、沙箱以及它们之间的传输协议都仍由你挑。实际价值出现在换模型、换沙箱或把智能体嵌进编辑器时——业务代码不用跟着改。对比数据：Alpha 阶段 4 个适配器，现在 23 个。
测试做得够不够？
官方给了可核对的数字：Beta 阶段每个 PR 跑 265 个确定性端到端测试、覆盖 10 个 provider；1.0 分支跑 943 个、覆盖 17 个适配器。这是少见的把测试规模写进公告的项目，但端到端测试覆盖率高不等于你的业务链路就安全，本地和 staging 仍要自己验。
agent harness 能用了么？
能用但不是稳定 API。官方在 1.0 公告里明确把它单列为唯一例外——agent harness 的 API 仍是实验性的。换句话说：可以拿来试验和评估，不要把它写进对可用性有承诺的核心链路，小版本升级时做好它变化的准备。
有哪些值得先用的新能力？
官方在「RC 之后落地了什么」里点了几项：子智能体（把回合交给具名子智能体，带类型化输入与限制）、decide() 做类型化选择/打分/布尔判断、Portable Agent Skills（任意工具调用模型可按需加载 SKILL.md）、上下文压缩 compaction、computer use（同一份代码在 OpenAI 与 Anthropic 上跑）。按你最缺的那块先试。