# 子比移动端APP

**Repository Path**: tyopen/zibll-app

## Basic Information

- **Project Name**: 子比移动端APP
- **Description**: 基于子比主题 (Zibll) 的 Flutter 移动端应用，适配 WordPress 社区生态。
- **Primary Language**: Dart
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 3
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 子比APP, 子比, WordPress

## README

# Zibll App (子比主题移动端)

[![Flutter](https://img.shields.io/badge/Flutter-3.16.0+-02569B?logo=flutter&logoColor=white)](https://flutter.dev/)
[![Zibll](https://img.shields.io/badge/Zibll-WordPress_Theme-FF6B6B)](https://www.zibll.com/)

基于 Flutter 和 TDesign 开发的 **子比主题 (Zibll)** 移动端应用，完美适配 WordPress 子比主题生态，提供原生级别的社区与博客交互体验。

## 项目定位

本项目致力于将子比主题 (Zibll) 的强大功能延伸至移动端，通过高度集成的 API 接口，实现与 Web 端数据的实时同步，并延续子比主题简约、大气、现代的设计哲学。

## 核心功能 (适配 Zibll 特性)

- **论坛系统 (BBS)**: 完整支持版块、话题、标签、帖子评分、收藏、点赞等 Zibll 核心论坛功能。
- **文章系统 (Blog)**: 优雅的博文阅读体验，支持专题、分类、文章点赞/收藏及深度评论。
- **互动评论**: 支持 Zibll 特色的嵌套回复、回复指定用户、IP 属地显示及热评标识。
- **个人中心**:
  - **用户成就**: 勋章墙、等级系统 (Lv10+)、经验记录、积分商城。
  - **财务系统**: 余额记录、积分记录、充值历史 (对接 Zibll 支付生态)。
  - **社交系统**: 关注/粉丝、私信聊天室、系统通知提醒。
- **任务系统**: 每日签到、登录奖励、积分任务、经验任务。
- **极致体验**: 深度适配子比主题的**暗黑模式**，并使用 TDesign 组件库保持 UI 的一致性与流畅度。

## 技术栈与规范

- **基础框架**: [Flutter](https://flutter.dev/)
- **UI 引擎**: [TDesign Flutter](https://tdesign.tencent.com/flutter/) (适配子比简约风格)
- **状态管理**: [GetX](https://pub.dev/packages/get)
- **网络层**: [Dio](https://pub.dev/packages/dio) (对接 `wp-json/zibll/v1` API)
- **版本管理**: 强制使用 **FVM** 锁定 Flutter SDK 版本。
- **开发准则**: 详见 `.trae/rules/zibll.md`，重点区分“帖子 (Post)”与“文章 (Blog)”。

## 域名修改说明

如果需要修改 API 接口域名，请参考以下两种方式：

### 1. 运行/构建时动态注入 (推荐)
在运行或构建命令中使用 `--dart-define` 注入 `API_BASE_URL` 参数：
```bash
# 运行
fvm flutter run --dart-define=API_BASE_URL=https://your-domain.com/wp-json/zibll/v1

# 构建 APK
fvm flutter build apk --dart-define=API_BASE_URL=https://your-domain.com/wp-json/zibll/v1
```

### 2. 修改源码默认值
如果需要永久修改默认域名，请编辑 `lib/network/app_api.dart` 文件中的 `kApiBaseUrl` 常量：
```dart
// lib/network/app_api.dart
const String kApiBaseUrl = String.fromEnvironment(
  'API_BASE_URL',
  defaultValue: 'https://your-domain.com/wp-json/zibll/v1',
);
```

## 更新日志
详见 [CHANGELOG.md](./CHANGELOG.md)。

## 贡献与反馈

如果您在使用的过程中发现了 Bug，或者有好的建议，欢迎通过以下方式参与：

- **Bug 反馈**: 请在 [Gitee Issues](https://gitee.com/tyopen/zibll-app/issues) 提交您发现的问题。
- **参与贡献**: 欢迎提交 [Pull Request (PR)](https://gitee.com/tyopen/zibll-app/pulls) 来完善项目。在提交前，请务必阅读 `PUSH_RESTRICTIONS.md`，确保代码符合安全与性能要求。

## 运行与开发

```bash
# 确保已安装 fvm
fvm flutter pub get

# 运行 Debug 模式
fvm flutter run --dart-define=API_BASE_URL=https://your-zibll-site.com/wp-json/zibll/v1
```

## 贡献指南

如果您想参与贡献，请参考 [贡献与反馈](#贡献与反馈) 章节。