介绍

Context Cat 是一款提供聚合功能的 obsidian 插件。它可以根据你设定好的标题进行指定范围的抓取内容，并聚合到当前你输入指令的页面。

安装和使用

安装

进入 https://github.com/yiyang-fairy/obsidian-context/releases/ 页面，选择最新的版本 进行下载。

两种方式：

• 下载压缩包并解压到你的 **\.obsidian\plugins\ 文件夹中，打开项目根目录，命令行输入

npm install

npm run dev

再重启 obsidian 即可正常使用

• 在你的 **\.obsidian\plugins\ 文件夹中创建一个contextCat文件夹（也可以定义为别的名字），将main.js，manifest.json 和 style.css 这三个文件下载到你创建好的**\.obsidian\plugins\contextCat\ 文件夹中，再重启 obsidian 即可正常使用

使用

聚合标题

打开一个空白页面，在页面上以一级标题的形式写下你想要聚合的二级标题，（当你没有输入一级标题的时候，会以你当前文件的文件名作为一级标题）例如： 接下来，有两个方法聚合标题

方法一：

点击左侧猫猫头图标即可聚合你想要的二级标题

方法二：

按 Ctrl+P（或 Cmd+P 在 macOS 上）打开命令面板，并输入 Context Cat: Aggregate current context 按下回车即可

然后你就能看到所有你想要聚合标题和内容了： 在这里还展示了对应的文章标题，方便你回到原文查看

聚合 Tag

首先在当前页面顶部输入 --- 调出文档属性，

在属性栏添加 key 为 catTags， value 为你想要聚合的 tag，如果你想聚合多个 tag，可以将 catTags 属性类型设为 list ，也可以设置 catTags 属性类型为 text， 然后使用 & 连接他们，例如：

接下来，同聚合标题的方法一样，点击左侧 猫猫头 或者打开命令面板输入 Context Cat 来进行聚合，结果示例：

注意

聚合标题与聚合 tag 只能二者选其一，并且聚合 tag 的优先级高于聚合标题

设置

设置文件夹筛选范围

点击 obsidian 的设置，再点击第三方插件下的 Context Cat，可以看到：

在这里，你可以对文件的筛选范围做限定，并且为你提供了两种筛选文件夹的方式：

以文件夹选择的方式

点击下拉框， 可以看到你的所有文件夹，选择你想要筛选的文件夹，之后的筛选范围则只会是你筛选的文件夹

以 glob 模式匹配

在右侧输入框中输入 glob 模式的文件路径，例如输入 /**/!(assets)/** ，则后续对文件的筛选会跳过 assets 文件夹；输入 `/diaries/*/ 则只在根目录下的 diaries 文件夹中进行筛选

文档属性

在页面顶部输入 --- 调出文档属性，对于我们 Context Cat 插件，我们提供了一些特殊的字段来增加额外的功能。 例如上文中用到过的 catTags 字段用来聚合 tag，除此之外，还有 catAutoUpdate 等字段，接下来一一介绍：

catTags

catTags 可以是 list 类型或者是 text 类型，表示的是你想要聚合的 tag 名称，当类型为 list 时，可直接添加多个；当类型为 text 时，可以用 & 连接来获取多个 tag

catAutoUpdate

每次进入页面都需要使用命令或点击猫猫头来实现聚合，这样是否还是不够方便？

只要在文档属性里设置 catAutoUpdate 为 true 即可自动更新

该字段建议将类型设置为 checkbox 类型或者 text 类型，它的值为 true 或 false，未设置时默认为 false 。表示的是在打开带有 catAutoUpdate 文档属性的文件时，是否自动执行聚合功能

最后

插件仍在更新中，欢迎提出建议☺