Documentation

仓库与全文检索

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

仓库在哪里

默认情况下,仓库位于你的用户目录(~/.xwx-backup/vault)。如果你偏好其他磁盘位置或同步文件夹,可以在 设置 → 仓库 中修改。

  • 每条对话一个 Markdown 文件,以对话标题命名
  • 每个文件都带 YAML frontmatter:标题、平台、模型、创建/更新时间戳、标签、字数和来源 URL
  • 文件布局刻意朴实:任何编辑器、脚本或 PKM 工具都能读取

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

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

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

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

筛选、标签与星标

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

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

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

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

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

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

Frequently Asked Questions

+

+

+

Related Articles