# [BestBlogs.dev](https://bestblogs.dev?utm_source=github&utm_medium=readme&utm_campaign=hero-title)

> **Discover content truly worth your time.**  
> 发现真正适合你的高质量内容 —— BestBlogs 是 AI 驱动的私人阅读助手。

替你判断什么值得读、协助你读得更快读得更顺、和你一起学习让推荐越来越贴合你。原生接入 RSS / Newsletter / Twitter / YouTube / Podcast 五种源，打通中英双语质量池。目前已有超过 **2 万**注册用户。

**v2.4.0 里程碑**：Pro 开通后 15 分钟内即可收到首份个性化早报；粘贴链接自动识别并接入 YouTube / 小宇宙 / 公众号订阅源；我的阅读、我的关注全面合并重组，私人阅读助手工作流更完整。

**世界杯专刊已上线**：围绕赛前信息、赛后回顾与精选内容做轻量更新，方便看球前后快速跟上关键脉络。

<p align="center">
  <a href="https://bestblogs.dev/?utm_source=github&utm_medium=readme&utm_campaign=hero-cta-primary"><b>🚀 Try BestBlogs.dev →</b></a> &nbsp;·&nbsp;
  <a href="https://bestblogs.dev/newsletter?utm_source=github&utm_medium=readme&utm_campaign=hero-cta-secondary"><b>📬 Subscribe Newsletter</b></a> &nbsp;·&nbsp;
  <a href="https://bestblogs.dev/pro?utm_source=github&utm_medium=readme&utm_campaign=hero-cta-pro"><b>⭐ Try Pro (7-day free)</b></a> &nbsp;·&nbsp;
  <a href="./README.en.md"><b>English</b></a>
</p>

![首页](./images/homepage.png)

---

## 1. 为什么 BestBlogs

如果你也是「订阅了 200 个 RSS 源，但每天打开 reader 都想关掉」那种状态，下面这三种疲劳你一定不陌生：

| 自管理 RSS 阅读器的三大疲劳 | BestBlogs 的回应 |
|---|---|
| **信息过载**：每天 200+ 篇，根本读不完 | AI 在源头做**初筛 + 六维评分**，每天只把高分内容浮上来 |
| **找不到精华**：标题党、转载、机翻、营销稿混在一起 | AI 初评 + 编辑精审形成「公共质量池」，所有用户共享这份判断力 |
| **没有评分**：不知道哪些值得深读 | 每篇内容都有**选题 / 内容 / 深度 / 实用 / 创新 / 表达**六维评分，深读价值一目了然 |
| **跨语言断层**：英文一手内容看不动，等中文转述又慢又失真 | 中英双向沉浸式翻译 + AI 伴读，让你直接读原文 |
| **重复阅读**：同一条新闻在 5 个源里被洗了 5 遍 | 主题解读把碎片聚合成主题全景，事件 / 领域 / 人物 / 产品对比四类视角 |

> **BestBlogs 的承诺不是「更多内容」，而是「更适合你的高质量内容」。**

---

## 2. 是什么

BestBlogs.dev 是 **AI 驱动的私人阅读助手**。产品结构上分两端：

- **公共策展层** —— 让所有访问者看到 BestBlogs 当下精选的高质量内容（无需登录）
- **我的空间** —— 让登录与 Pro 用户拥有真正属于自己的阅读流

两端由同一个公共质量池（AI 初评 + 编辑精审）供能。

### 核心能力

**公共策展层（任何人无需登录可读）**

| 入口 | 说明 |
|---|---|
| **每日早报** | 中英双语图文 + 10-15 分钟播客（Apple / Spotify / 小宇宙）+ 海报 / Telegram / X / RSS 多渠道分发 |
| **精选周刊** | 每周精审一份高质量内容合集，对本周值得回顾的内容做二次提纯 |
| **主题解读** | 围绕重要事件 / 领域 / 人物 / 关键产品对比形成的编辑式深度解读，把碎片内容聚合成主题全景 |
| **内容广场** | BestBlogs 全部公开内容的浏览主入口，「精选 / 最新」双视角，不做个性化排序 |

