wecom-agent — 企業微信全能 agent
| 線 | 能力 | 入口 | 依賴 |
|---|---|---|---|
| A 主動操作 | 發訊息/通訊錄/文檔讀寫/日程/會議 | wecom.py | CorpID+Secret+AgentId + 可信IP |
| B 本地讀取 | 解密匯出聊天記錄(會話/發送者/時間/正文) | decrypt/ | 企微登入 + adhoc 重簽(去除 hardened runtime) |
| C 即時接收+自主處理 | 收訊息→分析→自動回覆/寫文檔 | recv_server.py+agent_worker.py | A 的憑證 + 接收Token/AESKey + 公網URL |
配置見 README.md 與 docs/自建應用配置教程.md。憑證寫 config.json(已 gitignore)。
A 主動操作(官方 API)
python3 wecom.py <category> <method> '<json參數>' # 輸出JSON, errcode:0 成功
| category | method | 參數 | 作用 |
|---|---|---|---|
contact | departments | 無 | 部門列表(名稱+ID) |
contact | users | {"department_id":1} | 部門成員(userid+姓名) |
contact | get/search/list_id | {"userid"/"keyword":..} | 成員詳情/按名找人/成員ID列表 |
message | text/markdown/news | {"touser":"x","content":".."} | 發訊息(touser預設@all,多人` |
doc | create/get/edit/del/rename/sheet_get/sheet_edit | 透傳 body | 線上文檔/表格 讀寫+編輯(edit=batch_update) |
schedule/meeting | add/create/list.. | 透傳 body | 日程/會議 |
call | 逃生艙 | {"path":"/cgi-bin/..","body":{}} | 任意官方接口 |
寫操作(發訊息/刪日程/改文檔)執行前先向使用者確認內容。
B 本地讀取聊天記錄
依系統分流:macOS →
decrypt/macos/,Windows →decrypt/windows/;解密核心wxwork_crypto.py+ 解析export_wxwork.py在decrypt/根下兩端共用(同一套 wxSQLite3 AES,已兩端實證)。
macOS(已驗證)
前提:企業微信運行並登入 + 已對企微 adhoc 重簽(見 docs/解密思路.md、[[wechat_codesign_pitfall]])。
python3 decrypt/macos/read_wecom.py # ★一鍵: 掃key有效則跳過 → 解密 → 匯出
python3 decrypt/macos/find_key_fast.py # 單獨抓 key(活行程記憶體掃,唯讀不注入); 存 wxwork_keys.json
python3 decrypt/macos/decrypt_wxwork.py # 全庫解密 → decrypt/macos/decrypted/
python3 decrypt/macos/monitor.py --once # 增量(--poll N 持續監控)
解析已覆蓋:發送者真名(Session.db USER)、會話名、訊息類型——文字 / 圖片 / [語音] / [檔案]名 / [文件]標題+連結 / [卡片]標題+連結 / 系統 / 會議。
可選語音轉寫:voice_transcribe.py(本地快取 SILK→whisper,需 pilk+mlx-whisper,僅覆蓋已播放的)。
key 存盤後 ②③與 monitor 無需再掃記憶體。離線兜底 find_key_offline.py。方案見 docs/解密思路.md。產物私密、已 gitignore。
本地資料查詢/分析(解密後,全本地無網路):python3 decrypt/macos/wecom_local.py <子命令>
| 子命令 | 作用 |
|---|---|
contacts [詞] | 通訊錄 138 人(姓名/部門/職位/手機/郵箱),可按詞查 |
conversations | 會話列表(名稱/訊息數/最後時間) |
members <會話> | 群成員(依發言數) |
search <詞> | 全文搜尋訊息 |
stats | 統計畫像(發言排行/會話排行/類型/按小時/按天) |
todo / calendar | 本地待辦 / 日程 |
media [--out] | 匯出明文快取圖片+檔案(161圖+119檔案) |
openfile <名/詞> | 聊天裡找文件→定位本地本體→文字類解析內容(txt/csv/md/xlsx/docx/文字PDF,需 openpyxl/pdfplumber/python-docx);圖片型/掃描PDF輸出 🖼️VISUAL <路徑>→你接著用 Read 多模態直接看。內聯圖片(type29)無法依訊息定位,用 media 匯出後多模態瀏覽 |
語音轉寫:python3 decrypt/macos/voice_transcribe.py(快取 SILK→whisper large-v3,已驗證 6 條)。
MCP(可選薄門面,與 wechat 對齊)
邏輯核心是命令列 wecom_local.py(--json 拿結構化);server.py 的 MCP 工具只是逐個轉發到它,不含邏輯。不要 MCP 也行——直接跑 wecom_local.py <子命令>。
註冊:bash setup.sh(裝 mcp + claude mcp add wecom)→ 重啟 Claude Code。工具:wecom_contacts/conversations/members/search/stats/todo/calendar/media/openfile(參數同子命令)。前提:先 read_wecom.py 解密,decrypt/macos/decrypted/ 就位。
Windows(已驗證 · UTM Win11 ARM · 端到端 12/12)
前提:企業微信(WXWork)運行並登入 + 裝 Python + pip install pycryptodome(解密後端;cryptography 在 win-arm64 無 wheel)。openfile 文件解析另需 pip install openpyxl xlrd pypdf python-docx。無需重簽。
# ★一鍵: 掃key → 解密 → 跑子命令
powershell -ExecutionPolicy Bypass -File decrypt/windows/run.ps1 <子命令>
# 子命令(對齊 macOS wecom_local):
# read | contacts [詞] | conversations | members <會話> | search <詞> | stats
# todo | calendar | media [--out] | openfile <名> | voice | monitor
powershell -ExecutionPolicy Bypass -File decrypt/windows/run_test.ps1 # 端到端自測 12 項 → 報告
# 分步:
powershell -ExecutionPolicy Bypass -File decrypt/windows/find_key.ps1 # PS+內嵌C# 掃 WXWork.exe 記憶體(ReadProcessMemory)→ KEY=<hex>
python decrypt/windows/wecom_win.py <key> <子命令> # 複用根下 wxwork_crypto/export_wxwork/read_doc
名字解析:user.db(uid→名/手機/郵箱) + session.db(會話→名),1:1 取對方。庫在 Documents\WXWork\<id>\Data\,明文快取在 …\Cache\{File,Image,Voice}。content_type 標籤按 Windows 碼映射(覆蓋 export_wxwork 的渲染表)。voice 轉寫:x64 Windows 裝 faster-whisper+pilk 可用,ARM 版無 win_arm64 wheel/無 C++ 工具鏈 → 不可用(定位/匯出仍可)。
C 即時接收 + 自主處理
# 1. 按 docs/自建應用配置教程.md 配「接收訊息」(URL/Token/EncodingAESKey)
# 2. 公網暴露: cloudflared tunnel --url http://localhost:8000
python3 recv_server.py # 驗簽+AES解密+快速ACK+入隊 jobs/inbox.jsonl
python3 agent_worker.py # 讀佇列→決策→經wecom.py回覆/寫文檔
config.json 配 llm_base_url/llm_key/llm_model(OpenAI 相容) → LLM 自主決策;"auto_reply":false 僅記錄不發(人工把關)。
Agent 觸發規則
| 使用者說 | 調用 |
|---|---|
| "匯出/讀我的企微聊天" | B 線三步 |
| "發企微給X""通知X" | message text |
| "查通訊錄""找叫X的人" | contact users/search |
| "建/讀企微文檔" | doc create/get |
| "約會議""建日程" | meeting create/schedule add |
| "讓agent自動回覆企微" | C 線(recv_server + agent_worker) |
| 封裝沒有的接口 | call |
狀態
- B 本地讀取:✅ 已實跑驗證(5458 條結構化訊息)。
- A 主動操作:程式碼就緒、端點按官方文件校正;待真實憑證聯調(
gettoken已實測可達)。 - C 即時接收+自主處理:回呼加解密、決策閉環均自測通過;待憑證+公網URL聯調。
- 通訊錄讀取受企微隱私策略限制(需可見範圍+權限,否則
60011/60020)。