Anniversaries

jinianri

付费 · 48 小时试用 · ¥29.9 永久激活 Obsidian 生日与纪念日插件（LifeOS）。阴历/阳历、侧边栏倒计时、三档提醒、iCal 导出。插件市场显示名：jinianri。 当前公开版本：4.0.20 · 48 小时试用

定价与购买

LifeOS 三插件互跳

同一作者的 LifeOS 系列，可在社区插件里互相打开，或前往 GitHub：

安装

社区插件

设置 → 第三方插件 → 浏览 → 搜索 jinianri → 安装 → 启用。

BRAT

1. 安装并启用 BRAT
2. 添加仓库：

https://github.com/xileshuo/jinianri

3. 启用插件；之后可用 BRAT 检查更新。

手动安装

下载 Latest Release 的 main.js、manifest.json 到 .obsidian/plugins/jinianri/。

使用说明

纪念日插件用于记录生日、恋爱、婚姻等重要日期，自动计算「已过时长」与「距离下次还有几天」，并支持三档全局提醒与 iCal 导出。

---

目录

• 一、插件能做什么
• 二、如何安装
• 三、如何打开侧边栏
• 四、首次使用与激活
• 五、侧边栏使用说明
• 六、设置页说明
• 七、提醒机制
• 八、数据文件说明
• 九、常见问题

---

一、插件能做什么

• 纪念看板：侧边栏分组展示，支持拖动排序
• 阴历 / 阳历：农历日期自动换算当年公历
• 三档提醒：默认提前 30 / 15 / 7 天，可自定义
• Obsidian 弹窗 + 桌面系统通知
• iCal 导出：可导入系统日历
• 笔记嵌入：```jinianri``` 代码块渲染表格看板（随笔记刷新更新）

---

二、如何安装

解压后将 `main.js`、`manifest.json` 等文件放入：

```text 你的库/.obsidian/plugins/jinianri/ ```

然后在 设置 → 第三方插件 中开启「纪念日」，建议重启 Obsidian。

插件目录请使用 `jinianri/`。若库内同时存在 `.obsidian/plugins/纪念日/` 旧目录，请删除以免加载旧版。

个人版 与 公版 标识会显示在：电脑端设置页标题（含版本号，如「纪念日 配置 · 个人版 v4.0.3」）、移动端全屏看板顶栏徽章。公版需激活后使用全部功能；个人版已内置授权。

启动 Obsidian 不会自动弹出 更新日志或使用说明。需要时请手动在侧边栏激活页或 设置 → 第三方插件 → 纪念日 打开。

---

三、如何打开侧边栏

• 点击左侧 Ribbon 的 日历爱心图标
• 或命令面板：打开纪念日侧边栏

移动端若右侧栏不可用，会使用 打开纪念日面板（全屏） 命令或 Ribbon 打开全屏看板。移动端无状态栏倒计时，请用 Ribbon 或上述命令进入看板。

---

四、首次使用与激活

第一次打开侧边栏时，若尚未激活（公版），会进入 初始化向导。

步骤

1. 复制设备专属指纹（形如 `JNR-XXXXXXXX`）
2. 发送给作者，获取专属激活码（形如 `KEY-XXXXXXXX`）
3. 在向导或设置页 输入激活码，点击 验证并激活
4. 激活成功后 永久有效（绑定 Obsidian appId，本设备一次激活）

公版与体验版首次安装预填 3 条示例，可编辑或删除后添加自己的纪念日。仍兼容旧版按库名生成的激活码。

---

五、侧边栏使用说明

侧边栏用于 浏览，增删改在设置页。列表视图底部提示 点击折叠 · 拖动排序 · 点击事项进设置，下方两行 进入 Obsidian 设置 → 纪念日 → 事项 / 可增删改纪念事项（月历、时间轴不显示该提示；移动端首次进入列表会弹 Notice）。

• 顶部统计：全部 / 今天 / 本周 / 本月（按「下次纪念日」落在的时间范围统计）

• 焦点大卡：最近 2 项纪念日倒计时（无标题行）

• 列表 / 时间轴 / 日历：顶部工具栏一行切换（筛选下拉与视图 Tab 同排；移动端侧边栏与桌面一致）

• 筛选：全部 + 各分组（下拉高亮显示）

• 累计天数：类型选「累计天数」显示已经 X 天（如在一起）

• 月历：点日期筛选当日纪念日，可清除筛选

• 点击 / 轻点名称旁箭头区域：折叠 / 展开分组

• 拖动 / 长按分组标题栏：调整分组顺序（含数字区）

• 拖动 / 长按卡片：组内排序或拖到分组标题换组

• 点击 / 轻点卡片：跳转设置 事项 Tab 并定位到该条目

• 即将到期：与已启用的提醒档位联动（至少 7 天），临近事项会置顶显示

