Hubot 的简单用法

简介

Hubot 是 Github 的开源聊天机器人，能够用来作一些自动化任务，如部署网站，翻译语言等等。

你可能会说，这些只要写个脚本就能够作到了吧？

确实，但你写完脚本以后仍是须要手动运行那些脚本。

你有没想过其实你能够在经常使用的聊天软件上说 @xxx, 部署新版本的网站，而后机器人就自动登陆服务器，而后执行部署脚本，部署成功后告诉你 新版本的网站已经部署成功。

是的，若是你的聊天软件上集成了 Hubot，你就能够轻松地用它来管理一些繁琐的事情啦！

安装

官方推荐咱们用 yeoman + hubot 生成器来生成咱们的聊天机器人，方法以下：

$ npm install -g yo generator-hubot
$ mkdir myhubot && cd myhubot
$ yo hubot

回答一些基本的问题后，咱们的聊天机器人就生成好啦~

基本用法

咱们的聊天机器人的执行文件是 bin/hubot，咱们先看看里面写什么：

$ cat ./bin/hubot

#!/bin/sh

set -e

npm install
export PATH="node_modules/.bin:node_modules/hubot/node_modules/.bin:$PATH"

exec node_modules/.bin/hubot --name "myhubot" "$@"

这份执行文件只是先执行 npm install，而后设置环境变量，再执行 node_modules/.bin/hubot 而已，没什么神秘的。

咱们试试运行一下这份可执行文件：

$ ./bin/hubot
myhubot>

咱们看到了一个相似 shell 的东东！试试随便输入一些东西：

myhubot> hello
myhubot> world
myhubot> how are you?
myhubot> can you hear me?

咱们发现不管咱们输入什么，咱们的机器人都没有反应，是否是坏掉了？
其实并非这样的，它没反应是由于咱们没有对「输入」的处理，若是咱们输入一些特定的「输入」，它就会有反应啦！

myhubot> myhubot ping
myhubot> PONG

myhubot> myhubot pug me
myhubot> http://28.media.tumblr.com/tumblr_locinzasB91qzj3syo1_500.jpg

myhubot> myhubot help
myhubot> myhubot adapter - Reply with the adapter
myhubot animate me <query> - The same thing as `image me`, except adds a few parameters to try to return an animated GIF instead.
myhubot echo <text> - Reply back with <text>
myhubot help - Displays all of the help commands that Hubot knows about.
myhubot help <query> - Displays all help commands that match <query>.
myhubot image me <query> - The Original. Queries Google Images for <query> and returns a random top result.
myhubot map me <query> - Returns a map view of the area returned by `query`.
myhubot mustache me <url|query> - Adds a mustache to the specified URL or query result.
myhubot ping - Reply with pong
myhubot pug bomb N - get N pugs
myhubot pug me - Receive a pug
myhubot the rules - Make sure hubot still knows the rules.
myhubot time - Reply with current time
myhubot translate me <phrase> - Searches for a translation for the <phrase> and then prints that bad boy out.
myhubot translate me from <source> into <target> <phrase> - Translates <phrase> from <source> into <target>. Both <source> and <target> are optional
ship it - Display a motivation squirrel

看到了吧！若是咱们输入了特定的「输入」，机器人就会有反应啦！

当咱们输入 myhubot help 的时候，返回的东东其实就是预约义的「输入」，这些预约义的「输入」只在 shell adapter 下有效哦！

Adapter

什么是 shell adapter ？ 咱们运行 ./bin/hubot 时默认的 adapter 就是 shell adapter。

什么是 adapter ？ 所谓的 adapter 实际上是一些让机器人接收输入的接口。

刚才提到，shell adapter 是默认状况下的 adapter，主要是用来测试 adapter 是否生效。说白了，其实就是没什么用！

以为很坑爹是吧？说好的让咱们的聊天软件整合咱们的机器人呢？

实际上社区已经为咱们提供了各类各样的 adapter，咱们只要下载就能够用啦！具体请看看 https://hubot.github.com/docs/adapters/

那么咱们如何指定用某个 adapter 呢？很简单啦，只要启动机器人的时候带上 -a 参数就行了。
譬如若是咱们想让机器人整合到 telegram，咱们只要执行下面的命令就能够了：

$ npm install --save hubot-telegram
$ ./bin/hubot -a telegram

固然咱们还须要设置一下，这些设置会根据不一样的 adapter 而有所不一样，具体请看对应的文档！

若是你所用的聊天软件并不在社区的支持列表中，又想把整合 Hubot 的话，能够本身写 adapter，文档在这里：https://hubot.github.com/docs/adapters/d...

Scripts

咱们一直说 Hubot 是聊天机器人，机器人最基本的是根据不一样的「输入」给出不一样的「输出」。
在 Hubot 应该怎么处理不一样「输入」，给出不一样的「输出」呢？
答案就是用 Scripts 啦！

有没有发现咱们机器人的目录下有个 scripts/ 文件夹？咱们能够在这个文件夹下添加各类脚本文件，根据不一样的「输入」给出不一样的「输出」。
在咱们启动 Hubot 的时候，它会加载 scripts/ 文件夹下的脚本，赋予 Hubot 强大的交互能力！

须要注意的是，scripts/ 下的脚本必须是 .coffee 或者 .js 格式的，并且必须暴露一个接受 robot 参数的函数！
咱们仍是先打开 scripts/example.coffee 看看吧！

// coffee
module.exports = (robot) ->

// js
module.exports = function(robot) {}

在这个函数里面，咱们能够利用 robot.hear、robot.response、robot.send、robot.reply 等 api 为不一样的「输入」给出不一样的「输出」！
咱们还能够用 robot.http(url).get() 等方法来发出 http 请求！这样咱们的机器人就能够有更强大的交互能力了！

想知道更多 api 的用法的话，能够参考文档：https://hubot.github.com/docs/scripting/

写在最后

Hubot 真的是一个简单易用的聊天机器人，咱们能够把它整合到咱们的聊天软件中，让那些简单但繁琐的任务自动化起来，提升咱们的工做效率！
最后强烈推荐各位同窗去读一下 Hubot 的源码，简单易懂，以后会对 Hubot 有更深入的认识！

出处

http://scarletsky.github.io/2016/04/03/h...

参考资料

https://hubot.github.com/