@blueking/bkflow-canvas-editor 1.2.0-beta.3 → 1.2.0-beta.6

package/README.md

@@ -208,7 +208,7 @@ npm install @blueking/bkflow-canvas-editor @blueking/flow-canvas
 
 ### SelectPanelConfig 类型
 
-插件选择面板配置类型，用于配置插件选择面板中的按钮跳转链接和文本。
+插件选择面板配置类型，用于配置插件选择面板中的按钮跳转链接、文本以及标准运维插件分类白名单。
 
 #### 类型定义
 
@@ -218,6 +218,7 @@ interface SelectPanelConfig {
   agentResourceUrl?: string; // "智能体" 按钮跳转链接（可选）
   agentButtonText?: string; // "智能体" 按钮文本（可选，默认为 "智能体"）
   knowledgebaseResourceUrl?: string; // 知识库插件分组，"知识库" 按钮跳转链接（可选）
+  sopsCategoryWhitelist?: string; // 「标准运维插件」分组的分类白名单，分号分隔（可选）
 }
 ```
 
@@ -233,6 +234,7 @@ interface SelectPanelConfig {
       agentResourceUrl: 'https://example.com/agent',
       agentButtonText: '创建智能体',
       knowledgebaseResourceUrl: 'https://example.com/knowledgebase',
+      sopsCategoryWhitelist: '作业平台(JOB);配置平台(CMDB)',
     }" />
 </template>
 ```
