Skip to content

Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-smartpage

wecomcli-smartpage

Verified

何时用:企业微信智能文档/智能主页/smartpage 相关诉求(含 doc.weixin.qq.com/smartpage/ 或 page.weixin.qq.com/smartpage/ 链接),或泛指「创建/写/整理文档」的企微诉求时使用;纯本地文档默认走本地工具。能力:新建/导入(.md)、读取、修改内容(整页重写/局部编辑/增删子页面)、上传附件、搭建带看板/图表的数据系统页面与信息收集表单、获取内置智能表格。

references/formula/arraylist.md

View on GitHub
# 数组/列表公式函数(`AT`, `CHOOSE`, `CONTAINS`, `CONTAINSALL`, `CONTAINSONLY`, `FILTER`, `FIRST`, `LAST`, `LIST`, `LISTCOMBINE`, `LISTJOIN`, `LOOKUP`, `UNIQUE`)

> 用于对数据进行筛选、过滤、提取、合并、去重等操作,适用于数据统计、关联查询、列表处理等场景。

---

## AT - 获取列表指定位置元素

**表达式**: `列表.AT(位置)`

**函数说明**: 返回列表里面第N个位置的元素

**参数说明**:

- 列表:可以是数据表.字段、或一系列值
- 位置:要返回的值的位置(从 1 开始)。正数,表示从左往右第 N 个值;负数,表示从右往左第 N 个值。

**示例**:

```
LIST(1,2,3,4).AT(2)  =>  2  //返回列表 [1,2,3,4] 中的从左往右第2个元素
LIST("智","能","表","格").AT(-2) =>  表 //返回列表  ["智","能","表","格"] 中从右往左第2个元素
```

---

## CHOOSE - 根据索引选择

**表达式**: `CHOOSE(索引号,选择1,[选择2],...)`

**函数说明**: 根据索引号从选择列表中返回对应需要执行的值或操作

**参数说明**:

- 索引号:必需,指定选择列表中某个选择对应的位置。索引号必须是1到254之间的数字
- 选择1:必需,参数可以是一个字段,也可以是列表,也可以是数据表.字段
- 选择2:可选,其他可选择的值,最多可以支持254个选择

**示例**:

```
CHOOSE(3,"Hello"," ","World") => World
```

---

## CONTAINS - 包含任一判断

**表达式**: `查找范围.CONTAINS([值1,值2,...])`

**函数说明**: 判断查找范围中是否包含任一要查找的内容

**参数说明**:

- 查找范围:必填,查找的范围,可以是多个值也可以是一个值
- 值:要查找的内容,可以是多个值也可以是一个值

**限制**:

- CONTAINS只支持同类型比较。

通过文本筛选人员字段:
[反例]: [表.人员字段].FILTER([Each].CONTAINS("zhangsan")).FIRST()
[正例]: [表.人员字段].FILTER([Each].CONTAINTEXT("zhangsan")).FIRST() // CONTAINTEXT 支持人员通过文本形式筛选
[正例]: [表.人员字段].FILTER([Each].CONTAINS(USER())).FIRST() // USER() 返回的对象是user类型的,支持

**示例**:

```
[项目管理表.项目成员].CONTAINS([项目负责人]) // 判断 [项目管理表] 里面的 [项目成员] 整列内容中是否包含项目负责人中任意一个
[多选].CONTAINS("选项1","选项2") // 判断 [多选] 字段中是否包含"选项1"、"选项2"中的任意一个
LIST(1,2,3,4).CONTAINS(2,5) =>  TRUE   //在列表(1,2,3,4)中找是否包含2、5任意一个
LIST(1,2,3,4).CONTAINS(5,6,7) =>  FALSE  //在列表(1,2,3,4)中找是否包含5、6、7任意一个
```

---

## CONTAINSALL - 包含全部判断

**表达式**: `查找范围.CONTAINSALL([值1,值2,...])`

**函数说明**: 判断查找范围是否包含所有查找内容

**参数说明**:

- 查找范围:必填,查找的范围
- 值:要查找的内容

**示例**:

```
[项目成员].CONTAINSALL([项目负责人]) // 判断当前表里面的 [项目成员]字段中包含全部[项目负责人]
[多选].CONTAINSALL("选项1","选项2") // 判断[多选]字段中"选项1"和"选项2"是否都包含
LIST(1,2,3,4).CONTAINSALL(1,2)    =>  TRUE  // 1,2,3,4是否1,2都包含
LIST(1,2,3,4).CONTAINSALL(1,2,5)  =>  FALSE  // 1,2,3,4是否1,2,5都包含
```

---

## CONTAINSONLY - 仅包含判断

**表达式**: `查找范围.CONTAINSONLY([值1,值2,...])`

**函数说明**: 判断查找范围是否仅包含所有查找内容,不要求顺序一致

**参数说明**:

- 查找范围:必填,查找的范围
- 值:要查找的内容

**示例**:

```
[项目成员].CONTAINSONLY([项目负责人]) // 判断当前表里面的 [项目成员] 字段是否只包含[项目负责人]
[多选].CONTAINSONLY("选项1","选项2") // 判断 [多选] 字段中是否只包含"选项1"和"选项2"
LIST(1,2,3,4).CONTAINSONLY(1,2)    =>  FALSE  // 1,2,3,4是否只包含1,2
LIST(1,2,3,4).CONTAINSONLY(1,2,4,3)  => TRUE  // 1,2,3,4是否只包含1,2,4,3
```

---

## FILTER - 筛选函数

[警告] **必须使用 [Each] 引用**:在筛选条件中引用字段时,必须写成 `[Each].[字段名]`

**表达式**: `数据范围.FILTER(筛选条件)`

**函数说明**: 从数据范围中筛选出符合筛选条件的内容,需要通过 `[Each]` 进行逐一判断

**参数说明**:
- 数据范围:参与条件筛选的范围
- 筛选条件:取数据范围的值进行条件筛选,返回符合筛选条件的值

**示例**:

```
[正例] 正确写法:
[任务管理表].FILTER([Each].[启动时间]<TODAY()).[项目名称] =>项目名称1,项目名称3 // 找出 [启动时间] 今天之前的项目有哪些
LIST(1,2,3,4).FILTER([Each]>2)  =>  3,4  //查找列表 [1,2,3,4] 中大于2的值有为 3,4

[反例] 错误写法(会解析失败):
[任务管理表].FILTER([启动时间]<TODAY())  // 缺少 [Each]
```

### 基本筛选

[表名].FILTER([Each].[字段名] = 值).[字段]

- `[Each]` 表示当前遍历的行,在FILTER中取*表名*对应的字段,*必须*用到Each。
- 数据表中引用整表时,`FILTER`函数需要指定引用字段。

[反例]写法:
[表名].FILTER([Each].[字段名] = 值) // 未指定字段
[正例]写法:
[表名].FILTER([Each].[字段名] = 值).[字段]

**示例**:

```
// 筛选状态为"完成"的记录
[任务表].FILTER([Each].[状态] = "完成").[任务名称]

// 筛选金额大于1000的订单
[订单表].FILTER([Each].[金额] > 1000).[订单名称]

// 筛选日期在今天之后的任务
[任务表].FILTER([Each].[截止日期] > TODAY()).[任务名称]

// 引用其他表字段,与自己比较
// 统计表: 统计年份、成单金额汇总
// 成单表: 日期、成单金额
[成单表].FILTER(YEAR([Each].[日期]) = [统计年份]).[成单金额].SUM()
```

### 筛选后统计

[表名].FILTER([Each].[字段A] = 值).[字段B].SUM()

**示例**:

```
// 统计已完成任务的总金额
[任务表].FILTER([Each].[状态] = "完成").[金额].SUM()

// 统计优先级为高的任务数量
[任务表].FILTER([Each].[优先级] = "高").[任务名称].COUNTA()
```

### 多条件筛选(AND)

[表名].FILTER(AND([Each].[字段A] = 值1, [Each].[字段B] > 值2))

**示例**:

```
// 筛选已完成且金额大于1000的任务
[任务表].FILTER(AND([Each].[状态] = "完成", [Each].[金额] > 1000)).[金额].SUM()
```

### 多条件筛选(OR)

[表名].FILTER(OR([Each].[字段A] = 值1, [Each].[字段B] = 值2))

**示例**:

```
// 筛选优先级为高或紧急的任务
[任务表].FILTER(OR([Each].[优先级] = "高", [Each].[优先级] = "紧急"))
```

### 筛选条件引用当前行字段

[其他表].FILTER([Each].[字段] = [当前表字段])

**示例**:

```
// 统计另一个表中状态等于本表状态的记录总金额
[订单表].FILTER([Each].[状态] = [状态]).[金额].SUM()
```

### 访问关联记录内的字段

可以通过[关联字段]筛选条件。在公式中,关联字段默认代表关联表顺序第一个文本或日期或数字类型列。

