feat: 完成 TraceMemo v2.2.0 品牌升级并保留旧数据兼容

- 将用户可见品牌升级为 TraceMemo（迹忆） - 增加最早期 userData/sessionData 兼容路径选择 - 保留 WechatExplorer runtime identity 以兼容 safeStorage - 继续使用旧 Knowledge、Settings、API Token 和 Provider 配置 - 新日志写入 TraceMemo 目录并保留历史日志 - 保留旧 API、Skill、环境变量和导出目录兼容标识 - 更新相关文档、界面文案与自动化测试
2026-08-17 19:47:08 +08:00 · 2026-08-11 14:42:12 +08:00
parent 2354fd0766
commit 55c6fb8cd3
86 changed files with 481 additions and 459 deletions
@@ -1,6 +1,6 @@
-# 在微信里向 WechatExplorer 提问（Agent Hub）
+# 在微信里向 TraceMemo 提问（Agent Hub）

-Agent Hub 是 WechatExplorer 内置的微信机器人入口，也是应用一级导航中的“Agent”页面。你先扫码登录一个微信机器人账号，再用微信账号向机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发送者。
+Agent Hub 是 TraceMemo 内置的微信机器人入口，也是应用一级导航中的“Agent”页面。你先扫码登录一个微信机器人账号，再用微信账号向机器人发送文字；本机 Agent Hub 会接收消息、读取已经连接的微信数据，必要时调用已配置的 AI，再把结果回复给发送者。

 普通用户不需要安装 Reader Skill，也不需要配置 API Token。先连接微信数据库，再扫码登录机器人即可开始；需要总结或自然语言理解的任务还要配置 AI Provider。

@@ -11,7 +11,7 @@ Agent Hub 是 WechatExplorer 内置的微信机器人入口，也是应用一级

 ## 连接器和 Agent Hub 是什么关系

-你不需要单独部署这些组件。扫码后，后台的微信连接器负责登录机器人、保持连接、接收微信消息和发送回复；Agent Hub 负责判断消息要做什么、查询 WechatExplorer 本地数据、调用 AI 并组织结果。可以把它理解为：连接器负责“和微信通信”，Hub 负责“处理任务”。
+你不需要单独部署这些组件。扫码后，后台的微信连接器负责登录机器人、保持连接、接收微信消息和发送回复；Agent Hub 负责判断消息要做什么、查询 TraceMemo 本地数据、调用 AI 并组织结果。可以把它理解为：连接器负责“和微信通信”，Hub 负责“处理任务”。

 ## 你能做什么

@@ -50,9 +50,9 @@ Agent Hub 页面会记录系统、Agent Hub 和微信连接器日志。日志支

 ## 需要满足的条件

- WechatExplorer 的微信数据库已经连接，并且数据 API 可以查询；
+- TraceMemo 的微信数据库已经连接，并且数据 API 可以查询；
 - 依赖总结或自然语言理解的任务，需要在“设置 → AI 模型”配置可用的 AI 服务；
- WechatExplorer 和 Agent Hub 需要保持运行，机器人才能接收和回复消息。
+- TraceMemo 和 Agent Hub 需要保持运行，机器人才能接收和回复消息。

 ## 安全与边界

@@ -2,10 +2,12 @@

 ## 当前安全边界

-WechatExplorer 的本地 API 默认监听 `127.0.0.1:6131`。它面向同一台电脑上的 API Center、Reader Skill、CLI 和 Agent，不是公网网关，也不是带用户账户和细粒度权限 Scope 的服务。
+TraceMemo 的本地 API 默认监听 `127.0.0.1:6131`。它面向同一台电脑上的 API Center、Reader Skill、CLI 和 Agent，不是公网网关，也不是带用户账户和细粒度权限 Scope 的服务。

 ## Bearer Token

+文档中的 `WECHATEXPLORER_API_TOKEN` 是历史兼容环境变量名；TraceMemo v2.2.0 继续支持这一名称，以免已安装的 Reader Skill 和 Agent 配置失效。
+
 - `/api/v1/health` 是公开健康检查；
 - 其他所有端点都要求 `Authorization: Bearer <TOKEN>`；
 - Token 由应用生成，使用 32 个随机字节编码；
@@ -1,4 +1,4 @@
-# WechatExplorer Local HTTP API
+# TraceMemo Local HTTP API

 本文面向需要自己写集成的开发者。普通用户请先阅读[Agent 接入概览](./overview.md)。

@@ -24,6 +24,8 @@ curl -H "Authorization: Bearer $WECHATEXPLORER_API_TOKEN" \

 不要把 Token 放入 URL、Skill 文件、仓库或命令历史可被共享的脚本中。

+`WECHATEXPLORER_API_TOKEN` 是历史兼容环境变量名，TraceMemo v2.2.0 继续沿用它以保持 Reader Skill 和外部 Agent 兼容。
+
 ## 端点

 | 方法 | 路径 | 作用 | 参数/请求体 |
@@ -57,7 +59,7 @@ curl -H "Authorization: Bearer $WECHATEXPLORER_API_TOKEN" \
 - `YYYY-MM-DD/HH:mm`：从该分钟开始的 60 秒；
 - 也可以使用 Unix 秒级 `startTime` 和 `endTime`。

-时间按运行 WechatExplorer 的本机时区解析。用户说“今天”“昨天”时，先调用 `current_time`，再根据返回的 `localDate` 计算日期，避免使用 Agent 自己的时区。
+时间按运行 TraceMemo 的本机时区解析。用户说“今天”“昨天”时，先调用 `current_time`，再根据返回的 `localDate` 计算日期，避免使用 Agent 自己的时区。

 ## 常用工作流

@@ -1,6 +1,6 @@
-# 在微信机器人或外部 Agent 中使用 WechatExplorer
+# 在微信机器人或外部 Agent 中使用 TraceMemo

-WechatExplorer 提供两条不同路径。先按你实际想做的事选择，不需要先理解 Agent、Skill 或 API 等术语。
+TraceMemo 提供两条不同路径。先按你实际想做的事选择，不需要先理解 Agent、Skill 或 API 等术语。

 | 你想做什么                                           | 使用方式                      | 需要什么                                                  |
 | ---------------------------------------------------- | ----------------------------- | --------------------------------------------------------- |
@@ -9,7 +9,7 @@ WechatExplorer 提供两条不同路径。先按你实际想做的事选择，

 ## 直接在微信里提问

-打开应用一级导航中的“Agent”，进入“Agent Hub”，扫码登录一个微信机器人账号。之后用另一个微信账号向机器人发送文字，它会调用 WechatExplorer 的本机数据，必要时使用已配置的 AI，再把结果回复给发送者。
+打开应用一级导航中的“Agent”，进入“Agent Hub”，扫码登录一个微信机器人账号。之后用另一个微信账号向机器人发送文字，它会调用 TraceMemo 的本机数据，必要时使用已配置的 AI，再把结果回复给发送者。

 可以先尝试：

@@ -23,7 +23,7 @@ WechatExplorer 提供两条不同路径。先按你实际想做的事选择，

 ## 在外部 Agent 中查询历史微信

-Reader Skill 是给外部 Agent 的操作说明。安装后，Codex、Claude Code、OpenClaw 或其他本地 Agent 可以通过 WechatExplorer Local HTTP API 按需读取联系人、群聊、最近会话、指定时间范围的聊天和群成员信息。
+Reader Skill 是给外部 Agent 的操作说明。安装后，Codex、Claude Code、OpenClaw 或其他本地 Agent 可以通过 TraceMemo Local HTTP API 按需读取联系人、群聊、最近会话、指定时间范围的聊天和群成员信息。

 典型问题包括：

@@ -35,7 +35,7 @@ Reader Skill 是给外部 Agent 的操作说明。安装后，Codex、Claude Cod

 ## 外部 Agent 的安装步骤