@@ -243,6 +245,20 @@ interface SelectPanelConfig {
 - `agentButtonText` 默认值为 "智能体"
 - 配置通过 Vue 的 provide/inject 机制全局提供，子组件可以直接通过 `useSelectPanelConfig()` 获取
 
+##### sopsCategoryWhitelist
+
+只有命中白名单的标准运维插件分类才会出现在插件选择面板里，白名单外的分类及其插件对用户不可见。宿主一般由环境变量下发（例如 bk-incident 的 `BUITIN_PLUGINS_FILTERS` 经 html 注入到前端）：
+
+```vue
+<FlowEdit :select-panel-config="{ sopsCategoryWhitelist: window.BUITIN_PLUGINS_FILTERS }" />
+```
+
+- 多个分类用半角分号 `;` 分隔（全角 `；` 也可识别），每项与分类名或分类 id 精确相等（前后空格会被忽略）即命中
+- 不传或传空串时展示全部分类，行为与改动前一致
+- 「内置插件」与「第三方插件」两个来源共用同一份白名单
+- 分类被全部过滤时该来源下展示「暂无插件分类」空态，分组和来源 tab 本身仍然显示
+- 白名单只控制可选范围，已配置了白名单外插件的历史节点照常展示和编辑
+
 ---
 
 ### FlowCreateTask 组件
@@ -395,7 +411,8 @@ interface SelectPanelConfig {
 | `apiConfig`   | `FlowApiConfig \| FlowDetailApiConfig`        | -                                  | **必需**，API 配置对象；`canDebug=true` 时需一并提供调试方法（见下）       |
 | `permissions` | `Partial<FlowDetailPermissions>`              | `{ canEdit: false, canDebug: false, canExecute: false }` | 权限配置，**默认全部拒绝**，需显式开启                                     |
 | `onExecuteSuccess` | `(result: FlowTaskExecuteSuccessResult) => void` | - | 执行成功回调，参数与 `FlowView` 一致 |
-| `enableVersion` / `flowVersion` | `boolean` / `string`        | `false` / -                        | 流程版本功能，语义与 FlowView/FlowEdit 一致                                |
+| `enableVersion` / `flowVersion` | `boolean` / `string`        | `false` / -                        | 流程版本功能，语义与 FlowView/FlowEdit 一致；`flowVersion` 支持 `v-model`  |
+| `enableVersionManagement` | `boolean`                           | `false`                            | 是否启用版本管理 UI（版本选择器 + 版本历史 + 发布 + 回滚），见下           |
 | `defaultZoom` / `quickAdd` / `hideTrigger` / `bkflowSaasUrl` | 同 FlowEdit | -                       | 透传给内部画布与信息侧滑                                                   |
 
 #### Events
@@ -406,6 +423,16 @@ interface SelectPanelConfig {
 | `saveSuccess` | -                        | 显式保存成功后触发         |
 | `back`        | -                        | 返回按钮点击时触发         |
 | `createVariable` | `{ keyword, cursorIndex }` | 请求新建全局变量时触发 |
+| `update:flowVersion` | `version: string \| undefined` | 内部切换查看版本时触发；`undefined` 表示回到草稿。宿主可用 `v-model:flowVersion` 同步 URL，也可以不接 |
+
+#### Slots
+
+| 插槽名             | 作用域参数                                  | 说明                                                                   |
+| ------------------ | ------------------------------------------- | ---------------------------------------------------------------------- |
+| `header`           | -                                           | 自定义头部左侧标题区                                                   |
+| `headerActions`    | `{ savePending, canMutateFlow }`            | 头部右侧操作区追加宿主自定义按钮，排在内置「保存」「执行流程」之后     |
+| `inputParams`      | 见 `FlowView`                               | 自定义节点输入参数表单                                                 |
+| `customFormContent`| 见 `FlowView`                               | 自定义创建任务侧滑表单内容                                             |
 
 #### 权限矩阵
 
@@ -418,7 +445,17 @@ interface SelectPanelConfig {
 | `false`   | `true`     | 只读画布 + 全流程/单节点调试（调试期间流程本就不可编辑）   |
 | `true`    | `true`     | 可编辑、保存与完整调试；调试运行中锁定编辑（画布转 `view`）|
 
-`permissions.canExecute` 独立控制头部“执行流程”按钮。流程存在未保存修改时，确认保存成功后才会打开创建任务侧滑；`customFormContent` 插槽与 `FlowView` 一致。
+`permissions.canExecute` 独立控制头部“执行流程”按钮的显示，为 `false` 时按钮不渲染。流程存在未保存修改时，确认保存成功后才会打开创建任务侧滑；`customFormContent` 插槽与 `FlowView` 一致。
+
+头部右侧按钮区在 `canEdit`、`canExecute` 均为 `false` 且未传 `headerActions` 插槽时整体不渲染。宿主若要按状态控制自定义按钮的显隐，可在插槽模板上直接加 `v-if`，插槽未传入时按钮区不会留下空白：
+
+```vue
+<FlowDetail :flow-id="flowId" :api-config="apiConfig" :permissions="permissions">
+  <template v-if="permissions.canEdit" #headerActions>
+    <bk-button @click="handleExitEdit">退出编辑</bk-button>
+  </template>
+</FlowDetail>
+```
 
 #### 调试能力
 
@@ -427,7 +464,22 @@ interface SelectPanelConfig {
 - **单节点 Mock**：配置 Mock 输出结果后执行（内部顺序：保存 Mock → 单步执行 mock）；执行时跳过该节点并以 Mock 输出替代实际输出，Mock 节点在后续全流程中保留 `MOCK` 标签。
 - **取消 Mock**：清除节点的持久 Mock 配置。
 - **终止**：全流程终止不传 `node_id`；单步调试进入运行/等待态时，传当前 `active_node_id` 终止该节点。
-- **保存联动**：`canDebug` 且 `context` 空闲时，保存成功后会查询 `reset_impact` 并自动清理失效节点的调试结果。
+- **保存联动**：`canDebug` 时保存成功后刷新 `debug_context`；最后一次 `debug_snapshot` 会保留，直接修改或删除的节点分别由 `config_changed` / `node_deleted` 标记为已失效。
+
+#### 版本管理（`enableVersionManagement=true`）
+
+开启后头部流程名右侧出现版本选择器，头部图标区新增「版本历史」入口。草稿态右侧操作区依次展示主按钮「发布」和浅蓝次按钮「暂存草稿」，不展示「执行流程」；历史版本只读态只展示「执行流程」。
+
+- **数据加载**：`enableVersionManagement=true` 隐含 `enableVersion` 的语义，消费方只需传这一个。查看的版本由组件内部持有，初值取 `flowVersion`。
+- **草稿切换**：版本下拉首项固定为「草稿」；`flowVersion` 为空时默认选中草稿，选中该项可从历史版本预览切回当前草稿。
+- **查看历史版本**：选中历史版本后画布转为只读预览（走 `preview_task_tree`），不展示保存与发布，**调试域整体不挂载** —— 后端调试端点只读 DB 里的草稿，在历史版本视图下调试会跑在草稿上，结果与画面不符。
+- **草稿自动保存**：完整版本管理开启后，画布结构/配置、节点配置、全局变量和基础信息的编辑结果会按顺序自动保存全量流程；保存草稿不做完整性校验，允许暂存未完成流程。
+- **发布上线**：发布前会全量校验并确保草稿已落库（后端 `release_template` 转正的是 DB 里的 draft 行，不接受请求体里的 pipeline）。发布成功后刷新版本列表，并从新发布版本初始化草稿。版本号默认取 `calculate_version` 的建议值，失败原因内联展示在版本号字段上并保留输入。
+- **加载至草稿**：入口仅在版本历史条目 hover 中展示，二次确认后用所选历史版本覆盖当前草稿，随后回到草稿态重载。
+- **权限**：发布与回滚都收敛到 `permissions.canEdit`，不引入额外权限位；调试运行中（`debugLocked`）全部禁用。
+- **空间开关**：组件无法自检空间的 `flow_versioning` 配置（后端 `get_space_related_configs` 不返回该字段），由消费方保证只在已开启版本管理的空间传 `true`。
+
+`enableVersionManagement=true` 且消费方传入完整 api 配置对象时，需一并提供 `fetchFlowVersionList`、`calculateNextFlowVersion`、`releaseFlowVersion`、`rollbackFlowVersion`（签名见 `FlowVersionApiServices`）。走内置 `useFlowApi()` 时自动获得。
 
 #### 调试 API 契约（`canDebug=true` 必需）
 
@@ -1367,6 +1419,46 @@ resolve: {
     - FlowEdit 会自动将版本相关 props 透传给内嵌的 FlowDebug 组件
     - 版本功能依赖 `fetchFlowDraftDetail` 和 `fetchFlowDetailByVersion` 两个 API 方法
 
+## 国际化
+
+包内自带 `zh-cn` 与 `en` 词条，默认 `zh-cn`。宿主在挂载前调用一次 `setLocale` 即可：
+
+```typescript
+import { setLocale } from '@blueking/bkflow-canvas-editor';
+
+setLocale('en');
+```
+
+语言是进程级全局状态，切换后需由宿主刷新页面；不支持同一页面内两个画布实例使用不同语言。
+
+组件库（bkui-vue / element-plus）的文案由包内自动联动，宿主无需在 `app.use(bkui)` 时额外配置。
+
+`setLocale` 只管前端文案。**后端下发的内容（插件名称、插件表单 schema 标签、接口报错）
+不受它影响**——bkflow 后端按 `blueking_language` Cookie（`zh-cn` / `en`）判定语言，
+不读 `Accept-Language` 请求头，宿主需自行设置该 Cookie。
+
+locale 非 `zh-cn` 时本包会改写 bkui-vue 的 `defaultRootConfig.locale` 以覆盖命令式
+`Message` / `InfoBox`，**影响范围是整个宿主应用**。详见
+[docs/usage.md 的国际化章节](./docs/usage.md#国际化)。
+
+进阶用法：
+
+| API | 用途 |
+| --- | --- |
+| `registerMessages(locale, messages, options?)` | 深合并覆盖个别词条，或注册包内没有的新语言 |
+| `setTranslator(fn)` | 完全接管翻译，桥接宿主已有的 i18n；返回 `undefined` 时回落包内词条 |
+| `getLocale()` | 读取当前语言 |
+
+注册新语言时可一并提供 bkui-vue 语言包：
+
+```typescript
+import { registerMessages } from '@blueking/bkflow-canvas-editor';
+import jaMessages from './ja';
+import { jp } from 'bkui-vue/lib/locale';
+
+registerMessages('ja', jaMessages, { bkuiLocale: jp });
+```
+
 ## License
 
 MIT

package/dist/advanced.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./context-Bj442dps.cjs");exports.PLUGIN_GROUP_ICON_MAP=e.PLUGIN_GROUP_ICON_MAP;exports.provideVariableInputCreateVariable=e.provideVariableInputCreateVariable;exports.useFlowApi=e.useFlowApi;exports.useVariableInputCreateVariable=e.useVariableInputCreateVariable;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./context-DhrPIIhQ.cjs");exports.PLUGIN_GROUP_ICON_MAP=e.PLUGIN_GROUP_ICON_MAP;exports.SOPS_PLUGIN_GROUP_NAME=e.SOPS_PLUGIN_GROUP_NAME;exports.provideVariableInputCreateVariable=e.provideVariableInputCreateVariable;exports.resolveSopsPluginSources=e.resolveSopsPluginSources;exports.useFlowApi=e.useFlowApi;exports.useVariableInputCreateVariable=e.useVariableInputCreateVariable;exports.withSopsPluginGroup=e.withSopsPluginGroup;

package/dist/advanced.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 
-type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'SKIP';
+type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'INVALID' | 'SKIP';
 type ExecutionNodeAction = 'retry' | 'skip' | 'resume' | 'approve' | 'forceFail' | 'gatewaySkip';
 interface NodeExecutionState {
     status: NodeExecutionStatus;
@@ -81,13 +81,26 @@ interface ActivityComponent {
   api_meta?: {
     id: string;
     name: string;
+    /** 项目内 uniform_api 仍可能写入；标准运维 V4 对齐 bkflow，不再落这个字段 */
     alias?: string;
-    meta_url: string;
+    /** 目录项有 meta_url 才写；V4 开放插件通常只有 meta_url_template */
+    meta_url?: string;
     api_key: string;
     category: {
       id: string;
       name: string;
     };
+    // 标准运维 V4 开放插件的落库字段，对齐 bkflow NodeConfig.vue `if (isV4)` 保存分支
+    plugin_source?: string;
+    plugin_code?: string;
+    plugin_version?: string;
+    wrapper_version?: string;
+    versions?: string[];
+    meta_url_template?: string;
+    latest_version?: string;
+    default_version?: string;
+    desc?: string;
+    source_key?: string;
   };
 }
 
@@ -155,7 +168,7 @@ interface LoopConfig {
 }
 
 /**
- * 子流程（SubProcess）活动节点。
+ * 子流程（SubProcess）活动节点
  */
 interface SubProcessActivity {
   id: string;
@@ -166,6 +179,8 @@ interface SubProcessActivity {
   type: 'SubProcess';
   /** 被引用的模板 ID */
   template_id: string | number;
+  /** 模板名称 */
+  template_name?: string;
   /** 模板版本 */
   version?: string;
   /** 变量映射常量 */
@@ -570,15 +585,20 @@ interface FlowListItem {
     creator: string;
     update_at: string;
 }
+interface SpaceUniformApiEntry {
+    meta_apis: string;
+    api_categories?: string;
+    display_name?: string;
+    source_key?: string;
+    catalog_mode?: 'remote' | 'cache_first' | 'cache_only';
+    headers?: Record<string, string>;
+}
 interface SpaceFlowConfig {
     gateway_expression?: 'boolrule' | 'FEEL' | 'MAKO';
-    uiform_api?: {
-        api: Record<string, {
-            api_category: string;
-            display_name: string;
-            meta_apis: string;
-        }>;
-    };
+    uniform_api?: {
+        api?: Record<string, SpaceUniformApiEntry | null>;
+        common?: SpaceUniformApiEntry | null;
+    } | null;
 }
 interface UpdateFlowParams {
     name: string;
@@ -608,6 +628,88 @@ interface PluginMetaItem {
     icon?: string;
     category_id: string;
 }
+interface SopsPluginSourceItem {
+    id: string;
+    name: string;
+    /** 空间配置 uniform_api.api[api_name].source_key，缺省时等于 api_name */
+    source_key?: string;
+}
+interface SopsPluginCategory {
+    id: string;
+    name: string;
+}
+interface SopsPluginItem {
+    id: string;
+    name: string;
+    category?: string;
+    category_name?: string;
+    description?: string;
+    meta_url?: string;
+    meta_url_template?: string;
+    plugin_source?: string;
+    plugin_code?: string;
+    source_key?: string;
+    wrapper_version?: string;
+    default_version?: string;
+    latest_version?: string;
+    versions?: string[];
+}
+interface SopsPluginListResult {
+    total: number;
+    apis: SopsPluginItem[];
+}
+/**
+ * 统一插件详情里的表单描述符（bkflow V4 开放插件协议）。
+ * component_js / renderform(string) 走 $.atoms 注册链路，key 即注册用的 atom key；
+ * is_embedded 为 false 时 data 是脚本地址，否则 data 是脚本源码。
+ */
+type SopsPluginFormDescriptor = {
+    type: 'component_js';
+    key: string;
+    data: string;
+    base?: string;
+    is_embedded?: boolean;
+} | {
+    type: 'renderform';
+    key?: string;
+    data: string | RenderformInputsItem[] | Record<string, unknown>;
+    base?: string;
+    is_embedded?: boolean;
+} | {
+    type: 'jsonschema';
+    data: JsonschemaformInputs;
+} | {
+    type: 'api_plugin_json';
+    data?: Record<string, unknown>;
+};
+interface SopsPluginDetail {
+    plugin_type: 'component' | 'remote_plugin' | 'uniform_api';
+    plugin_code: string;
+    plugin_version: string;
+    source_key: string;
+    plugin_source?: string;
+    protocol?: string;
+    wrapper_version?: string;
+    name: string;
+    description?: string;
+    inputs?: UniformApiPluginInputsItem[];
+    outputs?: PluginOutputItem[];
+    credentials?: Record<string, unknown> | null;
+    forms?: {
+        input?: SopsPluginFormDescriptor | null;
+        output?: SopsPluginFormDescriptor | null;
+    } | null;
+    form_schema?: Record<string, unknown> | null;
+    /** 表单脚本运行所需的上下文（site_url / project 等），由插件提供方下发 */
+    form_context?: Record<string, unknown> | null;
+    execution_kind?: string;
+    url?: string;
+    methods?: string[];
+    response_data_path?: string;
+    polling?: Record<string, any> | null;
+    callback?: Record<string, any> | null;
+    credential_key?: string;
+}
 interface BkflowThirdPartyPluginGroupItem {
     code_name: string;
     id: number;
@@ -691,7 +793,7 @@ interface BkflowThirdPartyPluginAppDetail {
     };
 }
 interface GroupsPluginItem extends PluginGroupConfig {
-    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem)[];
+    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem | SopsPluginSourceItem)[];
 }
 interface UniformApiPluginOutputItem {
     key: string;
@@ -743,6 +845,29 @@ interface UniformApiPluginConfig {
         }>;
     };
 }
+interface RenderformInputsItem {
+    name?: string;
+    tag_code: string;
+    type: string;
+    attrs: Record<string, any>;
+    events?: Record<string, any>[];
+    validation?: Record<string, any>[];
+}
+interface JsonschemaformInputs {
+    type: string;
+    properties: Record<string, any>;
+    required?: string[];
+    definitions?: Record<string, {
+        type: string;
+        title: string;
+        description?: string;
+        default?: string | boolean | number | string[] | boolean[] | number[] | Record<string, any>;
+        enum?: string[];
+        items?: Record<string, any>;
+        'ui:props'?: Record<string, any>;
+        'ui:component'?: Record<string, any>;
+    }>;
+}
 interface UniformApiPluginInputsItem {
     desc: string;
     form_type?: string;
@@ -778,6 +903,60 @@ interface CustomVariableType {
     code: string;
 }
 
+interface VariableOption {
+    key: string;
+    name: string;
+    source_type?: string;
+    custom_type?: string;
+}
+interface CreateVariablePayload {
+    keyword?: string;
+    cursorIndex?: number;
+    defaultCustomType?: string;
+}
+/**
+ * 宿主自定义的候选项来源标识。
+ *
+ * 编辑器**不解释**它的内容，只做原样存储与回传：`key` 用于让宿主找到自己的加载器，
+ * `params` 放宿主拉取时需要的补充信息。
+ *
+ * 之所以由宿主带进来而不是编辑器从 pipeline_tree 反查关联节点的插件：节点配置尚未
+ * 保存时，`activities[nodeId].component` 还是换插件之前的那个，反查会拿到错的插件。
+ */
+interface SelectRelatedOptionSourceRef {
+    key: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * select 变量「关联数据」的来源，由宿主在节点表单里发起受控创建时锁定。
+ * 与 filter 的 FilterVariableSourceContext 平行。
+ */
+interface SelectRelatedSourceContext {
+    sourceNodeId: string;
+    /**
+     * 关联来源在「关联数据」栏展示的名字，由宿主决定放什么（bk-incident 放当前选中的插件名）。
+     *
+     * 它**优先于**画布实时解析的节点名：select 的关联源连同候选项来源一起冻结在创建时刻，
+     * 展示名跟着来源走而不是跟着节点实例走。不传则回落实时节点名、再回落裸 nodeId——
+     * 而空节点选插件后配置尚未写回 pipeline_tree，实时节点名恰恰是空的。
+     */
+    sourceNodeName?: string;
+    /** 关联表单项稳定 KEY，例如 index_set_id */
+    sourceFieldKey: string;
+    /**
+     * 关联表单项的展示名，例如「查询条件」——即节点表单上那一栏的标题，不是 fieldKey 本身。
+     * 全局变量侧滑没有加载插件 schema 的时机，不带进来就只能显示裸 fieldKey。
+     */
+    sourceFieldName?: string;
+    /** 候选项从哪来。缺省则该变量没有可拉取的候选项 */
+    optionSource?: SelectRelatedOptionSourceRef;
+}
+interface CreateVariableRequest extends CreateVariablePayload {
+    /** 缺省时 select 仍按「手动输入」初始化，普通「新建变量」入口不受影响 */
+    selectRelatedContext?: SelectRelatedSourceContext;
+    onCreated: (option: VariableOption) => void;
+}
+
 type DebugContextStatus = 'idle' | 'running' | 'terminating';
 type DebugNodeStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'finished' | 'failed' | 'revoked' | 'suspended' | 'skipped';
 type DebugExecutionMode = 'real' | 'mock';
@@ -812,9 +991,13 @@ interface DebugConditionResult {
 }
 interface DebugContextNode {
     node_id: string;
+    /** 节点显示名称；后端逐步补齐，旧版本可能缺失。 */
+    node_name?: string;
     node_type: string;
     execution_mode: DebugExecutionMode;
     status: DebugNodeStatus;
+    /** 节点配置变更后，已有调试结果是否失效。 */
+    config_changed?: boolean;
     can_step: boolean;
     missing_vars: DebugMissingVar[];
     waiting_reason?: string | null;
@@ -838,6 +1021,26 @@ interface DebugContextNode {
     /** 条件网关每个分支的表达式与命中结果。 */
     condition_results?: DebugConditionResult[];
 }
+interface DebugSnapshotNode {
+    node_id: string;
+    node_name: string;
+    node_type: string;
+    execution_mode: DebugExecutionMode;
+    status: DebugNodeStatus;
+    waiting_reason?: string | null;
+    inputs: Record<string, unknown>;
+    outputs: Record<string, unknown>;
+    duration_ms?: number | null;
+    error_detail?: DebugErrorDetail | string | null;
+    log_ref?: DebugContextNode['log_ref'];
+    operator: string;
+    last_run_at?: string | null;
+    config_changed: boolean;
+    node_deleted: boolean;
+}
+interface DebugSnapshot {
+    nodes: DebugSnapshotNode[];
+}
 /**
  * /debug_context/ 顶层结构。
  *
@@ -861,6 +1064,7 @@ interface DebugContext {
     global_vars: Record<string, unknown>;
     missing_vars?: DebugMissingVar[];
     nodes: DebugContextNode[];
+    debug_snapshot: DebugSnapshot | null;
 }
 interface DebugInputSchemaField {
     key: string;
@@ -957,6 +1161,45 @@ interface DebugApiServices {
     resetDebugResult(params: ResetDebugResultParams): Promise<DebugResetResult>;
 }
 
+/** 版本列表条目。列表接口不返回 pipeline_tree，取流程内容要走 preview_task_tree。 */
+interface FlowVersionSnapshot {
+    id: number;
+    template_id: number;
+    /** 草稿行为 null；已发布行为 semver 字符串 */
+    version: string | null;
+    desc: string | null;
+    draft: boolean;
+    creator: string;
+    operator: string;
+    /** pipeline 内容指纹 */
+    md5sum: string;
+    create_time: string;
+    update_time: string;
+}
+interface FlowVersionListResult {
+    count: number;
+    results: FlowVersionSnapshot[];
+}
+interface ReleaseFlowVersionParams {
+    version: string;
+    desc?: string;
+}
+interface RollbackFlowVersionParams {
+    version: string;
+}
+interface FlowVersionApiServices {
+    /** 版本列表。固定以 limit=-1 请求全量，不做分页 UI */
+    fetchFlowVersionList: (templateId: string) => Promise<FlowVersionListResult>;
+    /** 计算下一个建议版本号。基于当前线上版本 bump，无历史版本时返回 1.0.0 */
+    calculateNextFlowVersion: (templateId: string) => Promise<{
+        version: string;
+    }>;
+    /** 发布上线。作用于 DB 里的草稿行，调用前必须确保草稿已落库 */
+    releaseFlowVersion: (templateId: string, params: ReleaseFlowVersionParams) => Promise<FlowTemplate>;
+    /** 把历史版本加载至草稿，会覆盖当前草稿内容 */
+    rollbackFlowVersion: (templateId: string, params: RollbackFlowVersionParams) => Promise<unknown>;
+}
+
 /**
  * Flow API 配置接口
  */
@@ -1037,10 +1280,38 @@ interface OperateTaskNodeParams {
 interface GetFlowTaskDetailParams {
     task_id: number | string;
 }
+interface SopsPluginCategoryParams {
+    template_id: number | string;
+    /** 空间 uniform_api 配置里的 api_name，如 sops_builtin / sops_third_party */
+    api_name: string;
+}
+interface SopsPluginListParams extends SopsPluginCategoryParams {
+    category?: string;
+    /** 插件名称搜索关键字 */
+    key?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * 统一插件详情请求参数。
+ * 后端 serializer 会拒绝契约外字段（不是静默忽略），调用方不要附加额外参数；
+ * space_id / scope_type / scope_value 由 service 从 scopeData 补齐。
+ */
+interface SopsPluginDetailParams {
+    template_id: number | string;
+    plugin_type: 'component' | 'remote_plugin' | 'uniform_api';
+    /** 标准运维网关 plugin id：内置为 `builtin__<code>`，第三方即裸 code */
+    plugin_code: string;
+    plugin_version: string;
+    /** uniform_api 必填，缺失时后端直接 400 */
+    source_key?: string;
+}
 interface FlowTaskDetail {
     id: number | string;
     template_id: number;
     pipeline_tree: PipelineTree;
+    /** 调试任务执行人。 */
+    executor?: string;
     /** 任务已耗时（秒），调试摘要弹层刷新恢复用。 */
     elapsed_time?: number;
     [key: string]: unknown;
@@ -1196,6 +1467,9 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
         count: number;
     }>;
     enableThirdPlugin?: boolean;
+    fetchSopsPluginCategories?: (params: SopsPluginCategoryParams) => Promise<SopsPluginCategory[]>;
+    fetchSopsPluginList?: (params: SopsPluginListParams) => Promise<SopsPluginListResult>;
+    fetchSopsPluginDetail?: (params: SopsPluginDetailParams) => Promise<SopsPluginDetail>;
     fetchPluginDetail?: (id: string) => Promise<UniformApiPluginDetail>;
     fetchApplyInstructionData?: (params: any) => Promise<any>;
     drawPipeline?: (params: DrawPipelineParams) => Promise<{
@@ -1227,35 +1501,38 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
     getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
 }
-interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices> {
+interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices>, Partial<FlowVersionApiServices> {
 }
 
+declare const SOPS_PLUGIN_GROUP_NAME = "sops";
 declare const PLUGIN_GROUP_ICON_MAP: Record<string, string>;
 
+/** 目录查询接口由宿主注入，三个都要有才能走完「来源 -> 分类 -> 插件 -> 详情」 */
+type SopsPluginCatalogApi = Pick<FlowEditApiConfig, 'fetchSopsPluginCategories' | 'fetchSopsPluginList' | 'fetchSopsPluginDetail'>;
+interface SopsPluginGroupOptions {
+    spaceConfig?: SpaceFlowConfig | null;
+    api: SopsPluginCatalogApi;
+}
+/**
+ * 从 `get_space_related_configs` 的 `uniform_api.api` 里取出标准运维来源。
+ * id 即后续请求分类/插件列表要带的 `api_name`，顺序沿用配置里的顺序。
+ */
+declare function resolveSopsPluginSources(config?: SpaceFlowConfig | null): SopsPluginSourceItem[];
+/**
+ * 空间接入了标准运维、且宿主实现了目录查询接口时，在插件分组末尾补上「标准运维插件」分组；
+ * 否则原样返回。两个条件都要满足：少了接口，分组点开也只是一个永远空着的列表。
+ */
+declare function withSopsPluginGroup(groups: GroupsPluginItem[], options: SopsPluginGroupOptions): GroupsPluginItem[];
+
 /**
  * 使用 Flow API 的 composable
  * 返回所有 API 方法，兼容 FlowDetailApiConfig 接口（含调试 API）
  */
 declare function useFlowApi(config: FlowApiConfig): FlowDetailApiConfig;
 
-interface VariableOption {
-    key: string;
-    name: string;
-    source_type?: string;
-    custom_type?: string;
-}
-interface CreateVariablePayload {
-    keyword?: string;
-    cursorIndex?: number;
-    defaultCustomType?: string;
-}
-interface CreateVariableRequest extends CreateVariablePayload {
-    onCreated: (option: VariableOption) => void;
-}
-
 type VariableInputCreateVariableHandler = (request: CreateVariableRequest) => void;
 declare const provideVariableInputCreateVariable: (handler: VariableInputCreateVariableHandler) => void;
 declare const useVariableInputCreateVariable: () => VariableInputCreateVariableHandler | null;
 
-export { PLUGIN_GROUP_ICON_MAP, provideVariableInputCreateVariable, useFlowApi, useVariableInputCreateVariable };
-export type { CreateVariablePayload, CreateVariableRequest, CustomVariableType, DebugApiServices, DebugConditionResult, DebugContext, DebugContextNode, DebugContextStatus, DebugErrorDetail, DebugExecutionMode, DebugInputSchema, DebugMissingVar, DebugNodeStatus, DebugRunStatus, DebugRunType, EndEvent, Flow, FlowDetailApiConfig, FlowEditApiConfig, FlowListItem, FlowViewApiConfig, GatewayType, Line, Location, NodeConfigData, NodeType, NotifyConfig, PluginGroupConfig, PluginOutputItem, PortOrientation, StartEvent, TemplateConfigs, UniformApiPluginConfig, UniformApiPluginInputsItem, VariableInputCreateVariableHandler, VariableOption, VariableRefRequestParams };
+export { PLUGIN_GROUP_ICON_MAP, SOPS_PLUGIN_GROUP_NAME, provideVariableInputCreateVariable, resolveSopsPluginSources, useFlowApi, useVariableInputCreateVariable, withSopsPluginGroup };
+export type { CreateVariablePayload, CreateVariableRequest, CustomVariableType, DebugApiServices, DebugConditionResult, DebugContext, DebugContextNode, DebugContextStatus, DebugErrorDetail, DebugExecutionMode, DebugInputSchema, DebugMissingVar, DebugNodeStatus, DebugRunStatus, DebugRunType, DebugSnapshot, DebugSnapshotNode, EndEvent, Flow, FlowDetailApiConfig, FlowEditApiConfig, FlowListItem, FlowVersionApiServices, FlowVersionListResult, FlowVersionSnapshot, FlowViewApiConfig, GatewayType, Line, Location, NodeConfigData, NodeType, NotifyConfig, PluginGroupConfig, PluginOutputItem, PortOrientation, ReleaseFlowVersionParams, RollbackFlowVersionParams, SelectRelatedSourceContext, SopsPluginCategory, SopsPluginCategoryParams, SopsPluginDetail, SopsPluginDetailParams, SopsPluginFormDescriptor, SopsPluginItem, SopsPluginListParams, SopsPluginListResult, SopsPluginSourceItem, SpaceUniformApiEntry, StartEvent, TemplateConfigs, UniformApiPluginConfig, UniformApiPluginInputsItem, VariableInputCreateVariableHandler, VariableOption, VariableRefRequestParams };

package/dist/advanced.esm.js

@@ -1,7 +1,10 @@
-import { P as r, p as i, u as p, a as s } from "./context-CdSU0w5S.js";
+import { P as r, S as s, p as i, r as o, u as p, a as u, w as P } from "./context-CRk9vKJC.js";
 export {
   r as PLUGIN_GROUP_ICON_MAP,
+  s as SOPS_PLUGIN_GROUP_NAME,
   i as provideVariableInputCreateVariable,
+  o as resolveSopsPluginSources,
   p as useFlowApi,
-  s as useVariableInputCreateVariable
+  u as useVariableInputCreateVariable,
+  P as withSopsPluginGroup
 };