Trilium RSS Digest 插件使用教程

🎯 插件简介

Trilium RSS Digest 是一款功能强大的 WordPress 插件，它能够实现以下核心功能：

1. 🔗 连接 Miniflux - 从你的 Miniflux RSS 阅读器中获取已加星标的文章
2. 🤖 AI 智能生成周报 - 支持多种 AI 模型（OpenAI、DeepSeek、Gemini、Claude、Ollama 等）自动生成精美的阅读周报
3. 📝 同步到 Trilium - 将生成的周报自动保存到 Trilium 笔记系统
4. ⏰ 定时自动执行 - 支持设置定时任务，每周自动生成并发布周报
5. 🖥️ 前端展示 - 提供短代码功能，可在网站前端优雅地展示你的周报

1. 安装与激活 🛠️

步骤一：上传插件

将插件文件夹 trilium-rss-digest 上传到你的 WordPress 安装目录：

/wp-content/plugins/trilium-rss-digest/ 

步骤二：激活插件

登录 WordPress 后台，进入 「插件」 页面，找到 Trilium RSS Digest，点击 「启用」 按钮。

步骤三：进入设置

激活后，在左侧菜单栏会出现 「RSS Digest」 选项，点击即可进入插件设置页面。

2. API 配置 🔐

插件需要连接三个外部服务，请确保你已准备好以下信息：

3. Miniflux 设置 📡

3.1 获取 Miniflux API 密钥

1. 登录你的 Miniflux 实例
2. 进入 「设置」→「API 密钥」
3. 点击 「创建新的 API 密钥」
4. 复制生成的密钥

3.2 在插件中配置

进入 「RSS Digest」→「设置」 页面，填写：

• 📍 Miniflux API 地址：你的 Miniflux 服务器地址（例如：https://miniflux.example.com）
• 🔑 Miniflux API 密钥：刚才复制的 API 密钥

点击 「测试 Miniflux 连接」 按钮验证配置是否正确。

3.3 文章获取设置

💡 提示：建议将常读的重要文章加上星标，这样周报内容会更加精炼有价值。

4. Trilium 设置 📓

4.1 获取 ETAPI Token

1. 打开你的 Trilium 笔记应用
2. 进入 「菜单」→「选项」→「ETAPI」
3. 点击 「创建新的 ETAPI Token」
4. 为 Token 命名（如：wordpress-digest）
5. 复制生成的 Token

4.2 在插件中配置

• 📍 Trilium 服务器地址：你的 Trilium 服务地址（例如：https://trilium.example.com 或 http://localhost:8080）
• 🔑 ETAPI Token：刚才复制的 Token
• 📂 父笔记 ID：周报将保存到哪个笔记下面（可选）

4.3 如何获取父笔记 ID？

1. 在 Trilium 中，右键点击你想要存放周报的笔记
2. 选择 「笔记信息」 或 「高级」→「笔记 ID」
3. 复制显示的笔记 ID（格式类似：AbCdEf123）

⚠️ 注意：如果不填写父笔记 ID，周报将保存到 Trilium 的根目录。

点击 「测试 Trilium 连接」 验证配置。

5. AI 模型配置 🤖

5.1 支持的 AI 服务

插件支持多种主流 AI 服务，你可以根据需求选择：

5.2 配置 AI 服务

在设置页面填写：

• 📍 AI API 地址：
  • OpenAI：https://api.openai.com/v1
  • DeepSeek：https://api.deepseek.com/v1
  • 其他服务请参考各自的文档
• 🔑 API 密钥：从对应的 AI 服务商处获取
• 🎯 模型名称：填写你要使用的模型名称

5.3 自定义 Prompt（提示词）

插件提供了默认的周报生成 Prompt，你也可以根据需要自定义：

你是一位专业的内容编辑，请根据以下 RSS 文章内容，生成一份精美的周报摘要。

要求：
1. 对文章进行分类整理
2. 提取每篇文章的核心观点
3. 使用简洁优美的中文表达
4. 适当添加 emoji 增加可读性
...

💡 提示：好的 Prompt 能显著提升周报质量，建议根据你的阅读领域进行针对性调整。

6. 生成周报 ✨

6.1 手动生成

1. 进入 「RSS Digest」→「生成周报」 页面
2. 选择日期范围（默认为最近 7 天）
3. 点击 「获取文章」 预览将要处理的文章列表
4. 确认无误后，点击 「生成周报」

6.2 生成过程

生成过程分为以下几个步骤：

📥 获取文章 → 🤖 AI 生成摘要 → 📝 保存到 Trilium → ✅ 完成

整个过程可能需要 30 秒到几分钟，取决于文章数量和 AI 服务响应速度。

6.3 生成选项

7. 定时任务 ⏰

7.1 启用定时生成

你可以设置插件每周自动生成周报：

1. 进入 「设置」→「定时任务」 标签页
2. 开启 「启用定时生成」 开关
3. 选择执行时间（例如：每周日晚上 8 点）
4. 保存设置

7.2 定时任务类型

7.3 依赖说明

⚠️ 重要：WordPress 定时任务依赖于网站访问触发。如果你的网站访问量较低，建议设置服务器 Cron Job：

# 每 15 分钟触发一次 WordPress Cron */15 * * * * wget -q -O - https://your-site.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

8. 前端展示短代码 🖥️

8.1 基础短代码

在任意页面或文章中插入短代码即可展示周报：

[trilium_digest]

8.2 短代码参数

8.3 样式选项

插件提供了多种预设样式：

• card - 卡片式布局（默认），适合现代风格网站
• list - 列表式布局，简洁紧凑
• timeline - 时间线布局，展示历史周报
• magazine - 杂志式布局，图文并茂

8.4 示例

[trilium_digest count="5" style="card" show_date="true"]

这将在页面上展示最近 5 期周报，采用卡片样式并显示日期。

9. 常见问题 ❓

Q1：Miniflux 连接测试失败？

可能原因：

• ❌ API 地址格式错误（确保包含 https:// 或 http://）
• ❌ API 密钥不正确
• ❌ 服务器网络无法访问 Miniflux

解决方案：

1. 确认 API 地址结尾不要带斜杠
2. 重新生成 API 密钥
3. 检查服务器防火墙设置

Q2：AI 生成超时或失败？

可能原因：

• ⏱️ 文章数量太多，超过 AI 处理上限
• 💰 API 余额不足
• 🌐 网络连接不稳定

解决方案：

1. 减少单次获取的文章数量（建议 ≤ 30 篇）
2. 检查 AI 服务账户余额
3. 尝试更换 AI 服务商

Q3：定时任务不执行？

可能原因：

• 📉 网站访问量低，WordPress Cron 未被触发
• ⚙️ 服务器禁用了 wp-cron.php

解决方案：

1. 按照 7.3 节设置服务器 Cron Job
2. 安装 WP Crontrol 插件检查任务状态

Q4：如何在本地使用 Ollama？

1. 安装并运行 Ollama
2. 将 AI API 地址设置为：http://localhost:11434/v1
3. API 密钥填写：ollama（任意非空值）
4. 模型名称填写你已下载的模型，如：llama3 或 qwen2

🎉 总结

恭喜你完成了 Trilium RSS Digest 插件的配置！现在你可以：

• ✅ 自动从 Miniflux 获取加星文章
• ✅ 使用 AI 生成精美的阅读周报
• ✅ 同步保存到 Trilium 进行知识管理
• ✅ 在网站前端展示你的阅读成果

如有任何问题，欢迎在插件仓库提交 Issue 或联系作者。