-1. 启动 WechatExplorer 并完成微信数据库连接。
+1. 启动 TraceMemo 并完成微信数据库连接。
 2. 打开一级导航“API”（页面为“API Center”），确认本地 API、数据库和 Reader Skill 都可用。
 3. 选择目标 Agent，点击“复制安装指令”。
 4. 在 Agent 自己的 Skill/配置目录执行或粘贴指令。
@@ -2,15 +2,17 @@

 ## 先理解它能做什么

-Reader Skill 是一份给 Agent 的操作说明。安装后，Codex、Claude Code、OpenClaw 或其他本地 Agent 可以按需调用 WechatExplorer，读取联系人、群聊、最近会话、指定时间的聊天和群成员信息。
+Reader Skill 是一份给 Agent 的操作说明。安装后，Codex、Claude Code、OpenClaw 或其他本地 Agent 可以按需调用 TraceMemo，读取联系人、群聊、最近会话、指定时间的聊天和群成员信息。

-它使用的是 WechatExplorer Local HTTP API，不是 MCP Server。
+它使用的是 TraceMemo Local HTTP API，不是 MCP Server。

 Reader Skill 只负责“外部 Agent 主动查询历史微信数据”。它不负责二维码登录、监听微信实时消息、接收机器人消息或管理 Agent Hub。想让机器人收到微信消息后处理并回复，请阅读[Agent Hub](./agent-hub.md)。

+Reader Skill 的展示名称已迁移为 TraceMemo Reader；安装目录和 `WECHATEXPLORER_API_TOKEN` 环境变量仍保留历史兼容标识，以便旧 Agent 配置继续工作。
+
 ## 推荐安装流程

-1. 启动 WechatExplorer 并完成数据库连接。
+1. 启动 TraceMemo 并完成数据库连接。
 2. 打开“API Center”，确认 API 服务和数据库状态正常。
 3. 在 Reader Skill 区域选择目标 Agent，点击“复制安装指令”。
 4. 把指令粘贴到对应 Agent 的 Skill/配置目录；应用会根据本机路径生成适合 Codex、Claude Code、OpenClaw 或通用 Agent 的说明。
@@ -22,7 +24,7 @@ Reader Skill 只负责“外部 Agent 主动查询历史微信数据”。它不

 6. 先执行 health 检查，再读取数据端点。

-WechatExplorer 不会自动把 Token 写进 Agent 配置。重新生成 Token 后，必须同步更新 Agent 环境。
+TraceMemo 不会自动把 Token 写进 Agent 配置。重新生成 Token 后，必须同步更新 Agent 环境。

 ## Agent 的读取顺序

@@ -1,4 +1,4 @@
-# WechatExplorer 2.1.9：Local HTTP API 鉴权迁移
+# TraceMemo 2.1.9：Local HTTP API 鉴权迁移

 2.1.9 为 Local HTTP API 增加 Bearer Token 鉴权。这是一次有意的兼容性变化：除健康检查外，数据接口不再接受裸请求。

@@ -6,7 +6,7 @@
 - 2.1.9 中，相同请求必须携带 `Authorization: Bearer <TOKEN>`，否则返回 `401`；
 - `GET /api/v1/health` 保持公开；
 - 升级后应用会生成并安全保存 Token，原有 API 启用状态、监听地址和端口设置保持不变；
- Token 可在 WechatExplorer → API Center 中显示、复制和重新生成；
+- Token 可在 TraceMemo → API Center 中显示、复制和重新生成；
 - Reader Skill、Codex、Claude Code、OpenClaw 和其他本地 Agent 需要在自己的环境中设置 `WECHATEXPLORER_API_TOKEN`。

 如果旧 Agent 无法访问，请先从 API Center 复制当前 Token，再确认每个非 health 请求都带有 Bearer header。完整规则见[API 安全](./api-security.md)。