dalao.ai

tldraw

无限画布 SDK

关于 tldraw

tldraw 是一套用 React 构建无限画布应用的 TypeScript SDK，也是免费在线白板 tldraw.com 背后的引擎。它由 tldraw, Inc. 开发维护。截至 2026-10-25，GitHub 星标 51,074，最新版 v5.5.2（2026-10-02），npm 包 tldraw 在 2026-10-16 至 10-22 这一周（按 UTC 统计）下载 381,844 次。源码公开，但不是开源许可证：开发环境里可以免费用，上线到生产环境必须有许可证密钥。商业授权按年签，价格未公开；非商业项目可以申请免费的 hobby 许可，但要保留水印。

编辑部更新于 阅读约 12 分钟

它是什么

它由 tldraw, Inc. 开发维护。仓库里的 COMPANY.md 写明：tldraw 是一家完成 A 轮融资的创业公司，主体是 tldraw, Inc.，运营子公司是 tldraw GB Ltd.。README 的版权行写作「Copyright (c) 2024-present tldraw Inc.」。

来历。创始人 Steve Ruiz 在 A 轮公告里说，tldraw 2021 年作为一个开源业余项目起步，源于他此前在数字墨迹方面的工作。GitHub 仓库创建于 2021-05-09。2022-11-30 公司宣布 270 万美元种子轮，由 Lux Capital 领投；同一篇公告说，新版 tldraw 是一次完全重写，既是应用也是库，并带有自研的实时协作引擎；当时新版还没有开源，公司正在找设计合作伙伴提前试用。2025-04-09 宣布 1,000 万美元 A 轮，由 Lux Capital 和 Definition 领投。公告称第一年的授权销售额接近 100 万美元，客户包括 ClickUp、Padlet、Craft、Jam 等，团队接近 20 人（官方自述）。

产品形态。

  • SDK：npm 包 tldraw，核心是一个 React 组件，这是公司主要的收费产品。
  • tldraw.com：官方免费在线白板，用的就是这套 SDK。
  • tldraw offline：2026-07-16 发布的免费桌面应用，没有账号也没有服务器，文件存在本机，可以让 Claude Code、Codex 这类本机智能体读写画布、加脚本。
  • AI 接入：2026-03-03 在 Cursor 里推出 tldraw MCP App；2026-09-29 推出 ChatGPT 和 Codex 插件，画板就是 tldraw.com 上的文件，需要 tldraw.com 账号。

版本节奏。日期来自 GitHub Releases。v5.0.0 发布于 2026-05-07。此后大约每月一个小版本：v5.4.0 在 09-02，v5.5.0 在 09-30，v5.5.1 和 v5.5.2 都在 10-02。RELEASES.md 写明，它不遵循语义化版本，小版本按月发布，而且可能包含破坏性变更；官方会提前几个版本给出警告，并提供迁移工具。截至 2026-10-25，仓库最近一次推送是 2026-10-24，默认分支最近一次提交是 2026-10-23，未关闭的 issue 和 PR 合计 564，主要语言是 TypeScript。npm 包 tldraw 在 2026-10-16 至 10-22 这一周（按 UTC 统计）下载 381,844 次。

命运和资本都要求 tldraw 能够持续经营下去。

tldraw v4.0.0 发布说明（原文为英文，截至 2026-10-25）

核心能力

以下按 README、官方文档和发布说明整理，功能描述属于官方自述。

画布引擎。支持压感绘图、几何形状、富文本、箭头、吸附、图片和视频，可以导出图片。默认的白板工具集可以直接用，也可以只用底层原语，做全新的形状和交互。

可扩展。可以自定义形状、工具、绑定关系（bindings）、UI 组件、副作用和事件钩子；运行时用 Editor API 驱动画布。

网页渲染。画布基于 DOM 渲染，浏览器能显示的内容都能放上去，包括嵌入 YouTube、Figma、GitHub 等网站。

