Skip to content
cyrus-xcPublic

About

Linux WeChat operation skill backed by a local MCP, with REA-guided reverse engineering.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

weSkill:薄荷与蓝色折射的玻璃对话气泡

weSkill

强大的 Linux 微信 Skill,把一句话变成一连串微信操作。

License: MIT Linux ARM64 / x86-64 Codex / Claude Local MCP

weSkill 让 Agent 直接操作 Linux 原生微信:查找联系人、理解聊天记录、发送消息与文件、管理好友和群聊、使用表情、读写朋友圈。一个总入口、五个协作 Skill、32 个 MCP 工具,让多步任务自然衔接。

底层通过原生调用执行,不抢鼠标、不占键盘焦点、不切换窗口。各个 Skill 复用本机服务与原生连接,服务空闲一小时自动退出,再次调用自动启动。原生操作统一串行,结束后持锁随机冷却 1–3 秒,再允许下一次操作;同时共享每用户任意连续 60 秒最多 20 次的提交额度,分页逐次计入,超出时等待;条数仍由调用方选择。

项目采用 REA(Reverse Engineer Anything) 工作流逆向 Linux 微信,将 ELF 静态分析与 Frida 动态验证所得的原生能力封装成 MCP,再由 Skill 编排任务。

快速开始 · 能力目录 · we-Agent · 开发文档

weSkill 使用流程:发送消息与媒体、群协作、表情与朋友圈

一句话,完成微信任务

把项目介绍和这张图片发给我指定的联系人,再整理最近 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 setup

setup 在用户目录创建独立 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

we-Agent 是基于 weSkill 的 Agent 流程管理项目,面向常驻响应、流程编排、知识库与行为控制。

开发文档

.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 ⭐,也欢迎贡献新能力、兼容适配与使用反馈。

About

Linux WeChat operation skill backed by a local MCP, with REA-guided reverse engineering.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages