Communitygithub.com

tzwkb/wecom-agent

Agent 技能 — 企业微信自建应用 API 操作(訊息、通訊錄、日曆、文檔)以及 macOS 聊天記錄解密。

wecom-agent 是什麼?

這是一個專門為 AI Agent 設計的企業微信(WeCom)全能技能,讓 AI 助手能夠直接操作企業微信的各項核心功能。該技能涵蓋三條主要操作線路:A 線為官方 API 主動操作,包括發送訊息、管理通訊錄與部門、讀寫線上文檔與表格、建立日程與會議等;B 線為本地聊天記錄解密,支援 macOS 與 Windows 平台,可匯出所有聊天訊息(文字、圖片、語音、檔案、卡片等),並提供本地查詢與分析工具(如搜尋、統計、匯出媒體檔案);C 線為即時接收與自主處理,讓 Agent 能接收企業微信訊息、進行 LLM 決策分析後自動回覆或建立文檔。所有操作皆透過 CLI 命令執行,無需 MCP 框架亦可使用。此技能特別適合需要企業微信深度整合的開發者與團隊,支援 Claude Code 等 Agent 平台,可大幅提升工作效率與自動化程度。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add tzwkb/wecom-agent

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

wecom-agent — 企業微信全能 agent

線能力入口依賴
A 主動操作發訊息/通訊錄/文檔讀寫/日程/會議wecom.pyCorpID+Secret+AgentId + 可信IP
B 本地讀取解密匯出聊天記錄(會話/發送者/時間/正文)decrypt/企微登入 + adhoc 重簽(去除 hardened runtime)
C 即時接收+自主處理收訊息→分析→自動回覆/寫文檔recv_server.py+agent_worker.pyA 的憑證 + 接收Token/AESKey + 公網URL

配置見 README.md 與 docs/自建應用配置教程.md。憑證寫 config.json(已 gitignore)。

A 主動操作(官方 API)

python3 wecom.py <category> <method> '<json參數>'   # 輸出JSON, errcode:0 成功
categorymethod參數作用
contactdepartments無部門列表(名稱+ID)
contactusers{"department_id":1}部門成員(userid+姓名)
contactget/search/list_id{"userid"/"keyword":..}成員詳情/按名找人/成員ID列表
messagetext/markdown/news{"touser":"x","content":".."}發訊息(touser預設@all,多人`
doccreate/get/edit/del/rename/sheet_get/sheet_edit透傳 body線上文檔/表格 讀寫+編輯(edit=batch_update)
schedule/meetingadd/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)。

相關技能