Init: Migrate SimpleRemoter (Since v1.3.1) to Gitea

docs/UserManual.md

@@ -0,0 +1,576 @@
+# YAMA 日常使用手册
+
+> 远程管理功能详解
+
+---
+
+## 目标读者
+
+- 已完成部署的用户
+- 需要了解各项远程管理功能
+- 日常运维参考
+
+> 首次部署请先阅读[快速部署指南](QuickStart.md)
+
+---
+
+## 第一部分：界面概览
+
+### 1. 主界面布局
+
+YAMA 主界面由以下部分组成：
+
+```
+┌─────────────────────────────────────────────────┐
+│  菜单栏（主控、工具、扩展、参数、帮助）           │
+├─────────────────────────────────────────────────┤
+│  工具栏（常用功能快捷按钮）                       │
+├─────────────────────────────────────────────────┤
+│                                                   │
+│                                                   │
+│              主机列表区域                          │
+│         （显示所有受管端信息）                     │
+│                                                   │
+│                                                   │
+├─────────────────────────────────────────────────┤
+│  状态栏（主机统计 | FRP状态 | 授权信息）          │
+└─────────────────────────────────────────────────┘
+```
+
+### 2. 主机列表
+
+主机列表显示所有已连接的受管端信息：
+
+| 列名 | 说明 |
+|------|------|
+| IP 地址 | 受管端的网络地址 |
+| 计算机名 | 受管端的主机名 |
+| 操作系统 | Windows 版本信息 |
+| 用户名 | 当前登录用户 |
+| 分组 | 自定义分组标签 |
+| 备注 | 自定义说明 |
+| 上线时间 | 受管端连接时间 |
+
+**列表操作：**
+- 单击：选中主机
+- 双击：显示主机详细信息
+- 右键：显示操作菜单
+- Ctrl+单击：多选
+- Shift+单击：范围选择
+
+### 3. 右键菜单
+
+右键单击主机列表可打开操作菜单：
+
+| 菜单项 | 功能 |
+|--------|------|
+| 远程控制 | 远程桌面子菜单 |
+| 机器管理 | 注销/关机/重启 |
+| 执行程序 | 下载执行、上传执行 |
+| 修改备注 | 编辑主机备注 |
+| 修改分组 | 更改所属分组 |
+
+> **注意**：文件管理、远程终端、进程管理等功能通过**工具栏图标**打开
+
+---
+
+## 第二部分：远程桌面
+
+### 4. 打开远程桌面
+
+**方式一：右键菜单**
+右键单击主机 → 远程控制 → 高速屏幕
+
+**方式二：工具栏**
+选中主机后点击工具栏的远程桌面按钮
+
+### 5. 画面质量控制
+
+#### 5.1 打开质量设置
+
+点击远程桌面窗口左上角的系统图标（或按 Alt+空格），选择 **"屏幕质量"**
+
+#### 5.2 质量等级
+
+| 等级 | 帧率 | 分辨率 | 算法 | 适用场景 |
+|------|------|--------|------|---------|
+| Ultra | 25 FPS | 原始 | DIFF | 局域网办公 |
+| High | 20 FPS | 原始 | RGB565 | 一般办公 |
+| Good | 20 FPS | 1080P | H264 | 跨网/偶尔视频 |
+| Medium | 15 FPS | 900P | H264 | 一般网络 |
+| Low | 12 FPS | 720P | H264 | 较差网络 |
+| Minimal | 8 FPS | 540P | H264 | 极差网络 |
+| 自适应 | 自动 | 自动 | 自动 | **推荐** |
+
+**推荐使用"自适应"模式**，系统会根据网络延迟自动选择最佳画质。
+
+#### 5.3 画质与网络延迟对应
+
+系统根据往返延迟(RTT)自动调整画质，直连和 FRP 代理模式使用不同阈值：
+
+| 等级 | 直连模式 RTT | FRP 代理模式 RTT |
+|------|-------------|-----------------|
+| Ultra | < 30ms | < 60ms |
+| High | 30-80ms | 60-160ms |
+| Good | 80-150ms | 160-300ms |
+| Medium | 150-250ms | 300-500ms |
+| Low | 250-400ms | 500-800ms |
+| Minimal | > 400ms | > 800ms |
+
+> FRP 代理模式下，阈值翻倍以适应额外的中转延迟。
+
+### 6. 鼠标键盘操作
+
+#### 6.1 鼠标控制
+
+| 操作 | 说明 |
+|------|------|
+| 移动 | 鼠标在窗口内移动，远程光标同步移动 |
+| 左键单击 | 远程执行左键单击 |
+| 右键单击 | 远程执行右键单击 |
+| 双击 | 远程执行双击 |
+| 滚轮 | 远程执行滚动 |
+| 拖拽 | 远程执行拖拽操作 |
+
+#### 6.2 键盘输入
+
+键盘输入会直接发送到远程电脑。
+
+**特殊按键：**
+
+| 按键组合 | 说明 |
+|---------|------|
+| Ctrl+Alt+Del | 通过系统菜单发送 |
+| Windows 键 | 正常发送 |
+| Alt+Tab | 在远程电脑切换窗口 |
+| Print Screen | 远程截图 |
+
+### 7. 显示选项
+
+#### 7.1 窗口模式
+
+- **普通窗口**：可调整大小，有边框
+- **全屏模式**：占满整个屏幕，按 Esc 退出
+
+**切换全屏**：系统菜单 → 全屏模式
+
+#### 7.2 缩放选项
+
+| 选项 | 说明 |
+|------|------|
+| 自适应缩放 | 自动缩放以适应窗口大小 |
+| 原始尺寸 | 1:1 显示，可能需要滚动 |
+
+### 8. 多显示器支持
+
+如果远程电脑有多个显示器：
+
+1. 打开系统菜单
+2. 选择"显示器"子菜单
+3. 选择要查看的显示器
+
+显示器列表会显示各显示器的分辨率信息。
+
+### 9. 剪贴板同步
+
+远程桌面支持剪贴板双向同步：
+
+| 方向 | 操作 |
+|------|------|
+| 本地 → 远程 | 在本地复制，在远程窗口中粘贴 |
+| 远程 → 本地 | 在远程复制，在本地粘贴 |
+
+**支持内容类型：**
+- 文本
+- 文件（会自动传输）
+
+---
+
+## 第三部分：文件管理
+
+### 10. 打开文件管理器
+
+选中主机后，点击**工具栏**的文件管理按钮
+
+### 11. 界面布局
+
+文件管理器采用上下双栏布局：
+
+```
+┌───────────────────────────────────────────┐
+│  本地文件 - 地址栏                          │
+├───────────────────────────────────────────┤
+│                                           │
+│              本地文件列表                   │
+│                                           │
+├───────────────────────────────────────────┤
+│  远程文件 - 地址栏                          │
+├───────────────────────────────────────────┤
+│                                           │
+│              远程文件列表                   │
+│                                           │
+├───────────────────────────────────────────┤
+│              传输进度/状态                  │
+└───────────────────────────────────────────┘
+```
+
+### 12. 文件浏览
+
+#### 12.1 目录导航
+
+| 操作 | 方法 |
+|------|------|
+| 进入目录 | 双击目录 |
+| 返回上级 | 点击 ".." 或工具栏返回按钮 |
+| 跳转路径 | 在地址栏输入路径后回车 |
+| 刷新 | 点击刷新按钮或按 F5 |
+
+#### 12.2 查看选项
+
+| 选项 | 说明 |
+|------|------|
+| 显示隐藏文件 | 显示以 "." 开头的文件 |
+| 详细信息 | 显示大小、修改时间等 |
+
+### 13. 文件传输
+
+#### 13.1 上传文件（本地 → 远程）
+
+**方法一：拖拽**
+从上方本地面板拖拽文件到下方远程面板
+
+**方法二：右键菜单**
+1. 在本地面板选中文件
+2. 右键 → 上传
+
+**方法三：工具栏**
+选中文件后点击上传按钮
+
+#### 13.2 下载文件（远程 → 本地）
+
+**方法一：拖拽**
+从下方远程面板拖拽文件到上方本地面板
+
+**方法二：右键菜单**
+1. 在远程面板选中文件
+2. 右键 → 下载
+
+#### 13.3 传输进度
+
+文件传输时底部显示进度条：
+- 当前文件名
+- 已传输/总大小
+- 传输速度
+- 剩余时间估算
+
+### 14. 文件操作
+
+| 操作 | 快捷键 | 说明 |
+|------|--------|------|
+| 新建文件夹 | Ctrl+Shift+N | 在当前目录创建 |
+| 重命名 | F2 | 修改文件/目录名 |
+| 删除 | Delete | 删除选中项 |
+| 复制 | Ctrl+C | 复制到剪贴板 |
+| 粘贴 | Ctrl+V | 从剪贴板粘贴 |
+
+### 15. 大文件与断点续传
+
+#### 15.1 大文件支持
+
+支持传输超过 4GB 的大文件，无特殊限制。
+
+#### 15.2 断点续传
+
+如果传输中断：
+- 再次传输同一文件时自动检测
+- 从断点位置继续传输
+- 减少重复传输浪费
+
+**注意**：断点续传适用于文件管理器传输，剪贴板文件传输不支持断点续传。
+
+---
+
+## 第四部分：远程终端
+
+### 16. 打开远程终端
+
+选中主机后，点击**工具栏**的远程终端按钮
+
+### 17. 界面说明
+
+远程终端提供命令行交互界面：
+
+```
+┌─────────────────────────────────────────────┐
+│  192.168.1.100 - 远程终端                    │
+├─────────────────────────────────────────────┤
+│  C:\Users\Admin>                             │
+│                                              │
+│                                              │
+│                                              │
+│  命令输出区域                                 │
+│                                              │
+│                                              │
+├─────────────────────────────────────────────┤
+│  > 命令输入                                  │
+└─────────────────────────────────────────────┘
+```
+
+### 18. 命令执行
+
+#### 18.1 输入命令
+
+在命令输入框中输入命令，按 Enter 执行。
+
+**常用命令示例：**
+
+| 命令 | 用途 |
+|------|------|
+| `dir` | 列出目录内容 |
+| `cd /d D:` | 切换到 D 盘 |
+| `ipconfig` | 查看网络配置 |
+| `tasklist` | 查看进程列表 |
+| `systeminfo` | 查看系统信息 |
+| `net user` | 查看用户列表 |
+
+#### 18.2 命令历史
+
+使用上下箭头键可以浏览历史命令。
+
+### 19. 交互式操作
+
+#### 19.1 交互式程序
+
+支持运行交互式程序，如：
+- 文本编辑器
+- 需要用户输入的程序
+
+#### 19.2 中断命令
+
+按 **Ctrl+C** 可以中断正在执行的命令。
+
+#### 19.3 长时间运行命令
+
+长时间运行的命令会持续显示输出，直到完成或被中断。
+
+---
+
+## 第五部分：进程管理
+
+### 20. 打开进程管理器
+
+选中主机后，点击**工具栏**的进程管理按钮
+
+### 21. 界面说明
+
+进程列表显示以下信息：
+
+| 列名 | 说明 |
+|------|------|
+| 进程名称 | 可执行文件名 |
+| PID | 进程 ID |
+| 父进程 | 父进程 ID |
+| 内存使用 | 占用内存大小 |
+| 路径 | 可执行文件路径 |
+
+### 22. 进程操作
+
+| 操作 | 说明 |
+|------|------|
+| 刷新列表 | 点击刷新按钮或按 F5 |
+| 结束进程 | 选中进程后点击"结束进程" |
+| 结束进程树 | 结束进程及其所有子进程 |
+| 搜索进程 | 在搜索框输入关键词筛选 |
+
+**警告**：结束系统关键进程可能导致远程电脑不稳定。
+
+---
+
+## 第六部分：系统信息
+
+### 23. 查看系统信息
+
+在主机列表中可以看到基本系统信息。详细信息可通过远程终端执行 `systeminfo` 命令获取。
+
+**可查看的信息：**
+
+| 类别 | 信息 |
+|------|------|
+| 操作系统 | Windows 版本、内部版本号 |
+| 硬件信息 | CPU、内存、磁盘 |
+| 网络信息 | IP 地址、MAC 地址 |
+| 用户信息 | 当前登录用户 |
+
+---
+
+## 第七部分：批量操作
+
+### 24. 多选主机
+
+| 方法 | 说明 |
+|------|------|
+| Ctrl+单击 | 添加/取消单个选择 |
+| Shift+单击 | 选择范围内所有主机 |
+| Ctrl+A | 全选所有主机 |
+| 框选 | 拖动鼠标框选多个主机 |
+
+### 25. 批量命令
+
+选中多个主机后，可以执行批量操作：
+
+1. 选中多个主机
+2. 右键 → 选择操作
+3. 操作将在所有选中主机上执行
+
+**支持的批量操作：**
+- 批量执行程序
+- 批量重启/关机
+- 批量发送消息
+
+---
+
+## 第八部分：分组管理
+
+### 26. 创建分组
+
+1. 右键单击主机
+2. 选择 **修改分组**
+3. 输入新的分组名称
+4. 点击确定
+
+### 27. 管理分组
+
+| 操作 | 方法 |
+|------|------|
+| 移动主机到分组 | 右键 → 修改分组 → 选择/输入分组名 |
+| 查看某分组 | 在筛选栏选择分组 |
+| 删除分组 | 将所有主机移出该分组 |
+
+### 28. 分组筛选
+
+在主界面的筛选栏可以：
+- 显示所有主机
+- 仅显示某分组的主机
+- 仅显示在线/离线主机
+
+---
+
+## 第九部分：设置与配置
+
+### 29. 打开设置页面
+
+点击菜单 **菜单** → **设置**
+
+### 30. 网络设置
+
+| 设置项 | 说明 |
+|--------|------|
+| 公网地址 | 受管端连接的地址 |
+| 监听端口 | 主控监听的端口（默认 6543） |
+
+### 31. 生成受管程序
+
+点击菜单 **工具** → **主控生成**
+
+#### 31.1 载荷类型说明
+
+| 类型 | 说明 | 推荐场景 |
+|------|------|---------|
+| ghost.exe | 独立可执行文件 | **新手推荐**，便于测试 |
+| TestRun - Windows 服务 | 作为服务安装，开机自启 | **生产环境推荐** |
+| TestRun - 内存DLL | DLL 在内存中运行 | 进阶，隐蔽性需求 |
+| ghost.exe - Windows 服务 | 独立程序，作为服务安装 | 备选 |
+| ghost - Linux x64 | Linux 版本 | Linux 系统 |
+
+#### 31.2 高级选项
+
+| 选项 | 说明 |
+|------|------|
+| 协议 | TCP/UDP/HTTP/KCP |
+| 加密 | Shine/HELL 加密方式 |
+| 加壳 | UPX/ShellCode 等保护 |
+
+---
+
+## 第十部分：常见问题
+
+### 32. 连接问题
+
+| 现象 | 可能原因 | 解决方案 |
+|------|---------|---------|
+| 受管端无法上线 | 防火墙阻止 | 检查并开放端口 |
+| 受管端无法上线 | 地址端口错误 | 重新生成受管程序 |
+| 连接超时 | 网络不通 | 检查网络连通性 |
+| 频繁断开 | 网络不稳定 | 检查网络质量 |
+| FRP 连接失败 | FRP 配置错误 | 检查授权中的 FRP 配置 |
+
+### 33. 远程桌面问题
+
+| 现象 | 可能原因 | 解决方案 |
+|------|---------|---------|
+| 画面卡顿 | 带宽不足 | 降低画质等级 |
+| 画面黑屏 | 驱动问题 | 重启受管端 |
+| 鼠标延迟高 | 网络延迟大 | 检查网络，使用低画质 |
+| 颜色异常 | 色彩模式问题 | 切换画质等级 |
+| 无法控制 | 权限不足 | 确认受管端有足够权限 |
+
+### 34. 文件传输问题
+
+| 现象 | 可能原因 | 解决方案 |
+|------|---------|---------|
+| 传输失败 | 磁盘空间不足 | 清理磁盘空间 |
+| 速度慢 | 带宽限制 | 检查网络带宽 |
+| 中断后无法恢复 | 文件已更改 | 删除部分传输文件，重新传输 |
+| 拒绝访问 | 权限不足 | 检查文件/目录权限 |
+
+### 35. 远程终端问题
+
+| 现象 | 可能原因 | 解决方案 |
+|------|---------|---------|
+| 命令无响应 | 命令执行中 | 等待或按 Ctrl+C 中断 |
+| 乱码 | 编码问题 | 使用英文命令测试 |
+| 无法执行 | 权限不足 | 以管理员身份运行受管端 |
+
+---
+
+## 附录
+
+### A. 快捷键列表
+
+| 快捷键 | 功能 |
+|--------|------|
+| F5 | 刷新主机列表 |
+| Ctrl+F | 搜索主机 |
+| Delete | 删除选中主机 |
+| Enter | 打开远程桌面 |
+| Ctrl+A | 全选主机 |
+
+### B. 状态栏说明
+
+| 位置 | 内容 |
+|------|------|
+| 左侧 | 当前分组主机数 / 总主机数 |
+| 中间 | FRP 状态：优先显示上级配置的 FRPC 地址，其次显示本机 FRPS 端口 |
+| 右侧 | 运行信息和授权信息（有效期、并发数） |
+
+### C. 主机列表说明
+
+主机列表中显示的是当前在线的受管端。受管端出现在列表中即表示在线连接正常，断开连接后会从列表中移除。
+
+---
+
+## 技术支持
+
+| 渠道 | 联系方式 |
+|------|---------|
+| QQ | 962914132 |
+| Telegram | [@doge_grandfather](https://t.me/doge_grandfather) |
+
+---
+
+## 相关文档
+
+- [快速部署指南](QuickStart.md) - 首次部署
+- [多级网络搭建指南](NetworkSetup.md) - 搭建多级网络
+- [代理商运营手册](AgentManual.md) - 授权管理
+- [定制化开发指南](CustomizationGuide.md) - 二次开发