Skip to content
Back to search

"wechat-automation"

"微信发信能力:通过 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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lavarong--wechat-automation-api/badge.svg)](/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
  1. ---
  2. name: "wechat-automation"
  3. description: "微信发信能力:通过 Windows 桌面微信发送文本、图片URL或本地文件。适合各类 Agent 在本机直接发送一次性消息。触发词:给[某人]发微信、通知[某人]、把这个用微信发给[某人]、用微信发个图片、把本地文件发给[某人]"
  4. ---
  5. # 微信自动发信 Skill
  6. 赋予智能体掌控 Windows 桌面微信直接向真实用户或群组发送文本、图片URL或本地文件的能力。本 Skill 默认以同步命令行方式运行,执行一次命令发送一次消息,命令结束后立即退出。
  7. 只发送微信消息时,不需要专门启动后台 HTTP API,不需要运行 `run.bat`,也不需要调用 `scripts/app.py`。但**如果后台 HTTP API 恰好已在运行**,本 Skill 会**自动改走 API 队列模式**发送,以避免多个请求同时直接操作微信窗体造成冲突,详见下文「执行模式与结果判定」。
  8. ## 应用场景
  9. - **信息推送**:当你作为智能体完成了某项长耗时的搜索、总结或生图任务后,可以将最终结果或报告链接直接通过微信发送给用户指定的联系人。
  10. - **定时催办/打卡通知**:结合智能体的定时任务机制,向目标群组发送通知。
  11. - **跨平台转发**:将抓取到的内容(特别如新闻图片、数据图表链接)作为微信信息直接转发。
  12. - **任务链收尾**:先完成搜索、分析、运行命令、生成报告等任务,再把最终摘要或结果通过微信发送给指定联系人或群。
  13. - **本地文件转发**:把 Agent 生成的报告、截图、表格、压缩包、本地图片等文件直接发给指定联系人或群。
  14. ## 典型触发语句
  15. - “帮我给 **LAVA** 发个微信,就说**我今天晚点到**。”
  16. - “把刚才总结的**会议纪要**发到**工作群**里。”
  17. - “下载这个图片,用微信发给 **文件传输助手**。”
  18. - “帮我通知一下 **张三**,让他**明天带电脑**。”
  19. - “查询今天关于 **AI** 的最新新闻,整理成简洁总结,然后通过微信发送到联系人 **文件传输助手**。”
  20. - “把这次运行结果总结整理,通过微信发送到 **项目通知群**。”
  21. - “把本机上的 **C:\tmp\report.xlsx** 通过微信发送给 **文件传输助手**。”
  22. - “把刚生成的截图发到 **项目群**。”
  23. ## 作为 Skill 调用的规范指令
  24. 本 Skill 调用后会直接返回结果并退出,不会常驻内存。请在项目根目录中使用以下语法调用:
  25. ### 发送文本消息
  26. ```powershell
  27. python scripts/skill_cli.py --to "联系人或群组名称" --content "你要发送的具体文本"
  28. ```
  29. ### 发送图片消息
  30. ```powershell
  31. python scripts/skill_cli.py --to "联系人或群组名称" --content "https://example.com/image.png" --action "sendpic"
  32. ```
  33. 如果 `sendpic` 的 `--content` 是本地路径,则不会下载图片,会直接按本地文件复制并粘贴到微信。
  34. ### 发送本地文件或本地图片
  35. ```powershell
  36. python scripts/skill_cli.py --to "联系人或群组名称" --content "C:\path\to\file.zip" --action "sendfile"
  37. ```
  38. 本地图片、PDF、Office 文档、压缩包等都使用 `sendfile`。Agent 发送自己刚生成的文件时,应优先使用绝对路径。
  39. ### 发送测试
  40. 首次安装或接入 Agent 后,优先向“文件传输助手”发送测试消息:
  41. ```powershell
  42. python scripts/skill_cli.py --to "文件传输助手" --content "这是一条来自 Agent Skill 的测试消息"
  43. ```
  44. stdout 输出 `发送成功` 表示任务完成。stdout 输出 `发送失败` 或 `执行异常` 时,应将错误信息原样反馈给用户。
  45. 如需更稳定地解析结果,可追加 `--json`:
  46. ```powershell
  47. python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --json
  48. ```
  49. JSON 输出字段包含 `success`、`code`、`message`、`to`、`action`。`success=true` 表示发送请求已被成功受理;`success=false` 表示未成功(同步模式下即为发送失败,详见下文模式说明)。
  50. ## 执行模式与结果判定
  51. 本 Skill 有两种执行模式,默认会**自动选择**:
  52. - **同步 CLI 模式**(默认,且后台 API 未运行时):直接操作微信窗体发送,命令返回的 `success` 即为**真实发送结果**。失败会给出 `CONTACT_NOT_FOUND`、`WECHAT_WINDOW_NOT_FOUND` 等具体 `code`。需要确切知道"是否真的发出去了"时用这个模式。
  53. - **API 队列模式**(后台 `app.py` / `run.bat` 已在运行,且 `config.json` 配好 `token` 时自动启用):把消息提交到后台 HTTP 队列,由后台串行异步发送,多个请求不会互相抢占微信窗体。**注意:此模式下 `success=true` 仅表示"消息已入队受理",并不代表已成功送达**;真实发送结果需查询后台 `GET /status` 或服务端日志 `wechat_automation.log`。
  54. 可用以下参数显式指定模式(不加则自动判定):
  55. | 参数 | 作用 |
  56. | --- | --- |
  57. | `--no-api` | 强制同步 CLI 模式,跳过 API 自动检测,确保拿到真实发送结果 |
  58. | `--api` | 强制 API 队列模式(需先启动后台服务并配置 `token`,否则报错) |
  59. | `--lock-mouse` | 发送期间临时锁定鼠标,防止用户误触干扰(同步 CLI 模式生效) |
  60. | `--no-lock-mouse` | 发送时不锁定鼠标(默认使用 config.json 的 lock_mouse_during_send 配置) |
  61. ```powershell
  62. # 强制同步发送并拿真实结果(不论后台 API 是否在运行)
  63. python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --no-api --json
  64. ```
  65. **给 Agent 的判定建议**:常规发信依据退出码与 `success` 判断任务是否被受理即可;若任务**必须确认真实送达**(如重要通知),请追加 `--no-api` 走同步模式,再据 `code` 反馈用户。
  66. ## 安装与运行环境
  67. 1. Windows 10/11,微信 PC 客户端已启动并登录。
  68. 2. 在项目根目录安装依赖:`pip install -r requirements.txt`。
  69. 3. Agent 执行本 Skill 时,工作目录应为本项目根目录,确保 `python scripts/skill_cli.py ...` 可以找到 `scripts/wechat_controller.py`。
  70. 4. 不要为普通发消息任务启动后台 HTTP API;HTTP API 只用于长期服务、队列和外部系统集成。
  71. ## 系统辅助功能启用
  72. 若运行环境为精简版或 Ghost 系统,需确保 Windows 辅助功能正常运行。通过键盘 Win 键唤出开始菜单,输入“讲述人”并开启该功能(开启后可立即关闭),此操作可确保系统底层 UI 自动化接口处于激活状态,避免程序无法识别元素。
  73. ## 注意事项与约束
  74. 1. **必须精确匹配名称**:`--to` 参数指定的联系人或群组名称必须与微信内的备注或网名**完全一致**(区分大小写和空格),否则可能导致发送失败或发错人。
  75. 2. **直接执行命令**:不要试图使用视觉模型去理解或分析微信页面。直接执行上述命令行命令即可,底层脚本已封装窗体查找、联系人搜索和发送操作。
  76. 3. **识别执行结果**:执行后请读取 stdout 和退出码。退出码 `0` 表示请求已被受理;退出码非 `0` 表示失败。如果输出 `发送失败` 或 JSON 中 `success=false`,请**原封不动**把 `message` 和 `code` 反馈给用户,不要擅自循环重试。注意:当输出为 `消息已提交发送队列受理…` 时表示走了 API 队列模式(异步),仅代表受理成功;需确认真实送达请改用 `--no-api`。
  77. 4. **长文本分段发送**:如果要发送的文字内容超过 2000 字,Agent 应主动拆成多段,分多次调用本 Skill 发送。每段建议不超过 2000 字,并在内容开头标明序号,例如 `【1/3】...`、`【2/3】...`、`【3/3】...`。
  78. 5. **特殊字符支持**:内容中可以直接包含换行符(`\n`)或表情符号文本,脚本层会自动处理转义与输入,请放心传入。
  79. 6. **本地文件用绝对路径**:发送本机文件或本机图片时,优先传绝对路径,例如 `C:\tmp\report.pdf`。相对路径会按当前工作目录解析。
  80. 7. **避免重复发送**:失败后不要自动多次重试,除非用户明确要求。
  81. ## 异常处理与反馈
  82. CLI 会尽量给出明确失败原因,常见 `code` 包括:
  83. - `WECHAT_WINDOW_NOT_FOUND`:未找到微信窗口。请确认微信 PC 已启动并登录;精简版或 Ghost 系统可按“系统辅助功能启用”处理。
  84. - `CONTACT_NOT_FOUND`:未找到联系人或群组。请确认 `--to` 与微信备注、联系人名或群名完全一致。
  85. - `SEARCH_BOX_NOT_FOUND`:未找到微信搜索框。可能是微信 UI 结构变化、窗口未加载完成或系统 UI 自动化不可用。
  86. - `CHAT_INPUT_NOT_FOUND`:未找到聊天输入框。可能未成功进入目标会话,或微信 UI 结构变化。
  87. - `CLIPBOARD_TEXT_FAILED`:文本写入剪贴板失败。请检查系统剪贴板、`pyperclip` 或远程桌面会话状态。
  88. - `IMAGE_DOWNLOAD_FAILED` / `IMAGE_URL_NOT_IMAGE`:图片 URL 下载失败或返回内容不是图片。
  89. - `IMAGE_CLIPBOARD_FAILED`:图片复制到剪贴板失败。
  90. - `LOCAL_FILE_NOT_FOUND`:本地文件不存在。请检查路径是否正确,建议使用绝对路径。
  91. - `LOCAL_FILE_INVALID`:路径不是文件,当前不支持发送目录。
  92. - `FILE_CLIPBOARD_FAILED`:本地文件复制到剪贴板失败。请检查系统剪贴板或远程桌面会话状态。
  93. - `SEND_FILE_ERROR`:发送本地文件异常。
  94. - `DEPENDENCY_MISSING`:缺少 Python 依赖。请在项目根目录执行 `pip install -r requirements.txt`。
  95. - `CLI_EXCEPTION`:CLI 自身执行异常。
  96. Agent 遇到失败时应停止当前发送任务,把错误原因反馈给用户,并建议用户检查对应环境或联系人名称。
  97. ## 开发者辅助工具
  98. 如需维护或扩展元素查找逻辑,建议使用 Visual Studio SDK 自带的 `Inspect.exe` 工具(或 Windows SDK 工具包),用于实时查看微信窗口的 UI 元素树结构、`Name`、`AutomationID` 及 `ClassName` 等关键属性,辅助编写元素查找逻辑。
