wecom-agent

企业微信全能 agent——本地解密读取聊天记录、自建应用API发消息/查通讯录/读写在线文档/日程会议、实时接收消息并自主处理(自动回复/写文档)。触发词：企业微信/企微/wecom，读消息/导出聊天记录、发消息/通知、查通讯录/找人、建文档/读文档/编辑文档、日程/会议、实时接收/自动回复。

tzwkb 4 3 Updated 1mo ago

Resources

GitHub

Install

npx skillscat add tzwkb/wecom-agent

Install via the SkillsCat registry.

SKILL.md

wecom-agent

本 skill 的主线是 本地解密读取 + WecomTeam 官方操作层。

线	默认方案	能力边界
B 本地读取	本仓库 `decrypt/`	历史聊天、离线全文搜索、会话/成员/统计、媒体导出、聊天文件定位。默认优先使用。
A 主动操作	WecomTeam `wecom-cli` / `wecom-unified`	发消息、查通讯录、文档/表格/智能表格、日程、会议、待办。
实时互动	WecomTeam Bot SDK（后续接入）	WebSocket 收消息、流式回复、主动推送、文件下载解密。

旧的自建应用 HTTP API 方案不再是主线；不要为普通 A 线任务要求用户配置 CorpID/Secret/AgentId、可信域名或可信 IP。

决策规则

用户需求	默认调用
读/导出/搜索历史聊天、统计会话、找本地聊天文件	B 本地读取
读任何聊天消息/历史/近期增量	B 本地读取
用户明确要求官方在线接口且本地读取不可用	可应急使用 `wecom-cli msg get_message`
发消息、通知某人/群	`wecom-cli msg ...`；若返回“当前企业暂不支持授权机器人「消息」使用权限”，说明该企业不可用
查人、找 userid	优先 B 本地通讯录；A 线可用时用 `wecom-cli contact ...`
读/建/改企业微信文档、表格、智能表格	`wecom-cli doc ...`；写操作先确认
查/建/改/取消日程	`wecom-cli schedule ...`；若企业不支持则说明权限边界
查/建/取消会议	`wecom-cli meeting ...`；若企业不支持则说明权限边界
查/建/更新/删除待办	`wecom-cli todo ...`；写操作先确认
自动回复/流式回复	Bot SDK；未接入前说明暂未落地

写操作执行前先向用户确认对象、内容和影响范围。

A 主动操作（WecomTeam CLI）

首次使用先检查并初始化：

wecom-cli --version || npm install -g @wecom/cli
wecom-cli auth show --auth-status
wecom-cli init

通用格式：

wecom-cli <category> <method> '<json参数>'

常用入口：

category	例子
`doc`	`wecom-cli doc create_doc --json '{"doc_name":"标题","doc_type":3}'`
`doc`	`wecom-cli doc edit_doc_content --json '{"docid":"DOCID","content_type":1,"content":"# 标题\\n正文"}'`
`todo`	`wecom-cli todo search_todo_userid --json '{"keyword":"姓名"}'`
`todo`	`wecom-cli todo get_todo_list --json '{"follower_id":"USERID"}'`
`contact` / `msg` / `schedule` / `meeting`	当前企业实测返回“不支持授权机器人对应权限”；遇到该错误时不要继续重试，直接说明权限边界

遇到具体参数不确定时，优先查 wecom-cli <category> --help 或 WecomTeam wecom-unified references。

B 本地读取聊天记录

按系统分流：macOS → decrypt/macos/，Windows → decrypt/windows/。解密核心 decrypt/wxwork_crypto.py 与解析 decrypt/export_wxwork.py 两端共用。

macOS

前提：企业微信运行并登录；首次抓 key 需要已对企微 adhoc 重签，见 docs/解密思路.md。

PY=${WECOM_PYTHON:-/opt/homebrew/bin/python3}
$PY decrypt/macos/read_wecom.py
$PY decrypt/macos/find_key_fast.py
$PY decrypt/macos/decrypt_wxwork.py
$PY decrypt/macos/monitor.py --once

本地查询：

$PY decrypt/macos/wecom_local.py <contacts|conversations|members|search|stats|todo|calendar|media|openfile>

子命令	作用
`contacts [词]`	本地通讯录搜索
`conversations`	会话列表
`members <会话>`	群成员与发言数
`search <词>`	全文搜索消息
`stats`	发言/会话/类型/时间统计
`todo` / `calendar`	本地待办 / 日程
`media [--out]`	导出明文缓存图片和文件
`openfile <名/词>`	从聊天记录定位并解析本地文件

可选语音转写：

$PY decrypt/macos/voice_transcribe.py

Windows

前提：企业微信运行并登录，安装 Python 与 pycryptodome。

powershell -ExecutionPolicy Bypass -File decrypt/windows/run.ps1 <子命令>
powershell -ExecutionPolicy Bypass -File decrypt/windows/run_test.ps1
powershell -ExecutionPolicy Bypass -File decrypt/windows/find_key.ps1
python decrypt/windows/wecom_win.py <key> <子命令>

MCP（可选）

本地读取 MCP 只是 wecom_local.py --json 的薄门面。不要为了本地查询强制走 MCP；直接跑 CLI 更透明。

bash setup.sh

工具：wecom_contacts/conversations/members/search/stats/todo/calendar/media/openfile。

状态

B 本地读取：已实跑验证，覆盖本地历史聊天、会话、发送者、文本/图片/语音/文件/文档/卡片等解析。
A 主动操作：改为复用 WecomTeam wecom-cli/wecom-unified。当前企业实测授权成功；todo search_todo_userid/get_todo_list 可用；doc 命令可加载但写入需确认后测试；contact/msg/schedule/meeting 返回企业不支持授权机器人权限。
实时互动：后续接 WecomTeam Bot SDK；旧回调实验代码在 legacy/self-built-app/。

wecom-agent

Resources

Install

wecom-agent

决策规则

A 主动操作（WecomTeam CLI）

B 本地读取聊天记录

macOS

Windows

MCP（可选）

状态

Categories

Install

Recommended Skills