内容
# 微信助手
[](LICENSE)
[](SKILL.md)
[](https://www.python.org/)
中文 | [English](README.md)
微信本地解密读取加上微信团队 CLI/Bot 操作层，用于本地聊天搜索、媒体/文件发现、待办事项和在线文档/表格。
## 功能
| 跟踪 | 功能 | 状态 |
|---|---|---|
| B 本地读取 | 解密/导出本地聊天记录、联系人、对话记录、全文本搜索、统计、媒体导出、本地文件发现 | 可用 |
| A 在线操作 | 微信团队 `wecom-cli` 封装，用于文档、在线表格、智能表格、待办事项和其他支持的在线 API | 部分可用，取决于权限 |
| 实时交互 | 微信团队 Bot SDK WebSocket 接收/回复路径 | 计划中 |
旧的自行构建的应用程序 HTTP API 不再是主要路径。历史聊天记录读取默认本地解密；在线写入操作通过微信团队 `wecom-cli` 进行。
## 本地读取
```bash
PY=/opt/homebrew/bin/python3
$PY decrypt/macos/read_wecom.py
$PY decrypt/macos/wecom_local.py stats
$PY decrypt/macos/wecom_local.py contacts <name>
$PY decrypt/macos/wecom_local.py search <query>
$PY decrypt/macos/wecom_local.py conversations|members <conversation>|todo|calendar|media
$PY decrypt/macos/monitor.py --poll 30
$PY decrypt/macos/voice_transcribe.py
```
## 在线文档和表格
```bash
npm install -g @wecom/cli
wecom-cli init
wecom-cli auth show --auth-status
$PY -m online.selfcheck
```
已实现封装：
- `online.docs`：创建普通文档，覆盖 Markdown 内容，创建智能页面。
- `online.local_docs`：读取本地缓存/下载的文档作为在线内容 API 不可用时的备用。
- `online.sheets`：创建在线表格，读取表格元数据，添加/删除子表格，追加行，更新范围。
- `online.smartsheets`：创建智能表格，读取表格/字段，管理表格/字段，在已知记录 ID 时添加/更新/删除记录。
当前 `wecom-cli 0.1.9` 未公开 `get_doc_content`、`sheet_get_data` 或 `smartsheet_get_records`；因此最新的在线内容读取被 `online.selfcheck` 标记为不支持。本地缓存备用仅可读取已在此设备上下载或打开的文件。
## MCP
```bash
bash setup.sh
```
MCP 保留本地工具（`wecom_contacts`、`wecom_search`、`wecom_openfile` 等），添加本地文档备用工具（`wecom_local_doc_read_path`、`wecom_local_doc_search`），并添加在线工具，如 `wecom_doc_create`、`wecom_doc_write_markdown`、`wecom_sheet_append_row` 和 `wecom_smartsheet_add_records`。在线写入工具需要 `confirmed=True`。
## 结构
```text
decrypt/ 跟踪 B 本地解密/读取核心
online/ 跟踪 A 微信团队 CLI 封装
server.py MCP 薄 facade
legacy/self-built-app/ 旧的自行构建的应用程序实验
docs/ 设计笔记、状态和开发文档
tests/ 单元测试
```
## 安全
- 只读取用户自己的设备/账户。
- 解密输出、密钥、凭证和运行时数据保持 gitignored。
- 每个在线写入操作必须在执行前确认目标、内容和影响。
MCP 市场