**我的空间（登录可见，Pro 解锁完整工作流）**

| 入口 | 说明 |
|---|---|
| **我的早报** | 基于关注、兴趣标签与阅读行为的个性化每日早报（图文 + 邮件），Pro 解锁；**Pro 开通后 15 分钟内即送首份** |
| **我的关注** | 五种源（RSS / Newsletter / Twitter / YouTube / Podcast）三列工作台统一管理；粘贴 YouTube / 小宇宙 / 公众号链接即可自动识别并接入 |
| **我的阅读** | AI 伴读协助理解（摘要 / 翻译 / 提问 / 章节跳转）+ 图书馆沉淀（书签 / 划线 / 历史） |
| **我的回顾** | 每天晚间自动生成一份回顾页，把当日阅读足迹组织成「一天的阅读小结」 |

**跨入口能力**

| 能力 | 说明 |
|---|---|
| **AI 内容分析** | 六维评分（选题 / 内容 / 深度 / 实用 / 创新 / 表达）+ 摘要 + 关键观点 + 金句 |
| **沉浸式翻译** | 中英双向 + 文章 / 推文 / 播客 / 视频全类型支持 |
| **可解释画像** | 兴趣偏好由显式行为驱动（关注 / 阅读 / Domain 自定义篇数），不开放手动调权 |

### 产品截图

**公共策展层**

![每日早报](./images/public_daily_brief.png)

![内容广场](./images/explore_contents.png)

![主题解读](./images/topics.png)

**我的空间（Pro）**

![我的早报](./images/my_daily_brief.png)

![我的关注](./images/my_following.png)

---

## 3. Free vs Pro

Free 不是试用版，而是独立可用的高质量阅读产品。Pro 是完整私人阅读助手工作流的兑现。

| 能力 | Free | Pro |
|---|---|---|
| **公共策展层全部入口** | ✅ 完整开放 | ✅ 完整开放 |
| 每日早报 / 精选周刊 / 主题解读 / 内容广场 | ✅ | ✅ |
| **我的早报（个性化）** | ❌ | ✅ 图文 + 邮件每日触达 |
| **我的回顾** | ❌ | ✅ 日终阅读小结 |
| **自定义视图** | ❌ | ✅ 按主题 / 标签 / 来源组合 |
| **关注源数量** | 限量 | **10× 显著放宽** |
| **AI 伴读** | 3 次/天 | **30 次/天（10×）** |
| **沉浸式翻译** | 3 次/天 | **30 次/天（10×）** |
| **基础阅读沉淀**（书签 / 划线 / 历史） | ✅ | ✅ |
| **OpenAPI v2 接入** | ✅ | ✅ |

