# QuestLog

**Repository Path**: onepage1983/quest-log

## Basic Information

- **Project Name**: QuestLog
- **Description**: 个人向的安卓手游攻略工具箱，100% vibe coding。
- **Primary Language**: Kotlin
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-11
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuestLog - 游戏进度管理工具

<div align="center">

**一款专为游戏玩家设计的Android进度管理应用**

`Version 1.2-beta` · `Last Updated: 2026-01-11`

[![Platform](https://img.shields.io/badge/Platform-Android-green.svg)](https://www.android.com/)
[![Language](https://img.shields.io/badge/Language-Kotlin-blue.svg)](https://kotlinlang.org/)
[![Material Design](https://img.shields.io/badge/Design-Material%20Design%203-orange.svg)](https://m3.material.io/)

</div>

---

## 📖 简介

**QuestLog** 是一款功能强大的游戏进度管理工具，帮助玩家高效管理多款游戏的任务、攻略和进度。无论是日常任务打卡、主线支线追踪，还是攻略收藏整理，QuestLog都能为您提供完善的解决方案。

### ✨ 核心特性

- 🎮 **多游戏管理** - 同时管理多款游戏，快速切换
- 📊 **游戏进度追踪** - 主线/支线任务管理，可视化完成率
- 📝 **日常任务打卡** - 分组管理，进度统计，自动重置
- 📖 **攻略管理** - 支持文本/链接/文件三种类型
- 📈 **统计分析** - 多维度数据统计和图表展示
- 💾 **数据导入导出** - Excel/JSON格式，便于备份和迁移
- 🎨 **Material Design 3** - 现代化UI设计，流畅交互体验

---

## 🚀 功能清单

### 1. 游戏管理 🎮

#### 核心功能
- ✅ 添加/编辑/删除游戏
- ✅ 游戏归档功能
- ✅ 自定义游戏类型
- ✅ 游戏类型设置（角色扮演、动作、策略、放置、Roguelike等）
- ✅ 活跃游戏与已归档游戏分离展示

#### 数据管理
- ✅ 支持导入/导出游戏列表（JSON格式）

---

### 2. 游戏主页 🏠

#### 信息整合中心
- ✅ **游戏信息Banner** - 大标题展示当前游戏
- ✅ **统计概览卡片** - 汇总关键数据
  - 📝 今日日常完成情况
  - 🎯 游戏进度完成率
  - 📖 攻略收藏数量
- ✅ **快捷操作** - 一键跳转各功能模块
  - 日常任务
  - 游戏进度
  - 攻略管理
  - 游戏管理

#### 特色
- ✅ 实时数据更新
- ✅ 可视化进度条
- ✅ 友好的空状态引导

---

### 3. 日常任务 📝

#### 任务管理
- ✅ 添加/编辑/删除日常任务
- ✅ 任务分组管理
- ✅ 分组折叠/展开
- ✅ 快速打卡（一键完成）
- ✅ 全选/清除功能
- ✅ 进度统计显示

#### 数据功能
- ✅ **Excel导入** - 批量导入任务
- ✅ **Excel导出** - 导出当前任务列表
- ✅ **导出模板** - 含示例数据的Excel模板
- ✅ **清空所有任务** - 批量删除（带确认）
- ✅ **分组设置** - 管理任务分组

#### Excel字段
- `任务名` （必填）
- `任务描述`
- `分组名`
- `是否完成`
- `上次完成日期`

---

### 4. 游戏进度 🎯

#### 任务追踪
- ✅ 添加/编辑/删除任务
- ✅ 多维度任务属性：
  - 任务名、状态（不适用/挂起/待办/进行中/已完成）
  - 地点、类别（主线/支线/自定义）
  - 任务描述、任务奖励
  - 优先级（高/中/低）
  - 备注、网页链接

#### 数据筛选
- ✅ 按地点筛选
- ✅ 按类别筛选
- ✅ 按优先级筛选
- ✅ 按状态筛选
- ✅ 多条件组合筛选
- ✅ 一键清除筛选

#### 统计分析
- ✅ 总体完成率统计
- ✅ 按状态分类统计
- ✅ 按优先级分类统计
- ✅ 按地点分类统计
- ✅ 按类别分类统计
- ✅ 可视化统计图表

#### 数据功能
- ✅ **Excel导入** - 动态字段识别，灵活导入
- ✅ **Excel导出** - 完整导出所有任务数据
- ✅ **导出模板** - 标准Excel模板
- ✅ **清空所有任务** - 批量删除（带确认）
- ✅ **字段可见性设置** - 自定义显示字段
- ✅ **类别设置** - 管理自定义类别

#### Web链接功能
- ✅ 为任务添加网页链接（如Wiki页面）
- ✅ 从任务卡片直接打开链接
- ✅ 应用内WebView浏览
- ✅ 详情页查看完整信息

---

### 5. 攻略管理 📖

#### 三种内容类型
- ✅ **文本攻略** - 纯文本内容编辑
- ✅ **网页链接** - 保存并快速访问网页
- ✅ **文件导入** - 支持多种文件格式
  - PDF文档
  - Word文档（.doc/.docx）
  - Excel表格（.xls/.xlsx）
  - HTML网页（.html/.htm/.mhtml）
  - 图片文件（.jpg/.png/.gif等）

#### 组织管理
- ✅ 分类管理（预设 + 自定义）
- ✅ 分类折叠/展开
- ✅ 拖拽排序
- ✅ 搜索功能
- ✅ 分类设置（添加/编辑/删除/恢复）

#### 查看功能
- ✅ 文本攻略直接查看
- ✅ 网页链接应用内打开（WebView）
- ✅ 文件调用系统应用打开
- ✅ 图片缩略图展示
- ✅ URL类型卡片一键打开链接

#### 数据功能
- ✅ **JSON导出** - 导出攻略元数据
- ✅ **JSON导入** - 从文件导入攻略
- ✅ **清空所有攻略** - 批量删除（带确认）
- ✅ **分类设置** - 管理攻略分类

> **注意**：攻略管理使用JSON格式而非Excel，因为包含混合内容类型（文本/链接/文件引用）

---

## 🏗️ 技术架构

### 核心技术栈
- **语言**: Kotlin
- **架构**: MVVM (Model-View-ViewModel)
- **依赖注入**: Hilt
- **数据库**: Room (SQLite)
- **异步处理**: Kotlin Coroutines + Flow
- **UI框架**: Material Design Components 3
- **视图绑定**: ViewBinding
- **Excel处理**: Apache POI

### 数据库版本
- **当前版本**: v8
- **实体**: Game, Guide, DailyTask, GameProgress

### 主要模块
- **游戏管理**: 游戏信息和状态管理
- **日常任务**: 任务打卡和进度追踪
- **游戏进度**: 任务追踪和统计分析
- **攻略管理**: 多类型内容管理和组织

详细技术架构请参考 [Architecture.md](Architecture.md)

---

## 📦 安装与使用

### 系统要求
- Android 8.0 (API 26) 或更高版本
- 至少 50MB 可用存储空间

### 构建与安装

#### 方式一：使用PowerShell脚本（推荐）

```powershell
# 构建Debug APK
.\build.ps1

# 构建Release APK
.\build.ps1 -Release

# 清理后构建
.\build.ps1 -Clean

# 安装Debug APK到设备
.\install-apk.ps1

# 安装Release APK到设备
.\install-apk.ps1 -Release
```

#### 方式二：使用Gradle命令

```bash
# 构建Debug APK
./gradlew assembleDebug

# 构建Release APK
./gradlew assembleRelease

# 清理项目
./gradlew clean
```

#### 方式三：Android Studio
1. 在Android Studio中打开项目
2. 选择 `Build` → `Build Bundle(s) / APK(s)` → `Build APK(s)`
3. APK将生成在 `app/build/outputs/apk/` 目录

### 快速开始

使用指南请参考 [QuickGuide.md](QuickGuide.md)

---

## 📊 项目统计

### 代码量
- **Kotlin源文件**: 52+ 个
- **布局文件**: 50+ 个
- **总代码行数**: ~10,000+ 行

### 功能完成度
- ✅ 游戏管理: 100%
- ✅ 日常任务: 100%
- ✅ 游戏进度: 100%
- ✅ 攻略管理: 100%
- ✅ 游戏主页: 100%

---

## 🗺️ Roadmap

### 已完成 ✅
- [x] 基础架构搭建
- [x] 游戏管理模块
- [x] 日常任务模块
- [x] 游戏进度模块
- [x] 攻略管理模块
- [x] Excel导入导出功能
- [x] 统计分析功能
- [x] 游戏主页重新设计

### 未来计划 📅
- [ ] 云同步功能
- [ ] 数据备份到云端
- [ ] 主题切换（深色模式）
- [ ] 小部件支持
- [ ] 游戏图标上传
- [ ] 更多统计图表
- [ ] 数据分享功能

---

## 📝 变更日志

### v1.2-beta (2026-01-11) - 最新版本
- ✨ 全新游戏主页设计（信息整合中心）
- ✨ 游戏管理模块优化（自定义游戏类型）
- ✨ 日常任务Excel导入导出功能
- ✨ 游戏进度Web链接功能
- ✨ 攻略管理直接访问链接功能
- 🐛 修复游戏管理页面闪退问题
- 📝 更新游戏类型预设

### v1.1-beta (2026-01-11)
- ✨ 游戏进度UI/UX全面优化
- ✨ 游戏进度详情页重构
- ✨ Excel导入导出功能增强
- 🐛 修复Excel自动列宽闪退问题

### v1.0-beta (2026-01-11)
- ✨ 完整实现攻略管理模块
- ✨ 新增游戏进度管理模块
- ✨ 日常任务分组功能
- ❌ 移除游戏规划和网页收藏模块
- 📝 完善数据导出功能

---

## 📄 许可证

本项目仅供个人学习和使用。

---

## 👨‍💻 开发者

**Project**: QuestLog  
**Version**: 1.2-beta  
**Last Updated**: 2026-01-11  

---

## 📚 相关文档

- [Architecture.md](Architecture.md) - 技术架构详解
- [QuickGuide.md](QuickGuide.md) - 快速使用指南

---

<div align="center">

**Made with ❤️ for gamers**

</div>