新手必看：用 Obsidian 保存 GPT 对话，再用 QMD 随时找回来

跟 GPT 聊得越多，越容易遇到一个问题：当时说得很清楚，过几天却找不到了。

解决办法不复杂。让 Obsidian 保存 Markdown 文件，让 GPT 负责整理对话，再用 QMD 搜索这些文件。以后换电脑、换模型，资料仍然在你自己的硬盘里。

整套流程可以理解成：

你和 GPT 对话
    ↓
GPT 把重点整理成 Markdown
    ↓
Markdown 保存到 Obsidian
    ↓
QMD 建立本地索引
    ↓
以后提问时，GPT 先查旧资料再回答

本站用户可以先进入左侧“知识库”，点击“整理全部对话”，检查待确认资料，再点击“导出 Obsidian”。这样能直接得到整理好的 Markdown 压缩包。

先弄明白三个工具

Obsidian 是本地文件柜。每篇笔记都是普通的 .md 文件，文件归你自己管理。

GPT 是整理助手。它负责从长对话里提取标题、结论、步骤、用户偏好和待办。

QMD 是本地搜索引擎。它会索引 Markdown，支持关键词搜索和语义搜索，但不会替你保存聊天记录，也不会自动判断哪条信息是真的。

最重要的一点：普通 ChatGPT 网页端通常不能直接写入你的电脑。 网页端可以替你整理 Markdown，但仍要由你保存文件。Codex、Claude Code 等拥有本地文件权限的 Agent，得到授权后才可以自动写入 Obsidian。

10 分钟基础版

第一次操作只完成四件事：

  1. 安装 Obsidian。
  2. 保存一篇 Markdown。
  3. 安装 QMD。
  4. 用 qmd search 找到刚才的笔记。

关键词搜索跑通后，再考虑向量搜索和 MCP。别一开始把所有高级功能一起装，排错会很痛苦。

第一步：安装 Obsidian

打开 Obsidian 下载页，下载 Windows 版本并安装。

首次打开时选择“创建新仓库”，仓库英文叫 Vault。建议使用一个稳定、容易找到的目录，例如：

C:\Users\你的用户名\Documents\Obsidian\AI-Vault

不要把 Vault 放到 Program Files。如果要使用网盘同步，也建议先在本地跑通整套流程，再开启同步。

第二步：创建基础目录

在 Obsidian 左侧文件列表中新建下面几个文件夹：

AI-Vault/
  inbox/       刚整理好的对话，先放这里
  daily/       每日工作记录
  projects/    项目资料和项目决定
  knowledge/   已确认、可长期复用的知识
  templates/   Markdown 模板

新手不用急着研究复杂的双链、标签体系和知识图谱。先保证资料能保存、能搜索，已经解决了大部分问题。

第三步：让 GPT 在对话结束后整理 Markdown

每次对话结束前，把下面这段指令发给 GPT。

可直接复制的整理指令

请把刚才这次对话整理成一篇可以直接保存到 Obsidian 的 Markdown 文档。

整理原则：
1. 只记录本次对话中明确出现的事实、决定、步骤、代码、用户偏好和待办。
2. 不要编造经历、数据、来源、时间或没有说过的结论。
3. 把一次性闲聊和真正值得以后查找的内容分开。
4. 不要写入 API Key、密码、Token、Cookie、私钥或其他敏感凭据；发现这类内容时替换为 [已省略]。
5. 如果没有长期价值，请明确写“归档建议：仅保留在 inbox，不进入长期知识库”。

请严格按下面的顺序输出：
---
title: 用一句话概括这次对话
date: YYYY-MM-DD
tags: [conversation, 待补充标签]
type: conversation-summary
status: candidate
---

# 标题

## 一句话结论

## 关键事实与决定

## 可复用步骤、命令或代码

## 用户偏好与长期要求

## 待办与未解决问题

## 来源
- 对话主题：
- 整理时间：

只输出 Markdown 正文，不要在正文前后解释你做了什么。

GPT 返回内容后，从开头的 --- 一直复制到正文末尾，保存为：

2026-08-28-对话主题.md

第一次先放进 inbox。过几天确认这条资料仍然有价值，再移动到 projects 或 knowledge。

想让本地 Agent 自动写文件

如果你使用 Codex、Claude Code 等本地 Agent，可以把下面的规则放进项目指令。前提是 Agent 能访问你的 Vault，并且你允许它创建文件。

从现在起，每次任务完成前执行一次对话归档：
1. 把本轮真正有长期价值的结论整理为 Markdown。
2. 临时过程放入 inbox；稳定规则、项目事实和已验证结论放入对应目录。
3. 文件名使用 YYYY-MM-DD-简短主题.md，避免覆盖旧文件。
4. 写入前不要保存密码、API Key、Token、Cookie、私钥或完整凭据。
5. 写入后重新读取文件，确认标题、日期、结论、来源和待办没有丢失。
6. 最后只汇报文件路径、摘要和仍未解决的问题。

这里要分清三种情况：

使用方式 谁整理 谁保存文件
普通 ChatGPT 网页端 GPT 你手动保存
本地 Agent Agent 获得权限后自动保存
本站知识库 站内整理功能 导出 Obsidian 后由你放入 Vault

第四步：安装 Node.js 和 QMD

QMD 通过 npm 安装。先打开 Node.js 下载页，安装页面标注的 LTS 版本。本机验证的 QMD 版本是 2.5.3，需要 Node.js 22 或更高版本；如果你安装的是更新版本，以该版本的安装提示为准。

安装完成后，按 Windows 键，搜索并打开 PowerShell，依次执行：

node --version
npm --version
npm install --global @tobilu/qmd
qmd --version

最后一条命令能显示版本号，就说明 QMD 已经安装成功。

如果提示“qmd 不是内部或外部命令”，先关闭 PowerShell，再重新打开。仍然不行时执行：

where.exe qmd

它会告诉你 QMD 实际安装到了哪里。

第五步：把 Obsidian Vault 加入 QMD

把下面路径换成你自己的 Vault 路径：

qmd collection add "C:\Users\你的用户名\Documents\Obsidian\AI-Vault" --name ai-vault --mask "**/*.md"
qmd collection list
qmd update

这三条命令分别表示：

  • collection add：告诉 QMD 要搜索哪个文件夹。
  • collection list：查看已经加入的集合。
  • update：扫描新增、修改和删除的 Markdown，更新本地索引。

QMD 的索引是可以重建的缓存。真正的资料仍然是 Obsidian 里的 Markdown，不要把 QMD 索引当作备份。

第六步：做第一次关键词搜索

在 Obsidian 的 inbox 中新建 qmd-验证.md，写入：

# QMD 验证

这是一条专门用来验证 Obsidian、Markdown 和 QMD 的测试资料。
搜索关键词：QMD 验证。

保存后回到 PowerShell：

qmd update
qmd search "QMD 验证" --full-path

如果结果中出现 qmd-验证.md，基础链路已经跑通。

第七步：可选开启语义搜索

关键词搜索只找字面相近的内容。语义搜索可以处理“意思相近，但用词不同”的问题。

先生成向量：

qmd embed

再测试：

qmd vsearch "如何整理历史对话"
qmd query "如何整理历史对话"

第一次运行可能需要下载或加载本地模型，速度明显慢于 qmd search。如果 qmd embed 暂时失败，不影响基础使用，继续用关键词搜索即可。

第八步：配置 QMD MCP

支持 MCP 的 Agent 可以直接调用 QMD。常见配置写法如下：

{
  "mcpServers": {
    "qmd": {
      "command": "qmd",
      "args": ["mcp"]
    }
  }
}

不同客户端的配置文件位置不同，优先使用客户端自己的 MCP 设置入口。保存配置后重启客户端，再这样提问：

请先用 QMD 搜索我的 Obsidian，找到与“项目报价规则”有关的原文，核对日期和来源后再回答。

比较稳妥的召回顺序是：

  1. Agent 先用 QMD 搜索候选笔记。
  2. 再读取命中的 Markdown 原文。
  3. 核对日期、项目范围和资料状态。
  4. 最后根据原文回答。

不要让 QMD 搜到一个片段后就直接当成永久事实。旧笔记可能已经过期，也可能只适用于某个项目。

常见问题

QMD 搜不到刚保存的笔记

依次检查：

qmd collection list
qmd update
qmd search "笔记里的明确关键词" --full-path

同时确认文件后缀是 .md，QMD 集合路径和 Obsidian 当前打开的 Vault 是同一个目录。

关键词能搜，语义搜索不能用

这通常说明关键词索引正常，但向量还没生成。执行 qmd embed。模型下载或加载较慢时，不要反复卸载重装。

GPT 没有自动把文件写进电脑

这是权限边界，不是 GPT 故障。普通网页 GPT 只能返回文本。手动保存 Markdown，或使用有本地文件权限的 Agent。

MCP 启动失败

先在 PowerShell 单独运行：

qmd mcp

qmd mcp 是持续运行的 stdio 服务。命令执行后没有新提示、终端保持运行通常是正常的；按 Ctrl+C 退出后，再检查客户端配置中的 command 是否为 qmd、args 是否为 ["mcp"]，然后重启客户端。

隐私提醒

不要把这些内容写进 Obsidian：

  • API Key
  • 登录密码
  • Token 和 Cookie
  • 私钥
  • 完整代理节点
  • 支付信息

需要记录时，只写“凭据存放在哪里”和“怎样轮换”，具体秘密放到密码管理器或环境变量。

最后检查

完成下面四项，这套系统就能日常使用：

  • [ ] Obsidian 能打开你的 .md 文件。
  • [ ] qmd collection list 能看到 ai-vault。
  • [ ] qmd search 能找到测试笔记。
  • [ ] 配置 MCP 后，Agent 能先搜索原文再回答。

今天只完成前三项也完全够用。先让资料“存得下、找得到”，再慢慢增加自动归档、向量搜索和更复杂的知识管理规则。

参考入口