WechatExplorer/docs/user-guide/knowledge.md

# 把聊天变成更容易再次找到的本地资料

## 你为什么需要 Knowledge

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

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

## 建立和同步

Knowledge 不会在第一次连接后自动悄悄建立。进入“问问微信”后，在“本地知识库”区域点击：

- **建立本地知识库**：第一次读取当前账号的可检索聊天；
- **同步最新记录**：已有索引时，只补充新增或变化的内容。

同步在后台运行，**期间仍然可以正常提问和分析**，不会被禁用。索引还没追完时，答案会基于当前已经可用的部分给出，并在界面标注覆盖范围。

知识库卡片同时显示两组互相独立的信息：

- **规模**：已索引消息、知识片段、磁盘占用——说明索引有多大；
- **状态与本轮进度**：说明索引现在处于什么状态、这一轮同步在做什么（扫了多少、真正新增了多少、处理到第几个会话）。

`最新索引` 只表示索引已经覆盖到聊天记录的哪个时间点，**不等于**整库已经建完；进度里的计数是**本轮**的数字，不是全部历史的总数。

### 状态怎么读

| 状态                | 含义                                             |
| ------------------- | ------------------------------------------------ |
| 可用 · 已追至最新   | 索引已覆盖到聊天记录的最新位置，可以直接用       |
| 可用 · 正在追新     | 索引可用，正在后台补充最近新增的消息             |
| 可用 · 正在补齐历史 | 索引可用，正在后台补齐较早的历史内容             |
| 可用 · 同步已取消   | 索引仍然可用；上一轮同步被取消，已建立的部分保留 |
| 可用 · 更新失败     | 索引仍然可用；上一轮同步出错，可以稍后重试       |

只有确实追平、且没有待补齐内容时才会出现“已追至最新”。索引不可查询时不会显示“可用”。

### 取消和继续

同步过程中可以点击 **取消同步**（点击后显示“正在取消…”）。取消只结束当前这一轮，不会删除已经建立的索引，也不会回滚已完成的部分；下次同步会从上次停下的位置继续，不需要从头重扫。中断过的索引仍然可以正常搜索。

## 图片文字索引（另一份索引）

本地索引其实有两份，彼此独立：

- **聊天记录索引**（也就是上面说的 Knowledge）：索引文字消息，用于跨会话、跨时间查找；
- **图片文字索引**：在本机识别微信图片里的文字（截图、公告、报价图等），把识别结果也变成可搜索的文字。

“独立”的意思是：聊天记录索引建好了，并不代表图片里的文字就搜得到。建立图片文字索引后，可以在“问问微信”里直接搜截图或公告图里写过的词。

图片文字索引只在本机识别，原始图片不会因为本地识别而上传。它**不等于“图片理解”**：识别文字不联网、不需要 AI 服务；而让模型看图并回答属于图片理解，需要配置 AI 服务，走的是另一条路径。

识别失败的图片可以单独重试，也有“只重建搜索索引、不重新识别图片”的修复入口——修索引不需要重跑几万张图。

两个索引都可以在“设置 → 本地索引”里集中查看状态、建立、同步和清理。

## 账号隔离

每个微信账号使用独立的本地索引。切换账号时，应用不会把一个账号的索引混入另一个账号的搜索结果。

## 什么时候值得建立

- 你要跨多个群查过去几个月的内容；
- 你反复查同一个项目、客户或主题；
- 你希望 AI 先从更稳定的本地资料中找来源；
- 你想减少每次搜索都重新读取大量原始记录的等待。

只偶尔查一条原话时，直接使用档案搜索通常更快。

## 清理和重建

在“设置 → 缓存与清理”中可以清理本地知识库索引、检索记录和导出任务缓存。清理索引不会删除微信原始聊天记录或数据库密钥；之后可以回到“问问微信”重新建立。

## 产品术语（可选）

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