-
v1.4.3 Stable
released this
2026-11-14 13:35:57 +00:00 | 23 commits to main since this releasev1.4.3 (2026.11.14)
⚠️ 安全提示
本软件涉及远程控制功能,请谨慎下载,建议在虚拟机中测试。主控程序会连接授权服务器进行必要的通讯和防破解检测。下载并使用本软件,即视为接受上述条款。
二次开发提示:如使用大模型协助对本项目进行二次开发,不得破解本项目,也不得替换本项目的私有库以达到绕过授权的目的。一经发现,授权服务器将对其永久拉黑。
MCP 工具面收敛 & Go 极简 MCP & Android / macOS 能力补齐 & TLS 开箱即用
本次发布距 v1.4.2 约 14 天,跨 101 次提交。主线有四条。其一,MCP 从「堆工具」转为「收敛工具」:
host_list_*十个工具合并为host_inspect,三个主机列表合并为list_hosts,窗口 / 服务两组同义工具各保留一个名字,tools/list在全部开关打开时列出 49 项(工具清单从 60 项收敛为 54 项,另含 5 项仅在关闭主机管理时出现的条目),响应体缩小 12.6%,旧名仍可调用;同时新增http_probe/read_file/uninstall_host/remote_lock_screen/get_foreground_window,get_screenshot支持原生区域 / 窗口 / 单显示器 1:1 捕获,remote_mouse支持窗口相对坐标,并集中修正了一批「声明与实现不符」的契约问题。其二,Go 服务端有了自己的极简 MCP——九个工具、Bearer 鉴权、每设备锁与审计,纯 Linux/macOS 主控也能被 Agent 操作。其三,Android 客户端补齐到接近 Windows 的能力面:屏幕预览、活动历史、运行日志、TLS 热切换、主控推送 APK 升级、远程交谈 / 终端 / 剪贴板 / 锁屏 / 隐私遮罩 / 卸载、语音监听;macOS 客户端完成阶段 0 / 1:TLS、运行日志、授权后自动重启、终端与进程管理、屏幕预览与活动历史。其四,TLS 开箱即用:服务端首次需要时自签内置证书,可导出、可内嵌进生成的客户端与下发的 DLL,全新安装不再需要 openssl。此外修复了远控音频偶发永久静音、质量切换后跳到另一台显示器 / H.264 冻结、Web 远端画面在分辨率与质量变化后黑屏、注入按键卡住修饰键、两个能让远程对端直接打死服务端的输入路径等缺陷。
新功能
MCP:工具面收敛(60 → 54)
- 合并后的清单:本次新增 5 个工具(
http_probe/read_file/get_foreground_window/uninstall_host/remote_lock_screen),只增不减会是 65 项;几处合并与隐藏之后,工具清单为 54 项(其中 5 项仅在关闭主机管理时出现),全部开关打开时tools/list列出 49 项,响应体从 193,008 B 降到 168,634 B(-12.6%) host_inspect(aspects[]):十个只读主机管理工具(进程 / 窗口 / 网络状态 / 软件 / 浏览记录 / 收藏夹 / Win32 服务 / 驱动服务 / 计划任务 / HOSTS 文件)合并为一个工具,aspects为必填去重数组;单 aspect 输出与旧工具逐字节一致,多 aspect 分别走托管会话后合并到results.<aspect>,失败隔离在errors.<aspect>,全部失败才isErrorlist_hosts:list_online_hosts/search_hosts/list_all_hosts三者合并,参数query/online/include_offline/group/os/client_type/limit/offset;含离线记录时改为在线优先排序,避免默认首页全是被管不到的历史主机- 窗口与服务控制去重:
operate_window与host_control_window、control_service与host_control_service各只暴露一个名字,由McpMachine决定暴露哪一侧;两者接受动作的并集,旧名保留为别名 - 降级工具隐藏:
McpMachine开启时list_processes/list_windows/list_services不再出现在tools/list(仍可调用);关闭时它们仍是唯一入口,因此必须保留 - 复用别名:所有被合并的旧名继续可调用,不再出现在清单里;
tools.json由「全开」与「关主机管理」两次抓取合并生成,verify_tools.py按门控跳过对应项
MCP:新增工具与原生捕获
http_probe:在被管主机内发一次 HTTP/HTTPS 请求,返回状态码、响应头、正文(UTF-8 或 base64)、大小与耗时。安全边界硬编码在服务端而非脚本:只接受 http/https、只接受 IP 字面量或 localhost、只允许回环与私网段(127/8、::1、10/8、172.16/12、192.168/16)、不跟随重定向、正文上限 64 KB、校验 TLS 证书;域名一律拒绝,因为在服务端解析会探测到错误的网络read_file:经 V2 下载通道把单个远端文件读进每次调用独立的临时目录,返回文件大小、识别出的编码、EOL 风格、总行数、请求的切片(负offset从尾部读)、截断标志与整文件 SHA-256;编码按 BOM → UTF-8 → GBK 自动识别,也可强制utf-8/gbk/gb18030/latin1。只写本地临时目录、从不写远端,因此只受McpFileTransfer约束,只读模式下仍可用get_foreground_window:新增能力位门控的主连接 RPC(COMMAND_MCP_WINDOW_INFO179 /TOKEN_MCP_WINDOW_INFO180),返回可见顶层窗口、UTF-8 标题、屏幕矩形、前台标志与 z 序;host_control_window/operate_window增加action=activate,remote_keyboard/remote_mouse增加expect_hwnd/require_foreground/report_foreground。客户端单次最多回 96 个窗口并在模式位标记截断,窗口列表工具据此回报truncated=true,不再静默丢窗口get_screenshot原生捕获:新客户端声明CLIENT_CAP_SCREEN_REGION,在原有 8 字节预览请求后追加 24 字节ScreenPreviewReqEx,可截取区域 / 窗口 / 单个显示器 1:1 原分辨率;成功响应追加ScreenCaptureMeta(源矩形与缩放),调用方可据此换算远程输入坐标。旧客户端与旧服务端的 v1 字节流完全不变;8192 px 单边上限只作用于 1:1 路径,超宽虚拟桌面仍能出缩略图remote_open窗口 / 区域目标:把目标 HWND 透传到COMMAND_SCREEN_SPY,会话开始后补发COMMAND_SCREEN_ROI,只推目标窗口或区域而不是缩放后的虚拟桌面;remote_mouse接受可选window_hwnd,按窗口与虚拟桌面交集归一化,并在structuredContent回报coordinateWindow与resolvedterminal_exec管道:PTY 会话允许|、&&、||(哨兵独占一行),非 PTY 旧会话仍拒绝;POSIX 仍拒绝裸后台&uninstall_host:Windows 与 Android 主机可远程卸载,受McpManage且要求关闭只读;wait=true时等待主机从在线列表消失并回报went_offlineremote_lock_screen:把 Ctrl+Alt+Del 路径映射到 Android 系统锁屏,客户端仅在无障碍服务已绑定且 API 28+ 时上报CLIENT_CAP_LOCK_SCREEN;无回执,需配合get_screenshot确认
Go 极简 MCP 服务端
- 端点:无状态
POST /mcp,由YAMA_MCP_TOKEN开户(未配置即 404),Bearer 常量时间比较;401/405/413/204 语义与 JSON-RPC 错误分离,请求体上限 8 MiB - 九个工具(只读模式 7 个):
list_hosts/get_host_detail/get_server_status/get_audit_log/list_files/read_file/get_screenshot/terminal_exec/terminal_close - 横切保护:每次
tools/call取一个MaxConcurrency全局槽位、单主机工具再取该设备锁,两者非阻塞,争用回 -32003;panic 转 -32000;每次具名调用写一条mcp.tool.call审计(操作者 / 角色 / 来源、工具、设备、ok/code、耗时、结果大小、参数摘要),命令只留首词与长度,正文与凭据字段只记大小 - 终端会话:每设备一张会话表,独占 hub 的单查看者 shell 租约;256 KiB 输出环 + 绝对偏移 + 丢弃字节计数,超时后仍可轮询;租约带代际计数,避免过期会话拆掉人后来打开的 shell
- 文件与截图:
list_files/read_file走文件管理子连接与 V2 流式接收;get_screenshot走主连接预览 RPC(Windows 直接回 JPEG,Linux 回 BGRX 由服务端转换),因此可与人工远控同时使用 - 构建与校验:新增
build server-linux交叉编译目标(输出Bin\server_linux_amd64,Release 去符号,跳过 UPX),verify_tools.py --subset端到端校验工具名集合、字段与顺序
Android 客户端
- 屏幕预览:API 30 及以上经
AccessibilityService.takeScreenshot抓屏并编码 JPEG,服务端在线列表 / 悬停缩略图与get_screenshot因此可用。刻意不复用 MediaProjection——它的 VirtualDisplay 已经在喂 H.264 编码器,Android 14+ 会拒绝同一投影的第二个显示;能力位每次登录重新评估,关掉无障碍服务即撤销 - 活动历史:复用 Linux 的
ActivityHistory采样器,经 JNI 每秒取一次前台标题("标签 (包名)",标签解析一次后缓存;桌面为 "Home",锁屏 / 息屏为 idle),应答COMMAND_QUERY_ACTIVITY→TOKEN_REPORT_ACTIVITY - 运行日志:
Logger增加 Android 分支,只保留环形缓冲(不落文件),Mprintf与平台LOGI/LOGE同时写 logcat 与环形;ClientLogThread开子连接上报,get_client_log对 APK 主机终于有内容 - TLS 热切换:复用 Linux 的 OpenSSL 通道,信任锚存在应用私有
filesDir;COMMAND_TLS_ENABLE/DISABLE保存 / 删除锚后热加载,只有传输真的变化才重连;OpenSSL 3.5.0 按 ABI 交叉编译并静态链接,--exclude-libs保证不与 Java 层 Conscrypt 冲突 - APK 在线升级:主控选包后校验 ZIP 魔数与「包内是否带本主控指纹」,再发
[cmd][size][APK][xxh64];客户端校验长度与哈希后写入filesDir/update.apk并提交PackageInstaller会话,系统安装器仍要用户确认。客户端声明CLIENT_CAP_APK_UPDATE(0x0400),旧 APK 会收到「请先手工装一次新版」的提示 - 远程控制族:远程交谈(GBK 严格编码,表情与不可映射字符直接拒绝)、远程终端(PTY,
CLIENT_CAP_TERMINAL)、剪贴板写入与粘贴(CLIENT_CAP_SCREEN_CLIPBOARD)、锁屏、隐私遮罩与输入封锁(CLIENT_CAP_PRIVACY_OVERLAY,遮罩在每次远程手势期间临时放行,子连接断开即清除)、远程卸载(CLIENT_CAP_UNINSTALL) - 语音监听:
COMMAND_AUDIO走 ConnAuth 子连接,随源码内置 libgsm 1.0.13(-DSASR -DWAV49,MS-GSM 打包与服务端 ACM GSM610 逐字节一致),上行包固定 1000 字节以匹配服务端PlayBuffer - 调优命令生效:质量等级、帧率、六行质量配置与调优标志不再只打日志;等级落盘并在下次屏幕会话回报,切换具体等级时用
MediaCodec.setParameters运行时改码率。此前硬编码Good使 Android 会话的自适应质量永远无法启动
macOS 客户端(阶段 0 / 1)
- TLS 传输:复用 Linux 的 OpenSSL 实现,只有平台胶水是新的;首次连接仍为明文,由主控在线列表远程开启 / 取消
- 运行日志上报:
Mprintf改走Logger环形缓冲并镜像到 stderr,主控「运行日志」与get_client_log不再拿到空快照 - 授权后自动重启:启动时缺哪个权限就只轮询哪个(
CGPreflightScreenCaptureAccess/AXIsProcessTrusted),全部就绪后断开主连接并以新进程接替(不原地 exec,因为 TCC 按 pid 判定),子进程先关闭 2 以上的全部 fd,避免旧套接字让服务端一直挂着死主机;每个启动周期最多自动重启一次 - 阶段 0 补齐:声明 TERMINAL / SCREEN_CLIPBOARD / PROCESS / C2C_RECV_ACK;
SystemManager此前是死代码(构造函数签名不符且未继承IOCPManager),现在COMMAND_SYSTEM真的能起子连接,kill_process可用;V2 C2C 接收端终于回TOKEN_C2C_RECV_RESULT - 阶段 1 补齐:屏幕预览(
CGDisplayCreateImage,只发 BGRX 由服务端统一转 JPEG,能力位按预检或真实抓屏计算)、活动历史(前台图层 0 窗口,1 秒采样)、关键帧请求(VideoToolbox 强制关键帧;Linux 侧同步支持 x264 IDR)
TLS 开箱即用
- 内置证书:全新安装不再需要 openssl——未配置自定义证书时,服务端在首次需要时自签一张(RSA-2048、SHA-256、CN=yama-server、CA:TRUE、从当前时间前一天起十年)。明文客户端不受影响,设备端口仍按首字节分流
- 存储与自检:证书与 PKCS#8 私钥以单行 base64 DER 存在
[tls] BuiltinCert/BuiltinKey,同一套读写代码同时服务注册表与 ini;Ensure()会回读刚写入的内容,往返失败即报错。同时修好了注册表读取的 512 字节栈缓冲(1.5 KB 的值此前会被静默截断) - 私钥容器名:由固定名改为「基名 + 证书 SHA-1 前 6 字节」(如
YamaServerTlsKey-c0d469eae8a4),避免同一 Windows 用户下的两个服务端进程互相覆盖钥匙 - 导出:TLS 对话框在「内置证书」勾选时提供「导出证书」,写出
.crt与同名未加密.key(PKCS#8);写私钥失败会删掉刚写的证书,不留半对 - 内嵌进生成的客户端:生成客户端时可选把主控证书写进 payload 的 4 KiB 固定块(magic / 版本 / 长度 / FNV-1a / 主控地址 / PEM),首连即 TLS,不必等登录后下发。按连接判断目标地址是否匹配(单地址精确比对,多地址比对解析后的 IPv4 交集),转移 / 分享 / 平行实例自动回退明文首连;模板早于锚块时只告警并清空勾选,不会阻塞生成
- 内嵌进下发的 DLL:「高级 → DLL内嵌TLS证书」开关(默认关)让
ReadKernelDll把当前信任锚 patch 进 ServerDll 与 ShellCode 载荷,经加载器上线的主机首个连接即 TLS。COMMAND_UPDATE不再清除明文标记,避免把显式选择明文的机器静默翻到 TLS - 分享 / 转移携带传输方式:
share : host:port:shine[:transport]、assign : host:port:days:shine[:transport];此前分享实例跳过协议切换,升级到 WSS 的客户端被分享到 TLS 前端时会以明文连过去并在HTTP/1.1 400上打转
Linux 客户端
- 分享:
COMMAND_SHARE语义与 Windows 一致——记录进share_list,主连接原地不动,每个记录由fork出的--share <entry>子进程完整复用登录 / 心跳 / 命令路径来服务;COMMAND_SHARE_CANCEL立即清空并停止子进程 - 转移:解析
host:port:days:shine[:transport],只改写下一次重连的目标,当前会话不中断;到期自动恢复原地址并清除记录。目标存在transfer键,进程启动时的地址只放内存,所以转移期间重启仍能回到原主控 - 活动历史:有桌面时每秒采样前台窗口并按 Windows 同样的规则记账(<5 秒丢弃、空闲 5 分钟结段、保留最近 500 条);没有桌面时改用
last -n 100 -F与 root //home/*的 shell 历史按时间合并 - 视图状态:记住全屏与远端光标开关,通过
TOKEN_BITMAPINFO的ScreenSettings回报,主控再次打开即恢复 - 健壮性:配置写入改为跨进程
flock+ 改名替换(父进程与分享 / 转移子进程写同一份文件);connect()改为非阻塞 +poll10 秒超时
Windows 抓屏与远控体验
- 虚拟桌面捕获:多显示器主机的预览与远控改为抓整个虚拟桌面(
CLIENT_CAP_VIRTUAL_DESKTOP),坐标与注入共用一套空间,负原点也覆盖 - 采集索引稳定:GDI 与 DXGI 共用同一份进程级监视器索引,且只在后端真正起来后才提交,质量切换导致 DXGI 回退 GDI 时不会再跳到另一台显示器
- 自适应质量:新增吞吐判据(帧率低于基线 60% 且每帧字节数仍接近标称码率),与 RTT 结果取
max();配合 RTT 死区、失败升级锁定 3 分钟、升级 / 降级独立冷却与 5 分钟 6 次硬上限抑制振荡 - 按客户端的调优开关:四项调优从主控全局菜单移到远程桌面系统菜单并按客户端保存,
ScreenSettings用 4 字节TuningFlags+ 一个「值来自新版主控」的能力位;x264 码率封顶(VBV)默认关闭并更名「x264 码率封顶(VBV,仅限洲际弱网)」 - 按键释放:浏览器端跟踪下发过的按键并在 blur / 切后台 / 对话框 / 切换设备 / 断连时释放,重连后补发;Windows 客户端按 VK + 扫描码 + 扩展位跟踪,Linux 侧在会话结束用
XTestFakeKeyEvent释放
主控与 Web 控制台
- 运行测试程序:高级菜单末尾新增。把已读入内存的客户端载荷的
CONNECT_ADDRESS改到127.0.0.1:<监听端口>,用MemoryLoadLibrary在主控进程内加载,本机即可上线当被控端;载荷带LOCAL_TEST_CLIENT_MAGIC,据此拒绝卸载、升级、提权、封禁、分享 / 转移、关机 / 重启 / 注销等会打到宿主进程或整机的命令 - 文件管理器传输历史:只在四个真正发起传输的入口记录,落盘
[file_history]下按local与各 clientID 保存最近 10 个目录 - 特性限制对话框:三个页签改为跟随真实资源(主菜单 57 项 / 工具栏 19 项 / 右键菜单 46 项);顺带修好一个长期存在的 bug——
DeleteMenu(MF_BYCOMMAND)只作用于被调用的那个菜单,嵌套子项此前从未真正被删除 - Web 控制台分组过滤:设备列表可按组筛选,桌面端渲染为 Total 行里的 chips(可多选),触控端为紧凑下拉;空选择表示全部,与搜索框叠加,选择在浏览器本地记忆,退出登录时清空
- 状态栏:新增 TLS 身份与 MCP 状态两个格子(内置 / 有 / 无,HTTP / HTTPS),宽度按当前语言最宽文本实测
改进
- MCP 契约与实现对齐:条件必填参数改由
allOf/if/then声明(get_screenshot的 region / window、remote_keyboard的 type / key、remote_mouse的 drag、terminal_exec的二选一);get_server_status直接返回状态对象;search_file的files.items补全字段;http_probe的响应头进入文本块 - 文本客户端可用:
list_hosts/get_audit_log/list_files/get_host_detail在摘要后追加制表符表格,64 位主机 ID 终于出现在content[].text里,只读文本块的客户端也能继续调用后续工具 list_files先列全目录:不再在 500 条处截断并谎报hasMore=false,改为列全(100000 条上限防病态目录)后再分页;文件管理通道两端统一按 GBK 编解码,GBK 无法表示时直传 UTF-8- 终端会话语义:
terminal_exec可不带session_id隐式打开或复用会话;超时不再销毁会话而是返回done:false+ 已有输出,后续传session_id轮询直到done:true+exit_code;terminal_close可在没有等待者时立即回收;忙时提示写清占用者与出口;mcp_cancel_session支持按request_id/id/session_id定位,id=0不再被当作「全部主机」 - 超时与拒绝前置:
host_inspect60 秒后不再启动新 aspect,跳过的写进errors.<aspect>并提示减少 aspects;remote_open对声明了能力位却没有CLIENT_CAP_SCREEN_PREVIEW的 Linux 主机立即回 -32005,而不是等满timeout_ms;exec_command默认只读白名单增加sc qc/sc enumdepend/sc sdshow - 说明文本:
initialize.instructions与代码逐条对齐(get_keylog受开关控制、-32006 / -32005 的真实含义、Linux 上host_set_remark/host_set_watch_level可用、local_dir是主控机上的路径);get_client_log明确区分「客户端运行日志」与业务程序日志,并把读业务日志指向read_file - 中文进程名:连接列表改走 UTF-8 → UTF-16 再用
LVM_SETITEMTEXTW写入(此前的CA2T(..., CP_UTF8)在 MBCS 构建里忽略代码页,等于原样拷贝),排序仍按原始 UTF-8 字节 - 试用软件:已有授权码时不再直接拒绝,而是询问是否覆盖为试用口令;语言对话框显示语言包目录的绝对路径(未设置时显示「内置 / 预设」);远程交谈在未选择主机时不再弹无意义的确认框
- 危险操作说明化:注销 / 重启 / 关机 / 删除主机 / 卸载客户端 的确认框会列出目标主机(最多五行)且默认按钮为「否」;「高速 / 极速」更名为「高画质(DXGI 差分)」/「流畅(GDI H.264)」;Ctrl+F 从「查找下一个」改为即输即筛(IP / 归属 / 备注 / 系统 / 版本),Esc 清空;自适应档位会显示 20 秒切换原因
- 配置读取:
iniFile/binFile的读取改用RegOpenKeyExA,普通GetStr不再在注册表里凭空创建空子键;SaveQualityProfiles恢复默认时会把默认值真正写回
Bug 修复
- 两个能被远程对端直接打死服务端的输入路径:cpp-httplib 0.14.3 用
strtoull解析Content-Length,-1回绕成ULLONG_MAX后进入吃掉 18 EB 的死循环,32 个连接即可锁死线程池(且在校验 token 之前);回填上游parse_content_length_strict(),只接受纯十进制数字并拒绝溢出。HideScreenSpyDlg::JPG_BMP用 libjpeg 默认的error_exit(即exit()),一帧畸形 JPEG 就结束整个服务端;改为setjmp/longjmp返回失败,36 个畸形样本中原本会终止进程的 19 个现在都只是返回 false - 远控音频永久静音:环形缓冲与
WAVEHDR在 IOCP 工作线程与 UI 线程之间无锁共享,重复入队(waveOutWrite返回 33)且非原子计数下溢;现由递归互斥量串行化,设备的打开 / 重置 / 关闭只在窗口 UI 线程执行。另修:音频格式包早于CScreenSpyDlg创建而被丢弃导致一直无声(主控主动请求重播)、Modern Standby 恢复后端点失效(客户端按自身循环间隔检测冻结并重建,主控在WM_POWERBROADCAST重建 waveOut)、编码器不跟随端点声道与采样率变化 - 质量切换两处回归:切档后画面跳到另一台显示器(
switchScreen=false误用了「下一个」索引);从 RGB565 / DIFF 切回 H.264 冻结最长 10 秒(客户端编码器跨算法保留了参考帧,改为算法或调优变化后重建编码器) - 慢帧下自适应质量失灵:单帧耗时数秒时每秒完整帧数为 0,吞吐判据永远弃权,播视频时 Ultra / High 反复跳档;改为用最近 10 秒环形窗口计算速率,并对滚动突发与时钟补丁设防
- Web 远端黑屏:隐藏的 Web / MCP 屏幕会话收不到
TOKEN_FIRSTSCREEN,m_bIsFirst一直为 TRUE,分辨率变化后的关键帧全被丢弃;另外非 H.264 档位(Ultra / High)根本不会转发到 Web。现在 IDR 解码后清除标记、隐藏会话钳制为QUALITY_GOOD并把画质档位提示推给页面(不再静默黑屏),同时给 DIFF / 灰度 / RGB565 解码器加上块偏移与滚动参数边界 - Web 终端「过一会儿就用不了」:Go 服务端用 33 字节的 ACK 回心跳,而 Linux / Android 客户端要求 1025 字节,应用层 ACK 看门狗从未被喂饱,每 60 秒断开重连一次;每次重登录都替换整个 hub 设备记录,屏幕 / shell 子连接绑定被抹掉,于是能收输出但按键全部丢失。现在客户端也接受旧的 32 字节 ACK,服务端发完整的 1024 字节结构,重登录时保留子连接状态
- 远程桌面窗口尺寸变化后不重绘:
OnSize只更新布局参数不请求重绘,而窗口在首帧后已停止擦背景且没有重绘定时器,最大化还原后画面停在放大前的裁切状态,直到远端有内容变化 - macOS 子连接线程泄漏:POSIX 下
CloseHandle是空实现,接收线程既不 detach 也不 join,每个子连接永久占一个线程;六周后达到 2048 线程 / 1333 上限,之后所有需要起工作线程的命令静默失败。现在创建后立即 detach,并把S_STOP作为线程最后一笔写 - 子连接不继承协议:
common/sub_conn_thread.h未调用SetDefaultProto,反代后子连接仍按明文 TCP 拨号;Android 与 macOS 的子连接同样补上 - HELL 头编码固定:Release 客户端构造时随机选一种编码并终身不变,Go fallback 服务端只解
None..V6,抽到 V7–V10 的约三分之一客户端永远登不上;现在登录失败后轮换并在同一次运行内共享 - 运行时长恒为 0:主控把客户端按本地格式化的墙钟字符串与自己的本地时间相减,UTC+8 客户端在 UTC+1 主控上必为负并被钳成 0;新增
RES_UPTIME(进程运行秒数),跨时区与时钟偏差天然抵消 - 登录保留区越界:
AddReserved写分隔符前没有长度检查(客户端未安装无效参数处理器,溢出即崩溃);改为统一的边界检查追加,超长值留空槽而不是丢掉分隔符 - 特性限制在 32 位主控上丢项:
CCheckListBox的用户字段只有 32 位,bit 32 及以上的 26 个主菜单项与 14 个右键菜单项在 x86 主控上勾选无效(x64 不受影响,且 C4244 被全局关闭所以从未告警);改为存行号索引再回查标志 - 连接列表中文进程名乱码:
CA2T(x, CP_UTF8)在 MBCS 构建下等于memcpy,UTF-8 字节被按 GBK 渲染 chat_wait误报超时:排空收件箱后才判定超时,已收到消息的等待仍标记为timed_out;改为在排空前快照到达状态- Android 连接生命周期五处:主客户端句柄改
shared_ptr(分离线程可能活过ConnectionThread的清理)、重连循环在每条分支校验代际(否则快速nativeStop→nativeInit会产生两条同 ID 主连接)、活动上报线程补 try/catch 与 RAII 计数(异常曾直接std::terminate,一次失败后所有后续调用都被静默丢弃)、nativeStop停止采样器、子连接继承protoType - Go 服务端中文计算机名:
szPCName与 OS 字段不由CLIENT_CAP_UTF8覆盖,Windows 客户端填的是 CP936;改为按客户端类型选择 GBK / UTF-8 - 其它:macOS 上
pthread_t强转uintptr_t编译失败(Darwin 是指针,改reinterpret_cast<HANDLE>);屏幕预览提示框高度超出工作区(现在同时压缩图形与换行);浮动工具栏的质量菜单一打开就触发收回;删除无人引用的file_server.h
升级提示
- MCP 工具面变化:工具清单从 60 项收敛为 54 项,全部开关打开时
tools/list列出 49 项——这是合并而非删除:host_list_*、list_online_hosts、search_hosts、list_all_hosts、operate_window、control_service等旧名仍可按原参数调用。开启McpMachine时list_processes/list_windows/list_services不再列出(依旧可调用)。升级后建议重连一次连接器,部分客户端会缓存上一次的inputSchema - 新 MCP 能力需要新客户端:Android 的预览 / 活动历史 / 日志 / 终端 / 交谈 / 剪贴板 / 锁屏 / 隐私遮罩 / 卸载 / APK 升级,macOS 的终端与进程管理,全部以能力位区分;旧客户端对应工具会直接回 -32005,而不是挂起等超时
- 内置 TLS 证书默认开启:全新安装无需 openssl 即可加密;但如果之前分发过带信任锚的客户端,升级后证书可能已变(丢失存储会重新生成),需要重新下发锚或重新生成客户端。勾选「内置证书」并使用内置证书时,MCP HTTPS 不会回退到残留的自定义证书路径(自签证书无法通过公共 MCP 客户端校验)
- 内嵌证书的边界:生成客户端时的勾选只对目标地址与生成时主控地址一致的连接生效;转移 / 分享 / 平行实例会回退明文首连,这是有意设计,不是故障
- 调优开关迁移:x264 码率封顶(VBV)默认关闭;已显式保存过
TuningX264Vbv的机器保留原选择。每客户端的设置优先于旧的全局[settings] Tuning*,但旧全局键在两者都不存在时仍会被采纳,显式关闭不会被迁移覆盖 - 三个平台的客户端二进制本次没有入库:
linux/ghost、macos/ghost、android/ghost.apk本次发布没有提交到仓库——计划等这三个平台再稳定、功能更完整之后再入库。发布方提供的Yama.exe已内嵌本次全部最新客户端,开箱即可用;但如果自行编译主控,必须自行编译这三个平台的客户端,否则内嵌的仍是旧二进制(或缺失),装上去的主机将很难再远程升级:- Linux:
cd linux && cmake . && make(产物linux/ghost) - macOS:
cd macos && ./build.sh(产物macos/ghost,arm64 / 部署目标 11.0) - Android:
cd android && ./build_apk.sh(WSL / Linux,产物android/ghost.apk,再用android/sign_apk.bat或你自己的密钥重签)
- Linux:
- Android 客户端能力位变化较多:APK 必须是按 HEAD 编译并重新签名的(V1+V2,arm64-v8a + armeabi-v7a);用旧包生成的主机缺少预览 / 活动历史 / 日志 / 终端 / 交谈 / 剪贴板 / 锁屏 / 隐私遮罩 / 卸载 / APK 升级这些能力位,对应工具会回 -32005
- Go 主控 MCP:需要设置
YAMA_MCP_TOKEN才会注册/mcp(未设置时返回 404),必须经 HTTPS 反代暴露;YAMA_MCP_READONLY=1只开放 7 个工具,YAMA_MCP_MAX_CONCURRENCY/YAMA_MCP_TERM_IDLE/YAMA_MCP_READ_MAX控制闸门与终端回收
Downloads
- 合并后的清单:本次新增 5 个工具(