【AI智能体】Codex + Obsidian 打造专业知识库实战详解

目录

一、前言

[二、Codex 与Obsidian 介绍](#二、Codex 与Obsidian 介绍)

[2.1 Codex 是什么](#2.1 Codex 是什么)

[2.2 Codex能做什么?](#2.2 Codex能做什么?)

[2.3 Obsidian 介绍](#2.3 Obsidian 介绍)

[2.3.1 Obsidian 是什么](#2.3.1 Obsidian 是什么)

[2.3.2 Obsidian 核心特点](#2.3.2 Obsidian 核心特点)

[2.3.3 Obsidian 使用场景](#2.3.3 Obsidian 使用场景)

[三、Obsidian 安装部署](#三、Obsidian 安装部署)

[3.1 获取安装包](#3.1 获取安装包)

[3.2 Obsidian 安装过程](#3.2 Obsidian 安装过程)

[3.3 初始化与基本使用](#3.3 初始化与基本使用)

[3.3.1 界面基本说明](#3.3.1 界面基本说明)

[3.3.2 创建文件夹](#3.3.2 创建文件夹)

[3.3.3 创建文档](#3.3.3 创建文档)

[四、Codex 操作并使用Obsidian](#四、Codex 操作并使用Obsidian)

[4.1 Codex 连接Obsidian](#4.1 Codex 连接Obsidian)

[4.1.1 自然语言对话连接](#4.1.1 自然语言对话连接)

[4.1.2 Obsidian 安裝插件连接](#4.1.2 Obsidian 安裝插件连接)

[4.2 Codex 定时获取AI技术咨询并归档](#4.2 Codex 定时获取AI技术咨询并归档)

[4.3 基于知识库一键生成可编辑PPT](#4.3 基于知识库一键生成可编辑PPT)

[4.4 基于知识库形成个人风格Skill](#4.4 基于知识库形成个人风格Skill)

[4.4.1 背景说明](#4.4.1 背景说明)

[4.4.2 案例操作演示](#4.4.2 案例操作演示)

[4.5 Obsidian白板构建项目知识地图](#4.5 Obsidian白板构建项目知识地图)

[4.5.1 Obsidian 白板说明](#4.5.1 Obsidian 白板说明)

[4.5.2 案例操作演示](#4.5.2 案例操作演示)

五、写在文末


一、前言

Codex 被誉为2026年最值得上手的 AI 工具,它不仅是一个编程 Agent,更是一个几乎可以替换掉任何对话工具的全能 AI。配合高性价比的定价机制和充足的 Token 额度,只要你能想到的场景,它都能帮你自动化完成。可以说,Codex 完美复刻了ChatGPT的模板,让普通的用户也能方便使用一款专属定制、性能强大的桌面版AI助手。

随着AI 工具的普及和使用,企业对于知识库的操作也有了越来越多的选择,对很多企业来说,知识库文档的价值可以说是一大笔宝贵的资产,这也把知识库的安全提到了非常重要的位置,现在AI工具逐渐完善之后,AI+企业私有知识库的模式正得到很多人推崇,本篇以Obsidian 这个比较热门的知识库为载体,通过实战案例分享几个使用Codex + Obsidian 实现知识库搭建与操作的过程。

二、Codex 与Obsidian 介绍

Codex 是 OpenAI 推出的一款AI 编程智能体。与简单的聊天机器人或代码补全工具不同,Codex 能够像一个真实的开发人员一样,独立理解复杂任务、操作你的电脑、编写并修改代码、运行终端命令,甚至自动修复bug。https://openai.com/zh-Hans-CN/codex/?utm_source=Ai138.com

2.1 Codex 是什么

简单来说,可以把 Codex 看作一个"能帮你干活的AI工程师"。

  • 它是"目标驱动"而非"指令驱动":你只需告诉它最终的目标(例如:"帮我搭建一个带用户登录功能的网站"),它会自动拆解任务,规划步骤并执行,而不需要你一步步告诉它该怎么做。

  • 它不只是一个聊天框:虽然你可以在ChatGPT网页版找到它,但它真正的威力在于桌面应用和命令行工具(CLI)。在这些地方,它可以直接访问你的文件系统、运行终端命令,甚至操作其他软件。

  • 它的用户远超程序员:官方数据显示,Codex每周有超过300万用户,其中近一半(50%)的使用场景并非编码。从写周报、整理文档到数据分析,它都足以胜任。

2.2 Codex能做什么?

近期的重大更新让Codex的能力大幅跃升,使其不再局限于编程领域:

  • 动打开软件、运行模拟器、发现问题、修改代码,并再次测试验证,完成一整套开发闭环。

  • 所见即所得的开发(内置浏览器):Codex内置了一个浏览器。当你开发网页时,它可以直接在浏览器中展示效果。你可以直接在渲染出的网页上圈出问题,比如圈出一个标题并写上评论"字体太大,颜色改成蓝色",Codex就能理解视觉和空间上下文,并精准地修改对应的代码。

  • "心跳"机制与长期记忆:

    • 自动排班:你可以交付给它一个需要数小时甚至数周的长线任务。即使你关掉电脑,它也会在约定的时间点"自动醒来",在后台继续工作。

    • 记忆功能:它会记住你的编码偏好和纠正过的错误,下次再合作时,就不需要从头开始解释了。

  • 强大的工具生态:Codex已经接入了超过90个插件,可以无缝连接JIRA、GitLab、Microsoft Suite、Slack、Gmail等常用工具。你可以让它去Notion里读文档、去邮箱里看邮件、去项目管理工具里筛选Bug,再把所有信息汇总成一份报告给你。

2.3 Obsidian 介绍

2.3.1 Obsidian 是什么

Obsidian 是一款基于 Markdown 语法的本地优先知识管理软件。它由 Shida Li 和 Erica Xu 于2020年开发,因其独特的"双向链接"机制和强大的可定制性,迅速成为个人知识管理(PKM,即 Personal Knowledge Management)领域最受欢迎的工具之一。它不只是一个笔记应用,更被用户视为构建"第二大脑"的数字花园。

  1. Obsidian既是一个Markdown编辑器,也是一个知识库应用。

  2. 以最基本的方式使用时,你可以编辑和预览Markdown文件。但它真正的强大之处在于管理一个紧密互联的知识库。

  3. Obsidian 文档:关于 Obsidian - Obsidian 中文帮助

从本质上讲,Obsidian 是一个运行在你本地的文件管理器 + 超文本编辑器。

  • 存储本质:你的所有笔记都不是存储在云端或私有数据库里,而是以纯文本格式(.md文件)直接存放在你的电脑本地文件夹中。

  • 工作逻辑:它允许你在笔记之间创建永久的双向连接(通过 [[笔记名称]] 语法)。它不是让你把信息堆在文件夹里,而是像大脑神经元一样,将知识点编织成一张立体的知识网络。

2.3.2 Obsidian 核心特点

Obsidian 具有如下特点:

  • 本地化存储

    • 所有数据在本地硬盘,离线可用;支持通过 iCloud、Dropbox、Syncthing 或 Git 进行多端同步。
  • 双向链接与反向链接

    • 创建 [[笔记A]] 后,系统会自动在笔记A的页面底部生成"反向链接"列表,显示所有提及它的笔记,让知识脉络一目了然。
  • 关系图谱(Graph View)

    • 内置可视化图谱,将你的每篇笔记抽象为节点,链接为连线,支持全局俯瞰知识结构,发现隐性关联。
  • 强大的插件系统

    • 社区拥有超过 1400+ 插件(如 Dataview 数据查询、Kanban 看板、Calendar 日记、Excalidraw 绘图),可将其改造为任务管理、项目管理甚至轻量级数据库。
  • 高度主题定制

    • 支持 CSS 自定义和社区主题更换,从极简白到程序员暗黑风格均可一键切换。
  • 原生 Markdown 支持

    • 支持数学公式(LaTeX)、代码高亮、表格、任务列表(- )等,兼容绝大多数 Markdown 语法。

2.3.3 Obsidian 使用场景

Obsidian 主要有如下使用场景:

  • 学术研究与文献管理:研究者可以用它整理论文摘录,通过链接将不同文献的观点交叉引用,配合图谱发现跨学科的研究空白。

  • 长篇内容创作:作家、自媒体博主用它搭建"素材库"------将人物设定、情节片段、灵感金句分别记录,通过链接快速组合成文章或书籍大纲。

  • 软件开发和项目管理:程序员用于撰写技术文档、记录 Bug 解决方案;项目经理可结合插件搭建项目看板,链接会议纪要和需求文档。

  • 个人生活管理:结合日记插件进行每日复盘;利用标签和链接建立健康档案、读书清单、旅行攻略等个人数据库。

  • 终身学习与课堂笔记:学生可以将不同课程、不同学期的知识(如经济学与心理学)通过概念链接打通,构建跨学科思维体系。

总结:

Obsidian 不是一个即开即用的快餐式笔记软件,而是一套需要你投入时间学习,但一旦掌握就能受用终生的知识基建系统。如果你重视数据安全并渴望深度思考,它会是你的理想之选。

三、Obsidian 安装部署

3.1 获取安装包

Obsidian 官网链接:Obsidian - 磨砺你的思维,点击下图中的获取安装包按钮即可下载不同平台的安装包,提供了Windows ,Mac,Linux等不同平台安装包

我这里选择Windows 平台的,下载到本地

3.2 Obsidian 安装过程

Obsidian 的安装比较简单,双击安装包之后只需要点击下一步即可

安装完成后,打开效果如下

3.3 初始化与基本使用

3.3.1 界面基本说明

基于上一步,点击开始使用,来到下面的工作页面,这个也是你开始使用Obsidian 的工作区页面

如果需要对操作界面做一些日常的设置,可以点击右下角的设置图标进行设置,里面提供了丰富的设置

3.3.2 创建文件夹

对使用者来说,平时使用Obsidian 操作最多的当属在下面的工作区创建文件夹,并在文件夹里面创建自己的知识文档了吧,如下,点击加号可以创建出一个文件夹,后续就可以在这里管理各种知识库目录

3.3.3 创建文档

我在Codex 目录下创建一个文档,这里自动为markdown格式的文档

小结:

你只需要将Obsidian 当做一个日常可以管理你的各种分类知识文档的数据库即可,后续将会与AI工具进行联动

四、Codex 操作并使用Obsidian

如何发挥Obsidian 的作用呢,既然Obsidian作为一个本地(云上)知识库,可以存放很多文档,那么就可以作为AI的RAG进行后续的业务操作,下面以Codex 为例进行各类案例的详细说明。

4.1 Codex 连接Obsidian

4.1.1 自然语言对话连接

打开Codex 之后,先问下面的问题,以确保Codex 可以正常读取到Obsidian 的环境以及知识库目录

bash 复制代码
你能读到我本地的Obsidian知识库文档吗

可以看到,Codex 还不能直接读取到我在Obsidian中创建的文档所在的目录,进一步,将文档的知识库路径提供

通过这一步的测试,Codex 能够正确连上本地的Obsidian 知识库目录,接下来就可以做其他的操作了。

4.1.2 Obsidian 安裝插件连接

Obsidian 中安装Claudian插件,

Obsidian 插件可以把 Claude Code、Codex等Al 智能体直接装进 Obsidian 的操作台,它不是大模型本身,而是连接Obsidian笔记库与AI Agent 的桥梁。启用后,你可以在 Obsidian侧栏里直接让AI阅读、搜索、整理、改写和创建笔记;你的知识库会成为AI的工作目录。

它的主要作用包括:

  1. 在笔记库内与Claude Code、Codex、Grok、OpenCode、Pi等Agent 对话。

  2. 让AI搜索、读取、创建和编辑库内文件,完成多步骤任务。

  3. 选中文字后直接要求AI润色或改写,并查看逐词差异预览。

  4. 用 /调用可复用提示词,用 $ 调用自定义Skil,沉淀固定工作流。

  5. 用@引用笔记、外部文件、MCP工具或子智能体。

  6. 支持先制定计划、确认后执行,以及多会话、恢复会话和分支对话。

对于个人知识库课程,可以将它定位为:"让AI真正动手处理Obsidian笔记的工作界面。

需要注意:

它需要在桌面版Obsidian中配合相应的AI CLI和账号使用;发送给AI的提示词、附件和工具执行结果会交给你配置的模型服务处理。涉及批量改写、文件操作或外部工具时,建议始终先查看计划和差异预览。

安装过程,点击Obsidian设置按钮,来到三方插件这里

点击社区插件市场,点击浏览按钮,进入到下方的插件市场,输入Claudian进行搜索

然后点击第一个进入详情页面后点击右侧的安装按钮即可将该插件安装进去,安装完成后,注意点击一下启用

安装完成后,在操作面板的最左侧下方就能看到一个新的图标,打开就可以进入到下方的插件与Codex集成好的对话框了,可以提个问题做个测试

小结:

通过上面这种方式,就开启了一个在Obsidian内部使用Codex 与知识库文档的交互方式,这种方式的好处很明显,不需要在Codex 自己的操作界面上来回切换目录了

4.2 Codex 定时获取AI技术咨询并归档

需求场景描述:

  • 针对每天需要关注的AI模型、产品发布、研究进展和行业应用,使用Codex设计固定的信息搜集流程,并结合电脑的定时任务功能定期运行。搜集结果自动保存到Obsidian,按日期、主题和来源整理,减少重复搜索和复制资料的工作。

需要注意的是,Codex负责设计和执行资料处理流程;真正的定时启动通常还需要Windows任务计划程序、macOS定时任务或其他自动化工具配合。

给出如下需求提示词:

bash 复制代码
请帮我设计一个"每日 AI技术资讯搜集"工作流,点关注大语言模型、多模态模型、AI编程工具和智能体应用。重点来源包括 OpenAI Blog、Anthropic News、Google DeepMind

执行要求:
- 每次搜集最近24小时内发布的新内容
- 记录标题、发布时间、来源、原文链接和核心摘要
- 删除重复信息,并将内容分为"重要动态、一般资讯、待进一步研究"
- 对无法确认真实性的信息标记"待核实"
- 将结果保存到 Obsidian的"AI资讯/每日简报/YYYY-MM-DD.md"
- 在文末列出 3个最值得关注的变化及其可能影响

请先检查当前环境中可以使用的网页访问、定时任务和文件写入能力,然后给出实施方案。先试运行一次并展示结果,经过我确认之后,再帮助我配置为每个工作日早上8:30自动执行。任何涉及登录、订阅、发送信息或修改系统设置的操作,都必须先征得我的确认。

经过一段时间的响应后,已经按照要求将今天的AI咨询信息放在指定的目录下了

同时打开Codex 可以看到里面新增了一条每日简报的定时任务

4.3 基于知识库一键生成可编辑PPT

当我们的知识库文档比较齐全的时候,就可以直接基于知识库的内容做PPT了,场景描述:

让Codex读取项目方案、培训资料、研究报告或工作总结,自动整理演示逻辑并生成可继续修改的PowerPoint文件。生成结果不是图片合集,而是包含可编辑文本、图表和形状的 .pptx 文件,方便后续在PowerPoint或WPS中调整。

通用提示词模板

bash 复制代码
请读取Obsidian中与"[填写演示主题】"相关的笔记,为"[填写听众】"制作一份可编辑的PowerPoint 演示文稿。


制作要求:
- 演示时长约[填写分钟数】分钟,控制在[填写页数】页左右。
- 先提炼演示目标、核心观点和页面大纲,再开始制作。
- 所有事实、数据和案例必须来自知识库,并在备注或最后一页标注来源笔记。
- 结构包含【填写页面结构】。
- 使用【填写视觉风格】。
- 标题、正文、表格、图表和形状必须可以单独编辑。
- 不要把整页内容导出成图片后放入PPT。
- 将最终文件保存为"[填写输出目录]/[填写文件名】.pptx"。

请先检查当前环境是否具备生成和验证 PPTX的能力。如果缺少必要工具,请说明缺少什么,不要生成不可编辑的替代文件。制作完成后,请检查文字量否溢出,页面是否重叠、内容是否缺失,并同时生成一份页面内容清单供我核对。

比如在我的知识库目录下有一个AI分享课程的文档,我现在需要基于这个文档帮我生成一个PPT,给出如下提示词

bash 复制代码
请读取Obsidian中与"【AI智能体】"目录下相关的笔记,制作一份可编辑的PowerPoint 演示文稿。


制作要求:
- 演示时长约[10】分钟,控制在[10】页左右。
- 先提炼演示目标、核心观点和页面大纲,再开始制作。
- 所有事实、数据和案例必须来自知识库,并在备注或最后一页标注来源笔记。
- 结构包含封面、章节目录、AI 发展介绍、学习AI的意义、AI常用工具、案例展示。
- 使用简洁,专业,适合大多数AI小白的汇报风格,采用简约科技风格,背景采用存色。
- 标题、正文、表格、图表和形状必须可以单独编辑。
- 不要把整页内容导出成图片后放入PPT。
- 将最终文件保存在【AI智能体目录下】文件名为"【AI分享课程】.pptx"。

请先检查当前环境是否具备生成和验证 PPTX的能力。如果缺少必要工具,请说明缺少什么,不要生成不可编辑的替代文件。制作完成后,请检查文字量否溢出,页面是否重叠、内容是否缺失,并同时生成一份页面内容清单供我核对。

将上面的提示词输入给Codex

效果还是比较不错的,如果对其中的内容不满意需要调整,可以继续通过对话进行微调

4.4 基于知识库形成个人风格Skill

4.4.1 背景说明

很多作者有了丰富的写作经验之后,都会逐步形成自己的写作风格,比如我们将日常自己写作的文档,笔记或者其他的文章在Obsidian 中,就可以基于Codex 读取这些知识库下的文档,让AI分析内在的写作风格,语气等,从而整理出一套适合自己的Skill,在后续类似场景写文档或文章的时候,AI就可以基于这套风格写出符合预期的文章。

场景描述:

选择一批自己满意的文章、笔记或工作总结作为文风样本,让Codex分析常用语气、句式、结构和表达习惯,并将其整理为可重复使用的个人文风Skill。以后生成或润色笔记时,可以统一使用这套表达风格。

提示词模板:

bash 复制代码
请读取"【填写文风样本目录】"中的笔记,分析并总结我的个人写作风格

请重点分析:
- 常用的文章结构和段落长度。
- 标题、开头和结尾的写法
- 语气是正式、自然、克制还是强调观点。
- 常用词语、句式和过渡方式。
- 我通常如何解释复杂概念和举例。
- 应该避免的表达方式、套话和明显的AI腔。

请先输出一份"个人文风说明书",并分别展示"原始表达、普通润色、按照我的文风润色"的对比例子。不需要我确认直接创建一个名为 "personal-write-style"的自定义Skill。

这个Ski11应当用于新笔记生成和旧笔记润色,但不得修改事实、数据、引用、专有名词和原文观点。以后调用时,如果输入内容不足,应当先向我提问,不要自行补充事实。

4.4.2 案例操作演示

如下,在我的Obsidian 知识库目录下,我存储了好几篇与Codex 相关的文章

基于这个知识库目录,按照上面的提示词模板,给出下面的完整提示词内容

bash 复制代码
请读取"Codex 系列文档"目录中的笔记,分析并总结我的个人写作风格。

请重点分析:
- 常用的文章结构和段落长度。
- 标题、开头和结尾的写法
- 语气是正式、自然、克制还是强调观点。
- 常用词语、句式和过渡方式。
- 我通常如何解释复杂概念和举例。
- 应该避免的表达方式、套话和明显的AI腔。


请先输出一份"个人文风说明书",并分别展示"原始表达、普通润色、按照我的文风润色"的对比例子。经过我确

这个Ski11应当用于新笔记生成和旧笔记润色,但不得修改事实、数据、引用、专有名词和原文观点。以后调月

通过输出日志不难看出,Codex 会先读取知识库目录下的文档,并对里面的文档内容进行详细的分析,整理出这些文档的写作风格,写作语气,内容排版等,最后形成我要求的那个skill

最后使用上面创建出来的skill写一篇文档,看看效果

bash 复制代码
基于上面这个skill 帮我写一篇适合AI小白学习Codex 的学习计划文档,控制在2000字以内,生成的文档放在【Codex 系列文档】目录下

检查最终的结果,确实是按照上面其他文档中的个人风格的效果

4.5 Obsidian白板构建项目知识地图

4.5.1 Obsidian 白板说明

Obsidian 中提供了一个强大的功能,叫知识图谱,通过这个功能,用户可以快速的搞清楚知识库目录下各个文档的联系,相当于是一个全文索引一样,便于你快速查找到需要检索的那个文档

在真实的业务场景中,有很多知识图谱的场景,比如物流关系图,血缘关系图,人员关系图谱等,通过这些网状图,很快能理清楚它们之间的内在联系

场景分析:

  • 让AI助手分析某个主题或项目下的多篇笔记,再通过Obsidian白板将相关笔记、核心概念和行动事项连接起来,形成可以直观看懂的知识地图、项目全景图或学习路径。

提示词模板

bash 复制代码
请围绕"【填写主题或项目名称】"分析当前 Obsidian知识库中的相关笔记,并为我创建一张 Obsidian白板。

白板要求:
-将"[填写核心主题】"放在中央。
- 按"[填写分组一]、[填写分组二]、[填写分组三】、[填写分组四]"进行分组。
- 优先使用笔记卡片并链接到原始笔记,不要复制大段正文。
- 用连接线表达笔记之间的因果、补充、冲突、先后顺序或从属关系。
- 对没有可靠关联的笔记不要强行连接。
- 使用不同颜色区分资料、结论、问题和行动事项。
- 将白板保存到"[填写白板保存路径】.canvas"。

请先列出准备加入白板的笔记、分组方式和连接关系,不需要我确认直接创建或修改白板。如果目标白板已经存在,请保留原有内容,并先展示增量更新方案。

4.5.2 案例操作演示

如下,在我的知识库目录下有下面一些关于Codex 相关的文档,现在使用白板功能构建知识库地图

基于上述的提示词模板给出下面完整提示词

bash 复制代码
请围绕"【Codex 技能学习】"分析当前 Obsidian知识库中的相关笔记,并为我创建一张 Obsidian白板。

白板要求:
-将"【Codex 技能学习】"放在中央。
- 按"[Codex 基础认知]、[环境部署]、[Codex 使用技巧]、[使用场景]、[使用案例]"进行分组。
- 优先使用笔记卡片并链接到原始笔记,不要复制大段正文。
- 用连接线表达笔记之间的因果、补充、冲突、先后顺序或从属关系。
- 对没有可靠关联的笔记不要强行连接。
- 使用不同颜色区分资料、结论、问题和行动事项。
- 将白板保存到"[填写白板保存路径】.canvas"。

请先列出准备加入白板的笔记、分组方式和连接关系,不需要我确认直接创建或修改白板。如果目标白板已经存在,请保留原有内容,并先展示增量更新方案。

将上述提示词投给Codex,通过输出日志可以看到,Codex 会先读取知识库目录中与需求相关的文档内容,找出文档之间的关联关系,最后列出关系并汇总出一个完整的知识图谱,通过这个知识图谱,可以很快理清与Codex 技能学习相关的知识点的分布信息,并在可以直接链接到源文档中

五、写在文末

本文详细介绍了如何使用Codex 操作本地知识库Obsidian 的详细过程,并通过案例操作演示了具体的流程,希望对看到的同学有用哦,更深入的还可以基于此继续深入研究,本篇到此结束感谢观看。