@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillFilterOptions.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview FDE Skill 筛选器选项加载 - 经 handleSvcForAi 拉取下拉/人员/部门候选项
+ * @author seadon
+ * @created 2026-07-12
+ */
+import type { FdeSkillFilterControlType, FdeSkillFilterOptionItem, FdeSkillFilterOptionsSource, FdeSkillCardIntent, FdeSkillPageFilterBar, FdeSkillQueryCardIntent, FdeSkillQueryControlSpec } from './fdeSkillCardTypes';
+/** 系统应用：人员/部门筛选固定 app。 */
+export declare const FDE_SKILL_SYSTEM_ORG_APP_ID = "btdev_system_app";
+/** 部门筛选固定服务与字段映射。 */
+export declare const FDE_SKILL_SYSTEM_DEPT_FILTER: {
+    readonly app_id: "btdev_system_app";
+    readonly svc_code: "search_dept_c6cmkshz";
+    readonly value_field: "dept_id";
+    readonly label_field: "dept_name";
+};
+/** 人员筛选固定服务与字段映射。 */
+export declare const FDE_SKILL_SYSTEM_PERSON_FILTER: {
+    readonly app_id: "btdev_system_app";
+    readonly svc_code: "search_internal_emp_sql_svc3bwrm";
+    readonly value_field: "employee_id";
+    readonly label_field: "employee_name";
+};
+export interface FdeSkillFilterOptionsServiceConfig {
+    app_id: string;
+    svc_code: string;
+    value_field: string;
+    label_field: string;
+    query_criteria?: Array<{
+        column_name: string;
+        query_type: number;
+        value: unknown[];
+    }>;
+    page_size?: number;
+}
+/**
+ * 判断控件是否需要走服务拉选项。
+ * @param options - 选项来源协议。
+ * @returns 是否为服务类选项源。
+ */
+export declare function isFdeSkillServiceOptionsSource(options: FdeSkillFilterOptionsSource | null | undefined): options is FdeSkillFilterOptionsSource & {
+    service: NonNullable<FdeSkillFilterOptionsSource['service']>;
+};
+/**
+ * 人员/部门是否走可搜索远程下拉（关键字 + 防抖）。
+ * @param type - 控件类型。
+ * @returns 是否远程检索。
+ */
+export declare function isFdeSkillRemoteSearchFilterType(type: FdeSkillFilterControlType | string | undefined): type is 'person' | 'department';
+/**
+ * 构造人员/部门系统组织服务拉选项配置（固定 app/svc/字段；关键字决定 page_size 与 criteria）。
+ * @param kind - person | department。
+ * @param keyword - 可选检索关键字；空则 page_size=500 且无 keyword 条件。
+ * @returns 服务选项配置。
+ */
+export declare function buildFdeSkillSystemOrgOptionsConfig(kind: 'person' | 'department', keyword?: string): FdeSkillFilterOptionsServiceConfig;
+/**
+ * 构造拉选项 HandleDataDto 请求体。
+ * @param config - 服务选项配置。
+ * @returns handleSvcForAi body。
+ */
+export declare function buildFdeSkillFilterOptionsRequestBody(config: FdeSkillFilterOptionsServiceConfig): Record<string, unknown>;
+/**
+ * 将服务行映射为下拉选项；缺字段的行跳过。
+ * @param rows - 服务 value 行。
+ * @param valueField - 存储值字段。
+ * @param labelField - 显示值字段。
+ * @returns 选项列表。
+ */
+export declare function mapFdeSkillFilterOptionRows(rows: Array<Record<string, unknown>>, valueField: string, labelField: string): FdeSkillFilterOptionItem[];
+/**
+ * 调用 handleSvcForAi 拉取筛选器候选项。
+ * @param config - 服务选项配置。
+ * @param signal - 中止信号。
+ * @returns 选项列表。
+ */
+export declare function loadFdeSkillFilterOptionsFromService(config: FdeSkillFilterOptionsServiceConfig, signal?: AbortSignal): Promise<FdeSkillFilterOptionItem[]>;
+/**
+ * 从控件协议解析手工选项。
+ * @param control - 控件协议。
+ * @returns 手工选项。
+ */
+export declare function resolveFdeSkillManualFilterOptions(control: FdeSkillQueryControlSpec): FdeSkillFilterOptionItem[];
+/**
+ * 将页面级 filter_bar 归一为 FilterBar 可用的查询卡协议。
+ * @param filterBar - 页面筛选条。
+ * @returns 查询卡意图数组。
+ */
+export declare function convertFdeSkillFilterBarToQueryCards(filterBar: FdeSkillPageFilterBar): FdeSkillQueryCardIntent[];
+/**
+ * Host 归一筛选源：优先 cards 内 query 卡；否则用 filter_bar。
+ * @param cards - 页面卡片。
+ * @param filterBar - 可选页面筛选条。
+ * @returns 供 FilterBar 渲染的查询卡。
+ */
+export declare function resolveFdeSkillHostQueryCards(cards: ReadonlyArray<FdeSkillCardIntent>, filterBar?: FdeSkillPageFilterBar | null): FdeSkillQueryCardIntent[];

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillFloatingAction.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview FDE Skill 浮层操作工具 - 判断图表浮层操作条是否应被外部点击关闭
+ * @author seadon
+ * @created 2026-07-07
+ */
+/**
+ * 判断事件目标是否位于指定元素内部。
+ * @param target - 指针事件目标。
+ * @param element - 待判断的元素。
+ * @returns 是否位于元素内部。
+ */
+export declare function isFdeSkillEventTargetInsideElement(target: EventTarget | null, element: HTMLElement | null): boolean;
+/**
+ * 判断图表浮层操作条是否应被当前指针事件关闭。
+ * @param target - 指针事件目标。
+ * @param actionElement - 浮层操作条元素。
+ * @returns 是否应关闭浮层。
+ */
+export declare function shouldCloseFdeSkillFloatingAction(target: EventTarget | null, actionElement: HTMLElement | null): boolean;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillJson.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview FDE Skill JSON 工具 - 深拷贝 generated 卡片协议
+ * @author seadon
+ * @created 2026-07-06
+ */
+/**
+ * 深拷贝可 JSON 序列化的协议对象。
+ * @param value - 待拷贝对象。
+ * @returns 拷贝后的对象。
+ */
+export declare function cloneJson<T>(value: T): T;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillListMarquee.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview FDE Skill 动态清单常量与裁剪 - 约束滚动清单的行/列上限（全画布共用）
+ * @author seadon
+ * @created 2026-07-09
+ */
+import type { FdeSkillListColumn, FdeSkillListMarqueeSpec, FdeSkillListSpec } from './fdeSkillCardTypes';
+/** 动态清单默认单次拉取行数 */
+export declare const FDE_SKILL_LIST_MARQUEE_DEFAULT_ROWS = 20;
+/** 动态清单单次拉取硬上限 */
+export declare const FDE_SKILL_LIST_MARQUEE_MAX_ROWS = 50;
+/** 动态清单默认展示列数建议 */
+export declare const FDE_SKILL_LIST_MARQUEE_DEFAULT_COLUMNS = 4;
+/** 动态清单展示列硬上限 */
+export declare const FDE_SKILL_LIST_MARQUEE_MAX_COLUMNS = 6;
+/** 默认滚动速度（像素/秒） */
+export declare const FDE_SKILL_LIST_MARQUEE_DEFAULT_SPEED = 42;
+/**
+ * 归一化动态清单 marquee 配置，补齐默认值并钳制上下限。
+ * @param marquee - 原始 marquee 配置。
+ * @returns 归一化后的配置；未启用时返回 null。
+ */
+export declare function resolveFdeSkillListMarqueeSpec(marquee: FdeSkillListMarqueeSpec | undefined): Required<FdeSkillListMarqueeSpec> | null;
+/**
+ * 按动态清单上限裁剪列与行，供渲染与生成共用。
+ * @param list - 清单协议。
+ * @returns 裁剪后的列、行与归一化 marquee。
+ */
+export declare function clipFdeSkillListForMarquee(list: FdeSkillListSpec): {
+    columns: FdeSkillListColumn[];
+    rows: FdeSkillListSpec['rows'];
+    marquee: Required<FdeSkillListMarqueeSpec>;
+} | null;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillMetricChartDrilldown.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview FDE Skill 指标图表下钻 - 基于 chart/data metric_context 构造维度切换与逐层下钻请求。
+ * @author seadon
+ * @created 2026-07-30
+ */
+import type { FdeSkillChartCardIntent, FdeSkillMetricContext, FdeSkillMetricDimensionMeta, FdeSkillMetricStorageValue, FdeSkillProtocolChartDataRequest } from './fdeSkillCardTypes';
+export interface FdeMetricChartPathItem {
+    dimension_code: string;
+    dimension_name: string;
+    display_value: string;
+    storage_value: FdeSkillMetricStorageValue;
+}
+export interface FdeMetricChartInteractionView {
+    card_id: string;
+    source_id: string;
+    current_dimension_code: string;
+    current_dimension_name: string;
+    supported_dimensions: FdeSkillMetricDimensionMeta[];
+    remaining_drill_dimensions: FdeSkillMetricDimensionMeta[];
+    path_items: FdeMetricChartPathItem[];
+    semantic_contract_hash?: string;
+    query_context_signature?: string;
+}
+export interface FdeMetricChartCardState {
+    defaultDimensionCode: string;
+    selectedRootDimensionCode: string;
+    pathItems: FdeMetricChartPathItem[];
+}
+/**
+ * 从 protocol_data.extension.metric_context 读取指标上下文。
+ * @param protocolData - chart/data 返回的协议数据。
+ * @returns 指标上下文或 null。
+ */
+export declare function resolveFdeMetricContextFromProtocolData(protocolData: unknown): FdeSkillMetricContext | null;
+/**
+ * 读取协议图表响应中的 metric_context。
+ * @param card - 指标图卡。
+ * @returns 指标上下文或 null。
+ */
+export declare function resolveFdeMetricContext(card: FdeSkillChartCardIntent): FdeSkillMetricContext | null;
+/**
+ * 读取指标数值卡响应中的 metric_context。
+ * @param card - 指标数值卡。
+ * @returns 指标上下文或 null。
+ */
+export declare function resolveFdeNumberMetricContext(card: {
+    data_source: {
+        type: string;
+    };
+    number: {
+        protocol_data?: Record<string, unknown>;
+    };
+}): FdeSkillMetricContext | null;
+/**
+ * 构造指标图表交互视图。
+ * @param card - 指标图卡。
+ * @param pathItems - 前端保存的下钻展示路径。
+ * @returns 可渲染的指标交互视图；非指标图返回 null。
+ */
+export declare function resolveFdeMetricChartInteractionView(card: FdeSkillChartCardIntent, pathItems?: FdeMetricChartPathItem[]): FdeMetricChartInteractionView | null;
+/**
+ * 构造维度切换请求。
+ * @param card - 指标图卡。
+ * @param dimensionCode - 目标根维度。
+ * @returns 下一次 chart/data 请求。
+ */
+export declare function buildFdeMetricDimensionSwitchRequest(card: FdeSkillChartCardIntent, dimensionCode: string): FdeSkillProtocolChartDataRequest;
+/**
+ * 构造指标下钻请求。
+ * @param card - 指标图卡。
+ * @param input - 点击行索引和下一层维度。
+ * @returns 下一次请求与前端路径项。
+ */
+export declare function buildFdeMetricDrilldownRequest(card: FdeSkillChartCardIntent, input: {
+    dataIndex: number;
+    nextDimensionCode: string;
+}): {
+    request: FdeSkillProtocolChartDataRequest;
+    pathItem: FdeMetricChartPathItem;
+};
+/**
+ * 构造路径回跳请求。
+ * @param card - 指标图卡。
+ * @param pathItems - 前端保存的展示路径。
+ * @param targetIndex - 目标路径项索引。
+ * @returns 下一次 chart/data 请求。
+ */
+export declare function buildFdeMetricPathJumpRequest(card: FdeSkillChartCardIntent, pathItems: FdeMetricChartPathItem[], targetIndex: number): FdeSkillProtocolChartDataRequest;
+/**
+ * 解析清空下钻时应恢复的根维度。
+ * @param state - 指标图表交互状态。
+ * @returns 根维度编码。
+ */
+export declare function resolveFdeMetricClearDrilldownDimension(state: Pick<FdeMetricChartCardState, 'defaultDimensionCode' | 'selectedRootDimensionCode'>): string;
+/**
+ * 构造清空下钻请求。
+ * @param card - 指标图卡。
+ * @param rootDimensionCode - 进入下钻前的根维度。
+ * @returns 下一次 chart/data 请求。
+ */
+export declare function buildFdeMetricClearDrilldownRequest(card: FdeSkillChartCardIntent, rootDimensionCode: string): FdeSkillProtocolChartDataRequest;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillMetricNumberDetail.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview FDE Skill 指标数值卡查看明细 - 卡级点击解析明细上下文（受 metric_context.detail_* 控制）
+ * @author seadon
+ * @created 2026-08-03
+ */
+import type { FdeSkillDrilldownContext, FdeSkillMetricContext, FdeSkillNumberCardIntent } from './fdeSkillCardTypes';
+/**
+ * 判断指标上下文是否允许打开明细。
+ * @param metricContext - 指标上下文。
+ * @returns 后端未明确禁用时允许打开明细。
+ */
+export declare function isFdeSkillMetricDetailAvailable(metricContext: FdeSkillMetricContext): boolean;
+/**
+ * 解析指标数值卡「查看明细」上下文。
+ * 空维 KPI 无点击行条件，明细仅带已应用筛选；开关与指标图一致读取 detail_enabled/detail_supported。
+ * @param card - 指标数值卡。
+ * @returns 明细上下文；不可查看时返回 null。
+ */
+export declare function resolveFdeSkillMetricNumberDetailContext(card: FdeSkillNumberCardIntent): FdeSkillDrilldownContext | null;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillNumberFormat.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview FDE Skill 数值卡格式化 - 统一金额前缀和普通单位后置规则
+ * @author seadon
+ * @created 2026-06-27
+ */
+import type { FdeSkillNumberSpec } from './fdeSkillCardTypes';
+export interface FdeSkillFormattedNumberValue {
+    prefix: string;
+    value: string;
+    suffix: string;
+}
+/**
+ * 按数值卡协议输出前缀、主值和后缀。
+ * @param spec - 数值卡协议。
+ * @returns 拆分后的展示文本。
+ */
+export declare function formatFdeSkillNumberValue(spec: FdeSkillNumberSpec): FdeSkillFormattedNumberValue;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillProtocolChart.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview FDE Skill 协议图表工具 - 校验 ECharts protocol 图表协议
+ * @author seadon
+ * @created 2026-07-06
+ */
+import type { FdeSkillChartCardIntent, FdeSkillDataSource, FdeSkillProtocolChartSpec } from './fdeSkillCardTypes';
+export type FdeSkillProtocolChartCardIntent = FdeSkillChartCardIntent<FdeSkillProtocolChartSpec, FdeSkillDataSource>;
+/**
+ * 判断图表协议是否为 ECharts protocol 图表。
+ * @param chart - 图表协议。
+ * @returns 是否为协议图表。
+ */
+export declare function isFdeSkillProtocolChartSpec(chart: FdeSkillChartCardIntent['chart'] | unknown): chart is FdeSkillProtocolChartSpec;
+/**
+ * 判断图表卡是否为协议图表卡。
+ * @param card - 图表卡协议。
+ * @returns 是否为协议图表卡。
+ */
+export declare function isFdeSkillProtocolChartCard(card: FdeSkillChartCardIntent): card is FdeSkillProtocolChartCardIntent;
+/**
+ * 断言图表卡必须使用 ECharts protocol 协议。
+ * @param card - 图表卡协议。
+ * @returns 无返回值。
+ */
+export declare function assertFdeSkillProtocolChartCard(card: FdeSkillChartCardIntent): asserts card is FdeSkillProtocolChartCardIntent;
+/**
+ * 校验协议图表的 chartId 和 protocolType 在配置、数据、请求之间一致。
+ * @param card - 图表卡协议。
+ * @returns 无返回值。
+ */
+export declare function assertFdeSkillProtocolChartConsistency(card: FdeSkillChartCardIntent): void;
+/**
+ * 判断协议图表是否为空数据。
+ * @param card - 图表卡协议。
+ * @returns 是否为空态。
+ */
+export declare function isFdeSkillProtocolChartEmpty(card: FdeSkillChartCardIntent): boolean;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillProtocolChartApi.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview FDE Skill 协议图表接口 - 经平台 getFetch 调用 chart/data 并提取 protocol_data
+ * @author seadon
+ * @created 2026-07-06
+ */
+import type { FdeSkillProtocolChartDataRequest } from './fdeSkillCardTypes';
+export interface FdeSkillChartDataApiResult {
+    protocolData: Record<string, unknown>;
+    diagnostics?: Record<string, unknown>;
+}
+/**
+ * 调用协议图表数据接口（走平台 getFetch，携带 post-auth）。
+ * @param request - 图表数据请求。
+ * @param signal - 请求中止信号。
+ * @returns 协议图表数据和诊断信息。
+ */
+export declare function executeFdeSkillProtocolChartDataRequest(request: FdeSkillProtocolChartDataRequest, signal?: AbortSignal): Promise<FdeSkillChartDataApiResult>;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillProtocolChartDisplayData.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview FDE Skill 协议图表展示数据 - 补齐协议图表渲染所需的展示名称
+ * @author seadon
+ * @created 2026-07-07
+ */
+/**
+ * @param protocolData - 原始协议数据。
+ * @returns 可直接交给 EChartsProtocolRenderer 的协议数据。
+ */
+export declare function normalizeFdeSkillProtocolChartDisplayData(protocolData: Record<string, unknown>): Record<string, unknown>;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillProtocolChartDrilldown.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview FDE Skill 协议图表下钻 - 从 436 协议图表点击构造服务明细请求
+ * @author seadon
+ * @created 2026-07-07
+ */
+import type { FdeSkillChartCardIntent, FdeSkillDrilldownContext, FdeSkillDrilldownResult, FdeSkillExecuteRequest, FdeSkillNumberCardIntent } from './fdeSkillCardTypes';
+import type { FdeSkillQueryCriterion } from './fdeSkillQueryFilters';
+/** 可发起指标/服务查看明细的卡片（图卡或指标数值卡） */
+export type FdeSkillDetailSourceCard = FdeSkillChartCardIntent | FdeSkillNumberCardIntent;
+export interface FdeSkillProtocolChartClickParams {
+    componentType?: string;
+    seriesName?: unknown;
+    name?: unknown;
+    value?: unknown;
+    dataIndex?: number;
+    event?: {
+        clientX?: number;
+        clientY?: number;
+        offsetX?: number;
+        offsetY?: number;
+    };
+}
+export interface FdeSkillProtocolDrilldownRequest extends FdeSkillExecuteRequest {
+    body: {
+        app_id: string;
+        svc_code: string;
+        source_type?: 'METRIC';
+        handle_type?: 'DETAIL_ROWS';
+        save_datas: Record<string, unknown>;
+        save_datas_list: unknown[];
+        query: Record<string, unknown>;
+    };
+}
+/**
+ * 从 ECharts protocol 点击参数解析服务下钻上下文。
+ * @param card - 协议图表卡。
+ * @param params - 图表点击参数。
+ * @returns 下钻上下文，无法下钻时返回 null。
+ */
+export declare function resolveFdeSkillProtocolChartDrilldownContext(card: FdeSkillChartCardIntent, params: FdeSkillProtocolChartClickParams): FdeSkillDrilldownContext | null;
+/**
+ * 构造协议图表/指标数值卡明细请求。
+ * @param card - 协议图表卡或指标数值卡。
+ * @param context - 点击上下文。
+ * @param pageIndex - 页码，从 1 开始。
+ * @param appliedQueryCriteria - 已应用的查询卡条件。
+ * @returns 明细执行请求。
+ */
+export declare function buildFdeSkillProtocolChartDrilldownRequest(card: FdeSkillDetailSourceCard, context: FdeSkillDrilldownContext, pageIndex?: number, appliedQueryCriteria?: FdeSkillQueryCriterion[]): FdeSkillProtocolDrilldownRequest;
+/**
+ * 归一化服务明细响应。
+ * @param payload - 服务响应 JSON。
+ * @param options - 响应归一化选项。
+ * @returns 明细表格数据。
+ */
+export declare function normalizeFdeSkillProtocolDrilldownResponse(payload: unknown, options?: {
+    fieldNameMap?: Record<string, string>;
+}): FdeSkillDrilldownResult;
+/**
+ * 调用协议图表/指标数值卡明细接口。
+ * @param card - 协议图表卡或指标数值卡。
+ * @param context - 点击上下文。
+ * @param pageIndex - 页码。
+ * @param signal - 请求中止信号。
+ * @param appliedQueryCriteria - 已应用的查询卡条件。
+ * @returns 明细数据。
+ */
+export declare function executeFdeSkillProtocolChartDrilldown(card: FdeSkillDetailSourceCard, context: FdeSkillDrilldownContext, pageIndex: number, signal?: AbortSignal, appliedQueryCriteria?: FdeSkillQueryCriterion[]): Promise<FdeSkillDrilldownResult>;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillProtocolChartLinkage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview FDE Skill 协议图表联动 - 从点击事件构造 query_context.linkage
+ * @author seadon
+ * @created 2026-06-27
+ */
+import type { FdeSkillChartCardIntent, FdeSkillProtocolChartLinkageContext } from './fdeSkillCardTypes';
+export interface FdeSkillChartClickParams {
+    name?: unknown;
+    value?: unknown;
+    dataIndex?: number;
+    seriesName?: unknown;
+}
+/**
+ * 从协议图表点击参数解析联动刷新上下文。
+ * @param card - 协议图表卡。
+ * @param params - 图表点击参数。
+ * @returns 联动刷新上下文；无法解析时返回 null。
+ */
+export declare function resolveFdeSkillProtocolChartLinkageContext(card: FdeSkillChartCardIntent, params: FdeSkillChartClickParams): FdeSkillProtocolChartLinkageContext | null;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillProtocolChartRefresh.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview FDE Skill 协议图表刷新 - 新图表卡统一调用后端图表数据接口
+ * @author seadon
+ * @created 2026-07-06
+ */
+import type { FdeSkillChartCardIntent, FdeSkillProtocolChartDataRequest, FdeSkillProtocolChartLinkageContext } from './fdeSkillCardTypes';
+import type { FdeSkillRefreshQueryContext } from './fdeSkillDataRefresh';
+export interface FdeSkillProtocolChartRefreshOptions {
+    linkage?: FdeSkillProtocolChartLinkageContext;
+    metricRequest?: FdeSkillProtocolChartDataRequest;
+}
+/**
+ * 刷新协议图表卡。
+ * @param card - 图表卡协议。
+ * @param signal - 请求中止信号。
+ * @param queryContext - 当前查询卡上下文。
+ * @returns 刷新后的图表卡。
+ */
+export declare function refreshFdeSkillProtocolChartCard(card: FdeSkillChartCardIntent, signal?: AbortSignal, queryContext?: FdeSkillRefreshQueryContext, options?: FdeSkillProtocolChartRefreshOptions): Promise<FdeSkillChartCardIntent>;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillQueryFilters.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview FDE Skill 查询过滤工具 - 将筛选器运行态值注入 query_criteria 或指标维度过滤
+ * @author seadon
+ * @created 2026-06-30
+ */
+import type { FdeSkillDataSource, FdeSkillMetricDimensionMeta, FdeSkillMetricStorageValue, FdeSkillQueryBinding } from './fdeSkillCardTypes';
+/** 时间范围运行态值 */
+export type FdeSkillTimeRangeValue = [string, string];
+/** 筛选器运行态值：单值、多值或时间范围 */
+export type FdeSkillFilterRuntimeValue = string | number | boolean | Array<string | number> | FdeSkillTimeRangeValue | null | undefined;
+export type FdeSkillQueryValueMap = Record<string, FdeSkillFilterRuntimeValue>;
+export interface FdeSkillQueryCriterion {
+    column_name: string;
+    query_type: number;
+    field_type?: string;
+    column_type?: string;
+    value: unknown[];
+}
+/** 旧图表 query_context.filters 兼容结构：字段 → 单值或数组 */
+export type FdeSkillChartFiltersMap = Record<string, string | number | boolean | Array<string | number>>;
+export interface FdeSkillApplyQueryFilterResult {
+    body: Record<string, unknown>;
+    appliedCriteria: FdeSkillQueryCriterion[];
+}
+export interface FdeSkillApplyChartFiltersResult {
+    filters: FdeSkillChartFiltersMap;
+    appliedCriteria: FdeSkillQueryCriterion[];
+}
+export interface FdeSkillMetricDimensionFilter {
+    dimension_code: string;
+    operator: 'EQ' | 'IN';
+    values: FdeSkillMetricStorageValue[];
+}
+export interface FdeSkillApplyMetricDimensionFiltersResult {
+    dimensionFilters: FdeSkillMetricDimensionFilter[];
+    dimensionCodes: string[];
+    appliedCriteria: FdeSkillQueryCriterion[];
+}
+/**
+ * 从旧 chart/data filters 迁移 query_criteria。
+ * @param filters - 旧 query_context.filters。
+ * @param bindings - 查询绑定清单，用于补充 query_type。
+ * @returns 可合并到 query_context.query_criteria 的条件。
+ */
+export declare function resolveFdeSkillLegacyChartFilterCriteria(filters: unknown, bindings?: readonly FdeSkillQueryBinding[]): FdeSkillQueryCriterion[];
+/**
+ * 生成查询值映射 key。
+ * @param sourceCardId - 查询卡 / 筛选器 ID。
+ * @param controlId - 查询控件 ID / control_key。
+ * @returns 查询值 key。
+ */
+export declare function buildFdeSkillQueryValueKey(sourceCardId: string, controlId: string): string;
+/**
+ * 从数据源绑定生成清单/指标 query_criteria。
+ * @param dataSource - 卡片数据源。
+ * @param queryValues - 查询值映射。
+ * @returns 可执行查询条件。
+ */
+export declare function resolveFdeSkillQueryCriteria(dataSource: FdeSkillDataSource, queryValues: FdeSkillQueryValueMap): FdeSkillQueryCriterion[];
+/**
+ * 从指标数据源绑定生成 metric_context.dimension_filters。
+ * @param dataSource - 指标卡数据源。
+ * @param queryValues - 查询值映射。
+ * @param supportedDimensions - 后端返回的可筛选维度。
+ * @returns 指标维度过滤、涉及维度和并行 criteria。
+ */
+export declare function resolveFdeSkillMetricDimensionFilters(dataSource: FdeSkillDataSource, queryValues: FdeSkillQueryValueMap, supportedDimensions: FdeSkillMetricDimensionMeta[]): FdeSkillApplyMetricDimensionFiltersResult;
+/**
+ * 从数据源绑定生成旧图表 query_context.filters 兼容对象。
+ * @param dataSource - 卡片数据源。
+ * @param queryValues - 查询值映射。
+ * @returns 旧 filters 对象与并行 criteria（供下钻记录）。
+ */
+export declare function resolveFdeSkillChartFilters(dataSource: FdeSkillDataSource, queryValues: FdeSkillQueryValueMap): FdeSkillApplyChartFiltersResult;
+/**
+ * 把查询卡运行态条件注入克隆后的服务或指标请求体（清单/数值通道）。
+ * @param body - 原始请求体。
+ * @param dataSource - 卡片数据源。
+ * @param queryValues - 查询值映射。
+ * @returns 克隆后的请求体和实际追加条件。
+ */
+export declare function applyFdeSkillQueryFiltersToRequestBody(body: Record<string, unknown>, dataSource: FdeSkillDataSource, queryValues: FdeSkillQueryValueMap): FdeSkillApplyQueryFilterResult;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillServiceDrilldown.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview FDE Skill 服务下钻 - 构造点击明细请求并归一化表格数据
+ * @author seadon
+ * @created 2026-06-27
+ */
+import type { FdeSkillLegacyChartCardIntent as FdeSkillChartCardIntent, FdeSkillDrilldownContext, FdeSkillDrilldownResult, FdeSkillExecuteRequest } from './fdeSkillCardTypes';
+import type { FdeSkillQueryCriterion } from './fdeSkillQueryFilters';
+export interface FdeSkillChartClickParams {
+    componentType?: string;
+    dataIndex?: number;
+    name?: unknown;
+    seriesName?: unknown;
+    event?: {
+        offsetX?: number;
+        offsetY?: number;
+        zrX?: number;
+        zrY?: number;
+        event?: {
+            offsetX?: number;
+            offsetY?: number;
+            clientX?: number;
+            clientY?: number;
+        };
+    };
+}
+export interface FdeSkillServiceDrilldownRequest extends FdeSkillExecuteRequest {
+    body: Record<string, unknown>;
+}
+export interface FdeSkillDrilldownNormalizeOptions {
+    fieldNameMap?: Record<string, string>;
+}
+export interface FdeSkillDrilldownActionPositionInput {
+    clickX: number;
+    clickY: number;
+    containerWidth: number;
+    containerHeight: number;
+    actionWidth?: number;
+    actionHeight?: number;
+    cursorGap?: number;
+    margin?: number;
+}
+export interface FdeSkillDrilldownActionPosition {
+    left: number;
+    top: number;
+}
+/**
+ * 根据点击点计算下钻操作条位置，并限制在图表容器内。
+ * @param input - 点击点、容器尺寸和操作条尺寸。
+ * @returns 操作条左上角坐标。
+ */
+export declare function resolveFdeSkillDrilldownActionPosition(input: FdeSkillDrilldownActionPositionInput): FdeSkillDrilldownActionPosition;
+/**
+ * 基于 X 轴分类生成点击兜底下钻上下文。
+ * @param card - 图卡协议。
+ * @param axisValue - X 轴分类值。
+ * @returns 点击上下文。
+ */
+export declare function resolveFdeSkillChartAxisFallbackContext(card: FdeSkillChartCardIntent, axisValue: unknown): FdeSkillDrilldownContext | null;
+/**
+ * 从 ECharts 点击参数解析服务下钻上下文。
+ * @param card - 图卡协议。
+ * @param params - ECharts click 参数。
+ * @returns 点击上下文，无法解析时返回 null。
+ */
+export declare function resolveFdeSkillChartClickContext(card: FdeSkillChartCardIntent, params: FdeSkillChartClickParams): FdeSkillDrilldownContext | null;
+/**
+ * 构造服务型点击明细请求。
+ * @param card - 图卡协议。
+ * @param context - 点击上下文。
+ * @param pageIndex - 页码，从 1 开始。
+ * @returns 服务执行请求。
+ */
+export declare function buildFdeSkillServiceDrilldownRequest(card: FdeSkillChartCardIntent, context: FdeSkillDrilldownContext, pageIndex?: number, appliedQueryCriteria?: FdeSkillQueryCriterion[]): FdeSkillServiceDrilldownRequest;
+/**
+ * 归一化服务明细响应。
+ * @param payload - 服务响应 JSON。
+ * @param options - 响应归一化选项。
+ * @returns 明细表格数据。
+ */
+export declare function normalizeFdeSkillDrilldownResponse(payload: unknown, options?: FdeSkillDrilldownNormalizeOptions): FdeSkillDrilldownResult;
+/**
+ * 调用服务型下钻接口。
+ * @param card - 图卡协议。
+ * @param context - 点击上下文。
+ * @param pageIndex - 页码。
+ * @param signal - 请求中止信号。
+ * @returns 明细数据。
+ */
+export declare function executeFdeSkillServiceDrilldown(card: FdeSkillChartCardIntent, context: FdeSkillDrilldownContext, pageIndex: number, signal?: AbortSignal, appliedQueryCriteria?: FdeSkillQueryCriterion[]): Promise<FdeSkillDrilldownResult>;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillServiceFields.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 构造服务字段列表运行态地址。
+ * @param appId - 应用 ID。
+ * @param serviceCode - 服务编码。
+ * @returns 服务字段列表地址。
+ */
+export declare function buildFdeSkillServiceFieldListUrl(appId: string, serviceCode: string): string;
+/**
+ * 读取服务输出字段名映射，失败时返回空映射。
+ * @param input - 应用和服务编码。
+ * @param signal - 请求中止信号。
+ * @returns 字段编码到字段名称的映射。
+ */
+export declare function resolveFdeSkillServiceFieldNameMap(input: {
+    app_id: string;
+    svc_code: string;
+}, signal?: AbortSignal): Promise<Record<string, string>>;