neo-cmp-cli 1.13.17 → 1.13.19

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;
 }

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

@@ -2,10 +2,10 @@
 import { request as axiosFetcher } from 'neo-open-api';
 
 /**
- * 这里存放通用查询类 Open API
+ * Common query Open APIs are stored here
  */
 
-/** 将 where 规范为 SQL 片段：字符串直接使用；数组用 and 拼接各条件 */
+/** Normalize where to SQL fragment: string is used directly; array items are joined with 'and' */
 function normalizeWhere(where: unknown): string {
   if (where == null || where === '') {
     return '';
@@ -22,7 +22,7 @@ function normalizeWhere(where: unknown): string {
   return '';
 }
 
-// 根据 sql 查询 BI 数据
+// Query BI data by SQL
 export const queryByCustomSQL = async (options?: any) => {
   const apiUrl = '/rest/neobi/v2.0/query/queryByCustomSQL';
   const curOptions = options || {};
@@ -31,34 +31,34 @@ export const queryByCustomSQL = async (options?: any) => {
   const page = curOptions.page || 1;
   const pageSize = curOptions.pageSize || 10;
 
-  // 自动添加 objectId 字段
+  // Automatically add objectId field
   if (!fields.includes('id')) {
     fields.push('id');
   }
 
-  // 计算分页偏移量
+  // Calculate pagination offset
   const offset = (page - 1) * pageSize;
 
-  // 构建 SQL 查询
+  // Build SQL query
   let querySql = `select ${fields.join(',')} from ${xObjectApiKey}`;
 
-  // 添加排序条件（如果有的话）
+  // Add sort conditions (if any)
   if (curOptions.orderBy) {
     querySql += ` order by ${curOptions.orderBy}`;
   }
 
   /**
-   * 添加过滤条件（如果有的话）
-   * 支持的操作符包括：=、!=、like、not like、not in、is not null、is null、>、<、<>、>=、<=、in、between ... and ...。
-   * 对于 =、like 和 in 有以下说明：
-   *   “=” 作为字符串的条件时，表示精确匹配。例如，查询条件 city = '北京'，将返回 city 字段值严格等于 "北京" 的所有记录。
-   *   "like" 作为字符串的条件时，需要使用"%" 通配符进行模糊匹配。例如，city like‘北京%'，将返回 city 字段值以 "北京" 开头的所有记录。
-   *         目前仅支持将通配符“%” 放到已知内容之后的查询方式，例如，不支持 city like ‘% 北京'的查询方式。
-   *         当 SQL 查询中包含“%”等特殊字符时，需要对 SQL 进行 URL 编码处理。
-   * 支持"in"，但不包括子查询。
-   * 支持的逻辑运算符包括：and、or。
+   * Add filter conditions (if any)
+   * Supported operators: =, !=, like, not like, not in, is not null, is null, >, <, <>, >=, <=, in, between ... and ...
+   * Notes for =, like and in:
+   *   "=" as a string condition means exact match. For example, city = 'Beijing' returns all records where city is strictly equal to "Beijing".
+   *   "like" as a string condition requires "%" wildcard for fuzzy matching. For example, city like 'Beijing%' returns all records where city starts with "Beijing".
+   *         Currently only supports placing "%" after the known content; e.g., city like '% Beijing' is not supported.
+   *         When the SQL query contains special characters like "%", URL encoding is required.
+   * Supports "in", but not subqueries.
+   * Supported logical operators: and, or.
    *
-   * `where` 可为字符串，或字符串数组（多项默认以 and 连接，等价于手写 `a and b`）。
+   * `where` can be a string, or a string array (multiple items joined with 'and' by default, equivalent to `a and b`).
    */
   const whereClause = normalizeWhere(curOptions.where);
 
@@ -67,7 +67,7 @@ export const queryByCustomSQL = async (options?: any) => {
   }
 
   if (curOptions.page || curOptions.pageSize) {
-    // 添加分页限制
+    // Add pagination limit
     querySql += ` limit ${offset},${pageSize}`;
   }
 
@@ -91,7 +91,8 @@ export const queryByCustomSQL = async (options?: any) => {
       return {
         status: true,
         code: resultData.code,
-        msg: resultData.msg || '获取业务对象数据列表成功',
+        msg:
+          resultData.msg || 'Successfully retrieved business object data list',
         totalSize: records.length,
         data: records || [],
       };
@@ -100,15 +101,18 @@ export const queryByCustomSQL = async (options?: any) => {
     return {
       status: false,
       code: resultData.code,
-      msg: resultData.msg || '获取业务对象数据列表失败',
+      msg: resultData.msg || 'Failed to retrieve business object data list',
       data: [],
     };
   } catch (error) {
-    console.error('获取业务对象数据列表失败:', error);
+    console.error('Failed to retrieve business object data list:', error);
 
     return {
       status: false,
-      msg: error.msg || error.message || '获取业务对象数据列表失败',
+      msg:
+        error.msg ||
+        error.message ||
+        'Failed to retrieve business object data list',
       data: [],
     };
   }

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

@@ -1,10 +1,10 @@
 // @ts-nocheck
 import debounce from 'lodash/debounce';
 
-/** 组件内数据请求防抖间隔（毫秒），用于合并短时间内的重复触发 */
+/** Data request debounce interval in milliseconds for components, used to merge repeated triggers within a short time */
 export const REQUEST_DEBOUNCE_MS = 280;
 
-/** lodash debounce 实例（避免依赖 @types/lodash） */
+/** lodash debounce instance (avoids dependency on @types/lodash) */
 export type DebouncedRequestFn = {
   (): void;
   cancel(): void;
@@ -12,7 +12,7 @@ export type DebouncedRequestFn = {
 };
 
 /**
- * 尾部防抖：连续触发时仅在停顿后执行一次，适合 filter / props 连更新场景。
+ * Trailing debounce: executes only once after a pause during continuous triggers, suitable for filter / props rapid update scenarios.
  */
 export function createRequestDebounce(
   fn: () => void,

package/template/neo-pipeline-cmps/src/utils/simpleTable.tsx

@@ -1,5 +1,5 @@
 /**
- * 表格 simpleTable 专用：格式化、历史快照、趋势与单元格渲染
+ * Table simpleTable specific: formatting, history snapshots, trends and cell rendering
  */
 import * as React from 'react';
 import { Card, Popover } from 'antd';
@@ -7,7 +7,7 @@ import moment from 'moment';
 
 import { toFiniteNumber } from './common';
 
-/** 期间初商机快照（与当前行 id 关联） */
+/** Period-start opportunity snapshot (associated with current row id) */
 export interface HistoryOppSnap {
   id: string;
   closeDate: unknown;
@@ -67,7 +67,7 @@ function closeDateTrend(
   return 'same';
 }
 
-/** 自定义 SQL 返回行：数组列顺序与 HISTORY_QUERY_FIELDS 一致；或对象字段 */
+/** Custom SQL return row: array column order matches HISTORY_QUERY_FIELDS; or object fields */
 export function historyRowToSnap(row: unknown): HistoryOppSnap | null {
   if (row == null) return null;
   if (Array.isArray(row)) {
@@ -91,9 +91,7 @@ export function historyRowToSnap(row: unknown): HistoryOppSnap | null {
       opportunityName: String(
         o.opportunity_1_opportunityName ?? o.opportunityName ?? '',
       ),
-      saleStageId: String(
-        o.opportunity_1_saleStageId ?? o.saleStageId ?? '',
-      ),
+      saleStageId: String(o.opportunity_1_saleStageId ?? o.saleStageId ?? ''),
       money: o.opportunity_1_money ?? o.money,
     };
   }
@@ -123,7 +121,7 @@ export function formatActivityDateTime(value: unknown): string {
   return m.isValid() ? m.format('YYYY-MM-DD HH:mm:ss') : String(value);
 }
 
-/** customItem246/247：变更记录时间（毫秒/秒时间戳或可被 moment 解析的值）→ YYYY-MM-DD */
+/** customItem246/247: change record time (ms/s timestamp or moment-parseable value) -> YYYY-MM-DD */
 export function formatChangeRecordedAt(value: unknown): string {
   if (value == null || value === '') return '—';
   const n = toFiniteNumber(value);
@@ -136,7 +134,7 @@ export function formatChangeRecordedAt(value: unknown): string {
   return m.isValid() ? m.format('YYYY-MM-DD') : String(value);
 }
 
-/** 金额列：$ 前缀 + 千分位（不缩写） */
+/** Money column: $ prefix + thousands separator (no abbreviation) */
 export function formatMoneyCell(value: unknown): string {
   if (value == null || value === '') return '—';
   const n = parseFloat(String(value).replace(/,/g, '').trim());
@@ -150,8 +148,10 @@ export function formatMoneyCell(value: unknown): string {
   return `$${part}`;
 }
 
-/** oppHealthAssessmentLevel：数值 → 健康度标签（带颜色背景） */
-export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode {
+/** oppHealthAssessmentLevel: numeric value -> health label (with colored background) */
+export function renderOppHealthAssessmentLevel(
+  value: unknown,
+): React.ReactNode {
   if (value == null || value === '') return '—';
   const n = toFiniteNumber(value);
   if (n === 5) {
@@ -160,7 +160,9 @@ export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode
     );
   }
   if (n === 6) {
-    return <span className="opp-health-tag opp-health-tag--yellow">Health</span>;
+    return (
+      <span className="opp-health-tag opp-health-tag--yellow">Health</span>
+    );
   }
   if (n === 7) {
     return <span className="opp-health-tag opp-health-tag--red">Risk</span>;
@@ -172,7 +174,7 @@ export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode
 }
 
 /**
- * 百分比列：末尾加 %；接口常见为 0–1 小数或 0–100 数值，均按可读方式展示
+ * Percentage column: appends %; API commonly returns 0-1 decimal or 0-100 numeric, both displayed in readable format
  */
 export function formatPercentCell(value: unknown): string {
   if (value == null || value === '') return '—';
@@ -205,7 +207,9 @@ export function moneyChangeTooltipTitle(
       <div className="simpleTable-change-tip__detail">
         {formatMoneyCell(h.money)}
         {' → '}
-        <span className="simpleTable-change-tip__to">{formatMoneyCell(current)}</span>
+        <span className="simpleTable-change-tip__to">
+          {formatMoneyCell(current)}
+        </span>
       </div>
       <div className="simpleTable-change-tip__meta">
         Changed on {formatChangeRecordedAt(preset)}
@@ -227,7 +231,9 @@ export function closeDateChangeTooltipTitle(
       <div className="simpleTable-change-tip__detail">
         {formatCloseDate(h.closeDate)}
         {' → '}
-        <span className="simpleTable-change-tip__to">{formatCloseDate(current)}</span>
+        <span className="simpleTable-change-tip__to">
+          {formatCloseDate(current)}
+        </span>
       </div>
       <div className="simpleTable-change-tip__meta">
         Changed on {formatChangeRecordedAt(preset)}
@@ -268,22 +274,17 @@ export function renderTrendCell(args: {
   );
 }
 
-/** demo.html winRateTooltip 风格 */
+/** demo.html winRateTooltip style */
 export function renderWinRateHoverCard(record: any): React.ReactNode {
   const baseline = record?.customItem244__c;
   const positives = record?.customItem241__c;
   const negatives = record?.customItem242__c;
   const winRate = record?.customItem239__c;
 
-  const fmtLine = (v: unknown) =>
-    v == null || v === '' ? '—' : String(v);
+  const fmtLine = (v: unknown) => (v == null || v === '' ? '—' : String(v));
 
   return (
-    <Card
-      size="small"
-      bordered={false}
-      className="simpleTable-winrate-card"
-    >
+    <Card size="small" bordered={false} className="simpleTable-winrate-card">
       <div className="simpleTable-winrate-card__baseline">
         Baseline Probability{' '}
         <span className="simpleTable-winrate-card__baseline-val">
@@ -291,12 +292,16 @@ export function renderWinRateHoverCard(record: any): React.ReactNode {
         </span>
       </div>
       <hr className="simpleTable-winrate-card__hr" />
-      <div className="simpleTable-winrate-card__section-title">Positive Factors</div>
+      <div className="simpleTable-winrate-card__section-title">
+        Positive Factors
+      </div>
       <div className="simpleTable-winrate-card__positives">
         {fmtLine(positives)}
       </div>
       <hr className="simpleTable-winrate-card__hr" />
-      <div className="simpleTable-winrate-card__section-title">Negative Factors</div>
+      <div className="simpleTable-winrate-card__section-title">
+        Negative Factors
+      </div>
       <div className="simpleTable-winrate-card__negatives">
         {fmtLine(negatives)}
       </div>
@@ -311,7 +316,7 @@ export function renderWinRateHoverCard(record: any): React.ReactNode {
   );
 }
 
-/** 汇总金额展示（与 formatMoneyCell 数字格式一致） */
+/** Summary amount display (number format consistent with formatMoneyCell) */
 export function formatMoneySummaryAmount(n: number): string {
   const part = Number.isInteger(n)
     ? n.toLocaleString('en-US')
@@ -322,7 +327,7 @@ export function formatMoneySummaryAmount(n: number): string {
   return `$${part}`;
 }
 
-/** 按字段 apiKey 汇总行金额（解析规则与金额列一致） */
+/** Sum row amounts by field apiKey (parsing rules consistent with money column) */
 export function sumMoneyRows(rows: any[], moneyFieldKey: string): number {
   let total = 0;
   for (const row of rows) {