# jinianri
> **付费 · 48 小时试用 · ¥29.9 永久激活**
Obsidian 生日与纪念日插件（LifeOS）。阴历/阳历、侧边栏倒计时、三档提醒、iCal 导出。插件市场显示名：jinianri。
当前公开版本：**4.0.20 · 48 小时试用**
## 定价与购买
| 项目 | 说明 |
| --- | --- |
| **试用** | 插件内开启后 48 小时全功能 |
| **付费** | ¥29.9 一次付费，按设备指纹永久激活 |
| **购买** | 小红书联系作者下单 → 复制设备指纹 → 粘贴激活码 |
作者：[github.com/xileshuo](https://github.com/xileshuo) · 小红书：[下单入口](https://xhslink.com/m/3uOoUHv2rI1)
## LifeOS 三插件互跳

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

| 插件 | 社区插件（已上架后） | GitHub |
| --- | --- | --- |
| **BrainCore LifeOS** | [打开插件页](obsidian://show-plugin?id=braincore-lifeos) · 搜索 `BrainCore LifeOS` | [BrainCore LifeOS](https://github.com/xileshuo/BrainCore-LifeOS) |
| **PlainLedger** | [打开插件页](obsidian://show-plugin?id=plain-ledger) · 搜索 `PlainLedger` | [PlainLedger](https://github.com/xileshuo/plain-ledger-obsidian) |
| **jinianri** | [打开插件页](obsidian://show-plugin?id=jinianri) · 搜索 `jinianri` | [jinianri](https://github.com/xileshuo/jinianri) |
## 安装

### 社区插件

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

### BRAT

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

```text
https://github.com/xileshuo/jinianri
```

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

### 手动安装

下载 [Latest Release](https://github.com/xileshuo/jinianri/releases/latest) 的 `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 风格）。未激活公版时，仅 **授权** 与 **数据** 可用。

| Tab | 内容 |
|-----|------|
| **授权** | 设备指纹、激活码、验证并激活、打开使用说明（公版） |
| **提醒** | 三档提前天数、Obsidian 弹窗 / 系统通知、每日检查时间、测试提醒 |
| **事项** | 分组管理、表格编辑（emoji + 名称）、导入 \`纪念日.md\`、导出 iCal |
| **通用** | 状态栏开关、看板视图说明、笔记嵌入代码 \`\`\`jinianri\`\`\` |
| **数据** | 打开 \`data.json\` / \`events.json\` |
| **关于** | 更新日志、使用说明、作者与套装作品 |

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

---

## 七、提醒机制

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

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

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

---

## 八、数据文件说明

| 文件 | 内容 |
|------|------|
| \`data.json\` | 提醒档位、分组、激活状态等设置 |
| \`events.json\` | 全部纪念事项 |

路径可在设置 **数据** 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:

| Plugin | Community (after listed) | GitHub |
| --- | --- | --- |
| **BrainCore LifeOS** | [Open plugin page](obsidian://show-plugin?id=braincore-lifeos) · search `BrainCore LifeOS` | [BrainCore LifeOS](https://github.com/xileshuo/BrainCore-LifeOS) |
| **PlainLedger** | [Open plugin page](obsidian://show-plugin?id=plain-ledger) · search `PlainLedger` | [PlainLedger](https://github.com/xileshuo/plain-ledger-obsidian) |
| **jinianri** | [Open plugin page](obsidian://show-plugin?id=jinianri) · search `jinianri` | [jinianri](https://github.com/xileshuo/jinianri) |

## Pricing

| Item | Details |
| --- | --- |
| Install | Free from Community Plugins (when listed), BRAT, or GitHub Releases |
| Trial | Start a **48-hour full trial** inside the plugin |
| Unlock | **¥29.9** one-time payment, permanent activation per device fingerprint |
| Purchase | Contact the author on Xiaohongshu → pay → paste your device fingerprint → receive an activation code |

## Installation

### Community plugins

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

### BRAT

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

```text
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](https://github.com/xileshuo/jinianri/releases/latest) 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)