wechat-automation-api

Name: wechat-automation-api
Author: LAVARONG

159stars40forks

How to install wechat-automation-api?

lavarong/wechat-automation-api/wechat-automation-api

$npx -y skills add LAVARONG/wechat-automation-api --skill wechat-automation-api

Installs into the current project.

Summary

微信发信能力：通过 Windows 桌面微信发送文本、图片URL或本地文件。适合各类 Agent 在本机直接发送一次性消息。触发词：给[某人]发微信、通知[某人]、把这个用微信发给[某人]、用微信发个图片、把本地文件发给[某人]

Files · 1

View on GitHub

SKILL.md

1	# 微信自动发信 Skill
2
3	赋予智能体掌控 Windows 桌面微信直接向真实用户或群组发送文本、图片URL或本地文件的能力。本 Skill 默认以同步命令行方式运行，执行一次命令发送一次消息，命令结束后立即退出。
4
5	只发送微信消息时，不需要专门启动后台 HTTP API，不需要运行 `run.bat`，也不需要调用 `scripts/app.py`。但如果后台 HTTP API 恰好已在运行，本 Skill 会自动改走 API 队列模式发送，以避免多个请求同时直接操作微信窗体造成冲突，详见下文「执行模式与结果判定」。
6
7	## 应用场景
8
9	- 信息推送：当你作为智能体完成了某项长耗时的搜索、总结或生图任务后，可以将最终结果或报告链接直接通过微信发送给用户指定的联系人。
10	- 定时催办/打卡通知：结合智能体的定时任务机制，向目标群组发送通知。
11	- 跨平台转发：将抓取到的内容（特别如新闻图片、数据图表链接）作为微信信息直接转发。
12	- 任务链收尾：先完成搜索、分析、运行命令、生成报告等任务，再把最终摘要或结果通过微信发送给指定联系人或群。
13	- 本地文件转发：把 Agent 生成的报告、截图、表格、压缩包、本地图片等文件直接发给指定联系人或群。
14
15	## 典型触发语句
16
17	- “帮我给 LAVA 发个微信，就说我今天晚点到。”
18	- “把刚才总结的会议纪要发到工作群里。”
19	- “下载这个图片，用微信发给文件传输助手。”
20	- “帮我通知一下张三，让他明天带电脑。”
21	- “查询今天关于 AI 的最新新闻，整理成简洁总结，然后通过微信发送到联系人文件传输助手。”
22	- “把这次运行结果总结整理，通过微信发送到项目通知群。”
23	- “把本机上的 C:\tmp\report.xlsx 通过微信发送给文件传输助手。”
24	- “把刚生成的截图发到项目群。”
25
26	## 作为 Skill 调用的规范指令
27
28	本 Skill 调用后会直接返回结果并退出，不会常驻内存。请在项目根目录中使用以下语法调用：
29
30	### 发送文本消息
31
32	```powershell
33	python scripts/skill_cli.py --to "联系人或群组名称" --content "你要发送的具体文本"
34	```
35
36	### 发送图片消息
37
38	```powershell
39	python scripts/skill_cli.py --to "联系人或群组名称" --content "https://example.com/image.png" --action "sendpic"
40	```
41
42	如果 `sendpic` 的 `--content` 是本地路径，则不会下载图片，会直接按本地文件复制并粘贴到微信。
43
44	### 发送本地文件或本地图片
45
46	```powershell
47	python scripts/skill_cli.py --to "联系人或群组名称" --content "C:\path\to\file.zip" --action "sendfile"
48	```
49
50	本地图片、PDF、Office 文档、压缩包等都使用 `sendfile`。Agent 发送自己刚生成的文件时，应优先使用绝对路径。
51
52	### 发送测试
53
54	首次安装或接入 Agent 后，优先向“文件传输助手”发送测试消息：
55
56	```powershell
57	python scripts/skill_cli.py --to "文件传输助手" --content "这是一条来自 Agent Skill 的测试消息"
58	```
59
60	stdout 输出 `发送成功` 表示任务完成。stdout 输出 `发送失败` 或 `执行异常` 时，应将错误信息原样反馈给用户。
61
62	如需更稳定地解析结果，可追加 `--json`：
63
64	```powershell
65	python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --json
66	```
67
68	JSON 输出字段包含 `success`、`code`、`message`、`to`、`action`。`success=true` 表示发送请求已被成功受理；`success=false` 表示未成功（同步模式下即为发送失败，详见下文模式说明）。
69
70	## 执行模式与结果判定
71
72	本 Skill 有两种执行模式，默认会自动选择：
73
74	- 同步 CLI 模式（默认，且后台 API 未运行时）：直接操作微信窗体发送，命令返回的 `success` 即为真实发送结果。失败会给出 `CONTACT_NOT_FOUND`、`WECHAT_WINDOW_NOT_FOUND` 等具体 `code`。需要确切知道"是否真的发出去了"时用这个模式。
75	- API 队列模式（后台 `app.py` / `run.bat` 已在运行，且 `config.json` 配好 `token` 时自动启用）：把消息提交到后台 HTTP 队列，由后台串行异步发送，多个请求不会互相抢占微信窗体。注意：此模式下 `success=true` 仅表示"消息已入队受理"，并不代表已成功送达；真实发送结果需查询后台 `GET /status` 或服务端日志 `wechat_automation.log`。
76
77	可用以下参数显式指定模式（不加则自动判定）：
78
79	\| 参数 \| 作用 \|
80	\| --- \| --- \|
81	\| `--no-api` \| 强制同步 CLI 模式，跳过 API 自动检测，确保拿到真实发送结果 \|
82	\| `--api` \| 强制 API 队列模式（需先启动后台服务并配置 `token`，否则报错） \|
83
84	```powershell
85	# 强制同步发送并拿真实结果（不论后台 API 是否在运行）
86	python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --no-api --json
87	```
88
89	给 Agent 的判定建议：常规发信依据退出码与 `success` 判断任务是否被受理即可；若任务必须确认真实送达（如重要通知），请追加 `--no-api` 走同步模式，再据 `code` 反馈用户。
90
91	## 安装与运行环境
92
93	1. Windows 10/11，微信 PC 客户端已启动并登录。
94	2. 在项目根目录安装依赖：`pip install -r requirements.txt`。
95	3. Agent 执行本 Skill 时，工作目录应为本项目根目录，确保 `python scripts/skill_cli.py ...` 可以找到 `scripts/wechat_controller.py`。
96	4. 不要为普通发消息任务启动后台 HTTP API；HTTP API 只用于长期服务、队列和外部系统集成。
97
98	## 系统辅助功能启用
99
100	若运行环境为精简版或 Ghost 系统，需确保 Windows 辅助功能正常运行。通过键盘 Win 键唤出开始菜单，输入“讲述人”并开启该功能（开启后可立即关闭），此操作可确保系统底层 UI 自动化接口处于激活状态，避免程序无法识别元素。
101
102	## 注意事项与约束
103
104	1. 必须精确匹配名称：`--to` 参数指定的联系人或群组名称必须与微信内的备注或网名完全一致（区分大小写和空格），否则可能导致发送失败或发错人。
105	2. 直接执行命令：不要试图使用视觉模型去理解或分析微信页面。直接执行上述命令行命令即可，底层脚本已封装窗体查找、联系人搜索和发送操作。
106	3. 识别执行结果：执行后请读取 stdout 和退出码。退出码 `0` 表示请求已被受理；退出码非 `0` 表示失败。如果输出 `发送失败` 或 JSON 中 `success=false`，请原封不动把 `message` 和 `code` 反馈给用户，不要擅自循环重试。注意：当输出为 `消息已提交发送队列受理…` 时表示走了 API 队列模式（异步），仅代表受理成功；需确认真实送达请改用 `--no-api`。
107	4. 长文本分段发送：如果要发送的文字内容超过 2000 字，Agent 应主动拆成多段，分多次调用本 Skill 发送。每段建议不超过 2000 字，并在内容开头标明序号，例如 `【1/3】...`、`【2/3】...`、`【3/3】...`。
108	5. 特殊字符支持：内容中可以直接包含换行符（`\n`）或表情符号文本，脚本层会自动处理转义与输入，请放心传入。
109	6. 本地文件用绝对路径：发送本机文件或本机图片时，优先传绝对路径，例如 `C:\tmp\report.pdf`。相对路径会按当前工作目录解析。
110	7. 避免重复发送：失败后不要自动多次重试，除非用户明确要求。
111
112	## 异常处理与反馈
113
114	CLI 会尽量给出明确失败原因，常见 `code` 包括：
115
116	- `WECHAT_WINDOW_NOT_FOUND`：未找到微信窗口。请确认微信 PC 已启动并登录；精简版或 Ghost 系统可按“系统辅助功能启用”处理。
117	- `CONTACT_NOT_FOUND`：未找到联系人或群组。请确认 `--to` 与微信备注、联系人名或群名完全一致。
118	- `SEARCH_BOX_NOT_FOUND`：未找到微信搜索框。可能是微信 UI 结构变化、窗口未加载完成或系统 UI 自动化不可用。
119	- `CHAT_INPUT_NOT_FOUND`：未找到聊天输入框。可能未成功进入目标会话，或微信 UI 结构变化。
120	- `CLIPBOARD_TEXT_FAILED`：文本写入剪贴板失败。请检查系统剪贴板、`pyperclip` 或远程桌面会话状态。
121	- `IMAGE_DOWNLOAD_FAILED` / `IMAGE_URL_NOT_IMAGE`：图片 URL 下载失败或返回内容不是图片。
122	- `IMAGE_CLIPBOARD_FAILED`：图片复制到剪贴板失败。
123	- `LOCAL_FILE_NOT_FOUND`：本地文件不存在。请检查路径是否正确，建议使用绝对路径。
124	- `LOCAL_FILE_INVALID`：路径不是文件，当前不支持发送目录。
125	- `FILE_CLIPBOARD_FAILED`：本地文件复制到剪贴板失败。请检查系统剪贴板或远程桌面会话状态。
126	- `SEND_FILE_ERROR`：发送本地文件异常。
127	- `DEPENDENCY_MISSING`：缺少 Python 依赖。请在项目根目录执行 `pip install -r requirements.txt`。
128	- `CLI_EXCEPTION`：CLI 自身执行异常。
129
130	Agent 遇到失败时应停止当前发送任务，把错误原因反馈给用户，并建议用户检查对应环境或联系人名称。
131
132	## 开发者辅助工具
133
134	如需维护或扩展元素查找逻辑，建议使用 Visual Studio SDK 自带的 `Inspect.exe` 工具（或 Windows SDK 工具包），用于实时查看微信窗口的 UI 元素树结构、`Name`、`AutomationID` 及 `ClassName` 等关键属性，辅助编写元素查找逻辑。

