wecomcli-msg

Name: wecomcli-msg
Author: WecomTeam

2.5kstars172forks

How to install wecomcli-msg?

wecomteam/wecom-cli/wecomcli-msg

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

Installs into the current project.

Summary

企业微信消息技能。提供会话列表查询、消息记录拉取（支持文本/图片/文件/语音/视频）、多媒体文件获取和文本消息发送能力。当用户需要"查看消息"、"看聊天记录"、"发消息给某人"、"最近有什么消息"、"给群里发消息"、"看看发了什么图片/文件"时触发。

Files · 1

View on GitHub

SKILL.md

1	# 企业微信消息技能
2
3	> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。
4
5
6	通过 `wecom-cli msg <接口名> '<json入参>'` 与企业微信消息系统交互。
7
8	---
9
10	## 接口列表
11
12	### get_msg_chat_list — 获取会话列表
13
14	```bash
15	wecom-cli msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59"}'
16	```
17
18	按时间范围查询有消息的会话列表，支持分页。参见 [API 详情](references/get-msg-chat-list.md)。
19
20	### get_message — 拉取会话消息
21
22	```bash
23	wecom-cli msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'
24	```
25
26	根据会话类型和 ID 拉取指定时间范围内的消息记录，支持分页。支持 text/image/file/voice/video 消息类型，仅支持 7 天内。参见 [API 详情](references/get-message.md)。
27
28	### get_msg_media — 获取消息文件内容
29
30	```bash
31	wecom-cli msg get_msg_media '{"media_id": "MEDIAID_xxxxxx"}'
32	```
33
34	根据文件 ID 自动下载文件到本地，返回文件的本地路径（`local_path`）、名称、类型、大小及 MIME 类型。用于获取图片、文件、语音、视频等非文本消息的实际内容。参见 [API 详情](references/get-msg-media.md)。
35
36	### send_message — 发送文本消息
37
38	```bash
39	wecom-cli msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello world"}}'
40	```
41
42	向单聊或群聊发送文本消息。参见 [API 详情](references/send-message.md)。
43
44	---
45
46	## 核心规则
47
48	### 时间范围规则
49	- 格式：所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式
50	- 默认范围：用户未指定时，默认使用最近7天（当前时间往前推7天）
51	- 限制：开始时间不能早于当前时间的7天前，不能晚于当前时间
52	- 相对时间支持：支持"昨天"、"最近三天"等自动推算
53
54	### chatid查找规则
55	- 当用户提供人名或群名而非ID时：
56	1. 调用 `get_msg_chat_list` 获取会话列表（时间范围与目标查询一致）
57	2. 在 `chats` 中按 `chat_name` 匹配
58	3. 匹配策略：
59	- 精确匹配唯一结果：直接使用
60	- 模糊匹配多个结果：展示候选列表让用户选择
61	- 无匹配结果：告知用户未找到
62	- chat_type 判断：`get_msg_chat_list` 返回中不含会话类型字段，需根据上下文推断：用户明确提到「群」时使用 `chat_type=2`，否则默认 `chat_type=1`（单聊）
63
64	### userid 转 name
65	流程：
66	1. 调用 `wecomcli-contact` 技能的 `get_userlist` 获取用户列表
67	2. 建立 userid 到 name 的映射关系
68	3. 展示策略：
69	- 精确匹配：显示 name
70	- 无匹配：保持显示 userid
71
72	### 强制交互步骤（不可跳过）
73	以下步骤在涉及非文本消息下载时必须逐一执行，不得合并、省略或跳过，即使用户未主动询问也必须执行：
74	1. 必须主动告知文件位置：下载完成后必须立即向用户展示所有文件的完整路径和存放目录
75	2. 必须询问是否删除：告知位置后必须立即询问用户是否需要清理临时文件
76
77	---
78
79	## 典型工作流
80
81	### 查看会话列表
82	用户query示例：
83	- "看看我最近一周有哪些聊天"
84	- "这几天谁给我发过消息"
85
86	执行流程：
87	1. 确定时间范围（用户指定或默认最近7天）
88	2. 调用 `get_msg_chat_list` 获取会话列表
89	3. 展示会话名称、最后消息时间、消息数量
90	4. 若 `has_more` 为 `true`，告知用户还有更多会话可继续查看
91
92	### 查看聊天记录
93	用户query示例：
94	- "帮我看看和张三最近的聊天记录"
95	- "看看项目群里最近的消息"
96
97	执行流程：
98	1. 确定时间范围（用户指定或默认最近7天）
99	2. 通过 chatid查找规则确定目标会话的 `chatid` 和 `chat_type`
100	3. 调用 `get_message` 拉取消息列表
101	4. 调用 `wecomcli-contact` 技能的 `get_userlist` 获取通讯录，建立 userid→姓名映射
102	5. 统计非文本消息：遍历消息列表，统计 `msgtype` 非 `text` 的消息（image/file/voice/video）数量和类型
103	6. 展示消息时将 `userid` 替换为可读姓名，格式：
104	- 文本消息：`姓名 [时间]: 内容`
105	- 图片消息：`姓名 [时间]:[图片]`
106	- 文件消息：`姓名 [时间]:[文件] 文件名称`
107	- 语音消息：`姓名 [时间]:[语音] 语音内容`
108	- 视频消息：`姓名 [时间]:[视频]`
109	7. 非文本消息处理：展示完消息后，如果存在非文本消息：
110	- 主动询问是否下载：告知用户非文本消息数量和类型（如："以上聊天中包含 2 张图片、1 个文件，是否需要下载到本地？"）
111	- 用户确认后，逐个调用 `get_msg_media` 接口，接口会自动下载文件并返回 `local_path`
112	- 检查文件后缀：每个文件下载完成后，检查 `local_path` 对应的文件是否具有正确的后缀名：
113	- 根据 `get_msg_media` 返回的 `content_type`（MIME 类型）和 `name` 字段判断：
114	- 如果文件名缺少后缀（如 `screenshot` 而非 `screenshot.png`），根据 `content_type` 自动补上正确后缀（如 `image/png` → `.png`，`application/pdf` → `.pdf`，`audio/amr` → `.amr`，`video/mp4` → `.mp4`）
115	- 如果文件名后缀与 `content_type` 不一致，以 `content_type` 为准进行修正
116	- 补全或修正后缀后，将文件重命名为正确的文件名
117	- 确认文件可正常读取（文件大小 > 0），若文件为空或损坏则告知用户该文件下载异常
118	- ⚠️ 不要对下载的文件使用 `MEDIA:` 指令：这些文件是从聊天记录中下载的历史附件，仅需告知用户本地存放路径即可，严禁通过 `MEDIA:` 指令重新发送给用户
119	8. ⚠️ 必须主动告知文件位置（此步骤不可跳过）：所有文件下载并检查完成后，必须立即、主动以汇总形式向用户展示文件存放目录和每个文件的完整路径，不要等用户询问。示例：
120	> 📁 文件已下载到以下位置：
121	> - 图片：`xxx/yyy.png`
122	> - 文件：`xxx/yyy.pdf`
123	>
124	> 你可以在 `xxx/yyy/` 目录下找到所有下载的文件。
125	9. ⚠️ 必须询问是否删除（此步骤不可跳过）：告知文件位置后，必须立即、主动询问用户是否需要删除已下载的临时文件（如："如果不再需要这些文件，是否需要我帮你清理？"）
126	- 用户确认删除后，删除 `local_path` 对应的文件
127	- 用户不需要删除则保留文件
128	10. 若 `next_cursor` 不为空，告知用户还有更多消息可继续查看
129
130	### 发送消息
131	用户query示例：
132	- "帮我给张三发一条消息：明天会议改到下午3点"
133	- "在项目群里发一条消息：今天下午3点开会"
134
135	执行流程：
136	1. 通过 chatid查找规则确定目标会话的 `chatid` 和 `chat_type`
137	2. 发送前确认：向用户确认发送对象和内容（如："即将向张三发送：'明天会议改到下午3点'，确认发送吗？"），用户确认后再执行
138	3. 调用 `send_message` 发送（`msgtype` 固定为 `text`）
139	4. 展示发送结果
140
141	### 查看消息并回复
142	用户query示例：
143	- "看看张三给我发了什么，然后帮我回复收到"
144
145	执行流程：
146	1. 先执行"查看聊天记录"流程（复用已获取的 `chatid` 和 `chat_type`）
147	2. 展示消息后，执行"发送消息"流程（需确认后再发送）
148
149	---
150
151	## 错误处理
152	- 时间范围超限：告知用户7天限制并调整为有效范围
153	- 会话未找到：明确告知用户未找到对应会话
154	- API错误：展示具体错误信息，必要时重试
155	- 网络问题：HTTP错误时主动重试最多3次

