wx-cli

Category: Data & AI | Uploader: jackwener | Downloads: 0 | Version: v1.0（Latest）

> description: "wx-cli — 从本地微信数据库查询聊天记录、联系人、会话、收藏等。用户提到微信聊天记录、联系人、消息历史、群成员、收藏内容时，使用此 skill 安装并调用 wx-cli。"

Changelog: Source: GitHub https://github.com/jackwener/wx-cli

Directory Structure

Current level: tree/main/

📁 .claude/
- 📄 settings.local.json 729 B
📁 .github/
- 📁 workflows/
  - 📄 release.yml 4.8 KB
📁 docs/
- 📄 macos-3x-vs-4x-decryption-guide.md 14.1 KB
- 📄 macos-permission-guide.md 7.0 KB
📁 npm/
- 📁 platforms/
  - 📁 darwin-arm64/
    
    📄 package.json 250 B
  - 📁 darwin-x64/
    
    📄 package.json 244 B
  - 📁 linux-arm64/
    
    📄 package.json 248 B
  - 📁 linux-x64/
    
    📄 package.json 242 B
  - 📁 win32-x64/
    
    📄 package.json 244 B
- 📁 wx-cli/
  - 📁 bin/
    
    📄 wx.js 1.4 KB
  - 📄 install.js 827 B
  - 📄 package.json 841 B
📁 src/
- 📁 cli/
  - 📄 contacts.rs 427 B
  - 📄 daemon_cmd.rs 3.4 KB
  - 📄 export.rs 2.6 KB
  - 📄 favorites.rs 796 B
  - 📄 history.rs 2.5 KB
  - 📄 init.rs 4.2 KB
  - 📄 members.rs 391 B
  - 📄 mod.rs 7.2 KB
  - 📄 new_messages.rs 2.1 KB
  - 📄 output.rs 436 B
  - 📄 search.rs 1023 B
  - 📄 sessions.rs 389 B
  - 📄 stats.rs 560 B
  - 📄 transport.rs 6.2 KB
  - 📄 unread.rs 385 B
- 📁 crypto/
  - 📄 mod.rs 3.6 KB
  - 📄 wal.rs 2.5 KB
- 📁 daemon/
  - 📄 cache.rs 6.9 KB
  - 📄 mod.rs 4.2 KB
  - 📄 query.rs 52.2 KB
  - 📄 server.rs 8.0 KB
- 📁 scanner/
  - 📄 linux.rs 5.5 KB
  - 📄 macos.rs 14.4 KB
  - 📄 mod.rs 8.3 KB
  - 📄 windows.rs 6.3 KB
- 📄 config.rs 7.7 KB
- 📄 ipc.rs 3.2 KB
- 📄 main.rs 193 B
📄 .gitignore 372 B
📄 AGENTS.md 1.2 KB
📄 Cargo.lock 35.4 KB
📄 Cargo.toml 1.6 KB
📄 CLAUDE.md 1.7 KB
📄 config.example.json 165 B
📄 install.ps1 2.2 KB
📄 install.sh 2.1 KB
📄 LICENSE 11.1 KB
📄 README.md 6.0 KB
📄 SKILL.md 4.1 KB

SKILL.md

# wx-cli

> description: "wx-cli — 从本地微信数据库查询聊天记录、联系人、会话、收藏等。用户提到微信聊天记录、联系人、消息历史、群成员、收藏内容时，使用此 skill 安装并调用 wx-cli。"

## Triggers

- 查微信聊天记录
- 微信消息历史
- 微信联系人
- 微信群成员
- 微信收藏
- wechat history / messages / contacts
- wx-cli
- 帮我看看微信里
- 搜索微信消息

## Prerequisites

- macOS（Apple Silicon / Intel）或 Linux
- 微信桌面版 4.x 已安装并登录
- Node.js >= 14（npm 安装方式）或 curl（shell 安装方式）
- 首次 `wx init` 需要 `sudo`（内存扫描提取密钥）