多人协作。@tldraw/sync 是官方的实时同步库，tldraw.com 线上用的就是它。官方托管的演示服务只适合做原型，生产环境必须自己部署。文档推荐用官方的 Cloudflare 模板：每个房间对应一个 Durable Object，提供 WebSocket 服务，房间状态存在它自带的 SQLite 里，图片和视频存进 R2。模板不包含认证和权限、上传的限流和大小限制、长期历史快照、房间列表和搜索，这些要自己补。

5.0 的新东西。主题系统和 display values，可以统一修改默认形状的颜色、线宽、字号；OverlayUtil 叠加层；自定义记录类型、资源类型和几何形状。新增两个包：@tldraw/driver 用来以命令方式控制编辑器，@tldraw/mermaid 把 Mermaid 图转成原生形状。另外还有形状归属记录（TLUserStore）、同步服务的 WebSocket 休眠，以及从右到左书写的语言支持。

5.5 的新东西。v5.5.0 的发布说明称，这一版是对 SDK 的一次全面可靠性修整：形状在拖动、缩放、旋转或裁剪的过程中，会保留其他命令和远端同步同时做出的修改；浏览器取消指针事件后，触摸手势不再卡住；富文本加入智能标点和选区包裹；Mermaid 时序图的转换修了一批排版问题。v5.5.2 修复了从 blob: 地址加载页面时许可证域名校验的问题。

入门套件。运行 npx create-tldraw@latest 可以从模板起步。入门套件全部按 MIT 授权，包括多人协作、智能体、工作流（节点加连线）、聊天、图像流水线、分支对话和着色器。

AI 方面的积累。2023 年 11 月，Figma 工程师 Sawyer Hood 用 tldraw 组件做了一个演示：把手绘的界面截图发给 GPT-4V，得到能运行的网页。tldraw 团队随后上线了 makereal.tldraw.com，用户填自己的 OpenAI API key 就能用。后来的智能体入门套件、MCP App 和桌面版的智能体脚本，都延续了这条线。

和同类比

和两款同类产品对比，数据截至 2026-10-25。

Excalidraw。手绘风格的白板，也以 React 组件的形式提供给开发者嵌入。许可证是 MIT，GitHub 星标 134,510，约是 tldraw 的 2.6 倍。最新正式版 v0.18.1 发布于 2026-04-21，发版间隔比 tldraw 长得多。官方托管服务 Excalidraw+ 有永久免费的 Free 档；Plus 档年付每人每月 $6，月付每人每月 $7，有 14 天免费试用。它的长处是许可证宽松，可以免费上线商用。tldraw 则把 SDK 当作主业，扩展接口、官方多人同步方案和入门套件都是围绕开发者设计的，更新也更勤。

React Flow（xyflow）。专做节点加连线界面的 React 库，另有 Svelte 版。许可证是 MIT，GitHub 星标 38,769。它的收费方式是可选订阅 React Flow Pro：按月付 Starter 每月 $169、Professional 每月 $289，企业版询价；订阅换来 Pro 示例、优先处理 issue 和直接支持。官方说，订阅收入是为了让库继续保持 MIT 许可。它做的不是自由画布，而是节点图编辑器；tldraw 的工作流入门套件覆盖的是同一类需求。

怎么选。最大的区别在许可证。两个对手都是 MIT，可以免费上线；tldraw 上线必须有密钥，商业使用要付费，价格要和销售谈。按需求分：自由绘制、多人协作和深度定制是 tldraw 的重点，前提是承担授权费；免费商用的白板有 Excalidraw，MIT 许可没有这项成本；只做节点和连线的需求有 React Flow，它专门做这一类。

适合谁 / 不适合谁

适合谁

要在自己的产品里做白板、画布或图编辑器的商业团队，有预算买授权，想少写底层画布代码。官方列出的客户有 ClickUp、Padlet、Autodesk 等（官方自述）。

早期创业公司：定价页提供创业公司价格，可以申请，折扣幅度未公开。

