数据管理

搜索

Ctrl + K 打开搜索，支持对当前联系人的聊天记录做关键词匹配。结果按时间倒序分页，点击结果可跳转到对应消息并高亮。

搜索使用 SQL LIKE，对 %、_、\ 做了转义，不会因输入通配符导致全表匹配。

导出

点击聊天头部 📥 图标，选择格式（.txt / .md / .json）和时间范围（可留空导出全部）。文件名支持中文（RFC 5987 编码），Chrome / Edge / Safari 均不会乱码。

导出上限为 5000 条消息。导出内容排除导演词行。

完整备份（0.12.0）

外观与玩法中心 → 数据与洞察 →「导出完整备份」，一次导出全部角色的对话，得到一个 JSON 文件：

{ "app": "pchat", "schema": 1, "exported_at": "…",
  "counts": { "contacts": 3, "messages": 812 },
  "contacts": [ { "contact_id": "kayoko", "display_name": "…", "contact_type": "ai",
                  "message_count": 520, "messages": [ { "role": "…", "content": "…", "created_at": "…" } ] } ] }

上限：50 个角色 / 整体 20000 条 / 单角色 5000 条。换设备、重装、迁移都建议先导这份。

导入（0.12.0）

数据与洞察 →「选择 JSON 导入」，支持两种文件：

• 单角色 JSON（用聊天头部导出窗口得到的 .json）
• 完整备份 JSON（上一节那份）

流程：

1. 选择文件 → 显示「共 N 条消息」；
2. 选择落点：合并到现有角色 / 覆盖该角色历史 / ＋ 新建角色（整包备份则按原角色 ID 逐个还原，不存在的自动新建）；
3. 选择模式：合并（跳过重复） 或 覆盖该角色历史（整包时覆盖被禁用，避免误删多个角色）；
4. 点 先预览：只统计不写库，告诉你「将写入多少条、跳过多少条重复」；
5. 点 开始导入：逐条列出每个角色的写入/跳过结果。

几个要点：

• 去重：按「角色 + 时间 + 内容」判断，同一文件里的重复也只导一次，所以重复导入不会写两遍；
• 导入后会清理该角色的上下文缓存，下一句 AI 回复就会用上新历史（不需要手动刷新）；
• 单次最多 5000 条、单条正文最多 10000 字，超出会直接报错而不是悄悄截断；
• 导入不会重新计算亲密度或长期记忆，它只还原聊天记录。

本机用量与缓存

数据与洞察里可以看到：云端消息数、localStorage 占用、本地缓存条目数、背景图大小。

「清理本地缓存」只删本地聊天/联系人缓存（pchat_history_*、pchat_contacts*），不会动云端数据，也不会改你的外观设置。

删除聊天记录

点击聊天头部 🗑️ 图标，打开删除面板。勾选一条消息后，比它更晚的所有消息会被自动勾选（不可取消更晚的部分，只能整体取消）。一次最多删除 200 条。

删除会同时使该联系人的 KV 热缓存失效，下次读取自动回源。

收藏与表情回应

• 收藏：右键消息 →「收藏」，或在收藏面板中管理。收藏的消息带有 ★ 标记，可跳转定位。
• 表情回应：右键消息 →「表情回应」，支持 ❤ 😂 😢 😮 👍 五种。再次点击同一表情可取消。