---

## 安装

### 方式一：npm（推荐）

```bash
npm install -g @jackwener/wx-cli
```

### 方式二：curl

```bash
curl -fsSL https://raw.githubusercontent.com/jackwener/wx-cli/main/install.sh | bash
```

安装后验证：

```bash
wx --version
```

---

## 初始化（首次使用，只需一次）

### macOS（必须按顺序执行）

**第一步：对 WeChat 重新签名**（只需做一次，WeChat 更新后需重做）

```bash
codesign --force --deep --sign - /Applications/WeChat.app
```

如果报错 `signature in use` 或某个 dylib 签名损坏，先修复再签名：

```bash
codesign --remove-signature "/Applications/WeChat.app/Contents/Frameworks/vlc_plugins/librtp_mpeg4_plugin.dylib"
codesign --force --deep --sign - /Applications/WeChat.app
```

**第二步：重启 WeChat**

```bash
killall WeChat && open /Applications/WeChat.app
# 等待微信完全登录后再继续
```

**第三步：初始化**

```bash
sudo wx init
```

### Linux

```bash
sudo wx init
```

`wx init` 会自动：
1. 检测微信数据目录
2. 扫描进程内存，提取所有数据库密钥
3. 写入 `~/.wx-cli/config.json`

初始化完成后，后续所有命令无需 `sudo`，daemon 在首次调用时自动启动。

---

## 命令速查

所有命令默认输出 YAML，更省 token & 易读；`--json` 可切换为 JSON（方便 `jq` 处理等）。

### 会话与消息

```bash
# 最近 20 个会话
wx sessions

# 有未读消息的会话
wx unread

# 上次检查后的新消息（增量）
wx new-messages
wx new-messages --json          # JSON 输出，适合 agent 解析

# 聊天记录（支持昵称/备注名）
wx history "张三"
wx history "AI群" --since 2026-04-01 --until 2026-04-15 -n 100

# 全库搜索
wx search "关键词"
wx search "会议" --in "工作群" --since 2026-01-01
```

### 联系人与群组

```bash
# 联系人列表 / 搜索
wx contacts
wx contacts --query "李"

# 群成员列表
wx members "AI交流群"
```

### 收藏与统计

```bash
# 全部收藏
wx favorites

# 按类型筛选：text / image / article / card / video
wx favorites --type image

# 搜索收藏内容
wx favorites --query "关键词"

# 聊天统计（发言人、消息类型、活跃时段）
wx stats "AI群"
wx stats "AI群" --since 2026-01-01
```

### 导出

```bash
# 导出为 Markdown（默认）
wx export "张三" --format markdown -o chat.md

# 导出为 JSON
wx export "AI群" --since 2026-01-01 --format json -o chat.json
```

### Daemon 管理

```bash
wx daemon status
wx daemon stop
wx daemon logs --follow
```

---

## Agent 使用建议

查询结果需要程序处理时，统一加 `--json`：

```bash
wx sessions --json
wx new-messages --json
wx search "关键词" --json
wx history "张三" --json -n 50
```

CHAT 参数支持昵称、备注名、微信 ID，模糊匹配。不确定准确名称时，先用 `wx contacts --query` 搜索。

---

## 数据文件位置

```
~/.wx-cli/
├── config.json       # 配置
├── all_keys.json     # 数据库密钥（敏感，勿分享）
├── daemon.sock       # Unix socket
├── daemon.pid / .log
└── cache/            # 解密后的数据库缓存
```

---

## 常见问题

**微信重启后密钥失效**：重新运行 `sudo wx init --force`（微信必须正在运行）。

**daemon 无响应**：`wx daemon stop` 后重新调用任意命令自动重启。

**找不到聊天**：用 `wx contacts --query` 确认昵称/备注名，或用微信 ID 直接查询。

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

wx-cli

Directory Structure

SKILL.md

Report

Notice