中文文档 | English
Yearly Glance 是一款 Obsidian 年度事件一览插件，帮助你高效规划、回顾和管理全年的重要日期，支持高度自定义和多种事件类型。
- 🗓️ 年度日历视图：一屏尽览全年日历，年度规划一目了然
- 🎉 多事件类型：支持节日、生日、自定义事件等
- 🎂 生日管理：记录年龄、生肖、星座等属性
- 🎨 高度可定制：多种布局与配色风格，支持 emoji
- 🖱️ 交互界面：点击即可查看和编辑事件
- 🔍 事件筛选：按类型过滤、隐藏空日期
- 🌙 农历支持：原生支持中国农历
- 🌏 多语言：支持简繁中文和英文语言
- 📄 笔记事件：使用带有 frontmatter 属性的笔记作为事件来源，支持 Bases 集成实现高级筛选。了解更多
Yearly Glance 支持多种事件来源，你可以根据不同使用场景选择合适的存储方式：
| 来源 | 存储位置 | 适合场景 |
|---|---|---|
| 插件事件 | 插件数据 | 快速管理节日、生日和自定义事件 |
| 笔记事件 | 笔记 frontmatter | 需要独立笔记、详细正文、链接或附件的事件 |
| 日记事件 | 日记 frontmatter | 和 Daily Notes、日记工作流绑定的事件 |
| Bases 视图 | .base 查询结果 |
嵌入笔记内、根据条件筛选事件 |
关于 frontmatter 配置和 Bases 集成，请查看笔记事件文档。
列表视图
灵活的事件列表管理界面
日历视图
经典日历布局，直观查看全年事件
事件过滤
按类型筛选，隐藏空日期，支持高亮显示重要事件
查看和编辑事件
便捷的事件编辑窗口
- 点击左侧边栏🔭望远镜图标
- 或使用命令面板搜索“打开年度概览”
- 或使用快捷键（如已设置）
- 不同颜色代表不同事件类型
- 点击事件查看详情
- 点击 🗂️ 管理按钮打开事件管理器查看所有事件
- 通过命令面板选择“管理事件”，点击右上角 ➕ 按钮添加
- 或者直接在概览视图中将鼠标移到指定日期，点击出现的
+按钮 - 你也可以在命令面板中选择“添加事件”
- 通过命令面板打开事件管理器
- 在事件详情弹窗中点击 📍定位 按钮，将事件固定在事件管理器中
- 编辑：点击事件（在管理器或详情弹窗）中的 ✏️ 编辑 按钮，修改信息后保存
- 删除：点击事件（在管理器）中的 🗑️ 删除 按钮
事件管理界面.
在概览的顶部，有多个显示选项：
- 显示/隐藏节日、生日、自定义事件
- 切换到年度一览（推荐）、经典日历或自定义视图
- 仅限列表视图：
- 限制列表高度
- 隐藏无事件的日期
更多设置可以在插件设置中查看。
- 从 最新发布页 下载
yearly-glance.zip - 解压到你的 Obsidian 仓库的插件文件夹内：
<仓库路径>/.obsidian/plugins/yearly-glance/ - 重启 Obsidian 并在设置-社区插件中启用
- 安装 BRAT 插件
- 在 BRAT 设置中“添加 Beta 插件”，输入
Moyf/yearly-glance - 启用插件
- 克隆本仓库
- 确保 NodeJS 版本 ≥ 18 (
node --version) - 安装依赖：
npm i或yarn - 开启开发模式：
npm run dev - 构建插件：
npm run build - 构建并复制到你的 Obsidian 仓库（需要
.env文件，包含VAULT_PATH=/path/to/your/vault）：npm run build:local - 更新版本和更新清单：
npm run version - 发布新版本：
npm run release
- 有问题或建议请 提交 Issue
- 参与讨论：Discussions
- 欢迎 PR 贡献！详见 CONTRIBUTING 文档
MIT License，详见 LICENSE
如果喜欢本插件，可以加个⭐️星星表示支持！