# app_test_studio

**Repository Path**: DamonT/app_test_studio

## Basic Information

- **Project Name**: app_test_studio
- **Description**: 测试工具编辑器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AppTestStudio - 移动应用测试工作台

> 🎯 一款专为测试工程师打造的桌面工具，基于 Python + PySide6 构建

## 📸 功能概览

| 模块 | 功能 |
|------|------|
| 📝 **笔记** | Markdown编辑器，支持测试点记录、复现步骤、思维发散 |
| 🐛 **BUG记录** | 本地BUG管理 + **禅道开源版API对接** |
| 📊 **测试报告** | 测试执行记录 + HTML报告生成 |
| 📱 **设备管理** | Android ADB设备控制、截图、录屏、日志抓取 |
| 🧠 **思维导图** | XMind风格导图 + 一键生成测试要点 |

## ✨ 新增功能

### 🌙 主题切换
- **浅色主题** - 经典白色界面
- **深色主题** - 护眼黑色界面
- 一键切换：视图菜单 → 选择主题
- 自动保存主题偏好

### ☁️ 禅道开源版对接
- ✅ 创建BUG到禅道开源版
- ✅ 从禅道拉取BUG列表
- ✅ 状态同步
- ✅ 优先级/严重程度自动映射

## 🚀 快速开始

### 环境要求
- Python 3.10+
- Windows/Linux/macOS

### 安装依赖

```bash
pip install -r requirements.txt
```

### 运行应用

```bash
python main.py
```

或双击 `start.bat`

## 📦 打包为EXE

### 使用打包脚本

```bash
# 双击运行
build.bat
```

或手动打包：

```bash
pip install pyinstaller
pyinstaller pyinstaller.spec --clean
```

### EXE文件位置

打包完成后，可执行文件位于：
```
dist\AppTestStudio.exe
```

## ⚙️ 配置说明

### 禅道开源版配置

1. 点击菜单 **文件 → 设置**
2. 切换到 **禅道对接** 标签
3. 填写：
   - **禅道地址**：`http://zentao.company.com`
   - **用户名**：你的禅道账号
   - **密码**：你的禅道密码
   - **产品ID**：禅道中的产品ID
4. 点击 **保存**

### API说明

禅道开源版使用 API v1 接口：
- 登录：`POST /api.php/v1/users/login`
- 创建BUG：`POST /api.php/v1/bugs`
- 获取BUG：`GET /api.php/v1/bugs`

## 📁 数据存储

数据默认存储在用户目录：
```
Windows: C:\Users\<用户名>\.app_test_studio\
├── config.json          # 配置文件
├── app_test_studio.db   # SQLite数据库
├── notes/               # 笔记MD文件
├── reports/             # 测试报告
├── screenshots/         # 截图
└── recordings/          # 录屏
```

## 🗺️ 项目结构

```
app_test_studio/
├── main.py                    # 主入口（含主题管理）
├── requirements.txt           # 依赖列表
├── start.bat                  # Windows启动脚本
├── build.bat                  # 打包脚本
├── pyinstaller.spec           # PyInstaller配置
├── README.md                  # 说明文档
├── core/                      # 核心模块
│   ├── config.py              # 配置管理
│   ├── database.py            # 数据库
│   └── settings_dialog.py      # 设置对话框
└── modules/                   # 功能模块
    ├── notes/                  # 笔记
    ├── bug/                    # BUG管理
    ├── report/                 # 测试报告
    ├── device/                 # 设备管理
    └── mindmap/                # 思维导图
```

## 🎨 主题预览

### 浅色主题
经典Fusion风格，清晰的白色界面，适合日常使用。

### 深色主题
深灰色背景，柔和的文字颜色，有效减少眼睛疲劳，适合长时间使用。

## 📝 依赖列表

```
PySide6>=6.6.0        # GUI框架
markdown>=3.5         # Markdown解析
Pillow>=10.0.0       # 图片处理
requests>=2.31.0      # HTTP请求
sqlalchemy>=2.0.0    # 数据库ORM
python-dateutil>=2.8.0 # 日期处理
```

## ❓ 常见问题

**Q: ADB检测不到设备**
- 确保手机已开启USB调试
- 检查USB驱动是否安装
- 尝试重新插拔USB线

**Q: 禅道同步失败**
- 检查禅道地址是否可访问
- 确认用户名密码正确
- 检查API接口权限

**Q: 打包后运行出错**
- 确保所有依赖已安装
- 检查是否有中文字符路径问题
- 尝试使用管理员权限运行

## 📄 许可证

本项目仅供学习交流使用

---

**Made with ❤️ for Testers**

版本: 1.0.1 | 更新日期: 2026-03-23