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

- 将用户可见品牌升级为 TraceMemo（迹忆） - 增加最早期 userData/sessionData 兼容路径选择 - 保留 WechatExplorer runtime identity 以兼容 safeStorage - 继续使用旧 Knowledge、Settings、API Token 和 Provider 配置 - 新日志写入 TraceMemo 目录并保留历史日志 - 保留旧 API、Skill、环境变量和导出目录兼容标识 - 更新相关文档、界面文案与自动化测试
2026-08-17 03:27:00 +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
+# 第一次使用 TraceMemo

-如果你刚下载 WechatExplorer，只需要完成一条主线：
+如果你刚下载 TraceMemo，只需要完成一条主线：

 > 安装应用 → 连接微信数据 → 确认聊天已加载 → 搜索或提问。

@@ -14,7 +14,7 @@
 | Windows | [微信 Windows `4.1.9.57`](https://github.com/iibob/wechat-win-archive/releases#release-v4.1.9.57) | 首次使用时请确认微信数据目录；Windows 不需要关闭 SIP                           |

 - 上表是当前实际测试过的客户端版本，不代表只有这些版本可以使用。其他微信 4.x 版本可能可以连接，但尚未逐一验证。
- WechatExplorer 必须取得当前微信账号对应的数据库密钥，才能读取聊天记录。
+- TraceMemo 必须取得当前微信账号对应的数据库密钥，才能读取聊天记录。
 - 你需要有权访问要读取的微信账号和聊天数据。
 - 如果要使用 AI 问答、群聊日报或图片理解，还需要在应用中配置一个 AI 服务。

@@ -26,23 +26,23 @@

 ### Windows

-1. 从 Releases 下载 Windows x64 的 `WechatExplorer-<版本号>-setup.exe` 安装包。
+1. 从 Releases 下载 Windows x64 的 `TraceMemo-<版本号>-setup.exe` 安装包。
 2. 双击安装包，按向导完成安装。
-3. 启动 WechatExplorer。
-4. 如果安装完成后软件无法启动，请安装 Microsoft Visual C++ x64 运行库：[vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe)，安装完成后重新启动 WechatExplorer。
+3. 启动 TraceMemo。
+4. 如果安装完成后软件无法启动，请安装 Microsoft Visual C++ x64 运行库：[vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe)，安装完成后重新启动 TraceMemo。

 ### macOS

 1. 根据处理器下载对应的 `.dmg`：Apple Silicon（M 系列）选择 `arm64`，Intel Mac 选择 `x64`。
-2. 打开 DMG，将 WechatExplorer 拖入“应用程序”文件夹。
+2. 打开 DMG，将 TraceMemo 拖入“应用程序”文件夹。
 3. 如果系统提示“无法打开，因为开发者无法验证”，前往“系统设置 → 隐私与安全性”，点击“仍要打开”。
 4. 如果系统提示应用已损坏，可在终端执行：

   ```bash
-   xattr -cr "/Applications/WechatExplorer.app"
+   xattr -cr "/Applications/TraceMemo.app"
   ```

-5. 启动 WechatExplorer。首次自动获取数据库密钥时，按连接页面显示的授权要求操作；只有页面明确提示时才按[关闭 SIP 教程](../mac-disable-sip.md)处理。关闭 SIP 会降低系统安全性，完成密钥配置后应重新开启。
+5. 启动 TraceMemo。首次自动获取数据库密钥时，按连接页面显示的授权要求操作；只有页面明确提示时才按[关闭 SIP 教程](../mac-disable-sip.md)处理。关闭 SIP 会降低系统安全性，完成密钥配置后应重新开启。

 更完整的权限和安全边界见 [macOS 数据访问说明](../platform/macos.md)。

@@ -107,12 +107,12 @@
 - [转写微信语音](./voice.md)
 - [导出聊天档案](./export.md)
 - [可选开启防撤回](./recall-protection.md)
- [在微信里向 WechatExplorer 提问](../agent/agent-hub.md)
+- [在微信里向 TraceMemo 提问](../agent/agent-hub.md)
 - [让外部 Agent 查询微信历史](../agent/overview.md)

 ## 7. 想直接在微信里提问

-如果你希望直接在微信里向 WechatExplorer 提问，而不是另外配置 Codex 等外部 Agent，请使用 Agent Hub：
+如果你希望直接在微信里向 TraceMemo 提问，而不是另外配置 Codex 等外部 Agent，请使用 Agent Hub：

 1. 先完成上面的微信数据库连接，并确认“档案”里能看到聊天。
 2. 打开应用主导航中的“Agent”；页面标题为“Agent Hub”。
@@ -4,7 +4,7 @@

 如果你经常查同一批工作群、项目讨论或长期联系人，只靠每次临时翻聊天会越来越慢。Knowledge 会在本机建立一份可重复查找的索引，让“以前聊过什么”这类问题更容易跨会话、跨时间找到相关内容。

-它不是另一个聊天窗口，也不会替你修改微信原始数据库；它是 WechatExplorer 为当前账号维护的本地加速资料。
+它不是另一个聊天窗口，也不会替你修改微信原始数据库；它是 TraceMemo 为当前账号维护的本地加速资料。

 ## 建立和同步

@@ -34,5 +34,5 @@ Knowledge 不会在第一次连接后自动悄悄建立。进入“问问微信

 ## 产品术语（可选）

-源码和日志中可能出现 SQLite、FTS、Chunk、索引等词。它们描述的是本地存储和检索实现，不是你开始使用 WechatExplorer 的前置知识。
+源码和日志中可能出现 SQLite、FTS、Chunk、索引等词。它们描述的是本地存储和检索实现，不是你开始使用 TraceMemo 的前置知识。

@@ -1,6 +1,6 @@
 # 数据、隐私与安全

-WechatExplorer 的核心路径是本地优先，但“本地优先”不等于所有功能都完全离线。是否有数据离开电脑，取决于你是否启用了对应的 AI、Agent 或机器人能力。
+TraceMemo 的核心路径是本地优先，但“本地优先”不等于所有功能都完全离线。是否有数据离开电脑，取决于你是否启用了对应的 AI、Agent 或机器人能力。

 ## 默认留在本机的内容

@@ -12,9 +12,9 @@ WechatExplorer 的核心路径是本地优先，但“本地优先”不等于
 - 离线语音转写；
 - 导出文件生成和本地日报历史。

-应用不会因为你打开 WechatExplorer 就自动把整份微信数据库上传。
+应用不会因为你打开 TraceMemo 就自动把整份微信数据库上传。

-防撤回默认关闭，并且和上面的普通读取路径不同。用户第一次明确开启时，当前实现会在微信消息数据库中安装本地撤回日志/监听结构，同时在 WechatExplorer 用户数据目录保存必要的恢复记录。关闭开关不等于移除已经安装的结构或清空既有记录；当前 UI 没有对应的清理入口。详见[防撤回](./recall-protection.md)。
+防撤回默认关闭，并且和上面的普通读取路径不同。用户第一次明确开启时，当前实现会在微信消息数据库中安装本地撤回日志/监听结构，同时在 TraceMemo 用户数据目录保存必要的恢复记录。为兼容旧版本，磁盘上的用户数据目录可能仍沿用历史名称 `WechatExplorer`。关闭开关不等于移除已经安装的结构或清空既有记录；当前 UI 没有对应的清理入口。详见[防撤回](./recall-protection.md)。

 ## 什么时候会请求外部服务

@@ -24,7 +24,7 @@ WechatExplorer 的核心路径是本地优先，但“本地优先”不等于
 - 受控检索所需的有限上下文；
 - 最终用于总结的 Evidence。

-不会发送完整微信数据库、全量聊天记录、未选中的聊天范围、数据库密钥、内部索引结构或内部会话/消息引用 ID。Provider 的日志、保留、计费和跨境规则不由 WechatExplorer 控制，请查看你所选服务商的政策。
+不会发送完整微信数据库、全量聊天记录、未选中的聊天范围、数据库密钥、内部索引结构或内部会话/消息引用 ID。Provider 的日志、保留、计费和跨境规则不由 TraceMemo 控制，请查看你所选服务商的政策。

 Ollama 等本机 Provider 可以把模型请求留在本机，但本机服务的日志和配置仍由你负责。

@@ -47,7 +47,7 @@ Token 由应用生成，使用 Electron `safeStorage` 加密保存在本机 `loc

 外部 Agent 通过 Reader Skill 调用本机 API，按需读取联系人、会话或时间范围内的聊天；它不会因此获得数据库文件路径或任意文件系统权限。Agent 是否把读取结果再次发送给模型，取决于 Agent 本身及其配置。

-应用内 Agent Hub 是另一条路径：微信机器人通过本机 Hub 调用 WechatExplorer，并且可能使用已配置的 AI 来理解问题。请把机器人账号、发送权限和日志视为独立的安全边界。
+应用内 Agent Hub 是另一条路径：微信机器人通过本机 Hub 调用 TraceMemo，并且可能使用已配置的 AI 来理解问题。请把机器人账号、发送权限和日志视为独立的安全边界。

 机器人收到的文字会先进入本机 Agent Hub；如果任务需要总结或自然语言理解，受控上下文可能发送给你配置的 AI Provider。机器人账号扫码登录、个人微信数据库连接和外部 Agent/API Token 是不同的边界，使用前请分别确认账号与权限。

@@ -1,6 +1,6 @@
 # 防撤回

-防撤回是一个默认关闭的可选功能。开启后，WechatExplorer 会尽量保留它能够捕获到的撤回消息，并在聊天气泡旁标记“消息已撤回”。
+防撤回是一个默认关闭的可选功能。开启后，TraceMemo 会尽量保留它能够捕获到的撤回消息，并在聊天气泡旁标记“消息已撤回”。

 它适合希望在本机档案中保留后续聊天上下文的用户，但不能保证找回每一条撤回消息。

@@ -9,7 +9,7 @@
 1. 先连接微信数据库，并确认“档案”可以正常读取聊天。
 2. 打开“设置 → 防撤回”。
 3. 阅读性能和数据提示后，开启“防撤回”。
-4. 保持 WechatExplorer 与当前微信数据连接；之后捕获到的撤回消息会尽量保留并标记。
+4. 保持 TraceMemo 与当前微信数据连接；之后捕获到的撤回消息会尽量保留并标记。

 防撤回不是第一次使用的必要步骤。只想浏览、搜索、提问或导出时，可以保持关闭。

@@ -18,19 +18,19 @@
 - 监听应用能够识别到的后续撤回变化；
 - 在本地保留必要的消息和撤回关系；
 - 将已识别的原消息与撤回状态一起显示在档案中；
- 按微信账号隔离 WechatExplorer 保存的恢复记录。
+- 按微信账号隔离 TraceMemo 保存的恢复记录。

 ## 当前限制

 - 不能恢复开启前已经撤回、且应用从未保存到的消息；
- WechatExplorer 未运行、数据库未连接或没有捕获到撤回变化时，消息可能无法保留；
+- TraceMemo 未运行、数据库未连接或没有捕获到撤回变化时，消息可能无法保留；
 - 微信版本、消息表结构和数据库事件变化都可能让部分消息无法恢复或正确匹配；
 - 开启后需要为消息表增加监听，聊天很多或磁盘较慢时可能影响加载性能；
 - “消息已撤回”只说明应用识别到了撤回关系，不保证恢复内容完整。

 ## 数据写入与关闭边界

-普通浏览、搜索和 Knowledge 不会修改微信原始聊天数据库；防撤回是一个例外。用户第一次明确开启时，当前实现会在微信消息数据库中安装用于记录撤回的本地日志/监听结构，并在 WechatExplorer 的用户数据目录保存必要的本地恢复记录。
+普通浏览、搜索和 Knowledge 不会修改微信原始聊天数据库；防撤回是一个例外。用户第一次明确开启时，当前实现会在微信消息数据库中安装用于记录撤回的本地日志/监听结构，并在 TraceMemo 的用户数据目录保存必要的本地恢复记录。为兼容旧版本，该目录在磁盘上可能继续显示为历史名称 `WechatExplorer`。

 关闭设置中的开关，不等同于删除已经安装的日志结构或清空此前保存的恢复记录。当前版本没有在 UI 中提供“移除防撤回日志结构”或“清空防撤回记录”的独立操作。对数据库写入、磁盘占用或完全回滚有要求时，应在开启前先确认这一边界，并使用微信官方方式备份重要数据。

@@ -1,6 +1,6 @@
 # 生成群聊日报和总结

-如果你每天在多个群里聊天，晚上不想重新翻几十个群，可以让 WechatExplorer 根据一个群的聊天内容整理出一份可阅读、可保存的报告。
+如果你每天在多个群里聊天，晚上不想重新翻几十个群，可以让 TraceMemo 根据一个群的聊天内容整理出一份可阅读、可保存的报告。

 ## 报告适合做什么

@@ -8,14 +8,14 @@

 1. 确认下载的是 GitHub Releases 中的 Windows x64 `-setup.exe`，并已完成安装。
 2. 安装 [Microsoft Visual C++ x64 运行库](https://aka.ms/vc14/vc_redist.x64.exe)。
-3. 安装完成后重新启动 WechatExplorer；如果仍无响应，再重新运行安装包进行覆盖安装。
+3. 安装完成后重新启动 TraceMemo；如果仍无响应，再重新运行安装包进行覆盖安装。

 ### macOS

 - 提示“无法打开，因为开发者无法验证”时，前往“系统设置 → 隐私与安全性”并点击“仍要打开”。
- 提示应用已损坏时，确认应用位于“应用程序”目录，再执行 `xattr -cr "/Applications/WechatExplorer.app"`。
+- 提示应用已损坏时，确认应用位于“应用程序”目录，再执行 `xattr -cr "/Applications/TraceMemo.app"`。

-完整安装步骤见[第一次使用 WechatExplorer](./getting-started.md#2-安装并启动)。
+完整安装步骤见[第一次使用 TraceMemo](./getting-started.md#2-安装并启动)。

 ## 连接微信失败

@@ -69,7 +69,7 @@ AI Search 失败时可能仍保留部分来源；不要把部分结果当成完

 确认：

-1. WechatExplorer 正在运行且 API Center 显示本地服务在线；
+1. TraceMemo 正在运行且 API Center 显示本地服务在线；
 2. Agent 使用的是当前 Reader Skill，而不是旧的 MCP 配置；
 3. 请求地址为 `http://127.0.0.1:6131`；
 4. 非 health 请求带有最新 `Authorization: Bearer <TOKEN>`；
@@ -91,4 +91,4 @@ Agent Hub 和外部 Agent 是两条路径。机器人异常时依次确认：

 ## 防撤回没有保留消息

-防撤回只能尽量保留开启后且应用成功捕获到的撤回变化。确认开启时数据库已经连接、WechatExplorer 在撤回发生时保持运行，并检查聊天加载是否明显变慢。开启前已经消失、应用未捕获或微信结构无法识别的消息不能保证恢复；详见[防撤回](./recall-protection.md)。
+防撤回只能尽量保留开启后且应用成功捕获到的撤回变化。确认开启时数据库已经连接、TraceMemo 在撤回发生时保持运行，并检查聊天加载是否明显变慢。开启前已经消失、应用未捕获或微信结构无法识别的消息不能保证恢复；详见[防撤回](./recall-protection.md)。
@@ -1,6 +1,6 @@
 # 语音转文字

-WechatExplorer 可以把微信语音转换成可搜索的文字，适合你不想逐条播放、希望把语音内容带入后续查找或导出的场景。
+TraceMemo 可以把微信语音转换成可搜索的文字，适合你不想逐条播放、希望把语音内容带入后续查找或导出的场景。

 ## 使用前准备