wecomcli-smartsheet

Name: wecomcli-smartsheet
Author: WecomTeam

2.5kstars172forks

How to install wecomcli-smartsheet?

wecomteam/wecom-cli/wecomcli-smartsheet

$npx -y skills add WecomTeam/wecom-cli --skill wecomcli-smartsheet

Installs into the current project.

Summary

企业微信智能表格（smartsheet）管理技能。提供智能表格的新建（doc_type=10）、结构管理（子表、字段/列）和数据管理（记录增删改查）。适用场景：(1) 从零新建智能表格 (2) 管理智能表格子表和字段/列 (3) 查询、添加、更新、删除智能表格记录。支持通过 docid 或文档 URL 定位文档。当用户提到「企业微信智能表格」「智能表格」，或链接形如 https://doc.weixin.qq.com/smartsheet/xxx 时触发该技能。注意：普通文档（/doc/*）请用 wecomcli-doc；在线表格（`/she

Files · 1

View on GitHub

SKILL.md

1	# 企业微信智能表格管理
2
3	> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。
4
5	资源型技能，负责智能表格（`/smartsheet/*`，doc_type=10）的新建、结构（子表、字段/列）与数据（记录）管理。所有接口支持通过 `docid` 或 `url` 二选一定位文档。
6
7	## 调用方式
8
9	通过 `wecom-cli` 调用，品类为 `doc`：
10
11	```bash
12	wecom-cli doc <tool_name> '<json_params>'
13	```
14
15	> 智能表格各接口的 `docid`/`url` 二选一传入即可，以下示例以 `docid` 为主，URL 传入方式以此类推。
16
17	## 返回格式说明
18
19	所有接口返回 JSON 对象，包含以下公共字段：
20
21	\| 字段 \| 类型 \| 说明 \|
22	\|------\|------\|------\|
23	\| `errcode` \| integer \| 返回码，`0` 表示成功，非 `0` 表示失败 \|
24	\| `errmsg` \| string \| 错误信息，成功时为 `"ok"` \|
25
26	当 `errcode` 不为 `0` 时，说明接口调用失败，可重试 1 次；若仍失败，将 `errcode` 和 `errmsg` 展示给用户。
27
28	### 特殊错误码
29
30	\| errcode \| errmsg \| 含义 \| 处理方式 \|
31	\|---------\|--------\|------\|----------\|
32	\| `851002` \| `incompatible doc type` \| 文档品类与所调用的接口不匹配 \| 确认目标 URL 为 `/smartsheet/*`；若不是，请跳转到对应品类的 skill \|
33
34	## 接口路由表
35
36	> 硬规则：第二列是 `references/xxx.md` 链接的，命中这一行后先 `read` 对应 references 文件，再构造命令。写入/读取记录前，先用 `smartsheet_get_sheet` 拿到目标子表的 `sheet_id`，并用 `smartsheet_get_fields` 了解字段类型。
37
38	\| 用户意图 \| 参考位置 \|
39	\|---\|---\|
40	\| 从零新建智能表格（空白） \| 见下方「新建智能表格」 \|
41	\| 查询文档中所有子表 \| 见下方「查询子表」 \|
42	\| 添加 / 改名 / 删除子表 \| 见下方「子表管理」 \|
43	\| 查询子表字段/列 \| 见下方「查询字段」 \|
44	\| 添加字段/列 \| [references/smartsheet-field-types.md](references/smartsheet-field-types.md) \|
45	\| 改名 / 删除字段 \| 见下方「字段管理」 \|
46	\| 查询子表记录 \| [references/smartsheet-get-records.md](references/smartsheet-get-records.md) \|
47	\| 添加记录 / 更新记录 \| [references/smartsheet-cell-value-formats.md](references/smartsheet-cell-value-formats.md) \|
48	\| 删除记录 \| 见下方「删除记录」 \|
49
50	---
51
52	## 一、新建智能表格
53
54	### 新建智能表格
55
56	从零新建一篇企微智能表格（doc_type=10）：空白。创建成功后返回 `docid` 和 `url`。
57
58	命令
59
60	```bash
61	wecom-cli doc create_doc '<JSON 参数>'
62	```
63
64	参数
65
66	\| 参数 \| 类型 \| 必填 \| 默认值 \| 说明 \|
67	\|---\|---\|---\|---\|---\|
68	\| `doc_type` \| int \| 是 \| — \| 固定传 `10`（智能表格） \|
69	\| `doc_name` \| string \| 是 \| — \| 表格标题，最多 255 个字符，超过会被截断 \|
70
71	注意事项
72
73	- 新建智能表格文档默认已含一个子表，可通过 `smartsheet_get_sheet` 查询其 `sheet_id`，仅需多个子表时才调用 `smartsheet_add_sheet`。
74	- `docid` 仅在创建时返回，后续无法再获取，务必保存。
75
76	---
77
78	## 二、智能表格结构管理
79
80	### 查询子表
81
82	查询文档中所有子表信息，返回 `sheet_id`、`title`、类型等。
83
84	```bash
85	# 通过 docid 查询
86	wecom-cli doc smartsheet_get_sheet '{"docid": "DOCID"}'
87	# 通过 url 查询
88	wecom-cli doc smartsheet_get_sheet '{"url": "https://doc.weixin.qq.com/smartsheet/xxx"}'
89	```
90
91	### 子表管理
92
93	添加子表 —— 添加空子表。新子表不含视图、记录和字段，需通过其他接口补充。
94
95	```bash
96	wecom-cli doc smartsheet_add_sheet '{"docid": "DOCID", "properties": {"title": "新子表"}}'
97	```
98
99	> 注意：新建智能表格文档默认已含一个子表，仅需多个子表时调用。
100
101	修改子表标题 —— 需提供 `sheet_id` 和新 `title`。
102
103	```bash
104	wecom-cli doc smartsheet_update_sheet '{"docid": "DOCID", "properties":{"sheet_id":"SHEET_ID", "title":"新子表"}}'
105	```
106
107	删除子表 —— 永久删除子表，操作不可逆。
108
109	```bash
110	wecom-cli doc smartsheet_delete_sheet '{"docid": "DOCID", "sheet_id": "SHEETID"}'
111	```
112
113	### 查询字段
114
115	查询子表的所有字段信息，返回 `field_id`、`field_title`、`field_type`。
116
117	```bash
118	wecom-cli doc smartsheet_get_fields '{"docid": "DOCID", "sheet_id": "SHEETID"}'
119	```
120
121	### 字段管理
122
123	添加字段 —— 向子表添加一个或多个字段。单个子表最多 150 个字段。
124
125	```bash
126	wecom-cli doc smartsheet_add_fields '{"docid": "DOCID", "sheet_id": "SHEETID", "fields": [{"field_title": "任务名称", "field_type": "FIELD_TYPE_TEXT"}]}'
127	```
128
129	在添加字段前，请先参阅所有字段类型和定义 [字段类型参考](references/smartsheet-field-types.md)。
130
131	> 注意：如果是首次创建表并调用这个方法添加字段的情况下，调用本接口前，你必须确认已完成以下操作，否则会多出一个无用的默认列：
132	> 1. 已调用 `smartsheet_get_fields` 查看子表现有字段（新子表会自带一个默认文本字段）
133	> 2. 已调用 `smartsheet_update_fields` 将该默认字段重命名为你需要的第一个字段名，然后在本接口中只传入剩余的字段（不包含第一个字段）。
134
135	更新字段标题 —— 只能改名，不能改类型（`field_type` 必须传原始类型）。`field_title` 不能更新为原值。
136
137	```bash
138	wecom-cli doc smartsheet_update_fields '{"docid": "DOCID", "sheet_id": "SHEETID", "fields": [{"field_id": "FIELDID", "field_title": "新标题", "field_type": "FIELD_TYPE_TEXT"}]}'
139	```
140
141	删除字段 —— 删除一列或多列字段，操作不可逆。`field_id` 可通过 `smartsheet_get_fields` 获取。
142
143	```bash
144	wecom-cli doc smartsheet_delete_fields '{"docid": "DOCID", "sheet_id": "SHEETID", "field_ids": ["FIELDID"]}'
145	```
146
147	---
148
149	## 三、智能表格数据管理
150
151	### 查询记录
152
153	查询子表全部记录。
154
155	```bash
156	# 通过 docid
157	wecom-cli doc smartsheet_get_records '{"docid": "DOCID", "sheet_id": "SHEETID"}'
158	# 或通过 URL
159	wecom-cli doc smartsheet_get_records '{"url": "https://doc.weixin.qq.com/smartsheet/xxx", "sheet_id": "SHEETID"}'
160	```
161
162	参见 [API 详情](references/smartsheet-get-records.md)。
163
164	### 添加记录（不带图片或文件）
165
166	添加一行或多行记录，单次建议 500 行内。
167
168	调用前必须先了解目标表的字段类型（通过 `smartsheet_get_fields`），重点关注 `field_type`。对于单选/多选（Option）字段，需注意匹配已有选项的 `id`。
169
170	```bash
171	wecom-cli doc smartsheet_add_records '{"docid": "DOCID", "sheet_id": "SHEETID", "records": [{"values": {"任务名称": [{"type": "text", "text": "完成需求文档"}], "优先级": [{"text": "高"}]}}]}'
172	```
173
174	各字段类型的值格式参见 [单元格值格式参考](references/smartsheet-cell-value-formats.md)。
175
176	### 添加记录（带图片或文件）
177
178	添加一行或多行记录，单次建议 500 行内。与 `smartsheet_add_records

People who liked this also viewed

6 picks

Type

wecomcli-smartsheet

2.5kstars172forks

View on GitHub

How to install wecomcli-smartsheet?

wecomteam/wecom-cli/wecomcli-smartsheet

$npx -y skills add WecomTeam/wecom-cli --skill wecomcli-smartsheet

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 企业微信智能表格管理
2
3	> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。
4
5	资源型技能，负责智能表格（`/smartsheet/*`，doc_type=10）的新建、结构（子表、字段/列）与数据（记录）管理。所有接口支持通过 `docid` 或 `url` 二选一定位文档。
6
7	## 调用方式
8
9	通过 `wecom-cli` 调用，品类为 `doc`：
10
11	```bash
12	wecom-cli doc <tool_name> '<json_params>'
13	```
14
15	> 智能表格各接口的 `docid`/`url` 二选一传入即可，以下示例以 `docid` 为主，URL 传入方式以此类推。
16
17	## 返回格式说明
18
19	所有接口返回 JSON 对象，包含以下公共字段：
20
21	\| 字段 \| 类型 \| 说明 \|
22	\|------\|------\|------\|
23	\| `errcode` \| integer \| 返回码，`0` 表示成功，非 `0` 表示失败 \|
24	\| `errmsg` \| string \| 错误信息，成功时为 `"ok"` \|
25
26	当 `errcode` 不为 `0` 时，说明接口调用失败，可重试 1 次；若仍失败，将 `errcode` 和 `errmsg` 展示给用户。
27
28	### 特殊错误码
29
30	\| errcode \| errmsg \| 含义 \| 处理方式 \|
31	\|---------\|--------\|------\|----------\|
32	\| `851002` \| `incompatible doc type` \| 文档品类与所调用的接口不匹配 \| 确认目标 URL 为 `/smartsheet/*`；若不是，请跳转到对应品类的 skill \|
33
34	## 接口路由表
35
36	> 硬规则：第二列是 `references/xxx.md` 链接的，命中这一行后先 `read` 对应 references 文件，再构造命令。写入/读取记录前，先用 `smartsheet_get_sheet` 拿到目标子表的 `sheet_id`，并用 `smartsheet_get_fields` 了解字段类型。
37
38	\| 用户意图 \| 参考位置 \|
39	\|---\|---\|
40	\| 从零新建智能表格（空白） \| 见下方「新建智能表格」 \|
41	\| 查询文档中所有子表 \| 见下方「查询子表」 \|
42	\| 添加 / 改名 / 删除子表 \| 见下方「子表管理」 \|
43	\| 查询子表字段/列 \| 见下方「查询字段」 \|
44	\| 添加字段/列 \| [references/smartsheet-field-types.md](references/smartsheet-field-types.md) \|
45	\| 改名 / 删除字段 \| 见下方「字段管理」 \|
46	\| 查询子表记录 \| [references/smartsheet-get-records.md](references/smartsheet-get-records.md) \|
47	\| 添加记录 / 更新记录 \| [references/smartsheet-cell-value-formats.md](references/smartsheet-cell-value-formats.md) \|
48	\| 删除记录 \| 见下方「删除记录」 \|
49
50	---
51
52	## 一、新建智能表格
53
54	### 新建智能表格
55
56	从零新建一篇企微智能表格（doc_type=10）：空白。创建成功后返回 `docid` 和 `url`。
57
58	命令
59
60	```bash
61	wecom-cli doc create_doc '<JSON 参数>'
62	```
63
64	参数
65
66	\| 参数 \| 类型 \| 必填 \| 默认值 \| 说明 \|
67	\|---\|---\|---\|---\|---\|
68	\| `doc_type` \| int \| 是 \| — \| 固定传 `10`（智能表格） \|
69	\| `doc_name` \| string \| 是 \| — \| 表格标题，最多 255 个字符，超过会被截断 \|
70
71	注意事项
72
73	- 新建智能表格文档默认已含一个子表，可通过 `smartsheet_get_sheet` 查询其 `sheet_id`，仅需多个子表时才调用 `smartsheet_add_sheet`。
74	- `docid` 仅在创建时返回，后续无法再获取，务必保存。
75
76	---
77
78	## 二、智能表格结构管理
79
80	### 查询子表
81
82	查询文档中所有子表信息，返回 `sheet_id`、`title`、类型等。
83
84	```bash
85	# 通过 docid 查询
86	wecom-cli doc smartsheet_get_sheet '{"docid": "DOCID"}'
87	# 通过 url 查询
88	wecom-cli doc smartsheet_get_sheet '{"url": "https://doc.weixin.qq.com/smartsheet/xxx"}'
89	```
90
91	### 子表管理
92
93	添加子表 —— 添加空子表。新子表不含视图、记录和字段，需通过其他接口补充。
94
95	```bash
96	wecom-cli doc smartsheet_add_sheet '{"docid": "DOCID", "properties": {"title": "新子表"}}'
97	```
98
99	> 注意：新建智能表格文档默认已含一个子表，仅需多个子表时调用。
100
101	修改子表标题 —— 需提供 `sheet_id` 和新 `title`。
102
103	```bash
104	wecom-cli doc smartsheet_update_sheet '{"docid": "DOCID", "properties":{"sheet_id":"SHEET_ID", "title":"新子表"}}'
105	```
106
107	删除子表 —— 永久删除子表，操作不可逆。
108
109	```bash
110	wecom-cli doc smartsheet_delete_sheet '{"docid": "DOCID", "sheet_id": "SHEETID"}'
111	```
112
113	### 查询字段
114
115	查询子表的所有字段信息，返回 `field_id`、`field_title`、`field_type`。
116
117	```bash
118	wecom-cli doc smartsheet_get_fields '{"docid": "DOCID", "sheet_id": "SHEETID"}'
119	```
120
121	### 字段管理
122
123	添加字段 —— 向子表添加一个或多个字段。单个子表最多 150 个字段。
124
125	```bash
126	wecom-cli doc smartsheet_add_fields '{"docid": "DOCID", "sheet_id": "SHEETID", "fields": [{"field_title": "任务名称", "field_type": "FIELD_TYPE_TEXT"}]}'
127	```
128
129	在添加字段前，请先参阅所有字段类型和定义 [字段类型参考](references/smartsheet-field-types.md)。
130
131	> 注意：如果是首次创建表并调用这个方法添加字段的情况下，调用本接口前，你必须确认已完成以下操作，否则会多出一个无用的默认列：
132	> 1. 已调用 `smartsheet_get_fields` 查看子表现有字段（新子表会自带一个默认文本字段）
133	> 2. 已调用 `smartsheet_update_fields` 将该默认字段重命名为你需要的第一个字段名，然后在本接口中只传入剩余的字段（不包含第一个字段）。
134
135	更新字段标题 —— 只能改名，不能改类型（`field_type` 必须传原始类型）。`field_title` 不能更新为原值。
136
137	```bash
138	wecom-cli doc smartsheet_update_fields '{"docid": "DOCID", "sheet_id": "SHEETID", "fields": [{"field_id": "FIELDID", "field_title": "新标题", "field_type": "FIELD_TYPE_TEXT"}]}'
139	```
140
141	删除字段 —— 删除一列或多列字段，操作不可逆。`field_id` 可通过 `smartsheet_get_fields` 获取。
142
143	```bash
144	wecom-cli doc smartsheet_delete_fields '{"docid": "DOCID", "sheet_id": "SHEETID", "field_ids": ["FIELDID"]}'
145	```
146
147	---
148
149	## 三、智能表格数据管理
150
151	### 查询记录
152
153	查询子表全部记录。
154
155	```bash
156	# 通过 docid
157	wecom-cli doc smartsheet_get_records '{"docid": "DOCID", "sheet_id": "SHEETID"}'
158	# 或通过 URL
159	wecom-cli doc smartsheet_get_records '{"url": "https://doc.weixin.qq.com/smartsheet/xxx", "sheet_id": "SHEETID"}'
160	```
161
162	参见 [API 详情](references/smartsheet-get-records.md)。
163
164	### 添加记录（不带图片或文件）
165
166	添加一行或多行记录，单次建议 500 行内。
167
168	调用前必须先了解目标表的字段类型（通过 `smartsheet_get_fields`），重点关注 `field_type`。对于单选/多选（Option）字段，需注意匹配已有选项的 `id`。
169
170	```bash
171	wecom-cli doc smartsheet_add_records '{"docid": "DOCID", "sheet_id": "SHEETID", "records": [{"values": {"任务名称": [{"type": "text", "text": "完成需求文档"}], "优先级": [{"text": "高"}]}}]}'
172	```
173
174	各字段类型的值格式参见 [单元格值格式参考](references/smartsheet-cell-value-formats.md)。
175
176	### 添加记录（带图片或文件）
177
178	添加一行或多行记录，单次建议 500 行内。与 `smartsheet_add_records

People who liked this also viewed

6 picks

Type