diff --git a/README.md b/README.md index e735c1b..566631f 100644 --- a/README.md +++ b/README.md @@ -194,6 +194,8 @@ flowchart LR 6. 需要 AI 问答或日报时，在“设置 → AI 模型”添加并测试 AI 服务，再打开“问问微信”或“日报”。 7. 想直接在微信里提问时，打开“Agent”扫码连接微信机器人；想让 Codex 等外部 Agent 查询时，再进入“API”。 +Windows 安装后无法启动时，请先安装 [Microsoft Visual C++ x64 运行库](https://aka.ms/vc14/vc_redist.x64.exe)。当前完整测试过的微信客户端为 Windows `4.1.9.57` 和 macOS `4.1.8.100`；下载地址与连接要求见[第一次使用](./docs/user-guide/getting-started.md)。 + 如果 macOS 页面提示处理 SIP，请先阅读对应说明。具体步骤和限制见[第一次使用](./docs/user-guide/getting-started.md)。 完整步骤：[第一次使用 WechatExplorer](./docs/user-guide/getting-started.md) @@ -284,4 +286,3 @@ WechatExplorer 在开发过程中参考了多个优秀的开源项目，感谢 感谢所有开源作者。 - diff --git a/docs/user-guide/getting-started.md b/docs/user-guide/getting-started.md index 33869b5..bf748ba 100644 --- a/docs/user-guide/getting-started.md +++ b/docs/user-guide/getting-started.md @@ -8,29 +8,59 @@ ## 1. 开始前准备 -- 一台 macOS 或 Windows 电脑。 -- 已安装并使用过微信桌面客户端。 -- 你有权访问要读取的微信账号和聊天数据。 +| 系统 | 已测试的微信客户端 | 需要注意 | +| ------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | +| macOS | [微信 macOS `4.1.8.100`](https://github.com/zsbai/wechat-versions/releases/tag/4.1.8.100) | 自动获取数据库密钥前，需要按连接页面提示完成授权；页面明确要求时还需要处理 SIP | +| Windows | [微信 Windows `4.1.9.57`](https://github.com/iibob/wechat-win-archive/releases#release-v4.1.9.57) | 首次使用时请确认微信数据目录；Windows 不需要关闭 SIP | + +- 上表是当前实际测试过的客户端版本，不代表只有这些版本可以使用。其他微信 4.x 版本可能可以连接，但尚未逐一验证。 +- WechatExplorer 必须取得当前微信账号对应的数据库密钥，才能读取聊天记录。 +- 你需要有权访问要读取的微信账号和聊天数据。 - 如果要使用 AI 问答、群聊日报或图片理解，还需要在应用中配置一个 AI 服务。 当前代码按微信 4.x 数据结构处理。不同微信客户端版本、系统权限和数据迁移状态可能影响自动连接；遇到问题时请查看[常见问题与排查](./troubleshooting.md)。 ## 2. 安装并启动 -1. 从 [GitHub Releases](https://github.com/Wxw-Gu/WechatExplorer/releases) 下载对应系统的安装包。 -2. Windows 使用 `-setup.exe` 安装；macOS 打开 `.dmg` 并将应用拖入“应用程序”。 -3. 启动 WechatExplorer，进入“第一次使用”页面。 +安装包统一从 [GitHub Releases](https://github.com/Wxw-Gu/WechatExplorer/releases) 下载。 -macOS 如果提示无法验证开发者，请按系统提示允许打开。自动获取数据库密钥需要额外系统授权时，先阅读[macOS 数据访问说明](../platform/macos.md)。不要在不理解风险的情况下长期关闭系统安全保护。 +### Windows + +1. 从 Releases 下载 Windows x64 的 `WechatExplorer-<版本号>-setup.exe` 安装包。 +2. 双击安装包，按向导完成安装。 +3. 启动 WechatExplorer。 +4. 如果安装完成后软件无法启动，请安装 Microsoft Visual C++ x64 运行库：[vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe)，安装完成后重新启动 WechatExplorer。 + +### macOS + +1. 根据处理器下载对应的 `.dmg`：Apple Silicon（M 系列）选择 `arm64`，Intel Mac 选择 `x64`。 +2. 打开 DMG，将 WechatExplorer 拖入“应用程序”文件夹。 +3. 如果系统提示“无法打开，因为开发者无法验证”，前往“系统设置 → 隐私与安全性”，点击“仍要打开”。 +4. 如果系统提示应用已损坏，可在终端执行： + + ```bash + xattr -cr "/Applications/WechatExplorer.app" + ``` + +5. 启动 WechatExplorer。首次自动获取数据库密钥时，按连接页面显示的授权要求操作；只有页面明确提示时才按[关闭 SIP 教程](../mac-disable-sip.md)处理。关闭 SIP 会降低系统安全性，完成密钥配置后应重新开启。 + +更完整的权限和安全边界见 [macOS 数据访问说明](../platform/macos.md)。 ## 3. 让应用读取微信数据 -第一次打开时，应用会引导你完成数据库连接。核心是两件事：找到当前微信数据目录，并取得对应账号的数据库密钥。 +首次启动会自动进入“第一次使用”页面。页面会根据当前系统显示连接方式和注意事项： -1. 在连接页面确认微信数据目录。自动识别不准确时，打开微信设置中的缓存/存储管理，复制实际路径后粘贴到页面。 -2. 第一次使用先点击“开始连接”，按页面提示准备连接组件和获取密钥；只有已经通过其他方式拿到密钥的高级用户才选择“手动连接”。 -3. 如果自动获取要求微信处于特定登录状态，请按页面提示完成登录、授权或重新检测；不要只关闭微信窗口就认为已经退出。 -4. 点击开始连接，等待数据库、账号和联系人检查完成。 +

+ 第一次使用连接页面 +

+ +通常按下面三步操作即可： + +1. **确认微信数据目录**：自动识别不准确时，打开微信设置中的缓存/存储管理，复制实际路径并在页面中修改。 +2. **让微信停在登录页面**：如果微信已经登录，先退出当前微信账号，不只是关闭微信窗口。 +3. **点击“开始连接”并按提示获取密钥**：软件准备好连接组件后会提示你登录微信；回到微信完成登录，再等待数据库、账号和联系人检查完成。 + +只有已经通过其他方式取得当前账号数据库密钥的高级用户，才需要选择“手动连接”。Windows 不需要关闭 SIP；macOS 是否需要额外授权或处理 SIP，以当前连接页面提示为准。 连接页面会显示微信状态、数据库状态和诊断结果。连接失败时先不要反复删除数据，优先查看[连接问题排查](./troubleshooting.md#连接微信失败)。 diff --git a/docs/user-guide/troubleshooting.md b/docs/user-guide/troubleshooting.md index a766b02..e5274bb 100644 --- a/docs/user-guide/troubleshooting.md +++ b/docs/user-guide/troubleshooting.md @@ -2,6 +2,21 @@ 先按现象定位，不要为了“重置”而直接删除微信数据库或整个应用目录。 +## 安装后软件无法打开 + +### Windows + +1. 确认下载的是 GitHub Releases 中的 Windows x64 `-setup.exe`，并已完成安装。 +2. 安装 [Microsoft Visual C++ x64 运行库](https://aka.ms/vc14/vc_redist.x64.exe)。 +3. 安装完成后重新启动 WechatExplorer；如果仍无响应，再重新运行安装包进行覆盖安装。 + +### macOS + +- 提示“无法打开，因为开发者无法验证”时，前往“系统设置 → 隐私与安全性”并点击“仍要打开”。 +- 提示应用已损坏时，确认应用位于“应用程序”目录，再执行 `xattr -cr "/Applications/WechatExplorer.app"`。 + +完整安装步骤见[第一次使用 WechatExplorer](./getting-started.md#2-安装并启动)。 + ## 连接微信失败 依次检查：