@blueking/bkflow-canvas-editor 0.0.21 → 0.0.22

package/README.md

@@ -128,6 +128,7 @@ npm install bkflow-canvas-editor
 | `onBeforeLeave`          | `(isEdited: boolean) => Promise<boolean>`                                                      | -       | 离开前回调，返回 `false` 可阻止离开                                                                       |
 | `defaultZoom`           | `number`                                                                                      | `1`     | x6 画布的默认缩放比例，用于控制画布的初始显示效果。取值范围建议在 0.25 到 1.5 之间                                           |
 | `bkflowSaasUrl`         | `string`                                                                                      | -       | bkflow-saas-url，用于设置 `$.context.site_url` 的值，供插件内部使用                                                          |
+| `is_third_plugin_enabled` | `boolean`                                                                                    | `true`  | 是否启用第三方插件。设置为 `false` 时，将不加载第三方插件列表和详情，只显示内置插件                                         |
 
 #### Slots
 
@@ -613,6 +614,39 @@ interface AgentSelectPanelConfig {
 
 > **说明**：`bkflowSaasUrl` 会被设置到 `window.$.context.site_url` 中，供插件内部使用。如果不提供，`site_url` 默认为空字符串。
 
+### 禁用第三方插件
+
+可以通过 `is_third_plugin_enabled` props 控制是否加载第三方插件。当设置为 `false` 时，将不加载第三方插件列表和详情，只显示内置插件：
+
+```vue
+<template>
+  <FlowEdit
+    :flow-id="flowId"
+    :api-config="apiConfig"
+    :is-third-plugin-enabled="false" />
+</template>
+
+<script setup>
+  import { FlowEdit } from 'bkflow-canvas-editor';
+
+  const flowId = '123';
+  const apiConfig = {
+    scopeData: {
+      scope_type: 'space',
+      scope_value: 123,
+    },
+  };
+</script>
+```
+
+> **说明**：
+> - `is_third_plugin_enabled` 默认值为 `true`，即默认启用第三方插件
+> - 当设置为 `false` 时：
+>   - 插件选择面板中的第三方插件标签将不会显示
+>   - 不会请求第三方插件列表和详情
+>   - 如果流程中已存在第三方插件节点，尝试打开节点配置时会提示错误
+> - 也可以通过 `apiConfig.is_third_plugin_enabled` 来设置，效果相同
+
 ### 使用 FlowEdit 的调试功能
 
 启用 FlowEdit 组件的调试功能，点击调试按钮会打开 FlowDebug 组件：
@@ -875,6 +909,8 @@ interface FlowApiConfig {
   };
   /** 用户查询 API 地址（可选） */
   fetchUserApi?: string;
+  /** 是否启用第三方插件（可选，默认为 true） */
+  is_third_plugin_enabled?: boolean;
 }
 ```