SKILL.md
Full skill instructions
微信消息发送技能
此技能通过平台脚本实现微信消息的自动化发送：macOS 使用 AppleScript + cliclick，Windows 使用 PowerShell。按当前操作系统选用对应脚本即可。
功能概述
- 自动激活微信应用
- 搜索指定联系人或群组
- 发送指定消息内容
- 发送本地图片文件（指定路径）
- 支持中文和特殊字符
使用方法
macOS（AppleScript）
osascript scripts/wechat_automation_script.applescript "<联系人名称>" "<消息内容>" "[图片路径]"
Windows（PowerShell）
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "<联系人名称>" "<消息内容>" "[图片路径]"
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
| 联系人名称 | 是 | 微信联系人名称或群名称，需完全匹配 |
| 消息内容 | 否* | 要发送的消息文本；与图片至少填一项 |
| 图片路径/URL | 否* | 本地图片路径或 http(s):// 图片地址；与消息至少填一项 |
* 消息与图片可同时提供：先发送文本，再发送图片。
使用示例
macOS：
osascript scripts/wechat_automation_script.applescript "张三" "你好，今天有空吗？"
osascript scripts/wechat_automation_script.applescript "工作群" "大家好！"
osascript scripts/wechat_automation_script.applescript "张三" "" "/Users/me/screenshot.png"
osascript scripts/wechat_automation_script.applescript "张三" "请看截图" "/Users/me/screenshot.png"
osascript scripts/wechat_automation_script.applescript "张三" "" "https://example.com/image.png"
Windows：
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "张三" "你好，今天有空吗？"
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "工作群" "大家好！"
powershell -ExecutionPolicy Bypass -File scripts/wechat_automation_script.ps1 "张三" "" "C:\Users\me\screenshot.png"
工作流程
两平台流程一致，仅快捷键不同：
- 激活微信 - 将微信窗口置于最前
- 打开搜索 - macOS：
Cmd+F/ Windows：Ctrl+F - 搜索联系人 - 粘贴联系人名并选择第一个匹配结果（Ctrl+V / Cmd+V）
- 定位输入框 - macOS：cliclick 点击窗口右下角 / Windows：Tab 键定位
- 发送内容 - 粘贴文本和/或图片（剪贴板）并按回车发送
- 收尾 - macOS：
Cmd+H隐藏窗口 / Windows：最小化窗口
注意事项
- 微信必须已登录 - 执行前确保微信已打开并登录
- 联系人名称需精确匹配 - 搜索时会选择第一个匹配结果
- 执行时间约 15 秒 - 脚本包含多个延时，执行期间勿操作微信
- macOS：需要安装 cliclick 并授予 辅助功能 权限
- Windows：若提示无法执行脚本，请使用
-ExecutionPolicy Bypass；若在微信内修改过「搜索」快捷键，需在.ps1中把^f改为对应快捷键
权限配置
macOS
1. 安装 cliclick
使用 Homebrew 安装：
brew install cliclick
2. 授予辅助功能权限
- 系统设置 → 隐私与安全性 → 辅助功能
- 将 终端（或 iTerm、Cursor 等）加入列表并勾选
- 如有 System Events，建议一并勾选
Windows
无需额外权限；首次运行若受限，使用 -ExecutionPolicy Bypass 执行脚本即可。
故障排除
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 消息未发送 | 焦点未在输入框 | 执行期间勿切换窗口，可重试 |
| 不能获得 window 1 / 无效索引 | 微信被 Cmd+H 隐藏或最小化 | 脚本会先 activate，再 open -a WeChat 恢复一次；仍失败请手动打开微信 |
| 搜索不到联系人 | 名称不匹配 | 确认联系人/群名与微信中完全一致 |
| macOS 脚本无反应 | 未给辅助功能权限 | 在「辅助功能」中勾选终端等应用 |
| macOS 鼠标点击无效 | cliclick 未安装或权限不足 | brew install cliclick 并授予辅助功能权限 |
| Windows 无法执行脚本 | 执行策略限制 | 使用 -ExecutionPolicy Bypass |
| 发送中文乱码 | 编码问题 | 终端使用 UTF-8 编码 |
文件结构
wechat-message/
├── SKILL.md # 本技能说明
├── README.md # 使用说明
├── examples/
│ └── sample.md # 使用示例
└── scripts/
├── wechat_automation_script.applescript # macOS 脚本
└── wechat_automation_script.ps1 # Windows 脚本