Merge branch 'main' into mid-term

Author: huan

.file-name-linter.json

@@ -6,7 +6,7 @@
     ],
     "jekyll/assets": [
       "/[0-9\\-a-z_]+\\.",
-      "\\.(webp|pdf|zip)$"
+      "\\.(webp|pdf|zip|svg)$"
     ]
   },
   "ignore": [

README.md

@@ -1,13 +1,25 @@
-## wechaty.js.org
+<div align="center">
+<img src="https://github.com/wechaty/wechaty.js.org/blob/main/docs/images/wechaty-docusaurus.png" alt="wechaty logo" height ="auto" width="800" />
+<br />
+<h1>Wechaty Organization Website</h1>
+<p>
+Repository for the Wechaty Organization Website, a resource for the Wechaty Organization. It is the official Wechaty website for publishing latest news, blog posts, and documentation from our open source community.
+</p>
+<p align="center">
+<a href="https://github.com/wechaty/wechaty.js.org" alt="GitHub contributors">
+<img src="https://img.shields.io/github/contributors/wechaty/wechaty.js.org.svg" /></a>
+<a href="https://github.com/wechaty/wechaty.js.org" alt="GitHub issues by-label">
+<img src="https://img.shields.io/github/issues/wechaty/wechaty.js.org" /></a>
+<a href="https://gitter.im/wechaty/wechaty" alt="Gitter">
+<img src="https://img.shields.io/badge/[email protected]?logo=slack" /></a>
+</p>
 
 [![GitHub Pages CI](https://github.com/wechaty/wechaty.js.org/workflows/GitHub%20Pages%20CI/badge.svg)](https://github.com/wechaty/wechaty.js.org/actions?query=workflow%3A%22GitHub+Pages+CI%22)
 [![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-brightgreen.svg)](https://github.com/Wechaty/wechaty)
 [![DIVIO documentation system](https://img.shields.io/badge/DIVIO-Documentation%20System-blue)](https://documentation.divio.com/)
 [![ES Modules](https://img.shields.io/badge/ES-Modules-brightgreen)](https://github.com/Chatie/tsconfig/issues/16)
 
-![Wechaty Docusaurus](docs/images/wechaty-docusaurus.png)
-
-<https://wechaty.js.org> is the official Wechaty website for publishing latest news, blog posts, and documentation from our open source community.
+</div>
 
 ## How To Post a Blog
 
@@ -88,7 +100,7 @@ npm test
 
 ## How To Preview Your changes
 
-If you want to preview your blog post or changes on locahost, you need to have Jekyll installed in your machine. You can follow the [jekyll quickstart](https://jekyllrb.com/docs/) instructions to install jekyll.
+If you want to preview your blog post or changes on localhost, you need to have Jekyll installed in your machine. You can follow the [jekyll quickstart](https://jekyllrb.com/docs/) instructions to install jekyll.
 
 ### 1. Install Jekyll by Hand
 

docusaurus/config/presets/redocusaurus.js

@@ -3,16 +3,16 @@ const redocusaurus = [
   {
     specs: [
       {
-        routePath: "/docs/openapi/",
-        specUrl: "https://cdn.jsdelivr.net/npm/wechaty-grpc/dist/generated/wechaty/puppet.swagger.json",
+        route: "/docs/openapi/",
+        spec: "https://cdn.jsdelivr.net/npm/wechaty-grpc/dist/esm/out/wechaty/puppet.swagger.json",
       },
       {
-        routePath: "/docs/openapi@latest",
-        specUrl: "https://cdn.jsdelivr.net/npm/wechaty-grpc@latest/dist/generated/wechaty/puppet.swagger.json",
+        route: "/docs/openapi@latest",
+        spec: "https://cdn.jsdelivr.net/npm/wechaty-grpc@latest/dist/esm/out/wechaty/puppet.swagger.json",
       },
       {
-        routePath: "/docs/openapi@next",
-        specUrl: "https://cdn.jsdelivr.net/npm/wechaty-grpc@next/dist/generated/wechaty/puppet.swagger.json",
+        route: "/docs/openapi@next",
+        spec: "https://cdn.jsdelivr.net/npm/wechaty-grpc@next/dist/esm/out/wechaty/puppet.swagger.json",
       },
     ],
     theme: {

docusaurus/config/theme/mod.js

@@ -9,6 +9,7 @@ const themeConfig = {
   navbar,
   footer,
   algolia: {
+    appId            : 'BH4D9OD16A',
     apiKey           : 'cd8ca324c447a803e8a196a5c8fa22dd',
     indexName        : 'wechaty',
     searchParameters : {},                                   // Optional (if provided by Algolia)
@@ -34,7 +35,7 @@ const themeConfig = {
   // and https://docusaurus.io/docs/api/themes/configuration#metadatas
   // know more about Metadata configuration.
   image: 'img/wechaty-logo.svg',
-  metadatas: [
+  metaData: [
     {name: 'twitter:card', content: 'summary_large_image'},
     {name: 'twitter:image', content: 'img/wechaty-icon.png'},
     {name: 'twitter:title', content: 'Wechaty'},

docusaurus/docs/case-study/money-bot.mdx

@@ -3,7 +3,7 @@ sidebar_label: Money BOT
 title: 'Case Study: Money BOT'
 ---
 
-![image](https://wechaty.js.org/assets/2021/02-how-to-use-wechaty-to-ask-for-payment-before-user-joining-the-group/paying-by-qrcode.png)
+![image](https://wechaty.js.org/assets/2021/02-how-to-use-wechaty-to-ask-for-payment-before-user-joining-the-group/paying-by-qrcode.webp)
 
 一直以来在私域流量运营领域都有这样一个需求：自动通过好友，并在新好友支付一定的费用之后，依据新好友所发送的关键字，将其拉到对应的微信群。关键字与微信群对应，并且微信群满员以后可以自动扩建。
 
@@ -132,4 +132,4 @@ Git: https://github.com/rixingyike/wechat-operation-assistant
 ## Credit
 
 @rixingyike [Programmer LIYI](https://yishulun.com), Tencent TVP.
-First published on the official account: [A small smart robot: help us automatically pull people, automatically verify payment, and automatically transfer the payment to the personal bank card] (https://mp.weixin.qq.com/s/TUKmK7IgJElECt7hNq5QEA). 
+First published on the official account: [A small smart robot: help us automatically pull people, automatically verify payment, and automatically transfer the payment to the personal bank card] (https://mp.weixin.qq.com/s/TUKmK7IgJElECt7hNq5QEA). 

docusaurus/docs/gsoc/2022.md

@@ -0,0 +1,79 @@
+---
+title: GSoC 2022
+---
+
+![Wechaty Summer of Code](/img/docs/gsoc/wechaty-gsoc.png)
+
+This page aggregates project ideas for Google Summer of Code 2022. See more information about this project and applications on the [Wechaty Google Summer of Code page](../).
+
+## The Ideas
+
+### Project 1: Create a Web Component for a Chat UI for Wechaty
+
+UI is very user-friendly to the user, so UI developer kit is import to the developers. We want to create a Web Component in Angular for a Chat UI for Wechaty.
+
+We will not try to reinvent the wheel. There are already exists some great resource for us to use:
+
+1. [Fiora](https://fiora.suisuijiang.com/) is an interesting chat application power by socket.io, koa, MongoDB and React. (See: [https://github.com/yinxin630/fiora/issues/185](https://github.com/yinxin630/fiora/issues/185))
+2. [Aurora IMUI](https://github.com/jpush/aurora-imui) is a general IM UI components library, which does not depend on any specific IM SDK.
+3. [Chatvia](https://themeforest.net/item/chatvia-angular-chat-app-template/28316331) - Angular Chat App Template
+
+* Expected outcomes: a Web UI Component that is good enough in production
+* Potential Mentor(s): lijiarui, Huan
+* Category: Core development
+* Skills Required: TypeScript (programming language), Angular
+* Difficulty Level: Medium
+* Hours: 175
+
+### Project 2: Wechaty Rust
+
+Rust is a new programming language with increasing popularity for its performance, memory safety and extensibility with existing systems.
+
+Wechaty will benefit from a Rust Core module that interfaces with its original TypeScript code base for performance boost, and a potential to ship to browser and Native apps by building to binary and webAssembly.
+
+* Expected outcomes: a Wechaty Minimum Viable Product (MVP) rewritten in Rust
+* Potential Mentor(s): Simon LIANG, Zihua WU
+* Category: Core development
+* Skills Required: Rust (programming language)
+* Difficulty Level: Medium
+* Hours: 175
+
+### Project 3: Implement Wechaty Rasa Plugin
+
+Rasa is a popular task-oriented dialogue system which can be a pipeline in IM platform. What's more, wechaty is an unifiy conversation AI SDK for chatbot. So Wechaty + Rasa will be the perfect project that developer can easily deploy their chatbot on multi-platforms.
+
+1. Running Rasa Server. When you run the rasa server, it will expose the message service with http protocol.
+2. Communicating with Rasa Server. This process is a simple work which will send the request to the server and receive the message sending the wechaty end account.
+
+* Expected outcomes: A production-ready server that can communicated with Wechaty service and Rasa servers
+* Potential Mentor(s): @wj-Mcat, Xiaoquan Kong
+* Category: Core development
+* Skills Required: Python (programming language), Natural Language Processing, Rasa
+* Difficulty Level: Medium
+* Hours: 175
+
+### Project 4: Implement "Twitter" Puppet
+
+We want Wechaty to be the universal instant messaging SDK on all IM platforms for chatbot makers to build their great conversational user interface, so while these are our ideas of what we think would make good projects for the summer, we're eager to hear your ideas and proposals as well.
+
+Implement Twitter Puppet. The Puppet abstraction allows Wechaty to provide a consisting API on all IM platforms for build a chatbot. We are supporting WeChat, WeCom, Whatsapp already, and we want to support Twitter so that our developers can run their chatbots on Twitter to serve users from Twitter.
+
+* Expected outcomes: A production-ready puppet that can support Twitter communicate with Wechaty
+* Potential Mentor(s): Huan
+* Category: Core development
+* Skills Required: TypeScript (programming language), Twitter API
+* Difficulty Level: Medium
+* Hours: 175
+
+### Project 5: Conversational robot that provides COVID-19 information services for elderly groups
+
+The elderly population is more susceptible to COVID-19 virus infection and has a very high mortality rate. At the same time, the elderly population has barriers in accessing information: devices such as smartphones are not friendly to the elderly population. Many parts of the world have a high level of population aging and therefore have a large number of elderly populations. Society should pay more attention to the health of these elderly people and act quickly. Let's make a voice-based intelligent assistant to help the elderly population get information to protect themselves from COVID-19 virus infection.
+
+We will use [Rasa](https://rasa.com) as the backend engine to provide conversational AI experience. And, we will use Wechaty to provide the frontend. Wechaty has the ablility to connect with lots of IM in different countries, so we can serve as many elders as possible.
+
+* Expected outcomes: A chatbot backend server and multiple IM clients. It should provide Information on covid-19 travel ban, virus protection, self-diagnosis, and medical consultation. All this need to be done by talk with the user by text or audio.
+* Potential Mentor(s): Xiaoquan Kong
+* Category: Public welfare
+* Skills Required: Python (programming language), Rasa framework
+* Difficulty Level: Medium
+* Hours: 175

docusaurus/docs/gsoc/overview.md

@@ -17,6 +17,7 @@ Wechaty is applying to join GSoC in 2021 as its first time.
 ## Iterations of Summer of Wechaty for GSoC
 
 - [2021](2021.md)
+- [2022](2022.md)
 
 ### Useful Links
 

docusaurus/docs/puppet-providers/oicq.mdx

@@ -0,0 +1,79 @@
+---
+title: 'Puppet Provider: Oicq'
+sidebar_label: Oicq
+---
+
+[![Wechaty Puppet Oicq](https://img.shields.io/badge/Puppet-Oicq-blueviolet)](oicq)
+
+[![NPM Version](https://badge.fury.io/js/wechaty-puppet-oicq.svg)](https://badge.fury.io/js/wechaty-puppet-oicq)
+[![npm (tag)](https://img.shields.io/npm/v/wechaty-puppet-oicq/next.svg)](https://www.npmjs.com/package/wechaty-puppet-oicq?activeTab=versions)
+
+Wechaty Puppet for QQ based on project takayama-lily/oicq-template
+
+## Features
+
+1. Send & receive messages
+1. Message type support: TEXT
+
+## Usage
+
+<!-- MDX import -->
+import Tabs from '@theme/Tabs'
+import TabItem from '@theme/TabItem'
+
+<Tabs
+  groupId="operating-systems"
+  defaultValue="linux"
+  values={[
+    { label: 'Linux',   value: 'linux', },
+    { label: 'macOS',   value: 'mac', },
+    { label: 'Windows', value: 'windows', },
+  ]
+}>
+
+<TabItem value="linux">
+
+```sh
+npm install wechaty-puppet-oicq
+export WECHATY_PUPPET=wechaty-puppet-oicq
+npm start
+```
+
+</TabItem>
+<TabItem value="mac">
+
+```sh
+npm install wechaty-puppet-oicq
+export WECHATY_PUPPET=wechaty-puppet-oicq
+npm start
+```
+
+</TabItem>
+<TabItem value="windows">
+
+```sh
+npm install wechaty-puppet-oicq
+set WECHATY_PUPPET=wechaty-puppet-oicq
+npm start
+```
+
+</TabItem>
+</Tabs>
+
+## Roadmap
+
+- Add `roomList` support
+- Add `roomMembers` support
+
+## Important Links
+
+- Repo: <https://github.com/wechaty/wechaty-puppet-oicq>
+- Support & Feedback: <https://github.com/wechaty/wechaty-puppet-oicq/issues>
+
+## Blogs
+
+- [OSPP 2021-结项报告-开发支持 QQ 聊天软件的 Wechaty Puppet Provider 模块, @anaivebird, Oct 6, 2021](https://wechaty.js.org/2021/10/06/ospp-final-term-qq-puppet/)
+
+## Maintainers
+
+- [@anaivebird](https://wechaty.js.org/contributors/anaivebird)

docusaurus/docs/puppet-providers/padlocal.md

@@ -14,6 +14,16 @@ sidebar_label: PadLocal
 - Repo: <https://github.com/padlocal/wechaty-puppet-padlocal>
 - Support & Feedback: <https://github.com/padlocal/wechaty-puppet-padlocal/issues>
 
+## Known Issues
+
+1. `TypeError [ERR_INVALID_ARG_TYPE]: The "listener" argument must be of type function. Received undefined`
+
+The PadLocal version v0.4 can only be used with Wechaty version v0.x (below v1.0). You need to use Wechaty v0.x when you are using PadLocal v0.4.
+
+Related issues:
+
+- [can't use gateway padlocal/wechaty-puppet-padlocal#117](https://github.com/padlocal/wechaty-puppet-padlocal/issues/117#issuecomment-988773575)
+
 ## Features
 
 PadLocal is a full-featured Wechaty Puppet Provider.

docusaurus/docs/puppet-providers/simplepad.mdx

@@ -0,0 +1,60 @@
+---
+title: 'Puppet Provider: SimplePad'
+sidebar_label: SimplePad
+---
+
+[![Wechaty Puppet SimplePad](https://img.shields.io/badge/Puppet-SimplePad-blueviolet)](simplepad)
+
+[![npm version](https://badge.fury.io/js/wechaty-puppet-simplepad.svg)](https://badge.fury.io/js/wechaty-puppet-simplepad)
+
+- Repo: <https://github.com/chatrbot/wechaty-puppet-simplepad>
+- Support & Feedback: <https://github.com/chatrbot/wechaty-puppet-simplepad/issues>
+
+## Origin  
+
+In fact, before we knew wechaty, our team already had a complete set of wechat api used in internal projects. The entire SimplePad-Puppet is built on this api system. So when using SimplePad, you can not only Through Wechaty-Puppet, you can also use the Http protocol directly.
+Thanks to [@Huan](https://wechaty.js.org/contributors/huan/) and the Wechaty community for their great work, we quickly joined the Wechaty community and ecosystem.
+
+## Features  
+
+- Simple enough architecture.The simpler it is, the less mistakes.
+- Based on Http protocol.You can request the API directly in your favorite programming language,if you're not good at typescript.
+- Perfect debugging tool.We provide a complete debugging tool to debug all api.
+- For a reasonable charge, you can only buy the api you need.
+
+## Why SimplePad?  
+
+We provide support for multiple protocols (PC/Mac/Ipad, Ipad is recommended). Compared with other Puppets, it also provides moments api.
+
+## How to install and run?  
+
+Just three steps, you can quickly experience!  
+
+1. [Sign up](http://121.199.64.183:8866/user/#/login) for a test token(7 days)  
+
+2. clone [demo project](https://github.com/chatrbot/wechaty-puppet-simplepad-demo)  
+
+3. install demo packages and run:  
+
+    ```shell
+    cd wechaty-puppet-simplepad-demo
+    npm install
+    npx ts-node ./bot.ts -t {YOUR_TOKEN}
+    ```
+
+## WIKI  
+
+You can get more project information and usage from [here](https://github.com/chatrbot/wechaty-puppet-simplepad/wiki)
+
+## Conclusion  
+
+If you are interested in wechaty and looking for a flexible and stable Puppet, try SimplePad.
+We are also actively preparing to update to Wechaty 1.x version, we are getting better together with Wechaty.
+
+## Maintainer  
+
+[@simplepad](https://wechaty.js.org/contributors/simplepad/)
+
+## Related Post  
+
+[New Wechaty Puppet Service: SimplePad](https://wechaty.js.org/2021/06/17/puppet-simplepad-hello/)

docusaurus/docs/puppet-providers/transclusions/badges.mdx

@@ -6,6 +6,8 @@
 [![Wechaty Puppet PadLocal](https://img.shields.io/badge/Puppet-PadLocal-blueviolet)](../padlocal.md)
 [![Wechaty Puppet WeChat4U](https://img.shields.io/badge/Puppet-WeChat4U-blueviolet)](../wechat4u.md)
 [![Wechaty Puppet XP](https://img.shields.io/badge/Puppet-XP-blueviolet)](../xp.mdx)
+[![Wechaty Puppet Oicq](https://img.shields.io/badge/Puppet-Oicq-blueviolet)](../oicq.mdx)
+[![Wechaty Puppet SimplePad](https://img.shields.io/badge/Puppet-SimplePad-blueviolet)](../simplepad.mdx)
 [![Wechaty Puppet Service](https://img.shields.io/badge/Puppet-Service-blueviolet)](../service.md)
 [![Wechaty Puppet Mock](https://img.shields.io/badge/Puppet-Mock-blueviolet)](../mock.md)
 [![Wechaty Puppet DIY](https://img.shields.io/badge/Provider-DIY-blueviolet)](../diy.md)

docusaurus/docs/puppet-providers/wechat.md

@@ -24,15 +24,12 @@ WeChat Accounts that are registered after 2017 might not be able to login Web We
 
 Few points to be kept in mind :
 
+1. [Can not login with UOS patch any more, Jan 1, 2022](https://github.com/wechaty/puppet-wechat/issues/192)
 1. Web API can not create room and invite members to room since 2018.
-2. The ID of contacts and rooms will change across sessions. [#1644](https://github.com/wechaty/wechaty/issues/1644)
+1. The ID of contacts and rooms will change across sessions. [#1644](https://github.com/wechaty/wechaty/issues/1644)
 
 If you want to break the above limitations, then you need consider to use a Wechaty Puppet other than Web. Learn them from [Wechaty Puppet Providers](puppet-providers/overview.mdx).
 
-## Fixed Issues
-
-1. Support UOS with puppeteer : [#127](https://github.com/wechaty/wechaty-puppet-wechat/issues/127)
-
 ## Usage
 
 <!-- MDX import -->

docusaurus/docs/puppet-services/faq.md

@@ -1,5 +1,4 @@
 ---
-slug: /puppet-services/
 title: FAQ - Wechaty Puppet Services
 sidebar_label: 'Puppet Services: FAQ'
 ---

docusaurus/docs/puppet-services/overview.mdx

@@ -1,4 +1,5 @@
 ---
+slug: /puppet-services/
 title: Wechaty Puppet Services
 sidebar_label: 'Overview'
 ---