ratiger_obsidian-banyan/docs/README_zh.md

Banyan - 你的obsidian主页，更好地组织、浏览和回顾笔记

English | 简体中文

改动日志

这插件能干啥？

比方你想找某个特定主题的笔记，或者想看看最近写了什么，或者想随机翻翻以前的笔记。Banyan 就是干这个的。

创建笔记的时候，你只需要记录内容，打上标签，无需绞尽脑汁想一个凝练但又不丢失细节的标题，也无需层层展开目录以寻找其应存放的位置。
通过筛选功能强大的卡片视图面板轻松访问过往笔记。
这尤其适用于习惯记录短篇幅笔记的用户。
创建自定义随机回顾，定向翻出吃灰笔记。

主要功能

🃏 卡片视图 - 一眼看遍所有笔记

• 把你的笔记变成一张张卡片，内容、标签一目了然
• 支持单列或双列显示，看你的屏幕大小
• 右键卡片可以快速打开、删除、置顶等操作

🏷️ 复合筛选 - 想找啥就找啥

• 按标签找：支持多标签筛选，比如，学习 和 重要的笔记，音乐 或 电影的笔记
• 按时间找：查看某个时间段的笔记
• 按内容找：在笔记正文里搜索关键词

💾 保存筛选条件 - 一次设置，重复使用

• 常用的筛选条件可以保存下来，下次直接点一下就能用
• 比如"工作笔记"、"学习资料"、"待办事项"等

🎲 随机回顾 - 重新发现旧笔记

• 随机打开笔记，重新发现被遗忘的好内容
• 可以限定范围，比如只看标签读书笔记的
• 甚至还可以开启乱序浏览，与各个时期的自己再次相遇

📊 热图统计 - 看看你的写作习惯

• 用热图显示你什么时候写的笔记最多
• 帮你了解自己的写作规律

怎么用？

笔记面板，浏览卡片笔记

• 用户可以设置笔记目录，本插件只会管理该目录下的所有笔记。
• 该目录下笔记和子目录存放结构不再紧要。
• 已有笔记迁移到该目录之下，即可受本插件管理。
• 点击左边栏的图标，或通过Ctrl/Cmd + P命令，打开笔记面板

添加新笔记

• 在桌面端的面板中，可通过编辑区创建笔记。
• 点击左边栏的灯泡图标，或者通过 Ctrl/Cmd + P命令，打开新的笔记。
• 笔记与一般的obsidian笔记无异，但属性栏里多了2个东西：
  • 一是标签tags，可以在这输入标签，也可以在笔记正文中输入标签，它们都会显示在卡片视图的标签行中。
  • 二是id，请不要改动它，这是想实现预期效果不得已的做法

随机回顾

• 可以在面板视图的侧边栏增加或修改随机回顾项，左边栏也会对应新增图标
• 点击随机回顾项，或左边栏随机回顾的图标，可打开本插件目录下、符合标签筛选条件的笔记。

插件设置

• 笔记目录：默认为 cards，避免与现有目录冲突。
• 启动时自动打开面板：开启后 Obsidian 启动即打开卡片面板。
• 笔记列数：在桌面端可选择单列或双列显示。
• 是否显示标题
• 卡片内容最大高度：较短 / 一般 / 不折叠。
• 显示反向链接：在卡片底部显示引用当前笔记的链接。
• 双击进入编辑模式（桌面端）：卡片双击直接切换到编辑视图。

安装

方法一：从 Obsidian 插件社区安装（推荐）

1. 打开 Obsidian 设置
2. 找到"第三方插件"
3. 关闭"安全模式"
4. 点击"浏览"，搜索"Banyan"
5. 安装并启用

方法二：手动安装

1. 从release里下载发布包
2. 解压到 .obsidian/plugins/ 目录
3. 在 Obsidian 设置中启用插件

有问题？

欢迎在 GitHub 上提问题或建议！

或者加入此项目的discord: https://discord.gg/HGCmK8YzaX

许可证

GPLv3 - 详情看 LICENSE 文件