界面中的“项目”对应 API 和 CLI 中的
base 资源。baseId 等 API 字段、bse ID 前缀和 /base/... URL 保持不变。创建和管理项目
添加项目
- 进入空间,在侧栏点击 项目
- 点击右上角
创建项目

从模板创建项目
模板中心提供可以直接套用的项目。在空间左侧边栏点击 模板,或在创建项目时选择 从模板创建,都可以打开它。在模板详情中点击 安装,选择 新建项目(以模板命名的新项目)或 添加到现有项目(放进你可以编辑的项目中),再点击 安装。从分享链接安装时,会先选择空间。每个模板都会放进项目里自己的文件夹,是否带示例数据由模板发布者决定。 如果模板中的自动化需要连接外部平台,模板详情会列出这些平台。安装后,Teable 会打开项目的对话,并在输入框上方显示 连接账号,让模板跑起来 卡片:- 按平台连接账号。同一平台需要多个账号时(例如两个 YouTube 频道),每个账号各占一行,分别绑定。某个平台你在 设置 → 集成 中只连接过一个账号时会自动绑定它;连接过多个账号时,点击 授权我的 选择要用哪一个。还没连接的,点击 连接账号 走一次 OAuth。
- 需要 API Key 的条目列在 需要填写的密钥 下,点击 填写 新建,或选用已保存的 Secret。
- 点击 开始,凭据齐全的工作流和 例行任务 会被启用。按计划运行的会立刻先跑一轮,可以在运行历史中看到;由第三方应用事件触发的会等待首个事件。
管理已安装的模板
在空间侧栏点击项目旁的 …,选择 已安装的模板,可以查看项目中每个模板的状态(待配置、运行中、需要处理、已关闭),开关它的自动化,或点击 卸载。卸载会关闭并删除它的自动化和例行任务,它带来的表、应用等会移到回收站,文件夹清空后一并删除。发布到模板中心
点击左上角的项目名称,或在空间侧栏点击项目旁的 …,选择 发布到模板中心。填写名称、详细介绍和封面,选择包含的内容和是否包含示例数据,然后点击 提交审核。审核期间可以点击 撤回;审核通过后模板会上架,被退回时通知中会附上审核备注。之后修改项目需要再次提交,审核通过前,其他人安装到的仍是当前版本。已上架的模板可以点击 下架,已安装的副本不受影响。重命名/删除项目
- 进入空间
- 将鼠标悬停在目标项目上
- 点击
···按钮打开菜单 - 点击
重命名或删除

整理项目中的资源
在空间侧栏点击项目名称旁的 打开资源 文件夹按钮,即可在对话右侧浏览项目目录。目录中包括表格、应用、自动化和例行任务,可以使用文件夹整理。点击资源后,它会在面板的标签页中打开;点击面板顶部的 +(新标签页)可回到资源列表。 常见操作包括:- 创建文件夹:在项目目录中创建文件夹,用于归类相关资源。
- 移动资源:将表格、应用或自动化拖入文件夹,或拖动调整顺序。
- 整理层级:文件夹可以包含子节点。为了保持导航清晰,请避免创建过深的层级。
- 添加描述:表格、应用和自动化打开后,资源名称下方会显示 添加描述。点击后可以记录用途、负责人、交接说明或使用规则。首次打开带有描述的资源时,会自动展开;描述更新后,下次打开会再展开一次。
- 查看节点信息:打开资源的
...菜单,选择 节点信息,可查看文件夹、表格、自动化或应用 ID,以及创建和修改信息。
命令面板
按Ctrl + K(Mac: Command + K),或点击左侧目录栏顶部的搜索图标,打开 命令面板:
- 跳转:输入名称搜索表格、视图、应用等资源,支持拼音和拼音首字母;不输入内容时显示 最近访问 的资源和视图。找不到时可以直接新建同名表格,或 在当前表中搜索 输入的内容。
- 执行命令:输入命令名称即可执行,以
>开头时只搜索命令。可以新建表格、仪表盘、应用、自动化、例行任务、文件夹或视图,邀请协作者,切换外观,或打开设置和键盘快捷键。 - 问 Cuppy:在项目中输入问题后选择 问 Cuppy,问题会带上当前项目、表格和视图发给 AI 对话,详见 AI 对话。
复制项目到另一个空间
第一步:在当前空间中选择要复制的项目 第二步:点击项目菜单图标并选择复制项目
第三步:在弹出的窗口中选择目标空间,需拥有目标空间的可搭建权限才能完成复制
如果项目较大,复制窗口会显示复制进度。请等复制完成后再关闭窗口。记录修改历史和协作者不会被复制。
如果项目中包含指向其他空间的关联、查找、汇总、条件查找或条件汇总字段,Teable 会在复制前显示受影响字段。继续复制后,Teable 会在新项目中把这些字段转换为单行文本。

