wechat bot padlocal

如果您是在gitee看到這個repo，README.md中的圖片看不了是因為甜蜜的gitee不支援外鏈圖片。可前往github倉庫查看。

Please note that

有問題請提交issue ，我會及時回覆的。

如果有使用上的問題，請參閱wiki

---

一、關於iPad協議token的問題

1. 目前web協議的wechaty通常情況下已經無法使用（可自行百度網頁版微信登陸嘗試，能登上就可以用）
2. 基於UOS作業系統修改請求頭的方式登入網頁微信https://wx.qq.com/的手段已經失效（騰訊已經給UOS上架全新的微信桌面端。。）
3. 可透過http://pad-local.com/取得pad-local協定。新人可免費使用7天，之後是200元一個月。 。 。
4. 可透過成為Wechaty Contributor的方式，取得長達>=1年的免費token，請參閱《如何向wechaty投稿blog取得免費token【保母級教學】》。

教程撰寫不易，如果對您有幫助還請動動小手點個讚:bulb:

二、功能包括：

2.1 私聊訊息處理：關鍵字回复，包括

• 線上即時資料取得服務由API服務商提供

  • 毒雞湯

  • 神回覆

  • 每日英語

  • 全網熱點

  • 城市天氣

  • 客服

• 文字處理功能由本地編寫演算法處理

  • 英文字串轉大/小寫

  • rgb <=> hex

2.2 群管理

• 自動拉人入群
  • 透過私聊的快速指令
• 快捷指令踢人踢@用户名可快速踢出群組聊天
  
• 檢測群內非法url並@提醒對方

2.3 自動處理好友請求

• 自動透過好友請求
• 可限制透過填寫指定驗證訊息的好友
  • 避免陌生人添加好友

2.4 智慧對話（連結微信對話開放平台）

• 未被關鍵字捕獲的訊息將由**訓練好的AI **智慧回复