非商业项目和个人作品：可以申请免费的 hobby 许可，但要保留「made with tldraw」水印，并且每个申请都要人工审核。

只想用白板的普通用户：tldraw.com 和桌面版 tldraw offline 都免费。

在做 AI 画布或智能体可视化原型的开发者：开发环境不需要密钥，智能体入门套件可以直接改。

不适合谁

法务只接受 OSI 开源许可证的组织：官方许可证说明页写明，它不是任何定义下的开源软件。

想零授权费上线商业产品的团队：没有有效密钥，生产环境里的编辑器会在 5 秒后停止渲染。

想给上游贡献代码的人：README 和 CONTRIBUTING.md 写明目前不接受外部贡献，仓库已关闭 PR，只收 issue。

接受不了每月小版本可能带破坏性变更的项目。

不用 React 的前端项目：SDK 的入口就是 React 组件。

上手路径

只用白板。直接打开 tldraw.com，免费。多人共享和 ChatGPT、Codex 插件需要 tldraw.com 账号。想用本地文件、让本机智能体操作画布，到 offline.tldraw.com 下载桌面版。

开发。运行 npm i tldraw，在 React 里渲染 Tldraw 组件，并引入 tldraw/tldraw.css；也可以用 npx create-tldraw@latest 从模板和入门套件起步。克隆仓库在本地开发需要 Node.js 22.12 或以上（README 写 ^20，以 package.json 为准）。

先弄清什么算生产环境。这里要分开两件事。法律上，LICENSE.md 把生产环境定义为任何向终端用户、客户或公众提供功能的部署；开发环境只指组织内部用于开发、测试或预发布、终端用户和公众访问不到的部署。只要对外提供服务，就需要授权。技术上，许可证密钥文档描述的是 SDK 的检测规则：不是 HTTPS、主机是 localhost 或回环地址、NODE_ENV 不是 production，满足任意一条，SDK 就当作开发环境、不校验密钥；三条都不满足才要求密钥。SDK 不校验，不等于许可证允许：用 HTTP 或非 production 构建对外提供服务，按 LICENSE.md 仍然是生产使用。

上线之前。先申请 100 天免费试用，每个公司或项目只能申请一次，密钥会立刻发到邮箱。密钥通过 licenseKey 属性传入，也可以设置 TLDRAW_LICENSE_KEY、VITE_TLDRAW_LICENSE_KEY、NEXT_PUBLIC_TLDRAW_LICENSE_KEY 等环境变量。密钥在本地验签，不需要联网，可以放在前端代码里；密钥里写明了允许的域名，部署到其他域名会被当作没有授权。

多人协作需按 sync 文档部署官方 Cloudflare 模板，再自己补上认证、限流和备份。

升级。每月看一次发布说明。5.0 起官方提供了一个实验性的迁移技能，可以交给编程智能体执行，但官方也提醒结果要人工复查。

定价与许可证

以下信息截至 2026-10-25，来源是 tldraw.dev/pricing、许可证密钥文档和 LICENSE.md。

  • 试用：100 天免费，不需要信用卡，没有水印。到期立即失效，没有宽限期。
  • 商业授权：按年签。定价页写的是「按价值定价」，要通过表单联系销售，价格未公开。商业授权去掉水印，商业项目上线必须购买。年度授权到期后有 30 天宽限期。
  • 创业公司价格：早期创业公司可以申请，具体折扣未公开。
  • Hobby：非商业项目免费申请，保留水印，逐个审核。
  • 定价页写着高级模块（premium modules）正在开发中，多人同步已包含在内。
  • 早年卖过永久授权，绑定版本使用；现在除特殊情况外已经不再出售，老客户继续支持。