将项目移动到其他空间
拥有相应空间权限的用户可以把项目移动到其他空间。如果移动后会让关联类字段跨空间引用,Teable 会先提示并列出受影响字段。确认后,Teable 会在移动过程中把这些字段转换为单行文本。将资源移动到其他项目
表格、文件夹、应用、自动化和例行任务可以移动到同一空间内的其他项目。移动后,资源的数据和配置保持不变,归属改为目标项目。- 在项目目录中打开资源的
...菜单,选择 移动。 - 在 目标项目 中选择项目,Teable 会先检查这次移动的影响。
- 查看检查结果,点击 移动。
- 移动完成后,检查相关的自动化、应用和例行任务能否正常运行,必要时及时调整。
- 能否移动:目标项目不在同一空间、任一项目为只读、权限不足或目标项目已有同名文件夹时,会显示原因并阻止移动。
- 可能失效的资源:留在原项目、但引用了被移动表格的自动化和应用,移动后可能无法使用。例如自动化的触发器或操作指定了该表,脚本或 HTTP 请求中写有该表 ID,应用用该表登录或在代码中引用了该表。
- 跨项目关联:被移动表格与留下的表格之间的关联字段会变成跨项目关联,仍可正常使用。
- 你需要能在当前项目中删除该资源,并能在目标项目中创建同类资源。
- 启用权限矩阵时,绑定在当前项目角色上的权限规则无法随资源移动,会被移除。移动后这些资源适用目标项目的权限设置,如需相同限制,请在目标项目重新配置。
导入和导出项目
Connect & Migrate Everything
使用 AI 对话,将 Airtable、Baserow、NocoDB、SmartSuite 等系统迁移到 Teable。
导入项目(数据迁移)
Teable 项目导出文件(.tea)包含项目结构和配置;导出时选择包含记录,文件中才会带有记录数据。导入该文件可恢复项目,或在另一个 Teable 实例中创建项目。适用于以下场景:
- 数据迁移:在不同 Teable 实例之间迁移项目(如从 Teable Cloud 迁移到私有化部署)
- 备份恢复:恢复之前导出的项目
- 模板共享:与其他团队共享完整的项目结构
- 进入空间
- 点击空间右上角
···按钮打开菜单 - 点击
导入 - 选择 从文件导入,上传
.tea文件确认导入

导出项目(备份与迁移)
将项目导出为 Teable 项目文件(.tea),用于备份结构和配置,或导入到其他 Teable 实例。如需同时导出记录数据,请开启 包含记录。
操作步骤:
- 进入空间
- 鼠标悬浮在需要导出的项目上
- 点击
···按钮打开菜单 - 点击
导出 - 如需包含记录数据,保持 包含记录 开启;关闭后只会导出结构和配置
- 点击 开始导出,等待进度完成
- 导出完成后,在导出窗口中点击 下载 保存
.tea文件

- 如需迁移记录数据,请在导出时开启 包含记录。
- 跨项目关联字段会在导出文件中转换为单行文本。
- 跨空间复制或移动项目时,跨空间关联类字段会转换为单行文本。
- 导入后,重新授权所需的集成连接。导出的集成和密钥配置占位信息不包含凭据。
分享项目
项目可以通过公开链接分享。分享范围可以是整个项目,也可以是当前选中的某个节点。- 进入目标项目
- 打开项目或节点的分享入口
- 开启 公开分享到网络
- 复制分享链接或二维码

分享设置中可以配置链接权限,也可以重新生成链接或删除分享链接。展开 高级选项 后,可以设置 允许查看者复制数据、需要密码访问 和 嵌入配置。开启访问密码后,Teable 会自动生成一个随机密码,点击 复制链接和密码 即可一起发给访问者,详见 分享链接保护。

项目内的功能
项目可包含多个表格,用于组织和管理工作相关的各类信息。 例如,客户管理项目可包含”客户公司”、“客户联系人”、“客户跟进记录”等表格;会议室管理项目则可包含”会议室信息”、“设备管理”、“预约记录”等表格。 因此,项目的主要功能都围绕表格展开- 创建表格:可根据项目需求创建新表格,自定义表格结构、字段类型和数据格式
- 编辑表格:支持对现有表格进行编辑,包括添加、删除和修改记录
- 导出和导入数据:支持将数据导出为 CSV 格式,也可导入 CSV 和 XLSX 格式的数据文件

