<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>Codex on Ricardo</title>
        <link>https://sona201.github.io/tags/codex/</link>
        <description>Recent content in Codex on Ricardo</description>
        <generator>Hugo -- gohugo.io</generator>
        <language>zh-cn</language>
        <lastBuildDate>Mon, 23 Nov 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://sona201.github.io/tags/codex/index.xml" rel="self" type="application/rss+xml" /><item>
        <title>用 Codex 整理 Obsidian 笔记：从安装技能到画出第一张 Canvas</title>
        <link>https://sona201.github.io/posts/obsidian-skills-with-codex/</link>
        <pubDate>Mon, 23 Nov 2026 00:00:00 +0800</pubDate>
        
        <guid>https://sona201.github.io/posts/obsidian-skills-with-codex/</guid>
        <description>&lt;p&gt;我用 Obsidian 直接编辑这个 Hugo 博客，文章都放在仓库的 &lt;code&gt;content/post/&lt;/code&gt; 下。看到一条介绍 &lt;code&gt;obsidian-skills&lt;/code&gt; 的帖子，我想知道能不能直接用在这个库上，尤其是那条安装命令到底该在哪里跑。&lt;a class=&#34;link&#34; href=&#34;https://x.com/0xluffy_eth/status/2120807829699535162&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;原帖&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;这套技能装给 Codex 用。Obsidian 的笔记库（vault）是磁盘上的一个文件夹，在 Codex 里打开同一个文件夹，就可以让它按 Obsidian 的格式处理文件。比如我有几篇 Django 源码笔记，可以在 Codex 里请它把文章放到同一张画布上，再回 Obsidian 顺着连线读原文。这个用法直接读写文件，用不到 Obsidian CLI。&lt;a class=&#34;link&#34; href=&#34;https://github.com/obsidianmd/obsidian-skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;Obsidian Skills 官方仓库&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;把技能装到-codex&#34;&gt;把技能装到 Codex&lt;/h2&gt;
&lt;p&gt;用 Codex 桌面端，可以从插件目录安装 &lt;a class=&#34;link&#34; href=&#34;https://chatgpt.com/plugins/plugins_6aee4fde227881919d61b034b1c31096&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;Obsidian 插件&lt;/a&gt;。如果想用帖子里的终端命令，下面是指定安装给 Codex 的写法。两种方式选一种即可。&lt;/p&gt;
&lt;p&gt;命令行安装工具要求 Node.js 22.20 或更高版本。打开系统终端，用 &lt;code&gt;node -v&lt;/code&gt; 查看本机版本。下面这条是全局安装命令，在任意目录都可以运行。&lt;/p&gt;
&lt;div class=&#34;code-block&#34;&gt;
    &lt;div class=&#34;code-block__header&#34;&gt;&lt;span class=&#34;code-block__language&#34;&gt;Bash&lt;/span&gt;&lt;/div&gt;
    &lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;
