跳转到主要内容
项目是组织和管理相关表格、应用和自动化的容器。每个空间可包含多个项目,每个项目都有独立的资源和协作权限。
界面中的“项目”对应 API 和 CLI 中的 base 资源。baseId 等 API 字段、bse ID 前缀和 /base/... URL 保持不变。
对于不熟悉项目的用户来说,可以将项目类比为 Excel 中的工作簿,每个工作簿可以有多张表。

创建和管理项目

添加项目

  1. 进入空间
  2. 点击右上角创建项目
创建项目

从模板创建项目

模板中心提供可以直接套用的项目。在空间左侧边栏点击 模版,或在创建项目时选择 从模板创建,都可以打开它。在模板详情中点击 使用此模板,选择要放入的空间,Teable 会按模板创建一个新项目。 部分模板是解决方案:它的自动化要连上外部平台才能持续取数,模板详情里会列出需要连接的平台。使用这类模板时,Teable 创建的项目不含示例数据,并先打开一个配置页面:
  1. 页面按平台列出要连接的账号。同一平台需要多个账号时(例如两个 YouTube 频道),每个账号各占一行,分别绑定。某个平台你在 设置 → 集成 中只连接过一个账号时,进入页面会自动绑定它;连接过多个账号时,点击 授权我的 选择要用哪一个。还没连接的,点击 连接账号 走一次 OAuth。
  2. 需要 API Key 的条目列在 需要填写的密钥 下,点击 填写 新建,或选用已保存的 Secret。
  3. 点击 开始,凭据齐全的工作流和 例行任务 会被启用。按计划运行的会立刻先跑一轮,可以在运行历史中看到;由第三方应用事件触发的会等待首个事件。随后进入项目。
配置页面中没连上的集成不会就此丢失。只要项目里还有未连接的集成,页面上会提示 有 N 个集成未连接,点击 去连接 可以随时补上,详见凭据与集成。

重命名/删除项目

  1. 进入空间
  2. 将鼠标悬停在目标项目上
  3. 点击···按钮打开菜单
  4. 点击重命名或删除
重命名或删除项目

整理项目中的资源

进入项目后,左侧目录栏会显示当前项目内的资源,例如表格、应用和自动化。你可以使用文件夹整理这些资源,让大型项目更容易浏览。 常见操作包括:
  • 创建文件夹:在左侧目录栏中创建文件夹,用于归类相关资源。
  • 移动资源:将表格、应用或自动化拖入文件夹,或拖动调整顺序。
  • 整理层级:文件夹可以包含子节点。为了保持导航清晰,请避免创建过深的层级。
  • 添加描述:表格、应用和自动化打开后,资源名称下方会显示 添加描述。点击后可以记录用途、负责人、交接说明或使用规则。首次打开带有描述的资源时,会自动展开;描述更新后,下次打开会再展开一次。
  • 查看节点信息:打开资源的 ... 菜单,选择 节点信息,可查看文件夹、表格、自动化或应用 ID,以及创建和修改信息。

命令面板

按 Ctrl + K(Mac: Command + K),或点击左侧目录栏顶部的搜索图标,打开 命令面板:
  • 跳转:输入名称搜索表格、视图、应用等资源,支持拼音和拼音首字母;不输入内容时显示 最近访问 的资源和视图。找不到时可以直接新建同名表格,或 在当前表中搜索 输入的内容。
  • 执行命令:输入命令名称即可执行,以 > 开头时只搜索命令。可以新建表格、仪表盘、应用、自动化、例行任务、文件夹或视图,邀请协作者,切换外观,或打开设置和键盘快捷键。
  • 问 Cuppy:在项目中输入问题后选择 问 Cuppy,问题会带上当前项目、表格和视图发给 AI 对话,详见 AI 对话。

复制项目到另一个空间

第一步:在当前空间中选择要复制的项目 第二步:点击项目菜单图标并选择复制项目 第三步:在弹出的窗口中选择目标空间,需拥有目标空间的可搭建权限才能完成复制 如果项目较大,复制窗口会显示复制进度。请等复制完成后再关闭窗口。记录修改历史和协作者不会被复制。 如果项目中包含指向其他空间的关联、查找、汇总、条件查找或条件汇总字段,Teable 会在复制前显示受影响字段。继续复制后,Teable 会在新项目中把这些字段转换为单行文本。 复制项目

将项目移动到其他空间

