标准安装版：

• Windows: MrRSS-{version}-windows-amd64-installer.exe / MrRSS-{version}-windows-arm64-installer.exe
• macOS: MrRSS-{version}-darwin-universal.dmg
• Linux: MrRSS-{version}-linux-amd64.AppImage / MrRSS-{version}-linux-arm64.AppImage

便携版（无需安装，所有数据集中在一个文件夹中）：

• Windows: MrRSS-{version}-windows-{arch}-portable.zip
• Linux: MrRSS-{version}-linux-{arch}-portable.tar.gz
• macOS: MrRSS-{version}-darwin-{arch}-portable.zip

前置条件

在开始之前，请确保已安装以下内容：

• Go（1.25及以上版本）
• Node.js（20 LTS及以上版本，包含npm）
• Wails v3 CLI

平台特定要求：

• Linux: GTK3、WebKit2GTK 4.1、libsoup 3.0、GCC、pkg-config
• Windows: MinGW-w64（用于CGO支持）、NSIS（用于制作安装程序）
• macOS: Xcode命令行工具

详细安装说明请参阅构建要求。

# Linux（Ubuntu 24.04+）快速设置：
sudo apt-get install libgtk-3-dev libwebkit2gtk-4.1-dev libsoup-3.0-dev gcc pkg-config

安装步骤

1. 克隆仓库

   git clone https://github.com/WCY-dt/MrRSS.git
   cd MrRSS
   

2. 安装前端依赖

   cd frontend
   npm install
   cd ..
   

3. 安装Wails v3 CLI

   go install github.com/wailsapp/wails/v3/cmd/wails3@latest
   

4. 构建应用

   # 使用Task（推荐）
   task build
   
   # 或使用Makefile
   make build
   
   # 或直接用wails3
   wails3 build
   

   构建完成后，可执行文件将位于build/bin目录下。

5. 运行应用

   • Windows: build/bin/MrRSS.exe
   • macOS: build/bin/MrRSS.app
   • Linux: build/bin/MrRSS

普通模式（默认）：

• Windows: %APPDATA%\MrRSS\（例如：C:\Users\YourName\AppData\Roaming\MrRSS\）
• macOS: ~/Library/Application Support/MrRSS/
• Linux: ~/.local/share/MrRSS/

便携模式（当存在portable.txt文件时）：

• 所有数据存储在data/文件夹内

这样可以确保您的数据在应用更新和重新安装后仍然保留。

开发模式运行

以热重载模式启动应用：

# 使用Wails v3
wails3 dev

# 或使用Task
task dev

代码质量工具

使用Make

我们提供了一个Makefile来处理常见的开发任务（适用于Linux/macOS/Windows）：

# 查看所有可用命令
make help

# 运行全面检查（lint + 测试 + 构建）
make check

# 清理构建产物
make clean

# 设置开发环境
make setup

预提交钩子

该项目使用预提交钩子来保证代码质量：

# 安装钩子
pre-commit install

# 对所有文件运行
pre-commit run --all-files

运行测试

make test

服务器模式（仅API）

对于服务器部署和API集成，可以使用无界面的服务器版本：

# 使用Docker（推荐）
docker run -p 1234:1234 mrrss-server:latest

# 或者从源码构建
go build -tags server -o mrrss-server .
./mrrss-server

此外，基于ghcr.io的预构建服务器镜像也可供使用：

docker run -d -p 1234:1234 ghcr.io/wcy-dt/mrrss:latest-amd64
docker run -d -p 1234:1234 ghcr.io/wcy-dt/mrrss:latest-arm64

完整的API参考请参阅服务器模式API文档。

在贡献之前：

1. 阅读行为准则
2. 检查现有问题或创建新问题
3. 分支仓库并创建特性分支
4. 进行更改并添加测试
5. 提交拉取请求