Back to search
"wechat-automation"
SkillGitHub
"微信发信能力:通过 Windows 桌面微信发送文本、图片URL或本地文件。适合各类 Agent 在本机直接发送一次性消息。触发词:给[某人]发微信、通知[某人]、把这个用微信发给[某人]、用微信发个图片、把本地文件发给[某人]"
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/lavarong--wechat-automation-api)HTML
<a href="/listings/lavarong--wechat-automation-api"><img src="/api/listings/lavarong--wechat-automation-api/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
请帮我安装部署这个skill https://github.com/LAVARONG/wechat-automation-api ,完成后给微信联系人“文件传输助手”发送“这是来着微信自动化发信 Skill 的测试信息”
智能体会自动拉取仓库、读取 `SKILL.md`,并按项目说明准备运行环境。如果正常,会操作微信给“文件传输助手”发送测试信息。请提前确保 PC 版微信已经登录。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 141 lines
- ---
- name: "wechat-automation"
- description: "微信发信能力:通过 Windows 桌面微信发送文本、图片URL或本地文件。适合各类 Agent 在本机直接发送一次性消息。触发词:给[某人]发微信、通知[某人]、把这个用微信发给[某人]、用微信发个图片、把本地文件发给[某人]"
- ---
- # 微信自动发信 Skill
- 赋予智能体掌控 Windows 桌面微信直接向真实用户或群组发送文本、图片URL或本地文件的能力。本 Skill 默认以同步命令行方式运行,执行一次命令发送一次消息,命令结束后立即退出。
- 只发送微信消息时,不需要专门启动后台 HTTP API,不需要运行 `run.bat`,也不需要调用 `scripts/app.py`。但**如果后台 HTTP API 恰好已在运行**,本 Skill 会**自动改走 API 队列模式**发送,以避免多个请求同时直接操作微信窗体造成冲突,详见下文「执行模式与结果判定」。
- ## 应用场景
- - **信息推送**:当你作为智能体完成了某项长耗时的搜索、总结或生图任务后,可以将最终结果或报告链接直接通过微信发送给用户指定的联系人。
- - **定时催办/打卡通知**:结合智能体的定时任务机制,向目标群组发送通知。
- - **跨平台转发**:将抓取到的内容(特别如新闻图片、数据图表链接)作为微信信息直接转发。
- - **任务链收尾**:先完成搜索、分析、运行命令、生成报告等任务,再把最终摘要或结果通过微信发送给指定联系人或群。
- - **本地文件转发**:把 Agent 生成的报告、截图、表格、压缩包、本地图片等文件直接发给指定联系人或群。
- ## 典型触发语句
- - “帮我给 **LAVA** 发个微信,就说**我今天晚点到**。”
- - “把刚才总结的**会议纪要**发到**工作群**里。”
- - “下载这个图片,用微信发给 **文件传输助手**。”
- - “帮我通知一下 **张三**,让他**明天带电脑**。”
- - “查询今天关于 **AI** 的最新新闻,整理成简洁总结,然后通过微信发送到联系人 **文件传输助手**。”
- - “把这次运行结果总结整理,通过微信发送到 **项目通知群**。”
- - “把本机上的 **C:\tmp\report.xlsx** 通过微信发送给 **文件传输助手**。”
- - “把刚生成的截图发到 **项目群**。”
- ## 作为 Skill 调用的规范指令
- 本 Skill 调用后会直接返回结果并退出,不会常驻内存。请在项目根目录中使用以下语法调用:
- ### 发送文本消息
- ```powershell
- python scripts/skill_cli.py --to "联系人或群组名称" --content "你要发送的具体文本"
- ```
- ### 发送图片消息
- ```powershell
- python scripts/skill_cli.py --to "联系人或群组名称" --content "https://example.com/image.png" --action "sendpic"
- ```
- 如果 `sendpic` 的 `--content` 是本地路径,则不会下载图片,会直接按本地文件复制并粘贴到微信。
- ### 发送本地文件或本地图片
- ```powershell
- python scripts/skill_cli.py --to "联系人或群组名称" --content "C:\path\to\file.zip" --action "sendfile"
- ```
- 本地图片、PDF、Office 文档、压缩包等都使用 `sendfile`。Agent 发送自己刚生成的文件时,应优先使用绝对路径。
- ### 发送测试
- 首次安装或接入 Agent 后,优先向“文件传输助手”发送测试消息:
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "这是一条来自 Agent Skill 的测试消息"
- ```
- stdout 输出 `发送成功` 表示任务完成。stdout 输出 `发送失败` 或 `执行异常` 时,应将错误信息原样反馈给用户。
- 如需更稳定地解析结果,可追加 `--json`:
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --json
- ```
- JSON 输出字段包含 `success`、`code`、`message`、`to`、`action`。`success=true` 表示发送请求已被成功受理;`success=false` 表示未成功(同步模式下即为发送失败,详见下文模式说明)。
- ## 执行模式与结果判定
- 本 Skill 有两种执行模式,默认会**自动选择**:
- - **同步 CLI 模式**(默认,且后台 API 未运行时):直接操作微信窗体发送,命令返回的 `success` 即为**真实发送结果**。失败会给出 `CONTACT_NOT_FOUND`、`WECHAT_WINDOW_NOT_FOUND` 等具体 `code`。需要确切知道"是否真的发出去了"时用这个模式。
- - **API 队列模式**(后台 `app.py` / `run.bat` 已在运行,且 `config.json` 配好 `token` 时自动启用):把消息提交到后台 HTTP 队列,由后台串行异步发送,多个请求不会互相抢占微信窗体。**注意:此模式下 `success=true` 仅表示"消息已入队受理",并不代表已成功送达**;真实发送结果需查询后台 `GET /status` 或服务端日志 `wechat_automation.log`。
- 可用以下参数显式指定模式(不加则自动判定):
- | 参数 | 作用 |
- | --- | --- |
- | `--no-api` | 强制同步 CLI 模式,跳过 API 自动检测,确保拿到真实发送结果 |
- | `--api` | 强制 API 队列模式(需先启动后台服务并配置 `token`,否则报错) |
- | `--lock-mouse` | 发送期间临时锁定鼠标,防止用户误触干扰(同步 CLI 模式生效) |
- | `--no-lock-mouse` | 发送时不锁定鼠标(默认使用 config.json 的 lock_mouse_during_send 配置) |
- ```powershell
- # 强制同步发送并拿真实结果(不论后台 API 是否在运行)
- python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --no-api --json
- ```
- **给 Agent 的判定建议**:常规发信依据退出码与 `success` 判断任务是否被受理即可;若任务**必须确认真实送达**(如重要通知),请追加 `--no-api` 走同步模式,再据 `code` 反馈用户。
- ## 安装与运行环境
- 1. Windows 10/11,微信 PC 客户端已启动并登录。
- 2. 在项目根目录安装依赖:`pip install -r requirements.txt`。
- 3. Agent 执行本 Skill 时,工作目录应为本项目根目录,确保 `python scripts/skill_cli.py ...` 可以找到 `scripts/wechat_controller.py`。
- 4. 不要为普通发消息任务启动后台 HTTP API;HTTP API 只用于长期服务、队列和外部系统集成。
- ## 系统辅助功能启用
- 若运行环境为精简版或 Ghost 系统,需确保 Windows 辅助功能正常运行。通过键盘 Win 键唤出开始菜单,输入“讲述人”并开启该功能(开启后可立即关闭),此操作可确保系统底层 UI 自动化接口处于激活状态,避免程序无法识别元素。
- ## 注意事项与约束
- 1. **必须精确匹配名称**:`--to` 参数指定的联系人或群组名称必须与微信内的备注或网名**完全一致**(区分大小写和空格),否则可能导致发送失败或发错人。
- 2. **直接执行命令**:不要试图使用视觉模型去理解或分析微信页面。直接执行上述命令行命令即可,底层脚本已封装窗体查找、联系人搜索和发送操作。
- 3. **识别执行结果**:执行后请读取 stdout 和退出码。退出码 `0` 表示请求已被受理;退出码非 `0` 表示失败。如果输出 `发送失败` 或 JSON 中 `success=false`,请**原封不动**把 `message` 和 `code` 反馈给用户,不要擅自循环重试。注意:当输出为 `消息已提交发送队列受理…` 时表示走了 API 队列模式(异步),仅代表受理成功;需确认真实送达请改用 `--no-api`。
- 4. **长文本分段发送**:如果要发送的文字内容超过 2000 字,Agent 应主动拆成多段,分多次调用本 Skill 发送。每段建议不超过 2000 字,并在内容开头标明序号,例如 `【1/3】...`、`【2/3】...`、`【3/3】...`。
- 5. **特殊字符支持**:内容中可以直接包含换行符(`\n`)或表情符号文本,脚本层会自动处理转义与输入,请放心传入。
- 6. **本地文件用绝对路径**:发送本机文件或本机图片时,优先传绝对路径,例如 `C:\tmp\report.pdf`。相对路径会按当前工作目录解析。
- 7. **避免重复发送**:失败后不要自动多次重试,除非用户明确要求。
- ## 异常处理与反馈
- CLI 会尽量给出明确失败原因,常见 `code` 包括:
- - `WECHAT_WINDOW_NOT_FOUND`:未找到微信窗口。请确认微信 PC 已启动并登录;精简版或 Ghost 系统可按“系统辅助功能启用”处理。
- - `CONTACT_NOT_FOUND`:未找到联系人或群组。请确认 `--to` 与微信备注、联系人名或群名完全一致。
- - `SEARCH_BOX_NOT_FOUND`:未找到微信搜索框。可能是微信 UI 结构变化、窗口未加载完成或系统 UI 自动化不可用。
- - `CHAT_INPUT_NOT_FOUND`:未找到聊天输入框。可能未成功进入目标会话,或微信 UI 结构变化。
- - `CLIPBOARD_TEXT_FAILED`:文本写入剪贴板失败。请检查系统剪贴板、`pyperclip` 或远程桌面会话状态。
- - `IMAGE_DOWNLOAD_FAILED` / `IMAGE_URL_NOT_IMAGE`:图片 URL 下载失败或返回内容不是图片。
- - `IMAGE_CLIPBOARD_FAILED`:图片复制到剪贴板失败。
- - `LOCAL_FILE_NOT_FOUND`:本地文件不存在。请检查路径是否正确,建议使用绝对路径。
- - `LOCAL_FILE_INVALID`:路径不是文件,当前不支持发送目录。
- - `FILE_CLIPBOARD_FAILED`:本地文件复制到剪贴板失败。请检查系统剪贴板或远程桌面会话状态。
- - `SEND_FILE_ERROR`:发送本地文件异常。
- - `DEPENDENCY_MISSING`:缺少 Python 依赖。请在项目根目录执行 `pip install -r requirements.txt`。
- - `CLI_EXCEPTION`:CLI 自身执行异常。
- Agent 遇到失败时应停止当前发送任务,把错误原因反馈给用户,并建议用户检查对应环境或联系人名称。
- ## 开发者辅助工具
- 如需维护或扩展元素查找逻辑,建议使用 Visual Studio SDK 自带的 `Inspect.exe` 工具(或 Windows SDK 工具包),用于实时查看微信窗口的 UI 元素树结构、`Name`、`AutomationID` 及 `ClassName` 等关键属性,辅助编写元素查找逻辑。
README.md · README · 377 lines
- # 微信自动化发信 Skill / HTTP API
- 这是一个面向 Windows 桌面微信的自动化发信工具,核心能力是通过 `uiautomation` 控制已登录的微信客户端发送文本、图片 URL 或本地文件。项目提供两种入口:
- - **Skill / CLI 入口**:推荐给各类 Agent 使用。一次命令完成一次发送,执行后立即退出;只发送消息时无需启动后台 HTTP API。
- - **HTTP API 入口**:适合外部系统长期集成、批量投递和队列处理,需要启动 Flask 后台服务。
- 本项目不使用 Hook、不接入微信协议,只通过 Windows UI 自动化操作本机微信窗口。
- ## Skill 用法
- 这是最推荐的使用方式:你只需要用自然语言告诉智能体要把什么内容发给谁,智能体会自动调用 Skill,不需要你手写命令,也不需要启动后台 HTTP API。
- ### 安装
- ```text
- 请帮我安装部署这个skill https://github.com/LAVARONG/wechat-automation-api ,完成后给微信联系人“文件传输助手”发送“这是来着微信自动化发信 Skill 的测试信息”
- ```
- 智能体会自动拉取仓库、读取 `SKILL.md`,并按项目说明准备运行环境。如果正常,会操作微信给“文件传输助手”发送测试信息。请提前确保 PC 版微信已经登录。
- ### 玩法示例
- 安装完成后,可以直接这样对智能体说:
- ```text
- 查询今天关于 AI 的最新新闻,整理成简洁的总结,然后通过微信发送到联系人“文件传输助手”。
- ```
- ```text
- 把这次运行结果整理成 5 条要点,通过微信发送到“项目通知群”。
- ```
- ```text
- 下载这张图片并通过微信发给“文件传输助手”。
- ```
- ```text
- 给微信的“文件传输助手”发送我下载目录下最新的一张图片。
- ```
- ```text
- 把刚生成的 C:\tmp\report.xlsx 通过微信发送给“文件传输助手”。
- ```
- ```text
- 把当前项目的测试结果总结一下,然后通过微信发给“项目通知群”。
- ```
- 普通发消息、发图片、发本地文件都走 Skill 即可,不需要运行 `run.bat`,也不需要启动 `scripts/app.py`。
- ## CLI 用法
- CLI 适合开发者手动测试、排查环境问题,或在本机脚本里直接调用。
- ### 手动安装环境
- 先确保满足以下条件:
- - Windows 10/11
- - Python 3.7+
- - 微信 PC 客户端已启动并登录
- - 微信窗口可被系统 UI 自动化识别
- 在项目根目录安装依赖:
- ```powershell
- pip install -r requirements.txt
- ```
- ### 发送文本
- 在项目根目录执行:
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "这是一条 Skill CLI 测试消息"
- ```
- 成功时 stdout 会输出:
- ```text
- 发送成功: 已向「文件传输助手」发送文本消息。
- ```
- 失败时会输出明确原因和错误代码,例如:
- ```text
- 发送失败: 未找到联系人或群组: 文件传输助手。请确认名称与微信备注/群名完全一致。
- 错误代码: CONTACT_NOT_FOUND
- ```
- 这通常表示微信窗口未找到、联系人名称不匹配、系统 UI 自动化不可用或剪贴板不可用。
- ### 发送图片 URL
- 图片发送使用 URL,脚本会下载图片并通过剪贴板粘贴到微信:
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "https://example.com/image.png" --action "sendpic"
- ```
- ### 发送本地图片
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "C:\tmp\screenshot.png" --action "sendpic"
- ```
- 如果传入的是本地路径,`sendpic` 会自动跳过下载,按本地文件粘贴发送。
- ### 发送本地文件
- 发送本机上的任意文件时使用 `sendfile`:
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "C:\tmp\report.xlsx" --action "sendfile"
- ```
- 建议 Agent 使用绝对路径,避免相对路径因工作目录不同而找不到文件。
- ### JSON 输出
- 需要稳定解析时可追加 `--json`:
- ```powershell
- python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --json
- ```
- 输出包含 `success`、`code`、`message`、`to`、`action`。退出码 `0` 表示成功,非 `0` 表示失败。
- ### 鼠标防干扰与锁定选项
- 默认情况下,程序采用**无感瞬发模式**(输入框原生 `SetFocus` 聚焦 + 毫秒级光标原路复位),发送消息时物理鼠标指针几乎不移动,彻底杜绝光标乱飞。
- 若在自动化批量执行期间需要防止人手无意晃动鼠标造成点击偏离,可追加 `--lock-mouse`:
- ```powershell
- # 发信期间临时冻结鼠标操作(操作完成瞬间自动解锁)
- python scripts/skill_cli.py --to "文件传输助手" --content "重要通知" --lock-mouse
- ```
- 也可以通过 `--no-lock-mouse` 强制使用普通无感模式。
- ## 系统辅助功能启用
- 若运行环境为精简版或 Ghost 系统,需确保 Windows 辅助功能正常运行。通过键盘 Win 键唤出开始菜单,输入“讲述人”并开启该功能(开启后可立即关闭),此操作可确保系统底层 UI 自动化接口处于激活状态,避免程序无法识别元素。
- ## 远程桌面与锁屏
- 本项目依赖 Windows UI Automation 操作微信窗口。Windows 锁屏状态下 UIA 通常不可用;服务器通过远程桌面 RDP 登录后,如果直接关闭远程桌面窗口,也可能导致鼠标、键盘和 UI 自动化失效,从而无法继续操作微信。
- 在服务器远程桌面场景中,建议使用项目自带的 `disconnect_rdp.bat` 断开远程桌面连接。它会尝试执行 `tscon <会话ID> /dest:console`,将当前 RDP 会话切回本地控制台并保持会话运行,用于解决关闭远程桌面后鼠标键盘失效的问题。
- 使用方式:
- ```powershell
- .\disconnect_rdp.bat
- ```
- 如执行失败,请尝试以管理员身份运行,并确认当前确实处于远程桌面会话中。
- ## HTTP API 模式
- HTTP API 模式适合长期运行的服务化场景,例如外部系统通过 HTTP 投递消息、批量发送到多个联系人、使用队列控制发送间隔。
- ### 准备配置
- 复制配置示例:
- ```powershell
- Copy-Item config.json.example config.json
- notepad config.json
- ```
- 配置示例:
- ```json
- {
- "token": "your_secret_token_here",
- "host": "127.0.0.1",
- "port": 8808,
- "message_interval": 1,
- "lock_mouse_during_send": false,
- "log_level": "INFO",
- "log_file": "wechat_automation.log"
- }
- ```
- 配置说明:
- - `lock_mouse_during_send`:可选,默认 `false`。若设为 `true`,在发信的大约 1 秒关键窗口期内临时锁定鼠标/键盘,防止人机争抢,操作完成后立即解锁。
- `config.json` 已加入 `.gitignore`,可用于保存本地 token。
- ### 启动服务
- ```powershell
- .\run.bat
- ```
- 或直接运行:
- ```powershell
- python scripts/app.py
- ```
- 启动后默认监听:
- ```text
- POST http://127.0.0.1:8808/
- GET http://127.0.0.1:8808/status
- GET http://127.0.0.1:8808/health
- ```
- ### HTTP 发送文本
- ```powershell
- $body = @{
- token = "your_secret_token_here"
- action = "sendtext"
- to = @("文件传输助手")
- content = "这是一条 HTTP API 测试消息"
- } | ConvertTo-Json
- Invoke-RestMethod -Uri "http://127.0.0.1:8808/" -Method Post -Body $body -ContentType "application/json"
- ```
- ### HTTP 发送图片 URL
- ```powershell
- $body = @{
- token = "your_secret_token_here"
- action = "sendpic"
- to = @("文件传输助手")
- content = "https://example.com/image.png"
- } | ConvertTo-Json
- Invoke-RestMethod -Uri "http://127.0.0.1:8808/" -Method Post -Body $body -ContentType "application/json"
- ```
- ### HTTP 发送本地文件
- ```powershell
- $body = @{
- token = "your_secret_token_here"
- action = "sendfile"
- to = @("文件传输助手")
- content = "C:\tmp\report.xlsx"
- } | ConvertTo-Json
- Invoke-RestMethod -Uri "http://127.0.0.1:8808/" -Method Post -Body $body -ContentType "application/json"
- ```
- 成功响应示例:
- ```json
- {
- "success": true,
- "message": "消息已加入队列",
- "queued_count": 1,
- "queue_size": 1
- }
- ```
- ## 项目结构
- ```text
- wechat-automation-api/
- ├── scripts/
- │ ├── skill_cli.py # Agent Skill / CLI 同步发送入口
- │ ├── wechat_controller.py # 微信窗口查找、联系人搜索、文本/图片发送逻辑
- │ ├── app.py # Flask HTTP API 服务入口
- │ ├── message_queue.py # HTTP 模式消息队列
- │ └── monitor.py # 微信状态监控脚本
- ├── examples/
- │ └── wx.py # uiautomation 最小验证示例
- ├── test/
- │ └── test_api.py # HTTP API 测试脚本
- ├── docs/
- │ └── changelog.md # 更新日志
- ├── SKILL.md # Agent Skill 使用说明
- ├── requirements.txt # Python 依赖
- ├── config.json.example # HTTP API 配置示例
- ├── run.bat # HTTP API 快捷启动脚本
- └── README.md # 项目说明
- ```
- ## 工作原理
- Skill / CLI 模式:
- 1. Agent 或用户执行 `python scripts/skill_cli.py ...`
- 2. 脚本创建 `WeChatController`
- 3. 控制器查找并激活微信窗口
- 4. 优先从会话列表定位联系人,失败后使用搜索框
- 5. 通过剪贴板粘贴文本、图片或本地文件并按 Enter 发送
- 6. 命令返回 `发送成功` 或失败原因并退出
- HTTP API 模式:
- 1. Flask 接收 HTTP 请求并验证 token
- 2. 请求被加入消息队列
- 3. 后台线程按顺序调用 `WeChatController`
- 4. 按配置的 `message_interval` 控制发送间隔
- ## 开发者辅助工具
- 编写或调整元素查找逻辑时,建议准备 UI 自动化查看工具:
- - 使用 Visual Studio SDK 自带的 `Inspect.exe` 工具,或 Windows SDK 工具包中的 Inspect 工具。
- - 用于实时查看微信窗口的 UI 元素树结构、`Name`、`AutomationID`、`ClassName` 等关键属性。
- - 当微信版本更新导致控件名称或层级变化时,优先用 Inspect 重新确认元素属性,再修改 `scripts/wechat_controller.py` 中的查找逻辑。
- 当前代码中比较关键的定位点包括:
- - 微信主窗口:
- - 微信 4.x (Qt 架构):`ClassName="mmui::MainWindow"`(注意:窗口 `Name` 为当前登录微信账号的个人昵称,不可限定 `Name="微信"`)
- - 微信 3.x (Win32 架构):`ClassName="WeChatMainWndForPC"`,`Name="微信"`
- - 会话项:`ClassName="mmui::ChatSessionCell"`,`AutomationId="session_item_<联系人名>"`(搜索深度建议 >= 20)
- - 搜索框:`EditControl(Name="搜索")`,`ClassName="mmui::XValidatorTextEdit"`
- - 聊天输入框:`EditControl(AutomationId="chat_input_field", ClassName="mmui::ChatInputField")`(搜索深度建议 >= 25)
- - 旧版 `EditControl(foundIndex=1)` 在新版微信打开公众号文章/视频后会错位(右侧内置浏览器有自己的输入框),已弃用。
- ## 常见问题
- ### 提示未找到微信窗口
- 确认微信 PC 客户端已启动并登录。程序会尝试通过微信默认快捷键 `Ctrl+Alt+W` 唤醒窗口;如果仍失败,请检查微信快捷键设置、窗口标题和系统 UI 自动化能力。
- ### 精简版或 Ghost 系统无法识别元素
- 按“系统辅助功能启用”章节操作一次:Win 键打开开始菜单,搜索并开启“讲述人”,开启后可立即关闭。这可以激活底层 UI 自动化接口。
- ### 关闭远程桌面后无法操作微信
- 不要直接锁屏或直接关闭 RDP 窗口后期待 UIA 继续稳定工作。请使用 `disconnect_rdp.bat` 断开远程桌面连接并保持会话回到本地控制台;必要时以管理员身份运行该脚本。
- ### 找不到联系人或发错会话
- 检查 `--to` 或 HTTP 请求中的 `to` 是否与微信里的联系人名称、群名称或备注完全一致。建议先用“文件传输助手”完成发送测试,再切换到真实联系人。
- ### 文本包含中文、换行或特殊字符是否支持
- 支持。文本发送优先使用剪贴板粘贴,不依赖逐字键盘输入,因此比 `SendKeys` 更适合中文和特殊符号。
- ### 什么时候需要 HTTP API
- 只有当你需要外部系统通过 HTTP 调用、后台队列、批量发送、状态查询或长期服务化运行时才需要 HTTP API。普通 Agent 发消息直接使用 Skill / CLI。
- ### CLI 常见错误代码
- - `WECHAT_WINDOW_NOT_FOUND`:未找到微信窗口。确认微信 PC 已启动并登录;精简版或 Ghost 系统可开启一次“讲述人”激活辅助功能。
- - `CONTACT_NOT_FOUND`:未找到联系人或群组。确认名称与微信备注、联系人名或群名完全一致。
- - `SEARCH_BOX_NOT_FOUND`:未找到微信搜索框。可能是微信 UI 变化、窗口未加载完成或系统 UI 自动化不可用。
- - `CHAT_INPUT_NOT_FOUND`:未找到聊天输入框。可能未进入目标会话或微信 UI 结构变化。
- - `CLIPBOARD_TEXT_FAILED`:文本写入剪贴板失败。检查系统剪贴板、`pyperclip` 或远程桌面会话状态。
- - `IMAGE_DOWNLOAD_FAILED` / `IMAGE_URL_NOT_IMAGE`:图片 URL 下载失败或返回内容不是图片。
- - `IMAGE_CLIPBOARD_FAILED`:图片复制到剪贴板失败。
- - `LOCAL_FILE_NOT_FOUND`:本地文件不存在。检查路径是否正确,建议使用绝对路径。
- - `LOCAL_FILE_INVALID`:路径不是文件,当前不支持发送目录。
- - `FILE_CLIPBOARD_FAILED`:本地文件复制到剪贴板失败。检查系统剪贴板或远程桌面会话状态。
- - `SEND_FILE_ERROR`:发送本地文件异常。
- - `DEPENDENCY_MISSING`:缺少 Python 依赖。请在项目根目录执行 `pip install -r requirements.txt`。
- - `CLI_EXCEPTION`:CLI 自身执行异常。
- ## 日志
- HTTP API 模式会写入 `wechat_automation.log`:
- ```powershell
- Get-Content wechat_automation.log -Tail 50
- Get-Content wechat_automation.log -Wait
- ```
- Skill / CLI 模式主要通过 stdout 返回执行结果。
- ## 许可证
- 本项目仅供学习和研究使用。请遵守微信客户端使用规范,并在自己的账号和设备上谨慎使用。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.