README.md 24.0 KB
Newer Older
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
1
[![Wechaty](https://raw.githubusercontent.com/wechaty/wechaty/master/image/wechaty-logo-en.png)](https://github.com/wechaty/wechaty)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
2
# Wechaty [![Linux Circle CI](https://circleci.com/gh/wechaty/wechaty.svg?style=svg)](https://circleci.com/gh/wechaty/wechaty) [![Linux/Mac Build Status](https://img.shields.io/travis/wechaty/wechaty.svg?label=Linux/Mac)](https://travis-ci.org/wechaty/wechaty) [![Win32 Build status](https://img.shields.io/appveyor/ci/zixia/wechaty/master.svg?label=Windows)](https://ci.appveyor.com/project/zixia/wechaty) [![Coverage Status](https://coveralls.io/repos/github/wechaty/wechaty/badge.svg?branch=master)](https://coveralls.io/github/wechaty/wechaty?branch=master)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
3

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
4
### Connecting ChatBots.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
5

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
6
Wechaty is a Bot Framework for Wechat **Personal** Account that help you easy creating personal wechat bot in 7 lines of javascript code, with cross platform  support to [linux](https://travis-ci.org/wechaty/wechaty), [win32](https://ci.appveyor.com/project/zixia/wechaty) and [darwin(OSX/Mac)](https://travis-ci.org/wechaty/wechaty).
7

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
8 9 10
:octocat: <https://github.com/wechaty/wechaty>  
:beetle: <https://github.com/wechaty/wechaty/issues>  
:book: <https://github.com/wechaty/wechaty/wiki>  
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
11
:whale: <https://hub.docker.com/r/zixia/wechaty>  
12

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
13
[![Join the chat at https://gitter.im/zixia/wechaty](https://badges.gitter.im/zixia/wechaty.svg)](https://gitter.im/zixia/wechaty?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
14
[![node](https://img.shields.io/node/v/wechaty.svg?maxAge=2592000)](https://nodejs.org/)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
15
[![Repo Size](https://reposs.herokuapp.com/?path=wechaty/wechaty)]()
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
16

17
## Voice of the Developer
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
18

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
19
> @GasLin : it may be the best wecaht sdk i have seen in github! [link](https://github.com/wechaty/wechaty/issues/8#issuecomment-228971491)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
20

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
21
> @ak5 : Thanks for this it's quite cool! [link](https://github.com/wechaty/wechaty/issues/4)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
22

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
23
> @ccaapton : wechaty library looks fantastic! [link](https://github.com/wechaty/wechaty/issues/9)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
24

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
25 26
> @Samurais wechaty is great. 👍 [link](https://github.com/wechaty/wechaty/issues/36#issuecomment-251708382)

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
27
# Examples
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
28
Wechaty is dead easy to use: 7 lines javascript for your wechat bot.
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
29

30
## 1. Basic: 7 lines
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
31
The following 7 lines of code implement a bot who can log all message to console:
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
32

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
33
```javascript
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
34
const Wechaty = require('wechaty')
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
35
const bot = new Wechaty()
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
36

37 38 39
bot
.on('scan', ({url, code}) => console.log(`Scan QrCode to login: ${code}\n${url}`))
.on('login',         user => console.log(`User ${user} logined`))
40
.on('message',    message => console.log(`Message: ${message}`))
41
.init()
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
42 43
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
44
Notice that you need to wait a moment while bot trys to get the login QRCode from Wechat. As soon as the bot gets login QRCode url, he will print url out. You need to scan the qrcode on wechat, and confirm login.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
45

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
46
After that, bot will be on duty. (roger-bot source can be found at [here](https://github.com/wechaty/wechaty/blob/master/example/roger-bot.js))
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
47

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
48
## 2. Advanced: dozens of lines
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
49
Here's an chatbot [ding-dong-bot](https://github.com/wechaty/wechaty/blob/master/example/ding-dong-bot.js) who can reply _dong_ when receives a message _ding_.
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
50

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
51
## 3. Hardcore: hundreds of lines
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
52
Here's a chatbot [api-ai-bot](https://github.com/wechaty/wechaty/blob/master/example/api-ai-bot.js), who can slightly understand NLP.
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
53

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
54
Natual Language Understanding enabled by [api.AI](https://api.ai), you can get your module on api.AI by it's free plan.
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
55

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
56 57
# Deploy

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
58
Use docker to deploy wechaty is highly recommended.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
59

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
60 61
## Deploy with Docker

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
62 63 64
[![Docker Pulls](https://img.shields.io/docker/pulls/zixia/wechaty.svg?maxAge=2592000)](https://hub.docker.com/r/wechaty/wechaty/)
[![Docker Stars](https://img.shields.io/docker/stars/zixia/wechaty.svg?maxAge=2592000)](https://hub.docker.com/r/wechaty/wechaty/)
[![Docker Layers](https://images.microbadger.com/badges/image/zixia/wechaty.svg)](https://microbadger.com/#/images/wechaty/wechaty)
65

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
66
[![dockeri.co](http://dockeri.co/image/zixia/wechaty)](https://hub.docker.com/r/zixia/wechaty/)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
67

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
68
Wechaty is fully dockerized. So it will be very easy to be deployed as a MicroService. 
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
69

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
70 71
```shell
$ export TOKEN="your token here"
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
72

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
73
$ docker run -e WECHATY_TOKEN="$TOKEN" wechaty/wechaty
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
74 75
```

76
`WECHATY_TOKEN` is required here, because you need this key to manage wechaty on the chatbot cloud manager: https://www.wechaty.io
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
77

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
78 79 80 81 82 83
### Build

```shell
$ docker build -t wechaty .
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
84 85 86 87 88 89 90 91
### Ship

Wechaty can be used via: Container as a Service

* [Arukas Cloud](https://arukas.io/en/) - Hosting Docker Containers(Currently in Beta, provide up to 10 **free containers**)
* [Docker Cloud](https://cloud.docker.com/) - Docker Cloud is a hosted service that provides a Registry with build and testing facilities for Dockerized application images, tools to help you set up and manage your host infrastructure, and deployment features to help you automate deploying your images to your infrastructure.
* [Dao Cloud](https://www.daocloud.io/) - 容器云平台

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
92 93 94 95
## Deploy with Heroku

To Be Fix

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
96 97
~~Follow [these instructions](https://wechaty.readme.io/docs). Then, [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.sv
g)](https://heroku.com/deploy)~~
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
98 99


Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
100
# Installation
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
101

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
102
## Install from NPM
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
103 104 105 106

[![npm version](https://badge.fury.io/js/wechaty.svg)](https://badge.fury.io/js/wechaty)
[![Downloads][downloads-image]][downloads-url]

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
107
Use NPM is recommended to install a stable version of Wechaty published on NPM.com
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
108 109
```shell
npm install --save wechaty
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
110 111
```

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
112 113 114 115

If you use chrome instead of phantomjs, you should make sure:

1. chrome is installed
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
116 117 118
1. if you are under linux, set headless right for `Xvfb`

* [Running a GUI application in a Docker container](https://linuxmeerkat.wordpress.com/2014/10/17/running-a-gui-application-in-a-docker-container/)
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
119

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
120
Then you are set.
121

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
122
## Install to Cloud9 IDE
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
123
[Cloud9 IDE](https://c9.io/) is Google Docs for Code, which is my favourite IDE today. Almost all my wechaty development is based on Cloud9.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
124 125 126

> Cloud9 IDE written in JavaScript, uses Node.js on the back-end. It uses Docker containers for its workspaces, and hosted on Google Compute Engine.

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
127
### 1. Open in Cloud9 IDE
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
128

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
129
Just one click here: <a href="https://c9.io/open/?name=Wechaty&type=nodejs&clone_url=https://github.com/wechaty/wechaty.git&description=Wechat%20for%20Bot&selection_file=/example/ding-dong-bot.js" target="_blank"><img src="https://img.shields.io/badge/open%20in-Cloud9%20IDE-blue.svg" alt="Open Wechaty in Cloud9 IDE"></a>
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
130

131 132
### 2. Set default to Node.js v6
Open Terminal in Cloud9 IDE, use nvm to install nodejs v6, which is required by Wechaty.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
133 134 135 136 137 138 139 140 141 142 143 144 145 146

```bash
$ nvm install 6
Downloading https://nodejs.org/dist/v6.2.1/node-v6.2.1-linux-x64.tar.xz...
######################################################################## 100.0%
Now using node v6.2.1 (npm v3.9.3)

$ nvm alias default 6
default -> 6 (-> v6.2.1)

$ node --version
v6.2.1
```

147 148 149 150 151 152 153 154
### 3. Run
```bash
$ npm install

$ node example/ding-dong-bot.js
```

### 4. Enjoy Cloud9 IDE
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
155 156 157
You are set.

## Install from Github
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
158
In case that you want to dive deeper into Wechaty, fork & clone to run Wechaty bot on your machine, and start hacking.
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
159

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
160
### 1. Install Node.js
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
161 162 163
Node.js Version 6.0 or above is required.

1. Visit [Node.js](https://nodejs.org)
164 165 166
1. Download NodeJS Installer(i.e. "v6.2.0 Current")
1. Run Installer to install NodeJS to your machine

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
167
### 2. Fork & Clone Wechaty
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
168 169

If you have no github account, you can just clone it via https:
170
```shell
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
171
git clone https://github.com/wechaty/wechaty.git
172
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
173
This will clone wechaty source code to your current directory.
174

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
175
### 3. Run Demo Bot
176
```shell
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
177 178
cd wechaty
npm install
179
node example/ding-dong-bot.js
180 181
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
182 183
After a little while, bot will show you a message of a url for Login QrCode. You need to scan this qrcode in your wechat in order to permit your bot login.

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
184
### 4. Done
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
185 186 187 188

Enjoy hacking Wechaty!
Please submit your issue if you have any, and a fork & pull is very welcome for showing your idea.

189 190
# Wechaty Badge

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
191
[![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-green.svg)](https://github.com/wechaty/wechaty)
192 193 194 195

## Markdown

```markdown
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
196
[![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-green.svg)](https://github.com/wechaty/wechaty)
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
197 198 199 200 201
```

## Html

```html
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
202
<a href="https://github.com/wechaty/wechaty" target="_blank">
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
203
  <img src="https://img.shields.io/badge/Powered%20By-Wechaty-green.svg" alt="Powered by Wechaty" border="0">
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
204
</a>
205 206
```

207
# Trouble Shooting
Huan (李卓桓)'s avatar
log doc  
Huan (李卓桓) 已提交
208

209
If wechaty is not run as expected, run unit test maybe help to find some useful message.
Huan (李卓桓)'s avatar
log doc  
Huan (李卓桓) 已提交
210 211 212 213 214 215 216

```shell
$ npm test
```

To test with full log messages

217
```shell
Huan (李卓桓)'s avatar
log doc  
Huan (李卓桓) 已提交
218
$ WECHATY_LOG=silly npm test
219 220
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
221
[Details about unit testing](https://github.com/wechaty/wechaty/tree/master/test)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
222

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
223
## LOG output
224
Wechaty use [npmlog](https://www.npmjs.com/package/npmlog) to output log message. You can set log level by environment variable `WECHATY_LOG` to show log message.
225

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
226
environment variable `WECHATY_LOG` values:
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
227

228 229 230 231 232
1. `silly`
1. `verbose`
1. `info`
1. `warn`
1. `error`
233
1. `silent` for disable logging
234

235
Linux/Darwin(OSX/Mac):
236 237

```bash
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
238
$ export WECHATY_LOG=verbose
239 240 241 242 243
```

Win32:

```shell
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
244
set WECHATY_LOG=verbose
245 246
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
247
Tips: You may want to have more scroll buffer size in your CMD window in windows.
248 249 250 251 252
```shell
mode con lines=32766
```
> http://stackoverflow.com/a/8775884/1123955

253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277
### NpmLog with Timestamp ###
Here's a quick and dirty patch, to npmlog/log.js

```javascript
  m.message.split(/\r?\n/).forEach(function (line) {

    var date = new Date();
    var min = date.getMinutes()
    var sec = date.getSeconds()
    var hour = date.getHours()

    if (sec < 10) { sec = '0' + sec }
    if (min < 10) { min = '0' + min }
    if (hour < 10) { hour = '0' + hour }

    this.write(hour + ':' + min + ':' + sec + ' ')

    if (this.heading) {
      this.write(this.heading, this.headingStyle)
      this.write(' ')
    }
```

And we can looking forward the official support from npmlog: https://github.com/npm/npmlog/pull/24

278 279 280 281 282 283 284
## DEBUG

set environment variable WECHATY_DEBUG to enable DEBUG in Wechaty.

this will:
1. open phantomjs debugger port on 8080

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
285 286
# Requirement

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
287
ECMAScript2015(ES6). I develop and test wechaty with Node.js v6.0.
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
288

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
289
# API Refference
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
290

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
291
I'll try my best to keep the api as sample as it can be.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
292

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
293 294
## Events

295 296 297 298 299 300 301 302
Wechaty support the following 5 events:

1. scan
2. login
3. logout
4. message
5. error

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
303 304 305
### 1. Event: `scan`

A `scan` event will be emitted when the bot need to show you a QrCode for scaning.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
306 307

```javascript
308
wechaty.on('scan', ({code, url}) => {
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
309 310
  console.log(`[${code}] Scan ${url} to login.` )
})
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
311 312
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
313 314 315
1. url: {String} the qrcode image url
2. code: {Number} the scan status code. some known status of the code list here is:
    1. 0    initial
316 317 318
    1. 200  login confirmed
    1. 201  scaned, wait for confirm
    1. 408  wait for scan
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
319

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
320
`scan` event will be emit when it will detect a new code status change.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
321

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
322 323 324
### 2. Event: `login`

After the bot login full successful, the event `login` will be emitted, with a [Contact](#class-contact) of current logined user.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
325
```javascript
326
wechaty.on('login', user => {
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
327
  console.log(`user ${user} login`)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
328 329
})
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
330

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
331
### 3. Event: `logout`
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
332 333 334 335 336 337 338 339

`logout` will be emitted when bot detected it is logout, with a [Contact](#class-contact) of current logined user.

```javascript
wechaty.on('logout', user => {
  console.log(`user ${user} logout`)
})
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
340 341

### 4. Event: `message`
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
342 343
Emit when there's a new message.
```javascript
344
wechaty.on('message', message => {
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
345 346
  console.log('message ${message} received')
})
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
347
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
348
The `message` here is a [Message](#class-message).
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
349

350 351 352
### 5. Event: `error`
To be support.

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
353 354 355 356 357 358 359 360 361 362 363 364 365 366 367
### 6. Event: `friend`

Fired when we got new friend request, or confirm a friend ship.

```typescript
wechaty.on('friend', (contact: Contact, request: FriendRequest) => {
  if (request) {  // 1. request to be friend from new contact
    request.accept()
    console.log('auto accepted for ' + contact + ' with message: ' + request.hello)
  } else {        // 2. confirm friend ship
    console.log('new friend ship confirmed with ' + contact))
  }
})
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
368 369
## Class Wechaty
Main bot class.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
370

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
371
```javascript
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
372
const bot = new Wechaty({
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
373
  profile
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
374
  , token
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
375
})
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
376
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
377

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
378 379
1. `profile`(OPTIONAL): profile name. if a profile name is provided, the login status will be saved to it, and automatically restored on next time of wechaty start(restart).
    * can be set by environment variable: `WECHATY_PROFILE`
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
380
1. `token`(OPTIONAL): wechaty io token. Be used to connect to cloud bot manager.
381

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
382
### Wechaty.init(): Wechaty
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
383
Initialize the bot, return Promise.
384

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
385
```javascript
386
wechaty.init()
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
387
.then(() => {
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
388 389
  // do other staff with bot here
}
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
390
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
391

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
392
### Wechaty.reply(message: Message, reply: String): Wechaty
393 394 395 396 397 398 399 400
Reply a `message` with `reply`.

That means: the `to` field of the reply message is the `from` of origin message.

```javascript
wechaty.reply(message, 'roger')
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
401
### Wechaty.self(): boolean
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
402 403 404 405 406 407 408 409 410 411
Check if message is send by self.

Return `true` for send from self, `false` for send from others.

```javascript
if (wechaty.self(message)) {
  console.log('this message is sent by myself!')
}
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
412 413 414
## Class Message
All wechat messages will be encaped as a Message.

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
415
### Message.get(prop): String|Contact|Room|Date
416
Get prop from a message.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
417 418

Supported prop list:
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
419

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
420 421 422 423
1. `id` :String
1. `from` :Contact
1. `to` :Contact
1. `content` :String
424
1. `room` :Room
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
425 426 427 428 429 430
1. `date` :Date

```javascript
message.get('content')
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
431
### Message.set(prop, value): Message
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
432 433 434 435 436 437 438 439
Set prop to value for a message.

Supported prop list: the same as `get(prop)`

```javascript
message.set('content', 'Hello, World!')
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
440
### Message.ready(): Message
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
441
A message may be not fully initialized yet. Call `ready()` to confirm we get all the data needed.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
442 443 444 445

Return a Promise, will be resolved when all data is ready.

```javascript
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
446
message.ready()
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
447 448 449 450
.then(() => {
  // Here we can be sure all the data is ready for use.
})
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
451 452 453

## Class Contact

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
454
### Contact.get(prop): String|Number
455
Get prop from a contact.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
456 457

Supported prop list:
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
458

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
459 460 461 462 463 464 465 466 467 468 469 470 471
1. `id` :String
1. `weixin` :String
1. `name` :String
1. `remark` :String
1. `sex` :Number
1. `province` :String
1. `city` :String
1. `signature` :String

```javascript
contact.get('name')
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
472
### Contact.ready(): Contact
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
473
A Contact may be not fully initialized yet. Call `ready()` to confirm we get all the data needed.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
474 475 476 477

Return a Promise, will be resolved when all data is ready.

```javascript
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
478
contact.ready()
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
479 480 481 482 483
.then(() => {
  // Here we can be sure all the data is ready for use.
})
```

484
## Class Room
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
485 486


Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
487
### Room.get(prop): String|Array[{contact: Contact, name: String}]
488
Get prop from a room.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
489 490

Supported prop list:
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
491

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
492 493 494 495 496 497 498
1. `id` :String
1. `name` :String
1. `members` :Array
    1. `contact` :Contact
    1. `name` :String

```javascript
499
room.get('members').length
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
500
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
501
### Room.ready(): Room
502
A room may be not fully initialized yet. Call `ready()` to confirm we get all the data needed.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
503 504 505 506

Return a Promise, will be resolved when all data is ready.

```javascript
507
room.ready()
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
508 509 510 511
.then(() => {
  // Here we can be sure all the data is ready for use.
})
```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
512

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529
## Class FriendRequest

Send, receive friend request, and friend confirmation events.

When someone send you a friend request, there will be a Wechaty `friend` event fired.

```typescript
wechaty.on('friend', (contact: Contact, request: FriendRequest) => {
  if (request) {  // 1. request to be friend from new contact
    request.accept()
    console.log('auto accepted for ' + contact + ' with message: ' + request.hello)
  } else {        // 2. confirm friend ship
    console.log('new friend ship confirmed with ' + contact))
  }
})
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
530 531
Talk is cheap, show me the code: [Example/Friend-Bot](https://github.com/wechaty/wechaty/blob/master/example/friend-bot.js)

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549
### FriendRequest.hello: string

verify message

### FriendRequest.accept(): void

accept a friend request

### FriendRequest.send(contact: Contact, hello: string): void

send new friend request

```typescript
const from = message.get('from')
const request = new FriendRequest()
request.send(from, 'hello~')
```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
550
# Test
Huan (李卓桓)'s avatar
doc ava  
Huan (李卓桓) 已提交
551
Wechaty use ~~[TAP protocol](http://testanything.org/)~~ [AVA](https://github.com/avajs/ava) to test itself ~~by [tap](http://www.node-tap.org/)~~.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
552

Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
553
To test Wechaty, run:
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
554 555
```shell
npm test
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
556 557
```

Huan (李卓桓)'s avatar
doc ava  
Huan (李卓桓) 已提交
558
* Know more about TAP: [Why I use Tape Instead of Mocha & So Should You](https://medium.com/javascript-scene/why-i-use-tape-instead-of-mocha-so-should-you-6aa105d8eaf4)
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
559

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
560 561
# Version History

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
562 563 564 565 566 567 568 569 570
## master
1. #32 Extend Room Class with:
  1. tbw 
1. #33 New Class `FriendRequest` with:
  1. `Wechaty.on('friend', (contact, request) => {})` with Wechaty new Event `friend` 
  1. `accept()` to accept a friend request
  1. `send()` to send new friend request

## v0.3.13 (2016/09)
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
571
1. Managed by Cloud Manager: https://app.wechaty.io
Huan (李卓桓)'s avatar
doc ava  
Huan (李卓桓) 已提交
572
1. Dockerized & Published to docker hub as: [zixia/wechaty](https://hub.docker.com/r/zixia/wechaty/)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
573 574 575
1. Add `reset` & `shutdown` to IO Event
1. Switch Unit Test Runner from Tape/Tap to [AVA](https://github.com/avajs/ava)
1. Move git resposity from zixia/wechaty to [wechaty/wechaty](https://github.com/wechaty/wechaty)
Huan (李卓桓)'s avatar
v0.3.0  
Huan (李卓桓) 已提交
576 577

## v0.2.3 (2016/7/28)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
578
1. add wechaty.io cloud management support: set environment variable `WECHATY_TOKEN` to enable io support
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
579
2. rename `WECHATY_SESSION` to `WECHATY_PROFILE` for better name
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
580
3. fix watchdog timer & reset bug
581

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
582
## v0.1.8 (2016/6/25)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
583
1. add a watchdog to restore from unknown state
Huan (李卓桓)'s avatar
v0.1.6  
Huan (李卓桓) 已提交
584
2. add support to download image message by `ImageMessage.readyStream()`
Huan (李卓桓)'s avatar
v0.1.7  
Huan (李卓桓) 已提交
585
3. fix lots of stable issues with webdriver exceptions & injection js code compatible
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
586

Huan (李卓桓)'s avatar
v0.1.1  
Huan (李卓桓) 已提交
587
## v0.1.1 (2016/6/10)
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
588
1. add support to save & restore wechat login session
589
1. add continious integration tests on win32 platform. (powered by [AppVeyor](https://www.appveyor.com/))
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
590
1. add environment variables HEAD/PORT/SESSION/DEBUG to config Wechaty
Huan (李卓桓)'s avatar
v0.1.1  
Huan (李卓桓) 已提交
591

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
592
## v0.0.10 (2016/5/28)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
593
1. use event `scan` to show login qrcode image url(and detect state change)
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
594
2. new examples: Tuling123 bot & api.AI bot
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
595
3. more unit tests
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
596
4. code coverage status
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
597

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
598
## v0.0.5 (2016/5/11)
599
1. Receive & send message
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
600
1. Show contacts info
601
1. Show rooms info
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
602
1. 1st usable version
603
1. Start coding from May 1st 2016
Huan (李卓桓)'s avatar
readme  
Huan (李卓桓) 已提交
604

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
605
# Todo List
606

Huan (李卓桓)'s avatar
todo  
Huan (李卓桓) 已提交
607
- [ ] Contact
608 609 610
    - [ ] Accept a friend request
    - [ ] Send a friend request
    - [ ] Delete a contact
611 612 613 614
- [ ] Chat Room
    - [ ] Create a new chat room
    - [ ] Invite people to join a existing chat room
    - [ ] Rename a Chat Room
Huan (李卓桓)'s avatar
todo  
Huan (李卓桓) 已提交
615
- [ ] Events
616 617 618 619 620 621 622 623 624
    - [ ] Use EventEmitter2 to emit message events, so we can use wildcard
        1. `message`
        2. `message.recv`
        3. `message.sent`
        4. `message.recv.image`
        5. `message.sent.image`
        6. `message.recv.sys`
        1. `message.**.image`
        1. `message.recv.*`
Huan (李卓桓)'s avatar
todo  
Huan (李卓桓) 已提交
625
- [ ] Message
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
626 627 628
    - [ ] Send/Reply image/video/attachment message
    - [ ] Save video message to file
    - [x] Save image message to file
629
- [x] Session save/load
630 631
- [ ] Rewrite to TypeScript
- [ ] Switch to AVA Test Runner
632

Huan (李卓桓)'s avatar
readme  
Huan (李卓桓) 已提交
633
Everybody is welcome to issue your needs.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
634 635

# Known Issues & Support
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
636
Github Issue <https://github.com/wechaty/wechaty/issues>
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
637 638 639 640 641 642

# Contributing
* Lint: eslint
    ```bash
    $ npm lint
    ```
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
643
* Create an issue, fork, then send a pull request(with unit test please).
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
644

645
# See Also
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
646

647
## Similar Project
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
648 649

### Javascript
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
650
1. [Weixinbot](https://github.com/feit/Weixinbot) Nodejs 封装网页版微信的接口,可编程控制微信消息
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
651 652
1. [wechatBot](https://github.com/stonexer/wechatBot) 面向个人的微信 wechat 机器人平台 - 使用微信网页版接口wechat4u
1. [Wechat4U](https://github.com/nodeWechat/wechat4u) 微信 wechat web 网页版接口的 JavaScript 实现,兼容Node和浏览器
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
653
2. [wechat-user-bot](https://github.com/HalfdogStudio/wechat-user-bot) 正在组装中的微信机器人
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
654

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
655 656
### Electron
1. [:speech_balloon: A better WeChat on macOS and Linux. Fewer bugs, more features. Built with Electron by Zhongyi Tong.](https://github.com/geeeeeeeeek/electronic-wechat)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
657 658 659 660
  - [网页版微信抓包+注入实现表情贴纸显示](https://github.com/geeeeeeeeek/electronic-wechat/issues/2)
  - [新表情方案: 收到消息时修改其内容(及阻止撤回)](https://github.com/geeeeeeeeek/electronic-wechat/pull/13)
1. [普通个人号 微信机器人/外挂](https://github.com/fritx/wxbot)
  - [微信个人号/公众号相关项目整理(wechat/weixin/wx)](https://github.com/fritx/awesome-wechat)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
661

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
662 663 664
### Go
1. [0d0f/exfe](https://github.com/0d0f/exfe-bus/tree/master/src/wechat) Wechat bot component of exfe-bus 

665
### Perl
Huan (李卓桓)'s avatar
typo  
Huan (李卓桓) 已提交
666
1. [MojoWeixin](https://github.com/sjdy521/Mojo-Weixin) 使用Perl语言编写的微信客户端框架,基于Mojolicious,要求Perl版本5.10+,可通过插件提供基于HTTP协议的api接口供其他语言或系统调用
667

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
668
### Python
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
669 670 671
1. [WeixinBot](https://github.com/Urinx/WeixinBot) *Very well documented* 网页版微信API,包含终端版微信及微信机器人
1. [wxBot](https://github.com/liuwons/wxBot): Wechat Bot API
1. [ItChat](https://github.com/littlecodersh/ItChat): 微信个人号接口(支持文件、图片上下载)、微信机器人及命令行微信。三十行即可自定义个人号机器人
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
672
1. [WechatIrcd](https://github.com/MaskRay/wechatircd): 用IRC客户端控制微信网页版
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
673 674 675 676
1. [查看被删的微信好友](https://github.com/0x5e/wechat-deleted-friends): 由于微信后台已经对此类脚本做了屏蔽,无论是什么语言版本的脚本均已经失效,此项目帮助了解微信web版通讯过程,切勿再使用!

### KDE
1. [WeChat KDE frontend 微信 KDE 前端](https://github.com/xiangzhai/qwx)
677

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
678 679 680
### dotNET
1. [WeChat.NET](https://github.com/sherlockchou86/WeChat.NET) WeChat.NET client based on web wechat

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
681
## Chat Script
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
682 683
1. [SuperScript](http://superscriptjs.com/) A dialog system and bot engine for conversational UI's. (Pure Javascript)
2. [RiveScript](https://www.rivescript.com/) A simple scripting language for giving intelligence to chatbots and other conversational entities. (Perl original, Multi-Language support)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
684
3. [CleverScript](https://www.cleverscript.com) Easily create text, voice or avatar bots that people can chat with in browser, app or their preferred messaging platform.
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
685 686

## Application
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
687 688
1. [助手管家](http://72c.me/a/m/yhmhrh) It's a Official Account of wechat, which can manage your personal wechat account as a robot assistant.

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
689
## Service
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
690 691 692 693 694 695 696 697 698
1. [Luis.ai](https://www.luis.ai) Language Understanding Intelligent Service (LUIS) offers a fast and effective way of adding language understanding to applications from Microsoft
1. [API.ai](https://api.ai) Build conversational user interfaces
1. [Wit.ai](https://wit.ai) Turn user input into action from Facebook
1. [Watson](http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/doc/dialog/) a comprehensive, robust, platform for managing conversations between virtual agents and users through an application programming interface (API) from IBM

* [Advanced Natural Language Processing Tools for Bot Makers](https://stanfy.com/blog/advanced-natural-language-processing-tools-for-bot-makers/) a good article of comparing the above services.

## Framework
1. [Bot Framework](https://dev.botframework.com/) Build and connect intelligent bots to interact with your users naturally wherever they are, from text/sms to Skype, Slack, Office 365 mail and other popular services. from Microsoft
699

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
700
My Story
701 702 703 704 705 706 707 708 709 710 711
----------------
My daily life/work depends on too much chat on wechat.
* I almost have 14,000 wechat friends till May 2014, before wechat restricts a total number of friends to 5,000.
* I almost have 400 wechat rooms that most of them have more than 400 members.

Can you image that? I'm dying...

So a tireless bot working for me 24x7 on wechat, moniting/filtering the most important message is badly needed. For example: highlights discusstion which contains the KEYWORDS I want to follow up(especially in a noisy room). ;-)

At last, It's built for my personal study purpose of Automatically Testing.

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
712 713 714 715 716
Author
-----------------
Zhuohuan LI <zixia@zixia.net> (http://linkedin.com/in/zixia)

<a href="http://stackoverflow.com/users/1123955/zixia">
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
717
  <img src="http://stackoverflow.com/users/flair/1123955.png" width="208" height="58" alt="profile for zixia at Stack Overflow, Q&amp;A for professional and enthusiast programmers" title="profile for zixia at Stack Overflow, Q&amp;A for professional and enthusiast programmers">
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
718 719 720 721 722 723 724
</a>

Copyright & License
-------------------
* Code & Docs 2016© zixia
* Code released under the ISC license
* Docs released under Creative Commons
725

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
726
[downloads-image]: http://img.shields.io/npm/dm/wechaty.svg?style=flat-square
727
[downloads-url]: https://npmjs.org/package/wechaty
ruiruibupt's avatar
test  
ruiruibupt 已提交
728