WechatExplorer/docs/agent/release-notes-v2.2.0.md

TraceMemo 2.2.0：品牌升级与本地数据兼容

2.2.0 将用户可见品牌从 WechatExplorer 升级为 TraceMemo（迹忆）。这次升级不搬迁或复制用户的 Application Support 数据；macOS 和 Windows 上的旧用户会继续使用原有数据根，以避免设置、密钥和本地索引失联。

升级后继续保留的内容

• 微信数据库连接设置和其他用户设置；
• AI Provider、模型配置和已加密 API Key；
• Local HTTP API Token；
• 微信数据库 Key 和图片解密 Key；
• Knowledge 本地索引，包括现有 SQLite、WAL 和 SHM 文件；
• 报告历史、防撤回归档和图片理解结果；
• Renderer Local Storage 和其他 Chromium session 数据；
• ~/.wechatexplorer/wechat-connector/accounts 中的 Agent Hub 登录凭据。

应用启动时会在任何业务模块读取 Electron 路径或使用 safeStorage 之前选择数据根，并将 userData 与 sessionData 设置为同一目录：

• WechatExplorer 或 v2.1.9 使用的小写 wechatexplorer 目录包含有效用户资产时，继续使用对应旧目录；
• 只有 TraceMemo 新目录包含有效用户资产时，使用新目录；
• 多个旧目录或新旧目录同时包含有效用户资产时，不复制、不合并、不覆盖；两个大小写 legacy 目录均有效时确定性优先 WechatExplorer 并写入诊断日志；
• 两边都没有有效用户资产时，全新安装使用 TraceMemo 新目录。

仅有 Local State、Cache、Code Cache 或 GPUCache 等运行时文件，不会被判断为有效用户资产。

有意保留的兼容标识

内部 Electron runtime identity 在 macOS 上继续使用 WechatExplorer。前者用于兼容旧 safeStorage 密文，后者同时承担旧 safeStorage 与 WCDB 运行时兼容；它们都不是未完成的品牌替换。

以下历史标识也继续保留：

• bundle/app identifier：com.wechatexplorer.app；
• Reader Skill 目录和标识：wechatexplorer-reader；
• Agent 环境变量：WECHATEXPLORER_API_TOKEN；
• Agent Hub 凭据目录：~/.wechatexplorer；
• GitHub 仓库地址中的 WechatExplorer。

Local HTTP API 的 endpoint、默认端口 6131、Bearer Token 格式、加密方式和 rotation 行为没有因为品牌升级而改变。旧 Token 文件会从旧数据根继续读取，不会仅因升级而重新生成。

Knowledge 与日志

Knowledge 不会被复制、移动或自动重建。旧用户继续直接使用原有 Knowledge 目录，因此不需要为了 v2.2.0 重新建立索引。

TraceMemo 的新诊断日志写入 TraceMemo 日志目录；WechatExplorer 历史日志保持原位置，不移动、不重命名、不删除。“打开诊断日志目录”会打开当前版本使用的 TraceMemo 日志。

更多安全边界见数据、隐私与安全和API 安全。