neo-cmp-cli 1.13.17 → 1.13.18

package/template/neo-pipeline-cmps/src/components/stageTimeChart__c/index.tsx

@@ -1,6 +1,6 @@
 /**
- * @file 阶段停留时间组件
- * @description 展示各销售阶段的平均停留时间；图表数据来自 NeoBI queryDataTask，目标/上限来自 XObject 的 customItem3/4（天）
+ * @file Stage Time Component
+ * @description Displays the average time spent in each sales stage; chart data from NeoBI queryDataTask, target/limit from XObject customItem3/4 (days)
  */
 import * as React from 'react';
 import { Spin } from 'antd';
@@ -52,7 +52,7 @@ interface StageTimeChartProps {
   style?: React.CSSProperties;
 }
 
-/** 阈值行：仅将 customItem3/4 规范为 number，其余字段保持原样 */
+/** Threshold row: only normalize customItem3/4 to number, keep other fields as-is */
 interface ThresholdRecordRow extends Record<string, unknown> {
   customItem3__c: number;
   customItem4__c: number;
@@ -63,14 +63,14 @@ interface StageTimeChartState {
   error: string | null;
   items: StageTimeItem[];
   filter: any;
-  /** 与阈值行 customItem2__c 一致，默认 New Business（可由 setFilter 更新） */
+  /** Matches threshold row customItem2__c, default New Business (can be updated by setFilter) */
   oppType: string;
-  /** fetchThresholdRecords 拉取的完整列表（已转换 customItem3/4 为 number） */
+  /** Full list fetched by fetchThresholdRecords (customItem3/4 converted to number) */
   thresholdRecords: ThresholdRecordRow[];
 }
 
 class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
-  /** 初始化 state */
+  /** Initialize state */
   constructor(props: StageTimeChartProps) {
     super(props);
     const initialOppType =
@@ -94,20 +94,20 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
     this.setFilter = this.setFilter.bind(this);
   }
 
-  /** 挂载后拉取阈值与图表 */
+  /** Fetch thresholds and chart data after mount */
   componentDidMount() {
     this.fetchAllData();
 
     /*
-    // 监听一个广播事件
+    // Listen to a broadcast event
     NeoEvent.listen('updateFilterData', (filterData: any) => {
-      console.log('StageTimeChart 监听到了一个广播事件 updateFilterData: ', filterData);
+      console.log('StageTimeChart received broadcast event updateFilterData: ', filterData);
       this.setFilter(filterData);
     });
     */
   }
 
-  /** 关键 props 变化时重新拉数 */
+  /** Re-fetch data when key props change */
   componentDidUpdate(
     prevProps: StageTimeChartProps,
     prevState: StageTimeChartState,
@@ -134,7 +134,7 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
     }
   }
 
-  /** 按 customItem1__c / customItem2__c 在列表中查找单行；customItem2 默认取 state.oppType */
+  /** Find a single row in the list by customItem1__c / customItem2__c; customItem2 defaults to state.oppType */
   getThresholdRecord(
     customItem1__c: string = String(this.state.oppType ?? 'New Business'),
     customItem2__c: string,
@@ -150,7 +150,7 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
     });
   }
 
-  /** 请求阈值列表，仅把 customItem3/4 转为 number，并写入 state.thresholdRecords */
+  /** Fetch threshold list, only convert customItem3/4 to number, and write to state.thresholdRecords */
   async fetchThresholdRecords(): Promise<ThresholdRecordRow[]> {
     const { thresholdsXObjectApi } = this.props;
     const apiKey = thresholdsXObjectApi?.xObjectApiKey;
@@ -180,7 +180,7 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
 
       if (!result?.status) {
         console.warn(
-          'StageTimeChart xObject.query(thresholds) 非成功:',
+          'StageTimeChart xObject.query(thresholds) not successful:',
           result?.msg ?? result,
         );
         this.setState({ thresholdRecords: [] });
@@ -199,13 +199,13 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
       this.setState({ thresholdRecords });
       return thresholdRecords;
     } catch (e) {
-      console.error('StageTimeChart 加载阈值数据失败:', e);
+      console.error('StageTimeChart failed to load threshold data:', e);
       this.setState({ thresholdRecords: [] });
       return [];
     }
   }
 
-  /** 请求 queryDataTask，解析表格行并挂上每行对应的 target/limit（来自阈值行 customItem3/4） */
+  /** Request queryDataTask, parse table rows and attach target/limit for each row (from threshold row customItem3/4) */
   async fetchChartRows(
     thresholdRecords: ThresholdRecordRow[],
   ): Promise<{ rows: StageTimeRow[]; error: string | null }> {
@@ -216,7 +216,7 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
     if (viewId == null || viewId === '' || userId == null || userId === '') {
       return {
         rows: [],
-        error: '缺少 viewId 或当前用户 id（data.__NeoCurrentUser.id）',
+        error: 'Missing viewId or current user id (data.__NeoCurrentUser.id)',
       };
     }
 
@@ -248,7 +248,7 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
       if (status !== 0 || !Array.isArray(table)) {
         return {
           rows: [],
-          error: res?.message || res?.msg || '查询图表数据失败',
+          error: res?.message || res?.msg || 'Failed to query chart data',
         };
       }
 
@@ -286,10 +286,10 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
 
       return { rows, error: null };
     } catch (e: any) {
-      console.error('StageTimeChart queryDataTask 失败:', e);
+      console.error('StageTimeChart queryDataTask failed:', e);
       return {
         rows: [],
-        error: e?.message || '网络请求失败',
+        error: e?.message || 'Network request failed',
       };
     }
   }
@@ -370,7 +370,7 @@ class StageTimeChart extends BaseCmp<StageTimeChartProps, StageTimeChartState> {
       <div
         className={`stageTimeChart__c ${className || ''}`}
         style={style}
-        data-time="2026.4.15 01"
+        data-time="2026.4.17 01"
       >
         <Spin spinning={loading}>
           <div className="chart-header">

package/template/neo-pipeline-cmps/src/components/stageTimeChart__c/model.ts

@@ -1,7 +1,7 @@
 export class StageTimeChartModel {
-  label: string = '阶段停留时间';
+  label: string = 'Stage Time';
   description: string =
-    '展示各销售阶段的平均停留时间；图表来自 NeoBI queryDataTask，目标/上限来自 XObject customItem3/4（天）';
+    'Displays the average time spent in each sales stage; chart data from NeoBI queryDataTask, target/limit from XObject customItem3/4 (days)';
   iconUrl: string = 'https://custom-widgets.bj.bcebos.com/barChart.svg';
   targetPage: string[] = ['all'];
   targetDevice: string = 'all';
@@ -11,9 +11,9 @@ export class StageTimeChartModel {
     viewId: '4264466340118875',
     viewType: 'sync',
     showAiButton: true,
-    /** 与阈值记录 customItem2__c 匹配的商机类型，默认 New Business */
+    /** Opportunity type matching threshold record customItem2__c, default New Business */
     oppType: 'New Business',
-    /** 阈值：customItem1__c 阶段键、customItem2__c 商机类型、customItem3__c/4 目标与上限（天） */
+    /** Thresholds: customItem1__c stage key, customItem2__c opportunity type, customItem3__c/4 target and limit (days) */
     thresholdsXObjectApi: {
       xObjectApiKey: 'customEntity105__c',
       fields: [
@@ -30,28 +30,29 @@ export class StageTimeChartModel {
   events = [
     {
       apiKey: 'onActiveStageChange',
-      label: '点击阶段条触发',
+      label: 'Triggered on stage bar click',
       helpText:
-        '点击阶段条触发；事件参数含 activeStage（当前激活阶段）',
+        'Triggered when clicking a stage bar; event params include activeStage (current active stage)',
       eventParams:
-        '[{"apiKey":"eventParam","children":[{"apiKey":"activeStage","label":"当前激活阶段","type":"String"}],"label":"事件入参","type":"Object"}]',
+        '[{"apiKey":"eventParam","children":[{"apiKey":"activeStage","label":"Current active stage","type":"String"}],"label":"Event parameters","type":"Object"}]',
     },
   ];
 
   functions = [
     {
       apiKey: 'refreshData',
-      label: '刷新数据',
-      helpTextKey: '重新请求 queryDataTask 与阈值配置，刷新停留时间',
+      label: 'Refresh data',
+      helpTextKey:
+        'Re-request queryDataTask and threshold config to refresh stage time',
     },
     {
       apiKey: 'setFilter',
-      label: '设置过滤条件',
-      helpTextKey: '设置 queryDataTask 的 filter 并重新拉取图表数据',
+      label: 'Set filter conditions',
+      helpTextKey: 'Set the queryDataTask filter and re-fetch chart data',
       funcInParams: [
         {
           apiKey: 'filter',
-          label: '过滤条件',
+          label: 'Filter conditions',
           type: 'Object',
           required: false,
         },
@@ -63,27 +64,28 @@ export class StageTimeChartModel {
     {
       type: 'panelInput',
       name: 'title',
-      label: '标题',
+      label: 'Title',
     },
     {
       type: 'panelInput',
       name: 'viewId',
-      label: '视图 ID',
+      label: 'View ID',
     },
     {
       type: 'panelInput',
       name: 'viewType',
-      label: '视图类型（请求 type）',
+      label: 'View type (request type)',
     },
     {
       type: 'panelInput',
       name: 'oppType',
-      label: '商机类型（匹配 customItem2__c）',
+      label: 'Opportunity type (matching customItem2__c)',
     },
+    /*
     {
       type: 'xObjectDataApi',
       name: 'thresholdsXObjectApi',
-      label: '阶段目标/上限数据源',
+      label: 'Stage target/limit data source',
       value: {
         xObjectApiKey: '',
         fields: [
@@ -94,9 +96,10 @@ export class StageTimeChartModel {
         ],
       },
       placeholder:
-        '实体需含 customItem1__c（阶段）、customItem2__c（商机类型）、customItem3/4（目标/上限天）',
+        'Entity must contain customItem1__c (stage), customItem2__c (opportunity type), customItem3/4 (target/limit days)',
       custom: true,
     },
+    */
   ];
 }
 

package/template/neo-pipeline-cmps/src/utils/common.ts

@@ -1,5 +1,5 @@
 /**
- * 多组件共用的纯工具方法（筛选 where、阶段名、金额展示、NeoBI 请求体等）
+ * Shared pure utility methods across multiple components (filter where, stage name, amount display, NeoBI request body, etc.)
  */
 
 export interface PropsContext {
@@ -10,7 +10,7 @@ export interface PropsContext {
     };
   };
 }
-/** 筛选项转有限数字，无效返回 null（与 filter2chartFilter 等一致） */
+/** Convert filter option to finite number, returns null if invalid (consistent with filter2chartFilter, etc.) */
 export function toFiniteNumber(v: unknown): number | null {
   if (v == null || v === '') return null;
   if (typeof v === 'number' && Number.isFinite(v)) return v;
@@ -18,7 +18,7 @@ export function toFiniteNumber(v: unknown): number | null {
   return Number.isFinite(n) ? n : null;
 }
 
-/** 时间区间起止：均为有效数字时返回闭区间 [start, end]（毫秒时间戳，与 FilterBar 一致） */
+/** Time range start/end: returns closed interval [start, end] when both are valid numbers (millisecond timestamps, consistent with FilterBar) */
 export function closeRangeFromFilter(
   range: unknown,
 ): { start: number; end: number } | null {
@@ -30,7 +30,7 @@ export function closeRangeFromFilter(
   return { start, end };
 }
 
-/** opportunityOwner → 用于 where 的用户 id 列表（字符串避免大整数精度丢失） */
+/** opportunityOwner -> user id list for where clause (string to avoid big integer precision loss) */
 export function normalizeOwnerIdsForWhere(owner: unknown): string[] {
   if (owner == null || owner === '') return [];
   const raw = Array.isArray(owner) ? owner : [owner];
@@ -51,7 +51,7 @@ export function entityTypeIdForWhere(businessType: unknown): string | null {
   return s.replace(/,/g, '');
 }
 
-/** 从阶段展示名取「第一个 . 之后」的片段，用于匹配 customItem1__c 等 */
+/** Extract the segment after the first '.' from stage display name, used for matching customItem1__c, etc. */
 export function extractStageKeyFromStageName(stageName: string): string {
   const s = String(stageName ?? '').trim();
   const i = s.indexOf('.');
@@ -59,7 +59,7 @@ export function extractStageKeyFromStageName(stageName: string): string {
   return s.slice(i + 1).trim();
 }
 
-/** 商机行等：空或无法解析时为 0 */
+/** Opportunity rows, etc.: returns 0 when empty or unparseable */
 export function parseNumberOrZero(raw: unknown): number {
   if (raw === null || raw === undefined || raw === '') return 0;
   const n =
@@ -69,7 +69,7 @@ export function parseNumberOrZero(raw: unknown): number {
   return Number.isFinite(n) ? n : 0;
 }
 
-/** 阈值配置等：空或无法解析时为 NaN */
+/** Threshold config, etc.: returns NaN when empty or unparseable */
 export function parseNumberOrNaN(raw: unknown): number {
   if (raw === null || raw === undefined || raw === '') return NaN;
   const n =
@@ -79,7 +79,7 @@ export function parseNumberOrNaN(raw: unknown): number {
   return Number.isFinite(n) ? n : NaN;
 }
 
-/** 展示用金额：$ 前缀；≥1e3 时使用 K / M / B / T 缩写 */
+/** Display amount: $ prefix; uses K / M / B / T abbreviation when >= 1e3 */
 export function formatAmountDisplay(n: number): string {
   if (!Number.isFinite(n)) return '-';
   const sign = n < 0 ? '-' : '';
@@ -110,7 +110,7 @@ export function formatAmountDisplay(n: number): string {
   return `${sign}$${body}${suffix}`;
 }
 
-/** queryDataTask：x-www-form-urlencoded 表单体（filter 以 JSON 字符串传递） */
+/** queryDataTask: x-www-form-urlencoded form body (filter passed as JSON string) */
 export function buildQueryDataTaskFormBody(params: {
   viewId: string;
   userId: string | number;
@@ -125,11 +125,11 @@ export function buildQueryDataTaskFormBody(params: {
   return form.toString();
 }
 
-/** 负责人多选默认值：当前登录用户 id（与 __NeoCurrentUser 一致） */
+/** Owner multi-select default: current logged-in user id (consistent with __NeoCurrentUser) */
 export function getDefaultOpportunityOwnerIds(
   props: PropsContext,
 ): (number | string)[] {
-  // return [1246045]; // 默认用户改成 （Alice）
+  // return [1246045]; // Default user changed to (Alice)
   const curUser = props.data?.__NeoCurrentUser;
   if (
     curUser?.id == null ||
@@ -141,9 +141,9 @@ export function getDefaultOpportunityOwnerIds(
   return [curUser.id];
 }
 
-/** 负责人多选默认值：当前登录用户 id（与 __NeoCurrentUser 一致） */
+/** Owner multi-select default: current logged-in user id (consistent with __NeoCurrentUser) */
 export function getDefaultFilterWhereByProps(props: any = {}): any {
-  let userId = 1246045; // 默认用户（Alice）
+  let userId = 1246045; // Default user (Alice)
   const curUser = props.data?.__NeoCurrentUser;
   if (curUser?.id) {
     userId = curUser.id;
@@ -207,7 +207,7 @@ export function getDefaultFilterWhereByProps(props: any = {}): any {
 }
 
 export function getDefaultFilterByProps(props: any = {}): any {
-  let userId = 1246045; // 默认用户（Alice）
+  let userId = 1246045; // Default user (Alice)
   const curUser = props.data?.__NeoCurrentUser;
   if (curUser?.id) {
     userId = curUser.id;

package/template/neo-pipeline-cmps/src/utils/filter2chartFilter.ts

@@ -1,26 +1,26 @@
 /**
- * 过滤条件格式化
- * 将筛选栏组件得到的过滤条件格式化为接口需要的格式。
+ * Filter condition formatting
+ * Formats the filter conditions from the filter bar component into the format required by the API.
  * 
- * 数据转换规则：
+ * Data conversion rules:
 1. closeDate
 
-非 custom：用 toFiniteNumber 把选项值（如 201 / "201"）转成数字，timeType: 'relative'，value: [{ val, baseType: 'system' }]。
-custom：读取 closeDateCustomRange.start / end，二者均为有效数字时，timeType: 'absolute'，value 为两条 { val, close: 1 }；缺区间则不生成该项。
+Non-custom: Use toFiniteNumber to convert the option value (e.g. 201 / "201") to a number, timeType: 'relative', value: [{ val, baseType: 'system' }].
+custom: Read closeDateCustomRange.start / end; when both are valid numbers, timeType: 'absolute', value is two { val, close: 1 } entries; if range is missing, this item is not generated.
 
-2. opportunityOwner → ownerId
-支持单值（字符串/数字）或多选数组；逐项 toFiniteNumber，无效项丢弃。至少一个有效 id 时生成 refer 条件（referKey: 'user'、optionType: 'user'、operate: 'in'、includeNullValue: 0）。
-value 为数组，每个用户为 { val, sub: false, source: 'internal', specialType: 0 }。
+2. opportunityOwner -> ownerId
+Supports single value (string/number) or multi-select array; toFiniteNumber each item, invalid items are discarded. When at least one valid id exists, generates a refer condition (referKey: 'user', optionType: 'user', operate: 'in', includeNullValue: 0).
+value is an array, each user is { val, sub: false, source: 'internal', specialType: 0 }.
 
-3. businessType → entityType
-有值且能转成数字时，生成 refer + value: [{ val }]；空字符串不传 entityType。
+3. businessType -> entityType
+When a value exists and can be converted to a number, generates refer + value: [{ val }]; empty string does not pass entityType.
 
 4. relation
-按最终条目的 seq 拼成 "1 and 2 and 3"；没有任何条件时为 ''，filter 为 []。
+Concatenated as "1 and 2 and 3" based on the seq of final items; when there are no conditions, it is '', filter is [].
 
  * 
- * 例如：
- * 筛选栏组件得到的过滤条件：
+ * Example:
+ * Filter conditions from the filter bar component:
 {
     "closeDate": "custom",
     "closeDateCustomRange": {
@@ -33,7 +33,7 @@ value 为数组，每个用户为 { val, sub: false, source: 'internal', special
     "changesSinceCustomTime": 1776268800000
 }
 
-接口需要的格式：
+Format required by the API:
 {
     "relation": "1 and 2 and 3",
     "filter": [
@@ -96,7 +96,7 @@ value 为数组，每个用户为 { val, sub: false, source: 'internal', special
     ]
   }
 
-  如果是 closeDate 为 custom，则需要将 closeDateCustomRange 格式化为接口需要的格式
+  If closeDate is custom, the closeDateCustomRange needs to be formatted into the API-required format
   {
         "seq": 3,
         "fieldKey": "closeDate",
@@ -193,7 +193,7 @@ const ownerUserValueItem = (val: number) => ({
   specialType: 0,
 });
 
-/** 从 opportunityOwner（单值或 id 数组）解析出有效的用户 id 列表 */
+/** Parse valid user id list from opportunityOwner (single value or id array) */
 function normalizeOwnerIds(owner: unknown): number[] {
   if (owner == null || owner === '') return [];
   const raw = Array.isArray(owner) ? owner : [owner];
@@ -244,15 +244,13 @@ function entityTypeChunk(
 }
 
 /**
- * 将筛选栏 payload 转为图表/接口 filter 结构；仅映射 closeDate、ownerId、entityType。
+ * Convert filter bar payload to chart/API filter structure; only maps closeDate, ownerId, entityType.
  */
 export const filter2chartFilter = (filter: any): ChartFilterPayload => {
   const f = filter && typeof filter === 'object' ? filter : {};
-  const parts = [
-    closeDateChunk(f),
-    ownerChunk(f),
-    entityTypeChunk(f),
-  ].filter(Boolean) as Omit<ChartFilterItem, 'seq'>[];
+  const parts = [closeDateChunk(f), ownerChunk(f), entityTypeChunk(f)].filter(
+    Boolean,
+  ) as Omit<ChartFilterItem, 'seq'>[];
 
   const filterOut: ChartFilterItem[] = parts.map((p, i) => ({
     ...p,
@@ -265,4 +263,4 @@ export const filter2chartFilter = (filter: any): ChartFilterPayload => {
       : filterOut.map((x) => String(x.seq)).join(' and ');
 
   return { relation, filter: filterOut };
-};
+};

package/template/neo-pipeline-cmps/src/utils/filterBar.ts

@@ -1,22 +1,22 @@
 /**
- * 筛选栏 filterBar 专用工具方法
+ * Filter bar filterBar specific utility methods
  */
 import moment from 'moment';
 
 export interface FilterOption {
   value: string | number;
   label: string;
-  /** 业务类型等接口项上的 apiKey，用于与 defaultBusiType 配置对齐 */
+  /** apiKey on API items like business type, used to align with defaultBusiType config */
   apiKey?: string;
 }
 
-/** 自定义日期区间：起止为 Unix 毫秒时间戳（日为本地 startOfDay / endOfDay） */
+/** Custom date range: start/end are Unix millisecond timestamps (day is local startOfDay / endOfDay) */
 export interface TimestampRange {
   start?: number;
   end?: number;
 }
 
-/** 规范化下拉项的 value / label */
+/** Normalize dropdown item value / label */
 export function normalizeOptions(list?: FilterOption[]): FilterOption[] {
   if (!Array.isArray(list) || list.length === 0) return [];
   return list.map((o) => ({
@@ -25,7 +25,7 @@ export function normalizeOptions(list?: FilterOption[]): FilterOption[] {
   }));
 }
 
-/** Changes Since 下拉默认项 */
+/** Changes Since dropdown default options */
 export function defaultChangesSinceOptions(): FilterOption[] {
   return [
     { value: 'Start of the Period', label: 'Start of the Period' },
@@ -33,7 +33,7 @@ export function defaultChangesSinceOptions(): FilterOption[] {
   ];
 }
 
-/** RangePicker 选中的两天转为起止时间戳（含当日） */
+/** Convert two selected days from RangePicker to start/end timestamps (inclusive of the day) */
 export function momentRangeToTimestamps(dates: any): TimestampRange | null {
   const m0 = dates?.[0];
   const m1 = dates?.[1];
@@ -45,8 +45,8 @@ export function momentRangeToTimestamps(dates: any): TimestampRange | null {
 }
 
 /**
- * 将 Close Date 相对周期编码转为本地自然日的起止时间戳（起点 0 点，终点 23:59:59.999）。
- * 约定：百位 2=本周(iso 周)、3=本月、4=本季度（如 201/301/401 及同段其它编码）。
+ * Convert Close Date relative period code to local calendar day start/end timestamps (start at midnight, end at 23:59:59.999).
+ * Convention: hundreds digit 2=this week (ISO week), 3=this month, 4=this quarter (e.g. 201/301/401 and other codes in the same range).
  */
 export function relativeCloseDateRangeFromCode(
   encoded: number | string,
@@ -62,7 +62,7 @@ export function relativeCloseDateRangeFromCode(
     };
   }
   if (curEncoded === 301) {
-    // This Month（起点为月初次日 0 点）
+    // This Month (start is the second day of the month at midnight)
     return {
       start: now
         .clone()
@@ -74,7 +74,7 @@ export function relativeCloseDateRangeFromCode(
     };
   }
   if (curEncoded === 401) {
-    // This Quarter（起点为季首次日 0 点）
+    // This Quarter (start is the second day of the quarter at midnight)
     return {
       start: now
         .clone()
@@ -88,7 +88,7 @@ export function relativeCloseDateRangeFromCode(
   return null;
 }
 
-/** 将 user 实体查询结果转为负责人下拉项（按 id 去重） */
+/** Convert user entity query results to owner dropdown options (deduplicated by id) */
 export function parseUserRecordsToOwnerOptions(records: any): FilterOption[] {
   const arr = Array.isArray(records) ? records : [];
   const seen = new Set<string>();
@@ -104,7 +104,7 @@ export function parseUserRecordsToOwnerOptions(records: any): FilterOption[] {
   return out;
 }
 
-/** 从业务类型接口响应中取出列表数组 */
+/** Extract list array from business type API response */
 export function getBusinessTypeRawList(res: any): any[] {
   const raw = res?.data !== undefined ? res.data : res;
   const arr = Array.isArray(raw)
@@ -113,7 +113,7 @@ export function getBusinessTypeRawList(res: any): any[] {
   return Array.isArray(arr) ? arr : [];
 }
 
-/** 解析业务类型接口结果为下拉选项（保留 apiKey 供默认项匹配） */
+/** Parse business type API results to dropdown options (preserving apiKey for default item matching) */
 export function parseBusinessTypes(res: any): FilterOption[] {
   const arr = getBusinessTypeRawList(res);
   return arr
@@ -126,7 +126,7 @@ export function parseBusinessTypes(res: any): FilterOption[] {
 }
 
 /**
- * 在业务类型选项中按 apiKey === defaultBusiType 解析默认选中值（与下拉 value 一致，一般为 id）
+ * Resolve default selected value in business type options by apiKey === defaultBusiType (consistent with dropdown value, usually id)
  */
 export function resolveDefaultBusinessTypeValue(
   options: FilterOption[],

package/template/neo-pipeline-cmps/src/utils/pipelineFunnel.ts

@@ -1,5 +1,5 @@
 /**
- * Pipeline 漏斗 pipelineFunnel 专用（解析表格行、ECharts 配置）
+ * Pipeline funnel pipelineFunnel specific (parse table rows, ECharts config)
  */
 import * as echarts from 'echarts';
 
@@ -41,7 +41,7 @@ export function isTruthyProp(v: unknown): boolean {
   return v === true || v === 'true' || v === 1 || v === '1';
 }
 
-/** 与后端阶段名比对时忽略大小写与连续空白 */
+/** Ignore case and consecutive whitespace when comparing with backend stage names */
 export function isClosedLostStageName(raw: unknown): boolean {
   const n = String(raw ?? '')
     .trim()
@@ -50,7 +50,7 @@ export function isClosedLostStageName(raw: unknown): boolean {
   return n === 'closed lost';
 }
 
-/** 去掉 Closed Lost 阶段行，保留表头；须在 parseRowsToStages 之前调用，以免计入总额与占比 */
+/** Remove Closed Lost stage rows, keep header; must be called before parseRowsToStages to avoid counting in total and percentage */
 export function filterOutClosedLostRows(table: unknown[][]): unknown[][] {
   if (!Array.isArray(table) || table.length < 2) return table;
   const header = table[0];
@@ -122,7 +122,7 @@ export function funnelValueForStage(
   return 0;
 }
 
-/** 经典漏斗：宽度仍由 value（顺序）控制；层高按金额占比分配（与 series.gap 一致，单位为 px） */
+/** Classic funnel: width still controlled by value (order); layer height allocated by amount proportion (consistent with series.gap, unit is px) */
 export function classicFunnelLayerHeightPercents(
   amountNums: number[],
   viewHeightPx: number,
@@ -144,7 +144,7 @@ export function classicFunnelLayerHeightPercents(
 }
 
 export interface BuildFunnelChartOptionParams {
-  /** 容器高度（px），经典模式下用于计算各层 height 百分比；变化时应重新 setOption */
+  /** Container height (px), used in classic mode to calculate layer height percentages; should re-setOption when changed */
   chartViewHeightPx?: number;
   funnelGap?: number;
 }