flutter_opencode_client/PROJECT_STRUCTURE.md

ServerBox 项目结构说明

项目概述

• 名称: ServerBox (flutter_openclaw_client)
• 版本: 1.0.1351+1351
• 描述: 跨平台服务器状态监控和 SSH 管理工具
• 包名: tech.lolli.toolbox

技术栈

• 框架: Flutter 3.29+
• 语言: Dart 3.11+
• 状态管理: Riverpod
• 本地存储: Hive

目录结构

lib/ - 主代码目录

lib/
├── main.dart              # 应用入口
├── app.dart               # 应用配置
├── intro.dart             # 引导页面
├── core/                  # 核心功能
├── data/                  # 数据层
│   ├── model/            # 数据模型
│   ├── store/            # 状态存储
│   └── res/              # 资源定义
├── view/                  # 视图层
│   ├── page/             # 页面
│   │   ├── container/    # 容器管理
│   │   ├── private_key/  # SSH 密钥管理
│   │   ├── server/       # 服务器管理
│   │   ├── setting/      # 设置
│   │   ├── snippet/      # 代码片段
│   │   └── storage/      # 存储管理
│   └── widget/           # 公共组件
├── generated/            # 生成的代码
│   └── l10n/            # 本地化
└── hive/                # Hive 适配器

android/ - Android 平台配置

android/
├── app/
│   ├── build.gradle      # 应用构建配置
│   ├── debug.keystore    # 调试签名密钥
│   └── src/main/
│       ├── AndroidManifest.xml
│       ├── kotlin/tech/lolli/toolbox/
│       │   ├── MainActivity.kt
│       │   ├── ForegroundService.kt
│       │   └── widget/
│       │       ├── HomeWidget.kt
│       │       └── WidgetConfigureActivity.kt
│       └── res/          # 资源文件
├── build.gradle          # 项目构建配置
├── key.properties        # 签名配置
├── local.properties      # 本地配置
└── gradle.properties     # Gradle 配置

packages/ - 本地包

packages/
├── circle_chart/         # 圆形图表组件
├── dartssh2/            # SSH2 客户端
├── fl_build/            # 构建工具
├── fl_lib/              # 公共库
├── plain_notification_token/  # 通知令牌
├── server_box_monitor/  # 服务器监控
├── watch_connectivity/  # 手表连接
└── xterm/               # 终端模拟器

构建配置

签名配置 (android/key.properties)

storeFile=app/debug.keystore
storePassword=android
keyAlias=androiddebugkey
keyPassword=android

版本信息

• versionName: 1.0.1351
• versionCode: 1351
• minSdk: Flutter 默认
• targetSdk: Flutter 默认

主要功能模块

1. 服务器管理

   • SSH 连接和终端
   • SFTP 文件传输
   • 服务器状态监控 (CPU, 内存, 磁盘, 网络)
   • Docker 容器管理
   • 进程管理

2. Snippet (代码片段)

   • 保存和快速执行常用命令

3. 密钥管理

   • SSH 私钥管理

4. 容器管理

   • Docker 容器操作

5. 系统工具

   • 网络唤醒 (Wake-on-LAN)
   • 端口转发

平台支持

• Android
• iOS
• macOS
• Linux
• Windows

构建命令

获取依赖

flutter pub get

构建 APK

flutter build apk --release

构建 App Bundle

flutter build appbundle --release

构建指定 ABI

flutter build apk --release --target-platform android-arm64

项目依赖

主要依赖

• flutter_riverpod: 状态管理
• dio: 网络请求
• dartssh2: SSH 连接
• hive_ce_flutter: 本地存储
• fl_chart: 图表
• xterm: 终端模拟

开发依赖

• build_runner: 代码生成
• freezed: 不可变类生成
• json_serializable: JSON 序列化
• riverpod_generator: Riverpod 代码生成

注意事项

1. 首次构建需要运行代码生成:

   dart run build_runner build
   

2. 本项目使用本地包，位于 packages/ 目录

3. Android 构建需要配置签名密钥 (已配置 debug 密钥)

4. 国际化文件已预生成，位于 lib/generated/l10n/