许可证原文。LICENSE.md 是 tldraw 自己写的许可证，许可方是 tldraw, Inc.，适用美国特拉华州法律。它允许在开发环境里使用、修改和打包；不允许未经授权用于生产，不允许干扰许可证密钥校验，也不允许把它作为独立产品分发。条款还写明，软件可能为核查合规收集使用数据。终止条款规定：违反任何条款，或者对 tldraw、其关联方或该软件的任何用户提出版权、商业秘密或专利主张，授权都会自动终止。GitHub 识别不出标准许可证类型，npm 上的许可证字段写作「SEE LICENSE IN LICENSE.md」。

会回传什么数据。许可证密钥文档（2026-01-31 编辑）写明：商业授权不回传任何数据；hobby 和试用授权会把授权 ID、授权类型、SDK 版本和页面地址发给 tldraw 做统计（同一页的正文还列了构建环境）；没有授权的生产部署会发送 SDK 版本和页面地址；开发环境什么都不发。官方说不收集用户数据和画布内容。

许可证的变迁。按根目录 LICENSE 和 LICENSE.md 的提交历史、npm 上 @tldraw/tldraw 各版本的许可证字段，以及各版发布说明：

  • 2021 年至 2023 年初（v1）：MIT。2021-05-09 初始提交的 LICENSE 版权方写作 Steve Ruiz，后来先后改为 Stephen Ruiz Ltd 和 tldraw GB Ltd；1.x 的最后一版 1.29.2（2023-04-01）仍是 MIT。
  • 2023 年 3 月至 12 月（v2 重写的 alpha 期）：Apache 2.0。npm 上 2.0.0-alpha.9（2023-03-22）到 alpha.19（2023-12-12）的许可证字段都是 Apache-2.0，仓库根目录的 LICENSE 在 2023-04-25 换成 Apache 2.0。
  • 2023-12-19 的提交「Change licenses to tldraw」删除了 Apache 许可证，改为 tldraw 自有许可证，只允许非商业使用，商业用途要另外购买，同时加入贡献者许可协议 CLA.md。npm 从 2.0.0-beta.1（2023-12-20）起写作「SEE LICENSE IN LICENSE.md」，v2.0.0（2024-02-29）沿用这一许可证。
  • v3.0.0（2024-09-13）放宽：商业和非商业项目都可以用，前提是显示「Made with tldraw」水印；购买 Business License 可以去掉水印。
  • v4.0.0（2025-09-18）收紧：默认只能用于开发环境，上线必须有试用、商业或 hobby 密钥。发布说明的原话是「Fate and capital both demand that tldraw be sustainable」。
  • v5.0.0 的发布说明没有提到许可证变化。

风险与局限

不是开源。源码公开，可以读，也可以改，但能不能上线由密钥决定。官方许可证说明页自己写明，它不是任何定义下的开源软件。依赖它的产品，等于把一部分上线能力交给了供应商的授权续期。

许可证改得勤。2023 年以来许可证改了 4 次：v2 重写的 alpha 期从 MIT 改为 Apache 2.0；2023 年底从 Apache 2.0 改成只许非商业使用；3.0 放宽为带水印可以商用；4.0 又收紧为上线必须有密钥。许可证由 tldraw, Inc. 制定；贡献者须签 CLA.md（1.0 版，2023-06-08），把贡献的版权和专利许可不可撤销地授予 tldraw, Inc.，并允许它再许可。以后的版本还可能再变。

授权出问题，编辑器会停。没有有效密钥、密钥过期，或者部署的域名不在授权范围内，生产环境里的编辑器会在 5 秒后停止渲染。试用到期没有宽限期，年度授权有 30 天。续期和域名变更要纳入运维流程。

升级可能破坏代码。它不遵循语义化版本，小版本每月一次，可能包含破坏性变更，官方建议跟着节奏升级。

