| name | qq-friend-message |
| description | Windows 本机 QQ 普通好友消息 GUI 自动化。在本项目 QQ/频道等外部消息自动问答中，只能用于发送已通过项目批准口令门禁的回复：`#配置推荐` 仅限电脑配置相关问题，`#集院问答` 仅限新生生活、学业课程、竞赛科研及基于已提供资料的校园问答；未匹配批准口令时不得生成通用 AI 自动回复。用于在 QQ 桌面客户端已登录时，按好友昵称或备注名打开普通好友单聊并填入消息；只有用户明确要求直接发送时才发送。适用于用户说“用 QQ 给某个普通好友发消息”“QQ 好友消息”“不是 QQ 频道”的场景。 |
| metadata | {"version":"0.1.0","tags":"qq windows gui automation friend-message"} |
QQ Friend Message
这个 skill 通过 Windows 桌面 GUI 自动化控制本机 QQ 客户端，用于普通 QQ 好友单聊。它不是 QQ 频道接口，也不依赖 tencent-channel-cli。
项目全局 AI 自动回复门禁
在本项目的 QQ、QQ群、QQ 频道、帖子、评论、私信或其他外部消息自动问答场景中，本技能只能发送已经通过项目批准口令门禁的回复。
当前批准路线：
#配置推荐：仅限电脑配置、大学新生购机、笔记本/台式机选购、DIY 装机、硬件兼容性、预算配置、游戏/AI/仿真性能、电商比价或购买渠道。未通过该路线时，按电脑配置推荐技能的兜底规则处理。#集院问答：仅限新生生活、学业课程、竞赛科研，以及基于已提供资料的校园问答。带口令但越界时只发送范围说明；资料不足时说明无法确认并建议查看官方通知或咨询辅导员、教务/教学办。
不得因为用户发起 QQ 好友消息、私信、群消息或聊天内容，就绕过本项目门禁变成通用 AI 问答。
适用场景
- 用户要给普通 QQ 好友发消息。
- 用户明确说不是 QQ 频道，而是 QQ 好友聊天。
- 本机 Windows QQ 客户端已经登录，并且好友可以通过昵称或备注名搜索到。
硬性安全规则
- 用户要求发送 QQ 好友消息或文件时，先向用户确认目标好友和内容/文件。
- 用户确认后，自动调用
send 或 send-file 完成发送，不再要求用户手动点击 QQ 的发送按钮。
- 如果用户只要求草稿、预填、检查，才使用
fill，只打开会话并填入消息，不发送。
- 使用
send 时必须传入确认文本：--confirm-text "发送给<昵称>"；使用 send-file 时必须传入确认文本：--confirm-text "发送文件给<昵称>"。
- 不支持群聊、批量群发、营销骚扰或绕过平台限制。
- 找不到好友、搜索结果不可靠、无法确认当前会话时必须停止，不要猜测目标。
- 不要在日志或最终回复中复述长消息全文；只说明成功填入/发送或失败原因。
依赖
需要 Windows + Python 3.8+，并安装：
pip install pywinauto pyperclip
不要自动安装依赖；如果脚本提示缺依赖，告诉用户运行上面的命令。
命令
所有命令从项目根目录执行。
环境检查
python .claude/skills/qq-friend-message/scripts/qq_send.py check
控件树调试
python .claude/skills/qq-friend-message/scripts/qq_send.py inspect --depth 3
安全预填（默认推荐）
python .claude/skills/qq-friend-message/scripts/qq_send.py fill \
--nickname "纯乎一芯" \
--message "消息内容"
执行后应停在 QQ 输入框，消息已填入但未发送。
明确确认后发送
python .claude/skills/qq-friend-message/scripts/qq_send.py send \
--nickname "纯乎一芯" \
--message "消息内容" \
--confirm-text "发送给纯乎一芯"
明确确认后发送文件
python .claude/skills/qq-friend-message/scripts/qq_send.py send-file \
--nickname "纯乎一芯" \
--file "g:/My_code/trae_solo/QQ_auto_Q&A/freshman-pc-recommendation-20260527.pdf" \
--confirm-text "发送文件给纯乎一芯"
默认倒计时 3 秒后用 Enter 触发发送。如果用户 QQ 设置为 Ctrl+Enter 发送，可增加：
--send-keys "^{ENTER}"
故障处理
- 未找到 QQ 窗口：请用户先打开并登录 Windows QQ。
- 缺依赖：提示
pip install pywinauto pyperclip。
- 无法确认会话：不要发送，建议先运行
inspect 查看当前 QQ 版本控件树，或让用户手动打开目标聊天后再尝试。
- 多个 QQ/TIM 窗口：使用
--title-hint 指定窗口标题关键词。
