强大的 Linux 微信 Skill,把一句话变成一连串微信操作。
weSkill 让 Agent 直接操作 Linux 原生微信:查找联系人、理解聊天记录、发送消息与文件、管理好友和群聊、使用表情、读写朋友圈。一个总入口、五个协作 Skill、32 个 MCP 工具,让多步任务自然衔接。
底层通过原生调用执行,不抢鼠标、不占键盘焦点、不切换窗口。各个 Skill 复用本机服务与原生连接,服务空闲一小时自动退出,再次调用自动启动。原生操作统一串行,结束后持锁随机冷却 1–3 秒,再允许下一次操作;同时共享每用户任意连续 60 秒最多 20 次的提交额度,分页逐次计入,超出时等待;条数仍由调用方选择。
项目采用 REA(Reverse Engineer Anything) 工作流逆向 Linux 微信,将 ELF 静态分析与 Frida 动态验证所得的原生能力封装成 MCP,再由 Skill 编排任务。
把项目介绍和这张图片发给我指定的联系人,再整理最近 5 条聊天记录。
在指定群发布公告,@两位成员,并把指定消息置顶。
找一个名为“开心”的表情包发给指定好友,再把这张图发为仅自己可见的朋友圈。
| Skill | 职责 |
|---|---|
$weskill |
总入口、完整能力目录、搜索、历史与普通消息/媒体 |
$weskill-friends |
好友资料、备注、添加好友与申请处理 |
$weskill-group |
群成员、建群、邀请、管理设置与群协作 |
$weskill-emoji |
系统表情、个人收藏与在线搜索表情 |
$weskill-moments |
朋友圈时间线、个人动态与文字/图片发布 |
ARM64 保留原有能力。新增 x86-64 的联系人搜索、本地历史读取和私聊文字/图片/文件发送,已用 Cyrus 实测;另已在“weskill群管理测试”验证群消息与本地群成员读取,并向 Cyrus 验证系统表情和收藏表情包发送。群成员强制刷新、在线表情搜索、好友管理和朋友圈尚未移植。以下完整目录不代表所有架构均可执行,以 get_capabilities 和 x86-64 验证矩阵 为准。
基础与消息 · 搜索、历史、文本、图片、文件
- 联系人与群搜索:按关键词、自定义条数和排序查找,支持只搜索群。
search_contacts - 聊天历史:批量读取会话,默认 20 条;自定义条数,或用
0/null读取全部本机可读记录;可返回原始 XML;只读本机数据库与 WAL,支持压缩正文和分享卡片。get_messages - 私聊与群聊文本:共用原生发送接口。
send_text_message - 本地图片与文件:按本机路径发送到好友或群。
send_image/send_file - 客户端与能力识别:读取 ELF 架构、SHA-256、Build ID 和当前会话可用能力。
get_client_identity/get_capabilities - 共享服务:启动、续期、查看状态或在空闲时停止。
ensure_service/get_service_status/stop_service
好友管理 · 资料、备注、主动添加、申请处理
- 好友与群成员资料:读取本地可用昵称、微信号、备注、签名、地区、头像、电话列表、标签与来源。
get_friend_info - 修改备注:设置或清空好友备注。
set_contact_remark - 搜索新联系人:使用原生网络搜索获取添加对象。
search_new_contact - 主动添加好友:指定验证文字和备注。
add_friend - 查看好友申请:分页或全量读取,区分申请方向与当前联系人关系。
list_friend_requests - 接受好友申请:使用申请记录处理指定请求。
accept_friend_request
群管理 · 建群、邀请、成员、真实 @、公告、置顶
- 群资料与成员:查询公告、邀请确认状态、成员角色、群昵称及可用好友资料。
get_group_info/get_group_members - 发起群聊:用指定好友创建群聊并设置名称。
create_group - 邀请入群:向指定好友发起群聊邀请。
invite_group_members - 移出成员:群主或管理员移出指定成员,提交前刷新本人角色。
remove_group_members - 真实 @:向指定成员、多个成员或全体成员发送带原生提及元数据的消息。
send_group_mention - 群公告:发布、编辑或清空完整纯文本公告。
set_group_announcement - 消息置顶:按服务器消息 ID 置顶或取消。
pin_group_message - 邀请确认:开关“入群需要群主或管理员同意”。
set_group_invitation_confirmation
表情 · 系统表情、收藏表情、在线搜索与发送
- 系统表情:发现客户端识别的表情代码,通过文本接口发送。
list_system_emojis/send_text_message - 个人收藏:浏览收藏表情并选择素材。
list_saved_stickers - 在线搜索:按关键词搜索,支持分页续读。
search_stickers - 发送自定义表情 / GIF:复用微信原生下载与发送链路。
send_sticker
朋友圈 · 时间线、个人动态、文字与图片发布
- 读取动态:时间线、指定联系人的个人动态、游标分页与置顶内容。
get_moments - 发表动态:纯文字或本机图片,明确指定公开或仅自己可见。
publish_moments
工具参数与返回值见 工具参考,真实客户端验证范围见 能力说明。
推荐通过 npm 安装,一份包包含 CLI、五个 Skill 和 Python 原生执行层。准备 Node.js 22+、Python 3.12+(含 venv)与 GCC。原生操作支持 Linux ARM64 与 x86-64 的指定构建(各架构能力范围不同);本机微信位于 /opt/wechat/wechat 并已登录。构建识别方式见 兼容性说明。
npm install -g weskill
weskill setupsetup 在用户目录创建独立 Python 环境、安装依赖并编译原生桥,不连接微信、不发送消息。
Codex
weskill install codex自动注册本机 MCP,并安装五个 Codex Skill。
Claude Code
weskill install claude自动以用户范围注册 stdio MCP,并安装五个 Claude Skill。
其他 Agent 平台
支持本机 stdio MCP 的平台可直接使用执行层:
weskill config将输出中的 command 和 args 按宿主格式填入 MCP 配置。输出使用绝对路径,方便图形界面启动。支持 SKILL.md 的平台还可安装操作流程:
weskill skills --dir /path/to/agent/skills新开会话或重新连接 MCP,再调用 $weskill 或直接描述微信任务。原生模式提供 32 个工具;Agent 平台支持与微信原生构建适配是两个独立条件。详细安装、npx 接入与源码开发见 安装指南。
客户端返回 client_success 即按发送成功处理,结果未知时不自动重发。npm 安装的运行与幂等记录保存在用户数据目录,升级包时保留;服务管理和路径选项见 安装指南。
we-Agent 是基于 weSkill 的 Agent 流程管理项目,面向常驻响应、流程编排、知识库与行为控制。
- 如何探索与构建原生工具:从入口线索、ABI 和线程到回调生命周期、幂等与测试。
- 工具参考 · 能力与验证 · 兼容性 · 插件打包。
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python scripts/check_release.py原始研究、帐号数据与实验报告保留在本地忽略目录。工具使用本机 stdio 和同用户 Unix socket;查询结果会交给调用它的 AI 客户端。weSkill 是采用 MIT License 的非官方项目,与腾讯、微信、OpenAI 或 Anthropic 无隶属关系。
REA · Frida · MCP Python SDK · Pillow · OpenAI 插件规范 · Claude Code 插件规范。协议字段研究的更多参考见 开发指南。
觉得有用,欢迎给 weSkill 点一颗 Star ⭐,也欢迎贡献新能力、兼容适配与使用反馈。