两份官方文档说法不一致。许可证说明页（tldraw.dev/community/license）写着商业和 hobby 授权不发送任何数据，只有试用会发送密钥的哈希值。这一页的页脚日期是 2023-09-13，但内容讲的是试用、商业、hobby 三类密钥，而 hobby 许可证要到 v4.0.0（2025-09）才出现，页脚日期和内容对不上。许可证密钥文档（页脚 2026-01-31）写的是 hobby 授权也会回传授权 ID、SDK 版本和页面地址，没有授权的生产部署也会发送 SDK 版本和页面地址。

安全策略没更新。SECURITY.md 的受支持版本表只列了 3.x.x，而当前已经是 5.x；漏洞要发邮件到 hello@tldraw.com 报告。截至 2026-10-25，仓库的安全页没有已发布的安全公告。

不收外部代码。CONTRIBUTING.md 写明仓库已关闭 PR。官方在 issue #7695（2026-01-16）里解释：AI 生成的 PR 大量增加，因此开始自动关闭外部贡献者的 PR；官方称这是在 GitHub 提供更好的管理工具之前的临时政策，issue、bug 报告和讨论照常欢迎。

多人同步要自己运维。官方托管只是演示；生产环境要自己部署，认证、上传限流和大小限制、历史备份也要自己做。

客户名单来自官方。README 列出的 Google、Shopify、BlackRock、Autodesk 等客户均为官方自述，具体用在哪些产品、用到什么程度，官方没有说明。

我们的判断

tldraw 把无限画布做成了一个可以直接买来用的零件。画布手感、扩展接口和更新速度都不错，官方自己的在线白板、桌面版和 AI 插件也说明，这套 SDK 撑得起真实产品。代价在许可证：开发免费，上线要密钥，商业价格要谈，而且许可证 2023 年以来改了 4 次。

采用 tldraw 涉及三方面的条件：

  • 授权：试用期 100 天，到期没有宽限期；年度商业授权的价格需联系销售，绑定授权域名，到期后有 30 天宽限期。
  • 法务：条款不是开源许可，部分授权类型会回传使用数据，许可证 2023 年以来改过 4 次。
  • 升级：小版本每月发布一次，可能包含破坏性变更。

免费商用的白板有 Excalidraw，节点和连线有 React Flow；深度定制的多人画布是 tldraw 的定位，商业上线需要付授权费。

亮点

tldraw 最初是 Steve Ruiz 自己的画图应用，后来成了一套无限画布 SDK，被用来做设计工具、白板，以及一度刷屏全网的“make real”：tldraw 团队在 Sawyer Hood 的草图转网页演示基础上做出的画布，能把手绘草图变成可用的界面。

底下的工程很扎实：响应式状态库、自定义图形系统、多人实时同步，以及一块放上几千个对象依然流畅的画布。这一切都能在 GitHub 上读到。

它是一套无限画布 SDK，包含响应式状态库、自定义图形和多人同步，代码在 GitHub 上可读；make real 就建在它之上。

资料来源

官方

  1. GitHub - tldraw/tldraw: Build infinite canvas apps in React with the tldraw SDK.GitHub · 访问于 2026 年 10 月 25 日
  2. tldraw/LICENSE.md at main · tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日
  3. History for LICENSE.md - tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日
  4. History for LICENSE - tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日
  5. tldraw/CLA.md at main · tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日
  6. tldraw/CONTRIBUTING.md at main · tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日
  7. Contributions policy · Issue #7695 · tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日
  8. tldraw/COMPANY.md at main · tldraw/tldrawGitHub · 访问于 2026 年 10 月 25 日

动态与深度阅读

版本更新GitHub 版本发布 · tldraw v5.5.0：富文本支持智能排版

tldraw v5.5.0 为画布上的富文本加入智能排版，直引号会变成弯引号，-- 变成破折号；选中文字后输入括号或引号会把选区包起来。这一版对 SDK 做了一轮可靠性修复，形状在拖动、缩放、旋转或裁剪时会保留其他命令的改动。 tldraw 现在重新导出 TipTap 的扩展 API，自定义富文本扩展不必再单独安装 @tiptap/*；Editor.setCamera 遇到非有限值会直接报错。