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

docs/AgentManual.md

@@ -0,0 +1,614 @@
+# YAMA 代理商运营手册
+
+> 下级授权管理与 FRP 代理配置
+
+---
+
+## 目标读者
+
+- 有下级客户需要管理的代理商
+- 需要为下级生成授权
+- 需要提供 FRP 代理服务
+
+> 基础功能请参阅[日常使用手册](UserManual.md)
+
+---
+
+## 第一部分：代理商角色
+
+### 1. 您的角色定位
+
+作为代理商，您在授权链中扮演中间角色：
+
+```
+您的上级（为您提供授权）
+        │
+        ↓
+    您（代理商）
+        │
+        ↓
+您的下级（您为他们提供授权和服务）
+```
+
+**您的职责：**
+- 管理您的下级客户
+- 为下级生成和分发授权
+- 可选：为下级提供 FRP 代理服务
+- 提供技术支持和售后服务
+
+### 2. 权限范围
+
+您为下级授权时，受以下限制：
+
+| 限制项 | 规则 |
+|--------|------|
+| 有效期 | 不超过您自己的有效期 |
+| 并发数限制 | 不超过上级为您设置的并发数限制 |
+| 功能权限 | 不超过您被授予的权限 |
+
+**示例：**
+- 您的有效期到 2026-12-31
+- 您可以为下级设置最长到 2026-12-31 的有效期
+- 上级为您设置的并发数限制是 500
+- 您为下级设置的并发数限制不能超过 500
+
+### 3. 收益模式参考
+
+常见的代理商收益模式：
+
+| 模式 | 说明 |
+|------|------|
+| 按授权收费 | 每个授权收取一次性费用 |
+| 按并发数收费 | 根据分配的并发数定价 |
+| 按服务期限收费 | 月付/季付/年付不同价格 |
+| FRP 增值服务 | 为无服务器的下级提供 FRP 代理 |
+| 技术支持服务 | 提供部署、运维支持 |
+
+---
+
+## 第二部分：下级管理流程
+
+### 4. 发展下级的标准流程
+
+```
+步骤 1：下级联系您，表达需求
+    ↓
+步骤 2：下级下载并运行 YAMA.exe
+    ↓
+步骤 3：下级发送序列号给您
+    ↓
+步骤 4：您评估需求，生成授权
+    ↓
+步骤 5：您将 *.lic 文件发送给下级
+    ↓
+步骤 6：下级导入授权，开始使用
+```
+
+### 5. 获取下级序列号
+
+#### 5.1 指导下级获取序列号
+
+指导下级完成以下步骤：
+1. 下载并运行 YAMA.exe（首次运行会提示未授权，属正常现象）
+2. 点击菜单 **其他** → **申请授权**
+3. 首次会显示使用条款，确认本软件仅限合法正当使用
+4. 点击"确认"后显示序列号并复制
+
+> **提示**：导入授权后，该菜单会变为 **其他** → **序列号**
+
+**序列号格式：** `XXXX-XXXX-XXXX-XXXX`（16 位十六进制，分 4 组）
+
+#### 5.2 序列号传递建议
+
+| 方式 | 建议 |
+|------|------|
+| 微信/QQ | 直接复制文本发送 |
+| 邮件 | 主题注明"YAMA序列号" |
+| 截图 | 确保序列号完整清晰 |
+
+**重要**：序列号是生成授权的必要信息，请下级准确提供。
+
+### 6. 评估下级需求
+
+在生成授权前，了解下级的需求：
+
+| 问题 | 影响 |
+|------|------|
+| 预计受管端数量 | 决定分配的并发数 |
+| 计划使用期限 | 决定授权有效期 |
+| 有无公网服务器 | 决定是否需要分配 FRP |
+
+---
+
+## 第三部分：生成授权
+
+### 7. 打开授权生成界面
+
+点击菜单 **工具** → **口令生成**
+
+### 8. 填写授权信息
+
+#### 8.1 基本信息
+
+| 字段 | 说明 | 示例 |
+|------|------|------|
+| 序列号 | 下级提供的设备序列号 | b40f-638f-ebc8-6d54 |
+| 备注 | 便于识别的说明 | "张三-华东区代理" |
+
+**备注建议格式：** `客户名-地区/用途`
+
+#### 8.2 有效期设置
+
+| 字段 | 说明 |
+|------|------|
+| 起始日期 | 授权生效日期（可以是今天或将来某天） |
+| 结束日期 | 授权过期日期（不超过您的有效期） |
+
+**常见期限类型：**
+
+| 类型 | 期限 | 适用场景 |
+|------|------|---------|
+| 试用期 | 7-15 天 | 新客户体验 |
+| 月付 | 1 个月 | 短期需求 |
+| 季付 | 3 个月 | 一般客户 |
+| 半年付 | 6 个月 | 稳定客户 |
+| 年付 | 12 个月 | 长期合作 |
+
+#### 8.3 并发数设置
+
+设置下级可同时管理的受管端数量上限。
+
+**规划建议：**
+- 小型客户：10-50
+- 中型客户：50-200
+- 大型客户：200+
+- 预留 10-20% 余量应对增长
+
+### 9. 分配 FRP 端口
+
+#### 9.1 何时需要分配 FRP
+
+在以下情况为下级分配 FRP：
+- 下级没有公网服务器
+- 下级希望简化网络配置
+- 下级网络环境复杂
+
+#### 9.2 分配方式
+
+**自动分配（推荐）：**
+1. 勾选"FRP 代理"选项
+2. 系统自动从可用端口池分配
+3. 无需手动指定端口号
+
+**手动指定：**
+1. 勾选"FRP 代理"选项
+2. 取消"自动分配"
+3. 输入指定端口号
+
+**注意**：手动指定需确保端口在您配置的范围内且未被占用。
+
+#### 9.3 记录分配信息
+
+建议维护一份分配记录表：
+
+| 下级 | 序列号 | 端口 | 并发数 | 有效期 | 备注 |
+|------|-------|------|--------|--------|------|
+| 张三 | b40f-... | 20001 | 100 | 2026-12-31 | 华东区 |
+| 李四 | a12c-... | 20002 | 50 | 2026-06-30 | 试用 |
+
+### 10. 生成授权
+
+1. 确认所有信息无误
+2. 点击"生成"按钮
+3. 授权信息保存到本地数据库
+
+### 11. 发送给下级
+
+有两种方式将授权发送给下级：
+
+#### 方式 A：在线发送（推荐）
+
+如果下级使用您通过 **工具** → **主控生成** 分发的程序：
+
+1. 下级程序已硬编码您的地址，启动后会自动连接到您
+2. 您在主机列表中可以看到已连接但未授权的下级
+3. 右键点击该主机 → **发送授权**
+4. 选择已生成的授权记录
+5. 通知下级重启程序
+
+**下级重启流程（如授权包含 FRP）：**
+- 第一次重启：验证授权，提示"授权成功"，同时收到 FRP 配置
+- 第二次重启：应用 FRP 配置，开始使用 FRP 代理
+
+**优点：** 无需传输文件，操作简便，适合大量下级管理
+
+#### 方式 B：离线发送（lic 文件）
+
+如果下级无法先连接到您（如网络原因）：
+
+1. 在授权生成界面点击"导出"按钮
+2. 生成 `*.lic` 文件（建议命名：`客户名_日期.lic`）
+3. 通过微信/QQ/邮件发送给下级
+4. 附带导入说明：
+
+```
+请按以下步骤导入授权：
+1. 运行 YAMA.exe
+2. 点击菜单"工具" → "导入口令..."
+3. 选择 *.lic 文件
+4. 重启程序使授权生效
+
+如有问题请联系我。
+```
+
+---
+
+## 第四部分：FRP 代理服务
+
+> 为没有公网服务器的下级提供代理服务
+
+### 12. FRP 工作原理
+
+当下级没有公网服务器时，可以通过您的 FRP 服务实现连接：
+
+```
+下级的受管端
+      │
+      │ 连接
+      ↓
+您的 FRP 服务器（公网）
+      │
+      │ 转发
+      ↓
+下级的 YAMA 程序
+```
+
+**数据流向：**
+1. 受管端连接您的服务器的指定端口（如 20001）
+2. FRP 服务将流量转发给下级的 YAMA
+3. 下级 YAMA 通过 FRP 客户端接收数据
+
+### 13. 配置 FRP 服务
+
+#### 13.1 系统要求
+
+| 要求 | 说明 |
+|------|------|
+| 操作系统 | Windows 10 / Server 2016 或更高版本 |
+| 架构 | 必须是 64 位系统 |
+| 网络 | 服务器具有公网 IP |
+
+**注意**：32 位系统或 Windows 7/Server 2012 等旧系统不支持 FRP 功能。
+
+#### 13.2 打开配置界面
+
+点击菜单 **扩展** → **下级FRP代理设置**
+
+#### 13.3 启用服务
+
+勾选 **"启用为下级提供 FRP 代理"**
+
+#### 13.4 选择 FRPS 模式
+
+**方式 A：本地运行 FRPS（推荐）**
+
+勾选"FRPS 运行在本机"
+
+| 优点 | 说明 |
+|------|------|
+| 简单 | 程序自动管理 FRPS |
+| 集成 | 无需额外部署 |
+| 便捷 | 配置自动生效 |
+
+**方式 B：使用外部 FRPS**
+
+如果您已有独立的 FRPS 服务器：
+1. 取消勾选"FRPS 运行在本机"
+2. 填写 FRPS 服务器地址
+3. 填写 FRPS 端口
+4. 填写认证 Token（需与 FRPS 配置一致）
+
+#### 13.5 设置端口和密钥
+
+| 设置项 | 说明 | 建议值 |
+|--------|------|-------|
+| FRPS 端口 | FRPS 服务监听端口 | 7000 |
+| 认证 Token | 安全密钥 | 使用复杂随机字符串 |
+
+**Token 建议：** 使用 16 位以上包含字母数字的随机字符串。
+
+#### 13.6 设置分配范围
+
+| 设置项 | 说明 | 建议值 |
+|--------|------|-------|
+| 起始端口 | 分配给下级的最小端口 | 20000 |
+| 结束端口 | 分配给下级的最大端口 | 29999 |
+
+**容量计算：** 端口范围 20000-29999 可容纳 10000 个下级。
+
+### 14. 开放防火墙
+
+FRP 服务需要开放以下端口：
+
+| 端口 | 用途 |
+|------|------|
+| 7000（FRPS 端口） | FRP 服务监听 |
+| 20000-29999（分配范围） | 下级映射端口 |
+
+#### 14.1 Windows 防火墙
+
+1. 打开"Windows Defender 防火墙"
+2. 点击"高级设置"
+3. 选择"入站规则" → "新建规则"
+4. 选择"端口" → "TCP"
+5. 输入端口：`7000, 20000-29999`
+6. 选择"允许连接"
+7. 完成
+
+#### 14.2 云服务器安全组
+
+以阿里云/腾讯云为例：
+
+1. 登录云控制台
+2. 找到安全组配置
+3. 添加入站规则：
+   - 协议：TCP
+   - 端口：7000
+   - 端口：20000-29999
+4. 保存配置
+
+### 15. 验证 FRP 服务
+
+#### 15.1 检查运行状态
+
+如果选择"本地运行 FRPS"：
+- 状态栏应显示 FRP 服务状态
+- 可查看日志文件 `Bin/frps.log`
+
+#### 15.2 测试下级连接
+
+1. 为测试下级生成授权（包含 FRP）
+2. 下级导入授权
+3. 确认下级状态栏显示 FRP 连接成功
+4. 下级生成受管程序并测试
+
+---
+
+## 第五部分：授权管理
+
+### 16. 查看已发放授权
+
+点击菜单 **工具** → **授权管理**
+
+授权列表显示以下信息：
+
+| 列名 | 说明 |
+|------|------|
+| 序列号 | 下级设备序列号 |
+| 备注 | 自定义说明 |
+| 有效期 | 起始日期 - 结束日期 |
+| 并发数 | 分配的并发上限 |
+| FRP 端口 | 分配的 FRP 端口（如有） |
+| 状态 | 有效/过期/禁用 |
+
+**筛选功能：**
+- 按状态筛选：有效/过期/全部
+- 按关键词搜索：序列号、备注
+
+### 17. 授权续期
+
+当下级授权即将过期时：
+
+1. 在授权列表中找到目标授权
+2. 双击或点击"编辑"
+3. 修改结束日期
+4. 保存更改
+
+**下级更新授权：**
+- 下级重启程序即可自动获取新的有效期（通过网络验证）
+- 通常**无需重新发送 lic 文件**
+
+> **注意**：只有当下级的序列号（SN）发生变化时，才需要重新生成并发送授权文件。
+
+### 18. 授权撤销
+
+#### 18.1 何时需要撤销
+
+- 下级未按时付费
+- 下级违反使用协议
+- 下级主动要求取消
+
+#### 18.2 撤销方式
+
+**方式一：禁用授权**
+1. 在授权列表选中目标
+2. 点击"禁用"
+3. 下级下次验证时授权失效
+
+**方式二：删除授权**
+1. 在授权列表选中目标
+2. 点击"删除"
+3. 授权记录从数据库移除
+
+#### 18.3 撤销后的影响
+
+- 下级程序在下次联网验证时失效
+- 已连接的受管端保持连接直到断开
+- 下级无法生成新的受管程序
+
+### 19. 端口回收
+
+当下级不再使用 FRP 时：
+
+1. 记录下级占用的端口号
+2. 撤销或删除该下级授权
+3. 端口自动回到可用池
+4. 可分配给新下级使用
+
+---
+
+## 第六部分：日常运维
+
+### 20. 监控下级状态
+
+#### 20.1 定期检查
+
+建议定期检查：
+- 下级授权到期情况
+- FRP 端口使用率
+- 异常连接情况
+
+#### 20.2 日志查看
+
+FRP 相关日志位置：
+- `Bin/frps.log` - FRPS 服务日志
+- 包含下级连接/断开记录
+
+### 21. 常见问题处理
+
+| 下级反馈 | 可能原因 | 处理方法 |
+|---------|---------|---------|
+| 无法导入授权 | 序列号不匹配 | 确认序列号，重新生成 |
+| 授权显示无效 | 有效期问题 | 检查日期设置 |
+| FRP 连接失败 | 防火墙/网络 | 检查端口开放 |
+| 授权已过期 | 到期未续费 | 续期后下级重启程序即可 |
+| 并发数超限 | 超过分配限制 | 升级授权或释放连接 |
+| 受管端连不上 | 地址端口错误 | 检查下级设置 |
+
+### 22. 备份与恢复
+
+#### 22.1 定期备份
+
+建议备份以下数据：
+
+| 数据 | 位置 | 说明 |
+|------|------|------|
+| 配置信息 | 注册表 `HKCU\Software\YAMA` | 可导出为 .reg 文件 |
+| 授权数据库 | `%APPDATA%\YAMA\licenses.db` | SQLite 数据库 |
+
+**备份频率：** 每周或每次重要操作后
+
+**注册表导出方法：**
+1. 运行 `regedit`
+2. 导航到 `HKEY_CURRENT_USER\Software\YAMA`
+3. 右键 → 导出 → 保存为 .reg 文件
+
+#### 22.2 恢复方法
+
+1. 停止 YAMA 程序
+2. 双击 .reg 文件导入注册表配置
+3. 将 `licenses.db` 复制到 `%APPDATA%\YAMA\`
+4. 重新启动程序
+5. 验证数据恢复正确
+
+---
+
+## 第七部分：进阶功能
+
+### 23. 下级成为代理商
+
+如果您的授权支持，您的下级也可以发展自己的下级：
+
+```
+您（一级代理）
+    │
+    └── 下级 A（二级代理）
+            │
+            ├── A 的下级 1
+            └── A 的下级 2
+```
+
+**前提条件：**
+- 您的授权支持多级
+- 为下级开通代理权限
+
+### 24. 批量管理
+
+#### 24.1 批量生成
+
+如需为多个下级生成授权：
+1. 收集所有序列号
+2. 逐个生成授权
+3. 批量导出文件
+4. 分别发送
+
+#### 24.2 批量续期
+
+对于到期的授权：
+1. 筛选即将过期的授权
+2. 逐个编辑延长有效期
+3. 通知下级重启程序以更新授权
+
+> 续期无需重新发送 lic 文件，下级重启即可通过网络获取新的有效期。
+
+### 25. 数据统计
+
+建议自行记录统计以下数据：
+
+| 统计项 | 用途 |
+|--------|------|
+| 下级数量 | 业务规模 |
+| 端口使用率 | 资源规划 |
+| 到期预警 | 续费提醒 |
+| 收入记录 | 财务管理 |
+
+---
+
+## 附录
+
+### A. 定价建议参考
+
+定价时可考虑以下因素：
+
+| 因素 | 说明 |
+|------|------|
+| 并发数档位 | 10/50/100/500/不限 |
+| 有效期 | 月/季/半年/年 |
+| FRP 服务 | 是否包含、带宽限制 |
+| 技术支持 | 基础/高级/VIP |
+
+### B. 常用话术模板
+
+**获取序列号：**
+```
+请运行 YAMA.exe，点击菜单"其他" → "申请授权"。
+首次需确认使用条款，之后即可查看序列号。
+将序列号发送给我即可。
+```
+
+**发送授权文件：**
+```
+附件是您的授权文件，请按以下步骤导入：
+1. 运行 YAMA.exe
+2. 点击菜单"工具" → "导入口令..."
+3. 选择附件中的 *.lic 文件
+4. 关闭并重启程序
+5. 检查状态栏确认授权生效
+
+如有问题随时联系我。
+```
+
+**续期通知：**
+```
+您的 YAMA 授权将于 [日期] 到期。
+如需续期，请在到期前联系我。
+续期后重启程序即可自动更新，无需重新导入文件。
+```
+
+### C. 技术支持
+
+如遇到本手册未涵盖的问题：
+
+| 渠道 | 联系方式 |
+|------|---------|
+| QQ | 962914132 |
+| Telegram | [@doge_grandfather](https://t.me/doge_grandfather) |
+
+---
+
+## 相关文档
+
+- [快速部署指南](QuickStart.md) - 首次部署
+- [多级网络搭建指南](NetworkSetup.md) - 网络架构详解
+- [日常使用手册](UserManual.md) - 远程管理功能
+- [定制化开发指南](CustomizationGuide.md) - 二次开发（技术型客户）