README.md · README · 377 lines
  1. # 微信自动化发信 Skill / HTTP API
  2. 这是一个面向 Windows 桌面微信的自动化发信工具,核心能力是通过 `uiautomation` 控制已登录的微信客户端发送文本、图片 URL 或本地文件。项目提供两种入口:
  3. - **Skill / CLI 入口**:推荐给各类 Agent 使用。一次命令完成一次发送,执行后立即退出;只发送消息时无需启动后台 HTTP API。
  4. - **HTTP API 入口**:适合外部系统长期集成、批量投递和队列处理,需要启动 Flask 后台服务。
  5. 本项目不使用 Hook、不接入微信协议,只通过 Windows UI 自动化操作本机微信窗口。
  6. ## Skill 用法
  7. 这是最推荐的使用方式:你只需要用自然语言告诉智能体要把什么内容发给谁,智能体会自动调用 Skill,不需要你手写命令,也不需要启动后台 HTTP API。
  8. ### 安装
  9. ```text
  10. 请帮我安装部署这个skill https://github.com/LAVARONG/wechat-automation-api ,完成后给微信联系人“文件传输助手”发送“这是来着微信自动化发信 Skill 的测试信息”
  11. ```
  12. 智能体会自动拉取仓库、读取 `SKILL.md`,并按项目说明准备运行环境。如果正常,会操作微信给“文件传输助手”发送测试信息。请提前确保 PC 版微信已经登录。
  13. ### 玩法示例
  14. 安装完成后,可以直接这样对智能体说:
  15. ```text
  16. 查询今天关于 AI 的最新新闻,整理成简洁的总结,然后通过微信发送到联系人“文件传输助手”。
  17. ```
  18. ```text
  19. 把这次运行结果整理成 5 条要点,通过微信发送到“项目通知群”。
  20. ```
  21. ```text
  22. 下载这张图片并通过微信发给“文件传输助手”。
  23. ```
  24. ```text
  25. 给微信的“文件传输助手”发送我下载目录下最新的一张图片。
  26. ```
  27. ```text
  28. 把刚生成的 C:\tmp\report.xlsx 通过微信发送给“文件传输助手”。
  29. ```
  30. ```text
  31. 把当前项目的测试结果总结一下,然后通过微信发给“项目通知群”。
  32. ```
  33. 普通发消息、发图片、发本地文件都走 Skill 即可,不需要运行 `run.bat`,也不需要启动 `scripts/app.py`。
  34. ## CLI 用法
  35. CLI 适合开发者手动测试、排查环境问题,或在本机脚本里直接调用。
  36. ### 手动安装环境
  37. 先确保满足以下条件:
  38. - Windows 10/11
  39. - Python 3.7+
  40. - 微信 PC 客户端已启动并登录
  41. - 微信窗口可被系统 UI 自动化识别
  42. 在项目根目录安装依赖:
  43. ```powershell
  44. pip install -r requirements.txt
  45. ```
  46. ### 发送文本
  47. 在项目根目录执行:
  48. ```powershell
  49. python scripts/skill_cli.py --to "文件传输助手" --content "这是一条 Skill CLI 测试消息"
  50. ```
  51. 成功时 stdout 会输出:
  52. ```text
  53. 发送成功: 已向「文件传输助手」发送文本消息。
  54. ```
  55. 失败时会输出明确原因和错误代码,例如:
  56. ```text
  57. 发送失败: 未找到联系人或群组: 文件传输助手。请确认名称与微信备注/群名完全一致。
  58. 错误代码: CONTACT_NOT_FOUND
  59. ```
  60. 这通常表示微信窗口未找到、联系人名称不匹配、系统 UI 自动化不可用或剪贴板不可用。
  61. ### 发送图片 URL
  62. 图片发送使用 URL,脚本会下载图片并通过剪贴板粘贴到微信:
  63. ```powershell
  64. python scripts/skill_cli.py --to "文件传输助手" --content "https://example.com/image.png" --action "sendpic"
  65. ```
  66. ### 发送本地图片
  67. ```powershell
  68. python scripts/skill_cli.py --to "文件传输助手" --content "C:\tmp\screenshot.png" --action "sendpic"
  69. ```
  70. 如果传入的是本地路径,`sendpic` 会自动跳过下载,按本地文件粘贴发送。
  71. ### 发送本地文件
  72. 发送本机上的任意文件时使用 `sendfile`:
  73. ```powershell
  74. python scripts/skill_cli.py --to "文件传输助手" --content "C:\tmp\report.xlsx" --action "sendfile"
  75. ```
  76. 建议 Agent 使用绝对路径,避免相对路径因工作目录不同而找不到文件。
  77. ### JSON 输出
  78. 需要稳定解析时可追加 `--json`:
  79. ```powershell
  80. python scripts/skill_cli.py --to "文件传输助手" --content "测试消息" --json
  81. ```
  82. 输出包含 `success`、`code`、`message`、`to`、`action`。退出码 `0` 表示成功,非 `0` 表示失败。
  83. ### 鼠标防干扰与锁定选项
  84. 默认情况下,程序采用**无感瞬发模式**(输入框原生 `SetFocus` 聚焦 + 毫秒级光标原路复位),发送消息时物理鼠标指针几乎不移动,彻底杜绝光标乱飞。
  85. 若在自动化批量执行期间需要防止人手无意晃动鼠标造成点击偏离,可追加 `--lock-mouse`:
  86. ```powershell
  87. # 发信期间临时冻结鼠标操作(操作完成瞬间自动解锁)
  88. python scripts/skill_cli.py --to "文件传输助手" --content "重要通知" --lock-mouse
  89. ```
  90. 也可以通过 `--no-lock-mouse` 强制使用普通无感模式。
  91. ## 系统辅助功能启用
  92. 若运行环境为精简版或 Ghost 系统,需确保 Windows 辅助功能正常运行。通过键盘 Win 键唤出开始菜单,输入“讲述人”并开启该功能(开启后可立即关闭),此操作可确保系统底层 UI 自动化接口处于激活状态,避免程序无法识别元素。
  93. ## 远程桌面与锁屏
  94. 本项目依赖 Windows UI Automation 操作微信窗口。Windows 锁屏状态下 UIA 通常不可用;服务器通过远程桌面 RDP 登录后,如果直接关闭远程桌面窗口,也可能导致鼠标、键盘和 UI 自动化失效,从而无法继续操作微信。
  95. 在服务器远程桌面场景中,建议使用项目自带的 `disconnect_rdp.bat` 断开远程桌面连接。它会尝试执行 `tscon <会话ID> /dest:console`,将当前 RDP 会话切回本地控制台并保持会话运行,用于解决关闭远程桌面后鼠标键盘失效的问题。
  96. 使用方式:
  97. ```powershell
  98. .\disconnect_rdp.bat
  99. ```
  100. 如执行失败,请尝试以管理员身份运行,并确认当前确实处于远程桌面会话中。
  101. ## HTTP API 模式
  102. HTTP API 模式适合长期运行的服务化场景,例如外部系统通过 HTTP 投递消息、批量发送到多个联系人、使用队列控制发送间隔。
  103. ### 准备配置
  104. 复制配置示例:
  105. ```powershell
  106. Copy-Item config.json.example config.json
  107. notepad config.json
  108. ```
  109. 配置示例:
  110. ```json
  111. {
  112. "token": "your_secret_token_here",
  113. "host": "127.0.0.1",
  114. "port": 8808,
  115. "message_interval": 1,
  116. "lock_mouse_during_send": false,
  117. "log_level": "INFO",
  118. "log_file": "wechat_automation.log"
  119. }
  120. ```
  121. 配置说明:
  122. - `lock_mouse_during_send`:可选,默认 `false`。若设为 `true`,在发信的大约 1 秒关键窗口期内临时锁定鼠标/键盘,防止人机争抢,操作完成后立即解锁。
  123. `config.json` 已加入 `.gitignore`,可用于保存本地 token。
  124. ### 启动服务
  125. ```powershell
  126. .\run.bat
  127. ```
  128. 或直接运行:
  129. ```powershell
  130. python scripts/app.py
  131. ```
  132. 启动后默认监听:
  133. ```text
  134. POST http://127.0.0.1:8808/
  135. GET http://127.0.0.1:8808/status
  136. GET http://127.0.0.1:8808/health
  137. ```
  138. ### HTTP 发送文本
  139. ```powershell
  140. $body = @{
  141. token = "your_secret_token_here"
  142. action = "sendtext"
  143. to = @("文件传输助手")
  144. content = "这是一条 HTTP API 测试消息"
  145. } | ConvertTo-Json
  146. Invoke-RestMethod -Uri "http://127.0.0.1:8808/" -Method Post -Body $body -ContentType "application/json"
  147. ```
  148. ### HTTP 发送图片 URL
  149. ```powershell
  150. $body = @{
  151. token = "your_secret_token_here"
  152. action = "sendpic"
  153. to = @("文件传输助手")
  154. content = "https://example.com/image.png"
  155. } | ConvertTo-Json
  156. Invoke-RestMethod -Uri "http://127.0.0.1:8808/" -Method Post -Body $body -ContentType "application/json"
  157. ```
  158. ### HTTP 发送本地文件
  159. ```powershell
  160. $body = @{
  161. token = "your_secret_token_here"
  162. action = "sendfile"
  163. to = @("文件传输助手")
  164. content = "C:\tmp\report.xlsx"
  165. } | ConvertTo-Json
  166. Invoke-RestMethod -Uri "http://127.0.0.1:8808/" -Method Post -Body $body -ContentType "application/json"
  167. ```
  168. 成功响应示例:
  169. ```json
  170. {
  171. "success": true,
  172. "message": "消息已加入队列",
  173. "queued_count": 1,
  174. "queue_size": 1
  175. }
  176. ```
  177. ## 项目结构
  178. ```text
  179. wechat-automation-api/
  180. ├── scripts/
  181. │ ├── skill_cli.py # Agent Skill / CLI 同步发送入口
  182. │ ├── wechat_controller.py # 微信窗口查找、联系人搜索、文本/图片发送逻辑
  183. │ ├── app.py # Flask HTTP API 服务入口
  184. │ ├── message_queue.py # HTTP 模式消息队列
  185. │ └── monitor.py # 微信状态监控脚本
  186. ├── examples/
  187. │ └── wx.py # uiautomation 最小验证示例
  188. ├── test/
  189. │ └── test_api.py # HTTP API 测试脚本
  190. ├── docs/
  191. │ └── changelog.md # 更新日志
  192. ├── SKILL.md # Agent Skill 使用说明
  193. ├── requirements.txt # Python 依赖
  194. ├── config.json.example # HTTP API 配置示例
  195. ├── run.bat # HTTP API 快捷启动脚本
  196. └── README.md # 项目说明
  197. ```
  198. ## 工作原理
  199. Skill / CLI 模式:
  200. 1. Agent 或用户执行 `python scripts/skill_cli.py ...`
  201. 2. 脚本创建 `WeChatController`
  202. 3. 控制器查找并激活微信窗口
  203. 4. 优先从会话列表定位联系人,失败后使用搜索框
  204. 5. 通过剪贴板粘贴文本、图片或本地文件并按 Enter 发送
  205. 6. 命令返回 `发送成功` 或失败原因并退出
  206. HTTP API 模式:
  207. 1. Flask 接收 HTTP 请求并验证 token
  208. 2. 请求被加入消息队列
  209. 3. 后台线程按顺序调用 `WeChatController`
  210. 4. 按配置的 `message_interval` 控制发送间隔
  211. ## 开发者辅助工具
  212. 编写或调整元素查找逻辑时,建议准备 UI 自动化查看工具:
  213. - 使用 Visual Studio SDK 自带的 `Inspect.exe` 工具,或 Windows SDK 工具包中的 Inspect 工具。
  214. - 用于实时查看微信窗口的 UI 元素树结构、`Name`、`AutomationID`、`ClassName` 等关键属性。
  215. - 当微信版本更新导致控件名称或层级变化时,优先用 Inspect 重新确认元素属性,再修改 `scripts/wechat_controller.py` 中的查找逻辑。
  216. 当前代码中比较关键的定位点包括:
  217. - 微信主窗口:
  218. - 微信 4.x (Qt 架构):`ClassName="mmui::MainWindow"`(注意:窗口 `Name` 为当前登录微信账号的个人昵称,不可限定 `Name="微信"`)
  219. - 微信 3.x (Win32 架构):`ClassName="WeChatMainWndForPC"`,`Name="微信"`
  220. - 会话项:`ClassName="mmui::ChatSessionCell"`,`AutomationId="session_item_<联系人名>"`(搜索深度建议 >= 20)
  221. - 搜索框:`EditControl(Name="搜索")`,`ClassName="mmui::XValidatorTextEdit"`
  222. - 聊天输入框:`EditControl(AutomationId="chat_input_field", ClassName="mmui::ChatInputField")`(搜索深度建议 >= 25)
  223. - 旧版 `EditControl(foundIndex=1)` 在新版微信打开公众号文章/视频后会错位(右侧内置浏览器有自己的输入框),已弃用。
  224. ## 常见问题
  225. ### 提示未找到微信窗口
  226. 确认微信 PC 客户端已启动并登录。程序会尝试通过微信默认快捷键 `Ctrl+Alt+W` 唤醒窗口;如果仍失败,请检查微信快捷键设置、窗口标题和系统 UI 自动化能力。
  227. ### 精简版或 Ghost 系统无法识别元素
  228. 按“系统辅助功能启用”章节操作一次:Win 键打开开始菜单,搜索并开启“讲述人”,开启后可立即关闭。这可以激活底层 UI 自动化接口。
  229. ### 关闭远程桌面后无法操作微信
  230. 不要直接锁屏或直接关闭 RDP 窗口后期待 UIA 继续稳定工作。请使用 `disconnect_rdp.bat` 断开远程桌面连接并保持会话回到本地控制台;必要时以管理员身份运行该脚本。
  231. ### 找不到联系人或发错会话
  232. 检查 `--to` 或 HTTP 请求中的 `to` 是否与微信里的联系人名称、群名称或备注完全一致。建议先用“文件传输助手”完成发送测试,再切换到真实联系人。
  233. ### 文本包含中文、换行或特殊字符是否支持
  234. 支持。文本发送优先使用剪贴板粘贴,不依赖逐字键盘输入,因此比 `SendKeys` 更适合中文和特殊符号。
  235. ### 什么时候需要 HTTP API
  236. 只有当你需要外部系统通过 HTTP 调用、后台队列、批量发送、状态查询或长期服务化运行时才需要 HTTP API。普通 Agent 发消息直接使用 Skill / CLI。
  237. ### CLI 常见错误代码
  238. - `WECHAT_WINDOW_NOT_FOUND`:未找到微信窗口。确认微信 PC 已启动并登录;精简版或 Ghost 系统可开启一次“讲述人”激活辅助功能。
  239. - `CONTACT_NOT_FOUND`:未找到联系人或群组。确认名称与微信备注、联系人名或群名完全一致。
  240. - `SEARCH_BOX_NOT_FOUND`:未找到微信搜索框。可能是微信 UI 变化、窗口未加载完成或系统 UI 自动化不可用。
  241. - `CHAT_INPUT_NOT_FOUND`:未找到聊天输入框。可能未进入目标会话或微信 UI 结构变化。
  242. - `CLIPBOARD_TEXT_FAILED`:文本写入剪贴板失败。检查系统剪贴板、`pyperclip` 或远程桌面会话状态。
  243. - `IMAGE_DOWNLOAD_FAILED` / `IMAGE_URL_NOT_IMAGE`:图片 URL 下载失败或返回内容不是图片。
  244. - `IMAGE_CLIPBOARD_FAILED`:图片复制到剪贴板失败。
  245. - `LOCAL_FILE_NOT_FOUND`:本地文件不存在。检查路径是否正确,建议使用绝对路径。
  246. - `LOCAL_FILE_INVALID`:路径不是文件,当前不支持发送目录。
  247. - `FILE_CLIPBOARD_FAILED`:本地文件复制到剪贴板失败。检查系统剪贴板或远程桌面会话状态。
  248. - `SEND_FILE_ERROR`:发送本地文件异常。
  249. - `DEPENDENCY_MISSING`:缺少 Python 依赖。请在项目根目录执行 `pip install -r requirements.txt`。
  250. - `CLI_EXCEPTION`:CLI 自身执行异常。
  251. ## 日志
  252. HTTP API 模式会写入 `wechat_automation.log`:
  253. ```powershell
  254. Get-Content wechat_automation.log -Tail 50
  255. Get-Content wechat_automation.log -Wait
  256. ```
  257. Skill / CLI 模式主要通过 stdout 返回执行结果。
  258. ## 许可证
  259. 本项目仅供学习和研究使用。请遵守微信客户端使用规范,并在自己的账号和设备上谨慎使用。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.