# GithubStarsManager

一个使用 React Native (Expo) 构建的移动端应用，用于管理和浏览你在 GitHub 上星标的仓库。

## 功能

- **同步星标仓库** — 通过 GitHub API 一键同步你所有星标的仓库
- **智能分类** — 自动根据仓库的语言、描述等特征对仓库进行分类
- **分类管理** — 手动调整仓库分类，支持拖拽排序
- **搜索筛选** — 按分类快速筛选仓库
- **数据本地存储** — 所有数据保存在本地 SQLite 数据库中，无需担心隐私问题

## 技术栈

| 技术 | 用途 |
|------|------|
| [React Native](https://reactnative.dev/) 0.81 | 跨平台移动框架 |
| [Expo](https://expo.dev/) SDK 54 | 开发工具链与原生模块管理 |
| [expo-sqlite](https://docs.expo.dev/versions/latest/sdk/sqlite/) | 本地数据持久化 |
| [react-native-markdown-display](https://github.com/iamacup/react-native-markdown-display) | Markdown 渲染 |
| [react-native-syntax-highlighter](https://github.com/conorhastings/react-native-syntax-highlighter) | 代码语法高亮 |
| [@expo/vector-icons](https://docs.expo.dev/guides/icons/) | UI 图标系统 |

## 快速开始

### 前置条件

- Node.js >= 18
- npm 或 yarn
- GitHub 个人访问令牌（Personal Access Token）

### 获取 GitHub Token

1. 访问 [GitHub Settings > Developer settings > Personal access tokens](https://github.com/settings/tokens)
2. 点击 **Generate new token (classic)**
3. 勾选 `repo`  `user` 权限范围
4. 生成并复制 Token

### 安装与运行

```bash
# 克隆仓库
git clone https://github.com/EchoZenith/GithubStarsManager-Android.git
cd GithubStarsManager-Android

# 安装依赖
npm install

# 启动开发服务器
npx expo start

# 或在 Android 设备/模拟器上直接运行
npx expo run:android
```

首次启动时会提示输入 GitHub Token，粘贴后即可开始同步仓库。

## 项目结构

```
GithubStarsManager/
├── assets/              # 应用图标与静态资源
│   ├── icon.png         # 主图标
│   ├── adaptive-icon.png # Android 自适应图标
│   ├── splash-icon.png  # 启动页图标
│   └── favicon.png      # Web 图标
├── components/          # 可复用组件
│   ├── RepoItem.js      # 仓库列表项
│   └── TokenInput.js    # Token 输入组件
├── screens/             # 页面
│   ├── HomeScreen.js    # 首页：仓库列表与分类浏览
│   ├── RepoDetailScreen.js # 仓库详情与 README 展示
│   ├── CategoryManageScreen.js # 分类管理
│   └── SettingsScreen.js # 设置页
├── services/            # 业务逻辑
│   ├── github.js        # GitHub API 封装
│   ├── database.js      # SQLite 数据库操作
│   └── categorizer.js   # 自动分类引擎
├── App.js               # 应用入口与路由
├── app.json             # Expo 配置
└── package.json         # 依赖管理
```

## 自动分类

应用内置了基于语言和关键词的自动分类引擎，支持 13 个分类：

| 分类 | 匹配逻辑 |
|------|---------|
| Web 应用 | HTML/CSS/JS/TS + 相关关键词 |
| 移动应用 | Java/Kotlin/Dart/Swift + 相关关键词 |
| 桌面应用 | C++/C#/Go/Rust/Zig + 相关关键词 |
| AI/机器学习 | Python + 机器学习相关关键词 |
| 数据库 | SQL + 数据库相关关键词 |
| 开发工具 | Shell/Dockerfile + 工具类关键词 |
| 安全工具 | 安全相关关键词 |
| 游戏 | 游戏开发相关关键词 |
| 设计工具 | UI/UX 相关关键词 |
| 效率工具 | 效率工具类关键词 |
| 教育学习 | Awesome/教程/文档类关键词 |
| 社交网络 | 社交/通讯类关键词 |
| 数据分析 | R/Julia + 数据分析类关键词 |

## 致谢

感谢 [AmintaCCCP/GithubStarsManager](https://github.com/AmintaCCCP/GithubStarsManager) 仓库提供的灵感与参考。

## 许可证

[MIT](LICENSE)