feat: [6598098782] Modify doc.

Author: Simon9997

docs/en/05-basic/03-query.md

@@ -171,7 +171,7 @@ window_clause: {
 When using the window clause, the following rules should be observed. These rules apply to the five window types SESSION, STATE_WINDOW, INTERVAL, EVENT_WINDOW, and COUNT_WINDOW. EXTERNAL_WINDOW has different rules; see the [External Window](#external-window) section for details.
 
 1. The window clause is located after the data partitioning clause and cannot be used together with the GROUP BY clause.
-1. The window clause partitions the data by windows and performs calculations on the expressions in the SELECT list for each window. The expressions in the SELECT list can only include: constants; pseudocolumns: \_wstart pseudo-column,\_wend pseudo-column, and \_wduration pseudo-column; aggregate functions (including selection functions and time-series specific functions that can determine the number of output rows by parameters)
+1. The window clause partitions the data by windows and performs calculations on the expressions in the SELECT list for each window. The expressions in the SELECT list can only include: constants; pseudocolumns: \_wstart pseudo-column,\_wend pseudo-column, and \_wduration pseudo-column; aggregate functions (including selection functions, time-series specific functions whose output row count is determined by parameters, and window calculation / time-weighted statistics functions among the time-series specific functions)
 1. WHERE statements can specify the start and end times of the query and other filtering conditions.
 
 :::

docs/en/14-reference/03-taos-sql/22-function.md

@@ -2790,7 +2790,7 @@ LAG(expr, offset[, default_val])
 - `default_val` must be type-compatible with `expr`.
 - `LAG` is evaluated on the row order of the input result set; you can use `ORDER BY` to change the evaluation order.
 - It can be used together with `_rowts`, `tbname`, tag columns, and also in subqueries and `PARTITION BY` scenarios.
-- Window queries are not supported, such as `INTERVAL`, `SESSION`, and `STATE_WINDOW`.
+- When used with a window clause, `LAG` is evaluated only within the current window in window-local row order and does not carry state across windows.
 
 ### LEAD
 
@@ -2813,7 +2813,7 @@ LEAD(expr, offset[, default_val])
 - `default_val` must be type-compatible with `expr`.
 - `LEAD` is evaluated on the row order of the input result set; you can use `ORDER BY` to change the evaluation order.
 - It can be used together with `_rowts`, `tbname`, tag columns, and also in subqueries and `PARTITION BY` scenarios.
-- Window queries are not supported, such as `INTERVAL`, `SESSION`, and `STATE_WINDOW`.
+- When used with a window clause, `LEAD` is evaluated only within the current window in window-local row order and does not read rows from the next window.
 
 ### MAX
 
@@ -3135,6 +3135,7 @@ MAVG(expr, k)
 
 - Does not support +, -, *, / operations, such as mavg(col1, k1) + mavg(col2, k1);
 - Can only be used with regular columns, selection, and projection functions, not with aggregation functions;
+- When used with a window clause, `MAVG` is calculated only from samples inside the current window and does not continue state across windows.
 
 ### STATECOUNT
 
@@ -3159,7 +3160,7 @@ STATECOUNT(expr, oper, val)
 
 **Usage Notes**:
 
-- Cannot be used with window operations, such as interval/state_window/session_window.
+- When used with a window clause, `STATECOUNT` counts consecutive records only inside the current window and does not accumulate across windows.
 
 ### STATEDURATION
 
@@ -3185,7 +3186,7 @@ STATEDURATION(expr, oper, val, unit)
 
 **Usage Notes**:
 
-- Cannot be used with window operations, such as interval/state_window/session_window.
+- When used with a window clause, `STATEDURATION` measures continuous duration only inside the current window and does not accumulate across windows.
 
 ### TWA
 

docs/en/14-reference/03-taos-sql/24-distinguished.md

@@ -67,7 +67,7 @@ The following rules apply to the five window types SESSION, STATE_WINDOW, INTERV
 - The window clause divides the data by windows and calculates the expressions in the SELECT list for each window. The expressions in the SELECT list can only include:
   - Constants.
   - Pseudocolumns _wstart,_wend, and _wduration.
-  - Aggregate functions (including selection functions and time-series specific functions that can determine the number of output rows by parameters).
+  - Aggregate functions (including selection functions, time-series specific functions whose output row count is determined by parameters, and window calculation / time-weighted statistics functions among the time-series specific functions).
   - Expressions containing the above expressions.
   - And must include at least one aggregate function(this limitation no longer exists after version 3.4.0.0).
 - The window clause cannot be used together with the GROUP BY clause.

docs/zh/05-basic/03-query.md

@@ -170,7 +170,7 @@ window_clause: {
 **注意** 在使用窗口子句时应注意以下规则（以下规则适用于 SESSION、STATE_WINDOW、INTERVAL、EVENT_WINDOW、COUNT_WINDOW 五种窗口，EXTERNAL_WINDOW 的规则有所不同，详见[外部窗口](#外部窗口)章节）：
 
 1. 窗口子句位于数据切分子句之后，不可以和 GROUP BY 子句一起使用。
-2. 窗口子句将数据按窗口进行切分，对每个窗口进行 SELECT 列表中的表达式的计算，SELECT 列表中的表达式只能包含：常量；伪列：_wstart、_wend 和 _wduration；聚合函数：包括选择函数和可以由参数确定输出行数的时序特有函数。
+2. 窗口子句将数据按窗口进行切分，对每个窗口进行 SELECT 列表中的表达式的计算，SELECT 列表中的表达式只能包含：常量；伪列：_wstart、_wend 和 _wduration；聚合函数：包括选择函数、可以由参数确定输出行数的时序特有函数，以及时序函数中的窗口计算和时间加权统计函数。
 3. WHERE 语句可以指定查询的起止时间和其他过滤条件。
 
 ### 时间戳伪列

docs/zh/14-reference/03-taos-sql/22-function.md

@@ -2369,11 +2369,11 @@ LAG(expr, offset[, default_val])
 **使用说明**：
 
 - `offset` 必须为大于 0 的整数。
-- `default_val` 可选；当目标行不存在时返回该值，未指定时返回 `NULL`。
-- `default_val` 需要与 `expr` 类型兼容。
-- `LAG` 按输入结果集的行序计算；可以结合 `ORDER BY` 改变计算顺序。
-- 支持与 `_rowts`、`tbname`、标签列等一起查询，也支持在子查询和 `PARTITION BY` 场景中使用。
-- 不支持窗口查询（例如 `INTERVAL`、`SESSION`、`STATE_WINDOW` 等）。
+- `default_val` 可选；当目标行不存在时返回该值，未指定时返回 `NULL`。
+- `default_val` 需要与 `expr` 类型兼容。
+- `LAG` 按输入结果集的行序计算；可以结合 `ORDER BY` 改变计算顺序。
+- 支持与 `_rowts`、`tbname`、标签列等一起查询，也支持在子查询和 `PARTITION BY` 场景中使用。
+- 与窗口一起使用时，`LAG` 仅在当前窗口内部按窗口内结果顺序计算，不会跨窗口继承上一窗口的状态。
 
 #### LEAD
 
@@ -2392,11 +2392,11 @@ LEAD(expr, offset[, default_val])
 **使用说明**：
 
 - `offset` 必须为大于 0 的整数。
-- `default_val` 可选；当目标行不存在时返回该值，未指定时返回 `NULL`。
-- `default_val` 需要与 `expr` 类型兼容。
-- `LEAD` 按输入结果集的行序计算；可以结合 `ORDER BY` 改变计算顺序。
-- 支持与 `_rowts`、`tbname`、标签列等一起查询，也支持在子查询和 `PARTITION BY` 场景中使用。
-- 不支持窗口查询（例如 `INTERVAL`、`SESSION`、`STATE_WINDOW` 等）。
+- `default_val` 可选；当目标行不存在时返回该值，未指定时返回 `NULL`。
+- `default_val` 需要与 `expr` 类型兼容。
+- `LEAD` 按输入结果集的行序计算；可以结合 `ORDER BY` 改变计算顺序。
+- 支持与 `_rowts`、`tbname`、标签列等一起查询，也支持在子查询和 `PARTITION BY` 场景中使用。
+- 与窗口一起使用时，`LEAD` 仅在当前窗口内部按窗口内结果顺序计算，不会跨窗口读取下一窗口的数据。
 
 #### MAX
 
@@ -3155,10 +3155,11 @@ MAVG(expr, k)
 
 **适用于**：表和超级表。
 
-**使用说明**：
-
-- 不支持 +、-、*、/ 运算，如 mavg(col1, k1) + mavg(col2, k1);
-- 只能与普通列，选择（Selection）、投影（Projection）函数一起使用，不能与聚合（Aggregation）函数一起使用；
+**使用说明**：
+
+- 不支持 +、-、*、/ 运算，如 mavg(col1, k1) + mavg(col2, k1);
+- 只能与普通列，选择（Selection）、投影（Projection）函数一起使用，不能与聚合（Aggregation）函数一起使用；
+- 与窗口一起使用时，`MAVG` 仅在当前窗口内部按样本顺序计算，不会跨窗口延续上一窗口的样本状态。
 
 #### STATECOUNT
 
@@ -3181,9 +3182,9 @@ STATECOUNT(expr, oper, val)
 
 **适用于**：表和超级表。
 
-**使用说明**：
-
-- 不能和窗口操作一起使用，例如 `interval/state_window/session_window`。
+**使用说明**：
+
+- 与窗口一起使用时，`STATECOUNT` 仅统计当前窗口内部的连续记录，不会跨窗口累计。
 
 #### STATEDURATION
 
@@ -3207,9 +3208,9 @@ STATEDURATION(expr, oper, val, unit)
 
 **适用于**：表和超级表。
 
-**使用说明**：
-
-- 不能和窗口操作一起使用，例如 interval、state_window、session_window。
+**使用说明**：
+
+- 与窗口一起使用时，`STATEDURATION` 仅统计当前窗口内部满足条件的连续时长，不会跨窗口累计。
 
 ### 时间加权统计
 

docs/zh/14-reference/03-taos-sql/24-distinguished.md

@@ -69,7 +69,7 @@ window_clause: {
 - 窗口子句将数据按窗口进行切分，对每个窗口进行 SELECT 列表中的表达式的计算，SELECT 列表中的表达式只能包含：
   - 常量。
   - _wstart 伪列、_wend 伪列和_wduration 伪列。
-  - 聚集函数（包括选择函数和可以由参数确定输出行数的时序特有函数）。
+  - 聚集函数（包括选择函数、可以由参数确定输出行数的时序特有函数，以及时序函数中的窗口计算和时间加权统计函数）。
   - 包含上面表达式的表达式。
   - 且至少包含一个聚集函数 (3.4.0.0 之后不再有该限制)。
 - 窗口子句不可以和 GROUP BY 子句一起使用。