Open Hexo

一个跨平台的 Hexo 博客管理客户端。

当前支持平台：Android
iOS、Windows、macOS、Linux 平台支持正在规划中。

✨ 功能特性

📝 文章管理

文章列表：支持列表视图和时间线视图切换
文章编辑：Markdown 编辑器，支持实时预览
文章预览：精美的文章详情页面
智能图标：根据文章标签自动匹配图标

🔧 Git 集成

仓库克隆：一键克隆 Hexo 博客仓库
拉取推送：快速同步本地和远程仓库
自动提交：保存文章自动添加到 Git 索引

🎨 界面设计

现代 UI：Material Design 3 设计风格
深色模式：自动跟随系统主题
Hero 动画：流畅的页面过渡效果
响应式布局：适配各种屏幕尺寸

📂 多平台支持

当前支持：

✅ Android

计划支持：

🔲 iOS
🔲 Windows
🔲 macOS
🔲 Linux

🚀 快速开始

环境要求

Flutter SDK 3.24 或更高版本
Dart SDK 3.0 或更高版本
Git

安装步骤

克隆仓库

1 2	git clone https://github.com/your-username/open_hexo.git cd open_hexo

安装依赖
1
flutter pub get
运行应用
1
flutter run

构建发布版本

本地构建

# Android APK
flutter build apk --release

# Android App Bundle (用于上架 Google Play)
flutter build appbundle --release

自动构建（GitHub Actions）

本项目配置了 GitHub Actions 自动构建签名的 APK。详见 GitHub Actions 配置指南。

快速开始：

配置 GitHub Secrets（详见配置指南）
创建 tag 触发构建：
1
2
git tag v1.0.0
git push origin v1.0.0
在 Releases 页面下载签名的 APK

📖 使用说明

首次配置

打开应用，进入「配置」页面
填写 GitHub 仓库信息：
- 仓库地址（必填）
- 认证用户名（必填）
- 访问令牌（推送时需要）
- 分支（默认 main）
点击「连接」按钮，自动克隆仓库

文章操作

新建文章：点击右下角浮动按钮 → 新建
编辑文章：点击文章卡片的编辑图标
预览文章：点击文章卡片
删除文章：在编辑页面点击删除按钮

Git 同步

拉取更新：点击浮动按钮 → 拉取
推送更改：点击浮动按钮 → 推送

🛠️ 技术栈

框架：Flutter
状态管理：Provider
Git 操作：直接调用 Git 命令行工具
Markdown 解析：flutter_markdown
YAML 解析：yaml
路径处理：path

📂 项目结构

open_hexo/
├── lib/
│   ├── models/          # 数据模型
│   ├── providers/       # 状态管理
│   ├── screens/         # 页面
│   ├── services/        # 业务逻辑
│   ├── widgets/         # 自定义组件
│   └── main.dart        # 应用入口
├── android/             # Android 平台代码
├── .github/
│   └── workflows/       # GitHub Actions 工作流
├── docs/                # 文档
├── test/                # 测试文件
├── LICENSE              # MIT 许可证
└── README.md            # 项目说明