@wagemule/daemon 0.1.2 → 0.1.4

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-cell-style-and-merge.md

@@ -0,0 +1,141 @@
+# Sheets Cell Style and Merge
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总单元格样式和合并相关操作：
+
+- `+set-style`
+- `+batch-set-style`
+- `+merge-cells`
+- `+unmerge-cells`
+
+<a id="set-style"></a>
+## `+set-style`
+
+对应命令：`lark-cli sheets +set-style`
+
+对指定范围设置字体、颜色、对齐、边框等样式。
+
+```bash
+lark-cli sheets +set-style --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:C3" \
+  --style '{"font":{"bold":true},"backColor":"#ff0000"}'
+
+lark-cli sheets +set-style --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:Z100" --style '{"clean":true}'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 单元格范围 |
+| `--sheet-id` | 否 | 工作表 ID（用于相对范围） |
+| `--style` | 是 | 样式 JSON 对象 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+常用 `style` 字段：
+
+- `font.bold`
+- `font.italic`
+- `font.font_size`
+- `textDecoration`
+- `formatter`
+- `hAlign`
+- `vAlign`
+- `foreColor`
+- `backColor`
+- `borderType`
+- `borderColor`
+- `clean`
+
+输出：`updates`（updatedRange / updatedRows / updatedColumns / updatedCells / revision）
+
+<a id="batch-set-style"></a>
+## `+batch-set-style`
+
+对应命令：`lark-cli sheets +batch-set-style`
+
+对多个范围批量设置不同样式。
+
+```bash
+lark-cli sheets +batch-set-style --spreadsheet-token "shtxxxxxxxx" \
+  --data '[{"ranges":["<sheetId>!A1:C3"],"style":{"font":{"bold":true},"backColor":"#21d11f"}},{"ranges":["<sheetId>!D1:F3"],"style":{"foreColor":"#ff0000"}}]'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--data` | 是 | JSON 数组，每项包含 `ranges` 和 `style` |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `totalUpdatedRows`
+- `totalUpdatedColumns`
+- `totalUpdatedCells`
+- `revision`
+- `responses[]`
+
+<a id="merge-cells"></a>
+## `+merge-cells`
+
+对应命令：`lark-cli sheets +merge-cells`
+
+支持三种模式：
+
+- `MERGE_ALL`
+- `MERGE_ROWS`
+- `MERGE_COLUMNS`
+
+```bash
+lark-cli sheets +merge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2" --merge-type MERGE_ALL
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 单元格范围 |
+| `--sheet-id` | 否 | 工作表 ID（用于相对范围） |
+| `--merge-type` | 是 | `MERGE_ALL` / `MERGE_ROWS` / `MERGE_COLUMNS` |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`spreadsheetToken`
+
+<a id="unmerge-cells"></a>
+## `+unmerge-cells`
+
+对应命令：`lark-cli sheets +unmerge-cells`
+
+用于拆分合并单元格。
+
+```bash
+lark-cli sheets +unmerge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2"
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 单元格范围 |
+| `--sheet-id` | 否 | 工作表 ID（用于相对范围） |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`spreadsheetToken`
+
+## 参考
+
+- [cell-data](lark-sheets-cell-data.md) — 数据读写
+- [cell-images](lark-sheets-cell-images.md) — 写入单元格图片

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-dropdown.md

@@ -0,0 +1,133 @@
+# Sheets Dropdown
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总下拉列表配置：
+
+- `+set-dropdown`
+- `+update-dropdown`
+- `+get-dropdown`
+- `+delete-dropdown`
+
+> **关键规则：** 使用 `multipleValue` 写入前，必须先设置下拉列表；否则值会被当成纯文本。
+
+<a id="set-dropdown"></a>
+## `+set-dropdown`
+
+对应命令：`lark-cli sheets +set-dropdown`
+
+```bash
+lark-cli sheets +set-dropdown --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --range "<sheetId>!A2:A100" --condition-values '["选项1", "选项2", "选项3"]'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 范围（如 `<sheetId>!A2:A100`） |
+| `--condition-values` | 是 | 下拉选项 JSON 数组 |
+| `--multiple` | 否 | 是否多选 |
+| `--highlight` | 否 | 是否着色 |
+| `--colors` | 否 | 颜色 JSON 数组 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`code`、`msg`
+
+<a id="update-dropdown"></a>
+## `+update-dropdown`
+
+对应命令：`lark-cli sheets +update-dropdown`
+
+```bash
+lark-cli sheets +update-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" \
+  --ranges '["<sheetId>!A1:A100"]' \
+  --condition-values '["选项A", "选项B"]'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--ranges` | 是 | 范围 JSON 数组 |
+| `--condition-values` | 是 | 选项 JSON 数组 |
+| `--multiple` | 否 | 是否多选 |
+| `--highlight` | 否 | 是否着色 |
+| `--colors` | 否 | 颜色 JSON 数组 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`spreadsheetToken`、`sheetId`、`dataValidation`
+
+<a id="get-dropdown"></a>
+## `+get-dropdown`
+
+对应命令：`lark-cli sheets +get-dropdown`
+
+```bash
+lark-cli sheets +get-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A2:A100"
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 查询范围 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `dataValidations[].conditionValues`
+- `dataValidations[].ranges`
+- `dataValidations[].options.multipleValues`
+- `dataValidations[].options.highlightValidData`
+- `dataValidations[].options.colorValueMap`
+
+<a id="delete-dropdown"></a>
+## `+delete-dropdown`
+
+对应命令：`lark-cli sheets +delete-dropdown`
+
+```bash
+lark-cli sheets +delete-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --ranges '["<sheetId>!A2:A100", "<sheetId>!C1:C50"]'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--ranges` | 是 | 范围 JSON 数组 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：
+
+- `rangeResults[].range`
+- `rangeResults[].success`
+- `rangeResults[].updatedCells`
+
+## 典型流程
+
+```bash
+# 1. 配置下拉
+lark-cli sheets +set-dropdown --url "<url>" \
+  --range "<sheetId>!J2:J100" --condition-values '["选项1","选项2"]' --multiple
+
+# 2. 再写入 multipleValue
+lark-cli sheets +write --url "<url>" --sheet-id "<sheetId>" --range "J2" \
+  --values '[[{"type":"multipleValue","values":["选项1","选项2"]}]]'
+```
+
+## 参考
+
+- [cell-data](lark-sheets-cell-data.md#write) — 写入普通单元格数据

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-filter-views.md

@@ -0,0 +1,193 @@
+# Sheets Filter Views
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总筛选视图和筛选条件：
+
+- `+create-filter-view`
+- `+update-filter-view`
+- `+list-filter-views`
+- `+get-filter-view`
+- `+delete-filter-view`
+- `+create-filter-view-condition`
+- `+update-filter-view-condition`
+- `+list-filter-view-conditions`
+- `+get-filter-view-condition`
+- `+delete-filter-view-condition`
+
+<a id="create-filter-view"></a>
+## `+create-filter-view`
+
+对应命令：`lark-cli sheets +create-filter-view`
+
+在工作表中创建筛选视图，每个工作表最多 150 个。
+
+```bash
+lark-cli sheets +create-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "<sheetId>!A1:H14"
+
+lark-cli sheets +create-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "<sheetId>!A1:H14" --filter-view-name "我的筛选"
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--range` | 是 | 筛选范围 |
+| `--filter-view-name` | 否 | 显示名称 |
+| `--filter-view-id` | 否 | 自定义 10 位字母数字 ID |
+
+输出：`filter_view`
+
+<a id="update-filter-view"></a>
+## `+update-filter-view`
+
+对应命令：`lark-cli sheets +update-filter-view`
+
+```bash
+lark-cli sheets +update-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --range "<sheetId>!A1:J20"
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--range` | 否 | 新范围 |
+| `--filter-view-name` | 否 | 新显示名称 |
+
+<a id="list-filter-views"></a>
+## `+list-filter-views`
+
+对应命令：`lark-cli sheets +list-filter-views`
+
+```bash
+lark-cli sheets +list-filter-views --spreadsheet-token "shtxxxxxxxx" --sheet-id "<sheetId>"
+```
+
+输出：`items[]`（`filter_view_id`、`filter_view_name`、`range`）
+
+<a id="get-filter-view"></a>
+## `+get-filter-view`
+
+对应命令：`lark-cli sheets +get-filter-view`
+
+```bash
+lark-cli sheets +get-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>"
+```
+
+输出：`filter_view`
+
+<a id="delete-filter-view"></a>
+## `+delete-filter-view`
+
+对应命令：`lark-cli sheets +delete-filter-view`
+
+```bash
+lark-cli sheets +delete-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>"
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+
+<a id="create-filter-view-condition"></a>
+## `+create-filter-view-condition`
+
+对应命令：`lark-cli sheets +create-filter-view-condition`
+
+为筛选视图的指定列创建筛选条件。
+
+```bash
+# 数值筛选：E 列 < 6
+lark-cli sheets +create-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" \
+  --condition-id "E" --filter-type "number" --compare-type "less" --expected '["6"]'
+
+# 文本筛选：G 列以 a 开头
+lark-cli sheets +create-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" \
+  --condition-id "G" --filter-type "text" --compare-type "beginsWith" --expected '["a"]'
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--condition-id` | 是 | 列字母，如 `E` |
+| `--filter-type` | 是 | `hiddenValue` / `number` / `text` / `color` |
+| `--compare-type` | 否 | 比较运算符 |
+| `--expected` | 是 | 筛选值 JSON 数组 |
+
+输出：`condition`
+
+<a id="update-filter-view-condition"></a>
+## `+update-filter-view-condition`
+
+对应命令：`lark-cli sheets +update-filter-view-condition`
+
+```bash
+lark-cli sheets +update-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --condition-id "E" \
+  --filter-type "number" --compare-type "between" --expected '["2","10"]'
+```
+
+参数与创建条件相同，但 `filter-type` / `compare-type` / `expected` 可按需部分更新。
+
+<a id="list-filter-view-conditions"></a>
+## `+list-filter-view-conditions`
+
+对应命令：`lark-cli sheets +list-filter-view-conditions`
+
+```bash
+lark-cli sheets +list-filter-view-conditions --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>"
+```
+
+输出：`items[]`
+
+<a id="get-filter-view-condition"></a>
+## `+get-filter-view-condition`
+
+对应命令：`lark-cli sheets +get-filter-view-condition`
+
+```bash
+lark-cli sheets +get-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --condition-id "E"
+```
+
+输出：`condition`
+
+<a id="delete-filter-view-condition"></a>
+## `+delete-filter-view-condition`
+
+对应命令：`lark-cli sheets +delete-filter-view-condition`
+
+```bash
+lark-cli sheets +delete-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --condition-id "E"
+```
+
+## 参考
+
+- [dropdown](lark-sheets-dropdown.md) — 需要下拉值配合筛选时
+- [cell-data](lark-sheets-cell-data.md#find) — 只查数据时用 `+find`

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-float-images.md

@@ -0,0 +1,125 @@
+# Sheets Float Images
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+这份 reference 汇总浮动图片相关能力：
+
+- `+media-upload`
+- `+create-float-image`
+- `+update-float-image`
+- `+get-float-image`
+- `+list-float-images`
+- `+delete-float-image`
+
+<a id="media-upload"></a>
+## `+media-upload`
+
+对应命令：`lark-cli sheets +media-upload`
+
+把本地图片上传到指定电子表格的素材空间，返回 `file_token`，供 `+create-float-image` 使用。
+
+```bash
+lark-cli sheets +media-upload --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --file ./image.png
+```
+
+说明：
+
+- 内部调用 `drive/v1/medias/upload_all`
+- `>20MB` 自动分片上传
+- `--file` 只能是当前工作目录下的相对路径
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--file` | 是 | 本地图片路径，必须是相对路径 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+输出：`file_token`、`file_name`、`size`、`spreadsheet_token`
+
+<a id="create-float-image"></a>
+## `+create-float-image`
+
+对应命令：`lark-cli sheets +create-float-image`
+
+```bash
+lark-cli sheets +create-float-image --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --float-image-token "boxcnXXXX" \
+  --range "<sheetId>!A1:A1" --width 200 --height 150
+```
+
+关键规则：
+
+- `--float-image-token` 必须来自 `+media-upload`
+- `--range` 必须锚定单个单元格
+- `width` / `height` 必须 `>=20`
+- `offset-x` / `offset-y` 必须 `>=0`
+
+输出：`float_image`
+
+<a id="update-float-image"></a>
+## `+update-float-image`
+
+对应命令：`lark-cli sheets +update-float-image`
+
+```bash
+lark-cli sheets +update-float-image --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --float-image-id "fi12345678" \
+  --width 400 --height 300 --offset-y 20
+```
+
+至少需要传一个更新字段：`--range` / `--width` / `--height` / `--offset-x` / `--offset-y`
+
+输出：更新后的 `float_image`
+
+<a id="get-float-image"></a>
+## `+get-float-image`
+
+对应命令：`lark-cli sheets +get-float-image`
+
+```bash
+lark-cli sheets +get-float-image --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --float-image-id "fi12345678"
+```
+
+输出：`float_image`
+
+<a id="list-float-images"></a>
+## `+list-float-images`
+
+对应命令：`lark-cli sheets +list-float-images`
+
+```bash
+lark-cli sheets +list-float-images --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>"
+```
+
+输出：`items[]`
+
+<a id="delete-float-image"></a>
+## `+delete-float-image`
+
+对应命令：`lark-cli sheets +delete-float-image`
+
+```bash
+lark-cli sheets +delete-float-image --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --float-image-id "fi12345678"
+```
+
+输出：`code`、`msg`
+
+## 读取图片内容
+
+上述读接口只返回元数据，不返回图片字节。要读取图片内容，用 `float_image_token` 调：
+
+```bash
+lark-cli docs +media-preview --token "<float_image_token>" --output ./image.png
+```
+
+## 参考
+
+- [cell-images](lark-sheets-cell-images.md) — 写入到单元格的图片
+- [spreadsheet-management](lark-sheets-spreadsheet-management.md#info) — 先获取 `sheet_id`

package/dist/skills/larksuite/lark-sheets/references/lark-sheets-formula.md

@@ -0,0 +1,88 @@
+# 飞书表格公式规则
+
+> 生成或改写飞书电子表格公式时的参考规则。飞书不像 Excel 365 默认 spill，普通公式对区域默认“投影”（只取当前行/列对应的单值），必须显式使用 `ARRAYFORMULA` 或原生数组函数才能逐项展开。
+
+## 写入方式
+
+公式必须使用对象格式写入（参见 SKILL.md「单元格数据类型」）：
+
+```bash
+--values '[[{"type":"formula","text":"=SUM(A1:A10)"}]]'
+```
+
+## ARRAYFORMULA 判断流程
+
+1. 结果是**标量**（单值）→ 不需要
+2. 结果是**数组**，且公式中**有**原生数组函数 → 不需要（数组语义自动传播）
+3. 结果是**数组**，且公式中**无**原生数组函数，对区域做标量计算 → 加 `ARRAYFORMULA`
+
+```text
+# 有原生数组函数，无需包裹
+=FILTER(A2:A10,B2:B10="x")+1          ✓
+=XLOOKUP(E2:E10,A2:A10,B2:B10)*100    ✓
+=MAP(A2:A10,LAMBDA(x,x*2))-1          ✓
+
+# 无原生数组函数，必须包裹
+=ARRAYFORMULA(A2:A100*B2:B100)         ✓
+=ARRAYFORMULA(IF(A2:A100>0,B2:B100,""))✓
+```
+
+## 原生数组函数清单（无需 ARRAYFORMULA）
+
+`ARRAYFORMULA` `ARRAY_CONSTRAIN` `BYCOL` `BYROW` `CELL` `CHOOSECOLS` `CHOOSEROWS` `DROP` `EXPAND` `FILTER` `FLATTEN` `FREQUENCY` `GROWTH` `HSTACK` `IMPORTDATA` `IMPORTFEED` `IMPORTHTML` `IMPORTRANGE` `IMPORTXML` `LINEST` `LOGEST` `LOOKUP` `MAKEARRAY` `MAP` `MINVERSE` `MMULT` `MUNIT` `QUERY` `RANDARRAY` `REDUCE` `REGEXEXTRACT` `SCAN` `SEQUENCE` `SORT` `SORTBY` `SORTN` `SPLIT` `SUMPRODUCT` `SWITCH` `TAKE` `TEXTSPLIT` `TOCOL` `TOROW` `TRANSPOSE` `TREND` `UNIQUE` `VSTACK` `WRAPCOLS` `WRAPROWS` `XLOOKUP`
+
+## 高风险函数：INDEX / OFFSET / ROW / COLUMN / MATCH
+
+行号/列号/偏移量本身是数组时，必须显式包裹：
+
+```text
+=ARRAYFORMULA(INDEX(...))
+=ARRAYFORMULA(ROW(...))
+```
+
+例外：结果直接交给聚合函数消费时不需要：`=SUM(INDEX(A1:B2,0,1))` ✓
+
+## 隐式逐项求值 → MAP/LAMBDA
+
+Excel 中 `SUBTOTAL`、`INDIRECT`、`OFFSET` 等在 `SUMPRODUCT` 内会隐式逐行求值，飞书不会。用 `MAP` 显式遍历：
+
+```text
+# Excel
+=SUMPRODUCT(SUBTOTAL(103,INDIRECT("E"&ROW($E$16:$E$387))))
+
+# 飞书
+=SUMPRODUCT(MAP(ARRAYFORMULA(ROW($E$16:$E$387)),LAMBDA(r,SUBTOTAL(103,INDIRECT("E"&r)))))
+```
+
+同类场景：`SUMIF/COUNTIF/SUMIFS` 的范围参数来自 `INDIRECT/OFFSET` 时也需要 `MAP`。
+
+## 多维结果降维
+
+飞书公式结果只能是二维，不能返回“区域的列表”。合并多个区域时：
+
+| 需求 | 写法 |
+|------|------|
+| 上下堆叠 | `=VSTACK(a, b, c)` |
+| 左右拼接 | `=HSTACK(a, b, c)` |
+| 压成单列 | `=TOCOL(...)` |
+| 压成单行 | `=TOROW(...)` |
+| 归约为标量 | `=REDUCE(init, arr, LAMBDA(acc, x, ...))` |
+
+## 日期差
+
+| 需求 | 正确写法 | 错误写法 |
+|------|---------|---------|
+| 天数差 | `=DAYS(B2,A2)` 或 `=DATEDIF(A2,B2,"D")` 或 `=B2-A2` | `=DAY(B2-A2)` |
+| 月份差 | `=DATEDIF(A2,B2,"M")` | `=MONTH(B2-A2)` |
+| 年份差 | `=DATEDIF(A2,B2,"Y")` | `=YEAR(B2-A2)` |
+| 工作日差 | `=NETWORKDAYS(A2,B2)` | — |
+
+## 飞书不支持的 Excel 语法
+
+| Excel 语法 | 飞书替代 |
+|-----------|---------|
+| `=@A1:A10`（隐式交叉） | `=A1:A10`（飞书默认投影，去掉 `@`） |
+| `=A1#`（spill range） | 改成明确范围，或用 `TAKE`/`DROP`/`ARRAY_CONSTRAIN` |
+| `=SUM(Table1[Amount])`（结构化引用） | `=SUM(A2:A100)`（改为 A1 区域） |
+| `{=A1:A10*B1:B10}`（CSE 花括号） | `=ARRAYFORMULA(A1:A10*B1:B10)` |
+| `STOCKHISTORY` / `WEBSERVICE` / `CUBE*` | 飞书无等价函数 |