文档

仓库与全文检索

XWX Backup 保存的一切都在仓库里 — 磁盘上的纯 Markdown 文件,配一个即时搜索索引。本页介绍仓库的组织方式,以及如何找回你归档过的任何内容。

仓库在哪里

vault 默认位于你的用户目录(~/.xwx-backup/vault)。如果希望放在其他磁盘或同步文件夹,可在 设置 → Vault 中更改。

  • 每条会话一个 Markdown 文件,按平台分文件夹组织
  • 每个文件都有 YAML frontmatter:id、平台、标题、模型、创建/更新时间戳、消息数与标签
  • 文件结构刻意保持简单:任何编辑器、脚本或 PKM 工具都能直接读取

在外部编辑过文件后,请使用重新扫描 — 它会根据磁盘上的文件重建检索数据库。

仓库概览页:已归档对话列表
仓库概览页:已归档对话列表

搜索栏查询仓库中每条消息的全文 — 而不只是标题 — 由 SQLite FTS 索引驱动,毫秒级返回结果。

  • 一次搜索同时匹配所有平台的消息内容
  • 结果显示标题、平台、日期和命中片段
  • 点击结果即可在整洁的阅读器中查看对话,代码带语法高亮
跨平台的搜索结果与命中片段
跨平台的搜索结果与命中片段
note: 平台原生搜索通常只覆盖标题,且往往只有近期会话 — 更无法跨服务检索。本地全文检索正是这个仓库存在的理由。

筛选、标签与星标

将搜索与筛选组合来缩小范围:

  • 平台 — ChatGPT、Claude、Gemini 等
  • 账号 — 适用于多账号平台
  • 日期范围 — 按对话更新时间
  • 标签 — 在任意对话上自由编辑标签
  • 星标 — 标记重要对话并一键筛选查看

标签和星标会写回 Markdown frontmatter,因此在应用之外也依然生效。

仓库筛选栏:平台、标签与星标筛选
仓库筛选栏:平台、标签与星标筛选

维护:重新扫描、打包、清空

  • 重新扫描仓库 — 重新读取所有文件并重建搜索索引(外部编辑或恢复备份后运行)
  • 打包为 ZIP — 将当前筛选结果打成 ZIP 压缩包,便于异地存放或分享
  • 清空归档 — 删除仓库内容和索引。破坏性操作;设置会保留

Frequently Asked Questions

可以在应用运行的同时用 Obsidian 编辑仓库文件吗?+

可以 — 仓库就是纯 Markdown。之后运行一次重新扫描,让搜索索引吸收外部改动。如果你想要专门的 Obsidian 文件夹,请改用 Obsidian 同步功能。

仓库本身怎么备份?+

它就是一个文件夹 — 把它纳入你常规的文件备份(或放进同步/网盘文件夹)即可。定期快照用“打包为 ZIP”很方便。

手动恢复文件后搜索找不到任何结果,为什么?+

索引需要重建:设置 → 仓库 → 重新扫描。

能在一个地方同时搜索 ChatGPT、Claude 和 Gemini 的记录吗?+

可以 — 这正是 vault 存在的意义。平台自带的搜索通常只匹配标题(且往往只覆盖最近的会话),更无法跨服务搜索。XWX Backup 把所有平台全部消息的全文索引在一个本地索引里,毫秒级返回结果。

vault 能配合 Logseq 或其他 Markdown 工具使用吗?+

可以。vault 是纯 Markdown 加标准 YAML frontmatter,没有任何私有格式。Obsidian、Logseq、VS Code、grep、静态站点生成器或你自己的脚本都可以直接处理这些文件。

Related Articles