diff --git a/README.md b/README.md new file mode 100644 index 0000000..e664d77 --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ +# Favorites - 安卓书签导航器 + +一个轻量、美观的 Android 书签管理 + 多标签浏览器,适合自建导航页收藏夹。 + +## 📱 功能总览 + +### 🏠 书签导航首页 +- **固定首页书签** — 顶部固定「热门导航」等常用链接 +- **二级分类** — 支持 `科技/AI工具` 格式,自动按两级分组显示 +- **折叠分类** — 分类默认折叠,点击展开/收起(状态记忆) +- **空状态引导** — 首次使用显示添加书签指引 + +### 🌐 多标签浏览器 +- **独立 WebView** — 每个标签页独立运行,切换不刷新,页面状态完整保留 +- **底部标签栏** — 固定在底部,紧凑美观不遮挡网页 +- **标签切换** — 点击切换,显示/隐藏瞬时完成 +- **关闭标签** — 每个标签可单独关闭,自动销毁释放内存 + +### 📥 导入功能 +- **粘贴导入** — 批量粘贴 URL,每行一个 +- **文件导入** — 导入 Edge/Chrome 导出的 HTML 书签文件 + - 自动保留文件夹层级作为分类(如 `收藏夹栏/科技/AI工具`) +- **WebDAV 导入** — 从 WebDAV 服务器恢复书签备份 + +### ☁️ WebDAV 同步 +- **导出备份** — 将书签导出为 JSON 到 WebDAV 服务器(文件名 `favorites_bookmarks.json`) +- **导入恢复** — 从 WebDAV 服务器恢复书签 +- **Basic Auth** — 支持用户名/密码认证 +- **可配置** — 服务器地址、用户名、密码在 APP 内直接设置 + +### 🎨 界面 +- **Material Design** — 卡片式布局、阴影层次、圆角设计 +- **自适应图标** — Android 8.0+ 自适应图标,金色五角星 + 深蓝底色 +- **返回手势** — 内页按一次后退,按两次回首页;首页按两次退出 +- **小屏幕优化** — 100dp 紧凑标签,固定宽度不跳动 + +## 🔧 技术栈 + +| 技术 | 说明 | +|------|------| +| **语言** | Kotlin | +| **最低 API** | 24 (Android 7.0) | +| **构建** | Gradle 8.5 + Android SDK 35 | +| **WebView** | 多实例独立运行 | +| **存储** | SharedPreferences (JSON 序列化书签) | +| **UI** | 原生 View + 自定义 Drawable | + +## 🚀 构建 + +```bash +# 克隆 +git clone https://github.com/personal82555/android-favorites.git +cd android-favorites + +# 构建 APK +bash build-apk.sh +``` + +构建产物在 `/vol2/1000/HD2/APK/favorites_v{N}.apk`(需修改 `build-apk.sh` 中的输出路径)。 + +## 📄 许可证 + +MIT