LAVARONGPublisher · 1 listing

Preview

LAVARONG/wechat-automation-api

# 微信自动发信 Skill

赋予智能体掌控 Windows 桌面微信直接向真实用户或群组发送文本、图片URL或本地文件的能力。本 Skill 默认以同步命令行方式运行，执行一次命令发送一次消息，命令结束后立即退出。

只发送微信消息时，不需要专门启动后台 HTTP API，不需要运行 `run.bat`，也不需要调用 `scripts/app.py`。但**如果后台 HTTP API 恰好已在运行**，本 Skill 会**自动改走 API 队列模式**发送，以避免多个请求同时直接操作微信窗体造成冲突，详见下文「执行模式与结果判定」

## 应用场景

RepoLAVARONG/wechat-automation-api

License—

TypeSkills

CategoryAutomation

UpdatedJun 2026

Repo stars159

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

wechat-automation-api

159stars40forks

View on GitHub

How to install wechat-automation-api?

lavarong/wechat-automation-api/wechat-automation-api

$npx -y skills add LAVARONG/wechat-automation-api --skill wechat-automation-api

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 微信自动发信 Skill
2
3	赋予智能体掌控 Windows 桌面微信直接向真实用户或群组发送文本、图片URL或本地文件的能力。本 Skill 默认以同步命令行方式运行，执行一次命令发送一次消息，命令结束后立即退出。
4
5	只发送微信消息时，不需要专门启动后台 HTTP API，不需要运行 `run.bat`，也不需要调用 `scripts/app.py`。但如果后台 HTTP API 恰好已在运行，本 Skill 会自动改走 API 队列模式发送，以避免多个请求同时直接操作微信窗体造成冲突，详见下文「执行模式与结果判定」。
6
7	## 应用场景
8
9	- 信息推送：当你作为智能体完成了某项长耗时的搜索、总结或生图任务后，可以将最终结果或报告链接直接通过微信发送给用户指定的联系人。
10	- 定时催办/打卡通知：结合智能体的定时任务机制，向目标群组发送通知。
11	- 跨平台转发：将抓取到的内容（特别如新闻图片、数据图表链接）作为微信信息直接转发。
12	- 任务链收尾：先完成搜索、分析、运行命令、生成报告等任务，再把最终摘要或结果通过微信发送给指定联系人或群。
13	- 本地文件转发：把 Agent 生成的报告、截图、表格、压缩包、本地图片等文件直接发给指定联系人或群。
14
15	## 典型触发语句
16
17	- “帮我给 LAVA 发个微信，就说我今天晚点到。”
18	- “把刚才总结的会议纪要发到工作群里。”
19	- “下载这个图片，用微信发给文件传输助手。”
20	- “帮我通知一下张三，让他明天带电脑。”
21	- “查询今天关于 AI 的最新新闻，整理成简洁总结，然后通过微信发送到联系人文件传输助手。”
22	- “把这次运行结果总结整理，通过微信发送到项目通知群。”
23	- “把本机上的 C:\tmp\report.xlsx 通过微信发送给文件传输助手。”
24	- “把刚生成的截图发到项目群。”
25
26	## 作为 Skill 调用的规范指令
27
28	本 Skill 调用后会直接返回结果并退出，不会常驻内存。请在项目根目录中使用以下语法调用：
29
30	### 发送文本消息
31
32	```powershell
33	python scripts/skill_cli.py --to "联系人或群组名称" --content "你要发送的具体文本"
34	```
35
36	### 发送图片消息
37
38	```powershell
39	python scripts/skill_cli.py --to "联系人或群组名称" --content "https://example.com/image.png" --action "sendpic"
40	```
41
42	如果 `sendpic` 的 `--content` 是本地路径，则不会下载图片，会直接按本地文件复制并粘贴到微信。
43
44	### 发送本地文件或本地图片
45
46	```powershell
47	python scripts/skill_cli.py --to "联系人或群组名称" --content "C:\path\to\file.zip" --action "sendfile"
48	```
49
50	本地图片、PDF、Office 文档、压缩包等都使用 `sendfile`。Agent 发送自己刚生成的文件时，应优先使用绝对路径。
51
52	### 发送测试
53
54	首次安装或接入 Agent 后，优先向“文件传输助手”发送测试消息：
55
56	```powershell
57	python scripts/skill_cli.py --to "文件传输助手" --content "这是一条来自 Agent Skill 的测试消息"
58	```
59
60	stdout 输出 `发送成功` 表示任务完成。stdout 输出 `发送失败` 或 `执行异常` 时，应将错误信息原样反馈给用户。
61
62	如需更稳定地解析结果，可追加 `--json`：
63
64	```powershell
65	python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --json
66	```
67
68	JSON 输出字段包含 `success`、`code`、`message`、`to`、`action`。`success=true` 表示发送请求已被成功受理；`success=false` 表示未成功（同步模式下即为发送失败，详见下文模式说明）。
69
70	## 执行模式与结果判定
71
72	本 Skill 有两种执行模式，默认会自动选择：
73
74	- 同步 CLI 模式（默认，且后台 API 未运行时）：直接操作微信窗体发送，命令返回的 `success` 即为真实发送结果。失败会给出 `CONTACT_NOT_FOUND`、`WECHAT_WINDOW_NOT_FOUND` 等具体 `code`。需要确切知道"是否真的发出去了"时用这个模式。
75	- API 队列模式（后台 `app.py` / `run.bat` 已在运行，且 `config.json` 配好 `token` 时自动启用）：把消息提交到后台 HTTP 队列，由后台串行异步发送，多个请求不会互相抢占微信窗体。注意：此模式下 `success=true` 仅表示"消息已入队受理"，并不代表已成功送达；真实发送结果需查询后台 `GET /status` 或服务端日志 `wechat_automation.log`。
76
77	可用以下参数显式指定模式（不加则自动判定）：
78
79	\| 参数 \| 作用 \|
80	\| --- \| --- \|
81	\| `--no-api` \| 强制同步 CLI 模式，跳过 API 自动检测，确保拿到真实发送结果 \|
82	\| `--api` \| 强制 API 队列模式（需先启动后台服务并配置 `token`，否则报错） \|
83
84	```powershell
85	# 强制同步发送并拿真实结果（不论后台 API 是否在运行）
86	python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --no-api --json
87	```
88
89	给 Agent 的判定建议：常规发信依据退出码与 `success` 判断任务是否被受理即可；若任务必须确认真实送达（如重要通知），请追加 `--no-api` 走同步模式，再据 `code` 反馈用户。
90
91	## 安装与运行环境
92
93	1. Windows 10/11，微信 PC 客户端已启动并登录。
94	2. 在项目根目录安装依赖：`pip install -r requirements.txt`。
95	3. Agent 执行本 Skill 时，工作目录应为本项目根目录，确保 `python scripts/skill_cli.py ...` 可以找到 `scripts/wechat_controller.py`。
96	4. 不要为普通发消息任务启动后台 HTTP API；HTTP API 只用于长期服务、队列和外部系统集成。
97
98	## 系统辅助功能启用
99
100	若运行环境为精简版或 Ghost 系统，需确保 Windows 辅助功能正常运行。通过键盘 Win 键唤出开始菜单，输入“讲述人”并开启该功能（开启后可立即关闭），此操作可确保系统底层 UI 自动化接口处于激活状态，避免程序无法识别元素。
101
102	## 注意事项与约束
103
104	1. 必须精确匹配名称：`--to` 参数指定的联系人或群组名称必须与微信内的备注或网名完全一致（区分大小写和空格），否则可能导致发送失败或发错人。
105	2. 直接执行命令：不要试图使用视觉模型去理解或分析微信页面。直接执行上述命令行命令即可，底层脚本已封装窗体查找、联系人搜索和发送操作。
106	3. 识别执行结果：执行后请读取 stdout 和退出码。退出码 `0` 表示请求已被受理；退出码非 `0` 表示失败。如果输出 `发送失败` 或 JSON 中 `success=false`，请原封不动把 `message` 和 `code` 反馈给用户，不要擅自循环重试。注意：当输出为 `消息已提交发送队列受理…` 时表示走了 API 队列模式（异步），仅代表受理成功；需确认真实送达请改用 `--no-api`。
107	4. 长文本分段发送：如果要发送的文字内容超过 2000 字，Agent 应主动拆成多段，分多次调用本 Skill 发送。每段建议不超过 2000 字，并在内容开头标明序号，例如 `【1/3】...`、`【2/3】...`、`【3/3】...`。
108	5. 特殊字符支持：内容中可以直接包含换行符（`\n`）或表情符号文本，脚本层会自动处理转义与输入，请放心传入。
109	6. 本地文件用绝对路径：发送本机文件或本机图片时，优先传绝对路径，例如 `C:\tmp\report.pdf`。相对路径会按当前工作目录解析。
110	7. 避免重复发送：失败后不要自动多次重试，除非用户明确要求。
111
112	## 异常处理与反馈
113
114	CLI 会尽量给出明确失败原因，常见 `code` 包括：
115
116	- `WECHAT_WINDOW_NOT_FOUND`：未找到微信窗口。请确认微信 PC 已启动并登录；精简版或 Ghost 系统可按“系统辅助功能启用”处理。
117	- `CONTACT_NOT_FOUND`：未找到联系人或群组。请确认 `--to` 与微信备注、联系人名或群名完全一致。
118	- `SEARCH_BOX_NOT_FOUND`：未找到微信搜索框。可能是微信 UI 结构变化、窗口未加载完成或系统 UI 自动化不可用。
119	- `CHAT_INPUT_NOT_FOUND`：未找到聊天输入框。可能未成功进入目标会话，或微信 UI 结构变化。
120	- `CLIPBOARD_TEXT_FAILED`：文本写入剪贴板失败。请检查系统剪贴板、`pyperclip` 或远程桌面会话状态。
121	- `IMAGE_DOWNLOAD_FAILED` / `IMAGE_URL_NOT_IMAGE`：图片 URL 下载失败或返回内容不是图片。
122	- `IMAGE_CLIPBOARD_FAILED`：图片复制到剪贴板失败。
123	- `LOCAL_FILE_NOT_FOUND`：本地文件不存在。请检查路径是否正确，建议使用绝对路径。
124	- `LOCAL_FILE_INVALID`：路径不是文件，当前不支持发送目录。
125	- `FILE_CLIPBOARD_FAILED`：本地文件复制到剪贴板失败。请检查系统剪贴板或远程桌面会话状态。
126	- `SEND_FILE_ERROR`：发送本地文件异常。
127	- `DEPENDENCY_MISSING`：缺少 Python 依赖。请在项目根目录执行 `pip install -r requirements.txt`。
128	- `CLI_EXCEPTION`：CLI 自身执行异常。
129
130	Agent 遇到失败时应停止当前发送任务，把错误原因反馈给用户，并建议用户检查对应环境或联系人名称。
131
132	## 开发者辅助工具
133
134	如需维护或扩展元素查找逻辑，建议使用 Visual Studio SDK 自带的 `Inspect.exe` 工具（或 Windows SDK 工具包），用于实时查看微信窗口的 UI 元素树结构、`Name`、`AutomationID` 及 `ClassName` 等关键属性，辅助编写元素查找逻辑。

LAVARONGPublisher · 1 listing

Preview

LAVARONG/wechat-automation-api

# 微信自动发信 Skill

## 应用场景

RepoLAVARONG/wechat-automation-api

License—

TypeSkills

CategoryAutomation

UpdatedJun 2026

Repo stars159

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type