search

ehForwarderBot / efb-wechat-slave

A channel for EH Forwarder Bot.
GNU Affero General Public License v3.0
459 stars 62 forks source link
efb-slave-channel eh-forwarder-bot

readme

EFB WeChat Slave Channel：EFB 微信从端 (EWS)

.. image:: https://img.shields.io/pypi/v/efb-wechat-slave.svg :alt: PyPI 发布 :target: https://pypi.org/project/efb-wechat-slave/ .. image:: https://github.com/ehForwarderBot/efb-wechat-slave/workflows/Tests/badge.svg :alt: 测试状态 :target: https://github.com/ehForwarderBot/efb-wechat-slave/actions .. image:: https://pepy.tech/badge/efb-wechat-slave/month :alt: 每月下载量 :target: https://pepy.tech/project/efb-wechat-slave .. image:: https://d322cqt584bo4o.cloudfront.net/ehforwarderbot/localized.svg :alt: Translate this project :target: https://crowdin.com/project/ehforwarderbot/

.. image:: https://github.com/ehForwarderBot/efb-wechat-slave/raw/master/banner.png :alt: 头图

.. image:: https://i.imgur.com/dCZfh14.png :alt: This project proudly supports #SayNoToWeChat campaign.

README in other languages_.

.. TRANSLATORS: change the URL on previous line as "." (without quotations). .. _README in other languages: ./readme_translations

Channel ID: blueset.wechat

EWS 是兼容 EH Forwarder Bot 的微信从端，基于逆向工程的微信网页版、\ 修改版 wxpy\  和 \ ItChat\ 。

本项目的部分代码修改自 youfou/wxpy\ 、\ littlecodersh/ItChat\ 。

.. _youfou/wxpy: https://github.com/youfou/wxpy .. _littlecodersh/ItChat: https://github.com/littlecodersh/ItChat/

使用前须知

自 2017 年中旬以来，陆续有用户报告其微信网页版登录被腾讯封禁。\ 表现为用任何方式登录微信网页版提示「当前登录环境异常。为了你的账号安全，\ 暂时不能登录 Web 微信。你可以通过手机客户端或 Windows 微信登录」\ 或类似的提示。大部分用户会在封禁后一天到三个月内解封，不同用户的解封耗时不同。\ 据观测，仅有约不足一成的用户在使用过程中被封禁。该封禁不影响其他客户端的登录。\ 目前封禁的原因尚不明确。

与此同时，有现象表明 2017 年中旬以来新注册的微信用户不能够使用微信网页版。\ 在初次使用之前，请先访问\ 微信网页版_\ 并确认您可以正常使用此功能。\ 若您的账号不能使用该功能，请尝试换用其他账号尝试。

如果你对网页版登录有要求的话，请慎用此信道。详细的相关信息请参见 issue #7_\ 。

.. _微信网页版: https://web.wechat.com/ .. _issue #7: https://github.com/ehForwarderBot/efb-wechat-slave/issues/7

软件依赖

安装与启用

  1. 安装如上所要求的二进制依赖

  2. 安装

    .. code:: shell

    pip3 install efb-wechat-slave

  3. 使用 \ EFB 配置向导\ ，或在当前配置档案（Profile）目录的 \ config.yaml\  文件中启用 EWS。

    当前配置文件夹的位置会根据用户的设定而改变。

    (EFB 2 中，默认的配置档案目录位于  ~/.ehforwarderbot/profiles/default\  )

其他的安装方式


EWS 同时存在由社区提供的其他安装方式，包括：

- 由 KeLiu_ 维护的 `AUR 软件包`_\ （``python-efb-wechat-slave-git``）。
- 其他\ `安装脚本或 Docker 等容器`_\ 。

.. _KeLiu: https://github.com/specter119
.. _AUR 软件包: https://aur.archlinux.org/packages/python-efb-wechat-slave-git
.. _安装脚本或 Docker 等容器: https://efb-modules.1a23.studio#scripts-and-containers-eg-docker

可选的配置文件
--------------

EWS 支持使用可选的配置文件来启用实验功能。配置文件存储于
``<当前配置文件夹>/blueset.wechat/config.yaml``\ 。

配置文件例

.. code:: yaml

# 实验功能
# 使用本段来调整实验功能的设置。请注意实验功能随时可能变更或失效。
# 详细说明见下文。
flags:
    option_one: 10
    option_two: false
    option_three: "foobar"

常见问题

已知问题

实验功能

以下的实验功能可能不稳定，并可能随时更改、删除。使用时请注意。

.. _#48: https://ews.1a23.studio/issues/48

vendor_specific

EWS 的 \ Chat\  提供了以下的 \ vendor_specific\  项目：

开源许可

EWS 使用了 \ GNU Affero 通用公共许可协议 3.0_\ （GNU Affero General Public License 3.0）或更新版本作为其开源许可::

EFB 微信从端：一个适用于 EH Forwarder Bot 的从端
Copyright (C) 2016 - 2020 Eana Hufwe 和 EFB 微信从端贡献者
保留所有权利。

此程序是一个自由软件；您可以在遵守由自由软件基金会发布的第三版或更新
版本的 GNU Affero 通用公共许可协议的情况下重新分发并和/或修改软件。

我们本着可为人所用的意愿分发此软件，但并不提供任何保证；甚至没有商业
性的或对特定目的适用性的暗指。更多细节请参看 GNU Affero 通用公共许可
协议。

您应该已经随收到一份 GNU Affero 通用公共许可协议；如果没有，请查阅
<http://www.gnu.org/licenses/>。

.. _GNU Affero 通用公共许可协议 3.0: https://www.gnu.org/licenses/agpl-3.0.txt

翻译界面

EWS 启用了社区支持的本地化翻译。您可以将语言环境变量 (LANGUAGE, LC_ALL, LC_MESSAGES 或 LANG) 设为一种\ 已支持的语言\ 。 同时，您也可以在我们的 Crowdin 项目\ 里面将 EWS 翻译为您的语言。

.. _已支持的语言: https://crowdin.com/project/ehforwarderbot/ .. _Crowdin 项目: https://crowdin.com/project/ehforwarderbot/

.. note::

如果您是从源码安装的 EWS，您需要在安装前事先编译翻译文本目录（\ ``.mo``\ ），\
才可启用界面翻译。