# RemoteTool

**Repository Path**: MagicHand/remote-tool-r

## Basic Information

- **Project Name**: RemoteTool
- **Description**: 一个远程辅助工具，目前实现了远程设备信息的记录、搜索、一键连接的功能，支持国内的ToDesk和向日葵的远程连接，从此妈妈再也不用担心我记不住账号了
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2023-01-07
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RemoteTool

远程辅助桌面应用：集中记录设备信息、快速搜索，并一键唤起常用远控客户端进行连接，避免反复查找账号与识别码。支持的远程方式包括 **ToDesk**、**向日葵**、**RustDesk** 以及 **MSTSC**（Windows 远程桌面连接）。

---

## 功能概览

- 设备信息的录入、保存与检索  
- 关键词搜索（支持项目名称、设备名称，或「项目名 + 空格 + 设备名」组合）  
- 空格键快速查看最近使用过的 10 台设备  
- 常用远控一键连接：**ToDesk**、**向日葵**、**RustDesk**、**MSTSC**（各工具连接方式与配置要点见下文）  
- 主题等选项可通过右上角配置入口调整  

---

## 技术栈

| 类别 | 说明 |
|------|------|
| UI / MVVM | HandyControl（基于官方例程模板改造、界面简化）、MvvmLight |
| 数据 | SQLite、SqlSugar |

主程序为 **.NET Framework 4.7.2** 的 WPF 客户端（`RemoteTool` 工程），解决方案文件：`RemoteTool.sln`。

---

## 环境要求与构建

- Windows  
- Visual Studio（建议带 **.NET 桌面开发** 工作负载）  
- 克隆仓库后打开 `RemoteTool.sln`，还原 NuGet 包并生成解决方案即可调试运行主项目 `RemoteTool`。

---

## 使用说明

### 1. 配置远控程序路径

首次使用前，在设置中配置 **ToDesk**、**向日葵**、**RustDesk** 的可执行文件路径（指向安装目录或实际可执行文件所在位置；RustDesk 需能解析到该目录下的 `rustdesk.exe`）。**MSTSC** 使用系统自带的 `mstsc.exe`，无需单独配置安装路径。

![高级配置](RemoteTool/Resources/Img/Samples/setting.png)

### 2. 添加设备

新建设备、填写信息后保存，即可在主界面列表中看到。按 **空格** 可快速列出最近使用过的 10 台设备。

![添加设备](RemoteTool/Resources/Img/Samples/add-device.png)

### 3. 搜索与连接

在搜索框输入关键词，点击「搜索」或按 **Enter** 检索。索引字段包括：项目名称、设备名称，或「项目名称 + 空格 + 设备名称」的组合。

![搜索与连接](RemoteTool/Resources/Img/Samples/remote.png)

### 4. 各远程工具说明

- **ToDesk**：通过官方支持的命令行参数启动连接，过程相对直接。  
- **向日葵**：10 及以上版本不再支持同类命令行方式，本工具对高版本采用**模拟键盘输入**完成连接，因此会比 ToDesk 略慢，属预期行为。  
- **RustDesk**：在已配置路径的前提下，使用 `rustdesk.exe` 的命令行参数发起连接（`--connect` 远程 ID，可选 `--password` 传递密码）。  
- **MSTSC（远程桌面）**：调用系统 **mstsc**。设备侧请将远程地址填为 **`IP或主机名#用户名`** 格式，并填写对应密码；程序会通过 `cmdkey` 为对应 TERMSRV 目标缓存凭据后再启动连接。若在设备上维护了 RDP 扩展属性，连接时会生成临时 `.rdp` 文件并交给 mstsc 打开。

### 5. SSH远程

![输入图片说明](RemoteTool/Resources/Img/Samples/ssh.png)

### 6. 命令行

![输入图片说明](RemoteTool/Resources/Img/Samples/cmd.png)

### 7. 主题与外观

点击右上角**配置**图标可修改主题等选项。

![黑色主题](RemoteTool/Resources/Img/Samples/black.png)

![紫色主题](RemoteTool/Resources/Img/Samples/purple.png)
---

## 参与贡献

1. Fork 本仓库  
2. 从 `develop`（或当前主开发分支）新建功能分支，例如 `feat/your-feature`  
3. 提交变更并推送到你的 Fork  
4. 发起 Pull Request，简要说明改动与测试情况  

欢迎 Issue 反馈问题或功能建议。