Chatlog: инструмент с открытым исходным кодом для извлечения и запроса журналов чатов WeChat.

Последние ресурсы по искусственному интеллектуОпубликовано 5 месяцев назад Круг обмена ИИ

Общее введение

Chatlog - это инструмент с открытым исходным кодом, предназначенный для извлечения и запроса журналов чатов из локальной базы данных WeChat. Он поддерживает WeChat версий 3.x и 4.0, охватывая системы Windows и macOS. Пользователи могут просматривать журналы чатов, контакты, групповые чаты и последние разговоры через командную строку, терминальный интерфейс или HTTP API. MCP Протокол SSE, который может быть интегрирован с ИИ-помощниками (например, ChatWise) для быстрого анализа данных чата. Проект основан на лицензии Apache-2.0, код открыт, безопасен и надежен, и подходит для пользователей, которым нужно организовать или проанализировать данные WeChat.

Список функций

Извлеките журналы чатов, контакты, групповые чаты и последние разговоры из локальной базы данных WeChat.
Поддерживает WeChat версий 3.x и 4.0, совместим с различными форматами данных.
Предоставляет терминальный интерфейс (TUI) и инструменты командной строки для интуитивно понятного управления.
Встроенный HTTP API поддерживает запросы к журналам чатов, контактам, групповым чатам и другой информации.
Поддерживает протокол MCP SSE для бесперебойной связи с совместимыми ассистентами искусственного интеллекта.
Обеспечьте функцию расшифровки данных, чтобы пользователи могли безопасно получать доступ к локальным данным.
Открытый исходный код, пользователь может проверить безопасность или настроить функциональность.

Использование помощи

Цель Chatlog - позволить пользователям легко извлекать и запрашивать журналы чатов WeChat. Ниже приведено подробное руководство по установке и использованию, которое поможет пользователям быстро начать работу.

Процесс установки

Chatlog требует некоторых технических операций и подходит для пользователей с базовыми знаниями. Ниже описаны шаги по установке:

Подготовка среды
Убедитесь, что на вашем компьютере установлено следующее программное обеспечение:
- Перейти на сайт: Рекомендуется использовать последнюю версию, инструкции по установке см. на сайте Go.
- Xcode(Пользователи macOS): загрузите программу из App Store для извлечения ключа.
- Клиент WeChat: Убедитесь, что вы установлены и вошли в систему, и что журналы чата должны быть перенесены на ваш компьютер.
Установка из источника
Откройте терминал и выполните следующую команду, чтобы установить Chatlog:
```
go install github.com/sjzar/chatlog@latest
```
После установки Chatlog можно запускать непосредственно из командной строки.
Загрузите предварительно скомпилированную версию
Если вы не хотите компилировать из исходного кода, посетите GitHub Releases и загрузите предварительно скомпилированную версию для вашей системы (например, Windows или macOS). После загрузки распакуйте ее и используйте.
Пользователи macOS отключают SIP
В системе macOS из-за ограничений безопасности при извлечении ключей следует временно отключить SIP, как показано ниже:
- Войдите в режим восстановления:
  - Intel Mac: Нажмите и удерживайте после выключения Command + R включите компьютер, пока не появится логотип Apple.
  - Apple Silicon Mac: После выключения компьютера нажмите и удерживайте кнопку питания до появления опции загрузки.
