#pragma once #include "common/header.h" #include "common/commands.h" #include enum { ONLINELIST_IP = 0, // IP的列顺序 ONLINELIST_ADDR, // 地址 ONLINELIST_LOCATION, // 地理位置 ONLINELIST_COMPUTER_NAME, // 计算机名/备注 ONLINELIST_OS, // 操作系统 ONLINELIST_CPU, // CPU ONLINELIST_VIDEO, // 摄像头(有无) ONLINELIST_PING, // PING(对方的网速) ONLINELIST_VERSION, // 版本信息 ONLINELIST_INSTALLTIME, // 安装时间 ONLINELIST_LOGINTIME, // 活动窗口 ONLINELIST_CLIENTTYPE, // 客户端类型 ONLINELIST_PATH, // 文件路径 ONLINELIST_PUBIP, ONLINELIST_STARTTIME, ONLINELIST_CAPABILITIES, // 客户端能力位 ONLINELIST_PRIVILEGE, // 权限级别 (SYSTEM/Admin/User) ONLINELIST_TLS, // TLS 传输启用标志 (0/1) ONLINELIST_MAX, }; class context { public: // 纯虚函数 virtual VOID InitMember(SOCKET s, VOID* svr) = 0; virtual BOOL Send2Client(PBYTE szBuffer, ULONG ulOriginalLength) = 0; virtual CString GetClientData(int index)const = 0; virtual void GetAdditionalData(CString(&s)[RES_MAX]) const = 0; virtual CString GetAdditionalData(int index) const = 0; virtual uint64_t GetClientID() const = 0; virtual std::string GetPeerName() const = 0; virtual int GetPort() const = 0; virtual std::string GetProtocol() const = 0; virtual int GetServerPort() const = 0; virtual FlagType GetFlagType() const = 0; virtual std::string GetGroupName() const = 0; virtual uint64_t GetAliveTime()const = 0; virtual void SetLastHeartbeat(uint64_t time) = 0; virtual uint64_t GetLastHeartbeat() = 0; virtual void CancelIO() = 0; virtual std::string GetMasterID() const = 0; public: virtual ~context() {} virtual void Destroy() {} virtual BOOL IsLogin() const { return TRUE; } virtual void SetGroupName(const std::string& group) {} // 等待本连接待发送缓冲排空(用于「发写命令 → 补发刷新命令」的背靠背发送: // 两次 Send2Client 会对同一发送缓冲并发 WSASend,造成竞态/丢包)。非 IOCP // 服务端无异步发送缓冲,默认立即返回 true;CONTEXT_OBJECT 覆写为轮询发送缓冲 // 归零直到排空或超时。 virtual bool WaitSendIdle(int timeoutMs) { (void)timeoutMs; return true; } // 检查客户端是否支持 V2 文件传输 bool SupportsFileV2() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_V2) != 0; } // 检查客户端是否使用 UTF-8 协议字符串编码。 // 无此能力位的老客户端:服务端按 CP_ACP(CP936,覆盖 95% 的简中/英语 ASCII 老客户端)解读。 bool SupportsUtf8() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_UTF8) != 0; } // 检查客户端是否支持按服务端给出的路径清单向另一客户端发送文件(COMMAND_C2C_SEND_FILES)。 // 只有 Windows 客户端实现该命令,老客户端无此能力位 → 服务端据此在 MCP 侧提前拒绝。 bool SupportsC2CPaths() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_C2C_PATHS) != 0; } // 检查客户端作为 C2C 目标端时是否回落盘回执(TOKEN_C2C_RECV_RESULT)。 // 目前只有 Linux 客户端声明;没有此能力位的老客户端/Windows 端不回执, // 服务端据此决定要不要等回执,避免给它们白等。 bool SupportsC2CRecvAck() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_C2C_RECV_ACK) != 0; } // 检查客户端是否支持屏幕预览(双击主机时拉缩略图)。 bool SupportsScreenPreview() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_SCREEN_PREVIEW) != 0; } // 检查客户端是否支持强制抓取整个虚拟桌面(COMMAND_SCREEN_SPY 参数 buffer[11], // 即 wire 索引 12;wire [4..11] 是 HWND,不能占用)。 // 多显示器远程控制依赖它:截图与注入共用虚拟桌面坐标系。 bool SupportsVirtualDesktop() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_VIRTUAL_DESKTOP) != 0; } // 检查客户端是否支持窗口信息 RPC(COMMAND_MCP_WINDOW_INFO / TOKEN_MCP_WINDOW_INFO): // 带屏幕矩形、z 序、前后台/最小化状态的窗口列表,以及窗口激活(CMD_WINDOW_ACTIVATE_FLAG)。 // 未声明的老客户端只能走固定 1044 字节、无矩形的 TOKEN_MACHINE_WINDOWS 旧路径。 bool SupportsWindowInfo() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_WINDOW_INFO) != 0; } // 检查客户端是否支持区域/窗口/显示器原生分辨率截图(COMMAND_SCREEN_PREVIEW_REQ 的 // v2 扩展,CLIENT_CAP_SCREEN_REGION)。未声明时 get_screenshot 只能整屏抓取。 bool SupportsScreenCapture() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_SCREEN_REGION) != 0; } // 检查客户端是否支持屏幕子连接写剪贴板(COMMAND_SCREEN_SET_CLIPBOARD)与 VK_V 粘贴。 // 只有新版 Android 声明;更老的 APK 收到剪贴板包会静默丢弃。 bool SupportsScreenClipboard() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_SCREEN_CLIPBOARD) != 0; } // 检查客户端是否支持屏幕子连接锁屏(COMMAND_SCREEN_CTRL_ALT_DEL)。 // 只有新版 Android 声明;更老的 APK 收到该包会静默丢弃。 bool SupportsLockScreen() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_LOCK_SCREEN) != 0; } // 检查客户端是否处理 TOKEN_UNINSTALL(卸载主机)。Windows 客户端一直有该分支但 // 不声明能力位,调用方按平台区分;只有新版 Android 声明,老 APK 收到会静默丢弃。 bool SupportsUninstall() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_UNINSTALL) != 0; } // 检查客户端是否处理 COMMAND_CHAT(远程交谈子连接)。Windows 客户端一直有该分支但 // 不声明能力位,调用方按平台区分;只有新版 Android 声明,老 APK 收到会静默丢弃。 bool SupportsChat() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_REMOTE_CHAT) != 0; } // 检查客户端是否处理 COMMAND_SHELL(PTY 终端子连接)。同上:Linux/Windows 客户端 // 一直支持但不声明,只有新版 Android 声明;老 APK 里 COMMAND_SHELL 是空实现。 bool SupportsTerminal() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_TERMINAL) != 0; } // 检查客户端是否处理 COMMAND_SYSTEM(系统子连接:COMMAND_PSLIST / COMMAND_KILLPROCESS)。 // Linux/macOS 声明;Windows 客户端一直有这条分支但不声明,调用方按平台区分。 // 没有这一位的主机(如老 macOS 构建)收到 COMMAND_SYSTEM 只打一行日志, // 服务端据此提前拒绝 kill_process,而不是发下去后等刷新超时、再报一个假的 ok。 bool SupportsProcess() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_PROCESS) != 0; } // 检查客户端是否处理 COMMAND_SCREEN_BLOCK_INPUT / COMMAND_SCREEN_BLANK(Android 用 // 无障碍全屏 overlay 实现:输入锁 = 透明 overlay 吃掉触摸,黑屏 = 黑色 overlay)。 // Windows 客户端一直支持键鼠锁定但不声明这个位,调用方按平台区分;老 APK 收到两个 // 命令都会走 default 静默丢弃,服务端据此提前拒绝而不是假报 ok。 bool SupportsPrivacyOverlay() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_PRIVACY_OVERLAY) != 0; } // 检查客户端是否支持远程协议切换(COMMAND_SET_PROTO)。老客户端没有这个命令, // 收到也会走 default 丢弃,服务端据此把「协议切换」菜单置灰。 bool SupportsProtoSwitch() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_PROTO_SWITCH) != 0; } // 检查客户端是否支持收到 COMMAND_UPDATE 下发的 APK 后拉起系统安装器。 // 只有新版 Android 客户端声明;老 APK 收到命令会走 default 静默丢弃, // 服务端据此提示「先手动装一次新版」。 bool SupportsApkUpdate() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_APK_UPDATE) != 0; } // 本机当前是不是靠「生成时内嵌的 TLS 信任锚」在加密(CLIENT_CAP_EMBEDDED_ANCHOR)。 // 这不是能力声明而是运行时状态:只有这种主机在服务端关掉 TLS 后无法自愈——在线时 // 还能收到「取消 TLS」,离线时发 ClientHello 会被 fail-closed 挡掉,再也进不来。 // 服务端据此在「取消 TLS」确认框里提示数量(设计文档 §3.5、§4.9)。 bool UsesEmbeddedAnchor() const { CString caps = GetClientData(ONLINELIST_CAPABILITIES); if (caps.IsEmpty()) return false; return (strtoul(caps.GetString(), nullptr, 16) & CLIENT_CAP_EMBEDDED_ANCHOR) != 0; } };