{"contents":"# 用户指南\n\n## 1. 安装\n\n### Nix Flake（推荐）\n\n```bash\n# 进入开发环境（自动安装所有依赖）\nnix develop\n\n# 或直接运行\nnix run .\n```\n\n## 2. 前置条件\n\n- Linux 系统\n- 微信 4.x Linux 版（AppImage）正在运行\n- 需要有权限读取微信进程的内存（通常需要同用户或 root）\n\n## 3. CLI 命令\n\n```bash\nwxdump -h          # 查看所有命令帮助\nwxdump -V          # 查看版本\n```\n\n### 3.1 info — 获取微信信息\n\n从运行中的微信进程内存提取基本信息（pid、wx_dir、密钥等）。\n\n```bash\nwxdump info\nwxdump info -s /tmp/wxinfo.json    # 保存到文件\n```\n\n### 3.2 linux_key — 提取数据库密钥\n\n扫描微信进程内存，提取所有数据库的 SQLCipher 4 raw key。\n\n```bash\nwxdump linux_key\nwxdump linux_key --wx-dir /path/to/wechat/data    # 指定数据目录\n```\n\n### 3.3 decrypt — 解密数据库\n\n自动从进程内存提取密钥，解密所有 SQLCipher 4 数据库。\n\n```bash\nwxdump decrypt                          # 自动检测路径，输出到 ./decrypted\nwxdump decrypt -i /path/to/wx/data      # 指定微信数据目录\nwxdump decrypt -o /path/to/output       # 指定输出目录\n```\n\n### 3.4 merge — 合并数据库\n\n将已解密的多个数据库合并为单一文件。\n\n```bash\nwxdump merge -i ./decrypted -o ./merged/merge.db\nwxdump merge -i file1.db,file2.db -o merge.db\n```\n\n### 3.5 ui — 启动 Web 界面\n\n启动图形界面，在浏览器中查看聊天记录。\n\n```bash\nwxdump ui                       # 默认端口 5000\nwxdump ui -p 8080               # 指定端口\nwxdump ui --online              # 允许局域网访问\nwxdump ui --noOpenBrowser       # 不自动打开浏览器\n```\n\n### 3.6 api — 启动 API 服务\n\n启动 API 服务，不打开浏览器。\n\n```bash\nwxdump api\nwxdump api -p 8080 --online\n```\n\n### 3.7 dbshow — 查看已合并的数据库\n\n直接查看已解密合并的数据库。\n\n```bash\nwxdump dbshow -merge ./merge_all.db -wid /path/to/wx/data\n```\n\n## 4. Python API\n\n```python\nfrom wxdump_linux import get_wx_info, batch_decrypt, merge_db, decrypt_merge\nfrom wxdump_linux.linux import find_wechat_files_path, extract_all_keys\n\n# 获取微信信息\ninfo = get_wx_info(is_print=True)\n\n# 提取密钥\nwx_dir = find_wechat_files_path()\ndb_keys = extract_all_keys(wx_dir)\n# db_keys = {db_path: (enc_key_hex, salt_hex), ...}\n\n# 解密\ncode, results = batch_decrypt(db_keys, \"./decrypted\", is_print=True)\n\n# 一键解密+合并\ncode, merge_path = decrypt_merge(wx_path=wx_dir, outpath=\"./output\")\n```\n\n## 5. FAQ\n\n详见 [FAQ](./FAQ.md)\n\n## 6. 更新日志\n\n详见 [CHANGELOG](./CHANGELOG.md)\n","is_binary":false,"path":"doc/UserGuide.md","ref":""}