search

wechaty / dotnet-wechaty

.NET Wechaty is a Conversational SDK for Chatbot Makers Written in C#
Apache License 2.0
80 stars 29 forks source link
csharp dotnet wechaty

readme

dotnet-wechaty (.NET Wechaty)

dotnet-wechaty (.NET Wechaty) is a Conversational SDK for chatbot makers written in C#

.NET Core version support .NET Core

.NET Wechaty

Connecting Chatbots

Powered by Wechaty

Wechaty is a RPA SDK for Wechat Individual Account that can help you create a chatbot in 6 lines of C#

Voice of the Developers

"Wechaty is a great solution, I believe there would be much more users recognize it." link
— @Gcaufy, Tencent Engineer, Author of WePY

"太好用，好用的想哭"
— @xinbenlv, Google Engineer, Founder of HaoShiYou.org

"最好的微信开发库" link
— @Jarvis, Baidu Engineer

"Wechaty让运营人员更多的时间思考如何进行活动策划、留存用户，商业变现" link
— @lijiarui, Founder & CEO of Juzi.BOT.

"If you know js ... try Wechaty, it's easy to use."
— @Urinx Uri Lee, Author of WeixinBot(Python)

See more at Wiki:Voice Of Developer

History

dotnet-wechaty Versions

version: 0.2.0

  1. sdk升级到net 5.0
  2. Wechaty.Grpc 0.20.0
  3. 更新grpc客户端nuget包为Grpc.Net.Client
  4. Grpc.Net.Client Nuget Package
  5. Microsoft docs for grpc

Join Us

Wechaty is used in many ChatBot projects by thousands of developers. If you want to talk with other developers, just scan the following QR Code in WeChat with secret code dotnet wechaty, join our Wechaty dotnet Developers' Home.

Wechaty Friday.BOT QR Code

Scan now, because other Wechaty dotnet developers want to talk with you too! (secret code: dotnet wechaty)

The World's Shortest dotnet ChatBot: 7 lines of Code

C

var wechaty = new Wechaty(options, logger).onScan((qrcode, status) => {
    Console.WriteLine($"Scan QR Code to login: {status} https://wechaty.github.io/qrcode/{(qrcode)}`");
}).OnLogin( user => {
    Console.WriteLine("User {user} logined");
}).OnMessage( message => {
    Console.WriteLine($"Message: {message}");
}).Start();

dotnet Wechaty Developing Plan

We already have Wechaty in TypeScript, It will be not too hard to translate the TypeScript(TS) to C# because wechaty has only 3,000 lines of the TS code, they are well designed and de-coupled by the wechaty-puppet abstraction. So after we have translated those 3,000 lines of TypeScript code, we will almost be done.

As we have already a ecosystem of Wechaty in TypeScript, so we will not have to implement everything in C#, especially, in the Feb 2020, we have finished the @chatie/grpc service abstracting module with the wechaty-puppet-hostie implmentation.

The following diagram shows out that we can reuse almost everything in TypeScript, and what we need to do is only the block located at the top right of the diagram: Wechaty (C#).

  +--------------------------+ +--------------------------+
  |                          | |                          |
  |   Wechaty (TypeScript)   | |      Wechaty (C#)        |
  |                          | |                          |
  +--------------------------+ +--------------------------+

  +-------------------------------------------------------+
  |                 Wechaty Puppet Hostie                 |
  |                                                       |
  |                (wechaty-puppet-hostie)                |
  +-------------------------------------------------------+

+---------------------  @chatie/grpc  ----------------------+

  +-------------------------------------------------------+
  |                Wechaty Puppet Abstract                |
  |                                                       |
  |                   (wechaty-puppet)                    |
  +-------------------------------------------------------+

  +--------------------------+ +--------------------------+
  |      Pad Protocol        | |      Web Protocol        |
  |                          | |                          |
  | wechaty-puppet-padplus   | |(wechaty-puppet-puppeteer)|
  +--------------------------+ +--------------------------+
  +--------------------------+ +--------------------------+
  |    Windows Protocol      | |       Mac Protocol       |
  |                          | |                          |
  | (wechaty-puppet-windows) | | (wechaty-puppet-macpro)  |
  +--------------------------+ +--------------------------+

Example: How to Translate TypeScript to C

There's a 100 lines class named Image in charge of downloading the WeChat image to different sizes.

It is a great example for demonstrating how do we translate the TypeScript to C# in Wechaty Way:

Image Class Source Code

If you are interested in the translation and want to look at how it works, it will be a good start from reading and comparing those two Image class files in TypeScript and C# at the same time.

To-do List

Wechaty Internal Modules

  1. [ ] Class Wechaty
  2. [ ] Class Contact
  3. [ ] Class ContactSelf
  4. [ ] Class Message
  5. [ ] Class Room
  6. [ ] Class Image
  7. [ ] Class Accessory
  8. [ ] Class Config
  9. [ ] Class Favorite
  10. [ ] Class Friendship
  11. [ ] Class MiniProgram
  12. [ ] Class RoomInvitation
  13. [ ] Class Tag
  14. [ ] Class UrlLink

Wechaty External Modules

  1. [ ] Class FileBox
  2. [ ] Class MemoryCard
  3. [ ] Class WechatyPuppet
  4. [ ] Class WechatyPuppetHostie

Usage

WIP...

Requirements

  1. .NET Core 3.1+

Install

Dependencies Restore

dotnet restore ./src/Wechaty.sln

History

master

v0.1 (Oct 28, 2020)

  1. Decided to merged Jesn's implementation of .Net Wechaty to this one. (#4)

v0.0.1 (Jul 20, 2020)

  1. Project created.
  2. Welcome our first dotnet-wechaty contributor:

Related Projects

Badge

.NET Wechaty

[![.NET Wechaty](https://img.shields.io/badge/Wechaty-.NET-blueviolet)](https://github.com/wechaty/dotnet-wechaty)

Contributors

contributor contributor contributor contributor contributor contributor contributor contributor

  1. @echofool - echofool

Creators

Copyright & License