2.5 設定定時任務(可循環、可單次）

• 定時發送群組訊息

  • 登入時建立任務
  • 暫不支援指令設定任務，只可透過修改源碼

• 定時給個人發送訊息

  2022年1月14日4點0分0秒向備註為樊慶元的聯絡人發送“我剛學完，早安”

• 群發功能（可適用於多種節慶）

  加上備註作為稱謂，就不會被看出是群發的啦~:sparkles:誠意MAX:sparkles:

• 定時訊息銷毀

  定時任務設定成功後會返回任務id，憑此可銷毀任務

• 休息提醒

  在機器人正常運作時，每天上午9點啟動，晚上7關閉（自動）。每隔半小時會提醒master休息一下，近視眼福音有木有:tada:

2.6 密碼簿

此功能可用於記錄常用的冗長文本，例如身分證號、銀行卡號、購物時的好評範本等等。

• 透過指令map key value可記錄標籤為key ，內容為value的密碼（在password目錄下產生檔案）

• 透過指令get key可以取得標籤為key的密碼

• 文件加密

  • 檔案名稱透過md5演算法比對

  • 文件內容透過aes-128-cbc演算法加密

2.7 封鎖指定聯絡人

• 可透過屏蔽/解除屏蔽联系人备注的方式，在載入於記憶體中的封鎖清單中進行增加/刪除聯絡人【機器人重啟後失效】

2.8 監聽群組成員加入/退出

• 加入群組聊天，機器人會在群組聊天內公佈加入者和邀請人的名稱

• 退出群聊，機器人會向機器人master發送訊息，說明何人退出了何群

2.9 圖床

• 向機器人發送圖片時，將觸發圖床功能，由機器人接收圖片後將其上傳至圖床伺服器圖片可在瀏覽器進行訪問，也可以插入markdown文檔

2.10 翻譯

• 機器人已介入百度翻譯平台，自行註冊開發者並認證，可獲得每月200萬字符量翻譯，QPS可達到10。

三、目錄結構

• config/資料夾存放公共配置
• imgs/存放相關圖片
• password/存放密碼簿產生文件
• listeners/存放機器人初始化後一系列事件處理(分模組)
  • on-friendship.js處理好友請求
  • on-login.js處理登入
  • on-message.js處理用戶訊息、群組訊息
  • on-scan.js處理登入二維碼
  • on-room-join/leave處理用戶加入/退出群組聊天
• schedule/對定時任務node-schedule函式庫進行了封裝
• superagent/存放所有的資料請求、介面封裝都在此
• utils/公用方法的封裝
• bot.js機器人實例文件
• start.js入口文件

四、clone後請依照以下操作修改

要修改config配置，將裡面的配置改為自己的。開啟config/目錄並新建index.js文件， 文件內容如下：

 /*
 * @author Hilbert Yi
 * @digst:  全局配置config
 * @time: 2022-01-03 12:36
 */
const ignoreFile = require ( './ignore.json' ) ;
module . exports = {
  SERVER : "" , //服务器IP/域名

  PUPPET_TOKEN : "" , // pad-local

  TXAPI_TOKEN : "" , // 天行数据

  JUHEAPI_TOKEN : "" , // 聚合数据

  WXAI_TOKEN : "" , // 微信对话开放平台

  BAIDU_APPID : "" ,

  BAIDU_KEY : "" ,

  IGNORE : ignoreFile , //json文件:不需机器人回复的用户，填写用户备注，非昵称

  WEBROOM : [ "test" , "test2" ] , //要管理的群名称

  MYSELF : "mnb" , //大号的备注，防止其他人冒充

  BOTNAME : "gjb" , // 机器人的昵称

  PROVINCE : [
    "北京" ,
    "湖北" ,
    "广东" ,
    "浙江" ,
    "河南" ,
    "湖南" ,
    "重庆" ,
    "安徽" ,
    "四川" ,
    "山东" ,
    "吉林" ,
    "福建" ,
    "江西" ,
    "江苏" ,
    "上海" ,
    "广西" ,
    "海南" ,
    "陕西" ,
    "河北" ,
    "黑龙江" ,
    "辽宁" ,
    "云南" ,
    "天津" ,
    "山西" ,
    "甘肃" ,
    "内蒙古" ,
    "台湾" ,
    "澳门" ,
    "香港" ,
    "贵州" ,
    "西藏" ,
    "青海" ,
    "新疆" ,
    "宁夏" ,
  ] ,

  KEYWORDS : function ( ) {
    return `回复序号或关键字获取对应服务
1.回复群名进入群聊： ${ this . WEBROOM }
2.毒鸡汤
3.神回复
4.每日英语
5.全网热点
6.全国肺炎
7.客服
------------------
翻译(例：翻译 [en] [zh] text)
转小写(例：转小写 YZHYYDS)
转大写(例：转大写 yzhyyds)
转rgb(例：转rgb #cccccc)
转16进制(例：转16进制 rgb(255,255,255))
城市名 天气(例：武汉 天气)
省份/自治区 肺炎(例：湖北 肺炎)
------------------n` ;
  } ,

  VIP : function ( ) {
    return `密码簿n(例：map test 123456nget test)n` + 
           `定时消息n(例：定时 M.D.H.m.s 目标 信息)n` +
           `群发消息n(例：群发 M.D.H.m.s 目标1[，目标2] 信息)n` +
           `销毁定时n(例:销毁 id)n` +
           `刷新联系人数据(!WARNING!)n` +
           `[解除]屏蔽n(例：屏蔽 张三(->备注))` +
           `持久化屏蔽n(更新本地屏蔽联系人列表)`
  }
} ;

token/key取得操作如下：

• 官網註冊帳號

  • wechaty-puppet-padlocal 供應商：http://pad-local.com/
  • 天行資料官網：https://www.tianapi.com/
  • 聚合資料官網：https://www.juhe.cn/
  • 微信對話開放平台：https://openai.weixin.qq.com/
  • 百度翻譯開放平台：https://api.fanyi.baidu.com/

• 註冊成功後，申請以下介面：

  • 天行數據
    • 每日英語一句話
    • 神回覆
    • 全網熱搜榜
  • 聚合數據
    • 天氣預報

介面申請後請開啟config/index.js ，將頂部PUPPET_TOKEN 、 TXAPI_TOKEN 、 JUHEAPI_TOKEN 、 WXAI_TOKEN改為自己的即可。

其他免費介面可隨意申請，也可以自行更換API服務商。

五、運行

記得安裝依賴

npm install

npm start start.js

非常不建議使用cnpm ，請自行百度nrm使用方法或手動修改國內鏡像。當然，執意要用的話請務必這麼使用： cnpm i --by=npm

若部署於伺服器，可使用PM2進行管理

[root@xx ~ ] # pm2 start start.js

---

啟動後，終端機會出現一個二維碼，掃碼登入即可。

控制台也許會列印多個二維碼，掃一個耐心等待即可。如果確實沒登上去再後面出來的。

登出登入後再重新登入時，你的手機會自動彈出iPad的登入要求，點擊後耐心等待即可。如果確實沒登上去再掃控制台的二維碼登入。

若控制台列印的二維碼是支離破碎的，無法掃描，請更換終端。

我在本機用的是Windows Terminal ，ECS伺服器用tabby連線。

---

六、更新日誌

2022-04-02

• 上線翻譯功能:globe_with_meridians:

2022-03-31

• 優化AI簽章的獲取，加入輪詢機制
• 網域備案完成:ok_hand:

2022-03-29

• 支援將記憶體中修改過後的屏蔽聯絡人清單持久化到本地json文件

2022-03-08

• ?優化控制台日誌列印格式，附時間戳
• 修正了離線訊息的處理問題（從離線狀態恢復登入時，僅回應1分鐘內收到的訊息事件）

2022-03-04

• 休息提醒功能上線

2022-03-01

• 定時訊息v2.1上線，支援建立/銷毀定時任務
• ?密碼簿現支援自訂金鑰與初始化向量(16位元utf8字元。需自行儲存，遺失後檔案將無法解密。)!

2022-02-24

• 現支援線上新增/刪除屏蔽聯絡人清單（載入於內存，機器人重啟後失效！如需持久化，請手動修改config.js ）

2022-02-07

• ???圖床功能上線

2022-02-05

• 聯絡人刷新（:rotating_light:極度慎用！！！有可能觸發微信安全警告）

2022-01-29

• 添加節日祝福功能

2022-01-28

• bot實例重構，解決循環相依的問題
• 可直接npn i安裝依賴，徹底解決依賴版本的困擾

2022-01-25

• 接取網路易疫情資料接口

2022-01-23

• 接取新浪疫情數據接口

2022-01-20

• 存取聚合資料API
• 天氣資訊

2022-01-18

• 部署於阿里雲ECS伺服器環境

2022-01-17

• 投稿blog，成為Wechaty Contributors

2022-01-15

• 每日英語

2022-01-12

• 毒雞湯

2022-01-11

• 存取天行資料API
• 神回覆

2022-01-03

• 更改puppet供應商，由wechaty （web協定）切換為padlocal （iPad協定）

2022-01-02

• hex轉rgb
• rgb轉hex

2022-01-01

• 英文字串轉大寫
• 英文字串轉小寫

2022-12-28

• 掃碼登入

2021-11-23

• 程式碼熱更新部署