&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;npx skills add https://github.com/obsidianmd/obsidian-skills -a codex -g
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;&lt;code&gt;-a codex&lt;/code&gt; 指定使用技能的工具，&lt;code&gt;-g&lt;/code&gt; 表示给当前用户安装，以后用 Codex 打开其他笔记库也能用。如果只想在一个库里试，先在终端进入那个库的根目录，再去掉 &lt;code&gt;-g&lt;/code&gt;。安装时如果提示选择技能，下面的画布示例选 &lt;code&gt;json-canvas&lt;/code&gt;。要整理 Markdown 笔记，还可以选 &lt;code&gt;obsidian-markdown&lt;/code&gt;。&lt;a class=&#34;link&#34; href=&#34;https://github.com/vercel-labs/skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;skills 命令说明&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;用上面的全局命令安装后，运行 &lt;code&gt;npx skills list -g&lt;/code&gt;，在输出里找 &lt;code&gt;json-canvas&lt;/code&gt;。如果选的是项目安装，就在库根目录运行 &lt;code&gt;npx skills list&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id=&#34;把两篇-django-笔记连成一张画布&#34;&gt;把两篇 Django 笔记连成一张画布&lt;/h2&gt;
&lt;p&gt;装好插件或技能后，在 Codex 里打开笔记库的根目录作为项目，然后开一个新对话。我的项目根目录下可以直接看到 &lt;code&gt;content/&lt;/code&gt; 和 &lt;code&gt;.obsidian/&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;这个博客里有两篇适合放在一起读的文章。一篇从 &lt;code&gt;manage.py runserver&lt;/code&gt; 讲开发服务器怎样启动，另一篇从 &lt;code&gt;WSGIHandler.__call__&lt;/code&gt; 讲请求怎样交给 Django 处理。画布上可以给每个入口配一张原文卡片，顺着流程读到哪里，就点开哪篇。&lt;a class=&#34;link&#34; href=&#34;https://sona201.github.io/posts/django-runserver/&#34; &gt;runserver 启动笔记&lt;/a&gt; · &lt;a class=&#34;link&#34; href=&#34;https://sona201.github.io/posts/django-wsgihandler/&#34; &gt;WSGIHandler 笔记&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;在 Codex 对话里可以直接这样写。换一组笔记时，把路径和卡片标题换成自己的就行。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;读取 &lt;code&gt;content/post/django/core-runserver-2-run.md&lt;/code&gt; 和 &lt;code&gt;content/post/django/core-handlers-base.md&lt;/code&gt;，用 json-canvas 在库根目录新建 &lt;code&gt;Django 请求流程.canvas&lt;/code&gt;。左边放“启动开发服务器”，右边放“处理一次请求”，各用一张文字卡片概括文章里提到的入口函数。把两篇原文各放成一张文件卡片，连到对应的文字卡片。只新增画布，保留原文。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;完成后，在 Obsidian 左侧文件列表打开 &lt;code&gt;Django 请求流程.canvas&lt;/code&gt;。先看左右两侧是否分清了启动过程和请求过程，再打开右侧的文件卡片，看看能否读到原文中的 &lt;code&gt;WSGIHandler&lt;/code&gt;。如果文件卡片提示找不到笔记，先核对卡片引用的路径。这个例子里路径从库根目录的 &lt;code&gt;content/&lt;/code&gt; 开始。如果 Codex 打开的是更深的一层，生成的引用就可能少一截。&lt;a class=&#34;link&#34; href=&#34;https://github.com/obsidianmd/obsidian-skills/blob/main/plugins/obsidian/skills/json-canvas/SKILL.md&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;Canvas 文件卡片说明&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;同样的用法也适合做文章目录。想按日期找旧稿，可以安装时再选 &lt;code&gt;obsidian-bases&lt;/code&gt;，然后让 Codex “在库根目录创建 &lt;code&gt;文章目录.base&lt;/code&gt;，只列出 &lt;code&gt;content/post/&lt;/code&gt; 下的 Markdown 文章，显示 &lt;code&gt;title&lt;/code&gt;、&lt;code&gt;date&lt;/code&gt; 和 &lt;code&gt;categories&lt;/code&gt;，按日期倒序”。在 Obsidian 启用核心插件 Bases 后，打开这个文件就能看到表格。表格里的字段来自各篇文章开头的 YAML 属性，以后调整文章日期，视图也会随之更新。&lt;a class=&#34;link&#34; href=&#34;https://help.obsidian.md/bases&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;Obsidian Bases 文档&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;什么时候需要-obsidian-cli&#34;&gt;什么时候需要 Obsidian CLI&lt;/h2&gt;
&lt;p&gt;上面的例子都给出了文件路径。如果我想说“总结我现在打开的这篇笔记”，Codex 就需要向 Obsidian 查询窗口当前选中的文件。这时可以选用 &lt;code&gt;obsidian-cli&lt;/code&gt; 技能，并在桌面端启用它要调用的命令行工具。&lt;/p&gt;
&lt;p&gt;我这台 Mac 上的 Obsidian &lt;strong&gt;安装器版本&lt;/strong&gt;是 &lt;code&gt;1.5.12&lt;/code&gt;。官方要求使用 &lt;code&gt;1.12.7&lt;/code&gt; 或更高版本的安装器来配置 CLI。遇到这种情况，可以从官网下载安装新版，打开原有笔记库，在 &lt;strong&gt;设置 → 通用 → Command line interface&lt;/strong&gt; 启用并按提示注册。然后选中一篇容易认出的笔记，新开一个终端，运行下面两条命令。&lt;a class=&#34;link&#34; href=&#34;https://obsidian.md/download&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;Obsidian 下载&lt;/a&gt; · &lt;a class=&#34;link&#34; href=&#34;https://help.obsidian.md/cli&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;
    &gt;CLI 配置与命令说明&lt;/a&gt;&lt;/p&gt;
&lt;div class=&#34;code-block&#34;&gt;
    &lt;div class=&#34;code-block__header&#34;&gt;&lt;span class=&#34;code-block__language&#34;&gt;Bash&lt;/span&gt;&lt;/div&gt;
    &lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;
&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1
&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;
&lt;td class=&#34;lntd&#34;&gt;
&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;obsidian version
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;obsidian &lt;span class=&#34;nb&#34;&gt;read&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;p&gt;第一条显示版本，第二条读取目标库当前选中的文件。如果同时打开了多个库，可以显式指定库名，例如 &lt;code&gt;obsidian vault=&amp;quot;我的笔记&amp;quot; read&lt;/code&gt;，把引号里的名字换成自己的库名。等终端读到的正文和窗口里选中的笔记对上，就可以在 Codex 里说“用 Obsidian CLI 读我当前打开的笔记，帮我归纳成三点”。&lt;/p&gt;
</description>
        </item>
        
    </channel>
</rss>
