WeChatAssistant: система плагинов умного ассистента для WeChat 148

Что такое плагин WeChatAssistant (微信智能助手)?

WeChatAssistant — это модульная расширяемая система плагинов, разработанная на базе фреймворка 无界BNCR. Она предоставляет WeChat интеллектуальные вспомогательные функции, такие как запрос погоды, диалог с ИИ и напоминания о расписании. Система использует плагинную архитектуру, которая упрощает расширение и обслуживание, поддерживает управление через конфигурацию и горячую перезагрузку, содержит встроенную поддержку нескольких моделей ИИ, а также управляет конфиденциальной информацией через переменные среды, обеспечивая безопасность.

Что такое фреймворк 无界BNCR?

无界BNCR — это кроссплатформенный робот-фреймворк, поддерживающий WeChat, QQ, Telegram и другие платформы. Плагин WeChatAssistant разработан специально для фреймворка 无界BNCR и может быть бесшовно интегрирован в среду 无界BNCR, предоставляя расширенные функции для платформы WeChat.

Возможности плагина WeChatAssistant

• Плагинная архитектура: все функции реализованы в виде плагинов, что упрощает расширение и обслуживание.

• Управление через конфигурацию: все функции управляются через файлы конфигурации, без необходимости перекомпиляции.

• Интеграция ИИ: встроенная поддержка нескольких моделей ИИ с возможностью лёгкого расширения.

• Горячая перезагрузка: автоматическая перезагрузка плагинов при изменении их кода.

• Механизм безопасности: изоляция прав доступа плагинов для предотвращения вредоносных действий.

• Совместимость с 无界BNCR: полная совместимость с фреймворком 无界BNCR, может использоваться как плагин 无界BNCR.

• Защита конфиденциальной информации: API-ключи и другие конфиденциальные данные управляются через переменные среды, что предотвращает утечку информации.

• Система управления правами: продуманный контроль пользовательских разрешений с разделением прав обычных пользователей и администраторов.

Архитектура плагина WeChatAssistant

• Основной модуль: core.js, отвечает за загрузку плагинов и маршрутизацию сообщений.

• Загрузчик плагинов: plugin-loader.js, отвечает за инициализацию и мониторинг изменений плагинов.

• Менеджер конфигураций: config-manager.js, обрабатывает конфиденциальную информацию и слияние конфигураций.

• Менеджер прав доступа: permission-manager.js, управляет правами пользователей и контролем доступа к командам.

• Файлы конфигурации: config.json (для локального использования, не коммитится), config.example.json (пример конфигурации без конфиденциальной информации).

• Файл переменных среды: .env (для локального использования, не коммитится), .env.example (пример переменных среды).

• Каталог плагинов: plugins/, содержит различные плагины, такие как плагин погоды, плагин ИИ-чата, плагин утренних напоминаний и другие.

• Главный файл точки входа: 智能助手.js.

Способ установки

Предварительные требования

• Node.js (v14.0.0+)

• npm или yarn

• Среда фреймворка 无界BNCR

Установка в качестве плагина 无界BNCR

1. Перейдите в каталог плагинов 无界BNCR.

2. Клонируйте репозиторий.

3. Установите зависимости.

4. Настройте конфиденциальную информацию, создайте файл переменных среды и заполните необходимые API-ключи.

5. Создайте локальный файл конфигурации и при необходимости скорректируйте неконфиденциальные параметры.

6. Перезапустите фреймворк BNCR, система автоматически загрузит этот плагин.

Автономное использование

1. Клонируйте репозиторий.

2. Установите зависимости.

3. Настройте переменные среды и файл конфигурации в соответствии с шагами, описанными выше.

4. Запустите.

Управление конфиденциальной информацией

• Переменные среды: все API-ключи и прочая конфиденциальная информация хранятся в файле .env, который не коммитится в репозиторий.

• Разделение конфигурации: каждый плагин разделяет конфигурацию на общую и конфиденциальную.

• Менеджер конфигураций: автоматическая загрузка и слияние конфигураций из разных источников.

Инструкция по использованию

• Общие команды: например, /help — отображение справки, /plugins list — список всех доступных плагинов и т.д.

• Плагин погоды: например, /weather название_города — запрос текущей погоды в указанном городе.

• Плагин ИИ-чата: например, /chat содержимое — диалог с ИИ.

• Плагин утренних напоминаний: например, /morning on — включение ежедневных утренних напоминаний.

• Команды управления правами (только для администраторов): например, /admin list — список всех пользователей-администраторов.

Как разработать новый плагин

1. Создайте новый каталог плагина в директории plugins/.

2. Создайте файл index.js и реализуйте интерфейс плагина.

3. Добавьте конфигурацию плагина по умолчанию в файл config.example.json.

4. Обновите метки правил (@rule) в файле 智能助手.js.

5. Включите плагин в глобальной конфигурации.

Адрес на Github:https://github.com/2013888483/WeChatAssistant