增删改纪念事项请进入 设置 → 第三方插件 → 纪念日。

---

六、设置页说明

设置页采用 标签页 + 卡片区块 布局（BrainCore 风格）。未激活公版时，仅 授权 与 数据 可用。

移动端设置页顶部已与 Obsidian 原生顶栏对齐（41px 下沉），显示紧凑版插件标题。

---

七、提醒机制

每天在设定时间检查一次。若当时未打开 Obsidian，首次打开会补发。

当天还会再发「就是今天 🎉」提醒。每条事项可单独关闭提醒。

仅开启 系统通知 时，展示后即视为已提醒，不会重复弹窗。开启 库内弹窗 时，弹窗一出现即记为已提醒（避免关库未点确认导致同日重弹），可按 Esc 或点「知道了」关闭。若当时被设置页挡住没看到，可用设置 → 提醒 →「再弹今天」。

---

八、数据文件说明

路径可在设置 数据 Tab 查看并一键打开。随库 / iCloud 同步。

---

九、常见问题

Q：激活码在哪里输入？

侧边栏初始化向导，或 设置 → 纪念日 → 授权（输入后点 验证激活）。

Q：升级后如何查看更新说明？

更新日志 不会自动弹出。随时可在设置 关于 → 更新日志 手动查看。

Q：完整使用说明在哪里？

本文件即为完整说明。请在侧边栏激活页或设置页点击 打开使用说明 按需打开（不存在则自动生成）。

若你在本文件中自行修改了内容，插件不会覆盖你的编辑；仅当内置说明版本升级且文件仍带版本标记时才会同步更新。

Q：公版有示例数据吗？

公版与 48 小时体验版首次安装 预填 3 条示例纪念事项（生日 / 纪念日 / 恋爱纪念），并非空列表，可编辑或删除后添加自己的。个人版内置个人纪念事项。

Q：插件目录有两个文件夹（jinianri 与 纪念日）？

请只保留 jinianri 文件夹。若存在 `.obsidian/plugins/纪念日/` 旧目录，请删除或禁用，避免加载旧版插件。

---

一句话总结

打开 Obsidian → 点击日历爱心图标 → 激活后管理你的重要日期 → 到点自动提醒，不再错过。

更新日志

4.0.19

• 审核：首启卡改回浏览器 localStorage，去掉高于 minApp 的 App 存储 API（Scorecard no-unsupported-api）

4.0.18

• 审核：去掉设置页 inline !important / 手写 h2（Scorecard Risk）；CSS 去 !important

4.0.17

• 体验：首启 / 套装提示可点「去了解」；提醒重放与导入提示更稳
• 设置：数据文件行布局对齐 LifeOS；手机设置顶距与侧栏一致

4.0.16

• 版本对齐：公版 / 体验包与 LifeOS 同步发布

4.0.15

• 审核：manifest.description 改以英文句号结尾（Scorecard 不认中文 。）

4.0.14

• 设置：体验包激活后标题显示「公版」，不再写「48小时体验版」

4.0.13

• 审核：manifest 英文 description；README 市场名统一为 jinianri；版本对齐

4.0.12

• 市场显示名固定为 jinianri（覆盖社区目录里的 Anniversaries）
• 公开 README：中文在前、英文在后；上传时间轴 / 日历 / 列表截图

---

分发说明

本仓库用于社区插件 / BRAT / GitHub Release 分发与产品介绍，并附带 src/ 等源码便于社区审核。 仓库：https://github.com/xileshuo/jinianri 下方为英文说明（社区审核）。

jinianri

Paid · 48-hour trial · ¥29.9 permanent unlock

Overview

jinianri is a paid LifeOS plugin for birthdays and memorial dates in Obsidian, with lunar/solar calendars, sidebar countdowns, multi-level reminders, and iCal export.

Current public build: 4.0.20 (48-hour trial).

LifeOS family

Companion plugins by the same author — open each other in Community Plugins, or on GitHub:

Pricing

Installation

Community plugins

Settings → Community plugins → Browse → search jinianri → Install → Enable.

BRAT

1. Install and enable BRAT
2. Add this repository:

https://github.com/xileshuo/jinianri

3. Enable the plugin; use BRAT to check for updates later.

Manual install

Download main.js and manifest.json from the Latest Release into .obsidian/plugins/jinianri/.

Usage

1. Enable jinianri and open it from the left ribbon (or the command palette).
2. Start the 48-hour trial from the in-plugin activation panel when prompted.
3. Use the sidebar / main panel for daily work; full help is also available inside Settings → Usage guide.
4. After the trial ends, copy your device fingerprint and unlock with a purchased activation code.

Links

• Author: https://github.com/xileshuo
• Repository: https://github.com/xileshuo/jinianri
• Buy / support: Xiaohongshu (contact the author for an activation code)