Teable：把 AI Agent 放进真实业务数据的开源表格数据库

一、故事化开场：一个 CTO 的周三下午

某SaaS公司的CTO在飞书群里提了个需求：销售要能自助登记线索、主管要能自动看到本周转化异常、还要能一键生成报价单。研发排期四个月。这是绝大多数公司用 SaaS 的真实困境——软件覆盖了 70% 的需求，剩下 30% 要靠人 bending process 绕过去。

如果把 Airtable、飞书多维表格、Notion 数据库、Supabase 这四类工具摆在一起看，Teable 的差异化并不在"功能更多"，而在于它把 Agent 的工作面从真空搬到了生产数据上。市面上的 AI 应用生成器（bolt.new、v0、Base44）都能一句话生成一个能跑的 App，但生成出来的 App 背后是一个空的数据库——它不知道你团队的审批规则、不知道你的客户字段口径、不知道哪些数据不能给模型看。Teable 的主张是：先有真实 PostgreSQL 里的真实表、真实权限、真实协作关系，Agent 再在这套既有工作现场里干活。

二、背景科普：Teable 从何而来

Teable 由 Teable, Inc.（团队自称 "tea artist"）开发，2022 年 11 月在 GitHub 建仓，2026 年 7 月发布 3.0 版本，定位从"类 Airtable 表格"升级为"AI Spreadsheet for Business"。仓库 default branch 是 develop，主 release 走 publish-release.yml 工作流，官方镜像 ghcr.io/teableio/teable。

理解 Teable 的关键在于它是一个 单仓多包（pnpm monorepo），仓库顶层结构已经把架构说清楚了：

• apps/nestjs-backend —— 业务后端，NestJS 12 + Express 5，55 个 feature 模块（table、record、field、view、base、attachment、automation、plugin、audit、auth、oauth、share、risk-control 等），S3 附件、Redis 缓存与队列、Prisma ORM、OpenTelemetry + Sentry 可观测性
• apps/nextjs-app —— Next.js 前端，Tailwind + shadcn/ui（@teable/ui-lib），Playwright + Vitest 双测试栈
• packages/ —— 12 个共享包：core（领域模型）、db-main-prisma / db-data-prisma（主库与数据分离的双 Prisma schema，这是百万行级表格的关键设计）、formula（公式引擎）、sdk、openapi、i18n-keys
• packages/v2/ —— 40+ 个子包，是正在重写的 v2 内核：DDD 领域驱动 + 六边形架构，v2-core 是 Table 限界上下文（table/field/view/record/formula），adapter-* 是 PostgreSQL / SharedDB / Keyv 等端口适配器，contract-http-* 是 Express / Fastify / Hono 三套薄路由适配器
• dockers/ —— Docker 资产，dockers/teable/Dockerfile 是 Node 24 三阶段构建（deps → builder → runtime），dockers/examples/standalone/docker-compose.yaml 是一键起服方案

agents.md 这个文件本身就很有信息量——它是一份给 AI 编码助手看的架构约束文档，规定 v2 的路由要用 action 风格（/tables/create）而不是 RESTful 嵌套资源，规定 v2-core 里不许泄漏宿主概念。一个项目愿意把给 Agent 看的架构守则写进仓库主干，说明 Agent 已经是它的一等公民。

三、类比：把 Teable 想成"数字化车间"

• PostgreSQL 是车间的地基和机床，所有数据真材实料落在钢板上
• 电子表格 UI 是工位操作面板，工人（业务同事）不用懂 SQL 就能上手
• AI Chat / AI Automation 是车间的智能工长，听懂人话并驱动机床
• App Builder + Sandbox 是试制车间——Agent 在隔离沙箱里搭出样品，验证通过后固化成一条长期运行的生产线容器
• Infra Service 是调度中控，把沙箱、构建、部署、预览网关串起来

四层套在一起，才是"一个平台同时是数据库、自动化引擎、AI 沙箱平台和应用托管平台"的说法。

四、核心功能与实用场景

1. AI Chat —— 自然语言直接操作线上数据 后端 src/features/ai/ai.service.ts 基于 Vercel AI SDK（ai 7.x）实现 generateText / streamText，通过 ai-gateway-models.service.ts 做模型网关，Provider 覆盖 OpenAI、Anthropic、Google、Azure、AWS Bedrock、Cohere、Mistral、DeepSeek、Together AI、xAI、OpenRouter。模型分档（MODEL_TIER_IDS）带定价与额度比例，配置解密后注入 decryptAiIntegrationSecrets。场景：让业务方直接问"本月哪个渠道的续费率掉了"。

2. AI Automation —— 记录变更/定时/Webhook 触发的 AI 步骤 BullMQ 做队列，支持定时任务、字段自动填充、批量生成与补全，AI 步骤在数据所在处完成推理，不做跨系统搬运。

3. App Builder —— 描述需求，Agent 在沙箱里造 App 并一键发布 每个 AI 会话独享一个隔离容器，随用随起；生成的应用作为长期容器运行在 *.app. 子域。这一步是它和"AI 应用生成器"最大的分野：生成物接的是同一个 PostgreSQL，不是新孤岛。

