SDK 变更日志

Activepieces SDK 所有重要变更的记录

**重大变更：**

如果您的 Activepieces 镜像版本 \< 0.45.0 并且（您正在使用嵌入 SDK 的 connect 方法，且需要在用户创建后返回连接的外部 ID，或者您想要重新连接具有特定外部 ID 的连接），您必须将 Activepieces 镜像升级到 >= 0.45.0。 在 Activepieces 镜像版本 0.32.1 到 0.46.4 之间，导航处理程序在路径中包含项目 ID，这可能破坏了使用导航处理程序的实现逻辑。这一问题已从 0.46.5 版本起修复，处理程序将不再在路由前显示项目 ID。

变更日志格式：月/日/年（版本）

06/18/2026 (0.10.0)

  • SDK URL：https://cdn.activepieces.com/sdk/embed/0.10.0.js
  • 新增 authorizeMcp({ authRequestId }) —— 打开一个嵌入式的 MCP OAuth 授权对话框，使嵌入式（托管认证）用户无需独立的 Activepieces 登录即可批准 AI 客户端连接其项目。批准时 resolve 为 { redirectUrl }，拒绝时 resolve 为 { denied: true }。请参阅可嵌入 MCP。
  • 新增 mcpSettings() —— 在宿主应用内为嵌入式用户的项目打开 MCP 设置对话框（连接 URL、工具、暴露的工作流）。

04/21/2026 (0.9.0)

  • SDK URL：https://cdn.activepieces.com/sdk/embed/0.9.0.js
  • 此版本要求您将 Activepieces 升级到 0.82.0。
  • 向 configure 方法添加了 embedding.hideTables 参数 （值：true | false）。当为 true 时，隐藏控制面板中的表格 UI（树形视图、类型筛选选项、创建/导入表格按钮、空状态卡片、全局搜索结果），并阻止直接访问 /tables/:id 编辑器路由。工作流中使用的 Tables Piece 不受影响。

10/27/2025 (0.8.1)

09/21/2025 (0.8.0)

07/30/2025 (0.7.0)

07/07/2025 (0.6.0)

  • SDK URL：https://cdn.activepieces.com/sdk/embed/0.6.0.js
  • 此版本要求您将 Activepieces 升级到 0.66.1。
  • 向 configure 方法添加了 embedding.dashboard.hideFlowsPageNavbar 参数 （值：true | false）。
  • （重大变更） embedding.dashboard.hideSidebar 过去用于隐藏控制面板中工作流表格上方的导航栏，现在此功能由 embedding.dashboard.hideFlowsPageNavbar 控制。

03/07/2025 (0.5.0)

  • SDK URL：https://cdn.activepieces.com/sdk/embed/0.5.0.js
  • 此版本要求您将 Activepieces 升级到 0.64.2。
  • 向 configure 方法添加了 embedding.hideDuplicateFlow 参数 （值：true | false）。
  • 向 configure 方法添加了 embedding.builder.homeButtonIcon 参数 （值：‘logo’ | ‘back’），如果设置为 ‘back’，将移除悬停在首页按钮上时显示的工具提示。
  • 向 configure 方法添加了 embedding.locale 参数，接受 ISO 639-1 语言代码，支持的语言包括：（‘en’ | ‘nl’ | ‘it’ | ‘de’ | ‘fr’ | ‘bg’ | ‘uk’ | ‘hu’ | ‘es’ | ‘ja’ | ‘id’ | ‘vi’ | ‘zh’ | ‘pt’）。
  • 向 configure 方法添加了 embedding.styling.mode 参数 （值：‘light’ | ‘dark’）。
  • （重大变更） 从 configure 方法中移除了 embedding.builder.hideLogo 参数。
  • （重大变更） 从 SDK 中移除了 MCP 方法。

17/06/2025 (0.5.0-rc.1)

16/06/2025 (0.5.0-rc.0)

  • SDK URL：https://cdn.activepieces.com/sdk/embed/0.5.0-rc.0.js
  • 此版本要求您将 Activepieces 升级到 0.64.0-rc.0。
  • 向 configure 方法添加了 embedding.hideDuplicateFlow 参数 （值：true | false）。
  • 向 configure 方法添加了 embedding.builder.homeButtonIcon 参数 （值：‘logo’ | ‘back’），如果设置为 ‘back’，将移除悬停在首页按钮上时显示的工具提示。
  • 向 configure 方法添加了 embedding.locale 参数，接受 ISO 639-1 语言代码，支持的语言包括：（‘en’ | ‘nl’ | ‘it’ | ‘de’ | ‘fr’ | ‘bg’ | ‘uk’ | ‘hu’ | ‘es’ | ‘ja’ | ‘id’ | ‘vi’ | ‘zh’ | ‘pt’）。
  • 向 configure 方法添加了 embedding.styling.mode 参数 （值：‘light’ | ‘dark’）。
  • （重大变更） 从 configure 方法中移除了 prefix 参数。
  • （重大变更） 从 configure 方法中移除了 embedding.builder.hideLogo 参数。

26/05/2025 (0.4.1)

  • 修复了嵌入 HTML 文件有时被缓存的问题。

20/05/2025 (0.4.0)

—— 注意：我们之前认为添加可选新参数不属于重大变更，因此只增加了补丁版本号，但这是错误的。从现在开始，此类更改将增加次要版本号，补丁版本号仅用于 bug 修复。

  • 此版本要求您将 Activepieces 升级到 0.56.0。
  • 向 configure 方法添加了 embedding.hideExportAndImportFlow 参数。
  • 为 configure 方法参数 embed.builder.disableNavigation 添加了新值 “keep_home_button_only”，该值仅保留首页按钮并隐藏文件夹名称和删除工作流操作。
  • 为 configure 方法添加了新参数 embed.builder.homeButtonClickedHandler，覆盖点击首页按钮时的导航行为。

17/04/2025 (0.3.7)

  • 添加了更新 MCP 配置的 MCP 方法。

16/04/2025 (0.3.6)

  • 添加了 request 方法，允许您调用后端 API。

24/2/2025 (0.3.5)

  • 为 connect 方法添加了新参数，使连接对话框以弹出窗口形式显示，而不是占据整个页面的 iframe。
  • 修复了 connect 方法返回的 promise 始终 resolve 为 {connection: undefined} 的 bug。
  • 现在当您使用带有 “connectionName” 参数的 connect 方法时，用户将重新连接到具有匹配外部 ID 的连接，而不是创建新连接。

04/02/2025 (0.3.4)

  • 此版本要求您将 Activepieces 升级到 0.41.0。
  • 添加了向嵌入 SDK 传递字体系列名称和字体 URL 的功能。

26/01/2025 (0.3.3)

  • 此版本要求您将 Activepieces 升级到 0.39.8。
  • activepieces.configure 方法之前在用户认证完成前就已 resolve，此问题现已修复，因此您可以使用 activepieces.navigate 方法导航到所需的初始路由。

04/12/2024 (0.3.0)

  • 添加自定义导航处理程序（#4500）
  • 允许在 connect 方法中为连接传递预定义名称（#4485）
  • 添加变更日志（#4503）