- Откройте терминал и введите:
```
csrutil disable
```
- Перезагрузите систему:
```
sudo reboot
```
- После извлечения ключа рекомендуется повторно включить SIP (выполните команду csrutil enable (и перезагрузиться).
Перенос записей чата WeChat
Работайте в WeChat на своем мобильном телефоне:
- Откройте "Я - Настройки - Общие - Миграция и резервное копирование истории чата - Миграция - Перенести на ПК".
- Следуйте инструкциям, чтобы перенести записи чата на компьютер клиента WeChat. Эта операция не повлияет на данные мобильного телефона.

Основные функции

Chatlog предоставляет множество способов управления данными чата WeChat, вот как использовать основные функции:

Извлечение и расшифровка данных
После запуска Chatlog программа запросит путь к базе данных WeChat (обычно он находится в macOS ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (или каталог установки WeChat для Windows). После ввода пути выполните следующую команду для расшифровки данных:
```
./chatlog decrypt
```
Расшифрованные данные можно использовать для запросов или отображения.
Операции с интерфейсом терминала (TUI)
Запустите интерфейс терминала:
```
./chatlog
```
Метод работы:
- Для перемещения по меню используйте кнопки со стрелками.
- нажмите Enter Выберите вариант.
- нажмите Esc Возврат на предыдущий уровень.
- нажмите Ctrl+C Процедура выхода.
  В интерфейсе терминала отображаются журналы чата, контакты и другая информация, удобная для быстрого просмотра.
запрос из командной строки
Получите ключ данных microsoft:
```
./chatlog key
```
Запрос конкретных данных (например, журналов чата).
```
./chatlog decrypt
```
Командная строка подходит для пакетных операций или обработки сценариев.
Использование HTTP API
Запустите службу HTTP (порт по умолчанию 5030):
```
./chatlog
```
Доступ через браузер http://127.0.0.1:5030 Просматривайте данные или запрашивайте их с помощью API:
- журнал чата::
```
GET /api/v1/chatlog?time=2023-01-01&talker=wxid_xxx&limit=100&offset=0&format=json
```
  Описание параметра:
  - time: Диапазон времени, например. 2023-01-01 возможно 2023-01-01~2023-12-31.
  - talker: ID чата, поддержка WeChat ID, никнейм или ID группового чата.
  - limit: Возвращает количество записей.
  - offset: Смещение пейджинга.
  - format: Формат вывода (json, иcsv (или текст).
- Список контактов::
```
GET /api/v1/contact
```
- Список групповых чатов::
```
GET /api/v1/chatroom
```
- Последние сеансы::
```
GET /api/v1/session
```
Просмотр браузера
После запуска службы HTTP откройте браузер и зайдите на сайт http://127.0.0.1:5030. Страница отображает записи чата, контакты и другой контент, поддерживает сортировку по времени или объекту и имеет интуитивно понятное управление.

Функциональное управление

Уникальность Chatlog заключается в его открытом исходном коде и интеграции искусственного интеллекта:

Интеграция протокола MCP SSE
Chatlog поддерживает протокол MCP SSE для связи с ассистентами искусственного интеллекта (например, ChatWise, Claude). Этапы настройки:
- Запустите HTTP-службу Chatlog.
- Добавьте новый инструмент в настройки AI Assistant:
  - Тип:sse.
  - URL:http://127.0.0.1:5030/sse.
  - Отметьте "Инструменты автоматизированного выполнения".
- После настройки помощник ИИ может напрямую запрашивать записи чатов. Например, если ввести в ChatWise "Найти чаты с Сяомином вчера", помощник вернет соответствующие записи.
- Если инструмент искусственного интеллекта не поддерживает MCP SSE, используйте mcp-proxy Передайте запрос. Например. Клод Редактирование на рабочем столе config.json::
```
{
"mcpServers": {
"mcp-proxy": {
"command": "/path/to/mcp-proxy",
"args": ["http://localhost:5030/sse"],
"env": {}
}
}
}
```
Открытый исходный код и персонализация
Chatlog основан на лицензии Apache-2.0, и его код находится в открытом доступе, так что пользователи могут проверять безопасность или изменять функциональность. Например:
- Добавьте новый формат экспорта (например, CSV):
  - компилятор src/export.goДобавьте логику экспорта.
  - быть в движении go build Перекомпилируйте.
- Оптимизируйте скорость выполнения запросов:
  - модификации src/query.go, настраивая индекс базы данных.
    Открытый исходный код позволяет пользователям расширять функциональность по мере необходимости.

Дополнительные функции (упомянутые в официальном описании, но отсутствующие в оригинальной презентации)

Поддержка нескольких систем
Chatlog совместим как с Windows, так и с macOS, а процесс его создания согласован для обеспечения кросс-платформенного доступа.
Функция планирования (TODO)
Согласно официальному сообщению, Chatlog будет поддерживаться и в будущем:
- Извлечение мультимедийных данных (например, изображений, речи).
- Полнотекстовое индексирование данных чата для ускорения поиска.
- Панель статистики данных, показывающая результаты анализов, таких как частота сообщений, ключевые слова и т. д.
  Эти функции еще не реализованы, но показывают направление постоянного совершенствования проекта.

предостережение

безопасность данных: Chatlog обрабатывает только локальные данные и не загружает их в веб. Пользователи могут проверить код через GitHub, чтобы убедиться в безопасности.
Работа с SIP: пользователям macOS нужно отключать SIP только при извлечении ключей, а по окончании работы снова включать его.
Версия WeChat: Убедитесь, что клиент WeChat имеет версию 3.x или 4.0, другие версии могут быть несовместимы.
Резервное копирование данных: Рекомендуется регулярно создавать резервные копии файлов баз данных microsoft, чтобы предотвратить их случайную потерю.

Выполнив эти действия, пользователи смогут легко установить Chatlog, извлекать журналы чатов или анализировать данные с помощью API и AI-ассистентов.

сценарий применения

Организуйте чаты
Пользователи хотят сохранить сообщения WeChat с друзьями или групповые чаты, Chatlog может извлечь и упорядочить записи для удобного архивирования или экспорта.
Управление групповым чатом
Когда групповой чат перегружен сообщениями, Chatlog может быстро найти речи или ключевые слова конкретных участников, что делает его удобным для администраторов групп.
анализ данных
Разработчикам нужна статистика по частоте чатов или ключевым словам, и HTTP API Chatlog предоставляет структурированные данные, подходящие для исследований или отчетов.
Сотрудничество с искусственным интеллектом
Пользователи хотят, чтобы помощник ИИ узнавал, о чем они общаются в чате, а поддержка MCP SSE в Chatlog позволяет ИИ напрямую читать и анализировать данные.

QA

Какие системы поддерживает Chatlog?
Поддерживает Windows и macOS и совместим с WeChat версий 3.x и 4.0.
Как вы обеспечиваете безопасность данных?
Chatlog - это инструмент с открытым исходным кодом, где данные обрабатываются только локально, код общедоступен для просмотра и не выкладывается в сеть.
macOS Почему нужно отключить SIP?
Механизм безопасности WeChat ограничивает извлечение ключей, и отключение SIP - это временная операция, которая может быть снова включена после завершения.
Какие запросы данных поддерживает API?
Поддержка журналов чатов, контактов, групповых чатов и запросов последних сессий в форматах JSON и CSV.
Как он интегрируется с ассистентами ИИ?
Запустите службу SSE Chatlog и настройте URL-адрес инструмента помощника ИИ следующим образом http://127.0.0.1:5030/sse Вот и все.