4. MCP 与 Agent Skill（2026 年新增） 官方博客记录了 "Connect AI tools to Teable with MCP"（2026-10-20）和 "Teable Skill for AI Agents"（2026-07-28），Claude Code / Codex / Cursor 可直连建表、查数、建自动化。

5. 表格数据库本体 Grid / Form / Kanban / Gallery / Calendar 视图、公式、字段类型转换、筛选分组聚合、记录历史与撤销重做、实时协作、附件预览、批量编辑、导入导出、图表、插件、SQL 查询。2026-08-11 上线的 Data Archiving 支持"无限行"；2026-08-18 支持在 App Builder 里直接写 AI 特性。

6. 2026 年的商业化动作 上架 App Store 与 Google Play（2026-10-30）、GDPR 合规（2026-10-27）、连接 1500+ 应用与采集 800+ 网站数据、GPT-6 / GPT-5.6 接入、GPT-6 Sol 与 Luna 上线。同期 Bending Spoons 以 12.9 亿美元收购 Airtable（2026-08-05），Airtable 用户正被批量导向开源替代品——这是 Teable 增长曲线上最陡的一段外部推力。

五、上手门槛：CLI 与 Web UI 的实际差距

最省事：官方 SaaS（teable.ai） 注册即用，AI 能力全开，不用管任何基础设施，缺点是数据在别人家。

社区版自托管（standalone）

git clone https://github.com/teableio/teable.git
cd teable/dockers/examples/standalone
cp .env.example .env   # 填 POSTGRES_PASSWORD / REDIS_PASSWORD / SECRET_KEY
docker compose up -d

访问 3000 端口。需要提前准备域名与 HTTPS（建议 Caddy/Nginx 反代）。注意：standalone 不含 AI 能力——README 里明确写了 AI Chat、Agent、App Builder 在 standalone 下是 ❌，因为沙箱与 runtime plane 需要额外的 Infra Service、Sandbox 引擎、Git registry、预览网关和对象存储。社区版以 AGPL-3.0 免费自托管，AI 功能属商业版，靠 license key 原地激活，不用换镜像。

全功能自托管 走 teableio/teable-deployment 仓库（Compose 或 Helm chart），资源需求上一个台阶，官方也推荐直接把该仓库丢给 Claude Code / Codex 加域名和 DNS token 让 Agent 自动部署完。已在跑 standalone 的可按迁移指南原地升级，数据不动。

源码开发 Node 24 + pnpm 12 + corepack，pnpm install → make switch-db-mode → cd apps/nestjs-backend && pnpm dev（后端会自动带起 Next.js 前端）。全仓 pnpm workspace，pnpm g:test 跑 E2E + 单测。

六、争议与局限

• AGPL-3.0 + 商业双轨：核心应用 AGPL-3.0、packages/ 下为 MIT，但 AI 能力锁在付费版。自托管用户装完发现"AI 全是 ❌"是很常见的落差，README 里的能力对照表要仔细读。
• 社区版 ≠ 开源全功能：想要 AI Chat/App Builder 又想完全免费，路径只有"自己用社区版 + 自己接 LLM API"，App Builder 那一层基本没法复刻。这是商业模式上的关键取舍，也是它相对 Airtable 的最大不确定项。
• 沙箱架构吃并发：官方文档明说机器要按峰值并发 AI 会话数而非用户数来配。团队协作场景下并发一高，资源曲线很陡。沙箱与已部署应用都是容器，运维复杂度并不低。
• v2 重写仍在进行中：packages/v2/ 有 40+ 个包和独立的 benchmark / e2e 工作流，v1 与 v2 并存（FORCE_V2_ALL=true 等开关用于切流），说明核心正在换代期，架构仍在演进。
• Airtable 被收购是机会也是阴影：12.9 亿美元卖掉 Airtable 既是导流利好，也提醒所有人——这条赛道正在被资本定价，竞品（Baserow、NocoDB、飞书多维表格）都会加大投入。
• AGPL 对二次开发者的约束：改闭源产品并对外提供服务会触发源码开放义务，二次开发前必须读 LICENSE 全文。

七、行业意义

Teable 代表的是 "AI 原生业务系统"这条技术路线：不再把 AI 做成外挂式的聊天框，而是让 Agent 直接活在业务数据和权限体系内部。它的三个技术选择——真实 PostgreSQL 作为唯一事实源、Agent 沙箱与数据同域部署、把 App Builder 产物接回同一数据库——共同构成了"AI 不在孤岛里工作"的可落地形态。

从 GitHub 数据看，它的 21939 star、1356 fork、约 40 位贡献者、TypeScript 主导、2026-10-30 仍在 push，在开源多维表格赛道已经是第一梯队。对企业 IT 团队的现实意义是：可以用一套 AGPL 自托管平台替代 Airtable/飞书多维表格的组合，把数据主权、模型密钥、审计与权限一起握在手里——代价是要接受社区版无 AI 这个硬边界，并且自己承担沙箱集群的运维。

对想借鉴的开发者，最值得抄的三件事是：主库/数据分离的双 Prisma schema（百万行级表格的关键）、v2 的 DDD + 端口适配器分层（让核心可脱离 Web 框架演进）、以及把给 Agent 看的架构守则写进仓库主干。