hacker-podcast

环境要求

• Node.js 环境与 pnpm 包管理器（用于安装依赖和运行脚本）
• Cloudflare 账号，需开通 Workers、R2 存储、KV 存储和 Workflows
• 已创建并绑定域名的 R2 存储桶（用于存放静态资源和音频）
• OpenAI API Key 与 TTS 语音合成服务（用于生成中文摘要与播报音频）

安装与启动步骤

1. 1克隆并安装依赖

   拉取仓库后进入目录，用 pnpm 安装项目全部依赖。

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

   复制

2. 2配置 Web 环境变量

   在项目根目录创建 .env.local，写入 NODE_ENV=development 和 NEXT_STATIC_HOST 两个变量。

3. 3配置 Worker 环境变量

   在 worker/.env.local 中写入 NODE_ENV、HACKER_PODCAST_WORKER_URL 和 HACKER_PODCAST_R2_BUCKET_URL。

4. 4创建 R2 与 KV

   创建 R2 存储桶并绑定域名，创建 KV 命名空间，再把实际值填入 wrangler.jsonc。

5. 5部署 Worker

   用 wrangler 配置线上环境变量，并记得恢复 wrangler.jsonc 中 workflows 相关配置的注释。

   pnpm deploy:worker

   复制

6. 6部署 Web 应用

   执行部署脚本，把 vinext 开发的 Web 程序通过 Cloudflare Vite 插件发布到 Workers。

   pnpm run deploy

   复制

关键配置

如何确认成功

本地启动后访问 http://localhost:3000 能看到播客页面；线上访问部署域名并打开 /rss.xml 能取到订阅源。

常见问题

注意事项

• README 中的环境变量示例被截断，实际路径与地址请按自己 Cloudflare 资源填写，不要照抄示例。
• 项目由 Worker（抓取、处理音频）和 Web（展示、RSS）两部分组成，两边环境变量都要分别配置。
• 重新部署前确认 wrangler.jsonc 中的 KV、R2 值与控制台创建的资源一致。