HiveControl (蜂控)

一款基于 Electron + React + TypeScript 开发的 Android 设备管理工具，提供直观的图形界面来管理 ADB 连接的设备。

✨ 功能特性

设备管理

• 🔌 自动检测 USB 连接的 Android 设备
• 📶 支持 TCP/IP 无线连接
• 📱 显示设备详细信息（型号、Android 版本、电量、存储等）
• ✅ 批量选择设备进行操作

文件浏览器

• 📁 浏览设备文件系统
• 🔍 文件搜索/过滤
• 📊 多种排序方式（名称、大小、类型、时间）
• ☑️ 多选文件操作（Ctrl+点击、Shift+范围选择）
• 📥 下载文件到本地
• 📤 上传文件到设备（支持拖拽上传）
• ✂️ 复制、剪切、粘贴、重命名、删除
• 📂 新建文件夹/文件
• 📋 查看文件属性（权限、所有者、修改时间等）

文件预览与编辑

• 🖼️ 图片预览（支持 JPG、PNG、GIF、WebP、SVG 等）
• 📝 代码编辑器（支持语法高亮）
• 🌐 多编码支持（UTF-8、GBK、GB2312 等）
• 💾 Ctrl+S 快捷保存

Shell 终端

• 💻 交互式 ADB Shell
• 📜 命令历史记录

界面特性

• 🌙 深色/浅色主题切换
• 🌍 中英文双语支持
• 🎨 现代化 UI 设计（基于 shadcn/ui）

🚀 快速开始

环境要求

• Node.js 18+
• pnpm（推荐）或 npm
• ADB 工具（需要在系统 PATH 中）

安装依赖

pnpm install

开发模式

pnpm dev

构建应用

# Windows
pnpm build:win

# macOS
pnpm build:mac

# Linux
pnpm build:linux

📁 项目结构

src/
├── main/                 # Electron 主进程
│   ├── index.ts         # 主进程入口
│   ├── ipc/             # IPC 通信处理
│   └── services/        # ADB 服务封装
├── preload/             # 预加载脚本
├── renderer/            # 渲染进程 (React)
│   └── src/
│       ├── components/  # UI 组件
│       ├── hooks/       # React Hooks
│       ├── i18n/        # 国际化
│       └── lib/         # 工具函数
└── shared/              # 共享类型定义

🛠️ 技术栈

• 框架: Electron + React 19
• 语言: TypeScript
• 构建: electron-vite + Vite
• UI: Tailwind CSS + shadcn/ui + Radix UI
• ADB: @devicefarmer/adbkit
• 编辑器: CodeMirror 6

📝 开发命令

pnpm dev          # 启动开发服务器
pnpm build        # 构建应用
pnpm lint         # 代码检查
pnpm format       # 代码格式化
pnpm typecheck    # 类型检查

📄 License

MIT