Repository files navigation

这是一个使用现代技术栈构建的 HackerNews 中文版网站，提供实时翻译的英文科技新闻和讨论。

• 🚀 实时同步 HackerNews 最新内容
• 🤖 使用 OpenAI API 智能翻译
• 💻 现代化的用户界面设计
• ⚡ 快速的加载速度和响应式设计
• 🌐 支持多种内容分类浏览

• Next.js 14: React框架，用于构建现代化的服务端渲染应用
• Tailwind CSS: 用于样式开发的实用优先的CSS框架
• shadcn/ui: 高质量的UI组件库
• Lucide Icons: 现代简约风格的图标库

• Next.js API Routes: 服务端API实现
• Prisma: 现代化的ORM工具
• PostgreSQL: 主数据库
• OpenAI API: 提供高质量的内容翻译服务

• Vercel: 应用托管和自动部署
• Vercel Cron Jobs: 定时任务处理
• Vercel Postgres: 数据库服务

• Node.js 18+
• pnpm 8+
• PostgreSQL（本地开发可选）

1. 克隆项目```bashgit clonehttps://github.com/ViggoZ/hackernews-cn.gitcd hackernews-cn```

2. 安装依赖```bashpnpm install```

3. 配置环境变量```bashcp .env.example .env```然后编辑 .env 文件，填入必要的环境变量：

• DATABASE_URL: PostgreSQL 数据库连接URL
• OPENAI_API_KEY: OpenAI API密钥
• NEXT_PUBLIC_APP_URL: 应用URL
• CRON_SECRET: 定时任务密钥

4. 初始化数据库```bashpnpm prisma db push```

5. 启动开发服务器```bashpnpm dev```

访问http://localhost:3000 查看应用。

本项目已配置为可以直接部署到 Vercel 平台。

1. Fork 本项目到你的 GitHub 账号
2. 在 Vercel 中导入项目
3. 配置必要的环境变量：
   • DATABASE_URL: 推荐使用 Vercel Postgres 数据库，在 Vercel 控制台中创建并获取连接 URL
   • OPENAI_API_KEY: 从 OpenAI 获取的 API 密钥
   • NEXT_PUBLIC_APP_URL: 您的 Vercel 部署 URL（例如：https://your-app.vercel.app）
   • CRON_SECRET: 设置一个安全的随机字符串，用于保护定时任务 API
4. 初始化数据库：
   • 部署完成后，在 Vercel 控制台中打开项目
   • 进入 "Storage" 标签页，创建 Postgres 数据库
   • 数据库会自动完成初始化
5. 部署完成后即可访问

注意：项目已配置每小时自动更新内容，您可以在 Vercel 的 "Cron Jobs" 中监控定时任务的执行情况。

```├── src/│ ├── app/ # Next.js 应用路由和页面│ ├── components/ # React 组件│ ├── lib/ # 工具函数和配置│ └── types/ # TypeScript 类型定义├── prisma/ # 数据库模型和迁移├── public/ # 静态资源└── ...配置文件```

• 实时同步 HackerNews 最新内容
  • 每小时自动抓取最新内容
  • 支持多种内容类型：最新、最热、Ask HN、Show HN、Jobs
• 智能翻译
  • 使用 OpenAI API 进行高质量翻译
  • 支持标题和正文的中英对照显示
  • 保留原文链接便于对照
• 用户体验
  • 现代简约的界面设计
  • 响应式布局，完美支持移动端
  • 快速的页面加载和转换
  • 支持深色模式
• 系统特性
  • 基于 Vercel 的可靠部署
  • PostgreSQL 数据持久化
  • 自动的定时更新机制
  • ISR 增量静态再生成

欢迎提交 Pull Request 或创建 Issue！

如果您在使用过程中遇到任何问题，或有任何建议，请通过以下方式反馈：

1. 在 GitHub 上提交 Issue
2. 在 Twitter 上联系@decohack
3. 发送邮件至 [viggo.zw@gmail.com]（请替换为您的邮箱）

MIT License