⚡ 方案一：直接安装使用（推荐终端用户）

这是最快上手的方式，无需配置开发环境，下载即用。你可以在项目的 GitHub Releases 页面找到以下安装包：

平台 版本类型 说明 适用场景
Windows 官方安装程序 推荐。会创建桌面快捷方式，并支持静默自动更新。 长期稳定使用，希望自动获取新功能。
Windows 便携版 一个独立的可执行文件，无需安装，点击即用。 想要快速试用，或不便安装软件的临时环境。
Android 原生APK 签名后的原生安卓应用。 在手机或平板上随时随地阅读资讯。

下载对应的文件后，Windows用户双击运行安装程序或将便携版保存到本地即可；Android用户将APK文件传输至手机并点击安装即可。

🛠️ 方案二：从源码运行（适合开发者）

如果你想对项目进行二次开发、贡献代码，或体验最新未发布功能，可以按照以下步骤操作。

环境准备

  • Node.js: 版本要求 v18.0.0 或更高。
  • 包管理器: npm (随Node.js自带) 或 yarn。
  • （可选）Android Studio: 仅当你想在本地编译Android APK时需要。

详细部署步骤

1. 克隆代码仓库
打开终端或命令行，执行以下命令将项目代码下载到本地：

1
2
git clone https://github.com/dznass-cmd/RadarRSS.git
cd RadarRSS

2. 安装项目依赖
使用npm安装项目所需的所有Node.js包：

1
npm install

3. 配置Google Gemini API密钥（可选，开启AI功能）
此步骤为可选，但要想使用AI摘要、智能策展等核心功能，必须配置。

  • 首先，前往 Google AI Studio 申请一个免费的API密钥。

  • 在项目根目录下，创建一个名为 .env.local 的文件（用于开发环境），并在其中写入以下内容：

    1
    GEMINI_API_KEY=你的_Google_Gemini_API密钥

  • 对于生产环境或桌面应用，你需要将同样的密钥保存在一个名为 .env 的文件中，并放置于最终的可执行文件（Radar RSS.exe）同级目录下。

4. 启动开发服务器
运行以下命令，这将启动一个本地的开发服务器，并打开浏览器预览：

1
npm run dev

此时，你可以在浏览器中访问 http://localhost:3000 来使用Web版本。

5. 启动桌面应用（Electron模式）
如果你想在独立的桌面窗口中运行，可以执行：

1
npm run desktop

这会将应用置于一个无浏览器干扰的Electron窗口中。

6. 编译Android应用（使用Capacitor）
如果你需要生成或更新Android项目文件，可以按顺序执行：

1
2
npm run build:android  # 构建Web资源并同步到Android项目
npm run open:android   # 在Android Studio中打开项目

之后，你就可以使用Android Studio进行进一步的编译或签名打包了。

⚙️ 常见问题与技巧

  1. AI功能不工作？
    • 首先检查API密钥是否正确配置，且未过期。
    • 确认 .env.local (开发) 或 .env (生产) 文件位于正确的目录。
    • 注意：即使没有API密钥，应用的核心RSS阅读、更新和过滤功能依然可以正常使用，只是AI相关按钮会不可用或隐藏。
  2. Windows自动更新如何工作？
    • 如果你通过官方安装程序（Setup .exe）安装，应用启动时会后台检查GitHub Releases上的新版本。
    • 当检测到更新，它会静默下载。下载完成后，界面会提示你一键重启以应用更新。
  3. 如何修改默认的RSS源？
    • 项目的RSS源列表和分类模块（如“Technology”, “World News”）通常在代码的配置文件中定义。你可以在 src 目录下查找相关的配置文件（如 feeds.ts 或类似文件）进行自定义。

你是打算直接下载安装包使用，还是计划基于源码进行二次开发？如果是后者，告诉我你想调整的具体功能（比如修改RSS源列表或界面主题），我可以给你更详细的指导。