@blueking/bkflow-canvas-editor 1.1.0-beta.1 → 1.1.0-beta.11

package/dist/index.d.ts

@@ -2,13 +2,80 @@ import * as vue from 'vue';
 import { ComputedRef, Ref } from 'vue';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 import * as _blueking_flow_canvas from '@blueking/flow-canvas';
-import { CanvasUiEvent, QuickAddConfig, FlowModel, FlowNodeModel, NodeActionsConfig, ConnectionValidator, CanvasPlugin, CommandEnvelope, CanvasSchema } 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';
 
-type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED';
+/**
+ * Flow API 配置接口
+ */
+interface FlowApiConfig {
+    /** API 基础路径 */
+    baseURL?: string;
+    /** 自定义 axios 实例（可选，如果提供则优先使用） */
+    axiosInstance?: AxiosInstance;
+    /** axios 配置（可选，用于创建新的 axios 实例） */
+    axiosConfig?: AxiosRequestConfig;
+    /** CSRF cookie 名称（可选，用于创建新的 axios 实例时设置 xsrfCookieName） */
+    xsrfCookieName?: string;
+    /** 作用域数据（必需，由外部传入） */
+    scopeData: ScopeData;
+    /**
+     * 用户查询 API 地址（可选）
+     * @deprecated 请改用 FlowEdit/FlowView 顶层组件的 `memberSelectorConfig.fetchUserApi`。
+     * 该字段仅保留向后兼容，未来版本会移除。
+     */
+    fetchUserApi?: string;
+    /** 是否启用第三方插件（可选，默认为 true） */
+    enableThirdPlugin?: boolean;
+}
+interface ScopeData {
+    scope_type: string;
+    scope_value: number;
+    /** 业务方传入的空间 ID，语义独立于 scope_value。 */
+    space_id: number;
+}
+
+type __VLS_Slots$7 = {
+    header?: () => any;
+    extend?: () => any;
+};
+type __VLS_Props$7 = {
+    flowId: string;
+    taskId: string | number;
+    apiConfig: FlowApiConfig;
+    bkflowSaasUrl?: string;
+    defaultZoom?: number;
+    onBack?: () => void;
+};
+declare const __VLS_base$7: vue.DefineComponent<__VLS_Props$7, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+    back: () => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$7> & Readonly<{
+    onBack?: (() => any) | undefined;
+}>, {
+    defaultZoom: number;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+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$7<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+declare namespace __mock_vue {
+  export {
+    _default$8 as default,
+  };
+}
+
+type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'SKIP';
 type ExecutionNodeAction = 'retry' | 'skip' | 'resume' | 'approve' | 'forceFail' | 'gatewaySkip';
 interface NodeExecutionState {
     status: NodeExecutionStatus;
+    version?: string;
+    start_time?: string;
+    finish_time?: string;
+    elapsed_time?: number;
     /** 旧版任务引擎的 task 状态，优先用于识别 REVOKED */
     taskState?: string;
     /** 兼容旧版 snake_case 字段 */
@@ -52,6 +119,8 @@ type PortOrientation = 'Top' | 'Right' | 'Bottom' | 'Left';
 
 type GatewayType = 'ExclusiveGateway' | 'ParallelGateway' | 'ConditionalParallelGateway' | 'ConvergeGateway';
 
+type NodeType = StartEvent | EndEvent | Activity | Gateway;
+
 interface PluginInputDataItem {
   value:
     | string
@@ -507,6 +576,19 @@ interface DndNodeItem {
     disabledTip?: string;
     tipsImage?: string;
 }
+interface UniformApiPluginOutputItem {
+    key: string;
+    name?: string;
+    type?: string;
+    description?: string;
+    schema?: Record<string, any>;
+    form_type?: string;
+    options?: Array<{
+        label?: string;
+        value?: unknown;
+        text?: string;
+    }>;
+}
 interface UniformApiPluginDetail {
     alias: string;
     bk_tenant_id: string;
@@ -521,7 +603,7 @@ interface UniformApiPluginDetail {
     url: string;
     methods: string[];
     inputs: Record<string, any>;
-    outputs: string[];
+    outputs?: Array<UniformApiPluginOutputItem | string>;
     scope_id: string;
     sign: string;
     updated_at: string;
@@ -616,33 +698,178 @@ interface CustomVariableType {
     code: string;
 }
 
-interface FlowEditExpose {
+/** 画布视口相关方法，供 FlowView / FlowEdit 对外透传 */
+interface CanvasViewportExpose {
+    zoomToFit: (options?: ZoomToFitOptions) => void;
+    centerContent: () => void;
+    getZoom: () => number;
+}
+interface FlowEditExpose extends CanvasViewportExpose {
+    isFlowEdited: boolean;
+    updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
+    openGlobalVariables: () => void;
+}
+interface FlowViewExpose extends CanvasViewportExpose {
+}
+/** FlowDetail 统一详情页对外暴露（设计 §7.1） */
+interface FlowDetailExpose extends CanvasViewportExpose {
     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' | '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;
+}
+interface DebugContextNode {
+    node_id: string;
+    node_type: string;
+    execution_mode: DebugExecutionMode;
+    status: DebugNodeStatus;
+    can_step: boolean;
+    missing_vars: DebugMissingVar[];
+    waiting_reason?: string | null;
+    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 API 配置接口
+ * /debug_context/ 顶层结构。
+ *
+ * 前端按 status 分支：
+ * - running：任务定位用 active_*，进度用 last_run_status
+ * - terminating：继续用 active_*，UI 展示「终止中」并轮询
+ * - idle：active_* 为空，结果摘要用 last_*；last_task_id=null 表示尚无调试记录
  */
-interface FlowApiConfig {
-    /** API 基础路径 */
-    baseURL?: string;
-    /** 自定义 axios 实例（可选，如果提供则优先使用） */
-    axiosInstance?: AxiosInstance;
-    /** axios 配置（可选，用于创建新的 axios 实例） */
-    axiosConfig?: AxiosRequestConfig;
-    /** CSRF cookie 名称（可选，用于创建新的 axios 实例时设置 xsrfCookieName） */
-    xsrfCookieName?: string;
-    /** 作用域数据（必需，由外部传入） */
-    scopeData: {
-        scope_type: string;
-        scope_value: number;
-    };
-    /** 用户查询 API 地址（可选） */
-    fetchUserApi?: string;
-    /** 是否启用第三方插件（可选，默认为 true） */
-    enableThirdPlugin?: boolean;
+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'];
+    [key: string]: unknown;
+}
+interface RunGlobalDebugResult {
+    task_id: number | string;
+    status: DebugContextStatus;
+    [key: string]: unknown;
+}
+interface TerminateDebugResult {
+    status?: DebugContextStatus;
+    [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 {
@@ -653,16 +880,115 @@ interface DrawPipelineParams {
     gateway_size?: [number, number];
     start?: [number, number];
 }
+interface CreateMockDebugTaskParams {
+    template_id: number;
+    name: string;
+    pipeline_tree: PipelineTree;
+    mock_data: {
+        nodes: string[];
+        outputs: Record<string, Record<string, unknown>>;
+        mock_data_ids?: Record<string, number | string>;
+    };
+    creator?: string;
+}
+interface StopMockDebugTaskParams {
+    task_id: number | string;
+}
+interface FetchTaskStateParams {
+    task_id: number | string;
+}
+interface FetchTaskNodeDetailParams {
+    task_id: number | string;
+    node_id: string;
+}
+interface FetchTaskNodeSnapshotParams {
+    task_id: number | string;
+    node_id: string;
+}
+interface FetchTaskNodeLogParams {
+    task_id: number | string;
+    node_id: string;
+    version: string;
+}
+interface OperateTaskNodeParams {
+    task_id: number | string;
+    node_id: string;
+    action: ExecutionNodeAction;
+    data?: Record<string, unknown>;
+    /** 自定义 operation，优先级高于 action 默认映射 */
+    operation?: string;
+}
+interface GetFlowTaskDetailParams {
+    task_id: number | string;
+}
+interface FlowTaskDetail {
+    id: number | string;
+    template_id: number;
+    pipeline_tree: PipelineTree;
+    [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;
+    node_states?: TaskExecutionStates;
+    states?: Record<string, unknown>;
+    children?: Record<string, unknown> | unknown[];
+    nodes?: Record<string, unknown> | unknown[];
+    activities?: Record<string, unknown>;
+    gateways?: Record<string, unknown>;
+    [key: string]: unknown;
+}
 
 interface FlowViewApiConfig {
     fetchFlowDetail: (id: string) => Promise<FlowTemplate>;
     fetchSpaceFlowConfig: (id: string) => Promise<SpaceFlowConfig>;
     fetchSystemVariables: (id: string) => Promise<Variable[]>;
+    /**
+     * 用户查询 API 地址
+     * @deprecated 请改用 memberSelectorConfig.fetchUserApi（顶层组件 prop）
+     */
     fetchUserApi?: string;
     /** 作用域数据（必需，由外部传入） */
     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>;
@@ -682,24 +1008,32 @@ 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;
-        action: string;
+        task_id: number | string;
+        resource_type: string;
+        resource_id: number | string;
+        permission_type: string;
+    }) => Promise<ExecuteFlowTaskResult>;
+    revokeFlowTask?: (params: {
+        task_id: number | string;
         resource_type: string;
-        resource_id: number;
+        resource_id: number | string;
         permission_type: string;
     }) => Promise<any>;
+    createMockDebugTask?: (params: CreateMockDebugTaskParams) => Promise<{
+        data: {
+            id: number | string;
+            template_id: number;
+        };
+    }>;
+    stopMockDebugTask?: (params: StopMockDebugTaskParams) => Promise<void>;
+    fetchTaskState?: (params: FetchTaskStateParams) => Promise<TaskStateResult>;
+    fetchTaskNodeDetail?: (params: FetchTaskNodeDetailParams) => Promise<unknown>;
+    fetchTaskNodeSnapshot?: (params: FetchTaskNodeSnapshotParams) => Promise<unknown>;
+    fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
+    operateTaskNode?: (params: OperateTaskNodeParams) => Promise<unknown>;
+    getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
     fetchControlConfig?: () => Promise<Record<string, any>>;
     checkSpaceConfig?: (scopeValue: number, params: {
         name: string;
@@ -727,7 +1061,7 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchBkFlowThirdPartyPluginTags: () => Promise<BkflowThirdPartyPluginGroupItem[]>;
     fetchBkFlowThirdPartyPluginMeta: (plugin_code: string) => Promise<BkflowThirdPartyPluginMetaDetail>;
     fetchBkFlowThirdPartyPluginDetail: (plugin_code: string, plugin_version: string) => Promise<BkflowThirdPartyPluginDetail>;
-    fetchBkFlowThirdPartyPluginAppDetail: (plugin_code: string) => Promise<BkflowThirdPartyPluginAppDetail>;
+    fetchBkFlowThirdPartyPluginAppDetail: (plugin_code: string, plugin_version: string) => Promise<BkflowThirdPartyPluginAppDetail>;
     fetchPluginGroupList: () => Promise<PluginGroupConfig[]>;
     fetchCategoryPlugins: (category: string) => Promise<PluginMetaItem[]>;
     fetchAllPluginGroups: () => Promise<GroupsPluginItem[]>;
@@ -737,27 +1071,127 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     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;
-        action: string;
+        task_id: number | string;
         resource_type: string;
-        resource_id: number;
+        resource_id: number | string;
+        permission_type: string;
+    }) => Promise<ExecuteFlowTaskResult>;
+    revokeFlowTask?: (params: {
+        task_id: number | string;
+        resource_type: string;
+        resource_id: number | string;
         permission_type: string;
     }) => Promise<any>;
+    createMockDebugTask?: (params: CreateMockDebugTaskParams) => Promise<{
+        data: {
+            id: number | string;
+            template_id: number;
+        };
+    }>;
+    stopMockDebugTask?: (params: StopMockDebugTaskParams) => Promise<void>;
+    fetchTaskState?: (params: FetchTaskStateParams) => Promise<TaskStateResult>;
+    fetchTaskNodeDetail?: (params: FetchTaskNodeDetailParams) => Promise<unknown>;
+    fetchTaskNodeSnapshot?: (params: FetchTaskNodeSnapshotParams) => Promise<unknown>;
+    fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
+    getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
+}
+interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices> {
 }
 
-type __VLS_Props$5 = {
+/**
+ * 插件分组选择面板配置
+ */
+interface SelectPanelConfig {
+    agentApplyUrl?: string;
+    agentResourceUrl?: string;
+    agentButtonText?: string;
+    knowledgebaseResourceUrl?: string;
+}
+/**
+ * 人员选择器配置
+ * 采用判别联合（discriminated union）：
+ *  - mode 缺省或为 'legacy'：使用组件内置的 UserSelector，依赖 fetchUserApi
+ *  - mode 为 'tenant'：使用多租户人员选择器 @blueking/bk-user-selector，
+ *    tenantId 与 apiBaseUrl 在类型上即为必填
+ *    接入方需自行安装 npm 包 @blueking/bk-user-selector
+ */
+type MemberSelectorConfig = {
+    mode?: 'legacy';
+    /** 用户查询 API 地址 */
+    fetchUserApi?: string;
+} | {
+    mode: 'tenant';
+    /** 租户 ID */
+    tenantId: string;
+    /** bk-user 服务的 API 基础地址 */
+    apiBaseUrl: string;
+    /** 当前登录用户 ID，开启后可在下拉中快捷选择"我" */
+    currentUserId?: string;
+    /** 是否启用跨租户搜索，默认 false */
+    enableMultiTenantMode?: boolean;
+    /** 是否展示头像，默认 false */
+    hasAvatar?: boolean;
+    /** 头像 CDN 基础地址 */
+    avatarBaseUrl?: string;
+    /** 最近选择的用户 ID 列表 */
+    recentUserIds?: string[];
+};
+/**
+ * 在顶层组件中提供 FlowApiConfig
+ * @param config FlowApiConfig 配置对象或已处理的 API 配置对象
+ * @returns 返回处理后的 API 配置对象
+ */
+declare function provideFlowApiConfig(config: FlowApiConfig | FlowDetailApiConfig | FlowEditApiConfig | FlowViewApiConfig): FlowDetailApiConfig | FlowEditApiConfig | FlowViewApiConfig;
+/**
+ * 在子组件中注入 FlowApiConfig（通用版本）
+ * @returns FlowEditApiConfig
+ * @throws 如果 apiConfig 未提供则抛出错误
+ */
+declare function useFlowApiConfig(): FlowDetailApiConfig;
+/**
+ * 在子组件中注入 FlowEditApiConfig（类型化版本）
+ * @returns FlowEditApiConfig
+ */
+declare function useFlowEditApiConfig(): FlowEditApiConfig;
+/**
+ * 在子组件中注入 FlowViewApiConfig（类型化版本）
+ * 注意：实际上返回的是 FlowEditApiConfig，但类型上兼容 FlowViewApiConfig
+ * @returns FlowViewApiConfig
+ */
+declare function useFlowViewApiConfig(): FlowViewApiConfig;
+/**
+ * 在顶层组件中提供 SelectPanelConfig
+ * @param config SelectPanelConfig 配置对象
+ */
+declare function provideSelectPanelConfig(config: SelectPanelConfig): void;
+/**
+ * 在子组件中注入 SelectPanelConfig
+ * @returns SelectPanelConfig 或 null（如果未提供配置）
+ */
+declare function useSelectPanelConfig(): SelectPanelConfig | null;
+/**
+ * 在顶层组件中提供 MemberSelectorConfig
+ *
+ * 注意：当 `config` 为 undefined 时，**不会调用 provide**，从而不会遮蔽
+ * 父级（如外层 FlowView/FlowEdit）已经 provide 的配置。
+ * 例如 `FlowView` 内部渲染 `FlowCreateTask` 时，如果调用方仅在 `FlowView`
+ * 上传入 `memberSelectorConfig`，则 `FlowCreateTask` 不会因为自己未收到 prop
+ * 而把 tenant 配置覆盖回 legacy。
+ *
+ * 若调用方主动传入 `{ mode: 'legacy' }`，则视为显式覆盖，按正常 provide。
+ *
+ * @param config MemberSelectorConfig 配置对象；为 undefined 时跳过 provide
+ */
+declare function provideMemberSelectorConfig(config?: MemberSelectorConfig): void;
+/**
+ * 在子组件中注入 MemberSelectorConfig
+ * @returns MemberSelectorConfig，未提供时返回 { mode: 'legacy' }
+ */
+declare function useMemberSelectorConfig(): MemberSelectorConfig;
+
+type __VLS_Props$6 = {
     flowId: string;
     show: boolean;
     editable?: boolean;
@@ -768,10 +1202,12 @@ type __VLS_Props$5 = {
         variablesValue: Record<string, any>;
     }) => Promise<void> | void;
     useCustomConfirm?: boolean;
-    onExecuteSuccess?: (taskId: number, templateId: number) => void;
+    mockData?: CreateMockDebugTaskParams['mock_data'];
+    onExecuteSuccess?: (taskId: number | string, templateId: number) => void;
     bkflowSaasUrl?: string;
     enableVersion?: boolean;
     flowVersion?: string;
+    memberSelectorConfig?: MemberSelectorConfig;
 };
 declare var __VLS_72: {
     formData: {
@@ -779,15 +1215,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;
@@ -795,13 +1231,13 @@ declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$5, {}, {}, {}, {}, v
 }>, {
     editable: boolean;
     showFlowEntry: boolean;
-    enableVersion: boolean;
     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;
     };
@@ -809,15 +1245,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;
@@ -826,15 +1262,15 @@ 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;
     approve: (nodeId: string) => any;
     forceFail: (nodeId: string) => any;
     gatewaySkip: (nodeId: string) => any;
-    back: () => any;
     "ui-event": (event: CanvasUiEvent) => any;
+    back: () => any;
     "node-click": (event: {
         type: "node.click";
         nodeId: string;
@@ -845,15 +1281,15 @@ 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;
     onApprove?: ((nodeId: string) => any) | undefined;
     onForceFail?: ((nodeId: string) => any) | undefined;
     onGatewaySkip?: ((nodeId: string) => any) | undefined;
-    onBack?: (() => any) | undefined;
     "onUi-event"?: ((event: CanvasUiEvent) => any) | undefined;
+    onBack?: (() => any) | undefined;
     "onNode-click"?: ((event: {
         type: "node.click";
         nodeId: string;
@@ -869,10 +1305,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;
     };
@@ -880,26 +1316,35 @@ type __VLS_WithSlots$3<T, S> = T & {
 
 declare namespace __execute_vue {
   export {
-    _default$5 as default,
+    _default$6 as default,
   };
 }
 
-type __VLS_Props$3 = {
+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;
 };
-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;
@@ -909,58 +1354,22 @@ 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,
   };
 }
 
-/**
- * 插件分组选择面板配置
- */
-interface SelectPanelConfig {
-    agentApplyUrl?: string;
-    agentResourceUrl?: string;
-    agentButtonText?: string;
-    knowledgebaseResourceUrl?: string;
-}
-/**
- * 在顶层组件中提供 FlowApiConfig
- * @param config FlowApiConfig 配置对象或已处理的 API 配置对象
- * @returns 返回处理后的 API 配置对象
- */
-declare function provideFlowApiConfig(config: FlowApiConfig | FlowEditApiConfig | FlowViewApiConfig): FlowEditApiConfig | FlowViewApiConfig;
-/**
- * 在子组件中注入 FlowApiConfig（通用版本）
- * @returns FlowEditApiConfig
- * @throws 如果 apiConfig 未提供则抛出错误
- */
-declare function useFlowApiConfig(): FlowEditApiConfig;
-/**
- * 在子组件中注入 FlowEditApiConfig（类型化版本）
- * @returns FlowEditApiConfig
- */
-declare function useFlowEditApiConfig(): FlowEditApiConfig;
-/**
- * 在子组件中注入 FlowViewApiConfig（类型化版本）
- * 注意：实际上返回的是 FlowEditApiConfig，但类型上兼容 FlowViewApiConfig
- * @returns FlowViewApiConfig
- */
-declare function useFlowViewApiConfig(): FlowViewApiConfig;
-/**
- * 在顶层组件中提供 SelectPanelConfig
- * @param config SelectPanelConfig 配置对象
- */
-declare function provideSelectPanelConfig(config: SelectPanelConfig): void;
-/**
- * 在子组件中注入 SelectPanelConfig
- * @returns SelectPanelConfig 或 null（如果未提供配置）
- */
-declare function useSelectPanelConfig(): SelectPanelConfig | null;
-
-type __VLS_Slots$2 = {
+type __VLS_Slots$3 = {
     header?: () => any;
     inputParams?: (props: {
         node: any;
@@ -984,7 +1393,7 @@ type __VLS_Slots$2 = {
         variablesValue: Record<string, any>;
     }) => any;
 };
-type __VLS_Props$2 = {
+type __VLS_Props$3 = {
     flowId: string;
     apiConfig: FlowApiConfig;
     permissions?: {
@@ -997,49 +1406,76 @@ type __VLS_Props$2 = {
     }) => Promise<void> | void;
     useCustomDebugConfirm?: boolean;
     selectPanelConfig?: SelectPanelConfig;
+    memberSelectorConfig?: MemberSelectorConfig;
     onSave?: (flowData: FlowTemplate) => void;
     onSaveSuccess?: () => void;
     onBack?: () => void;
     onExitEdit?: () => void;
     onBeforeLeave?: (isEdited: boolean) => Promise<boolean>;
+    onMockDebugCreated?: (params: {
+        taskId: number | string;
+        templateId: number | string;
+    }) => void;
     enableVersion?: boolean;
     flowVersion?: string;
     defaultZoom?: number;
     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"];
+    zoomToFit: FlowEditExpose["zoomToFit"];
+    centerContent: FlowEditExpose["centerContent"];
+    getZoom: FlowEditExpose["getZoom"];
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     back: () => any;
     save: (flowData: FlowTemplate) => any;
+    mockDebugCreated: (params: {
+        taskId: number | string;
+        templateId: number | string;
+    }) => any;
     saveSuccess: () => any;
     exitEdit: () => any;
     debugBeforeClose: () => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
+    createVariable: (payload: {
+        keyword: string;
+        cursorIndex: number;
+    }) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$3> & Readonly<{
     onBack?: (() => any) | undefined;
     onSave?: ((flowData: FlowTemplate) => any) | undefined;
+    onMockDebugCreated?: ((params: {
+        taskId: number | string;
+        templateId: number | string;
+    }) => any) | undefined;
     onSaveSuccess?: (() => any) | undefined;
     onExitEdit?: (() => any) | undefined;
     onDebugBeforeClose?: (() => any) | undefined;
+    onCreateVariable?: ((payload: {
+        keyword: string;
+        cursorIndex: number;
+    }) => any) | undefined;
 }>, {
     quickAdd: QuickAddConfig;
+    enableThirdPlugin: boolean;
+    hideTrigger: boolean;
     defaultZoom: number;
+    enableDebug: boolean;
+    enableVersion: boolean;
     permissions: {
         canSave?: boolean;
     };
-    enableVersion: 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;
     };
@@ -1047,11 +1483,11 @@ 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;
@@ -1064,12 +1500,25 @@ 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;
+        };
+        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;
@@ -1079,27 +1528,50 @@ 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, {
-    back: () => any;
+declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {
+    zoomToFit: (options?: ZoomToFitOptions) => void;
+    centerContent: () => void;
+    getZoom: () => number;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     edit: () => any;
-}, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
-    onBack?: (() => any) | undefined;
+    back: () => any;
+    mockDebugCreated: (params: {
+        taskId: number | string;
+        templateId: number | string;
+    }) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
     onEdit?: (() => any) | undefined;
+    onBack?: (() => any) | undefined;
+    onMockDebugCreated?: ((params: {
+        taskId: number | string;
+        templateId: number | string;
+    }) => any) | undefined;
 }>, {
     thumbnail: boolean;
+    hideTrigger: boolean;
     defaultZoom: number;
+    enableDebug: boolean;
+    enableVersion: boolean;
     permissions: {
         canEdit?: boolean;
+        canExecute?: boolean;
     };
-    enableVersion: boolean;
     showHeaderActions: 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;
     };
@@ -1107,10 +1579,148 @@ 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;
+    inputParams?: (props: {
+        node: any;
+        pluginDetail: PluginDetailCommon | null;
+        inputs: any[];
+        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;
+    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"];
+    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: {
+        keyword: string;
+        cursorIndex: number;
+    }) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
+    onBack?: (() => any) | undefined;
+    onSave?: ((flowData: FlowTemplate) => any) | undefined;
+    onSaveSuccess?: (() => any) | undefined;
+    onCreateVariable?: ((payload: {
+        keyword: string;
+        cursorIndex: number;
+    }) => 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 {
+    form_type?: string;
+    options?: Array<{
+        label: string;
+        value: unknown;
+        text?: string;
+    }>;
+    schema?: Record<string, unknown>;
+    default?: unknown;
+}
+interface NodeMockConfig {
+    nodeId: string;
+    outputs: Record<string, unknown>;
+    fieldSnapshots: Record<string, MockOutputField>;
+}
+interface SimulateDebugState {
+    stage: SimulateDebugStage;
+    selectedNodeIds: Set<string>;
+    mockConfigs: Record<string, NodeMockConfig>;
+    activeConfigNodeId?: string;
+    activeRunningNodeId?: string;
+    taskId?: number | string;
+    taskStatus?: 'RUNNING' | 'FINISHED' | 'FAILED';
+    taskStartedAt?: number;
+    nodeStates?: TaskExecutionStates;
+    resultDrawerOpen: boolean;
+}
+interface SimulateDebugCanvasContext {
+    stage: Ref<SimulateDebugStage>;
+    isMockSelected: (nodeId: string) => boolean;
+    toggleMockSelected: (nodeId: string) => void;
+    hasMockConfig: (nodeId: string) => boolean;
+    isAllMockNodesSelected?: () => boolean;
+}
+
+interface OutputNormalizeOptions {
+    includeSystem?: boolean;
+}
+declare function mergeOutputs(...groups: Array<Array<PluginOutputItem | MockOutputField>>): MockOutputField[];
+declare function normalizePluginOutputItems(outputs: unknown, options?: OutputNormalizeOptions): MockOutputField[];
+declare function resolveMockFormControl(field: MockOutputField): MockFormControl;
+
+declare function isMockableNode(node: NodeType | Activity | undefined | null): node is Activity;
+
 declare const random4: () => string;
 declare const generateId: (group?: number) => string;
 
@@ -1127,6 +1737,12 @@ declare const getVariableDefaultConfig: () => Variable;
 
 declare const getUniformApiPluginFormValue: (config: UniformApiPluginInputsItem$1) => PluginInputDataItem["value"];
 
+type BkflowBusinessCanvasMode = 'edit' | 'view' | 'mock-config' | 'execute';
+interface BkflowSchemaOptions {
+    getBusinessMode?: () => BkflowBusinessCanvasMode;
+}
+declare function createBkflowSchema(options?: BkflowSchemaOptions): CanvasSchema;
+
 declare class BkFlowNodeAccessor {
     private node;
     constructor(node: FlowNodeModel);
@@ -1168,15 +1784,35 @@ 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;
+}
+
 type __VLS_Props = {
     pipelineTree: PipelineTree;
-    mode?: 'edit' | 'view';
+    mode?: BkflowBusinessCanvasMode;
     thumbnail?: boolean;
     defaultZoom?: number;
     nodeActions?: NodeActionsConfig;
     quickAdd?: QuickAddConfig;
     connectionValidator?: ConnectionValidator;
     additionalPlugins?: CanvasPlugin[];
+    toolbarItems?: CanvasToolbarItem[];
+    simulateDebugContext?: SimulateDebugCanvasContext;
+    debugContext?: DebugCanvasContext;
 };
 declare var __VLS_8: {};
 declare var __VLS_22: {
@@ -1271,8 +1907,8 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
     }) => any) | undefined;
     "onFormat-position"?: (() => any) | undefined;
 }>, {
-    mode: "edit" | "view";
     thumbnail: boolean;
+    mode: BkflowBusinessCanvasMode;
     nodeActions: NodeActionsConfig;
     quickAdd: QuickAddConfig;
     defaultZoom: number;
@@ -1303,8 +1939,6 @@ declare function importFromPipelineTree(tree: PipelineTree): FlowModel;
 
 declare function exportToPipelineTree(flowModel: FlowModel): PipelineTree;
 
-declare function createBkflowSchema(): CanvasSchema;
-
 /**
  * 创建 bkflow 业务插件实例。
  * 每次调用返回独立实例，避免多个画布共享模块级可变状态。
@@ -1317,7 +1951,8 @@ declare function createBkflowSchema(): CanvasSchema;
  *    若目标是 placeholder 且删后无入边，级联删除该 placeholder
  *  - edge.reconnect：若源从条件网关迁出，清理旧条件
  *  - node.remove：主动查找将被级联删除的边，清理对应网关条件；
- *    若删除的是分支网关，级联删除关联的 placeholder 节点
+ *    若删除的是分支网关，级联删除关联的 placeholder 节点；
+ *    同时清理全局变量中对被删除节点的 source_info 引用，并删除已无引用的变量
  */
 declare function createBkflowPlugin(): CanvasPlugin;
 
@@ -1346,7 +1981,12 @@ declare const _default: {
     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$2 as FlowView, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, provideFlowApiConfig, provideSelectPanelConfig, random4, resolveExecutionActions, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useSelectPanelConfig, validatePipelineTree };
-export type { Activity, DndNodeItem, ExecutionNodeAction, FlowApiConfig, FlowEditExpose, FlowTemplate, Gateway, GatewayCondition, NodeExecutionState, NodeExecutionStatus, NotifyConfig, PipelineTree, PluginDetailCommon, PluginInputDataItem, SelectPanelConfig, 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, 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, CanvasViewportExpose, CreateFlowTaskResult, DndNodeItem, ExecuteFlowTaskResult, ExecutionNodeAction, FlowApiConfig, FlowDetailExpose, FlowDetailPermissions, FlowEditExpose, FlowTaskExecuteSuccessResult, FlowTemplate, FlowViewExpose, Gateway, GatewayCondition, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, PipelineTree, PluginDetailCommon, PluginInputDataItem, SelectPanelConfig, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };