fluxdo

# FluxDO

> 一个真诚、友善、团结、专业的 [Linux.do](https://linux.do/) 第三方客户端

[![Telegram Channel](https://img.shields.io/badge/Telegram-Channel-26A5E4?logo=telegram&logoColor=white)](https://t.me/ldxfd)
[![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?logo=telegram&logoColor=white)](https://t.me/fluxdo_chat)

FluxDO 是为 [Linux.do](https://linux.do/) 社区打造的现代化移动和桌面客户端，基于 Flutter 开发，致力于为用户提供流畅、优雅的论坛浏览体验。

## 下载

<a href="https://github.com/lingyan000/fluxdo/releases"><img alt="Get it on GitHub" src="https://img.shields.io/github/v/release/lingyan000/fluxdo?style=for-the-badge&logo=github&label=GitHub%20Releases" /></a>
<a href="altstore://source?url=https://lingyan000.github.io/fluxdo/source.json"><img alt="Add to AltStore" src="https://img.shields.io/badge/AltStore-Add_Source-0c6bff?style=for-the-badge&logo=apple" /></a>

### AltStore 安装

1. 在 iOS 设备上安装 [AltStore](https://altstore.io/)
2. 打开 AltStore，进入 **Browse** → **Sources** → 点击左上角 **+**
3. 粘贴源地址：
   ```
   https://lingyan000.github.io/fluxdo/source.json
   ```
4. 在源中找到 FluxDO 并安装

![FluxDO 预览](screenshots/preview.png)

## 特性

### 核心功能
- **跨平台支持**：Android、iOS、Windows、macOS、Linux
- **Material Design 3**：现代化 UI 设计，支持动态取色
- **深色模式**：自动适配系统主题
- **完整论坛功能**：浏览话题、发帖回复、搜索、通知
- **内容管理**：书签、浏览历史、关注列表
- **徽章系统**：查看和展示社区徽章
- **Markdown 编辑器**：支持富文本编辑和预览
- **图片支持**：图片上传、查看、保存
- **投票功能**：参与社区投票

### 技术特性
- **安全连接**：集成 Rust 实现的 DOH (DNS over HTTPS) 代理
- **性能优化**：图片缓存、懒加载、代码高亮
- **实时通知**：MessageBus 实时消息推送
- **智能渲染**：HTML 内容分块渲染，流畅滚动

## 快速开始

### 前置要求

- Flutter SDK ^3.10.4
- Rust 工具链（用于编译 DOH 代理）
- Android Studio / Xcode（移动端开发）

### 安装步骤

1. **克隆仓库**
   ```bash
   git clone https://github.com/Lingyan000/fluxdo.git
   cd fluxdo
   ```

2. **初始化工作区**
   ```bash
   melos bootstrap
   ```
   如果没有安装全局 `melos`，可改用 `dart run melos bootstrap`。
   这一步只负责 workspace 依赖和链接初始化。

3. **安装 `just`**
   - Windows：`winget install --id Casey.Just --exact`
   - Windows：`scoop install just`
   - Windows：`choco install just`
   - 通用：`cargo install just`

4. **同步项目状态**
   ```bash
   just sync
   ```
   这一步会统一完成 `flutter pub get`、l10n 生成和代理证书资源同步。

5. **运行应用**
   ```bash
   just run -- -d windows
   just run -- -d macos
   just run -- --dart-define=cronetHttpNoPlay=true
   ```

   如果你不想安装 `just`，也可以直接调用 Dart 入口：
   ```bash
   dart run tool/project_prep.dart app
   dart run tool/flutterw.dart run -d windows
   ```

## 开发

开发相关的工程化细节已经拆到独立文档，根 README 只保留最短路径。

- [开发环境与日常命令](docs/development.md)
- [发版与 iOS IPA](docs/release.md)
- [Flatpak 打包说明](docs/flatpak.md)

## 项目结构

```
fluxdo/
├── lib/
│   ├── config/              # 应用配置
│   ├── models/              # 数据模型（话题、用户、通知等）
│   ├── modules/             # 功能模块
│   ├── pages/               # 页面组件
│   ├── providers/           # Riverpod 状态管理
│   ├── services/            # 业务逻辑服务
│   │   ├── network/         # 网络层（DOH、代理、适配器）
│   │   └── ...
│   ├── utils/               # 工具类
│   ├── widgets/             # 可复用组件
│   └── main.dart
├── core/
│   └── doh_proxy/           # Rust DOH 代理实现