1.5.0

Academic RSS Reader v1.5.0

简体中文 | English

This feature release adds native graphical abstracts from RSS and Atom feeds.

What is new

1. Graphical abstracts are extracted from item-level media fields, image
   enclosures, Atom enclosures, or images embedded in feed summaries. The
   plugin does not fetch article pages.
2. Paper cards use a stable content-and-image layout with lazy loading,
   load-failure fallback, and an image-size-aware preview modal.
3. Titles reserve three lines, support selectable text, and render delimited
   LaTeX fragments through Obsidian's native MathJax.
4. Subscription management uses one journal field, repairs malformed legacy
   OPML metadata when possible, and presents cleaner subscription and
   analytics tables.

Database upgrade

Schema 5 adds the nullable items.image_url column. Existing images are not
downloaded or backfilled. A v3 database upgrades through v4 and then v5; a v4
database applies only v5. The existing protection backup and rollback process
remains in effect.

Important

Requires desktop Obsidian 1.13.0 or later. If the bundled runtime is
incompatible, update Obsidian and try again.

Install only main.js, manifest.json, and styles.css from the GitHub
Release.

1.4.1

Academic RSS Reader v1.4.1

简体中文 | English

This patch release:

• supports RSS 1.0/RDF feeds used by Nature journals;
• parses RSS 1.0 dc:date publication dates;
• removes Obsidian style and clean-build compatibility warnings.

Important

Requires desktop Obsidian 1.13.0 or later with Node.js 22.16+ and
node:sqlite.

Install only main.js, manifest.json, and styles.css from the GitHub
Release.

1.4.0

Academic RSS Reader v1.4.0

简体中文 | English

This release makes the reader faster, safer, and more stable:

• Native SQLite with automatic protection backups and in-place v3 upgrades.
• More reliable paper deduplication after upgrading.
• Automatic updates skip feeds refreshed successfully within the last hour;
  manual updates always run.
• Stable two-line card titles with a compact relevance and keyword layout.
• More consistent recommendations, translation caching, and safer LLM/RSS
  handling.

Important

Requires desktop Obsidian 1.13.0 or later with Node.js 22.16+ and
node:sqlite. Unsupported runtimes cannot load the database.

Important

Close other Obsidian instances before upgrading. The plugin automatically
backs up a v3 database before migration; do not replace the database while
the plugin is open.

Install only main.js, manifest.json, and styles.css from the GitHub
Release.

1.3.0

English

Important compatibility requirement

Academic RSS Reader v1.3.0 requires Obsidian 1.13.0 or later. Before installing or updating to v1.3.0, update Obsidian to the latest available 1.13.x release. Obsidian 1.11.x and 1.12.x are not supported; users who cannot update should remain on v1.2.0.

Highlights

• Migrated the settings page to Obsidian's declarative getSettingDefinitions() API so settings can appear in settings search.
• Preserved database directory suggestions, Vault-relative path validation, SecretStorage, database create/load/switch, backup/restore, and dynamic database state feedback.
• Improved the English and Chinese table layout for subscription management and interest analysis, and removed the redundant last-checked column.
• No migration is required for SQLite, data.json, or SecretStorage data.

中文

重要兼容性要求

Academic RSS Reader v1.3.0 要求 Obsidian 1.13.0 或更高版本。安装或更新到 v1.3.0 前，请先将 Obsidian 更新到最新可用的 1.13.x 版本。Obsidian 1.11.x 和 1.12.x 不受支持；无法升级的用户请继续使用 v1.2.0。

更新要点

• 设置页迁移到 Obsidian 声明式 getSettingDefinitions() API，设置现在可以出现在设置搜索中。
• 保留数据目录联想、Vault 相对路径校验、SecretStorage、数据库创建/载入/切换、备份/恢复和动态数据库状态反馈。
• 优化订阅管理和兴趣分析表格的中英文布局，并移除冗余的“最后检查”列。
• SQLite、data.json 和 SecretStorage 数据均无需迁移。

Full changelog / 完整变更记录

Academic RSS Reader 1.2.0

Academic RSS Reader 1.2.0 是一次综合功能升级：

• 使用稳定键完善中英文界面国际化，并加入语言包一致性检查。
• 推荐模型改用 Web Worker 稀疏训练，支持自动阈值、人工停用词、增量评分，并在订阅更新后自动刷新。
• 订阅更新支持 ETag/Last-Modified、HTTP 304、有界并发、超时取消、Retry-After 和失败退避。
• 数据库自动迁移到新 schema，并继续使用 Vault 相对路径、串行写入和保护性持久化。

手动安装时请下载并替换 main.js、manifest.json 和 styles.css。

1.1.1

Full Changelog: 1.1.0...1.1.1

1.1.0

Full Changelog: 1.0.4...1.1.0

1.0.4

Full Changelog: 1.0.2...1.0.4

Academic RSS Reader v1.0.3

