# 泰山派M1管理面板

**Repository Path**: qianmonai/TaishanPiManager-Desktop

## Basic Information

- **Project Name**: 泰山派M1管理面板
- **Description**: 这是一个面向 泰山派 RK3566 开发板 的 Windows 原生桌面管理工具，它通过 ADB 连接和管理开发板。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-20
- **Last Updated**: 2026-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 泰山派设备管理 · TaishanPi Manager Desktop

面向 LCSC TaishanPi RK3566 的 Windows 桌面设备管理工具，基于 Python 和 PySide6 开发。本页为 Gitee 精简介绍。

## 主要功能

| 模块 | 说明 |
| --- | --- |
| 设备概览 | 查看设备型号、系统版本、CPU、内存和存储状态 |
| 文件管理 | 浏览目录，在电脑与开发板之间传输文件 |
| 系统日志 | 查看和导出设备日志，辅助定位运行问题 |
| 交互终端 | ADB 终端会话和多标签操作 |
| 连接设置 | 通过 USB 或可信局域网连接开发板 |
| 插件中心 | 导入经用户审查和信任的插件包，展示页面和状态卡片 |
| 硬件工具 | 串口、GPIO、I²C、SPI、PWM、摄像头和 LD06 雷达调试 |

## 快速开始

### 使用运行包

前往 [Gitee 发行版页面](https://gitee.com/qianmonai/TaishanPiManager-Desktop/releases)，以页面实际提供的附件为准。源码归档不是 Windows 运行包。

1. 完整解压 Windows x64 运行包。
2. 保留 `TaishanPiManager.exe` 同目录的 `adb`、`iperf3` 和 `licenses` 文件夹。
3. 使用支持数据传输的 USB 线连接开发板，确认设备系统已启用 ADB。
4. 运行程序，点击“刷新设备”并选择设备。

仅操作自己拥有或明确获准管理的设备。文件覆盖、脚本执行、配置修改和重启前，请确认目标并备份重要数据。不要将调试接口直接暴露到不可信网络。

### 从源码运行

建议使用 Windows x64 和 Python 3.13。在项目根目录的 PowerShell 中执行：

```powershell
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install PySide6==6.11.2 pyte==0.8.2 wcwidth==0.8.3 PyYAML==6.0.3
.\.venv\Scripts\python.exe source\desktop.py
```

请保留项目中的 `adb` 目录。完整步骤见[运行与构建](docs/运行与构建.md)。

## 连接说明

v2.67 使用电脑端独立 ADB 服务地址 `127.0.0.1:5038`，不再默认共用其他设备管理软件的 `5037`。此端口与开发板网络 ADB 的 `5555` 不同，无需因此修改板端配置。

升级时先退出旧版，再运行新版；局域网设备需要在新版重新连接。独立端口不能完全避免 USB 设备占用冲突，如遇异常，请退出其他正在使用该设备的软件后重试。

“检查更新”仅在手动点击时查询 Gitee，在侧栏显示结果，不自动下载安装。部分环境可能出现超时或 HTTP 401，此问题尚未确认解决；检查失败不代表当前程序已是最新版。

## 第三方插件

插件由声明文件和板端脚本组成，可提供操作入口、独立页面和状态卡片。导入前请确认来源并审查脚本；受信任脚本会通过当前 ADB 会话在设备上执行。

- [第三方插件开发指南](docs/第三方插件开发.md)
- [设备信息示例](examples/device-info/)
- [界面展示示例](examples/ui-showcase/)

示例通过主程序统一调用 ADB，在 v2.67 中自动使用独立端口，无需为此修改插件包。

## 项目结构

```text
source/       桌面端源码与测试
examples/     第三方插件示例
plugins/      随应用分发的板端插件
docs/         使用、开发及验证文档
adb/          ADB 工具
iperf3/       网络测试工具
licenses/     第三方组件许可证
dist/         构建产物
```

## 版本与验证

当前代码版本为 v2.67。项目保留从 v1.0 起的迭代历史，见 [Gitee 标签列表](https://gitee.com/qianmonai/TaishanPiManager-Desktop/tags)。`v2.67` 是修改前基线，`v2.67-release` 是对应发布代码的标签；标签存在不代表 Gitee 已提供发行版附件。

v2.67 的 190 项回归测试和运行包解压启动检查通过，但未进行与其他设备管理软件同时运行的完整硬件验证。详见 [v2.67 验证记录](docs/v2.67验证记录.md)。

```powershell
.\.venv\Scripts\python.exe -B -m unittest discover -s source -p "test_*.py"
```

## 问题反馈

欢迎通过仓库 Issue 提交问题，请提供程序版本、开发板系统、连接方式、复现步骤及必要的错误信息。分享日志或截图前，请删除密码、令牌、私钥等个人信息。

## 许可证与组件

第三方组件分别遵循其原始许可证。相关声明和许可证保留在 [licenses](licenses/) 与[第三方组件说明](docs/第三方组件说明.md)中。