我用 Obsidian 直接编辑这个 Hugo 博客,文章都放在仓库的 content/post/ 下。看到一条介绍 obsidian-skills 的帖子,我想知道能不能直接用在这个库上,尤其是那条安装命令到底该在哪里跑。原帖
这套技能装给 Codex 用。Obsidian 的笔记库(vault)是磁盘上的一个文件夹,在 Codex 里打开同一个文件夹,就可以让它按 Obsidian 的格式处理文件。比如我有几篇 Django 源码笔记,可以在 Codex 里请它把文章放到同一张画布上,再回 Obsidian 顺着连线读原文。这个用法直接读写文件,用不到 Obsidian CLI。Obsidian Skills 官方仓库
把技能装到 Codex
用 Codex 桌面端,可以从插件目录安装 Obsidian 插件。如果想用帖子里的终端命令,下面是指定安装给 Codex 的写法。两种方式选一种即可。
命令行安装工具要求 Node.js 22.20 或更高版本。打开系统终端,用 node -v 查看本机版本。下面这条是全局安装命令,在任意目录都可以运行。
|
|
-a codex 指定使用技能的工具,-g 表示给当前用户安装,以后用 Codex 打开其他笔记库也能用。如果只想在一个库里试,先在终端进入那个库的根目录,再去掉 -g。安装时如果提示选择技能,下面的画布示例选 json-canvas。要整理 Markdown 笔记,还可以选 obsidian-markdown。skills 命令说明
用上面的全局命令安装后,运行 npx skills list -g,在输出里找 json-canvas。如果选的是项目安装,就在库根目录运行 npx skills list。
把两篇 Django 笔记连成一张画布
装好插件或技能后,在 Codex 里打开笔记库的根目录作为项目,然后开一个新对话。我的项目根目录下可以直接看到 content/ 和 .obsidian/。
这个博客里有两篇适合放在一起读的文章。一篇从 manage.py runserver 讲开发服务器怎样启动,另一篇从 WSGIHandler.__call__ 讲请求怎样交给 Django 处理。画布上可以给每个入口配一张原文卡片,顺着流程读到哪里,就点开哪篇。runserver 启动笔记 · WSGIHandler 笔记
在 Codex 对话里可以直接这样写。换一组笔记时,把路径和卡片标题换成自己的就行。
读取
content/post/django/core-runserver-2-run.md和content/post/django/core-handlers-base.md,用 json-canvas 在库根目录新建Django 请求流程.canvas。左边放“启动开发服务器”,右边放“处理一次请求”,各用一张文字卡片概括文章里提到的入口函数。把两篇原文各放成一张文件卡片,连到对应的文字卡片。只新增画布,保留原文。
完成后,在 Obsidian 左侧文件列表打开 Django 请求流程.canvas。先看左右两侧是否分清了启动过程和请求过程,再打开右侧的文件卡片,看看能否读到原文中的 WSGIHandler。如果文件卡片提示找不到笔记,先核对卡片引用的路径。这个例子里路径从库根目录的 content/ 开始。如果 Codex 打开的是更深的一层,生成的引用就可能少一截。Canvas 文件卡片说明
同样的用法也适合做文章目录。想按日期找旧稿,可以安装时再选 obsidian-bases,然后让 Codex “在库根目录创建 文章目录.base,只列出 content/post/ 下的 Markdown 文章,显示 title、date 和 categories,按日期倒序”。在 Obsidian 启用核心插件 Bases 后,打开这个文件就能看到表格。表格里的字段来自各篇文章开头的 YAML 属性,以后调整文章日期,视图也会随之更新。Obsidian Bases 文档
什么时候需要 Obsidian CLI
上面的例子都给出了文件路径。如果我想说“总结我现在打开的这篇笔记”,Codex 就需要向 Obsidian 查询窗口当前选中的文件。这时可以选用 obsidian-cli 技能,并在桌面端启用它要调用的命令行工具。
我这台 Mac 上的 Obsidian 安装器版本是 1.5.12。官方要求使用 1.12.7 或更高版本的安装器来配置 CLI。遇到这种情况,可以从官网下载安装新版,打开原有笔记库,在 设置 → 通用 → Command line interface 启用并按提示注册。然后选中一篇容易认出的笔记,新开一个终端,运行下面两条命令。Obsidian 下载 · CLI 配置与命令说明
|
|
第一条显示版本,第二条读取目标库当前选中的文件。如果同时打开了多个库,可以显式指定库名,例如 obsidian vault="我的笔记" read,把引号里的名字换成自己的库名。等终端读到的正文和窗口里选中的笔记对上,就可以在 Codex 里说“用 Obsidian CLI 读我当前打开的笔记,帮我归纳成三点”。