跳转至

扩展

扩展商店（管理 → 扩展）用于安装由供应商签名的扩展，在不更改 Turbo EA 核心的前提下（「clean core」原则）添加客户专属能力——额外的元模型内容、集成、后台任务，甚至新页面。

扩展有两种安装方式：从内置商店一键安装（实例需能访问互联网），或直接上传文件——扩展是签名的 .teax 包，许可证是签名的文本文件，通常都通过电子邮件发送。基于文件的方式无需商店账户或对外连接，因此在隔离（air-gapped）环境中同样适用。

该页面有两个标签页：商店 用于浏览供应商的扩展目录并一键安装；已安装 用于管理许可证并通过文件安装。

扩展由 Turbo EA 构建并签名——不支持自行构建，也不向第三方开放。如果您需要为贵组织量身定制的功能，我们可以为您构建并授权。请参阅 Turbo EA 咨询服务。

信任机制

两项相互独立的检查保护您的实例：

  1. 来源（签名）。 每个包都带有供应商密钥的 Ed25519 签名。Turbo EA 在上传时验证签名，并在每次后端启动时再次验证。未签名、被篡改或第三方的包都会被拒绝——已安装的扩展保证与供应商构建的完全一致。
  2. 激活（许可证）。 签名的许可证文件列出您的授权——每个扩展一项，各有自己的到期日。已安装的扩展只有在存在可用授权时才会运行。许可证绑定到您的实例 ID——为其他实例签发的许可证会被拒绝。

您的实例 ID

每个安装都会一次性生成唯一的实例 ID（TEA-XXXX-XXXX-XXXX），显示在 管理 → 扩展 页面顶部，并带有复制按钮。它是您的许可身份：购买时请提供它（应用内商店会自动发送；在线商店结账时会要求填写），这样为该实例购买的每个扩展——无论由哪位管理员、使用哪个邮箱购买——都会汇入同一份组合许可证。它仅用于标识您的实例；绝不是凭证，因此可以放心提供给供应商。

该 ID 会随工作区转移一起迁移，因此迁移到新主机后许可证仍然有效。完全重装后实例会获得新 ID——请供应商为新 ID 重新签发许可证（供应商侧的快速「re-key」操作）。

商店标签页

商店 标签页开箱即用，会列出供应商发布的扩展及其描述和价格：

  • 购买 会在浏览器的新标签页中打开支付页面。付款确认后，许可证会自动应用（副本也会通过电子邮件发送）。
  • 安装（当有更新版本发布时显示 更新）会先检查您的许可证——如果扩展尚未获得授权，会弹出对话框供您购买或粘贴许可证，然后自动继续——并让软件包经过与手动上传完全相同的签名验证和模拟预览。 带演示的扩展会显示观看演示链接，发布更新版本后按钮会变为更新。

商店标签页是只读且匿名的：无需账户、无需令牌，也不会发送任何关于实例的信息——只读取供应商的公开目录。隔离实例无需任何配置——标签页只会显示友好的提示，并使用下面基于文件的流程；供应商的商店网站可在任何联网浏览器上提供相同的购买和下载。

安装扩展

  1. 如果尚未操作，请先应用许可证（见下文）。
  2. 打开管理 → 扩展，在商店标签页中选择从文件安装…，上传收到的 .teax 文件。
  3. Turbo EA 验证签名并显示预览：对于包含内容的扩展，这是对其将创建或更新的每个卡片类型、标签组、卡片和关系的试运行——此时尚未写入任何内容。
  4. 检查预览后点击安装扩展。
  5. 如果扩展包含后端或界面代码，会出现横幅提示重启后端容器（docker compose restart backend）。纯内容扩展立即生效。

重复上传同一个包是安全的——预览会将所有内容显示为「已跳过」，应用后不会有任何变化。

许可证与续期

通过「已安装」标签页中的输入许可证…应用许可证（粘贴文本或上传文件）——需要许可证的每个扩展行上也会显示该按钮。页面随后会显示被许可方以及每项授权的徽章及其到期日期。

授权过期后会进入宽限期（默认 30 天）：一切照常工作，管理员会看到警告横幅。宽限期结束后，扩展将被软停用——其页面消失、API 拒绝请求、后台任务暂停。任何数据都不会被删除。 应用续期后的许可证文件即可立即恢复一切，无需重启。

通过商店购买的许可证在联网实例上会自动续期：每次付款成功后，实例会自动获取延长后的许可证——无需任何粘贴操作。在隔离环境中，续期流程是：粘贴续订邮件中的最新许可证文件（或向供应商索取）——仅此而已。

启用、禁用与卸载

  • 已启用开关会立即软停用扩展（无需重启），且可随时切换回来。对于内容包，这会将其卡片类型从元模型中隐藏——卡片保持原位。
  • 卸载会删除扩展的文件并将其卡片类型从元模型中隐藏。卡片和扩展自己的表会被特意保留，重新安装后一切（包括类型）都会恢复。

权限

整个页面及其所有 API 路由都由专用权限 admin.manage_extensions 保护（授予内置管理员角色）。扩展可以定义自己的权限键（ext.<名称>.…），扩展加载后会出现在管理 → 用户与角色中。

高级字段功能

某些扩展可解锁核心本身不提供的高级数据描述方式：

  • 字段帮助文本 —— 在录入数据时显示在字段下方的可折叠提示，让表单能够自我说明。
  • 自定义字段类型 —— 内置类型之外的新字段种类（例如可配置的 1–5 或 0–10 评分）。

这些选项仅在提供它们的扩展已安装并获得许可时才会出现在元模型字段编辑器中。如果此类扩展随后被禁用或其许可证到期，您已录入的值仍会以只读纯文本形式继续显示 —— 不会被清空或删除 —— 而编辑选项会一直消失，直到该扩展重新生效。

扩展页面出现的位置

扩展页面在扩展安装并获得许可后会出现在导航中 —— 通常作为其自己的顶级菜单项，但某些报表会与内置报表一起放在报表菜单下。