优化代码以及更新文档说明

Author: Joker-x-dev

.gitignore

@@ -16,3 +16,4 @@ local.properties
 /.idea/
 /android-project-compose-docs/
 /context/
+/blog_post.md

README.md

@@ -0,0 +1,161 @@
+<div align="center">
+
+<img src="docs/images/graphs/logo.svg" width="120" alt="Logo"/>
+
+# AndroidProject-Compose
+
+_一个 Android 快速开发框架_
+
+<!-- 语言切换按钮 -->
+<div align="center">
+  <a href="README_EN.md">🌍 English</a>
+</div>
+
+[![GitHub](https://img.shields.io/badge/GitHub-AndroidProjectCompose-blue?style=flat-square&logo=github)](https://github.com/Joker-x-dev/AndroidProject-Compose)
+[![Gitee](https://img.shields.io/badge/Gitee-AndroidProjectCompose-red?style=flat-square&logo=gitee)](https://gitee.com/Joker-x-dev/AndroidProject-Compose)
+[![Demo](https://img.shields.io/badge/Demo-蒲公英下载-green?style=flat-square&logo=android)](https://www.pgyer.com/AndroidProject-Compose)
+[![API](https://img.shields.io/badge/Docs-compose.dusksnow.top-orange?style=flat-square&logo=readthedocs)](https://compose.dusksnow.top)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Joker-x-dev/AndroidProject-Compose)
+
+</div>
+
+## 📖 项目简介
+
+AndroidProject-Compose 是一个包含网络、状态、导航、主题、数据存储、数据库等基础能力的 **Jetpack Compose 单模块脚手架**，并提供少量功能示例页面，方便你“拉仓库 → 运行 → 填业务”地快速搭建或学习现代 Compose 应用。
+
+> 如果项目对您有帮助，请给个 Star 支持 ⭐ 这对我来说很重要，能给我带来长期更新维护的动力！
+
+## 📱 项目预览
+
+<img src="docs/images/preview/page.png" alt="page"/>
+
+### 📍 项目地址
+
+- **GitHub 地址**：[https://github.com/Joker-x-dev/AndroidProject-Compose](https://github.com/Joker-x-dev/AndroidProject-Compose)
+- **Gitee 地址**：[https://gitee.com/Joker-x-dev/AndroidProject-Compose](https://gitee.com/Joker-x-dev/AndroidProject-Compose)
+
+> 本脚手架源于青商城的实践，仅保留基础能力与功能示例；完整电商业务与全量 UI/动效/完整业务示例请查看青商城：GitHub https://github.com/Joker-x-dev/CoolMallKotlin ｜ Gitee https://gitee.com/Joker-x-dev/CoolMallKotlin
+
+### Demo 下载
+
+**Release 版本（2MB）**：[点击下载体验](https://www.pgyer.com/AndroidProject-Compose)
+- **支持系统**：Android 6.0 及以上
+- **更新说明**：预览版本会不定时更新，可能不会完全同步最新的代码变更
+
+### 说明文档
+
+- **说明文档**：[在线查看](https://compose.dusksnow.top)
+- **说明**：与代码同步的在线文档，包含快速开始、架构说明、示例路由、常见定制点等，便于理解项目与学习。
+
+## 🛠️ 技术栈
+
+### 核心技术
+
+| 类别    | 技术选型                      | 版本号        | 说明                |
+|-------|---------------------------|------------|-------------------|
+| 编程语言  | Kotlin                    | 2.2.21     | 100% Kotlin 开发    |
+| UI 框架 | Jetpack Compose           | 2025.11.01 | 声明式 UI 框架         |
+| 依赖注入  | Hilt                      | 2.57.2     | 基于 Dagger 的依赖注入框架 |
+
+### 功能模块
+
+| 类别    | 技术选型                  | 版本号           | 说明               |
+|-------|-----------------------|---------------|------------------|
+| 导航    | Navigation Compose    | 2.9.6         | Compose 导航组件     |
+| 网络请求  | Retrofit + OkHttp     | 3.0.0 + 5.3.2 | HTTP 客户端         |
+
+### 数据存储
+
+| 类别   | 技术选型 | 版本号   | 说明         |
+|------|------|-------|------------|
+| 数据库  | Room | 2.8.4 | SQLite 数据库 |
+| 本地存储 | MMKV | 2.2.4 | 高性能键值存储    |
+
+### 开发工具
+
+| 类别   | 技术选型          | 版本号    | 说明          |
+|------|---------------|--------|-------------|
+| 日志框架 | Timber        | 5.0.1  | 日志管理        |
+| 网络调试 | Chucker       | 4.2.0  | 网络请求监控      |
+| 内存检测 | LeakCanary    | 2.14   | 内存泄漏检测      |
+
+## 📱 功能模块目录
+
+- **主模块 (main)**
+  - 主页面 (main)
+  - 基础能力示例 (core-demo)
+  - 导航示例 (navigation-demo)
+  
+
+- **认证模块 (auth)**
+  - 登录页 (login)
+
+
+- **用户模块 (user)**
+  - 用户信息 (info)
+
+
+- **示例模块 (demo)**
+  - 通用网络请求示例 (network-demo)
+  - 通用分页列表示例 (network-list-demo)
+  - 数据库示例 (database)
+  - 本地存储示例 (local-storage)
+  - 状态管理示例 (state-management)
+  - 网络请求示例 (network-request)
+  - 带参跳转示例 (navigation-with-args)
+  - 结果回传示例 (navigation-result)
+
+## 项目结构
+
+```
+├── app/                  # 应用入口
+├── core/                 # 核心
+│   ├── base/             # 基础抽象
+│   ├── data/             # 数据层
+│   ├── database/         # 数据库
+│   ├── datastore/        # 数据存储
+│   ├── designsystem/     # 设计系统
+│   ├── model/            # 数据模型
+│   ├── network/          # 网络层
+│   ├── result/           # 结果处理
+│   ├── state/            # 状态管理
+│   ├── ui/               # UI 组件
+│   └── util/             # 工具类
+├── navigation/           # 导航模块
+│   ├── routes/           # 路由定义
+│   ├── results/          # 路由返回结果
+│   └── extension/        # 导航扩展
+├── feature/              # 功能模块
+│   ├── main/             # 主模块
+│   ├── auth/             # 认证模块
+│   ├── user/             # 用户模块
+│   └── demo/             # 示例模块
+└── MainActivityViewModel.kt # 宿主级共享 ViewModel
+```
+
+## 👥 加入群聊
+
+欢迎加入开发者交流群，一起分享学习心得，讨论技术问题！
+
+<div align="left">
+  <img src="docs/images/group/qq.jpg" width="200" alt="QQ群二维码"/>
+  <p>扫码或搜索群号加入 QQ 群</p>
+</div>
+
+## 🤝 参与贡献
+
+这是一个开放的学习项目，欢迎所有对 Android 开发感兴趣的开发者参与贡献！
+
+### 🎯 贡献方式
+
+- **代码贡献**: 提交 Pull Request，完善功能实现或修复问题
+- **问题反馈**: 通过 Issue 报告 Bug 或提出功能建议
+- **文档优化**: 完善项目文档、添加使用说明或开发指南
+- **设计支持**: 提供 UI/UX 设计建议或素材资源
+- **测试协助**: 参与功能测试，提供使用反馈和改进建议
+
+### 📋 贡献指南
+
+- 提交代码前请确保遵循项目的编码规范
+- 新功能开发建议先创建 Issue 讨论可行性
+- 欢迎分享学习心得和技术总结

README_EN.md

@@ -0,0 +1,158 @@
+<div align="center">
+
+<img src="docs/images/graphs/logo.svg" width="120" alt="Logo"/>
+
+# AndroidProject-Compose
+
+_A fast-start Android framework built with Jetpack Compose_
+
+<!-- Language Switch Button -->
+<div align="center">
+  <a href="README.md">🌍 中文</a>
+</div>
+
+[![GitHub](https://img.shields.io/badge/GitHub-AndroidProjectCompose-blue?style=flat-square&logo=github)](https://github.com/Joker-x-dev/AndroidProject-Compose)
+[![Gitee](https://img.shields.io/badge/Gitee-AndroidProjectCompose-red?style=flat-square&logo=gitee)](https://gitee.com/Joker-x-dev/AndroidProject-Compose)
+[![Demo](https://img.shields.io/badge/Demo-Download-green?style=flat-square&logo=android)](https://www.pgyer.com/AndroidProject-Compose)
+[![API](https://img.shields.io/badge/Docs-compose.dusksnow.top-orange?style=flat-square&logo=readthedocs)](https://compose.dusksnow.top)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Joker-x-dev/AndroidProject-Compose)
+
+</div>
+
+## 📖 Project Overview
+
+AndroidProject-Compose is a **single-module Jetpack Compose scaffold** that ships with the essential building blocks for networking, state, navigation, theming, data storage, and database access. It also includes a few feature demo pages so you can “clone → run → plug in your business logic” to quickly build or learn a modern Compose app.
+
+> If this project helps you, please give it a Star ⭐ It means a lot and keeps me motivated to maintain and update the project long-term!
+
+## 📱 Preview
+
+<img src="docs/images/preview/page.png" alt="page"/>
+
+### 📍 Project Links
+
+- **GitHub**: [https://github.com/Joker-x-dev/AndroidProject-Compose](https://github.com/Joker-x-dev/AndroidProject-Compose)
+- **Gitee**: [https://gitee.com/Joker-x-dev/AndroidProject-Compose](https://gitee.com/Joker-x-dev/AndroidProject-Compose)
+
+> This scaffold originates from the CoolMall practice project and keeps only the foundational capabilities plus sample pages. For the full e-commerce business, complete UI/animations, and full-featured demos, see CoolMall: GitHub https://github.com/Joker-x-dev/CoolMallKotlin ｜ Gitee https://gitee.com/Joker-x-dev/CoolMallKotlin
+
+### Demo Download
+
+**Release build (2MB)**: [Download](https://www.pgyer.com/AndroidProject-Compose)
+- **Supported OS**: Android 6.0 and above
+- **Release notes**: Preview builds update occasionally and may not always reflect the latest code changes
+
+### Documentation
+
+- **Docs**: [View online](https://compose.dusksnow.top)
+- **Note**: Online docs stay in sync with the code and cover quick start, architecture, sample routes, common customization points, and more.
+
+## 🛠️ Tech Stack
+
+### Core Technologies
+
+| Category              | Technology          | Version    | Description                  |
+|-----------------------|---------------------|------------|------------------------------|
+| Programming Language  | Kotlin              | 2.2.21     | 100% Kotlin                  |
+| UI Framework          | Jetpack Compose     | 2025.11.01 | Declarative UI framework     |
+| Dependency Injection  | Hilt                | 2.57.2     | Dagger-based DI framework    |
+
+### Feature Modules
+
+| Category   | Technology             | Version       | Description               |
+|------------|------------------------|---------------|---------------------------|
+| Navigation | Navigation Compose     | 2.9.6         | Compose navigation        |
+| Network    | Retrofit + OkHttp      | 3.0.0 + 5.3.2 | HTTP client               |
+
+### Data Storage
+
+| Category      | Technology | Version | Description                      |
+|---------------|------------|---------|----------------------------------|
+| Database      | Room       | 2.8.4   | SQLite database                  |
+| Local Storage | MMKV       | 2.2.4   | High-performance key-value store |
+
+### Development Tools
+
+| Category          | Technology | Version | Description            |
+|-------------------|------------|---------|------------------------|
+| Logging           | Timber     | 5.0.1   | Log management         |
+| Network Debugging | Chucker    | 4.2.0   | Network request monitor|
+| Memory Leak Check | LeakCanary | 2.14    | Memory leak detection  |
+
+## 📱 Feature Module Directory
+
+- **Main Module (main)**
+  - Main page (main)
+  - Core capability demos (core-demo)
+  - Navigation demos (navigation-demo)
+
+- **Auth Module (auth)**
+  - Login (login)
+
+- **User Module (user)**
+  - User info (info)
+
+- **Demo Module (demo)**
+  - Generic network request demo (network-demo)
+  - Generic paged list demo (network-list-demo)
+  - Database demo (database)
+  - Local storage demo (local-storage)
+  - State management demo (state-management)
+  - Network request demo (network-request)
+  - Navigation with args (navigation-with-args)
+  - Navigation result passing (navigation-result)
+
+## Project Structure
+
+```
+├── app/                  # App entry
+├── core/                 # Core
+│   ├── base/             # Base abstractions
+│   ├── data/             # Data layer
+│   ├── database/         # Database
+│   ├── datastore/        # Data storage
+│   ├── designsystem/     # Design system
+│   ├── model/            # Data models
+│   ├── network/          # Network layer
+│   ├── result/           # Result handling
+│   ├── state/            # State management
+│   ├── ui/               # UI components
+│   └── util/             # Utilities
+├── navigation/           # Navigation module
+│   ├── routes/           # Route definitions
+│   ├── results/          # Route results
+│   └── extension/        # Navigation extensions
+├── feature/              # Feature modules
+│   ├── main/             # Main module
+│   ├── auth/             # Auth module
+│   ├── user/             # User module
+│   └── demo/             # Demo module
+└── MainActivityViewModel.kt # Host-level shared ViewModel
+```
+
+## 👥 Join the Community
+
+Welcome to the developer group—share learning notes and discuss technical questions together!
+
+<div align="left">
+  <img src="docs/images/group/qq.jpg" width="200" alt="QQ group QR code"/>
+  <p>Scan or search the group number to join the QQ group</p>
+</div>
+
+## 🤝 Contributing
+
+This is an open learning project. All Android enthusiasts are welcome to contribute!
+
+### 🎯 How to Contribute
+
+- **Code Contributions**: Submit pull requests to improve features or fix issues
+- **Issue Feedback**: Report bugs or suggest features via Issues
+- **Documentation**: Enhance docs, add usage guides or developer guides
+- **Design Support**: Provide UI/UX suggestions or assets
+- **Testing Help**: Join feature testing and share feedback
+
+### 📋 Contribution Guidelines
+
+- Please follow the project coding conventions before submitting code
+- For new features, create an Issue first to discuss feasibility
+- Sharing learning notes and technical takeaways is encouraged

app/proguard-rules.pro

@@ -20,8 +20,13 @@
 # hide the original source file name.
 #-renamesourcefileattribute SourceFile
 
-# toast 混淆规则
--keep class com.hjq.toast.** {*;}
-
-# xxp权限混淆规则
--keep class com.hjq.permissions.** { *; }
+# xxp权限混淆规则 地址: https://github.com/getActivity/XXPermissions/blob/master/library/proguard-permissions.pro
+-keepclassmembers interface com.hjq.permissions.start.IStartActivityDelegate {
+    <methods>;
+}
+-keepclassmembers interface com.hjq.permissions.fragment.IFragmentMethodNative {
+    <methods>;
+}
+-keepclassmembers class androidx.fragment.app.Fragment {
+    androidx.fragment.app.FragmentActivity getActivity();
+}

app/src/main/java/com/joker/kit/core/model/entity/User.kt

@@ -1,5 +1,7 @@
 package com.joker.kit.core.model.entity
 
+import androidx.annotation.Keep
+
 import kotlinx.serialization.Serializable
 
 /**
@@ -18,6 +20,7 @@ import kotlinx.serialization.Serializable
  * @param updateTime 更新时间
  * @author Joker.X
  */
+@Keep
 @Serializable
 data class User(
 

app/src/main/java/com/joker/kit/core/model/network/NetworkResponse.kt

@@ -1,5 +1,7 @@
 package com.joker.kit.core.model.network
 
+import androidx.annotation.Keep
+
 import kotlinx.serialization.Serializable
 
 /**
@@ -11,6 +13,7 @@ import kotlinx.serialization.Serializable
  * @param message 出错的提示信息
  * @author Joker.X
  */
+@Keep
 @Serializable
 data class NetworkResponse<T>(
     /**

app/src/main/java/com/joker/kit/core/network/service/UserInfoService.kt

@@ -1,5 +1,7 @@
 package com.joker.kit.core.network.service
 
+import androidx.annotation.Keep
+
 import com.joker.kit.core.model.entity.User
 import com.joker.kit.core.model.network.NetworkResponse
 import retrofit2.http.GET
@@ -9,6 +11,7 @@ import retrofit2.http.GET
  *
  * @author Joker.X
  */
+@Keep
 interface UserInfoService {
 
     /**