拥有相应空间权限的用户可以把项目移动到其他空间。如果移动后会让关联类字段跨空间引用,Teable 会先提示并列出受影响字段。确认后,Teable 会在移动过程中把这些字段转换为单行文本。

将资源移动到其他项目

表格、文件夹、应用、自动化和例行任务可以移动到同一空间内的其他项目。移动后,资源的数据和配置保持不变,归属改为目标项目。
移动前的检查无法保证找出所有引用,例如自动化脚本或应用代码中的部分引用可能会遗漏。移动后请务必检查相关业务是否受影响,并及时调整。
  1. 在左侧目录栏中打开资源的 ... 菜单,选择 移动。
  2. 在 目标项目 中选择项目,Teable 会先检查这次移动的影响。
  3. 查看检查结果,点击 移动。
  4. 移动完成后,检查相关的自动化、应用和例行任务能否正常运行,必要时及时调整。
检查只读取项目中的配置,不会改动数据。检查结果包括:
  • 能否移动:目标项目不在同一空间、任一项目为只读、权限不足或目标项目已有同名文件夹时,会显示原因并阻止移动。
  • 可能失效的资源:留在原项目、但引用了被移动表格的自动化和应用,移动后可能无法使用。例如自动化的触发器或操作指定了该表,脚本或 HTTP 请求中写有该表 ID,应用用该表登录或在代码中引用了该表。
  • 跨项目关联:被移动表格与留下的表格之间的关联字段会变成跨项目关联,仍可正常使用。
移动所有相关引用 默认开启,会把引用链上的资源一起移动,避免留下失效的引用。关联表不会随之移动。
  • 你需要能在当前项目中删除该资源,并能在目标项目中创建同类资源。
  • 启用权限矩阵时,绑定在当前项目角色上的权限规则无法随资源移动,会被移除。移动后这些资源适用目标项目的权限设置,如需相同限制,请在目标项目重新配置。

导入和导出项目

Connect & Migrate Everything

使用 AI 对话,将 Airtable、Baserow、NocoDB、SmartSuite 等系统迁移到 Teable。

导入项目(数据迁移)

Teable 项目导出文件(.tea)包含项目结构和配置;导出时选择包含记录,文件中才会带有记录数据。导入该文件可恢复项目,或在另一个 Teable 实例中创建项目。适用于以下场景:
  • 数据迁移:在不同 Teable 实例之间迁移项目(如从 Teable Cloud 迁移到私有化部署)
  • 备份恢复:恢复之前导出的项目
  • 模板共享:与其他团队共享完整的项目结构
操作步骤:
  1. 进入空间
  2. 点击空间右上角···按钮打开菜单
  3. 点击导入
  4. 选择 从文件导入,上传 .tea 文件确认导入
导入项目
如果要从 Airtable 创建项目,可以在同一导入窗口中选择 从 Airtable 导入。

导出项目(备份与迁移)

将项目导出为 Teable 项目文件(.tea),用于备份结构和配置,或导入到其他 Teable 实例。如需同时导出记录数据,请开启 包含记录。 操作步骤:
  1. 进入空间
  2. 鼠标悬浮在需要导出的项目上
  3. 点击···按钮打开菜单
  4. 点击导出
  5. 如需包含记录数据,保持 包含记录 开启;关闭后只会导出结构和配置
  6. 点击 开始导出,等待进度完成
  7. 导出完成后,在导出窗口中点击 下载 保存 .tea 文件
导出项目
  • 如需迁移记录数据,请在导出时开启 包含记录。
  • 跨项目关联字段会在导出文件中转换为单行文本。
  • 跨空间复制或移动项目时,跨空间关联类字段会转换为单行文本。
  • 导入后,重新授权所需的集成连接。导出的集成和密钥配置占位信息不包含凭据。

分享项目

项目可以通过公开链接分享。分享范围可以是整个项目,也可以是当前选中的某个节点。
  1. 进入目标项目
  2. 打开项目或节点的分享入口
  3. 开启 公开分享到网络
  4. 复制分享链接或二维码
分享项目入口 分享范围包括: 分享设置中可以配置链接权限、允许查看者复制数据、访问密码,也可以重新生成链接、删除分享链接或复制嵌入配置。开启访问密码后,Teable 会自动生成一个随机密码,点击 复制链接和密码 即可一起发给访问者,详见 分享链接保护。 项目分享设置 如果分享范围中包含应用节点,应用需要先发布后才能通过公开链接访问。

项目内的功能

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