People who liked this also viewed

6 picks

Type

wecomcli-msg

2.5kstars172forks

View on GitHub

How to install wecomcli-msg?

wecomteam/wecom-cli/wecomcli-msg

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 企业微信消息技能
2
3	> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。
4
5
6	通过 `wecom-cli msg <接口名> '<json入参>'` 与企业微信消息系统交互。
7
8	---
9
10	## 接口列表
11
12	### get_msg_chat_list — 获取会话列表
13
14	```bash
15	wecom-cli msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59"}'
16	```
17
18	按时间范围查询有消息的会话列表，支持分页。参见 [API 详情](references/get-msg-chat-list.md)。
19
20	### get_message — 拉取会话消息
21
22	```bash
23	wecom-cli msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'
24	```
25
26	根据会话类型和 ID 拉取指定时间范围内的消息记录，支持分页。支持 text/image/file/voice/video 消息类型，仅支持 7 天内。参见 [API 详情](references/get-message.md)。
27
28	### get_msg_media — 获取消息文件内容
29
30	```bash
31	wecom-cli msg get_msg_media '{"media_id": "MEDIAID_xxxxxx"}'
32	```
33
34	根据文件 ID 自动下载文件到本地，返回文件的本地路径（`local_path`）、名称、类型、大小及 MIME 类型。用于获取图片、文件、语音、视频等非文本消息的实际内容。参见 [API 详情](references/get-msg-media.md)。
35
36	### send_message — 发送文本消息
37
38	```bash
39	wecom-cli msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello world"}}'
40	```
41
42	向单聊或群聊发送文本消息。参见 [API 详情](references/send-message.md)。
43
44	---
45
46	## 核心规则
47
48	### 时间范围规则
49	- 格式：所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式
50	- 默认范围：用户未指定时，默认使用最近7天（当前时间往前推7天）
51	- 限制：开始时间不能早于当前时间的7天前，不能晚于当前时间
52	- 相对时间支持：支持"昨天"、"最近三天"等自动推算
53
54	### chatid查找规则
55	- 当用户提供人名或群名而非ID时：
56	1. 调用 `get_msg_chat_list` 获取会话列表（时间范围与目标查询一致）
57	2. 在 `chats` 中按 `chat_name` 匹配
58	3. 匹配策略：
59	- 精确匹配唯一结果：直接使用
60	- 模糊匹配多个结果：展示候选列表让用户选择
61	- 无匹配结果：告知用户未找到
62	- chat_type 判断：`get_msg_chat_list` 返回中不含会话类型字段，需根据上下文推断：用户明确提到「群」时使用 `chat_type=2`，否则默认 `chat_type=1`（单聊）
63
64	### userid 转 name
65	流程：
66	1. 调用 `wecomcli-contact` 技能的 `get_userlist` 获取用户列表
67	2. 建立 userid 到 name 的映射关系
68	3. 展示策略：
69	- 精确匹配：显示 name
70	- 无匹配：保持显示 userid
71
72	### 强制交互步骤（不可跳过）
73	以下步骤在涉及非文本消息下载时必须逐一执行，不得合并、省略或跳过，即使用户未主动询问也必须执行：
74	1. 必须主动告知文件位置：下载完成后必须立即向用户展示所有文件的完整路径和存放目录
75	2. 必须询问是否删除：告知位置后必须立即询问用户是否需要清理临时文件
76
77	---
78
79	## 典型工作流
80
81	### 查看会话列表
82	用户query示例：
83	- "看看我最近一周有哪些聊天"
84	- "这几天谁给我发过消息"
85
86	执行流程：
87	1. 确定时间范围（用户指定或默认最近7天）
88	2. 调用 `get_msg_chat_list` 获取会话列表
89	3. 展示会话名称、最后消息时间、消息数量
90	4. 若 `has_more` 为 `true`，告知用户还有更多会话可继续查看
91
92	### 查看聊天记录
93	用户query示例：
94	- "帮我看看和张三最近的聊天记录"
95	- "看看项目群里最近的消息"
96
97	执行流程：
98	1. 确定时间范围（用户指定或默认最近7天）
99	2. 通过 chatid查找规则确定目标会话的 `chatid` 和 `chat_type`
100	3. 调用 `get_message` 拉取消息列表
101	4. 调用 `wecomcli-contact` 技能的 `get_userlist` 获取通讯录，建立 userid→姓名映射
102	5. 统计非文本消息：遍历消息列表，统计 `msgtype` 非 `text` 的消息（image/file/voice/video）数量和类型
103	6. 展示消息时将 `userid` 替换为可读姓名，格式：
104	- 文本消息：`姓名 [时间]: 内容`
105	- 图片消息：`姓名 [时间]:[图片]`
106	- 文件消息：`姓名 [时间]:[文件] 文件名称`
107	- 语音消息：`姓名 [时间]:[语音] 语音内容`
108	- 视频消息：`姓名 [时间]:[视频]`
109	7. 非文本消息处理：展示完消息后，如果存在非文本消息：
110	- 主动询问是否下载：告知用户非文本消息数量和类型（如："以上聊天中包含 2 张图片、1 个文件，是否需要下载到本地？"）
111	- 用户确认后，逐个调用 `get_msg_media` 接口，接口会自动下载文件并返回 `local_path`
112	- 检查文件后缀：每个文件下载完成后，检查 `local_path` 对应的文件是否具有正确的后缀名：
113	- 根据 `get_msg_media` 返回的 `content_type`（MIME 类型）和 `name` 字段判断：
114	- 如果文件名缺少后缀（如 `screenshot` 而非 `screenshot.png`），根据 `content_type` 自动补上正确后缀（如 `image/png` → `.png`，`application/pdf` → `.pdf`，`audio/amr` → `.amr`，`video/mp4` → `.mp4`）
115	- 如果文件名后缀与 `content_type` 不一致，以 `content_type` 为准进行修正
116	- 补全或修正后缀后，将文件重命名为正确的文件名
117	- 确认文件可正常读取（文件大小 > 0），若文件为空或损坏则告知用户该文件下载异常
118	- ⚠️ 不要对下载的文件使用 `MEDIA:` 指令：这些文件是从聊天记录中下载的历史附件，仅需告知用户本地存放路径即可，严禁通过 `MEDIA:` 指令重新发送给用户
119	8. ⚠️ 必须主动告知文件位置（此步骤不可跳过）：所有文件下载并检查完成后，必须立即、主动以汇总形式向用户展示文件存放目录和每个文件的完整路径，不要等用户询问。示例：
120	> 📁 文件已下载到以下位置：
121	> - 图片：`xxx/yyy.png`
122	> - 文件：`xxx/yyy.pdf`
123	>
124	> 你可以在 `xxx/yyy/` 目录下找到所有下载的文件。
125	9. ⚠️ 必须询问是否删除（此步骤不可跳过）：告知文件位置后，必须立即、主动询问用户是否需要删除已下载的临时文件（如："如果不再需要这些文件，是否需要我帮你清理？"）
126	- 用户确认删除后，删除 `local_path` 对应的文件
127	- 用户不需要删除则保留文件
128	10. 若 `next_cursor` 不为空，告知用户还有更多消息可继续查看
129
130	### 发送消息
131	用户query示例：
132	- "帮我给张三发一条消息：明天会议改到下午3点"
133	- "在项目群里发一条消息：今天下午3点开会"
134
135	执行流程：
136	1. 通过 chatid查找规则确定目标会话的 `chatid` 和 `chat_type`
137	2. 发送前确认：向用户确认发送对象和内容（如："即将向张三发送：'明天会议改到下午3点'，确认发送吗？"），用户确认后再执行
138	3. 调用 `send_message` 发送（`msgtype` 固定为 `text`）
139	4. 展示发送结果
140
141	### 查看消息并回复
142	用户query示例：
143	- "看看张三给我发了什么，然后帮我回复收到"
144
145	执行流程：
146	1. 先执行"查看聊天记录"流程（复用已获取的 `chatid` 和 `chat_type`）
147	2. 展示消息后，执行"发送消息"流程（需确认后再发送）
148
149	---
150
151	## 错误处理
152	- 时间范围超限：告知用户7天限制并调整为有效范围
153	- 会话未找到：明确告知用户未找到对应会话
154	- API错误：展示具体错误信息，必要时重试
155	- 网络问题：HTTP错误时主动重试最多3次

People who liked this also viewed

6 picks

Type