@finebi/finebi-cli 1.2.1 → 1.3.0

package/skills/finebi-cli-agent/references/formula-help-index.md

@@ -0,0 +1,264 @@
+# 官方函数文档索引
+
+## 1. 覆盖范围与使用方式
+
+入口：[函数学习路径](https://help.fanruan.com/finebi/doc-view-1709.html)。按官方导航树的“进阶学习 → 函数专题”完整子树整理，快照日期 2026-09-20，共 186 篇唯一文档，涵盖入门、各类函数、应用、FAQ 和自定义函数。范围是这一完整专题，不是全站所有出现“函数”字样的运维或权限文档；视频、在线习题和附件不作为已读取的正文。
+
+先在本页按函数名或场景定位，打开“蒸馏落点”；只有需要查原始细节、图示或目标版本差异时才打开原文。不需要每次读取全部来源。[函数库](formula-functions.md)提供选型和简例；125 篇独立函数/表达式页的逐参数说明分为 [文本](formula-parameters-text.md)、[日期](formula-parameters-date.md)、[数值与逻辑](formula-parameters-math-logic.md)、[聚合与表格计算](formula-parameters-aggregate.md)、[DEF/LOD/窗口/引用](formula-parameters-analysis.md)。位置、引擎和跨函数组合限制集中在 [使用边界](formula-help-boundaries.md)。
+
+官方网页是产品使用语义来源；CLI 的字段引用、Model JavaScript、主题 profile、validate 是本项目接入契约，两者不可混为官方网页原文。既有实例补充函数 PERIOD_TD、TOSTRING、WINDOW_MEDIAN 保留为待面板核验项，不声称本专题逐个提供完整说明。
+
+正文示例统一英文符号、字段引用及明确函数名；只在图片中的公式不伪装为已逐字转录。模板是从正文和签名改写的候选表达式，不是执行结果。[排错文档](formula-troubleshooting.md#4-来源冲突处理) 记录原文冲突及采用口径。
+
+## 2. 分类来源
+
+### 【函数学习路径】（1 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [【函数学习路径】](https://help.fanruan.com/finebi/doc-view-1709.html) | [formula-generation](formula-generation.md) | 学习路线与函数族选型；视频、练习入口不作为可执行公式证据 |
+
+### 函数新手入门（3 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [BI函数与Excel函数对应](https://help.fanruan.com/finebi/doc-view-1349.html) | [formula-troubleshooting](formula-troubleshooting.md) | Excel 对照按单函数页裁决；NOT/IFERROR 条目不作支持性依据 |
+| [函数计算格式](https://help.fanruan.com/finebi/doc-view-2.html) | [formula-syntax](formula-syntax.md) | 函数、字段、运算符、字面量组成；GUI 标签转成 CLI 字段引用 |
+| [运算符和优先级](https://help.fanruan.com/finebi/doc-view-1321.html) | [formula-syntax](formula-syntax.md) | 比较、逻辑、文本拼接及优先级；复杂组合显式加括号 |
+
+### 文本函数（30 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [文本函数概述](https://help.fanruan.com/finebi/doc-view-6.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [UPPER-转为大写字符](https://help.fanruan.com/finebi/doc-view-1464.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TRIM-清除首尾空格](https://help.fanruan.com/finebi/doc-view-1453.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TOINTEGER-文本转为Integer](https://help.fanruan.com/finebi/doc-view-1461.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TODOUBLE-将文本转换成 Double 对象](https://help.fanruan.com/finebi/doc-view-1466.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SUBSTITUTE-替换指定字符](https://help.fanruan.com/finebi/doc-view-1458.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [STARTWITH-判断字符串 str1 是否以 str2 开始](https://help.fanruan.com/finebi/doc-view-1477.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SPLIT-分割字段](https://help.fanruan.com/finebi/doc-view-1463.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [RIGHT-截取后几个字符串](https://help.fanruan.com/finebi/doc-view-1465.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [REPLACE-替换指定位置字符](https://help.fanruan.com/finebi/doc-view-1469.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [REPEAT-重复显示文本](https://help.fanruan.com/finebi/doc-view-1462.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [REGEXP-判断字符串和正则表达式是否匹配](https://help.fanruan.com/finebi/doc-view-1476.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [PROPER-转换文本大小写](https://help.fanruan.com/finebi/doc-view-1475.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [NUMTO-数字转中文格式](https://help.fanruan.com/finebi/doc-view-1456.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MID-返回指定位置字符串](https://help.fanruan.com/finebi/doc-view-1459.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LOWER-大写转小写](https://help.fanruan.com/finebi/doc-view-1471.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LEFT-截取前几个字符串](https://help.fanruan.com/finebi/doc-view-1457.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LEN-返回字符长度](https://help.fanruan.com/finebi/doc-view-1472.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [INDEXOF-返回指定位置的字符](https://help.fanruan.com/finebi/doc-view-1467.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [FORMAT-格式转换](https://help.fanruan.com/finebi/doc-view-1454.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [FIND-返回字符所在位置](https://help.fanruan.com/finebi/doc-view-1468.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [EXACT-判断两文本是否相同](https://help.fanruan.com/finebi/doc-view-1460.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ENDWITH-判断字符串结束情况](https://help.fanruan.com/finebi/doc-view-1455.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [CONCATENATE-合并字段](https://help.fanruan.com/finebi/doc-view-1470.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [CODE-返回数值代码](https://help.fanruan.com/finebi/doc-view-1474.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [CHAR-返回指定数值的字符](https://help.fanruan.com/finebi/doc-view-1473.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [文本合并、截取、分列](https://help.fanruan.com/finebi/doc-view-1331.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 拼接、固定长度截取、按分隔符分列及倒数段 |
+| [正则表达式示例](https://help.fanruan.com/finebi/doc-view-1155.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 数字匹配、反斜杠转义；区分零次和至少一次匹配 |
+| [统计字段中某字符出现次数](https://help.fanruan.com/finebi/doc-view-1078.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 替换前后长度差统计字符次数 |
+| [特殊字符处理](https://help.fanruan.com/finebi/doc-view-1481.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | PROPER/LOWER 统一大小写 |
+
+### 日期函数（29 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [日期函数概述](https://help.fanruan.com/finebi/doc-view-7.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [DATE-显示日期](https://help.fanruan.com/finebi/doc-view-1414.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DATEDIF-日期差](https://help.fanruan.com/finebi/doc-view-1402.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DATEDELTA-返回后几天日期](https://help.fanruan.com/finebi/doc-view-1403.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DATESUBDATE-日期时间差](https://help.fanruan.com/finebi/doc-view-1411.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DATETONUMBER-日期转化为13位时间戳](https://help.fanruan.com/finebi/doc-view-1412.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DAY-日期中的日](https://help.fanruan.com/finebi/doc-view-1407.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DAYSOFMONTH-某月天数](https://help.fanruan.com/finebi/doc-view-1410.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DAYSOFQUARTER-某季度天数](https://help.fanruan.com/finebi/doc-view-1418.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DAYSOFYEAR-一年的天数](https://help.fanruan.com/finebi/doc-view-1399.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DAYS360-天数差(360天)](https://help.fanruan.com/finebi/doc-view-1405.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DAYVALUE-天数（1900起）](https://help.fanruan.com/finebi/doc-view-1413.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [HOUR-小时数](https://help.fanruan.com/finebi/doc-view-1416.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LUNAR-农历日期](https://help.fanruan.com/finebi/doc-view-1408.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MINUTE-分钟数](https://help.fanruan.com/finebi/doc-view-1409.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MONTH-日期中的月份](https://help.fanruan.com/finebi/doc-view-1398.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MONTHDELTA-返回后几个月日期](https://help.fanruan.com/finebi/doc-view-1401.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [NOW-当前时间](https://help.fanruan.com/finebi/doc-view-1415.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [QUARTER-季度](https://help.fanruan.com/finebi/doc-view-1424.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SECOND-秒数](https://help.fanruan.com/finebi/doc-view-1423.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TIME-时间](https://help.fanruan.com/finebi/doc-view-1422.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TODAY-当前日期](https://help.fanruan.com/finebi/doc-view-1421.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TODATE-转换为日期类型](https://help.fanruan.com/finebi/doc-view-1406.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WEEK-求周数](https://help.fanruan.com/finebi/doc-view-1419.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WEEKDATE-指定周周几日期](https://help.fanruan.com/finebi/doc-view-1404.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WEEKDAY-星期数](https://help.fanruan.com/finebi/doc-view-1420.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [YEAR-返回年份](https://help.fanruan.com/finebi/doc-view-1400.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [YEARDELTA-某日期后几年](https://help.fanruan.com/finebi/doc-view-1417.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [常用日期公式](https://help.fanruan.com/finebi/doc-view-1326.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 当前日期、月末、年月偏移、日期转换 |
+
+### 数值函数（31 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [数值函数概述](https://help.fanruan.com/finebi/doc-view-5.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [MAX-返回最大值](https://help.fanruan.com/finebi/doc-view-1431.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TRUNC-返回指定位数](https://help.fanruan.com/finebi/doc-view-1433.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TAN-正切值](https://help.fanruan.com/finebi/doc-view-1452.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SQRT-计算一个非负数的算术平方根](https://help.fanruan.com/finebi/doc-view-1427.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SIGN-返回数字的符号](https://help.fanruan.com/finebi/doc-view-1437.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SIN-正弦值](https://help.fanruan.com/finebi/doc-view-1451.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [RANDBETWEEN-返回两个数相同整数部分](https://help.fanruan.com/finebi/doc-view-1435.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [RADIANS-将角度转换成弧度](https://help.fanruan.com/finebi/doc-view-1450.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [RAND-生成均匀分布的0-1之间的随机数](https://help.fanruan.com/finebi/doc-view-1426.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [PROMOTION-返回value2在value1上提升的比例](https://help.fanruan.com/finebi/doc-view-1440.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [PI-一个数学常量](https://help.fanruan.com/finebi/doc-view-1448.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [POWER-返回指定数字的乘幂](https://help.fanruan.com/finebi/doc-view-1449.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MOD-返回两数相除的余数](https://help.fanruan.com/finebi/doc-view-1439.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MIN-返回最小值](https://help.fanruan.com/finebi/doc-view-1432.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LN-返回一个数的自然对数](https://help.fanruan.com/finebi/doc-view-1436.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LOG10-返回以10为底的对数](https://help.fanruan.com/finebi/doc-view-1428.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [LOG-返回数值的对数](https://help.fanruan.com/finebi/doc-view-1430.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [FLOOR-向下取整](https://help.fanruan.com/finebi/doc-view-1429.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [FACT-返回数的阶乘](https://help.fanruan.com/finebi/doc-view-1434.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [EXP-返回e的n次幂](https://help.fanruan.com/finebi/doc-view-1441.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DEGREES-将弧度转化为度](https://help.fanruan.com/finebi/doc-view-1447.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [COS-余弦值](https://help.fanruan.com/finebi/doc-view-1446.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [CEILING-向上取整](https://help.fanruan.com/finebi/doc-view-1438.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ATAN2-返回x、y坐标的反正切值](https://help.fanruan.com/finebi/doc-view-1445.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ATAN-计算指定数值的反正切值](https://help.fanruan.com/finebi/doc-view-1444.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ASIN-反正弦值](https://help.fanruan.com/finebi/doc-view-1443.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ACOS-反余弦值](https://help.fanruan.com/finebi/doc-view-1442.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ABS-绝对值](https://help.fanruan.com/finebi/doc-view-1378.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [INT](https://help.fanruan.com/finebi/doc-view-1380.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [ROUND-保留几位小数](https://help.fanruan.com/finebi/doc-view-1379.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+
+### 聚合函数（12 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [聚合函数概述](https://help.fanruan.com/finebi/doc-view-4.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [SUM_AGG-求和](https://help.fanruan.com/finebi/doc-view-1385.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MAX_AGG-最大值](https://help.fanruan.com/finebi/doc-view-1390.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MIN_AGG-最小值](https://help.fanruan.com/finebi/doc-view-1389.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [AVG_AGG-平均值](https://help.fanruan.com/finebi/doc-view-1393.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [COUNT_AGG-计数](https://help.fanruan.com/finebi/doc-view-1386.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [COUNTD_AGG-去重计数](https://help.fanruan.com/finebi/doc-view-1388.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [VAR_AGG-方差](https://help.fanruan.com/finebi/doc-view-1392.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [STDEV_AGG-标准差](https://help.fanruan.com/finebi/doc-view-1394.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [MEDIAN_AGG-中位数](https://help.fanruan.com/finebi/doc-view-1391.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [PERCENTILE_AGG-百分位数](https://help.fanruan.com/finebi/doc-view-1395.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [APPROX_COUNTD_AGG-近似去重计数](https://help.fanruan.com/finebi/doc-view-1396.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+
+### 分析函数（34 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [DEF类函数概述](https://help.fanruan.com/finebi/doc-view-1993.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [DEF(指定维度)](https://help.fanruan.com/finebi/doc-view-1986.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DEF_ADD(分析区域维度+指定维度)](https://help.fanruan.com/finebi/doc-view-1987.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DEF_SUB(分析区域维度-指定维度)](https://help.fanruan.com/finebi/doc-view-1990.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [EARLIER-获取当前行的值（只用于DEF类函数）](https://help.fanruan.com/finebi/doc-view-1991.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [CLEAN函数-清除所有过滤效果（只用于DEF类函数）](https://help.fanruan.com/finebi/doc-view-2407.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [CLEAN_WIDGET函数-清除组件过滤效果（只用于DEF类函数）](https://help.fanruan.com/finebi/doc-view-2408.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WINDOW窗口函数概述-跨行计算](https://help.fanruan.com/finebi/doc-view-2470.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [WINDOW_AVG-跨行求平均](https://help.fanruan.com/finebi/doc-view-2472.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WINDOW_SUM-跨行求和/求累计](https://help.fanruan.com/finebi/doc-view-2477.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WINDOW_MAX-跨行求最大值](https://help.fanruan.com/finebi/doc-view-2473.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WINDOW_MIN-跨行求最小值](https://help.fanruan.com/finebi/doc-view-2474.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WINDOW_STDEV-跨行求标准差](https://help.fanruan.com/finebi/doc-view-2475.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [WINDOW_VAR-跨行求方差](https://help.fanruan.com/finebi/doc-view-2476.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [RANK_AGG-按指定规则排名](https://help.fanruan.com/finebi/doc-view-2478.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [FIXED](https://help.fanruan.com/finebi/doc-view-2770.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [EXCLUDE](https://help.fanruan.com/finebi/doc-view-2771.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [INCLUDE](https://help.fanruan.com/finebi/doc-view-2772.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [DEF函数应用合集](https://help.fanruan.com/finebi/doc-view-2173.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | DEF 业务场景分解与粒度选择 |
+| [DEF类函数使用须知](https://help.fanruan.com/finebi/doc-view-2549.html) | [formula-help-boundaries](formula-help-boundaries.md) | DEF 嵌套、视图回连及数据编辑步骤复杂度 |
+| [求移动平均](https://help.fanruan.com/finebi/doc-view-2230.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 三行移动平均，确认月份连续与窗口不足 |
+| [计算同一列不同时间的时间差](https://help.fanruan.com/finebi/doc-view-2546.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 唯一序号定位上一行，时间戳还原与空值保护 |
+| [数据编辑中按指定规则进行排序](https://help.fanruan.com/finebi/doc-view-2548.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | DEF 构建固定视图后执行 RANK_AGG |
+| [逐月展示前三个月销售额](https://help.fanruan.com/finebi/doc-view-2221.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 前两行加当前行销售额合计，按年月排序 |
+| [用户购买频次分析](https://help.fanruan.com/finebi/doc-view-2043.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 按客户固定购买次数，按次数分桶去重客户 |
+| [同期群分析](https://help.fanruan.com/finebi/doc-view-2046.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 固定首购日期，首购年份构成同期群 |
+| [跨行计算-计算增长率](https://help.fanruan.com/finebi/doc-view-2048.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 固定基准年销售额，明确基准过滤与分母 |
+| [目标达成情况分解](https://help.fanruan.com/finebi/doc-view-2050.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 省份产品粒度算目标差额，再统计达标产品占比 |
+| [用户消费周期](https://help.fanruan.com/finebi/doc-view-2070.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 首末消费跨度与次数；区分跨度/次数和平均相邻间隔 |
+| [月盈利天数统计](https://help.fanruan.com/finebi/doc-view-2080.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 按天聚合利润后打标签，按月去重统计日期 |
+| [对月累计值求年同比](https://help.fanruan.com/finebi/doc-view-2085.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | EARLIER 定位本年/上年累计月份后求同比 |
+| [销售额对比分析](https://help.fanruan.com/finebi/doc-view-2091.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 组件参数选定品类，独立基准金额与各类金额比较 |
+| [不同地区经营状况对比](https://help.fanruan.com/finebi/doc-view-2092.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 地区加门店粒度，对店总额和交易统计再比较 |
+| [动态展示前N名](https://help.fanruan.com/finebi/doc-view-886.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 排名加组件参数过滤，明确并列与比例取整 |
+
+### 引用函数（5 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [ADD_DIM(引用维度+指定维度)](https://help.fanruan.com/finebi/doc-view-2623.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SUB_DIM(引用维度-指定维度)](https://help.fanruan.com/finebi/doc-view-2624.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [FIELD_IN(判断数组是否属于)](https://help.fanruan.com/finebi/doc-view-2638.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [动态层级维度成本分析](https://help.fanruan.com/finebi/doc-view-2643.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | FIELD_IN 检查员工维度，切换个人/公司成本 |
+| [自定义合计行计算规则](https://help.fanruan.com/finebi/doc-view-2649.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 自动合计按自身视图重算，保留明细并定制合计 |
+
+### 逻辑函数（9 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [逻辑函数概述](https://help.fanruan.com/finebi/doc-view-9.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [IF](https://help.fanruan.com/finebi/doc-view-1377.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [AND](https://help.fanruan.com/finebi/doc-view-1383.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [IN](https://help.fanruan.com/finebi/doc-view-2188.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [NOT](https://help.fanruan.com/finebi/doc-view-2189.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [OR](https://help.fanruan.com/finebi/doc-view-1384.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [Switch-多条件赋值](https://help.fanruan.com/finebi/doc-view-360.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [IF函数的嵌套用法](https://help.fanruan.com/finebi/doc-view-2510.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | IF 与 AND/OR/IN 组合分类 |
+| [无穷/负数/空值显示为0](https://help.fanruan.com/finebi/doc-view-1111.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 空值、零分母、负数分别处理，维持结果类型 |
+
+### 其他函数（4 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [其他函数概述](https://help.fanruan.com/finebi/doc-view-10.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [ISNULL-判断是否为空](https://help.fanruan.com/finebi/doc-view-1478.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [NVL](https://help.fanruan.com/finebi/doc-view-1479.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [IFERROR-处理异常值](https://help.fanruan.com/finebi/doc-view-2324.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+
+### 快速计算函数（7 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [快速计算函数概述](https://help.fanruan.com/finebi/doc-view-1499.html) | [formula-functions](formula-functions.md) | 函数族用途、位置；限制配合使用边界阅读 |
+| [ACC_SUM-累计](https://help.fanruan.com/finebi/doc-view-1214.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [PERIOD_ANLS-上期末](https://help.fanruan.com/finebi/doc-view-1210.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [PREVIOUS_PERIOD-环期](https://help.fanruan.com/finebi/doc-view-1213.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [RANK_ANLS-排名](https://help.fanruan.com/finebi/doc-view-1216.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [SAME_PERIOD-同期](https://help.fanruan.com/finebi/doc-view-1212.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+| [TOTAL-汇总](https://help.fanruan.com/finebi/doc-view-1215.html) | [formula-functions](formula-functions.md) | 函数签名、返回语义和示例；重载与引擎差异查使用边界 |
+
+### 函数综合应用（16 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [数据清洗整合运算概述](https://help.fanruan.com/finebi/doc-view-1318.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 数据清洗、整合、运算按输入类型与目标输出选择 |
+| [拼接不同列数据](https://help.fanruan.com/finebi/doc-view-1143.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 多列拼接，保留文本类型及分隔符 |
+| [截取多次出现的指定字符后的内容](https://help.fanruan.com/finebi/doc-view-1092.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 多次分隔符定位，末段/倒数段提取 |
+| [截取字段中的指定字符](https://help.fanruan.com/finebi/doc-view-878.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 分隔符前后和两分隔符之间的截取 |
+| [字段清洗](https://help.fanruan.com/finebi/doc-view-1867.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 会计金额清币符千分位和括号负号，再转数值 |
+| [日期与字符串相互转化](https://help.fanruan.com/finebi/doc-view-1346.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 秒/毫秒时间戳和年月日文本的显式转换 |
+| [巧用 IF 函数处理数据](https://help.fanruan.com/finebi/doc-view-1315.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 先处理缺失日期，条件分类与类型保持 |
+| [查找不同列字段中的重复数据](https://help.fanruan.com/finebi/doc-view-1482.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | EXACT 做逐行两列比较，不等于跨行去重 |
+| [判断字段中是否包含某字符串](https://help.fanruan.com/finebi/doc-view-896.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | FIND>0 判断包含，显式输出数值标签 |
+| [去除字符串里面的某些字符](https://help.fanruan.com/finebi/doc-view-820.html) | [formula-recipes-text-date](formula-recipes-text-date.md) | 按位置删除括号片段，双引号转义 |
+| [条件求和与计数](https://help.fanruan.com/finebi/doc-view-1329.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | IF 置空后条件去重计数、IF 置零后求和 |
+| [指标卡实现展示总计值和最大值](https://help.fanruan.com/finebi/doc-view-1513.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 指标卡总计、展示二次计算及跨组去重口径 |
+| [计算年累计额同比](https://help.fanruan.com/finebi/doc-view-1170.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 年内累计与去年同期累计，按年分组避免跨年串算 |
+| [计算累计平均值](https://help.fanruan.com/finebi/doc-view-606.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 窗口首行到当前行平均，显式指定时间排序 |
+| [为表格添加序号](https://help.fanruan.com/finebi/doc-view-1128.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 显示序号与可计算累计序号分开选择 |
+| [求前n天平均值/数据不唯一条件下求平均](https://help.fanruan.com/finebi/doc-view-1163.html) | [formula-recipes-analysis](formula-recipes-analysis.md) | 前 n 天均值区分缺日、重复日期及日粒度分母 |
+
+### 函数常见问题（5 篇）
+
+| 原文 | 蒸馏落点 | 查阅内容 |
+|---|---|---|
+| [自定义函数简介](https://help.fanruan.com/finebi/doc-view-13.html) | [formula-troubleshooting](formula-troubleshooting.md) | 抽取 Java 标量自定义函数，不支持自定义聚合 |
+| [自定义函数实现字符串拼接](https://help.fanruan.com/finebi/doc-view-1244.html) | [formula-troubleshooting](formula-troubleshooting.md) | StringCat 部署示例、注册与多节点生效边界 |
+| [常用函数语法FAQ](https://help.fanruan.com/finebi/doc-view-1323.html) | [formula-troubleshooting](formula-troubleshooting.md) | 字段选择、日期类型、混用、记录数与公式位置 FAQ |
+| [运算符和不合法报错](https://help.fanruan.com/finebi/doc-view-1287.html) | [formula-troubleshooting](formula-troubleshooting.md) | 操作符参数类型、函数签名、错误码与过时条目裁决 |
+| [公式不合法原因排查](https://help.fanruan.com/finebi/doc-view-849.html) | [formula-troubleshooting](formula-troubleshooting.md) | 语法、字符、聚合嵌套、直接输出与指标条件排查 |

package/skills/finebi-cli-agent/references/formula-parameters-aggregate.md

@@ -0,0 +1,143 @@
+# 聚合与表格计算参数详解
+
+聚合的输入是明细表达式，表格计算的输入是聚合结果，两者不能交换。`array` 是官方参数名，通常传字段或行级公式，不代表必须写字面数组 `[字段]`。目标位置/引擎需同时核对 [使用边界](formula-help-boundaries.md)。
+
+## 1. 聚合函数
+
+以下函数随当前分析维度分组；放入 DEF 时由 DEF 的维度决定计算粒度。参数要求“非聚合表达式”意味着不能直接套 `SUM_AGG(SUM_AGG(...))`。单函数页未说明的空组返回值不作推断。
+
+### SUM_AGG
+
+`SUM_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1385.html)
+
+- `array`：必需的一个非聚合表达式，可为指标字段、维度或字段与普通函数的计算结果；用于数值求和。
+- 官方位置为组件计算字段；自助数据集公式列不能裸用聚合函数。`SUM_AGG(${金额}/${数量})` 是逐条相除后求和，与两项分别聚合后相除含义不同。
+
+### AVG_AGG
+
+`AVG_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1393.html)
+
+- `array`：必需的一个非聚合表达式；直连明确要求数值类型。返回组内明细值的平均值，不是对各组已求好的平均值再平均。
+
+### COUNT_AGG
+
+`COUNT_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1386.html)
+
+- `array`：必需的一个任意非聚合表达式；直连支持任意类型。统计该表达式的**非空**值数量。
+- 统计全部记录传常量 `1`，即 `COUNT_AGG(1)`；不省略参数，不将 `COUNT_AGG(${字段})` 无条件视为总行数。
+
+### COUNTD_AGG
+
+`COUNTD_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1388.html)
+
+- `array`：必需的一个非聚合表达式，可为字段或行级公式；直连允许任意类型。统计非空值的去重个数，空值不计入。
+
+### APPROX_COUNTD_AGG
+
+`APPROX_COUNTD_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1396.html)
+
+- `array`：必需的一个任意类型非聚合表达式，返回近似去重个数；无精度或误差率参数。
+- 仅部分直连数据库支持，白名单见 [数据库限制](formula-help-boundaries.md#2-数据库与标量函数限制)。Redshift 对同一查询涉及多个有序聚合字段有限制；Vertica 不能同时使用精确与近似去重计数。
+
+### MAX_AGG
+
+`MAX_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1390.html)
+
+- `array`：必需的一个非聚合表达式；非数值字段按单函数页仅支持在 DEF 内使用。直连参数类型表允许任意类型，仍需满足具体位置限制。
+- 数值时间戳取最大后转回日期，可使用 `TODATE(MAX_AGG(DATETONUMBER(${日期})))`。
+
+### MIN_AGG
+
+`MIN_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1389.html)
+
+- `array`：必需的一个非聚合表达式，可为字段或行级公式；直连支持任意类型。返回当前组最小值。原文未重复 MAX_AGG 的非数值 DEF 限制，不将两者限制自动视为相同。
+
+### VAR_AGG
+
+`VAR_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1392.html)
+
+- `array`：必需的一个非聚合表达式；直连要求数值。返回组内方差。
+- 原文没有样本/总体切换参数，也未细述分母口径，统计业务需以目标实例结果确认，不自加第二参。
+
+### STDEV_AGG
+
+`STDEV_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1394.html)
+
+- `array`：必需的一个非聚合表达式，用于标准差计算；直连参数表写为任意类型，生成时仍优先数值表达式。
+- 原文明确对应 Excel `STDEV.P`，即总体标准差；无样本/总体第二参数。
+
+### MEDIAN_AGG
+
+`MEDIAN_AGG(array)` · [原文](https://help.fanruan.com/finebi/doc-view-1391.html)
+
+- `array`：必需的一个**数值**非聚合表达式，不支持日期或文本。返回中位数。
+- 官方限定仪表板/组件使用；MySQL 不支持。
+
+### PERCENTILE_AGG
+
+`PERCENTILE_AGG(array, percentile)` · [原文](https://help.fanruan.com/finebi/doc-view-1395.html)
+
+- `array`：数值非聚合表达式，不能为文本或日期。
+- `percentile`：**数值常量**，范围 **[0,1]**，包含端点。例如 95% 分位写 `0.95`，不是 `95` 或 `"95%"`；不可用行字段代替常量。两参均必需。
+- 6.1.4 起支持抽取；直连白名单见使用边界。MaxCompute/Hive 输入限整数字段；Redshift 同时进行有序聚合时须使用同一字段。原文说明非恰好落点时使用插值。
+
+## 2. 表格计算
+
+这组函数在分析结果行上运算，`metric` 必须是聚合函数表达式或聚合指标。`range` 的“组内”由视图分组决定，不是另一个数组参数；日期类根据分析区日期分组决定周期。原文未明确可选的参数应显式填写。
+
+### ACC_SUM
+
+`ACC_SUM(metric, range)` · [原文](https://help.fanruan.com/finebi/doc-view-1214.html)
+
+- `metric`：待累计的聚合指标，如 `SUM_AGG(${买入}-${卖出})`，不能裸传明细指标。
+- `range`：数值范围码，`0` 对所有行累计，`1` 在组内累计。原文未声明默认值，显式传 0/1。
+- 依视图行顺序累计，日期累计需先确认日期粒度和排序。
+
+### TOTAL
+
+`TOTAL(metric, range, agg)` · [原文](https://help.fanruan.com/finebi/doc-view-1215.html)
+
+- `metric`：待跨行汇总的聚合指标。
+- `range`：数值，`0` 所有行，`1` 组内所有行。
+- `agg`：文本汇总规则，`"sum"` 求和、`"avg"` 求平均、`"max"` 最大值、`"min"` 最小值，大小写不敏感。
+- 原文两参示例以求和解释，但参数表未完整声明省略契约；生成时显式填写第三参以固定口径。它汇总视图行结果，不能假定与明细重新聚合完全等价。
+
+### RANK_ANLS
+
+`RANK_ANLS(metric, range, order)` · [原文](https://help.fanruan.com/finebi/doc-view-1216.html)
+
+- `metric`：参与排名的聚合指标。
+- `range`：数值，`0` 所有行排名，`1` 组内排名。
+- `order`：文本，`"asc"` 升序、`"desc"` 降序，大小写不敏感。
+- 第二、三参不支持 IF、SWITCH 等动态表达式；原文未声明默认值，显式提供常量。没有 RANK_AGG 的第四种排名模式参数，不自行追加 DENSE 等参数。
+
+### PREVIOUS_PERIOD
+
+`PREVIOUS_PERIOD(metric)` · [原文](https://help.fanruan.com/finebi/doc-view-1213.html)
+
+- `metric`：唯一且必需的聚合指标，返回上一周期的指标值，不直接返回环比增长率。
+- 没有日期字段或偏移量参数；周期来自分析区日期分组，支持年、年季度、年月日、年月、年周数。日分组取上一日，年月分组取上一月。
+
+### SAME_PERIOD
+
+`SAME_PERIOD(metric, datepart)` · [原文](https://help.fanruan.com/finebi/doc-view-1212.html)
+
+- `metric`：必需的聚合指标。
+- `datepart`：必需文本，`"Y"` 上年同期、`"M"` 上月同期、`"W"` 上周同期，大小写不敏感。日视图的 M 是上月同日，不是上年同月。
+- 分析区支持年季度、年月日、年月、年周数；视图日期字段不满足要求会标红。返回基期值，要增长率还需另算差值或比值。
+
+### PERIOD_ANLS
+
+`PERIOD_ANLS(metric, datepart)` · [原文](https://help.fanruan.com/finebi/doc-view-1210.html)
+
+- `metric`：必需的聚合指标。
+- `datepart`：必需文本，`"Y"` 上年期末、`"M"` 上月期末、`"W"` 上周期末，大小写不敏感，**不支持 Q**。
+- 分析区日期支持年季度、年月日、年月、年周数，但“支持年季度视图”不等于支持 Q 参数。月视图取上年末、日视图取上月末均须满足对应视图粒度。
+
+### PERIOD_TD（实例补充）
+
+`PERIOD_TD(metric, datepart)` 来自本项目既有 Direct 实例参考，本次官方专题未找到独立参数页。
+
+- `metric`：用于期间累计比较的聚合指标。
+- `datepart`：既有参考的 `"Y"` 为累计同比、`"M"` 为累计环比；Y 需分析区年、年月字段，M 需年月、年月日字段。
+- 具体支持范围、返回口径和可选参数以目标面板为准；不要因为 SAME_PERIOD 支持 W 就给此函数添加 W。