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

docs/BuildScript.md

@@ -0,0 +1,157 @@
+# SimpleRemoter 编译脚本
+
+命令行编译脚本，支持完整编译和增量编译。
+
+## 环境要求
+
+- Visual Studio 2019 或 2022
+- v142 工具集 (MSVC v142 - VS 2019 C++ build tools)
+- MFC 库 (C++ MFC for v142 build tools)
+
+脚本自动检测以下 VS 安装路径：
+- `C:\Program Files\Microsoft Visual Studio\18\*` (VS2019 Insiders)
+- `C:\Program Files*\Microsoft Visual Studio\2019\*`
+- `C:\Program Files*\Microsoft Visual Studio\2022\*`
+
+## 脚本文件
+
+| 文件 | 说明 |
+|------|------|
+| `build.ps1` | PowerShell 主脚本 |
+| `build.cmd` | 批处理快捷入口 |
+
+## 命令参数
+
+### PowerShell (`build.ps1`)
+
+```powershell
+.\build.ps1 [-Config <配置>] [-Platform <平台>] [-ServerOnly] [-Clean] [-Publish]
+```
+
+| 参数 | 可选值 | 默认值 | 说明 |
+|------|--------|--------|------|
+| `-Config` | `Release`, `Debug` | `Release` | 编译配置 |
+| `-Platform` | `x64`, `x86`, `all` | `x64` | 目标平台 |
+| `-ServerOnly` | 开关 | 否 | 仅编译主控程序，跳过依赖项 |
+| `-Clean` | 开关 | 否 | 清理后重新编译 |
+| `-Publish` | 开关 | 否 | 发版模式：重编译所有 + UPX 压缩 |
+
+### 批处理 (`build.cmd`)
+
+```cmd
+build [release|debug] [x64|x86|all] [server|clean|publish]
+```
+
+- 参数顺序任意
+- 不区分大小写
+
+## 使用示例
+
+### PowerShell
+
+```powershell
+# 完整编译 (Release x64)
+.\build.ps1
+
+# 编译 x86 + x64 两个平台
+.\build.ps1 -Platform all
+
+# Debug 模式编译
+.\build.ps1 -Config Debug
+
+# 仅编译主控程序 (跳过依赖项，适合快速重编译)
+.\build.ps1 -ServerOnly
+
+# 清理后重新编译
+.\build.ps1 -Clean
+
+# 组合使用
+.\build.ps1 -Config Debug -Platform all -Clean
+```
+
+### 批处理
+
+```cmd
+build                      # 完整编译 Release x64
+build server               # 仅主控程序
+build debug x86            # Debug x86
+build release all clean    # 清理后编译所有平台
+build publish              # 发版模式
+```
+
+## 编译流程
+
+### 完整编译 (默认)
+
+```
+Step 1: 编译客户端项目 (始终 Release, x86 + x64)
+   ├── ServerDll.dll    ← ClientDll_vs2015.vcxproj
+   ├── ghost.exe        ← ghost_vs2015.vcxproj
+   ├── TestRun.exe      ← TestRun_vs2015.vcxproj
+   ├── TinyRun.dll      ← TinyRun.vcxproj
+   └── SCLoader.exe     ← SCLoader.vcxproj
+
+Step 2: 编译主控程序 (使用 -Config 指定的配置)
+   └── Yama.exe         ← 2015Remote_vs2015.vcxproj
+```
+
+**注意：** 客户端项目始终使用 Release 模式编译，因为主控程序资源中引用的是 `Release\` 目录下的文件。`-Config Debug` 只影响主控程序本身。
+
+主控程序 Yama 会将 Step 1 编译的 DLL/EXE 内嵌到资源中，因此**首次编译必须执行完整编译**。
+
+### 发版模式 (-Publish)
+
+```
+Step 1: 重新编译所有客户端项目 (Release x86 + x64)
+Step 2: 重新编译主控程序 (Release x64)
+Step 3: UPX 压缩 (upx --best Yama_x64.exe)
+```
+
+发版模式会：
+- 强制 Release x64 配置
+- 强制 Clean 重新编译（确保所有文件是最新的）
+- 使用 UPX 压缩最终输出（约 70% 压缩率）
+
+UPX 路径：`server/2015Remote/res/3rd/upx.exe`
+
+### 仅主控 (-ServerOnly)
+
+跳过 Step 1，直接编译 Yama。适用于：
+- 依赖项已编译完成
+- 仅修改了主控程序代码
+
+## 输出文件
+
+| 平台 | 输出路径 |
+|------|---------|
+| x64 | `Bin\Yama_x64.exe` |
+| x86 | `Bin\Yama_x86.exe` |
+
+客户端项目输出：
+
+| 项目 | x86 输出 | x64 输出 |
+|------|---------|---------|
+| ServerDll | `Release\ServerDll.dll` | `x64\Release\ServerDll.dll` |
+| ghost | `Release\ghost.exe` | `x64\Release\ghost.exe` |
+| TestRun | `Release\TestRun.exe` | `x64\Release\TestRun.exe` |
+| TinyRun | `Release\TinyRun.dll` | `x64\Release\TinyRun.dll` |
+| SCLoader | `Release\SCLoader.exe` | `x64\Release\SCLoader.exe` |
+
+## 常见问题
+
+### v142 build tools cannot be found
+
+安装 VS2019 构建工具：
+1. 打开 Visual Studio Installer
+2. 修改 VS2022 或安装 VS2019
+3. 勾选 `MSVC v142 - VS 2019 C++ x64/x86 build tools`
+
+### MFC libraries are required
+
+安装 MFC 库：
+1. 打开 Visual Studio Installer
+2. 勾选 `C++ MFC for v142 build tools (x86 and x64)`
+
+### MSBuild not found
+
+确保安装了 Visual Studio 2019 或 2022，且包含 C++ 桌面开发工作负载。