微信聊天记录skill
查询、分析和导出微信聊天数据,提供 AI 驱动的智能洞察和精美的可视化页面。
⚠️ 重要提示
- 本 Skill 依赖 Wetrace 服务
- 仅支持 Windows 平台(微信数据库位于 Windows 系统)
- 需要先安装并运行 Wetrace 服务才能使用本 Skill
http://127.0.0.1:5200将用户请求分类为以下类别:
从用户请求中识别关键参数:
本 Skill 提供了 Python 脚本工具来调用 Wetrace API,比直接使用 WebFetch 更方便。
使用 wetrace_api.py 脚本,位于 scripts/wetrace_api.py:
# 查询会话
python scripts/wetrace_api.py sessions --keyword "张三" --limit 20
# 获取消息
python scripts/wetrace_api.py messages --talker wxid_abc123 --limit 50
# 搜索关键词
python scripts/wetrace_api.py search --keyword "项目" --limit 30
# 分析数据
python scripts/wetrace_api.py analysis hourly wxid_abc123
python scripts/wetrace_api.py analysis daily wxid_abc123
# 导出聊天记录
python scripts/wetrace_api.py export chat --talker wxid_abc123 --format html
完整脚本文档:查看 scripts/README.md
基础 URL:http://127.0.0.1:5200/api/v1
完整 API 文档:参考 references/api.md
GET /sessions?keyword={名称}&limit=50
GET /messages?talker_id={id}&time_range={范围}&limit=100
GET /search?keyword={关键词}&time_range={范围}&limit=50
GET /analysis/hourly/{session_id}
GET /analysis/daily/{session_id}
GET /export/chat?talker={id}&format={格式}&time_range={范围}
以清晰、结构化的格式呈现数据。
调用导出 API,告知用户下载信息。
Wetrace 提供 8 个核心可视化功能,每个功能都会:
~/wetrace-exports/ 并提供访问链接当用户请求生成可视化页面时,根据触发关键词选择对应的功能:
智能摘要生成 - 触发词:总结聊天记录、生成摘要、智能总结
待办事项提取 - 触发词:提取待办、找出任务、待办事项
聊天活跃度热力图 - 触发词:活跃度热力图、聊天时间分布
互动趋势分析 - 触发词:趋势分析、互动趋势
智能周报月报 - 触发词:生成周报、生成月报
数据仪表板 - 触发词:生成仪表板、数据总览
智能对话摘要 - 触发词:对话摘要、智能总结、分类摘要
客户关系健康度 - 触发词:客户健康度、CRM 仪表板
所有生成的 HTML 页面都遵循统一的设计系统,详见 references/design-system.md,包括:
所有生成的 HTML 页面:
当用户请求生成网页时:
~/wetrace-exports/ 目录支持多种格式:
转换为 API 格式:YYYY-MM-DD~YYYY-MM-DD
对于大数据集:
limit=50 开始~/wetrace-exports/ 目录file:// 协议的完整路径脚本位置:scripts/wetrace_api.py
cd scripts
pip install -r requirements.txt
# 查看帮助
python wetrace_api.py --help
# 查询会话
python wetrace_api.py sessions --keyword "张三" --limit 20
# 获取消息(需要会话ID)
python wetrace_api.py messages --talker wxid_abc123 --limit 50
# 按时间范围查询
python wetrace_api.py messages --talker wxid_abc123 --time-range "2024-01-01~2024-01-31"
# 全文搜索
python wetrace_api.py search --keyword "项目" --limit 30
# 数据分析
python wetrace_api.py analysis hourly wxid_abc123
python wetrace_api.py analysis daily wxid_abc123
python wetrace_api.py analysis type wxid_abc123
# 获取总览
python wetrace_api.py dashboard
# 导出聊天记录
python wetrace_api.py export chat --talker wxid_abc123 --format html
from scripts.wetrace_api import WetraceAPI
# 创建API客户端
api = WetraceAPI()
# 查询会话
sessions = api.get_sessions(keyword="张三", limit=10)
for session in sessions:
print(f"{session['NickName']}: {session['MessageCount']} 条消息")
# 获取消息
messages = api.get_messages(talker_id="wxid_abc123", limit=50)
for msg in messages:
print(f"[{msg['CreateTime']}] {msg['Content']}")
# 搜索
result = api.search(keyword="项目", limit=20)
print(f"找到 {result['Total']} 条相关消息")
完整文档:查看 scripts/README.md