# pscd

**Repository Path**: lonely-shadow/pscd

## Basic Information

- **Project Name**: pscd
- **Description**: 科普互动展示墙安卓端App
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PSCD

PSCD 是一个 Android 应用程序，用于管理资源下载和缓存，支持用户登录、资源浏览、离线访问等功能。

## 特性

- **用户登录**：支持用户通过手机号登录，并保存用户的登录状态。
- **资源管理**：从服务器获取资源列表，支持分页、搜索和筛选。
- **离线访问**：支持资源的离线缓存，包括封面图片和文件。
- **下载管理**：提供下载进度跟踪、暂停和恢复功能。
- **自动更新检测**：自动检测服务器上的资源更新，并支持自动缓存新资源。
- **用户中心**：显示用户信息、缓存大小，并提供清除缓存和退出登录的功能。

## 架构

PSCD 使用现代 Android 开发架构，包括：

- **MVVM 模式**：使用 ViewModel 和 LiveData 管理 UI 相关数据。
- **Jetpack Compose**：用于构建现代 UI。
- **Retrofit**：用于网络请求。
- **Room 数据库**：用于本地数据存储。
- **Kotlin 协程**：用于异步任务处理。

## 目录结构

```
app/
├── src/
│   ├── main/
│   │   ├── java/com/weeemake/pscd/  # Java/Kotlin 源代码
│   │   │   ├── data/                  # 数据层
│   │   │   │   ├── auth/              # 认证相关
│   │   │   │   ├── local/             # 本地数据存储
│   │   │   │   ├── manager/           # 资源管理
│   │   │   │   ├── model/             # 数据模型
│   │   │   │   └── network/           # 网络请求
│   │   │   ├── ui/                    # UI 层
│   │   │   │   ├── component/         # 可复用 UI 组件
│   │   │   │   ├── screen/            # 页面
│   │   │   │   ├── theme/             # 应用主题
│   │   │   │   └── viewmodel/         # ViewModel
│   │   │   └── util/                  # 工具类
│   │   └── assets/                    # 静态资源
│   └── res/                           # 资源文件
│       ├── drawable/                  # 图片资源
│       ├── mipmap/                    # 启动图标
│       ├── values/                    # 字符串、颜色、样式等
│       └── xml/                       # XML 配置文件
└── build.gradle                       # Gradle 构建文件
```

## 安装

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/lonely-shadow/pscd.git
   cd pscd
   ```

2. 使用 Android Studio 打开项目：
   - 打开 `Android Studio`
   - 选择 "Open an existing Android Studio project"
   - 导航到项目目录并打开

3. 构建并运行应用：
   - 点击 "Run" 按钮（绿色播放按钮）或使用快捷键 `Shift + F10`

## 使用

1. **登录**：在登录页面输入用户名和密码进行登录。
2. **浏览资源**：登录后进入主页面，查看资源列表。
3. **下载资源**：点击资源条目开始下载，下载进度会在 UI 中显示。
4. **离线访问**：下载完成后，资源将缓存到本地，即使在无网络环境下也可以访问。
5. **用户中心**：点击右上角进入用户中心，查看缓存大小、清除缓存或退出登录。

## 贡献

欢迎贡献代码或提出问题。请遵循以下步骤：

1. Fork 仓库
2. 创建新分支 (`git checkout -b feature/your-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request

## 许可证

本项目使用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。