**示例**:
// 学生表字段列表:姓名、年龄、所属班级(引用)
// 班级表字段列表:班级名、班级学生数量(公式)。
// 需求:需要统计所有班的学生。

// 班级学生数量(公式)
[学生表].FILTER([Each].[所属班级] = [班级名]).COUNTA()

---

## FIRST - 首个元素

**表达式**: `列表.FIRST()`

**函数说明**: 返回列表中的第一个元素

**参数说明**: 列表:可以是数据表.字段、或一系列值

**示例**:

```
LIST(1,2,3).FIRST()  => 1  //返回列表[1,2,3]中的第一个元素
LIST("智","能","表","格").FIRST()  =>  智  //返回列表 ["智","能","表","格"] 中的第一个元素
```

---

## LAST - 末尾元素

**表达式**: `列表.LAST()`

**函数说明**: 返回列表中的最后一个元素

**参数说明**: 列表:可以是数据表.字段、或一系列值

**示例**:

```
LIST(1,2,3).LAST()  => 3  //返回列表[1,2,3]中的最后一个元素
LIST("智","能","表","格").LAST()  =>  格  //返回列表 ["智","能","表","格"] 中的最后一个元素
```

---

## LIST - 创建列表

**表达式**: `LIST([值1,值2,...])`

**函数说明**: 返回一个列表

**参数说明**: 值:参与生成列表的内容

**示例**:

```
LIST([项目负责人],[项目成员]).LISTCOMBINE() => 返回项目总参与人的列表
LIST("智","能","表","格")  =>  [智,能,表,格] //返回列表 [智,能,表,格]
```

---

## LISTCOMBINE - 合并列表

**表达式**: `值1.LISTCOMBINE([值2,...])`

**函数说明**: 将多个列表合并为一个列表

**参数说明**: 字段:可以是一个字段,也可以是列表,也可以是数据表.字段

**示例**:

```
[项目管理表].[项目负责人].LISTCOMBINE([项目管理表].[部门负责人]) // 将项目负责人列表和部门负责人列表合并为一个列表。
LISTCOMBINE(LIST(1,2,LIST(3,4)),5,6)  =>  [1,2,3,4,5,6] //将嵌套列表 [1,2,[3,4]] 和常量5,6合并返回列表 [1,2,3,4,5,6]
```

---

## LISTJOIN - 列表拼接

**表达式**: `列表.LISTJOIN([分隔符])`

**函数说明**: 用分隔符拼接列表中的多个值

**参数说明**:

- 列表:必填,可以是数据表.字段、或一系列值
- 分隔符:用于拼接列表的值。自定义拼接符,不填写则默认是英文逗号

**示例**:

```
LIST(1,2,3,4).LISTJOIN()  =>   1,2,3,4 //将列表用 "," 拼接返回文本
LIST("智","能","表","格").LISTJOIN("-")   =>  智-能-表-格 //将列表用"-" 拼接返回文本
```

---

## LOOKUP - 查找

**表达式**: `LOOKUP(查找的值,匹配的值,返回的字段,[查找模式])`

**函数说明**: 在列表中查找符合条件的值

**参数说明**:

- 查找的值:要查找的值,当前表的字段,也可以手动输入
- 匹配的值:用来和查找值进行匹配的值,其他表的字段
- 返回的字段:条件匹配后返回结果的字段 ,和匹配的值是同一个表
- 查找模式:字段多选的时候,1代表拆分选项,0代表不拆分

**示例**:

```
LOOKUP([项目负责人],[人员信息表.姓名],[人员信息表.所属部门],1)=>部门1 //根据项目负责人 = 姓名,返回人员信息表中对应姓名的所属部门。
```

---

## UNIQUE - 去重

**表达式**: `值1.UNIQUE([值2,...])`

**函数说明**: 对列表中的数据进行去重

**参数说明**: 值:可以是多个值,也可以是数据表.字段,也可以是多个字段

**示例**:

```
[经营分析].[门店店员].UNIQUE()  => 返回去重后的门店店员
[经营分析].[门店店员].UNIQUE().COUNTA()  => 对店员列表去重后计数=店员人数
LIST(1,2,2,3,1).UNIQUE()  =>  [1,2,3]  //对列表 [1,2,2,3,1] 去重返回列表 [1,2,3]
```

**简化写法**:
[表名].[字段名].UNIQUE()

**示例**:

```
// 统计不重复的部门数量
[员工表.部门].UNIQUE().COUNTA()
```
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall