wechatircd——用IRC客户端控制微信网页版

内容可能过时，最新文档参见：https://github.com/MaskRay/wechatircd。

wechatircd

wechatircd在wx.qq.com里注入JavaScript，用WebSocket与IRC server(wechatircd.py)通信，使得IRC客户端可以收发微信朋友、群消息、设置群名、邀请删除成员等。

1
2
3
4
           IRC               WebSocket                 HTTPS
IRC client --- wechatircd.py --------- browser         ----- wx.qq.com
                                       injector.user.js
                                       injector.js

安装

需要Python 3.5或以上，支持async/await语法 pip install -r requirements.txt安装依赖

Arch Linux

  • yaourt -S wechatircd-git。会在/etc/wechatircd/下生成自签名证书。
  • 把/etc/wechatircd/cert.pem导入到浏览器(见下文)
  • systemctl start wechatircd会运行/usr/bin/wechatircd --http-cert /etc/wechatircd/cert.pem --http-key /etc/wechatircd/key.pem --http-root /usr/share/wechatircd

IRC服务器默认监听127.0.0.1:6667 (IRC)和127.0.0.1:9000 (HTTPS + WebSocket over TLS)。

如果你在非本机运行，建议配置IRC over TLS，设置IRC connection password：/usr/bin/wechatircd --http-cert /etc/wechatircd/cert.pem --http-key /etc/wechatircd/key.pem --http-root /usr/share/wechatircd --irc-cert /path/to/irc.key --irc-key /path/to/irc.cert --irc-password yourpassword

可以把HTTPS私钥证书用作IRC over TLS私钥证书。使用WeeChat的话，如果觉得让WeeChat信任证书比较麻烦(gnutls会检查hostname)，可以用： 

1
2
3
set irc.server.wechat.ssl on`
set irc.server.wechat.ssl_verify off
set irc.server.wechat.password yourpassword`

其他发行版

  • openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -out cert.pem -subj '/CN=127.0.0.1' -days 9999创建密钥与证书。
  • 把cert.pem导入浏览器，见下文
  • ./wechatircd.py --http-cert cert.pem --http-key key.pem

导入自签名证书到浏览器

Chrome/Chromium

Firefox

  • 访问https://127.0.0.1:9000/injector.js，报告Your connection is not secure，Advanced->Add Exception->Confirm Security Exception
  • 安装Greasemonkey扩展，安装userscript

HTTPS、WebSocket over TLS默认用9000端口，使用其他端口需要修改userscript，启动wechatircd.py时用--web-port 10000指定其他端口。

使用

  • 运行wechatircd.py
  • 访问https://wx.qq.com，userscript注入的JavaScript会向服务器发起WebSocket连接
  • IRC客户端连接127.1:6667(weechat的话使用/server add wechat 127.1/6667)，会自动加入+wechat channel

在+wechat发信并不会群发，只是为了方便查看有哪些朋友。 微信朋友的nick优先选取备注名(RemarkName)，其次为DisplayName(原始JS根据暱称等自动填写的一个名字)

在+wechat channel可以执行一些命令：

  • help，帮助
  • status [pattern]，已获取的微信朋友、群列表，支持 pattern 参数用来筛选满足 pattern 的结果，目前仅支持子串查询。如要查询所有群，由于群由 & 开头，所以可以执行 status &。
  • eval $password $expr: 如果运行时带上了--password $password选项，这里可以eval，方便调试，比如eval $password client.wechat_users

服务器选项

  • Join mode，短选项-j
    • --join auto，默认：收到某个群第一条消息后自动加入，如果执行过/part命令了，则之后收到消息不会重新加入
    • --join all：加入所有channel
    • --join manual：不自动加入
    • --join new：类似于auto，但执行/part命令后，之后收到消息仍自动加入
  • 指定不自动加入的群名，用于补充join mode
    • --ignore 'fo[o]' bar，channel名部分匹配正则表达式fo[o]或bar
    • --ignore-topic 'fo[o]' bar, 群标题部分匹配正则表达式fo[o]或bar
  • HTTP/WebSocket相关选项
    • --http-cert cert.pem，HTTPS/WebSocketTLS的证书。你可以把证书和私钥合并为一个文件，省略--http-key选项。如果--http-cert和--http-key均未指定，使用不加密的HTTP
    • --http-key key.pem，HTTPS/WebSocket的私钥
    • --http-listen 127.1 ::1，HTTPS/WebSocket监听地址设置为127.1和::1，overriding --listen
    • --http-port 9000，HTTPS/WebSocket监听端口设置为9000
    • --http-root ., 存放injector.js的根目录
  • -l 127.0.0.1，IRC/HTTP/WebSocket监听地址设置为127.0.0.1
  • IRC相关选项
    • --irc-cert cert.pem，IRC over TLS的证书。你可以把证书和私钥合并为一个文件，省略--irc-key选项。如果--irc-cert和--irc-key均未指定，使用不加密的IRC
    • --irc-key key.pem，IRC over TLS的私钥
    • --irc-listen 127.1 ::1，IRC over TLS监听地址设置为127.1和::1，overriding --listen
    • --irc-nicks ray ray1，给客户端保留的nick。SpecialUser不会占用这些名字
    • --irc-password pass，IRC connection password设置为pass
    • --irc-port 6667，IRC监听端口
  • 服务端日志
    • --logger-ignore '&test0' '&test1'，不记录部分匹配指定正则表达式的朋友/群日志
    • --logger-mask '/tmp/wechat/$channel/%Y-%m-%d.log'，日志文件名格式
    • --logger-time-format %H:%M，日志单条消息的时间格式

IRC命令

  • 标准IRC channel名以#开头
  • WeChat群名以&开头。SpecialChannel#update
  • 联系人带有mode +v (voice, 通常显示为前缀+)。SpecialChannel#update_detail
  • 多行消息：!m line0\nline1
  • 多行消息：!html line0<br>line1
  • nick0: nick1: test会被转换成@GroupAlias0 @GroupAlias1 test，GroupAlias0是nick0在频道里的Group Alias，如果没设置的话就是Alias。GroupAlias0是移动端用户看到的名字
  • 回复12:34:SS的消息：@1234 !m multi\nline\nreply，会发送「Re GroupAlias: text」text
  • 回复12:34:56的消息：!m @123456 multi\nline\nreply
  • 回复朋友/群的倒数第二条消息：@2 reply

若客户端启用IRC 3.1 3.2的server-time扩展，wechatircd.py会在发送的消息中包含 网页版获取的时间戳。客户端显示消息时时间就会和服务器收到的消息的时刻一致。参见http://ircv3.net/irc/。参见http://ircv3.net/software/clients.html查看IRCv3的客户端支持情况。

WeeChat配置方式： 

1
/set irc.server_default.capabilities "account-notify,away-notify,cap-notify,multi-prefix,server-time,znc.in/server-time-iso,znc.in/self-message"

支持的IRC命令：

  • /cap，列出支持的capabilities
  • /dcc send $nick/$channel $filename, send image or file。This feature borrows the command /dcc send which is well supported in IRC clients. See https://en.wikipedia.org/wiki/Direct_Client-to-Client#DCC_SEND.
  • /invite $nick [$channel], invite a contact to the group.
  • /kick $nick，删除群成员，群主才有效。由于网页版限制，可能收不到群成员变更的消息
  • /list，列出所有群
  • /mode +m, --join new模式下防止自动重新join。用/mode -m撤销
  • /names, 更新当前群成员列表
  • /part $channel的IRC原义为离开channel，这里表示当前IRC会话中不再接收该群的消息。不用担心，telegramircd并没有主动退出群的功能
  • /query $nick，打开和$nick聊天的窗口
  • /summon $nick $message，发送添加朋友请求，$message为备注消息
  • /topic topic修改群标题。因为IRC不支持channel改名，实现为离开原channel并加入新channel
  • /who $channel，查看群的成员列表

显示

  • MSGTYPE_TEXT，文本或是视频/语音聊天请求，显示文本
  • MSGTYPE_IMG，图片，显示[Image]跟URL
  • MSGTYPE_VOICE，语音，显示[Image]跟URL
  • MSGTYPE_VIDEO，视频，显示[Video]跟URL
  • MSGTYPE_MICROVIDEO，微视频?，显示[MicroVideo]跟URL
  • MSGTYPE_APP，订阅号新文章、各种应用分享送红包、URL分享等属于此类，还有子分类APPMSGTYPE_*，显示[App]跟title跟URL

QQ表情会显示成<img class="qqemoji qqemoji0" text="[Smile]_web" src="/zh_CN/htmledition/v2/images/spacer.gif">样，发送时用[Smile]即可(相当于在网页版文本输入框插入文本后点击发送)。

