@blueking/bkflow-canvas-editor 1.1.0-beta.4 → 1.1.0-beta.41

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 import * as vue from 'vue';
-import { ComputedRef, Ref } from 'vue';
+import { Component, ComputedRef, Ref, App } from 'vue';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 import * as _blueking_flow_canvas from '@blueking/flow-canvas';
-import { CanvasUiEvent, QuickAddConfig, CanvasSchema, FlowModel, FlowNodeModel, NodeActionsConfig, ConnectionValidator, CanvasPlugin, CanvasToolbarItem, CommandEnvelope } from '@blueking/flow-canvas';
-export { InsertDirection, QuickAddConfig, QuickAddInsertDirectionResolver, QuickAddPortResolver } from '@blueking/flow-canvas';
+import { ZoomToFitOptions, CanvasUiEvent, QuickAddConfig, CanvasSchema, FlowModel, FlowNodeModel, NodeActionsConfig, ConnectionValidator, CanvasPlugin, CanvasToolbarItem, CommandEnvelope } from '@blueking/flow-canvas';
+export { Locale, MessageTree, Translator, getLocale, registerMessages, setLocale, setTranslator, t } from '@blueking/flow-canvas';
+import { defaultRootConfig } from 'bkui-vue/lib/config-provider';
 
 /**
  * Flow API 配置接口
@@ -18,10 +19,7 @@ interface FlowApiConfig {
     /** CSRF cookie 名称（可选，用于创建新的 axios 实例时设置 xsrfCookieName） */
     xsrfCookieName?: string;
     /** 作用域数据（必需，由外部传入） */
-    scopeData: {
-        scope_type: string;
-        scope_value: number;
-    };
+    scopeData: ScopeData;
     /**
      * 用户查询 API 地址（可选）
      * @deprecated 请改用 FlowEdit/FlowView 顶层组件的 `memberSelectorConfig.fetchUserApi`。
@@ -31,12 +29,18 @@ interface FlowApiConfig {
     /** 是否启用第三方插件（可选，默认为 true） */
     enableThirdPlugin?: boolean;
 }
+interface ScopeData {
+    scope_type: string;
+    scope_value: number;
+    /** 业务方传入的空间 ID，语义独立于 scope_value。 */
+    space_id: number;
+}
 
-type __VLS_Slots$5 = {
+type __VLS_Slots$7 = {
     header?: () => any;
     extend?: () => any;
 };
-type __VLS_Props$6 = {
+type __VLS_Props$7 = {
     flowId: string;
     taskId: string | number;
     apiConfig: FlowApiConfig;
@@ -44,17 +48,17 @@ type __VLS_Props$6 = {
     defaultZoom?: number;
     onBack?: () => void;
 };
-declare const __VLS_base$5: vue.DefineComponent<__VLS_Props$6, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+declare const __VLS_base$7: vue.DefineComponent<__VLS_Props$7, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     back: () => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props$6> & Readonly<{
+}, string, vue.PublicProps, Readonly<__VLS_Props$7> & Readonly<{
     onBack?: (() => any) | undefined;
 }>, {
     defaultZoom: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$6: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
-declare const _default$7: typeof __VLS_export$6;
+declare const __VLS_export$7: __VLS_WithSlots$7<typeof __VLS_base$7, __VLS_Slots$7>;
+declare const _default$8: typeof __VLS_export$7;
 
-type __VLS_WithSlots$5<T, S> = T & {
+type __VLS_WithSlots$7<T, S> = T & {
     new (): {
         $slots: S;
     };
@@ -62,11 +66,11 @@ type __VLS_WithSlots$5<T, S> = T & {
 
 declare namespace __mock_vue {
   export {
-    _default$7 as default,
+    _default$8 as default,
   };
 }
 
-type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED';
+type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'SKIP';
 type ExecutionNodeAction = 'retry' | 'skip' | 'resume' | 'approve' | 'forceFail' | 'gatewaySkip';
 interface NodeExecutionState {
     status: NodeExecutionStatus;
@@ -110,6 +114,11 @@ interface NodeExecutionState {
     actions?: ExecutionNodeAction[];
     /** 兼容旧版后端直接透出的动作数组字段 */
     action_list?: ExecutionNodeAction[];
+    /**
+     * 条件网关命中的出边 flow_id。
+     * 有值时执行态连线优先按它着色，不要求目标节点已经执行（网关单步不会跑下游）。
+     */
+    selectedFlowIds?: string[];
 }
 type TaskExecutionStates = Record<string, NodeExecutionState>;
 
@@ -142,13 +151,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;
   };
 }
 
@@ -443,15 +465,20 @@ interface FlowDraftDetail {
     md5sum: string;
     pipeline_tree: PipelineTree;
 }
+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;
@@ -481,6 +508,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;
@@ -564,7 +673,7 @@ interface BkflowThirdPartyPluginAppDetail {
     };
 }
 interface GroupsPluginItem extends PluginGroupConfig {
-    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem)[];
+    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem | SopsPluginSourceItem)[];
 }
 interface DndNodeItem {
     type: string;
@@ -667,14 +776,29 @@ interface PluginOutputItem {
     type: string;
     name: string;
 }
-interface PluginDetailCommon {
+/**
+ * 输入表单的渲染方式与表单项数据。
+ *
+ * 两者必须配对：renderform 的表单项以 tag_code 标识、uniformApiForm 用 key，jsonschemaform
+ * 给的则是一个 schema 对象而非数组。做成判别联合，取默认值、取字段名、选渲染组件这些地方
+ * 就必须先按 inputParamsFormType 收窄，漏掉一种由编译器报出来，而不是在遍历时崩掉。
+ */
+type PluginInputForm = {
+    inputParamsFormType: 'renderform';
+    inputs: RenderformInputsItem[];
+} | {
+    inputParamsFormType: 'jsonschemaform';
+    inputs: JsonschemaformInputs;
+} | {
+    inputParamsFormType: 'uniformApiForm';
+    inputs: UniformApiPluginInputsItem[];
+};
+interface PluginDetailBase {
     code: string;
     name: string;
     desc: string;
     version: string;
-    inputs: UniformApiPluginInputsItem[] | RenderformInputsItem[] | JsonschemaformInputs;
     outputs: PluginOutputItem[];
-    inputParamsFormType: string;
     versions?: string[];
     category?: string;
     group?: string;
@@ -682,10 +806,20 @@ interface PluginDetailCommon {
     methods?: string[];
     uniformApiName?: string;
     polling?: Record<string, any>;
+    callback?: Record<string, any>;
+    response_data_path?: string;
     credential_key?: string;
+    /** V4 开放插件身份，执行时引擎从 component.data 的同名隐藏字段读取 */
+    openPluginIdentity?: {
+        pluginId: string;
+        pluginVersion: string;
+        sourceKey: string;
+        wrapperVersion: string;
+    };
     component_type?: string;
     displayGroupName?: string;
 }
+type PluginDetailCommon = PluginDetailBase & PluginInputForm;
 interface CustomVariableType {
     name: string;
     form: string;
@@ -696,11 +830,428 @@ interface CustomVariableType {
     code: string;
 }
 
-interface FlowEditExpose {
+/**
+ * filter 变量的宿主配置契约与注入。
+ *
+ * `RetrievalFilterField` 与 `getValues` 的返回结构和宿主
+ * `src/components/bk-monitor-retieval-filter/types.d.ts` 里的 `IFilterField`
+ * 逐字段一致——依赖包不带 `.d.ts`，宿主已经自己维护了一份，这里刻意同源，
+ * 避免出现两套形状相近但不兼容的类型。
+ */
+
+/**
+ * 关联节点的插件配置摘要。getFields 在节点表单未挂载时要用它自行取维度，
+ * 不能依赖「打开过节点配置」留下的内存缓存。
+ */
+interface FilterVariableSourceNodeComponent {
+    code?: string;
+    /** `name` 是插件的稳定标识（如 log_plugin）；`id` 随环境变化，不能用来做判断 */
+    api_meta?: {
+        id?: string;
+        name?: string;
+    };
+    data?: Record<string, {
+        value?: unknown;
+    }>;
+}
+/** 关联来源。创建时由宿主锁定，用户不能在编辑器里改 */
+interface FilterVariableSourceContext {
+    sourceNodeId: string;
+    sourceNodeName: string;
+    /** 关联表单项稳定 KEY，例如 query_condition */
+    sourceFieldKey: string;
+    sourceFieldName: string;
+    /** 关联节点当前 component，供宿主 getFields 在节点配置未打开时解析 */
+    sourceNodeComponent?: FilterVariableSourceNodeComponent;
+}
+interface RetrievalFilterField {
+    alias: string;
+    name: string;
+    type: string;
+    isEnableOptions?: boolean;
+    methods: Array<{
+        alias: string;
+        value: string;
+        placeholder?: string;
+        wildcardValue?: string;
+        options?: unknown[];
+    }>;
+}
+/**
+ * 候选值查询参数。
+ *
+ * 这是适配器归一化之后的稳定形状：依赖组件内部有四条 `getValueFn` 调用路径，
+ * 参数形状互不一致（`search`/`field`/`isInit__` vs `where` + `operator` vs
+ * `where` + `method`），禁止把 raw params 直接透给宿主。升级依赖时需重新核对。
+ */
+interface FilterCandidateQuery {
+    field?: string;
+    keyword?: string;
+    limit?: number;
+    method?: string;
+    /** 通配搜索路径会带 `options.is_wildcard`，宿主据此选择精确或模糊匹配 */
+    isWildcard?: boolean;
+}
+interface FilterVariableConfig {
+    /**
+     * 宿主注入的 **原始** `RetrievalFilter` 组件，即
+     * `import { RetrievalFilter } from '@blueking/monitor-vue3-components'`。
+     *
+     * 必须是原始组件而不是宿主自己的封装（例如 bk-incident 的
+     * `BkMonitorRetievalFilter`）：封装层 props 是 `filters/fieldList/query`、事件是
+     * `change`，与适配器传入的 `fields/where` + `whereChange` 不兼容；且它的
+     * `getValueFn` 只透传 `fields`，会丢掉搜索关键词，候选值搜索无法工作。
+     *
+     * 编辑器不把该依赖列入自身 dependencies，所以拿不到注入就是不可用。
+     */
+    retrievalFilterComponent: Component;
+    getFields(source: FilterVariableSourceContext): Promise<RetrievalFilterField[]>;
+    getValues(source: FilterVariableSourceContext, params: FilterCandidateQuery): Promise<{
+        count: number;
+        list: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    /** 传给依赖组件的 `zIndex`，用于让候选值弹层盖在侧滑之上 */
+    popupZIndex?: number;
+    loadDelay?: number;
+    limit?: number;
+}
+/**
+ * 在顶层组件中提供 FilterVariableConfig。
+ *
+ * 与 `provideMemberSelectorConfig` 一致：`config` 为 undefined 时不调用 provide，
+ * 避免遮蔽父级已提供的配置。
+ */
+declare function provideFilterVariableConfig(config?: FilterVariableConfig): void;
+
+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;
+}
+
+/**
+ * filter（复合条件选择）变量的领域逻辑。
+ *
+ * `Variable.value` 直接就是提交给后端的条件数组 `{ key, operator, value, options }[]`，
+ * 不引入编辑态中间形状：编辑器与依赖组件之间只有一处命名差异（`operator` ⇄ `method`），
+ * 那一次转换收在适配器边界上（见 retrieval-filter-adapter/index.vue）。
+ *
+ * 关联标识复用 `Variable.source_info`（C-09），不另立字段。既有的节点删除清理逻辑
+ * 原先只放行 component_inputs / component_outputs，已显式把 filter 一并纳入
+ * （canvas-adapter/plugin/index.ts 的节点删除，以及 node-config-sideslider 保存时
+ * 对照节点数据里是否还引用 `${var}`）。节点删掉或表单里取消引用后不清理，
+ * 就会留下用户无法修复的孤儿变量——关联信息是只读的。
+ */
+
+/**
+ * 条件值标量。
+ *
+ * 必须允许 number：依赖协议里 `value` 是 `number[] | string[]`，整型字段的候选值
+ * 就是数字，统一转成字符串会改变提交给后端的类型。
+ */
+type FilterConditionValue = string | number;
+/**
+ * 单条条件的附加选项。
+ *
+ * `is_wildcard`（通配匹配）与 `group_relation`（多值关系）由依赖组件在运算符的
+ * `methods[].options` 里声明、由用户勾选，并原样带在条件上。丢掉它等于静默改写
+ * 用户的选择，所以读写两侧都必须透传，也不做已知字段白名单。
+ */
+interface FilterConditionOptions {
+    is_wildcard?: boolean;
+    group_relation?: boolean;
+    [key: string]: unknown;
+}
+/** 单条条件，即 Variable.value 的元素。形状对齐宿主既有协议 */
+interface FilterWhereItem {
+    key: string;
+    operator: string;
+    value: FilterConditionValue[];
+    options?: FilterConditionOptions;
+}
+type FilterWhereValue = FilterWhereItem[];
+
+/**
+ * 全局变量受控创建的对外契约与守卫。
+ *
+ * filter 变量不能从普通「新建变量」入口创建——它必须携带关联节点与关联字段，
+ * 所以对外只暴露这一个方法，由宿主在节点表单里发起。
+ *
+ * select 的「关联数据」态同样只能受控创建（`selectRelatedContext`），但它是**可选**的：
+ * select 缺少关联源时退化为「手动输入」，仍是一个可用的变量，不像 filter 那样必须锁定。
+ */
+
+interface OpenFilterVariableCreateRequest {
+    defaultCustomType: 'filter';
+    /** 关联来源，filter 场景必填 */
+    filterContext: FilterVariableSourceContext;
+    selectRelatedContext?: never;
+    keyword?: string;
+    /**
+     * 可选：把宿主表单里已配好的真实维度条件带进来作为默认值。
+     * 已 hook 的 `${var}` 占位会被丢掉，不能当默认条件。
+     */
+    initialValue?: FilterWhereValue;
+    onCreated?: (variable: Variable) => void;
+}
+interface OpenStandardVariableCreateRequest {
+    defaultCustomType?: string;
+    filterContext?: never;
+    /**
+     * 可选：把 select 变量初始化成「关联数据」态并锁定关联源。
+     * 不传则 select 按「手动输入」初始化。
+     */
+    selectRelatedContext?: SelectRelatedSourceContext;
+    keyword?: string;
+    cursorIndex?: number;
+    onCreated?: (variable: Variable) => void;
+}
+type OpenGlobalVariableCreateRequest = OpenFilterVariableCreateRequest | OpenStandardVariableCreateRequest;
+
+/** 画布视口相关方法，供 FlowView / FlowEdit 对外透传 */
+interface CanvasViewportExpose {
+    zoomToFit: (options?: ZoomToFitOptions) => void;
+    centerContent: () => void;
+    getZoom: () => number;
+}
+/** 受控创建能力。返回 false 表示未通过同步守卫，开发态会打印具体原因 */
+interface GlobalVariableCreateExpose {
+    openGlobalVariableCreate: (request?: OpenGlobalVariableCreateRequest) => boolean;
+}
+interface FlowEditExpose extends CanvasViewportExpose, GlobalVariableCreateExpose {
     isFlowEdited: boolean;
     updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
     openGlobalVariables: () => void;
 }
+interface FlowViewExpose extends CanvasViewportExpose {
+}
+/** FlowDetail 统一详情页对外暴露（设计 §7.1） */
+interface FlowDetailExpose extends CanvasViewportExpose, GlobalVariableCreateExpose {
+    isFlowEdited: boolean;
+    updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
+    openGlobalVariables: () => void;
+    refreshDebugContext: () => Promise<void>;
+    openDebugResult: (nodeId?: string) => void;
+}
+
+type DebugContextStatus = 'idle' | 'running' | 'terminating';
+type DebugNodeStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'finished' | 'failed' | 'revoked' | 'suspended' | 'skipped';
+type DebugExecutionMode = 'real' | 'mock';
+interface DebugMissingVar {
+    key: string;
+    source_node_id: string | null;
+}
+type DebugRunType = 'global' | 'step';
+type DebugRunStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'terminating' | 'finished' | 'failed' | 'revoked';
+/** 运行级 / 节点级错误详情（last_error_detail、nodes[].error_detail）。 */
+interface DebugErrorFailure {
+    message: string;
+    node_id?: string;
+    template_node_id?: string;
+    [key: string]: unknown;
+}
+interface DebugErrorDetail {
+    type?: string;
+    message?: string;
+    task_id?: number | string;
+    failures?: DebugErrorFailure[];
+    [key: string]: unknown;
+}
+/** 条件网关分支求值结果（`debug_context.nodes[].condition_results`）。 */
+interface DebugConditionResult {
+    flow_id: string;
+    name?: string;
+    expression?: string;
+    resolved_expression?: string;
+    matched?: boolean;
+    [key: string]: unknown;
+}
+interface DebugContextNode {
+    node_id: string;
+    node_type: string;
+    execution_mode: DebugExecutionMode;
+    status: DebugNodeStatus;
+    can_step: boolean;
+    missing_vars: DebugMissingVar[];
+    waiting_reason?: string | null;
+    /** 是否支持单步调试；并行/汇聚网关为 false，仅用于展示全局调试状态。 */
+    supports_step?: boolean;
+    /** 是否支持 Mock；全部网关为 false。 */
+    supports_mock?: boolean;
+    mock_result?: 'success' | 'fail' | null;
+    error_detail?: DebugErrorDetail | string | null;
+    duration_ms?: number | null;
+    log_ref?: {
+        instance_id: number | string;
+        node_id: string;
+        version: string;
+    } | null;
+    mock_outputs?: Record<string, unknown> | null;
+    mock_error?: string | null;
+    outputs?: Record<string, unknown> | null;
+    /** 条件网关命中的出边 flow_id；画布用它把命中连线标绿。 */
+    selected_flow_ids?: string[];
+    /** 条件网关每个分支的表达式与命中结果。 */
+    condition_results?: DebugConditionResult[];
+}
+/**
+ * /debug_context/ 顶层结构。
+ *
+ * 前端按 status 分支：
+ * - running：任务定位用 active_*，进度用 last_run_status
+ * - terminating：继续用 active_*，UI 展示「终止中」并轮询
+ * - idle：active_* 为空，结果摘要用 last_*；last_task_id=null 表示尚无调试记录
+ */
+interface DebugContext {
+    template_id: number;
+    status: DebugContextStatus;
+    locked_by: string;
+    active_task_id: number | string | null;
+    active_run_type: DebugRunType | null;
+    active_node_id: string | null;
+    last_task_id: number | string | null;
+    last_run_type: DebugRunType | null;
+    last_run_status: DebugRunStatus | null;
+    last_error_detail?: DebugErrorDetail | null;
+    last_inputs?: Record<string, unknown>;
+    global_vars: Record<string, unknown>;
+    missing_vars?: DebugMissingVar[];
+    nodes: DebugContextNode[];
+}
+interface DebugInputSchemaField {
+    key: string;
+    name: string;
+    type: string;
+    default?: unknown;
+    required?: boolean;
+    [key: string]: unknown;
+}
+interface DebugInputSchema {
+    fields?: DebugInputSchemaField[];
+    constants?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface DebugResetImpact {
+    reset_node_ids: string[];
+    reasons?: Record<string, string>;
+}
+interface UpdateNodeDebugMockResult {
+    node_id: string;
+    execution_mode: DebugExecutionMode;
+    updated_global_vars?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface RunNodeDebugStepResult {
+    node_id: string;
+    status: DebugNodeStatus;
+    outputs?: Record<string, unknown> | null;
+    error_detail?: unknown;
+    updated_global_vars?: Record<string, unknown>;
+    log_ref?: DebugContextNode['log_ref'];
+    selected_flow_ids?: string[];
+    condition_results?: DebugConditionResult[];
+    [key: string]: unknown;
+}
+interface RunGlobalDebugResult {
+    task_id: number | string;
+    status: DebugContextStatus;
+    [key: string]: unknown;
+}
+/**
+ * /debug_terminate/ 返回。
+ *
+ * 全局终止返回 `terminating`，需要继续轮询 /debug_context/ 直到 idle + last_run_status=revoked；
+ * 单节点终止直接返回 `idle`，并用 reset_node_ids 告知哪些节点被恢复为「未调试」。
+ */
+interface TerminateDebugResult {
+    status?: DebugContextStatus;
+    /** 单节点终止：被恢复为 not_run 的节点，本地需同步清空输入、输出、耗时、错误与日志。 */
+    reset_node_ids?: string[];
+    [key: string]: unknown;
+}
+interface DebugResetResult {
+    reset_node_ids?: string[];
+    [key: string]: unknown;
+}
+interface UpdateNodeDebugMockParams {
+    templateId: string | number;
+    nodeId: string;
+    enable: boolean;
+    mockResult?: 'success' | 'fail';
+    mockOutputs?: Record<string, unknown>;
+    mockError?: string;
+}
+interface RunNodeDebugStepParams {
+    templateId: string | number;
+    nodeId: string;
+    mode: 'real' | 'mock';
+    inputOverrides?: Record<string, unknown>;
+    mockResult?: 'success' | 'fail';
+    mockOutputs?: Record<string, unknown>;
+    mockError?: string;
+}
+interface RunGlobalDebugParams {
+    templateId: string | number;
+    inputs: Record<string, unknown>;
+}
+interface TerminateDebugParams {
+    templateId: string | number;
+    nodeId?: string;
+}
+interface ResetDebugResultParams {
+    templateId: string | number;
+    nodeIds?: string[];
+}
+interface DebugApiServices {
+    fetchDebugContext(templateId: string | number): Promise<DebugContext>;
+    fetchDebugInputSchema(templateId: string | number): Promise<DebugInputSchema>;
+    fetchDebugResetImpact(templateId: string | number): Promise<DebugResetImpact>;
+    updateNodeDebugMock(params: UpdateNodeDebugMockParams): Promise<UpdateNodeDebugMockResult>;
+    runNodeDebugStep(params: RunNodeDebugStepParams): Promise<RunNodeDebugStepResult>;
+    runGlobalDebug(params: RunGlobalDebugParams): Promise<RunGlobalDebugResult>;
+    terminateDebug(params: TerminateDebugParams): Promise<TerminateDebugResult>;
+    resetDebugResult(params: ResetDebugResultParams): Promise<DebugResetResult>;
+}
 
 interface DrawPipelineParams {
     pipeline_tree: PipelineTree;
@@ -730,6 +1281,7 @@ interface FetchTaskStateParams {
 interface FetchTaskNodeDetailParams {
     task_id: number | string;
     node_id: string;
+    component_code?: string;
 }
 interface FetchTaskNodeSnapshotParams {
     task_id: number | string;
@@ -751,12 +1303,75 @@ 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;
+    /** 任务已耗时（秒），调试摘要弹层刷新恢复用。 */
+    elapsed_time?: number;
+    [key: string]: unknown;
+}
+interface CreateFlowTaskParams {
+    template_id: number;
+    name: string;
+    creator: string;
+    constants: Record<string, any>;
+    label_ids?: number[];
+    [key: string]: unknown;
+}
+interface CreateFlowTaskResult {
+    data: {
+        id: number | string;
+        template_id?: number;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+interface ExecuteFlowTaskResult {
+    result?: boolean;
+    code?: number;
+    data?: {
+        /** 任务详情页跳转地址（含正确的 bkflow task id 与 templateId） */
+        url?: string;
+        [key: string]: unknown;
+    };
+    message?: string | null;
+    request_id?: string;
+    trace_id?: string | null;
     [key: string]: unknown;
 }
+interface FlowTaskExecuteSuccessResult {
+    /** createFlowTask（create_task）接口响应 */
+    createResult: CreateFlowTaskResult;
+    /** executeFlowTask（operate_task）接口响应，data.url 用于任务详情跳转 */
+    executeResult: ExecuteFlowTaskResult;
+}
 interface TaskStateResult {
     state?: string;
     status?: string;
@@ -782,6 +1397,8 @@ interface FlowViewApiConfig {
     scopeData: {
         scope_type: string;
         scope_value: number;
+        /** 业务方传入的空间 ID，调试接口专用，语义独立于 scope_value */
+        space_id: number;
     };
     fetchFlowDraftDetail?: (id: string) => Promise<FlowDraftDetail>;
     fetchFlowDetailByVersion?: (id: string, version: string) => Promise<FlowDetailByVersion>;
@@ -801,23 +1418,13 @@ interface FlowViewApiConfig {
             data: any[];
         };
     }>;
-    createFlowTask?: (params: {
-        template_id: number;
-        name: string;
-        creator: string;
-        constants: Record<string, any>;
-    }) => Promise<{
-        data: {
-            id: number;
-            template_id: number;
-        };
-    }>;
+    createFlowTask?: (params: CreateFlowTaskParams) => Promise<CreateFlowTaskResult>;
     executeFlowTask?: (params: {
         task_id: number | string;
         resource_type: string;
         resource_id: number | string;
         permission_type: string;
-    }) => Promise<any>;
+    }) => Promise<ExecuteFlowTaskResult>;
     revokeFlowTask?: (params: {
         task_id: number | string;
         resource_type: string;
@@ -869,28 +1476,21 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchCategoryPlugins: (category: string) => Promise<PluginMetaItem[]>;
     fetchAllPluginGroups: () => Promise<GroupsPluginItem[]>;
     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<{
         pipeline_tree: PipelineTree;
     }>;
-    createFlowTask?: (params: {
-        template_id: number;
-        name: string;
-        creator: string;
-        constants: Record<string, any>;
-    }) => Promise<{
-        data: {
-            id: number;
-            template_id: number;
-        };
-    }>;
+    createFlowTask?: (params: CreateFlowTaskParams) => Promise<CreateFlowTaskResult>;
     executeFlowTask?: (params: {
         task_id: number | string;
         resource_type: string;
         resource_id: number | string;
         permission_type: string;
-    }) => Promise<any>;
+    }) => Promise<ExecuteFlowTaskResult>;
     revokeFlowTask?: (params: {
         task_id: number | string;
         resource_type: string;
@@ -910,6 +1510,8 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
     getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
 }
+interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices> {
+}
 
 /**
  * 插件分组选择面板配置
@@ -919,6 +1521,7 @@ interface SelectPanelConfig {
     agentResourceUrl?: string;
     agentButtonText?: string;
     knowledgebaseResourceUrl?: string;
+    sopsCategoryWhitelist?: string;
 }
 /**
  * 人员选择器配置
@@ -954,13 +1557,13 @@ type MemberSelectorConfig = {
  * @param config FlowApiConfig 配置对象或已处理的 API 配置对象
  * @returns 返回处理后的 API 配置对象
  */
-declare function provideFlowApiConfig(config: FlowApiConfig | FlowEditApiConfig | FlowViewApiConfig): FlowEditApiConfig | FlowViewApiConfig;
+declare function provideFlowApiConfig(config: FlowApiConfig | FlowDetailApiConfig | FlowEditApiConfig | FlowViewApiConfig): FlowDetailApiConfig | FlowEditApiConfig | FlowViewApiConfig;
 /**
  * 在子组件中注入 FlowApiConfig（通用版本）
  * @returns FlowEditApiConfig
  * @throws 如果 apiConfig 未提供则抛出错误
  */
-declare function useFlowApiConfig(): FlowEditApiConfig;
+declare function useFlowApiConfig(): FlowDetailApiConfig;
 /**
  * 在子组件中注入 FlowEditApiConfig（类型化版本）
  * @returns FlowEditApiConfig
@@ -1002,7 +1605,7 @@ declare function provideMemberSelectorConfig(config?: MemberSelectorConfig): voi
  */
 declare function useMemberSelectorConfig(): MemberSelectorConfig;
 
-type __VLS_Props$5 = {
+type __VLS_Props$6 = {
     flowId: string;
     show: boolean;
     editable?: boolean;
@@ -1026,15 +1629,15 @@ declare var __VLS_72: {
     };
     variablesValue: Record<string, any>;
 };
-type __VLS_Slots$4 = {} & {
+type __VLS_Slots$6 = {} & {
     'custom-form-content'?: (props: typeof __VLS_72) => any;
 };
-declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$5, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+declare const __VLS_base$6: vue.DefineComponent<__VLS_Props$6, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     close: (...args: any[]) => void;
     "update:show": (...args: any[]) => void;
     confirm: (...args: any[]) => void;
     "before-close": (...args: any[]) => void;
-}, string, vue.PublicProps, Readonly<__VLS_Props$5> & Readonly<{
+}, string, vue.PublicProps, Readonly<__VLS_Props$6> & Readonly<{
     onClose?: ((...args: any[]) => any) | undefined;
     "onUpdate:show"?: ((...args: any[]) => any) | undefined;
     onConfirm?: ((...args: any[]) => any) | undefined;
@@ -1045,10 +1648,10 @@ declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$5, {}, {}, {}, {}, v
     useCustomConfirm: boolean;
     enableVersion: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$5: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
-declare const _default$6: typeof __VLS_export$5;
+declare const __VLS_export$6: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
+declare const _default$7: typeof __VLS_export$6;
 
-type __VLS_WithSlots$4<T, S> = T & {
+type __VLS_WithSlots$6<T, S> = T & {
     new (): {
         $slots: S;
     };
@@ -1056,15 +1659,15 @@ type __VLS_WithSlots$4<T, S> = T & {
 
 declare namespace __debug_vue {
   export {
-    _default$6 as default,
+    _default$7 as default,
   };
 }
 
-type __VLS_Slots$3 = {
+type __VLS_Slots$5 = {
     header?: () => any;
     extend?: () => any;
 };
-type __VLS_Props$4 = {
+type __VLS_Props$5 = {
     pipelineTree: PipelineTree;
     nodeStates?: TaskExecutionStates;
     defaultZoom?: number;
@@ -1073,7 +1676,7 @@ type __VLS_Props$4 = {
     showHeader?: boolean;
     onBack?: () => void;
 };
-declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$4, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+declare const __VLS_base$5: vue.DefineComponent<__VLS_Props$5, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     retry: (nodeId: string) => any;
     skip: (nodeId: string) => any;
     resume: (nodeId: string) => any;
@@ -1092,7 +1695,7 @@ declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$4, {}, {}, {}, {}, v
         nodeId: string;
         action: ExecutionNodeAction;
     }) => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props$4> & Readonly<{
+}, string, vue.PublicProps, Readonly<__VLS_Props$5> & Readonly<{
     onRetry?: ((nodeId: string) => any) | undefined;
     onSkip?: ((nodeId: string) => any) | undefined;
     onResume?: ((nodeId: string) => any) | undefined;
@@ -1116,10 +1719,10 @@ declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$4, {}, {}, {}, {}, v
     defaultZoom: number;
     nodeStates: TaskExecutionStates;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$4: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
-declare const _default$5: typeof __VLS_export$4;
+declare const __VLS_export$5: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
+declare const _default$6: typeof __VLS_export$5;
 
-type __VLS_WithSlots$3<T, S> = T & {
+type __VLS_WithSlots$5<T, S> = T & {
     new (): {
         $slots: S;
     };
@@ -1127,27 +1730,101 @@ type __VLS_WithSlots$3<T, S> = T & {
 
 declare namespace __execute_vue {
   export {
-    _default$5 as default,
+    _default$6 as default,
   };
 }
 
-type __VLS_Props$3 = {
+/**
+ * select 变量「关联数据」候选来源的领域逻辑。
+ *
+ * 关联标识落在 `meta.related` 的 `node_id` / `field_key` 上，不复用 `source_info`——
+ * 那里表达的是「哪些节点表单项 hook 了本变量」，两种语义混在一起会让节点删除时的
+ * 清理逻辑误伤。
+ *
+ * 与 filter 的差异是刻意的：filter 脱离关联节点就无法执行，所以它锁定类型、并在
+ * 节点删除时连变量一起清理；select 关联失效后退回「手动输入」就能继续用，而且可能
+ * 已被多处引用，因此这里既不锁类型也不做清理，只把「关联节点已不存在」暴露给配置态。
+ */
+
+/** 关联标识。select 恒为单节点单表单项 */
+interface SelectRelatedSource {
+    nodeId: string;
+    fieldKey: string;
+}
+/** 关联来源的完整信息：标识 + 宿主自定义的来源引用 */
+interface SelectRelatedSourceInfo extends SelectRelatedSource {
+    optionSource?: SelectRelatedOptionSourceRef;
+}
+
+/**
+ * 关联态 select 的候选项来源：由宿主注入。
+ *
+ * 编辑器不认识具体插件与接口，只要 `{ id, name }[]`——「调哪条指令、响应怎么解析」
+ * 是宿主的知识，放进来就得在编辑器里写死插件名。
+ *
+ * 契约刻意比 FilterVariableConfig 小：filter 需要注入依赖组件、字段与候选值三件套，
+ * select 只需要一次列表拉取。
+ */
+
+interface SelectRelatedOptionItem {
+    id: string;
+    name: string;
+}
+interface SelectRelatedOptionSource extends SelectRelatedSourceInfo {
+    /**
+     * 关联节点当前 component，仅在节点配置**已写回** pipeline_tree 时才反映真实插件。
+     * 从节点配置面板发起创建时它还是换插件之前的那个，所以宿主必须核对后再用，
+     * 不能把它当作插件标识的唯一来源。
+     */
+    nodeComponent?: FilterVariableSourceNodeComponent;
+}
+interface SelectRelatedOptionConfig {
+    getOptions(source: SelectRelatedOptionSource): Promise<SelectRelatedOptionItem[]>;
+    /**
+     * 关联来源在「关联数据」栏的展示名（如「查询条件」）。
+     *
+     * 由宿主实时提供而不是沿用创建时的快照：那个文案属于宿主的节点表单，改了之后已存
+     * 变量也该跟着显示新的。不实现或返回空时回落快照。
+     */
+    resolveSourceLabel?(source: SelectRelatedSourceInfo): string | undefined;
+}
+/**
+ * 在顶层组件中提供候选项来源。
+ *
+ * 与 `provideFilterVariableConfig` 一致：config 为 undefined 时不调用 provide，
+ * 避免遮蔽父级已提供的配置。
+ */
+declare function provideSelectRelatedOptionConfig(config?: SelectRelatedOptionConfig): void;
+
+type __VLS_Slots$4 = {
+    customFormContent?: (props: {
+        customFormData: Record<string, any>;
+        additionalTaskParams: Record<string, any>;
+        updateCustomFormData: (data: Record<string, any>) => void;
+        updateAdditionalTaskParams: (params: Record<string, any>) => void;
+    }) => any;
+};
+type __VLS_Props$4 = {
     flowId: string;
     show: boolean;
     editable?: boolean;
     showFlowEntry?: boolean;
     apiConfig: FlowApiConfig;
-    onExecuteSuccess?: (taskId: number, templateId: number) => void;
+    onExecuteSuccess?: (result: FlowTaskExecuteSuccessResult) => void;
     bkflowSaasUrl?: string;
     memberSelectorConfig?: MemberSelectorConfig;
+    /** 执行时填写 filter 变量条件所需的能力；不传则这类变量退化为只读文本 */
+    filterVariableConfig?: FilterVariableConfig;
+    /** 执行时关联态 select 变量的候选项来源；不传则这类变量的下拉为空 */
+    selectRelatedOptionConfig?: SelectRelatedOptionConfig;
 };
-declare const __VLS_export$3: vue.DefineComponent<__VLS_Props$3, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$4, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     close: (...args: any[]) => void;
     "update:show": (...args: any[]) => void;
     confirm: (...args: any[]) => void;
     "before-close": (...args: any[]) => void;
     "view-flow": (...args: any[]) => void;
-}, string, vue.PublicProps, Readonly<__VLS_Props$3> & Readonly<{
+}, string, vue.PublicProps, Readonly<__VLS_Props$4> & Readonly<{
     onClose?: ((...args: any[]) => any) | undefined;
     "onUpdate:show"?: ((...args: any[]) => any) | undefined;
     onConfirm?: ((...args: any[]) => any) | undefined;
@@ -1157,20 +1834,27 @@ declare const __VLS_export$3: vue.DefineComponent<__VLS_Props$3, {}, {}, {}, {},
     editable: boolean;
     showFlowEntry: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const _default$4: typeof __VLS_export$3;
+declare const __VLS_export$4: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
+declare const _default$5: typeof __VLS_export$4;
+
+type __VLS_WithSlots$4<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
 
 declare namespace __create_task_vue {
   export {
-    _default$4 as default,
+    _default$5 as default,
   };
 }
 
-type __VLS_Slots$2 = {
+type __VLS_Slots$3 = {
     header?: () => any;
     inputParams?: (props: {
         node: any;
         pluginDetail: PluginDetailCommon | null;
-        inputs: any[];
+        inputs: PluginInputForm['inputs'];
         editable: boolean;
         fullVariableList: {
             key: string;
@@ -1189,7 +1873,7 @@ type __VLS_Slots$2 = {
         variablesValue: Record<string, any>;
     }) => any;
 };
-type __VLS_Props$2 = {
+type __VLS_Props$3 = {
     flowId: string;
     apiConfig: FlowApiConfig;
     permissions?: {
@@ -1203,6 +1887,10 @@ type __VLS_Props$2 = {
     useCustomDebugConfirm?: boolean;
     selectPanelConfig?: SelectPanelConfig;
     memberSelectorConfig?: MemberSelectorConfig;
+    /** 复合条件选择（filter）变量的宿主配置；不传则该类型变量不可用，其余功能不受影响 */
+    filterVariableConfig?: FilterVariableConfig;
+    /** 关联态 select 变量的候选项来源；不传则这类变量的下拉为空，其余功能不受影响 */
+    selectRelatedOptionConfig?: SelectRelatedOptionConfig;
     onSave?: (flowData: FlowTemplate) => void;
     onSaveSuccess?: () => void;
     onBack?: () => void;
@@ -1218,11 +1906,17 @@ type __VLS_Props$2 = {
     bkflowSaasUrl?: string;
     enableThirdPlugin?: boolean;
     quickAdd?: QuickAddConfig;
+    /** 是否隐藏基础信息中的触发器配置表单，默认 false */
+    hideTrigger?: boolean;
 };
-declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {
+declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$3, {
     isFlowEdited: ComputedRef<FlowEditExpose["isFlowEdited"]>;
     updateNodeInputParams: FlowEditExpose["updateNodeInputParams"];
     openGlobalVariables: FlowEditExpose["openGlobalVariables"];
+    openGlobalVariableCreate: FlowEditExpose["openGlobalVariableCreate"];
+    zoomToFit: FlowEditExpose["zoomToFit"];
+    centerContent: FlowEditExpose["centerContent"];
+    getZoom: FlowEditExpose["getZoom"];
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     back: () => any;
     save: (flowData: FlowTemplate) => any;
@@ -1233,11 +1927,8 @@ declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {
     saveSuccess: () => any;
     exitEdit: () => any;
     debugBeforeClose: () => any;
-    createVariable: (payload: {
-        keyword: string;
-        cursorIndex: number;
-    }) => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
+    createVariable: (payload: CreateVariablePayload) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$3> & Readonly<{
     onBack?: (() => any) | undefined;
     onSave?: ((flowData: FlowTemplate) => any) | undefined;
     onMockDebugCreated?: ((params: {
@@ -1247,25 +1938,23 @@ declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {
     onSaveSuccess?: (() => any) | undefined;
     onExitEdit?: (() => any) | undefined;
     onDebugBeforeClose?: (() => any) | undefined;
-    onCreateVariable?: ((payload: {
-        keyword: string;
-        cursorIndex: number;
-    }) => any) | undefined;
+    onCreateVariable?: ((payload: CreateVariablePayload) => any) | undefined;
 }>, {
     quickAdd: QuickAddConfig;
+    enableThirdPlugin: boolean;
+    hideTrigger: boolean;
     defaultZoom: number;
+    enableDebug: boolean;
     enableVersion: boolean;
     permissions: {
         canSave?: boolean;
     };
-    enableDebug: boolean;
     useCustomDebugConfirm: boolean;
-    enableThirdPlugin: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$2: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
-declare const _default$3: typeof __VLS_export$2;
+declare const __VLS_export$3: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default$4: typeof __VLS_export$3;
 
-type __VLS_WithSlots$2<T, S> = T & {
+type __VLS_WithSlots$3<T, S> = T & {
     new (): {
         $slots: S;
     };
@@ -1273,16 +1962,16 @@ type __VLS_WithSlots$2<T, S> = T & {
 
 declare namespace __edit_vue {
   export {
-    _default$3 as default,
+    _default$4 as default,
   };
 }
 
-type __VLS_Slots$1 = {
+type __VLS_Slots$2 = {
     header?: () => any;
     inputParams?: (props: {
         node: any;
         pluginDetail: PluginDetailCommon | null;
-        inputs: any[];
+        inputs: PluginInputForm['inputs'];
         editable: boolean;
         fullVariableList: {
             key: string;
@@ -1290,6 +1979,12 @@ type __VLS_Slots$1 = {
         }[];
         updateInputParams: (data: Record<string, any>) => void;
     }) => any;
+    customFormContent?: (props: {
+        customFormData: Record<string, any>;
+        additionalTaskParams: Record<string, any>;
+        updateCustomFormData: (data: Record<string, any>) => void;
+        updateAdditionalTaskParams: (params: Record<string, any>) => void;
+    }) => any;
     debugCustomFormContent?: (props: {
         formData: {
             name: string;
@@ -1297,11 +1992,12 @@ type __VLS_Slots$1 = {
         variablesValue: Record<string, any>;
     }) => any;
 };
-type __VLS_Props$1 = {
+type __VLS_Props$2 = {
     flowId: string;
     apiConfig: FlowApiConfig;
     permissions?: {
         canEdit?: boolean;
+        canExecute?: boolean;
     };
     onEdit?: () => void;
     onBack?: () => void;
@@ -1311,22 +2007,28 @@ type __VLS_Props$1 = {
     showHeaderActions?: boolean;
     defaultZoom?: number;
     bkflowSaasUrl?: string;
-    onExecuteSuccess?: (taskId: number, templateId: number) => void;
+    onExecuteSuccess?: (result: FlowTaskExecuteSuccessResult) => void;
     memberSelectorConfig?: MemberSelectorConfig;
     enableDebug?: boolean;
     onMockDebugCreated?: (params: {
         taskId: number | string;
         templateId: number | string;
     }) => void;
+    /** 是否隐藏基础信息中的触发器配置表单，默认 false */
+    hideTrigger?: boolean;
 };
-declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {
+    zoomToFit: (options?: ZoomToFitOptions) => void;
+    centerContent: () => void;
+    getZoom: () => number;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     edit: () => any;
     back: () => any;
     mockDebugCreated: (params: {
         taskId: number | string;
         templateId: number | string;
     }) => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
+}, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
     onEdit?: (() => any) | undefined;
     onBack?: (() => any) | undefined;
     onMockDebugCreated?: ((params: {
@@ -1335,18 +2037,20 @@ declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {}, {}, {}, {}, v
     }) => any) | undefined;
 }>, {
     thumbnail: boolean;
+    hideTrigger: boolean;
     defaultZoom: number;
+    enableDebug: boolean;
     enableVersion: boolean;
     permissions: {
         canEdit?: boolean;
+        canExecute?: boolean;
     };
     showHeaderActions: boolean;
-    enableDebug: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
-declare const _default$2: typeof __VLS_export$1;
+declare const __VLS_export$2: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
+declare const _default$3: typeof __VLS_export$2;
 
-type __VLS_WithSlots$1<T, S> = T & {
+type __VLS_WithSlots$2<T, S> = T & {
     new (): {
         $slots: S;
     };
@@ -1354,10 +2058,108 @@ type __VLS_WithSlots$1<T, S> = T & {
 
 declare namespace __view_vue {
   export {
-    _default$2 as default,
+    _default$3 as default,
   };
 }
 
+/**
+ * FlowDetail 权限（默认拒绝，设计 §3.1 / §7.2）。
+ */
+interface FlowDetailPermissions {
+    canEdit: boolean;
+    canDebug: boolean;
+    canExecute: boolean;
+}
+
+type __VLS_Slots$1 = {
+    header?: () => any;
+    /** 头部右侧操作区追加宿主自定义按钮，位于内置「保存」「执行流程」之后 */
+    headerActions?: (props: {
+        savePending: boolean;
+        canMutateFlow: boolean;
+    }) => any;
+    inputParams?: (props: {
+        node: any;
+        pluginDetail: PluginDetailCommon | null;
+        inputs: PluginInputForm['inputs'];
+        editable: boolean;
+        fullVariableList: {
+            key: string;
+            name: string;
+            source_type?: string;
+            custom_type?: string;
+        }[];
+        updateInputParams: (data: Record<string, PluginInputDataItem>) => void;
+        updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
+        updateVariableSourceInfo: (variableKey: string, nodeId: string, formKey: string) => void;
+    }) => any;
+    customFormContent?: (props: {
+        customFormData: Record<string, any>;
+        additionalTaskParams: Record<string, any>;
+        updateCustomFormData: (data: Record<string, any>) => void;
+        updateAdditionalTaskParams: (params: Record<string, any>) => void;
+    }) => any;
+};
+type __VLS_Props$1 = {
+    flowId: string;
+    apiConfig: FlowApiConfig | FlowDetailApiConfig;
+    permissions?: Partial<FlowDetailPermissions>;
+    enableVersion?: boolean;
+    flowVersion?: string;
+    defaultZoom?: number;
+    bkflowSaasUrl?: string;
+    enableThirdPlugin?: boolean;
+    quickAdd?: QuickAddConfig;
+    hideTrigger?: boolean;
+    selectPanelConfig?: SelectPanelConfig;
+    memberSelectorConfig?: MemberSelectorConfig;
+    /** 复合条件选择（filter）变量的宿主配置；不传则该类型变量不可用，其余功能不受影响 */
+    filterVariableConfig?: FilterVariableConfig;
+    /** 关联态 select 变量的候选项来源；不传则这类变量的下拉为空，其余功能不受影响 */
+    selectRelatedOptionConfig?: SelectRelatedOptionConfig;
+    onSave?: (flowData: FlowTemplate) => void;
+    onSaveSuccess?: () => void;
+    onExecuteSuccess?: (result: FlowTaskExecuteSuccessResult) => void;
+    onBack?: () => void;
+};
+declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {
+    isFlowEdited: ComputedRef<boolean>;
+    updateNodeInputParams: FlowDetailExpose["updateNodeInputParams"];
+    openGlobalVariables: FlowDetailExpose["openGlobalVariables"];
+    openGlobalVariableCreate: FlowDetailExpose["openGlobalVariableCreate"];
+    refreshDebugContext: FlowDetailExpose["refreshDebugContext"];
+    openDebugResult: FlowDetailExpose["openDebugResult"];
+    zoomToFit: FlowDetailExpose["zoomToFit"];
+    centerContent: FlowDetailExpose["centerContent"];
+    getZoom: FlowDetailExpose["getZoom"];
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+    back: () => any;
+    save: (flowData: FlowTemplate) => any;
+    saveSuccess: () => any;
+    createVariable: (payload: CreateVariablePayload) => any;
+    executeSuccess: (result: FlowTaskExecuteSuccessResult) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
+    onBack?: (() => any) | undefined;
+    onSave?: ((flowData: FlowTemplate) => any) | undefined;
+    onSaveSuccess?: (() => any) | undefined;
+    onCreateVariable?: ((payload: CreateVariablePayload) => any) | undefined;
+    onExecuteSuccess?: ((result: FlowTaskExecuteSuccessResult) => any) | undefined;
+}>, {
+    quickAdd: QuickAddConfig;
+    enableThirdPlugin: boolean;
+    hideTrigger: boolean;
+    defaultZoom: number;
+    enableVersion: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const _default$2: typeof __VLS_export$1;
+
+type __VLS_WithSlots$1<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
 type SimulateDebugStage = 'edit' | 'mock-config' | 'mock-running';
 type MockFormControl = 'bk-input' | 'bk-input-number' | 'bk-textarea' | 'json-editor' | 'bk-select' | 'bk-checkbox-group' | 'bk-radio-group' | 'bk-switcher' | 'bk-date-picker' | 'bk-date-range-picker' | 'data-table';
 interface MockOutputField extends PluginOutputItem {
@@ -1407,10 +2209,19 @@ declare function isMockableNode(node: NodeType | Activity | undefined | null): n
 declare const random4: () => string;
 declare const generateId: (group?: number) => string;
 
+interface ValidatePipelineTreeOptions {
+    /**
+     * 需要「已配置插件」的节点集合，不传时要求全部节点均已配置。
+     *
+     * 单步 / Mock 调试只依赖目标节点自身的配置（后端 step_run 用目标节点单独拼一棵最小流程树），
+     * 画布其余未配置节点不影响调试，因此这类场景只传目标节点，允许空节点先存为草稿。
+     */
+    requireConfiguredNodeIds?: string[];
+}
 /**
  * 画布pipeline_tree数据校验
  */
-declare const validatePipelineTree: (pipelineTree: PipelineTree) => {
+declare const validatePipelineTree: (pipelineTree: PipelineTree, options?: ValidatePipelineTreeOptions) => {
     valid: boolean;
     message: string;
     ids: string[];
@@ -1467,6 +2278,25 @@ declare class BkFlowModelAccessor {
     get flowModel(): FlowModel;
 }
 
+/**
+ * 新调试（FlowDetail）向画布节点透出的最小上下文（设计 §14.3）。
+ *
+ * - isMockNode：节点渲染据此显示 MOCK 标签；
+ * - 其余为可选能力：独立调试聚焦态、打开节点调试面板。
+ *   保持可选以兼容仅需 Mock 标签的场景，且不改变对外 npm 公共 API。
+ */
+interface DebugCanvasContext {
+    isMockNode(nodeId: string): boolean;
+    /** 节点调试状态；任务节点用它补充未执行（not_run）标识，不写入连线执行态。 */
+    getNodeStatus?(nodeId: string): string | undefined;
+    /** 当前独立调试聚焦节点（不复用 X6 编辑选择态，设计 §9.3.2） */
+    focusedNodeId?(): string;
+    /** 打开该节点详情侧滑的“调试配置”Tab */
+    openNodeDebugPanel?(nodeId: string): void;
+    /** 调试锁定期（running/terminating）；节点配置据此展示只读说明 Alert */
+    isLocked?(): boolean;
+}
+
 type __VLS_Props = {
     pipelineTree: PipelineTree;
     mode?: BkflowBusinessCanvasMode;
@@ -1478,6 +2308,7 @@ type __VLS_Props = {
     additionalPlugins?: CanvasPlugin[];
     toolbarItems?: CanvasToolbarItem[];
     simulateDebugContext?: SimulateDebugCanvasContext;
+    debugContext?: DebugCanvasContext;
 };
 declare var __VLS_8: {};
 declare var __VLS_22: {
@@ -1572,8 +2403,8 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
     }) => any) | undefined;
     "onFormat-position"?: (() => any) | undefined;
 }>, {
-    mode: BkflowBusinessCanvasMode;
     thumbnail: boolean;
+    mode: BkflowBusinessCanvasMode;
     nodeActions: NodeActionsConfig;
     quickAdd: QuickAddConfig;
     defaultZoom: number;
@@ -1617,7 +2448,7 @@ declare function exportToPipelineTree(flowModel: FlowModel): PipelineTree;
  *  - edge.reconnect：若源从条件网关迁出，清理旧条件
  *  - node.remove：主动查找将被级联删除的边，清理对应网关条件；
  *    若删除的是分支网关，级联删除关联的 placeholder 节点；
- *    同时清理全局变量中对被删除节点的 source_info 引用，并删除已无引用的变量
+ *    同时清理全局变量中对被删除节点的 source_info 引用，并删除已无引用的派生变量
  */
 declare function createBkflowPlugin(): CanvasPlugin;
 
@@ -1640,14 +2471,40 @@ declare function createExecutionStatusPlugin(stateRef: Ref<TaskExecutionStates>)
  */
 declare function resolveExecutionActions(state: NodeExecutionState | undefined, nodeType: string): ExecutionNodeAction[];
 
+type BkuiLocale = typeof defaultRootConfig.locale;
+/** 取当前语言对应的 bkui-vue 语言包；消费方注册的第三语言从 registry 取。 */
+declare function resolveBkuiLocale(locale: string): BkuiLocale | undefined;
+/**
+ * 顶层 Flow 组件 setup 内调用：在本组件子树内应用语言（含 Teleport 弹层），
+ * 并改写 defaultRootConfig 覆盖脱离组件树的命令式 Message / InfoBox。
+ *
+ * 约束 1：必须先读 useGlobalConfig() 再合并。provideGlobalConfig 内部是
+ *   merge(defaultRootConfig, config)，直接传 { locale } 会拿 defaultRootConfig.prefix
+ *   覆盖宿主自定义的 prefix。
+ * 约束 2：zh-cn 时整段跳过，保证现有消费方零行为变化，也不会把已设为英文的宿主拽回中文。
+ *   代价是不会把 defaultRootConfig 改回中文——语言切换本就要求宿主刷新页面。
+ *
+ * 注意 defaultRootConfig 是 bkui-vue 的模块级单例，这一行的**影响范围是整个宿主应用**，
+ * 不限于本组件子树：宿主在别处调用的 bkui-vue 命令式弹窗语言也会随之变化。
+ * 这是覆盖命令式组件的唯一手段（它们没有组件上下文可供 inject），已在
+ * docs/usage.md「对宿主 bkui-vue 全局配置的影响」中对消费方说明。
+ */
+declare function applyBkuiLocaleToTree(): void;
+/** 自建 createApp 调用：该 app 脱离宿主 provide 链，从 defaultRootConfig 起步合并。 */
+declare function applyBkuiLocale(app: App): void;
+
 declare const _default: {
     FlowView: () => Promise<typeof __view_vue>;
     FlowEdit: () => Promise<typeof __edit_vue>;
     FlowCreateTask: () => Promise<typeof __create_task_vue>;
     FlowExecute: () => Promise<typeof __execute_vue>;
     FlowDebug: () => Promise<typeof __debug_vue>;
+    /**
+     * @deprecated Use FlowDetail with permissions.canDebug instead.
+     * FlowMockDebug will be removed in the next major version.
+     */
     FlowMockDebug: () => Promise<typeof __mock_vue>;
 };
 
-export { _default$1 as BkFlowCanvas, BkFlowModelAccessor, BkFlowNodeAccessor, _default$4 as FlowCreateTask, _default$6 as FlowDebug, _default$3 as FlowEdit, _default$5 as FlowExecute, _default$7 as FlowMockDebug, _default$2 as FlowView, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, isMockableNode, mergeOutputs, normalizePluginOutputItems, provideFlowApiConfig, provideMemberSelectorConfig, provideSelectPanelConfig, random4, resolveExecutionActions, resolveMockFormControl, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useMemberSelectorConfig, useSelectPanelConfig, validatePipelineTree };
-export type { Activity, DndNodeItem, ExecutionNodeAction, FlowApiConfig, FlowEditExpose, FlowTemplate, Gateway, GatewayCondition, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, PipelineTree, PluginDetailCommon, PluginInputDataItem, SelectPanelConfig, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };
+export { _default$1 as BkFlowCanvas, BkFlowModelAccessor, BkFlowNodeAccessor, _default$5 as FlowCreateTask, _default$7 as FlowDebug, _default$2 as FlowDetail, _default$4 as FlowEdit, _default$6 as FlowExecute, _default$8 as FlowMockDebug, _default$3 as FlowView, applyBkuiLocale, applyBkuiLocaleToTree, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, isMockableNode, mergeOutputs, normalizePluginOutputItems, provideFilterVariableConfig, provideFlowApiConfig, provideMemberSelectorConfig, provideSelectPanelConfig, provideSelectRelatedOptionConfig, random4, resolveBkuiLocale, resolveExecutionActions, resolveMockFormControl, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useMemberSelectorConfig, useSelectPanelConfig, validatePipelineTree };
+export type { Activity, CanvasViewportExpose, CreateFlowTaskResult, DndNodeItem, ExecuteFlowTaskResult, ExecutionNodeAction, FilterCandidateQuery, FilterConditionOptions, FilterConditionValue, FilterVariableConfig, FilterVariableSourceContext, FilterVariableSourceNodeComponent, FilterWhereItem, FilterWhereValue, FlowApiConfig, FlowDetailExpose, FlowDetailPermissions, FlowEditExpose, FlowTaskExecuteSuccessResult, FlowTemplate, FlowViewExpose, Gateway, GatewayCondition, GlobalVariableCreateExpose, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, OpenFilterVariableCreateRequest, OpenGlobalVariableCreateRequest, OpenStandardVariableCreateRequest, PipelineTree, PluginDetailCommon, PluginInputDataItem, RetrievalFilterField, SelectPanelConfig, SelectRelatedOptionConfig, SelectRelatedOptionItem, SelectRelatedOptionSource, SelectRelatedOptionSourceRef, SelectRelatedSourceContext, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };