
把AI对话存成笔记Agent Client for Obsidian的Chat Export导出技巧与最佳实践【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-clientAgent Client for Obsidian 是一个把 Claude Code、Codex、Gemini CLI 等 AI 编码代理接入 Obsidian 的插件。它的Chat Export聊天导出功能可以把与 AI 的完整对话一键导出为带 YAML Frontmatter 的 Markdown 笔记自动归档到笔记库中成为可搜索、可链接、可分享的长期知识资产。本文将带你掌握导出按钮、9 项导出设置与自动导出机制轻松把每一次 AI 对话变成有价值的笔记。为什么要把AI对话导出成笔记与 AI 代理的对话往往包含决策过程、问题解答和调试记录但这些内容默认只存在于会话里切换会话或重启后就不好找了。Chat Export 能帮你 文档留痕完整记录对话与决策随时回顾 学习复盘把 Agent 的解释保存下来日后复习 分享协作导出为 Markdown 后直接发给同事无需额外转换 排错参考工具调用记录读了哪些文件、改了哪些代码都可追溯导出后的笔记与普通笔记一样支持[[笔记名]]双向链接、标签检索与嵌入引用。手动导出点击聊天窗口里的保存按钮最简单的使用方式——在聊天面板顶部的标题栏点击保存图标Export点击后会发生什么当前对话被转换为 Markdown 文件文件保存到导出文件夹默认Agent Client/弹出通知告知导出路径默认自动打开这份新笔记除了标题栏按钮还可以点击标题栏的更多⋯菜单选择 Export chat to Markdown打开 Obsidian命令面板执行Export chat命令命令 IDagent-client:export-chat导出按钮的界面定义见 ChatHeader.tsx导出动作的实现见 useChatActions.ts。9项导出设置调出最适合你的导出工作流在设置 → Agent Client → Export中配置所有选项见 SettingsTab.ts设置项说明默认值Export folder导出笔记的保存文件夹Agent ClientFilename文件名模板支持{date}与{time}占位符agent_client_{date}_{time}Frontmatter tag附加标签支持嵌套如projects/agent-client留空则不加agent-clientInclude images是否导出消息中的图片开启Image location图片保存位置Obsidian 附件文件夹 / 自定义文件夹 / Base64 内嵌Obsidian 附件文件夹Custom image folder选择自定义位置时的图片路径Agent ClientAuto-export on new chat开始新会话前自动导出当前对话关闭Auto-export on close chat关闭聊天视图时自动导出关闭Open note after export导出后自动打开笔记开启默认值定义见 plugin.ts。导出的Markdown笔记长什么样导出的笔记是标准 Markdown YAML Frontmatter 结构可直接被 Obsidian 索引--- created: 2025-12-13T00:31:12 agentDisplayName: Claude Code agentId: claude-agent-acp session_id: f95b4847-cb9c-441a-9f0b-08eb243ff5dd tags: [agent-client] ---正文部分会完整保留消息按## 时间 - User / Assistant分段带时间戳工具调用工具名、涉及文件路径、执行状态与代码 diff如### Read File思考过程以可折叠的 [!info]- Thinking提示框呈现任务计划带 ✅ / / ⏳ 状态标记的 callout笔记引用自动提及与手动提及都以[[笔记名]]格式保留格式生成逻辑见 chat-exporter.ts完整示例见官方文档 chat-export.md。图片导出3种存储方式各有所长如果对话中附带了截图比如让 AI 分析图片导出时图片有三种处理方式方式特点适用场景Obsidian 附件文件夹跟随笔记库附件设置存放笔记中用![[图片名]]引用默认选择管理方便自定义文件夹集中存放在指定目录想让导出素材集中归档Base64 内嵌图片数据直接写进 Markdown无外部依赖需要单独分享这一份笔记细节上的贴心设计图片文件名按导出名_001.png递增编号若图片已存在则自动跳过不会重复写入。自动导出让每一次对话都不丢失手动点击容易忘记两个自动触发时机值得开启开始新会话时点新对话前自动把当前对话导出归档关闭聊天视图时关掉聊天面板时自动兜底导出还有一个避免重复文件的机制导出文件通过 Frontmatter 中的session_id与来源会话匹配——同一会话重复导出会覆盖原文件不同会话则自动加_2、_3后缀保证互不覆盖。实现细节见 resolveExportFilePath。最佳实践清单✅ 设置专属标签把 Frontmatter tag 改为projects/ai-notes之类的嵌套标签检索更精准✅ 开启自动导出频繁切换会话/多开 Agent 时开启新会话时自动导出防止遗漏✅ 利用文件名模板{date}{time}组合保证文件按时间自然排序✅ 分享前选 Base64需要单独发送含图笔记时改用 Base64 内嵌一份文件走天下✅ 自动导出时关闭导出后打开笔记避免后台导出时不断弹开新标签页打扰工作✅ 用标签做知识管理默认agent-client标签可作为兜底方便定期回顾所有 AI 对话相关文档与源码内容路径Chat Export 官方文档docs/usage/chat-export.md导出器核心实现src/services/chat-exporter.ts导出动作与自动导出逻辑src/hooks/useChatActions.ts导出按钮界面src/ui/ChatHeader.tsx导出设置面板src/ui/SettingsTab.ts插件入口与命令注册src/plugin.ts掌握 Chat Export 后你与 AI 的每一次深度对话都不再是过眼云烟而是沉淀在笔记库中、可持续检索复用的知识资产。【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考