Communitygithub.com

tzwkb/wecom-agent

Agent Skill — 企业微信自建应用 API 操作(消息、通讯录、日历、文档)及 macOS 聊天解密。

wecom-agent란 무엇인가요?

이 스킬은 에이전트(Claude Code, Cursor 등)가 기업 위챗(WeCom) 셀프-빌드 앱과 상호작용할 수 있도록 설계된 포괄적인 도구 모음입니다. 세 가지 주요 기능 라인을 제공합니다: A) 공식 API를 통한 능동적 작업(메시지 전송, 연락처 읽기, 문서 편집, 일정 및 회의 관리), B) 로컬 macOS/Windows에서의 채팅 기록 복호화(메시지 발신자, 세션 이름, 메시지 유형-텍스트/이미지/파일 등 추출), C) 메시지 수신, LLM 기반 분석 및 자동 응답을 포함한 실시간 웹훅 처리입니다. 이 스킬은 API 자격 증명(CorpID, Secret, AgentId)과 수동 adhoc 재서명이 필요한 복호화 모듈이 있는 macOS를 포함한 여러 플랫폼을 지원합니다. 채팅 기록 복호화는 메모리 스캔을 사용하여 미사용 키를 가져오므로 사전 서명된 애플리케이션 이진 파일이 필요합니다. Windows 지원은 유사한 워크플로우에 대해 PowerShell 기반 스크립트를 통해 제공됩니다. LLM 기반 워커는 OpenAI 호환 API를 사용하여 메시지에 자율적으로 응답하거나 기록 전용으로 모드할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add tzwkb/wecom-agent

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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)。

관련 스킬