chore: 补充

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

@@ -0,0 +1,45 @@
+# 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 日志。
+
+更多安全边界见[数据、隐私与安全](../user-guide/privacy.md)和[API 安全](./api-security.md)。