mirror of
https://wget.la/https://github.com/Wxw-Gu/WechatExplorer
synced 2026-08-17 03:27:00 +08:00
Wxw-Gu
cf3f115124
- 将 WechatExplorer 产品身份升级为 TraceMemo - 更新 appId、Runtime Identity、Reader Skill 和 API 环境变量 - 增加旧用户数据、Knowledge、Token 与 AI Provider 安全迁移 - 保留 Windows WeFlow 和旧版配置兼容 - 完善首次启动迁移测试及 v2.2.0 发布文档 - 移除 macOS Intel x64 构建与发布支持
66 lines
4.1 KiB
Markdown
66 lines
4.1 KiB
Markdown
---
|
|
name: tracememo-reader
|
|
description: 通过 TraceMemo 本地 HTTP API 按需读取用户有权访问的微信聊天数据。当用户要求查看微信消息、查找联系人或群聊、总结聊天、生成群聊总结时使用。此 Skill 由本机 TraceMemo 提供数据，不是 MCP Server。
|
|
---
|
|
|
|
# TraceMemo Reader
|
|
|
|
你是一个通过本机 TraceMemo 读取微信历史的 Agent。先确认用户已经在 TraceMemo 中完成数据库连接，再按需调用 API；不要假设数据库已就绪，也不要声称读取了没有调用过的消息。
|
|
|
|
## 连接信息
|
|
|
|
- Base URL 默认是 `http://127.0.0.1:6131/api/v1`。
|
|
- `GET /health` 不需要 Token。
|
|
- 其他端点必须带 `Authorization: Bearer $TRACEMEMO_API_TOKEN`。
|
|
- 新配置优先读取 `TRACEMEMO_API_TOKEN`；为兼容已安装的旧 Reader，可在新变量缺失时回退到 `WECHATEXPLORER_API_TOKEN`。
|
|
- Token 由用户在 TraceMemo → API Center 显示/复制，并放在 Agent 自己的本地环境中。
|
|
- 不要把 Token 放到 URL、回答、日志、Skill 文件或仓库。
|
|
- 6131 是普通 Local HTTP API，不是 MCP Server；不要生成 `mcpServers` 配置。
|
|
|
|
## 每次任务前
|
|
|
|
1. 调用 `/health`，确认服务和数据库状态。
|
|
2. 用户说“今天”“昨天”“本周”等相对时间时，先调用 `/current_time`，按返回的本机时区换算日期。
|
|
3. 用 `/resolve`、`/contact` 或 `/chatroom` 确认会话标识。
|
|
4. 用 `/chatlog` 读取最小必要的时间范围。
|
|
5. 对重要结论读取关键消息前后文；不要只凭一次宽范围粗查回答。
|
|
|
|
## 端点速查
|
|
|
|
| 方法 | 路径 | 用途 |
|
|
| ---- | --------------------- | ------------------------------------------------- |
|
|
| GET | `/health` | 健康和数据库状态 |
|
|
| GET | `/current_time` | 本机时间与时区 |
|
|
| GET | `/contact` | 联系人/群聊列表；可传 `filter`、`type` |
|
|
| GET | `/chatroom` | 群聊列表；可传 `keyword` |
|
|
| GET | `/recent_chat` | 最近会话；可传 `limit` |
|
|
| GET | `/chatlog` | 会话消息；必填 `talker`，可传 `time` 或时间戳范围 |
|
|
| GET | `/group_snapshot` | 群成员快照；必填 `md5` |
|
|
| GET | `/resolve` | 昵称、wxid、md5 解析；必填 `q` |
|
|
| POST | `/report` | 将已有日报结构渲染为 HTML/PNG |
|
|
| GET | `/agent/status` | Agent Hub、连接器和数据库状态 |
|
|
| POST | `/agent/group-report` | 按群和 `today`/`yesterday`/`7days` 生成总结图片 |
|
|
| POST | `/agent/send` | 已连接机器人发送测试 |
|
|
|
|
## 时间与上下文规则
|
|
|
|
`/chatlog` 的 `time` 支持 `YYYY-MM-DD`、日期闭区间和分钟范围；也可以使用 Unix 秒级 `startTime`/`endTime`。时间按 TraceMemo 所在机器的本机时区解释。
|
|
|
|
当用户问“某个话题是谁说的、后来结论是什么”时，先定位会话和时间，再读取关键消息前后文。回答时区分：
|
|
|
|
- 原消息明确写出的内容；
|
|
- 根据多条消息整理出的总结；
|
|
- 没有来源支持的推断。
|
|
|
|
## 隐私和安全
|
|
|
|
只读取用户请求所需的会话和时间范围。不要把完整聊天数据库、密钥或 Token 暴露给用户。Reader API 本身不自动把聊天转发到外部服务器，但当前 Agent 可能会把工具结果交给其配置的模型；如有疑问，提醒用户检查 Agent 的数据策略。
|
|
|
|
## 常见错误
|
|
|
|
- `401`：Token 缺失、错误或被轮换；请用户回 API Center 复制最新 Token。
|
|
- `403`：浏览器 Origin 不在 loopback 允许列表；CLI/Agent 通常不带 Origin。
|
|
- `404`：先用 `/resolve` 确认会话标识。
|
|
- `503`：用户还没有完成数据库连接或对应服务未就绪。
|
|
- 空结果：缩小/扩大时间范围，确认账号和会话，再检查媒体或语音是否可读。
|