diff --git a/docs/development/overview.md b/docs/development/overview.md index a1132e1..464128d 100644 --- a/docs/development/overview.md +++ b/docs/development/overview.md @@ -41,7 +41,7 @@ pnpm test:e2e:build | `src/shared/voice-recognition.ts` | `user-guide/voice.md` | | `src/shared/group-report.ts`、报告 UI | `user-guide/report.md`、API/Agent 文档 | | `src/shared/export.ts`、导出服务/UI | `user-guide/export.md` | -| `src/main/services/recall-archive-service.ts`、防撤回设置 | `user-guide/recall-protection.md`、`user-guide/privacy.md` | +| `src/main/services/recall-archive-service.ts` | `user-guide/privacy.md` | | `src/shared/local-api-test.ts`、`src/main/http-server.ts` | `agent/api.md`、`api-security.md`、打包 Skill | | Agent Hub service/UI | `agent/agent-hub.md`、`user-guide/privacy.md` | | 设置导航、连接页面 | `user-guide/getting-started.md`、`docs/README.md` | diff --git a/docs/user-guide/chat-archive.md b/docs/user-guide/chat-archive.md index 2f99eff..2a09e80 100644 --- a/docs/user-guide/chat-archive.md +++ b/docs/user-guide/chat-archive.md @@ -45,12 +45,6 @@ 联系人和群聊列表会尽量显示头像、备注和昵称。头像或资料缺失时不影响消息读取；这通常表示本机没有对应资源，或微信没有返回完整资料。 -## 可选保留撤回消息 - -“设置 → 防撤回”提供一个默认关闭的可选功能。开启后，应用会尽量保留之后捕获到的撤回消息，并在气泡旁标记“消息已撤回”。它不能找回开启前已经消失或应用未捕获到的内容，也可能增加加载开销。 - -该功能与普通只读浏览的数据边界不同。开启前请阅读[防撤回](./recall-protection.md)。 - ## 保护自己不被误导 档案中的原始消息是核对 AI 结果的最终依据。看到 AI 的总结、日报或来源时，建议： diff --git a/docs/user-guide/getting-started.md b/docs/user-guide/getting-started.md index 1b81f87..9916f2a 100644 --- a/docs/user-guide/getting-started.md +++ b/docs/user-guide/getting-started.md @@ -106,7 +106,6 @@ - [生成群聊日报或总结](./report.md) - [转写微信语音](./voice.md) - [导出聊天档案](./export.md) -- [可选开启防撤回](./recall-protection.md) - [在微信里向 TraceMemo 提问](../agent/agent-hub.md) - [让外部 Agent 查询微信历史](../agent/overview.md) @@ -142,7 +141,6 @@ Agent Hub 是普通用户可以直接使用的入口，不需要安装 Reader Sk - 离线语音转写使用本地模型；它与在线 AI 请求是两条不同的数据路径。 - 你主动开始并确认 AI 问答或日报后，完成任务所需的受控上下文才可能发送给你选择的 AI 服务；打开应用不会自动上传全部聊天。 - 应用内 Local HTTP API 默认只监听 `127.0.0.1:6131`，受保护接口需要 Token。 -- 防撤回默认关闭；首次开启会为微信消息数据库增加本地撤回日志/监听结构，详细边界见[防撤回](./recall-protection.md)。 完整边界见[数据、隐私与安全](./privacy.md)。 diff --git a/docs/user-guide/privacy.md b/docs/user-guide/privacy.md index 65f986e..f8cf4dc 100644 --- a/docs/user-guide/privacy.md +++ b/docs/user-guide/privacy.md @@ -14,8 +14,6 @@ TraceMemo 的核心路径是本地优先，但“本地优先”不等于所有 应用不会因为你打开 TraceMemo 就自动把整份微信数据库上传。 -防撤回默认关闭，并且和上面的普通读取路径不同。用户第一次明确开启时，当前实现会在微信消息数据库中安装本地撤回日志/监听结构，同时在 TraceMemo 用户数据目录保存必要的恢复记录。v2.1.9 的旧恢复记录会随首次启动迁移复制到 TraceMemo，旧目录仍保留。关闭开关不等于移除已经安装的结构或清空既有记录；当前 UI 没有对应的清理入口。详见[防撤回](./recall-protection.md)。 - ## 什么时候会请求外部服务 当你主动使用 AI Search、群聊日报或图片理解，并配置了远程 Provider 时，完成任务所需的内容可能发送给该 Provider。当前设置页给出的边界是： @@ -58,4 +56,3 @@ Token 由应用生成，使用 Electron `safeStorage` 加密保存在本机 `loc - 对需要外发的 AI 功能逐项确认 Provider； - 定期在“设置 → 缓存与清理”清理不再需要的检索、导出和索引缓存； - 在共享电脑上退出应用并保护系统账户。 -- 在开启防撤回前确认你接受其数据库写入、性能和清理边界，并先用微信官方方式备份重要数据。 diff --git a/docs/user-guide/recall-protection.md b/docs/user-guide/recall-protection.md deleted file mode 100644 index b475b01..0000000 --- a/docs/user-guide/recall-protection.md +++ /dev/null @@ -1,37 +0,0 @@ -# 防撤回 - -防撤回是一个默认关闭的可选功能。开启后，TraceMemo 会尽量保留它能够捕获到的撤回消息，并在聊天气泡旁标记“消息已撤回”。 - -它适合希望在本机档案中保留后续聊天上下文的用户，但不能保证找回每一条撤回消息。 - -## 如何开启 - -1. 先连接微信数据库，并确认“档案”可以正常读取聊天。 -2. 打开“设置 → 防撤回”。 -3. 阅读性能和数据提示后，开启“防撤回”。 -4. 保持 TraceMemo 与当前微信数据连接；之后捕获到的撤回消息会尽量保留并标记。 - -防撤回不是第一次使用的必要步骤。只想浏览、搜索、提问或导出时，可以保持关闭。 - -## 当前能做什么 - -- 监听应用能够识别到的后续撤回变化； -- 在本地保留必要的消息和撤回关系； -- 将已识别的原消息与撤回状态一起显示在档案中； -- 按微信账号隔离 TraceMemo 保存的恢复记录。 - -## 当前限制 - -- 不能恢复开启前已经撤回、且应用从未保存到的消息； -- TraceMemo 未运行、数据库未连接或没有捕获到撤回变化时，消息可能无法保留； -- 微信版本、消息表结构和数据库事件变化都可能让部分消息无法恢复或正确匹配； -- 开启后需要为消息表增加监听，聊天很多或磁盘较慢时可能影响加载性能； -- “消息已撤回”只说明应用识别到了撤回关系，不保证恢复内容完整。 - -## 数据写入与关闭边界 - -普通浏览、搜索和 Knowledge 不会修改微信原始聊天数据库；防撤回是一个例外。用户第一次明确开启时，当前实现会在微信消息数据库中安装用于记录撤回的本地日志/监听结构，并在 TraceMemo 的用户数据目录保存必要的本地恢复记录。v2.1.9 的旧恢复记录会在用户确认迁移后复制到 TraceMemo，旧目录不会删除。 - -关闭设置中的开关，不等同于删除已经安装的日志结构或清空此前保存的恢复记录。当前版本没有在 UI 中提供“移除防撤回日志结构”或“清空防撤回记录”的独立操作。对数据库写入、磁盘占用或完全回滚有要求时，应在开启前先确认这一边界，并使用微信官方方式备份重要数据。 - -完整的数据边界见[数据、隐私与安全](./privacy.md)。 diff --git a/docs/user-guide/troubleshooting.md b/docs/user-guide/troubleshooting.md index e481468..365a108 100644 --- a/docs/user-guide/troubleshooting.md +++ b/docs/user-guide/troubleshooting.md @@ -88,7 +88,3 @@ Agent Hub 和外部 Agent 是两条路径。机器人异常时依次确认： 5. 需要总结或自然语言理解时，AI Provider 是否可用。 当前机器人不支持群发、定时任务或与文字同等的图片、语音、文件和视频理解。详细边界见[Agent Hub](../agent/agent-hub.md)。 - -## 防撤回没有保留消息 - -防撤回只能尽量保留开启后且应用成功捕获到的撤回变化。确认开启时数据库已经连接、TraceMemo 在撤回发生时保持运行，并检查聊天加载是否明显变慢。开启前已经消失、应用未捕获或微信结构无法识别的消息不能保证恢复；详见[防撤回](./recall-protection.md)。