Agili 的 Hacker Podcast

一个基于 AI（人工智能）的 Hacker News 中文播客项目，每天自动抓取 Hacker News 热门文章，通过 AI 生成中文总结并转换为播客内容。

预览地址：https://hacker-podcast.agi.li

订阅地址：RSS | Apple Podcasts | YouTube | 小宇宙 | Spotify

---

主要特性

• 🤖 自动抓取 Hacker News 每日热门文章
• 🎯 使用 AI 智能总结文章内容和评论
• 🎙️ 通过 TTS（Text-to-Speech，文本转语音）生成中文播报
• 📱 支持网页和播客 App 收听
• 🔄 每日自动更新
• 📝 提供文章摘要和完整播报文本

技术栈

• vinext (Vite + React Server Components) 应用框架
• Cloudflare Workers（无服务器函数）部署和运行环境
• TTS 语音合成
• OpenAI API 内容生成
• Tailwind CSS 样式处理
• shadcn-ui 组件库

工作流程

1. 定时抓取 Hacker News 热门文章
2. 使用 AI 生成中文摘要和播报文稿
3. 通过 TTS 转换为音频。
4. 存储到 Cloudflare R2（对象存储）和 KV（键值存储）
5. 通过 RSS feed 和网页提供访问

本地开发

项目由一个 Worker（云函数）和 Web 程序组成，Worker 负责抓取数据，处理音频。使用了 Cloudflare 的 R2 存储、KV 存储、工作流和浏览器呈现。 Web 程序负责展示数据和提供 RSS 订阅。Web 程序使用 vinext 开发，通过 Cloudflare Vite 插件部署到 Workers。

1. 安装依赖：

pnpm install

2. 配置环境变量：

# .env.local
NODE_ENV=development
NEXT_STATIC_HOST=http://localhost:3000/static

# worker/.env.local
NODE_ENV=development
HACKER_PODCAST_WORKER_URL=https://you-worker-url
HACKER_PODCAST_R2_BUCKET_URL=https://your-bucket-url
OPENAI_API_KEY=your_api_key
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4.1

3. 启动开发服务器：

# 开发工作流
pnpm dev:worker
# curl -X POST http://localhost:8787 # 手动触发工作流

# 开发 Web 页面
pnpm dev

注意：

• 本地运行工作流时，Edge TTS 转换音频可能会卡住。建议直接注释该部分代码进行调试。
• 由于合并音频需要使用 Cloudflare 的浏览器端呈现，不支持本地开发，需要远程调试。可以使用 pnpm tests 进行测试。

部署

项目使用 Cloudflare Workers 部署：

1. 创建 R2 文件存储桶，绑定域名后，修改 NEXT_STATIC_HOST 和 HACKER_PODCAST_R2_BUCKET_URL 变量。
2. 创建 KV 存储空间
3. 修改 wrangler.jsonc 中 KV 和 R2 的值
4. 使用 wrangler（Cloudflare 命令行工具）脚手架配置线上环境的环境变量：

# 更新 Worker 的私有变量
pnpx wrangler secret put --cwd worker HACKER_PODCAST_WORKER_URL # 绑定域名后，修改为绑定域名
pnpx wrangler secret put --cwd worker HACKER_PODCAST_R2_BUCKET_URL
pnpx wrangler secret put --cwd worker OPENAI_API_KEY
pnpx wrangler secret put --cwd worker OPENAI_BASE_URL
pnpx wrangler secret put --cwd worker OPENAI_MODEL

# 更新 Web 程序的私有变量
pnpx wrangler secret put NODE_ENV # 建议 production
pnpx wrangler secret put NEXT_PUBLIC_BASE_URL # Web 服务地址
pnpx wrangler secret put NEXT_STATIC_HOST # 绑定域名后，修改为绑定域名

# 记得恢复注释：wrangler.jsonc 中的 workflows 相关配置
pnpm deploy:worker
pnpm run deploy

致谢

特别感谢以下开源项目：

• Podify - 一个优雅的播客主题，为本项目提供了设计灵感和参考

贡献

欢迎提交 Issue 和 Pull Request！

赞助

[!TIP] MiniMax-M2.1 是开源的业界顶尖编程模型，在多语言代码编写、界面设计理解与美学表达、长文本处理及多步骤复杂开发任务上表现卓越。让我们向通用生产力的长期愿景迈出了坚实一步，让人人都能轻松用上前沿的 AI 能力。点击领取 MiniMax CodingPlan 专属 88 折优惠。

1. 在 Telegram 关注我
2. 在 𝕏 上关注我
3. 在 GitHub 赞助我

免责声明

本项目与 Hacker News 和 Y Combinator 没有任何关联。"Hacker News" 是 Y Combinator 的注册商标。

hacker-podcast 快速上手指南

hacker-podcast 是一个基于 AI 的 Hacker News 中文播客项目。它自动抓取每日热门文章，通过 AI 生成中文总结并转换为音频播客。支持本地开发、云端部署及多平台订阅。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 系统要求: 现代操作系统（macOS / Linux / Windows）
• 运行环境: Node.js (建议 v18+)
• 包管理器: pnpm
• 账号服务:
  • Cloudflare 账号（用于 Workers、R2 存储、KV 存储）
  • OpenAI API Key（用于内容生成）
• 网络环境: 由于涉及 Cloudflare 和 OpenAI 服务，请确保网络环境可正常访问相关域名。

安装步骤

1. 克隆项目代码

   git clone https://github.com/miantiao-me/hacker-podcast.git
   cd hacker-podcast
   

2. 安装依赖

   pnpm install
   

3. 配置环境变量

   在项目根目录创建 .env.local 文件，并在 worker/ 目录下创建 worker/.env.local 文件，填入以下内容（需替换为您的实际信息）：

   根目录 .env.local:

   NODE_ENV=development
   NEXT_STATIC_HOST=http://localhost:3000/static
   

   worker 目录 worker/.env.local:

   NODE_ENV=development
   HACKER_PODCAST_WORKER_URL=https://you-worker-url
   HACKER_PODCAST_R2_BUCKET_URL=https://your-bucket-url
   OPENAI_API_KEY=your_api_key
   OPENAI_BASE_URL=https://api.openai.com/v1
   OPENAI_MODEL=gpt-4.1
   

基本使用

本地开发调试

项目由 Worker 和 Web 程序两部分组成，需分别启动：

1. 启动 Web 页面

   pnpm dev
   

2. 启动工作流 (Worker)

   pnpm dev:worker
   

   提示：如需手动触发工作流，可使用 curl 命令：

   curl -X POST http://localhost:8787
   

测试与构建

由于合并音频需要 Cloudflare 浏览器端呈现，本地直接调试可能受限，建议使用测试脚本验证功能：

pnpm tests

线上部署

若需将项目部署到生产环境，请使用 Cloudflare Wrangler 进行配置：

1. 修改 wrangler.jsonc 中的 KV 和 R2 绑定配置。
2. 设置私有环境变量：

   # 更新 Worker 的私有变量
   pnpx wrangler secret put --cwd worker HACKER_PODCAST_WORKER_URL
   pnpx wrangler secret put --cwd worker HACKER_PODCAST_R2_BUCKET_URL
   pnpx wrangler secret put --cwd worker OPENAI_API_KEY
   pnpx wrangler secret put --cwd worker OPENAI_BASE_URL
   pnpx wrangler secret put --cwd worker OPENAI_MODEL
   
   # 更新 Web 程序的私有变量
   pnpx wrangler secret put NODE_ENV
   pnpx wrangler secret put NEXT_PUBLIC_BASE_URL
   pnpx wrangler secret put NEXT_STATIC_HOST
   

3. 执行部署：

   pnpm deploy:worker
   pnpm run deploy
   

注意:

• 本地运行工作流时，Edge TTS 转换音频可能会卡住，建议调试时注释相关代码。
• 在线预览地址：https://hacker-podcast.agi.li
• 支持 RSS、Apple Podcasts、小宇宙、Spotify 等平台订阅。