# Home Pages 更新日志

插件仓库：[github.com/jepicaju862-lab/home-pages](https://github.com/jepicaju862-lab/home-pages)。升级只替换 `main.js`、`manifest.json`、`styles.css` 三个文件，布局与数据保存在 `data.json` 中不受影响。

## 0.1.0 — 2026-09-15

首个正式开源版本。

- 最低 Obsidian 版本 1.7.2；支持桌面端与 Obsidian Mobile（iOS / Android）。
- 开源协议 GNU General Public License v3.0。

### 布局引擎

- 12 列自适应网格：随窗口宽度折行与等比缩放，桌面宽屏与手机竖屏均可用。
- 所见即所得编排：拖拽卡片重排；卡片底部按钮调整宽度（1–12 列）与高度（网格行数）；支持复制、前移、后移与删除。
- 多页面：标签栏「+」新建独立首页，支持重命名、复制、排序与删除。
- JSON 导入 / 导出：一键备份完整布局与组件配置，跨设备、跨库迁移。

### 内置组件

- 欢迎横幅：问候语、称呼、时钟、天气（中国气象局国家站免密钥 / Open-Meteo / 和风天气）、库统计徽章、倒计时徽章、背景图。
- 最近笔记：最近修改或创建的笔记列表，支持目录过滤与路径展示。
- 快捷入口：常用笔记与文件夹的图标磁贴，Lucide 图标与路径联想。
- 倒计时与纪念日。
- 番茄时钟：专注 / 休息循环计时，插件后台守护，切页与重启不丢状态；系统通知与提示音。
- 每日一言：从指定笔记提取或使用内置语录。
- 习惯打卡：今日清单 + 周 / 月 / 年 GitHub 风格热力图，支持本地存储或 Daily Note 块同步。
- 任务看板：扫描 `- [ ]` 任务，按待办、进行中、已完成三列分栏，拖拽改状态。
- 全库统计：笔记数、标签数、字数、附件数与库龄等指标。
- 那年今日：回顾往年同月同日创建的笔记。
- 笔记嵌入：直接渲染任意笔记或指定标题下的内容。

### 联动组件

- 待办与日程：读取库内多维表格（`.duowei`）。
- 微信收件箱：聚合 WeChat2Ob 消息。
- 批注与复习：对接 Mobile Ink Annotation Pro。
- 聚合信息流：合并以上三个来源。

### 宿主 API

- 第三方插件可通过 `registerWidget` 向首页注册自定义组件，`pinWidget` 固定卡片，`refresh` 触发重绘。
- 提供 `renderKpi`、`renderEmpty` 等与内置组件风格一致的 UI 助手。
- Duowei Table Pro ≥ 1.4.0 已借此注册 `duowei-view`，支持在表格视图右键「固定到首页」。

### 安全与质量

- 本地优先，所有数据存于 Vault 的 `data.json`，无遥测。
- 构建时通过 `scripts/verify-bundle.mjs` 强制校验，禁止动态脚本创建、`eval()` 与 `new Function()`。
- 配套 GitHub Actions 工作流：Lint、测试、构建证明（Attestations）与 Releases 发布。