whats-reader 仓库中文介绍文档

whats-reader 是一款隐私优先的离线WhatsApp聊天导出浏览工具，由 rodrigogs 提供，支持语音转录、书签、搜索和统计功能，适用于需要安全处理敏感信息的用户。该工具汇聚人工智能、桌面应用和隐私保护等核心内容。

要点：

开头就要说清楚：这是什么工具、解决什么问题
包含Stars数（如有）、维护者信息
1-3句话，简洁有力

一、核心信息速览

维度	详情
:---	:---
仓库地址	[whats-reader](https://github.com/rodrigogs/whats-reader)
许可证	MIT License
核心定位	离线浏览WhatsApp聊天导出，保护用户隐私
主要语言	Svelte
适用人群	需要处理WhatsApp聊天数据的个人用户；注重隐私的数据分析人员；需要备份和恢复聊天记录的企业用户
关键亮点	离线使用；AI语音转录；书签与搜索功能；隐私保护；支持大聊天记录

二、核心功能

功能模块	描述	典型场景
:---	:---	:---
离线浏览	支持本地查看WhatsApp聊天导出文件	不需要网络连接即可访问聊天记录
语音转录	使用Whisper AI将语音消息转为文字	快速查找语音内容，无需逐条播放
媒体库	可视化展示照片、视频和音频文件	批量下载或查看特定媒体文件
书签与搜索	添加书签并快速搜索关键词	快速定位重要对话或信息
统计功能	提供聊天数据的统计分析	了解消息频率、活跃时间等
多语言支持	支持多种语言界面	适应不同地区用户的使用需求
跨平台兼容	支持桌面和网页端使用	适用于不同设备环境

三、快速上手

1. 环境准备

安装Node.js（建议版本16+）
安装Electron（如需构建桌面应用）

2. 安装方式

npm install

3. 基础配置

下载最新版本的whats-reader
解压后运行程序，选择WhatsApp导出文件

4. 核心示例

// 示例：在Electron中打开主窗口
const { app, BrowserWindow } = require('electron');

function createWindow () {
  const win = new BrowserWindow({
    width: 800,
    height: 600,
    webPreferences: {
      nodeIntegration: true
    }
  });

  win.loadFile('index.html');
}

app.whenReady().then(createWindow);

四、核心亮点

隐私优先：所有数据仅存储在本地，无云端传输。
AI语音转录：通过本地Whisper实现语音转文字，无需API密钥。
多功能支持：包括书签、搜索、统计等功能，提升使用效率。
多平台兼容：支持桌面和网页端，方便不同设备使用。

五、适用场景

隐私敏感数据处理：适合处理包含个人信息的WhatsApp聊天记录。
大数据分析：适用于需要分析大量聊天数据的场景。
离线办公：在没有网络的情况下也能访问聊天内容。
多语言用户：支持多种语言界面，便于全球用户使用。
企业备份需求：可用于企业级WhatsApp聊天记录的备份与管理。

六、优缺点

优势

高度隐私保护，数据不上传至服务器
支持AI语音转录，提高信息检索效率
操作简单，界面友好，易于使用

不足

目前仅支持WhatsApp导出文件，不兼容其他聊天软件
对于非技术用户可能需要一定的学习成本

七、与同类工具对比（可选）

工具	类型	核心差异
:---	:---	:---
whats-reader	开源工具	免费开源，隐私保护强，支持AI语音转录
WhatsApp Web	在线服务	依赖网络连接，数据可能被存储在服务器上