# JbForum

**Repository Path**: donsole/JbForum

## Basic Information

- **Project Name**: JbForum
- **Description**: No description available
- **Primary Language**: Kotlin
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JbForum

JbForum 是一款基于 Jetpack Compose 构建的 Android 论坛客户端应用，支持浏览论坛版块、查看帖子、回复、收藏内容等功能。

## 功能特性

- **论坛浏览**: 浏览各个论坛版块，查看帖子列表
- **帖子查看**: 查看帖子详情，支持图片预览
- **用户中心**: 登录/退出，查看个人发帖、回复和收藏
- **内容收藏**: 支持收藏图片和链接，本地保存
- **图片缓存**: 自动缓存帖子中的图片，支持缩略图生成
- **代码识别**: 自动识别帖子中的番号代码，获取元数据信息
- **主题切换**: 支持浅色、深色和跟随系统主题
- **历史记录**: 记录浏览过的帖子历史
- **设置管理**: 缓存清理、域名配置等

## 技术栈

- **语言**: Kotlin
- **UI 框架**: Jetpack Compose
- **网络**: OkHttp + Jsoup
- **本地存储**: Room Database + SharedPreferences
- **图片加载**: Coil
- **架构**: MVVM + StateFlow

## 项目结构

```
app/src/main/java/com/xxyangyoulin/jbforum/
├── AppCacheManager.kt       # 应用缓存管理
├── AppConstants.kt         # 常量定义
├── AppDatabase.kt          # Room 数据库
├── BackupManager.kt        # 数据备份导出
├── BoardDiskCache.kt       # 版块缓存
├── CodeMetadataScraper.kt  # 番号元数据抓取
├── CookiePersistence.kt    # Cookie 持久化
├── ForumApiClient.kt       # 论坛 API 客户端
├── ForumDomainConfig.kt    # 论坛域名配置
├── ForumHtmlParser.kt      # HTML 解析
├── ForumRepository.kt      # 数据仓库
├── GitHubUpdateChecker.kt  # GitHub 更新检查
├── ImagePreviewActivity.kt # 图片预览
├── JbForumApp.kt          # Application 类
├── LinkCategory.kt         # 链接分类
├── LocalCodeMetadataStore.kt # 本地番号存储
├── LocalFavoritesActivity.kt # 本地收藏
├── LocalImageFavorites.kt  # 图片收藏
├── LocalLinkFavorites.kt   # 链接收藏
├── LoginPersistence.kt    # 登录信息持久化
├── MainActivity.kt        # 主界面
├── MainViewModel.kt       # 主 ViewModel
├── MetaTubeApiClient.kt   # MetaTube API
├── MetaTubeConfig.kt      # MetaTube 配置
├── MetaTubeImageCache.kt  # MetaTube 图片缓存
├── Models.kt              # 数据模型
├── SettingsActivity.kt    # 设置界面
├── ShareImportActivity.kt # 分享导入
├── ThreadBrowseHistory.kt # 浏览历史
├── ThreadDetailActivity.kt # 帖子详情
├── ThreadDetailDiskCache.kt # 帖子缓存
├── ThreadImageCache.kt    # 帖子图片缓存
├── ThreadLinkRecognizer.kt # 链接识别
├── ThreadListDiskCache.kt # 帖子列表缓存
├── ThreadWebViewActivity.kt # WebView 帖子
├── ThreadsActivity.kt     # 帖子列表
├── UserCenterActivity.kt  # 用户中心
└── ui/                    # UI 组件
    ├── components/        # 通用组件
    └── theme/             # 主题定义
```

## 安装

1. 克隆项目
2. 使用 Android Studio 打开项目
3. 同步 Gradle 依赖
4. 构建并安装 APK

## 使用说明

1. **首次启动**: 输入论坛域名并登录
2. **浏览论坛**: 在版块列表中选择感兴趣的版块
3. **查看帖子**: 点击帖子查看详情，支持图片点击预览
4. **收藏内容**: 长按图片或链接进行收藏
5. **本地收藏**: 通过底部导航进入本地收藏管理
6. **设置**: 可配置主题、清理缓存、设置域名等

## 配置说明

- **论坛域名**: 支持配置不同的论坛实例
- **图片缓存**: 可配置缓存大小和压缩质量
- **番号识别**: 可配置 MetaTube 服务器和 Token 获取番号元数据

## 许可证

请查看项目中的 LICENSE 文件了解具体的开源许可证。