**Pro 试用**：新用户 7 天、老用户 14 天免费试用，完整体验私人阅读助手工作流 → [立即试用 Pro](https://bestblogs.dev/pro?utm_source=github&utm_medium=readme&utm_campaign=free-vs-pro)

> 配额具体数字由后端动态调整；BestBlogs 不做首屏强弹窗、强制升级和骚扰式触达，升级动机来自用户真实触达能力天花板。

---

## 4. 快速上手

**直接浏览**：访问 [bestblogs.dev](https://bestblogs.dev/?utm_source=github&utm_medium=readme&utm_campaign=quickstart-web)，免费阅读所有公开内容。

**命令行**（开发者 / Agent 用户）：

```bash
npm install -g @bestblogs/cli
bestblogs auth login           # 输入 API Key（在设置页生成）
bestblogs discover today       # 今天最值得读的内容
bestblogs read deep <id>       # 深度阅读一篇
```

**Agent Skills**（Claude Code / Codex / Cursor 等）：

```bash
npx @bestblogs/skills           # 一键安装所有 Skills
# 安装后在 Claude Code 或 Codex 中直接说：「今天 BestBlogs 有什么值得读的？」
```

---

## 5. 订阅

每周五发送**精选周刊（Featured Weekly Newsletter）**，由 AI 初评 + 编辑精审形成本周高质量内容合集，覆盖图文、邮件、图文精读、播客四种形态 → [浏览往期](https://www.bestblogs.dev/newsletter?utm_source=github&utm_medium=readme&utm_campaign=newsletter-section)

![精选周刊](./images/newsletters.png)

---

## 6. RSS 订阅

BestBlogs.dev 支持灵活的 RSS 订阅：

| 订阅范围 | 地址 |
|---|---|
| 全站 | `https://www.bestblogs.dev/zh/feeds/rss` |
| 仅精选内容 | `https://www.bestblogs.dev/zh/feeds/rss?featured=y` |
| 编程类文章 | `https://www.bestblogs.dev/zh/feeds/rss?category=programming&type=article` |
| AI 高分内容（英文） | `https://www.bestblogs.dev/en/feeds/rss?category=ai&minScore=90` |
| 精选周刊（Newsletter） | `https://www.bestblogs.dev/zh/feeds/rss/newsletter` |
| 每日早报 | `https://www.bestblogs.dev/zh/feeds/rss/daily-brief` |

更多参数说明见 [BestBlogs_RSS_Doc.md](./BestBlogs_RSS_Doc.md)。

### BestBlogs 精选池订阅源 OPML

以下为 BestBlogs 当前收录的订阅源 OPML 文件，可导入到任意 RSS 阅读器：

- **全部（400 个）**：[BestBlogs_RSS_ALL.opml](./BestBlogs_RSS_ALL.opml)
- **文章（170 个）**：[BestBlogs_RSS_Articles.opml](./BestBlogs_RSS_Articles.opml)
- **播客（30 个）**：[BestBlogs_RSS_Podcasts.opml](./BestBlogs_RSS_Podcasts.opml)
- **视频（40 个）**：[BestBlogs_RSS_Videos.opml](./BestBlogs_RSS_Videos.opml)
- **Twitter（160 个）**：[BestBlogs_RSS_Twitters.opml](./BestBlogs_RSS_Twitters.opml)

> 💡 导入这些 OPML 后，推荐在 [BestBlogs.dev](https://bestblogs.dev/?utm_source=github&utm_medium=readme&utm_campaign=opml-followup) 关注这些源，让 AI 帮你做初筛 —— 不只是「订阅了什么」，而是「值得读什么」。

### 精选订阅源整理计划（opml/）

BestBlogs 团队正在系统整理高质量 RSS 订阅源，按来源类型分类收录。目前已发布 **551 个**（公众号 375 + 播客 57 + YouTube 119），更多类型整理中，欢迎持续关注。

**已发布：**

| 文件 | 类型 | 数量 | 说明 |
|---|---|---|---|
| [opml/bestblogs_wechat2rss_opml_all.opml](./opml/bestblogs_wechat2rss_opml_all.opml) | 微信公众号 | 375 | 通过 [wechat2rss](https://github.com/ttttmr/Wechat2RSS) 转换；[整理文章](./posts/bestblogs_sources_wechat_part1.md) |
| [opml/bestblogs_podcast_opml_all.opml](./opml/bestblogs_podcast_opml_all.opml) | 播客（小宇宙） | 57 | 小宇宙播客 RSS；[整理文章](./posts/bestblogs_sources_part2_podcasts_videos.md) |
| [opml/bestblogs_youtube_opml_all.opml](./opml/bestblogs_youtube_opml_all.opml) | YouTube | 119 | YouTube 频道 RSS；[整理文章](./posts/bestblogs_sources_part2_podcasts_videos.md) |

有优质 RSS 源推荐？欢迎提 [Issue](https://github.com/ginobefun/BestBlogs/issues)。

---

## 7. 开放 API（v2）

BestBlogs v2 API 面向开发者开放，提供内容发现、阅读与个人数据管理能力。

**Base URL**：`https://api.bestblogs.dev/openapi/v2`  
**鉴权**：Header `X-API-KEY: <your_key>`（在 [Settings](https://bestblogs.dev/settings?utm_source=github&utm_medium=readme&utm_campaign=openapi) 生成）

| 模块 | 说明 |
|---|---|
| [openapi/01-auth.md](./openapi/01-auth.md) | 认证与身份，公共规范 |
| [openapi/02-intake.md](./openapi/02-intake.md) | 兴趣画像建立，冷启动引导 |
| [openapi/03-discover.md](./openapi/03-discover.md) | 内容发现：早报 / 推荐 / 搜索 |
| [openapi/04-read.md](./openapi/04-read.md) | 内容阅读：全文 / Markdown / 元数据 |
| [openapi/05-capture.md](./openapi/05-capture.md) | 书签 / 划线笔记 / 阅读历史 |
| 主题（Topics） | `GET /openapi/v2/topics`（列表） + `GET /openapi/v2/topics/{slug}`（详情，含四类型结构化字段、引用、延伸阅读）— 鉴权同上，独立文档整理中 |

典型使用路径：认证 → Intake 建立画像 → Discover 发现内容 → Read 深度阅读 → Capture 留存笔记

> v1 API 已停止接入，历史文档见 [archive/v1-openapi.md](./archive/v1-openapi.md)

---

## 8. CLI & Agent Skills

### @bestblogs/cli

官方命令行工具，基于 OpenAPI v2，所有命令支持 `--json` 模式，可直接被 AI Agent 消费。

```bash
npm install -g @bestblogs/cli
bestblogs auth login
bestblogs intake setup           # 冷启动：选兴趣标签
bestblogs discover today --limit 20
bestblogs read deep <resourceId>
bestblogs capture bookmark add <resourceId> --note "值得反复读"
```

- 文档：[cli/README.md](./cli/README.md)
- 更新日志：[cli/CHANGELOG.md](./cli/CHANGELOG.md)
- 源码：[cli/src/](./cli/src/)（TypeScript，MIT 协议）

### BestBlogs Skills

一组 SKILL.md 文件，让 Claude Code / Codex / Cursor / OpenClaw 等 Agent 主动触发 BestBlogs 能力（25 个稳定原语）。

```bash
npx @bestblogs/skills             # 默认安装到 Claude Code 和 Codex
npx @bestblogs/skills --client codex
npx @bestblogs/skills upgrade     # 升级到最新版
```

安装后直接说：
- 「今天有什么值得读的？」→ `bestblogs-discover`
- 「深度阅读这篇」→ `bestblogs-read`
- 「收藏这篇，加笔记」→ `bestblogs-capture`
- 「为什么推这条给我？」→ `bestblogs-explain`
- 「BestBlogs 有哪些主题页 / 看 X 主题」→ `bestblogs-topic`

- 文档：[skills/README.md](./skills/README.md)
- 安装指南：[skills/INSTALL.md](./skills/INSTALL.md)
- 源码：[skills/](./skills/)

---

## 9. Build in Public

BestBlogs 是一个完全公开建造过程的独立产品，以下是部分建造日志与背后的思考：

| 文章 | 日期 | 说明 |
|---|---|---|
| [BestBlogs 2.0 内测开启：我想重新做一款更适合自己的阅读产品](./posts/20260412_bestblogs_v2_beta.mdx) | 2026-04 | v2.0 内测发布时的产品思考，重新理解「适合自己的阅读产品」是什么 |
| [为什么 BestBlogs 开始按 Agent Native 来设计开放能力](./posts/20260420_bestblogs_agent_native_next_step.mdx) | 2026-04 | OpenAPI / CLI / Skills 开放的背后：把阅读能力整理成可组合的工作流原语 |
| [解密 BestBlogs 早报背后的 AI 助手](./posts/20260307_bestblogs_daily_digest_behind_the_scenes.mdx) | 2026-03 | 拆解早报背后的 AI Agent 工作流：Skill 是什么、Agent 怎么工作 |
| [BestBlogs.dev 基于 Dify Workflow 的文章智能分析实践](./posts/20240714_bestblogs_use_dify_workflow.mdx) | 2024-07 | 从文章初评到深度分析再到多语言翻译的全流程实现 |
| [BestBlogs 订阅源分享第一期：微信公众号篇](./posts/bestblogs_sources_wechat_part1.md) | 2026-06 | 375 个仍在更新的微信公众号 RSS 源整理与分享 |
| [BestBlogs 订阅源分享第二波：播客与视频篇](./posts/bestblogs_sources_part2_podcasts_videos.md) | 2026-06 | 57 个小宇宙播客 + 119 个 YouTube 频道整理与分享 |

---

## 10. 文档与资源

### 产品与技术文档

| 文档 | 说明 |
|---|---|
| [docs/1-VISION.md](./docs/1-VISION.md) | 愿景与长期方向 |
| [docs/2-PRODUCT.md](./docs/2-PRODUCT.md) | 产品策略、能力矩阵、执行版路线 |
| [docs/3-BRAND.md](./docs/3-BRAND.md) | 品牌基线与表达规范 |
| [docs/4-ARCHITECTURE.md](./docs/4-ARCHITECTURE.md) | 系统边界、技术链路与开关 |
| [docs/5-DESIGN.md](./docs/5-DESIGN.md) | 视觉与交互规范 |
| [docs/6-UI-SPEC.md](./docs/6-UI-SPEC.md) | UI 组件与交互细则 |
| [docs/7-CONVENTIONS.md](./docs/7-CONVENTIONS.md) | 开发规范与代码风格 |
| [docs/8-CURRENT_STATE.md](./docs/8-CURRENT_STATE.md) | 当前阶段、能力概览与路线图 |
| [docs/9-TESTING.md](./docs/9-TESTING.md) | 测试分层、覆盖原则与质量门禁 |
| [docs/10-TERMINOLOGY.md](./docs/10-TERMINOLOGY.md) | 中英术语表 |
| [docs/11-OPERATIONS.md](./docs/11-OPERATIONS.md) | 运维原则、监控与回滚边界 |
| [docs/12-WORKFLOW.md](./docs/12-WORKFLOW.md) | 开发流程、评审标准与交付闭环 |
| [docs/13-INFRA-DEPS.md](./docs/13-INFRA-DEPS.md) | 全局技术架构、运行组件与外部依赖概览 |

### 版本历史

详细双语 Changelog 见 [changelog/](./changelog/)（从 v2.0.0 起）。每次大版本（v2.x.0）会同步在 [GitHub Releases](https://github.com/ginobefun/BestBlogs/releases) 发布，附带本月产品大事件。

### Roadmap 与社区讨论

- 🗺️ **Roadmap**：见 [docs/8-CURRENT_STATE.md](./docs/8-CURRENT_STATE.md) 的「阶段路线图」章节
- 💬 **GitHub Discussions**：开放 Roadmap 讨论、功能建议、月度更新 → [参与讨论](https://github.com/ginobefun/BestBlogs/discussions)

### 历史归档

[archive/](./archive/) 包含 v1 API 文档、早期 Dify 实现文档等历史资料，仅供参考。

---

## 11. 实现原理

### AI 内容处理流水线

```
RSS 爬取 → 初筛过滤 → AI 深度分析 → 多语言翻译 → 入库 → 个性化推荐
```

**1. 内容爬取**：基于 RSS + 无头浏览器提取全文，支持订阅源配置正文选择器

**2. 初筛过滤**：语言类型、内容质量特征初步评分，过滤低价值内容

**3. AI 深度分析**：大语言模型生成六维评分 + 摘要 + 关键观点 + 金句 + 标签

**4. 多语言翻译**：识别专业术语 → 初译 → 检查 → 意译优化，支持中英双语

**5. 个性化推荐**：六维兴趣标签匹配 + 早报智能编排

详细实践文档与 Dify DSL：

- [BestBlogs 文章智能分析实践](./flows/Dify/BestBlogs.dev%20基于%20Dify%20Workflow%20的文章智能分析实践.md)
- [Intelligent Article Analysis at BestBlogs.dev](./flows/Dify/Intelligent%20Article%20Analysis%20at%20BestBlogs.dev%3A%20A%20Case%20Study%20Using%20Dify%20Workflow.md)
- Workflow DSL：[flows/Dify/dsl/](./flows/Dify/dsl/)

---

## 12. 支持与交流

这次除了整理播客和 YouTube 频道，也顺手把 BestBlogs 对外的交流和发布入口整理了一下。

如果你对 RSS、AI 阅读、Agent 工作流、高质量信息源和个人内容管理感兴趣，可以通过以下渠道继续关注 BestBlogs：

| 渠道 | 说明 |
|---|---|
| **微信交流群** | 日常交流、反馈问题、推荐订阅源；二维码过期可添加小助手 **ginobot** 拉入群 |
| **微信公众号** | 同步产品更新、订阅源整理和阅读方法 → [关注公众号](https://mp.weixin.qq.com/s/PjLi-o2-kxIWqIGT7_0o4A?scene=1) |
| **飞书群** | 更深入的产品、技术和运营讨论 → [加入飞书群](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=e71u9acd-3f93-4d7d-95b2-94111c51a668) |
| **小宇宙** | 中文早报、内容精选和产品动态 → [收听](https://www.xiaoyuzhoufm.com/podcast/69acf4bcfe570e1a10f20f73) |
| **Apple Podcasts** | 适合习惯用苹果播客收听的用户 → [Subscribe](https://podcasts.apple.com/us/podcast/bestblogs/id1896876403) |
| **公开仓库** | OPML、订阅源、OpenAPI、CLI 和 Agent 相关能力 → [BestBlogs on GitHub](https://github.com/ginobefun/BestBlogs) |
| **作者博客** | 产品迭代、技术架构、增长运营和独立开发思考 → [GinoNotes](https://www.ginonotes.com/) |
| **官方推特** | 产品动态、每日早报和精选内容 → [@BestBlogsDev](https://x.com/BestBlogsDev) |
| **Gino 推特** | BestBlogs、AI 阅读、RSS、Agent 和独立开发 → [@hongming731](https://x.com/hongming731) |
| **小光推特** | 产品、内容、社区、创业和高质量阅读体验 → [@puliandc](https://x.com/puliandc) |

如果 BestBlogs.dev 对你有帮助，也欢迎：

- ⭐ 给项目点个 Star —— 让更多人发现这个工具
- 🚀 [注册 BestBlogs.dev](https://bestblogs.dev/?utm_source=github&utm_medium=readme&utm_campaign=support-cta) —— 完整体验 AI 阅读助手
- 💝 赞赏支持项目发展
- 📧 邮件反馈建议：[hi@gino.bot](mailto:hi@gino.bot)
- 🐛 提交 Issue：[GitHub Issues](https://github.com/ginobefun/BestBlogs/issues)
- 💬 参与讨论：[GitHub Discussions](https://github.com/ginobefun/BestBlogs/discussions)

<div align="center">

| 赞赏支持项目发展 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | 微信交流群（过期联系 ginobot） |
|:---:|:---:|:---:|
| <img src="https://bestblogs.dev/support-qrcode.png" alt="赞赏支持项目发展" width="200" /> | | <img src="https://bestblogs.dev/author-qrcode.png" alt="添加微信加入群聊" width="200" /> |

</div>

---

## 致谢

感谢以下开源项目：

- [RSSHub](https://github.com/DIYgod/RSSHub) — 万物皆可 RSS
- [wechat2rss](https://github.com/ttttmr/Wechat2RSS) — 微信公众号转 RSS
- [Dify](https://github.com/langgenius/dify) — LLM 应用开发平台
- [XGo.ing](https://xGo.ing) — 推文 RSS
- [Bark](https://github.com/Finb/Bark) — iOS 推送通知工具
- [Uptime Kuma](https://github.com/louislam/uptime-kuma) — 自建监控服务

---