Emoji在网页上呈现时为<img class="emoji emoji1f604" text="_web" src="/zh_CN/htmledition/v2/images/spacer.gif">，传送至IRC时转换成单个emoji字符。若使用终端IRC客户端，会因为emoji字符宽度为1导致重叠，参见终端模拟器下使用双倍宽度多色Emoji字体。

JS改动

修改的地方都有//@标注，结合diff，方便微信网页版JS更新后重新应用这些修改。增加的代码中大多数地方都用try catch保护，出错则consoleerr(ex.stack)。原始JS把console对象抹掉了……consoleerr是我保存的一个副本。

目前的改动如下：

webwxapp.js开头

创建到服务端的WebSocket连接，若onerror则自动重连。监听onmessage，收到的消息为服务端发来的控制命令：send_text_message、add_member等。

Hook contactFactory#addContact以记录联系人列表的变更

Python服务端代码

当前只有一个文件wechatircd.py，从miniircd抄了很多代码，后来自己又搬了好多RFC上的用不到的东西……

1
2
3
4
5
6
7
8
9
10
11
12
13
.
├── Web                      HTTP(s)/WebSocket server
├── Server                   IRC server
├── Channel
│   ├── StandardChannel      `#`开头的IRC channel
│   ├── StatusChannel        `+wechat`，查看控制当前微信会话
│   └── SpecialChannel       微信群对应的channel，仅该客户端可见
├── (User)
│   ├── Client               IRC客户端连接
│   ├── SpecialUser          微信用户对应的user，仅该客户端可见
├── (IRCCommands)
│   ├── UnregisteredCommands 注册前可用命令：NICK USER QUIT
│   ├── RegisteredCommands   注册后可用命令

FAQ

使用这个方法的理由

原本想研究微信网页版登录、收发消息的协议，自行实现客户端。参考过https://github.com/0x5e/wechat-deleted-friends，仿制了https://gist.github.com/MaskRay/3b5b3fcbccfcba3b8f29，可以登录。但根据minify后JS把相关部分重写非常困难，错误处理很麻烦，所以就让网页版JS自己来传递信息。

用途

可以使用强大的IRC客户端，方便记录日志(微信日志导出太麻烦https://maskray.me/blog/2014-10-14-wechat-export)，可以写bot。

微信数据获取及控制

少量特殊账户的UserName不带@前缀：newsapp,fmessage,filehelper,weibo,qqmail,fmessage等的；一般账户(公众号、服务号、直接联系人、群友)的UserName以@开头；微信群的UserName以@@开头。不同session UserName会变化。Uin应该是唯一id，但微信网页版API多数时候都返回0，隐藏了真实值。 群的OwnerUin字段是群主的Uin，但大群用户的Uin通常都为0，因此难以对应。

自己的帐号 

1
angular.element(document.body).scope().account

所有联系人列表 

1
angular.element($('#navContact')[0]).scope().allContacts

删除群中成员 

1
2
3
4
5
var injector = angular.element(document).injector()
# 这里获取了chatroomFactory，还可用于获取其他factory、service、controller等
var chatroomFactory = injector.get('chatroomFactory')
# 设置其中的`room`与`userToRemove`
chatroomFactory.delMember(room.UserName, userToRemove.UserName)`

名称中包含xxx的最近联系人列表中的群 

1
angular.element($('span:contains("xxx")')).scope().chatContact

当前窗口发送消息 

1
2
angular.element('pre:last').scope().editAreaCtn = "Hello，微信";
angular.element('pre:last').scope().sendTextMessage();

已知问题

1
2
3
4
5
6
7
8
9
10
11
Uncaught TypeError: angular.extend is not a function
    at Object.setUserInfo (index_0c7087d.js:4)
    at index_0c7087d.js:2
    at c (vendor_2de5d3a.js:11)
    at vendor_2de5d3a.js:11
    at c.$eval (vendor_2de5d3a.js:11)
    at c.$digest (vendor_2de5d3a.js:11)
    at c.$apply (vendor_2de5d3a.js:11)
    at l (vendor_2de5d3a.js:11)
    at m (vendor_2de5d3a.js:11)
    at XMLHttpRequest.C.onreadystatechange (vendor_2de5d3a.js:11)
1
Uncaught TypeError: angular.forEach is not a function

injector.js得在vendor_*.js后index_*.js前执行。但TamperMonkey无法精细控制script的运行时机。

参考