【亲测免费】 .NET Wechaty 使用教程

.NET Wechaty 使用教程

1. 项目介绍

.NET Wechaty 是一个基于 .NET Core 的聊天机器人 SDK，它是 Wechaty 项目的一部分，旨在帮助开发者使用 C# 语言创建微信聊天机器人。Wechaty 是一个用于微信个人账号的 RPA（机器人流程自动化） SDK，支持多种编程语言，包括 TypeScript、Python、Go、Java、Scala、PHP 和 .NET。

.NET Wechaty 是 TypeScript 版本 Wechaty 的翻译版本，利用 .NET Core 实现。由于 .NET Core 支持跨平台，因此 .NET Wechaty 也支持跨平台运行，已经在 Windows、Centos 和 Ubuntu 等操作系统上进行了测试。

2. 项目快速启动

2.1 克隆项目

首先，克隆 .NET Wechaty 的 GitHub 仓库到本地：

git clone https://github.com/wechaty/dotnet-wechaty.git
cd dotnet-wechaty

2.2 安装依赖

使用 NuGet 恢复项目依赖：

dotnet restore

2.3 配置机器人

打开 appsettings.json 文件，配置 Wechaty 的相关设置，包括 Puppet 类型和 Token：

{
  "WECHATY_PUPPET": "wechaty-puppet-hostie",
  "WECHATY_PUPPET_HOSTIE_TOKEN": "your_token_here"
}

2.4 运行机器人

使用 Visual Studio 或命令行运行机器人：

dotnet run

3. 应用案例和最佳实践

3.1 自动回复机器人

一个常见的应用案例是创建一个自动回复机器人。以下是一个简单的示例代码：

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}");
        if (message.Text == "你好")
        {
            message.Say("你好，很高兴见到你！");
        }
    })
    .Start();

3.2 群管理机器人

另一个应用案例是创建一个群管理机器人，用于自动管理群成员和消息：

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 =>
    {
        if (message.Room != null && message.Text.Contains("踢出"))
        {
            var room = message.Room;
            var mentionList = await room.MentionListAsync();
            foreach (var mention in mentionList)
            {
                await room.DelAsync(mention);
            }
        }
    })
    .Start();

4. 典型生态项目

4.1 Wechaty

Wechaty 是一个多语言的聊天机器人 SDK，支持 TypeScript、Python、Go、Java、Scala、PHP 和 .NET。它提供了一个统一的接口，使得开发者可以使用不同的编程语言创建微信聊天机器人。

4.2 Wechaty Puppet Hostie

Wechaty Puppet Hostie 是一个基于 gRPC 的服务抽象模块，用于连接不同的 Wechaty Puppet 实现。它使得 .NET Wechaty 可以复用 TypeScript 版本的生态系统，减少了开发工作量。

4.3 Wechaty Puppet PadLocal

Wechaty Puppet PadLocal 是一个基于 Pad 协议的 Puppet 实现，支持微信的多种功能，如消息发送、群管理、好友管理等。

通过这些生态项目，.NET Wechaty 可以与其他语言版本的 Wechaty 无缝集成，共同构建强大的聊天机器人应用。