Academic RSS Reader v1.0.3

v1.0.3 是以稳定性、启动体验和界面反馈为主的小型修复版本。数据库 schema 仍为版本 1，最低 Obsidian 版本仍为 1.11.4。

平台验证

v1.0.3 已在 Windows 和 macOS 桌面环境完成全部功能测试，覆盖数据库配置与恢复、RSS 窗口启动、订阅更新、文献篮子、标题翻译、关键词推荐、LLM 复核和兴趣分析。

启动与数据库生命周期

• 已打开的 RSS 窗口随工作区恢复时会立即渲染载入状态，不再等待数据库初始化或订阅网络请求完成。
• 数据库载入成功后统一刷新所有 RSS 窗口；路径失效、配置异常或数据库校验失败时显示设置引导，不阻止 Obsidian 主界面启动。
• 启动时自动更新在后台执行，并通过消息通知显示开始、完成或失败状态。
• 数据库切换和恢复会拒绝正在执行的订阅更新、翻译、LLM 复核、推荐重建及数据库写入，避免旧服务写入已关闭的数据库。
• 恢复备份后，pending 和 translating 翻译任务会重新进入队列，failed 任务保持失败状态。

阅读与推荐

• 文献列表首次加载 100 条，滚动到底部后继续追加下一批 100 条。
• 文献篮子的名称和数量改为单行布局，保留足够的触摸区域。
• 文献标题后显示“高相关”“待判断”或“低相关”彩色小字，其中低相关使用灰色。
• 排序按最终推荐分层、关键词得分和发布日期依次执行。
• 关键词模型的特征提取、350 轮训练和未读评分会分批让出 UI 主线程，并显示阶段通知。
• 推荐结果使用 SQLite prepared statement 批量写入，缩短最终提交停顿；提交仍保持原子性。

安全、兼容与质量

• Vault 路径使用真实路径和最近已存在父目录校验，拒绝指向 Vault 外部的 symlink。
• UI 异步操作统一捕获异常并防止重复提交，导入和确认失败时不再产生未处理的 Promise rejection。
• 增加 :focus-visible、ARIA 当前与按压状态、aria-live、错误提示和 44×44px 触摸尺寸。
• DOM 类型判断、观察器、定时器和外部链接使用视图所属窗口，支持 Obsidian popout。
• 清理无效翻译设置和不可达逻辑，继续使用兼容旧版 Obsidian 的 PluginSettingTab.display()。
• 新增数据库生命周期、翻译状态、Vault 路径、异步 UI、连续加载和 popout DOM 测试，并增加 Node.js 20 GitHub Actions。

发布产物

build/
├── obsidian/academic-rss-reader/
│   ├── main.js
│   ├── manifest.json
│   └── styles.css
├── Academic-RSS-Reader-1.0.3.zip
└── SHA256SUMS.txt

Academic RSS Reader v1.0.2

Academic RSS Reader v1.0.2

Academic RSS Reader 是一款面向学术文献初筛的 Obsidian 桌面 RSS 阅读与个性化推荐插件。

主要更新

• 插件 ID 和名称调整为 academic-rss-reader 与 Academic RSS Reader。
• LLM API Key 改由 Obsidian SecretStorage 管理，并自动迁移旧 data.json 中的明文 Key。
• 首次启用实验性标题翻译时，明确提示标题将发送至 Google 的非正式翻译接口。
• 数据目录经过 Obsidian 路径规范化和 Vault 范围检查。
• 改进阅读器与设置页面按钮的悬停和禁用状态反馈。
• 最低支持 Obsidian 1.11.4。

安装方法

当前版本尚未上架 Obsidian 社区插件市场，只能手动安装。社区插件市场发布正在规划中。

1. 下载本 Release 中的 Academic-RSS-Reader-1.0.2.zip。

2. 关闭 Obsidian。

3. 解压 ZIP，将其中完整的 academic-rss-reader 文件夹复制到：

   <Vault>/.obsidian/plugins/
   

4. 确认最终目录结构为：

   <Vault>/.obsidian/plugins/academic-rss-reader/
   ├── main.js
   ├── manifest.json
   └── styles.css
   

5. 重新打开 Obsidian，在“设置 → 第三方插件”中启用 Academic RSS Reader。

请勿把 ZIP 文件直接放入 .obsidian/plugins/；必须先解压并保留完整的 academic-rss-reader 目录。

从旧插件 ID 升级

若此前安装的是 rss-reader 目录，请先关闭 Obsidian，将该目录重命名为 academic-rss-reader，然后仅替换 main.js、manifest.json 和 styles.css，并保留原有 data.json。新版首次加载时会迁移旧 API Key。

数据库文件仍为 rss-reader.sqlite3，无需迁移数据库内容。全新安装或重新载入时，请在插件设置中选择原有 Vault 数据目录。

校验

附件 SHA256SUMS.txt 提供发布文件的 SHA-256 校验值。