Repository navigation
🎉 正式发布:相比 v0.1.1(2026-06)的主要变化
- Android Agent A1/A2/A3 可靠性全面落地:链路打通(A1)、手势注入/屏幕采集/找色找图/远程截图(A2)、开机自启/崩溃自重启/核心看门狗/机型保活指引/受限设置引导(A3),APK 随 nightly 分发(
wingman-*-android-arm64.apk) - 密钥保险箱:主口令派生加密存储(PBKDF2-HMAC-SHA256 600k + AES-256-GCM)、连接快捷调用(
useSaved自动注入凭据)、管理界面(设主口令/解锁/锁定/条目列表/导出) - Guacamole 目标转发中继:guacd 不直拨目标,字节流经 Agent TCP 链路由 runtime 侧拨真实 target(解决云/NAT 下 server 与目标不同网段必败)
- 一键安装三件套:
install.sh/install.ps1+ agent 独立构建矩阵接入 nightly 分发(linux/macos/windows × x64/arm64 六腿) - 三处生产级修复:Dashboard 列表恒空(useRequest formatResult)、Guacamole WS 票据 401(URL 污染)、浏览器 WS 握手秒断(子协议回显缺失)
fix(2026-10-03,正式版发布链两处根因——reusable job 被静默丢弃 + 资产校验查 draft 恒 404)
v0.1.2 首次正式发布连续两次卡死,两处根因均无错误提示、只在 run 的 job 数量上体现。修复后 run 37088776490 十三 job 全绿,v0.1.2 十三资产上线。
- 根因一:reusable job 被静默丢弃(
prerelease需fromJSON转型):callee 把prerelease声明为type: boolean,而 job outputs 一律是字符串(resolve-version写"true"/"false")。GitHub 在图构建期做with:类型校验,字符串直传 boolean 类型的输入会让整个 reusable job 被丢弃——失败发生在图构建而非 job 执行,因此 run 里只有resolve-version/create-release成功、build 侧无 check-run 无 annotation、内层 run 不创建、publish-release随之 skipped 而整条 run 记 failure(37081668034 / 37085699901 复现)。修复:两处with:改fromJSON(needs.resolve-version.outputs.prerelease)。- 前两次修复(cabfa81 callee 顶层 env 下沉、453dc13 build-agent env 下沉)方向判断有误:env 下沉本身是有效的卫生改动,但与本故障无关,移除 env 后故障依旧。四个探针逐项排除后定位:x2(移除
secrets: inherit)、x4(needs改单值不传ref)、x5(不传ref)各自只改一处仍失败;x3 同时把prerelease改字面量false并换最小 callee,job 成功创建并运行 noop——x3 与其余三支的唯一共同变量即类型不匹配。
- 前两次修复(cabfa81 callee 顶层 env 下沉、453dc13 build-agent env 下沉)方向判断有误:env 下沉本身是有效的卫生改动,但与本故障无关,移除 env 后故障依旧。四个探针逐项排除后定位:x2(移除
- 根因二:资产大小校验查 draft release 恒 404(
remote_size_of改走 release id):根因一修复后 11 条构建腿全绿,但两个publish-assets在校验环节失败——gh: Not Found (HTTP 404) /releases/get-a-release-by-tag-name加[: {"message":"Not Found"...}: integer expression expected。根因是校验逻辑而非上传:remote_size_of走/releases/tags/<tag>端点,而 GitHub API 不允许按 tag 取未发布的 release,正式版的 draft 正是create-release建的,该端点恒 404;上传本身成功(v0.1.2 draft 上 agent linux-arm64 6172495B 与 android-arm64.apk 28188410B 均为uploaded)。修复:先从/releases列表按tag_name筛出 release id(列表端点含 draft),解析不到即报错退出,再按 id 取资产大小。本机以 v0.1.2 draft 实证:新路径返回 6172495(与本地产物字节数一致),旧路径 404。build-package.yml与build-agent.yml的publish-assets各有一份同款逻辑,一并修正;两段脚本经 shellcheck error 级校验干净,actionlint 无 schema 错。 - 发布实证(run 37088776490,tag push 路径):十三 job 全 success——三平台整包(windows-x64 34995637B / linux-x64 111850460B / macos-x64 35102132B)+ android-arm64.apk 28188410B + 六腿 agent 矩阵 +
SHA256SUMS.txt/BUILD_INFO.txt/VERIFY.md。真实下载wingman-v0.1.2-macos-x64.tar.gz跑sha256sum -c --ignore-missing得 OK。 - 已知瑕疵(未修):
BUILD_INFO.txt的Commit:行显示 tag 名v0.1.2而非 commit SHA——resolve-version的refoutput 直接赋 tag 值,该行本意是记录构建 commit。不影响资产完整性(SHA256SUMS 覆盖),下版修正。
feat(2026-10-03,密钥保险箱——主口令派生加密存储 / 连接快捷调用 / 管理界面,附 dashboard 列表与 Guacamole WS 三处生产级修复)
cockpit 密码箱模式的 wingman 落地:远程桌面凭据加密存本机、连接时自动取用,解决「密钥不能每次手输」。走查口径:存一次密钥 → 断开 → 重连凭据留空 → 经 useSaved 自动注入建会话。
- 加密结构(
internal/security/vault.go+models/vault.go,新):主口令PBKDF2-HMAC-SHA256(salt, 600k)派生 KEK → AES-256-GCM 包裹随机 32B DEK 落库;凭据Password/PrivateKey经 DEK AES-256-GCM 加密落库(hex nonce‖ciphertext)。DEK 仅解锁期驻留内存、空闲超时锁回,主口令与 DEK 永不落库、不留可校验口令摘要(解锁 = 解开 WrappedKey,GCM 认证失败与篡改不可区分)。忘主口令即不可恢复是设计属性;与 cockpit 的差异:对方落库密文用 server 级 env 密钥,本实现按用户主口令派生——存储被拖走也解不开。 - API(
handlers/vault.go,routes.go装配):/api/remote/vault/{status,setup,unlock,lock,change-password,credentials,export}与票据同权限面desktop:view|control;写操作 handler 内要求解锁态(423);凭据按 (用户, agent, 协议, 端口) 唯一 upsert;导出仅回密文。 - 快捷调用(
guacamole.go票据侧):useSaved=true时只填充请求里缺失的 username/password/domain(现场显式值优先),解密结果只进票据参数不进日志/审计(authSource 仅记user|saved枚举)。 - 管理界面(
VaultManagerModal新 + Agents 页接线):首装设主口令(双输入校验)/解锁/锁定(表单内联解锁)/条目列表/删除/导出 Popconfirm 确认;连接表单「保存到保险箱」「使用保险箱已存凭据」(探测命中且解锁默认勾选)+ 端口字段透传(RemoteSessionParams.port)。隐私默认:凭据不出本机、导出需明示确认。 - 三处生产级修复(同批真实走查中定位):
- Agents/Scripts/Workflows 列表恒空:umi
useRequest包装器恒注入formatResult: r => r?.data,service 手工解包返回裸数组被二次取.data得 undefined——四处 service 改回完整 ApiResponse 信封交 formatResult 解包。 - Guacamole WS 票据 401:
WebSocketTunnel.connect(data)原样拼base + '?' + data,client.connect()空参拼出?ticket=x?undefined污染票据——guacamoleWSPath改只返干净基址,票据作 connect 数据传(ticket=<enc>)。 - 浏览器 WS 握手秒断:guacamole-common-js 以子协议
guacamole建连,Chrome 对「请求了子协议但响应未回显」判握手失败即刻关闭(会话建立同毫秒被浏览器拆,日志上像服务端秒杀)——upgrader 配Subprotocols: []string{"guacamole"}回显;不请求子协议的集成测试裸 WS 不受影响。
- Agents/Scripts/Workflows 列表恒空:umi
- SPA fallback(
routes.goNoRoute):未命中路由先按静态文件找(umi 产物含根级umi.<hash>.js、preload_helper),未命中回 index.html 交客户端路由;/api、/swagger未注册路径保持 404 JSON,path.Clean归一防穿越。 - 测试(全绿口径):
go test ./...14 包 ok(security/handlers 新增 vault 用例:错口令拒绝、密文篡改拒绝、解锁态机、唯一 upsert、useSaved 填充语义);jest 427/427(新增vault.test.ts+ remote/modal 用例更新);tsc --noEmit0。 - 真实走查(headless 浏览器全链路)10/12:登录 → 设主口令 → 手输凭据+保存勾选连 SSH → 断开 → 重连凭据留空(useSaved 默认勾选)→ 自动注入建会话 → 条目列表 → 导出确认,全 PASS;2 项远端键入铁证(echo 落盘)未过——走查栈 guacd 子进程在 SSH 成功后 ~300ms 早退(票据链、中继 accept、SSH 握手均已验通),根因待独立跟进。
feat(2026-10-03,Guacamole 目标转发中继落地——guacd 不直拨目标,字节流经 Agent TCP 链路由 runtime 侧拨真实 target)
背景:guacd 原先按 connect 参数直拨 endpoint 地址,云/NAT 部署下 server 与目标不同网段必败,且 endpoint 的 RDP/VNC/SSH 端口本就不该对 server 暴露。自 cockpit 0767b8b 移植中继方案(对方仓库已跑通):每会话 Go server 起 127.0.0.1:0 回环 listener,connect 的 hostname/port 指向中继,字节流按代理协议(proxy.new/proxy.data(base64)/proxy.close/proxy.error,Notify 帧)在既有 Agent TCP 链路上搬运,runtime 侧 ProxyTunnel 从自己网络位拨真实 target——host 语义变为「agent 侧可达地址」。设计定案见 docs/remote-gateway-guacamole-design.md §4.5/DG-10(§4.1 流向图、§4.3 runtime 角色、§4.4 地址解析、§9 合规表、§10 不做清单同步修正)。
- server 侧(
internal/agent/guac_relay.go,新):GuacRelay每会话一个回环 listener;guacd 侧连接的读泵保留 cockpit 拷贝纪律(buf[:n]先拷贝再入队/序列化——异步写泵会被下次 Read 覆写,RDP 亚毫秒连发高频命中);guacRelayDeliver/HandleClose/HandleError按 proxyID 经包级注册表路由;发送口agentConn.SendNotify(新导出方法,持既有写锁)。listener.gohandleNotify 增 proxy.* 三分发;guacamole.go在 WS 升级前起中继(失败回干净 502 JSON 而非半截隧道)、connect 参数覆写为中继地址(审计与会话记录仍记真实目标)、closeSession随会话拆中继;票据侧对 registry IPSplitHostPort剥临时端口(conn.RemoteAddr()原文含 ephemeral 端口,不剥则中继 target 拼成ip:ephemeral:port;无端口的手动注册/裸主机名原样保留)。 - runtime 侧(
libs/agentcore/src/proxy_tunnel.cpp/.hpp,新):ProxyTunnel 只拨号不监听(架构硬约束零触碰)。线程模型为每连接一个 worker 线程跑 io_context 全生命周期——socket 全部操作(拨号/读泵/写入/收口)都是该线程内 async handler,其他线程只 post 投递或查 atomic 标志;stop()先逐连接 post 收口再 join 全部 worker。该模型是退出期崩溃的根治:初版 detached 线程实现下全量二进制偶发terminate ... std::system_error(detached 线程与静态析构竞态;CI 按 gtest_filter 单测跑永远看不到全量退出,本地 3 次全量重跑均 0 也难复现,docker 构建并发负载下现形一次后定位重写)。proxy.data先于拨号完成到达(guacd connect 一成功即发协议首包)时写入进 per-conn 队列、拨通后按序冲刷——无拨号等待原语、无丢首包窗口;代理流不缓冲重放(proxy.data不入 outbox,链路断即拆链会话作废)。内置 base64(agentcore 层禁依赖 lib/wingman 的 crypt)。remote_client.cpp注入 ProxyTunnel 并分发 proxy.* Notify,stop()在断链后拆全部连接。 - 测试:agentcore +5 例(双向回环 / 目标 EOF 回 proxy.close / 拨号失败回 proxy.error / stop 后迟到 proxy.new 拒绝 / 坏 target 与坏 base64 优雅拒绝),33 例全绿 ×4 轮全量 + 3 轮并发全量均无退出期 terminate;
agent_sim_test.go的 simAgent 升级为真 TCP 链路 + 代理数据面(proxyHandleNew在 readLoop 内同步拨号保序、target→server 读泵、幂等拆链),guacd e2e 从纯注册表登记改走真链路;三协议真链路 e2e(SSH/VNC/RDP 全经中继)RC=0,加三个拒绝路径(未知 agent 404 / 坏协议 400 / 伪票据 401)。Go 全模块go test ./...绿。 - docker 镜像:
orchestrator/server/Dockerfile构建验证(golang:1.26-alpine → alpine 运行时,95.4MB),容器启动 healthy 冒烟通过(JWT secret 32+ 字符校验路径顺带覆盖)。
feat(2026-10-02,wingman agent 一键安装三件套——install.sh / install.ps1 / agent 独立构建矩阵接入 nightly 分发)
一条命令(curl … | bash / irm … | iex)从每日构建分发面安装 wingman-agent 单二进制:自动检测 OS 与 CPU 架构、匿名下载(release 资产直链天然免登录,Actions artifacts 需登录故不作分发面)、解包放 PATH、wingman-agent --version 验证、幂等(重跑即覆盖升级)、失败即停带明确报错。README 新增「一键安装 Agent」节(三平台命令一行复制 + 参数形态 + 支持矩阵表)。
- agent 分发矩阵(.github/workflows/build-agent.yml,新):linux/macos/windows × x64/arm64 六腿,只构建
wingman-runtimetarget 打包为wingman-agent-<ver>-<os>-<arch>.{tar.gz,zip}(整包矩阵 build-package.yml 不动——GUI/server/Dashboard 构建贵,agent 单体轻)。windows-arm64 用 windows-11-arm runner +arm64-windows-statictriplet(configure-windows.ps1 增-Platform/-Triplet/-Generator参数,向后兼容默认;初版-static-md静态库配动态 CRT 与根 CMakeLists 无条件 /MT 相撞 LNK2038,修正为全静态);armv7 无 runner 不产出,安装侧明确报错不猜测。publish-assets 与 build-package.yml 同款纪律:gh release upload --clobber+ 3 次指数退避重试 + 远端大小逐文件校验;release_tag 为空时只出 artifacts 不发布。 - nightly 接线(nightly.yml):build-agent job 复用 resolve-version 与同一
nightly滚动 tag;nightly-notes 资产表补 agent 行;cleanup-assets 修剪正则扩展为^wingman-(agent-)?<date>-nightly-<sha>-(整包与 agent 单体按同 sha 一组保留,避免旧正则把 agent 资产当遗留格式误删)。 - install.sh(Linux/macOS,~300 行,bash + 零依赖):OS/架构检测(
Linux|linux→linux、Darwin→macos、MINGW/MSYS 指向 install.ps1;x86_64|amd64|x64→x64、aarch64|arm64→arm64;armv7/armv6 明确报错含 issue 指引;不认识的主机/架构报错引用实际输入值);JSON 解析零依赖(grep -oE+cut -d'"'提取 browser_download_url,紧凑/缩进两形态通吃);版本选择 =/releases?per_page=30时间倒序取第一个含本平台 agent 资产的 release(正式版优先,正式版尚无 agent 产物时自然落到 nightly),--version TAG走/releases/tags/;HTTP 失败按状态码分型报错(403 限流含 token 提示 / 000 网络含可达域名说明 / 404 tag 不存在);幂等升级 =rm -f+install -m 0755(防运行中二进制 ETXTBSY)+ 新旧版本对照打印;--version验证失败时 Linux 侧ldd列出缺失动态库;--service注册 systemd user unit / launchd LaunchAgent(先停旧实例幂等;headless 需 linger 的明确指引);PATH 缺失打印 export 提示不代改 rc。 - install.ps1(Windows,PS 5.1+ 兼容):Desktop edition 视为 Windows(无
$IsWindows)+ 强制 TLS 1.2;PROCESSOR_ARCHITECTURE检测 AMD64/ARM64,x86 与未知值明确报错;param 默认值惰性求值(绑定阶段$env:LOCALAPPDATA在非 Windows 会话为 null 会先抛——真跑抓到);查询统一Invoke-WebRequest -UseBasicParsing+ConvertFrom-Json(pwsh 7.4 的Invoke-RestMethod对 JSON 数组响应返回嵌套数组不枚举、5.1 又平铺展开——本机实测分叉后统一 IWR 路径);用户 PATH 幂等追加(2047 字符上限防御);-Service注册 Windows 服务(管理员检测 + Session 0 无桌面访问的明确警告,建议 headless 专用);下载与查询分离——token 仅用于 API 提额,二进制走资产匿名直链。 - cli 验证入口:
wingman-agent --version/-V/version三拼写等价(cli.cpp dispatch + RuntimeCliTest 新用例,全树注册 2518 → 2519)。 - 版本后缀接线(0eaa69d):configure-unix.sh:45 / configure-windows.ps1:66 早已传
-DWINGMAN_VERSION_SUFFIX=,但根 CMakeLists 无任何消费点,宏与命令行变量断开、后缀无声丢弃——--version对所有 nightly 一律报纯Wingman 0.1.0(资产名里的日期与 sha 只进包内 VERSION.txt,二进制内无迹),install.sh 的Upgraded: X → Y升级感知分支因新旧两串恒相等永不触发,启动日志与运维侧无法区分当日报的是哪次构建。修复:根 CMakeLists 消费该 cache 变量(默认空 = 正式版输出不变)派生WINGMAN_VERSION_FULL_SUFFIX,version.hpp.in新增WINGMAN_VERSION_FULL并拼进WINGMAN_VERSION_STRING,启动日志改用 FULL;WINGMAN_VERSION保持纯 semver 不掺后缀(system.getVersionRPC 据此上报 Go server,刻意不碰以免波及协议侧解析)。边界:后缀按 nightly.yml resolve-version 形态为<date>-nightly不含 sha——同日多次构建版本串相同(逐构建 sha 仍由 VERSION.txt 承载),升级感知按日触发而非按构建。本地两形态实测:带后缀 →Wingman 0.1.0-2026.10.02-nightly,置空 →Wingman 0.1.0不变。 - 验证:install.sh
bash -n+ shellcheck 干净;防御分支全实测(--help / armv7l 报错引用实际输入 / SunOS / 未知参数 / 真 API 无 agent 资产时明确报错 / --version 404);URL 与 tag 提取链对真 API 数据验证;install.ps1 AST 解析干净 + Linux 下非 Windows 防御分支真跑(exit 1 指向 install.sh)+ 带 token 真实 API 遍历(跳过 0 资产正式版、命中 nightly linux-x64 资产、tag 提取正确)。验证边界如实说明:ps1 Windows 主流程未在本机真跑(无 Windows 环境)。六腿 CI 收敛(三轮修复 f5d48d8/1e520dc/74e9be8):unix 三腿 compat 开关默认值、linux-arm64 预装 cmake 4.4(vcpkg STRING_ENCODE 需 4.4+ 且 arm64 不自动下载 host tool)、windows-arm64 VS18 生成器(windows-11-arm 镜像 2026-09 起切 VS2026)+ 全静态 triplet、security 反调试/反VM x86 专属 API ARM64 编译期回退;run 36989019047 六腿全绿。nightly 分发上线(run 36991734536 全绿):wingman-agent-2026.10.02-nightly-74e9be8-*六资产与整包同组挂上 nightly release,旧组资产自动修剪。本机 Linux 端到端真装:README 一行命令原文curl -fsSL …/install.sh | bash真跑——匿名 403 分支真实触发且文案准确(含 token 提示),GITHUB_TOKEN提额后正确选中 nightly linux-x64 资产、装至~/.local/bin、--version验证通过、幂等重跑 exit 0。本机补验(18:29):装入二进制与 release 资产 sha256 逐字节一致;--version nightly锚定路径真跑通过;--service端到端——systemd user unit 注册→enable→start 全过,daemon 真启动并按架构硬约束 outbound 连 server(默认 127.0.0.1:8888,本地无 server 时退避重连),验证后 disable + 删 unit 还原(not-found / inactive / 零残留 / 无进程)。后缀接线端到端(run 36996458690 全绿,4f61ebb 含 0eaa69d):nightly 二次派发刷新资产组(4 整包 + 6 agent 单体,旧 74e9be8 组修剪,重复派发的 36998504472 已撤销避免竞争上传);本机重装首次实测Upgraded: Wingman 0.1.0 → Wingman 0.1.0-2026.10.02-nightly——修复前恒相等永不触发的升级感知分支真实触发;直调--version打印Wingman 0.1.0-2026.10.02-nightly;同日幂等重跑回Installed:同串,按日触发边界符合设计。仍未本机覆盖:ps1 Windows 主流程、macOS/Windows 安装链——分别依赖 CI 证据或留待有环境时补验。
feat(2026-10-01,wingman.task pause/resume 落地——协作式暂停四检查点 / 超时时钟悬挂 / pausedFrom_ 状态恢复 / task.paused·resumed 事件)
docs/development-todo.md 缺口清单条目「pause(taskId) / resume(taskId)(未实现)」落地,Lua/Python 双侧 API 同步(清单中「API 形状统一」「命名风格统一」两项范围模糊,按任务指示留后)。
- 协作式暂停语义(无法挂起正在执行的 work 本身,暂停在生命周期检查点生效):① 开工前(execute 入口)驻留不执行;② work 执行中被暂停则完成后结果扣住不落账(resume 才提交 succeeded,cancel/timeout 打断则丢弃);③ 重试间隙不进入下一次尝试;④ 超时时钟在暂停期间停走(timeout 线程驻留、deadline 顺延暂停时长)。状态机
pending → running → paused → running恢复,仅 pending/running 可 pause、仅 paused 可 resume(其余含不存在返回 false)。 - pausedFrom_ 状态恢复(自查抓出的真缺陷):resume 一律恢复 running 会使「worker 启动前完成 pause+resume」时 execute 入口误判重入直接返回——work 永不执行且无超时监控。改为 pause 记录
pausedFrom_、resume 恢复原状态(开工前→pending,执行中→running),入口为「驻留环 + 仅 pending 开工」。 - 配套收口:重试检查点驻留醒来后复查 cancel/timeout(否则 cancel 打断后会带着 canceled 状态落入 try 执行 work);超时线程
wait_until改谓词化消除 pause 的 lost-notify 竞态;wait() 将 paused 视为未完成继续等待、等待者超时对 paused 只返回 false 不改写状态不发事件;cancel() 改为仅状态真正转换时发task.canceled(终态任务不再发误导事件);TaskManager::shutdown 先 cancel-all 再 join(暂停中任务超时时钟已停走、可能无限驻留);pause/resume 与 cancel 同款「锁外调 task 方法」防事件死锁纪律。 - 双侧落地最小面:C++ ModuleDescriptor 注册 pause/resume(Lua 侧即得);Python 侧经 registerModule + camelToSnake 自动绑定零运行时代码,仅补
task.pyi(TaskStatus Literal 加"paused"+ 两函数签名)。新增task.paused/task.resumed生命周期事件(载荷 taskId, metadata)。 - 测试(TaskModuleTest 42 → 47 例):PauseRunningTaskHoldsCompletionUntilResume(扣留+wait 契约+事件计数)、PauseResumeInvalidTargetsReturnFalse(不存在/缺参/非字符串/终态)、CancelPausedTaskDiscardsHeldResult、PauseSuspendsTimeoutClock(timeoutMs=300 下暂停睡 600ms 仍 paused 对照钉时钟停走)、PauseBetweenRetriesDelaysNextAttempt(backoffMs=300 下暂停睡 400ms attempts 仍 1 对照钉停试)。
- 验证:新 5 例 ×10 连跑全绿;全量两树 ctest(CI 口径 xvfb-run 串行 --timeout 300)2518 注册(2513+5)两树各 100% 全绿、0 failed。文档同步:docs/api/task.md(暂停/恢复章节 + status 返回加 paused + 接口表 + 事件表)与 development-todo.md 勾选。
ci(2026-10-01,C++ Linux (full tests, Python engine) 网络下载脆弱性修复——libuuid vendor 预缓存旁路 sourceforge 单点)
- 现象与根因链:7071a54 CI 唯红该 job 的 Configure CMake 步。依赖图 python3 → libuuid 走
vcpkg_from_sourceforge;sourceforge 事故窗口内源站 522(vcpkg 判非瞬态不重试)、~20 个镜像全部返回坏内容(unexpected hash)→ workflow 层 configure 3 次重试全灭。仓库无 ExternalProject/FetchContent;哈希钉死的对应机制即 vcpkg port 的 SHA512(随 builtin-baseline 固定,vcpkg_from_sourceforge内置)——真正缺失的是「预缓存」腿。全图核查:该 job 依赖面里 sourceforge 托管的下载仅 libuuid 一个(28 端口逐一遍历 portfile 实证),其余全在 github/lua.org/sqlite.org。 - 放大器(登记,不修):actions/cache 两维虽命中(397MB 恢复),但 Linux files 二进制缓存 ABI 恒不匹配(全部 Linux/macOS job 每轮
Restored 0 package(s)、全量源码构建),且 GitHub cache key 不可变(对已存在 key 的 save 必失败,downloads 缓存成化石、不含 libuuid)→ libuuid 每轮重下、SF 挂即恒红。Windows job 走 NuGet(恢复 20 包)不受影响。滚动 cache key 只摊薄首建成本、首建仍需本预缓存,不另立项。 - 修复:vendor
build-scripts/ci/vcpkg-downloads/libuuid-1.0.3.tar.gz(318KB;deac-riga 镜像取货,SHA512 与 baseline portfile 钉值逐位一致)+sha512.manifest(sha512sum --check --strict口径)+seed-vcpkg-downloads.sh(先验后拷进${VCPKG_ROOT}/downloads)+ ci.yml 该 job 在 Prepare/Configure 间接线。vcpkg 下载前先查本地文件并按 portfile SHA512 独立复验,命中即零网络——脚本清单与 vcpkg portfile 双层哈希即供应链边界;baseline 升级若改端口哈希,清单先行失败给出明确报错(脚本头注释含更新口径)。 - 验证:本地
vcpkg install libuuid:x64-linux --no-downloads(禁网)全链通过(SHA512 校验→构建→二进制缓存提交);种子脚本 shellcheck 干净、篡改腿实测拒绝(FAILED 即不拷贝)、恢复件哈希复验一致;ci.yml YAML 解析通过;CI 结果见提交对应 run。
fix(2026-10-01,ScriptManager 状态机死锁环修复 + stop 数据竞争根治——running 赋值 / 协作停止 / 重入防护 / 运行代号)
2026-09-29 覆盖率扫描登记的结构性缺陷(当时明确「建议独立任务」,本条即该任务):runScriptInternal 从不赋值 ScriptState::running(全文件唯一赋值点在 resumeScript,而 resume 前置 paused、pause 前置 running——死锁环),导致 pause/resume 成功腿、pauseAll/resumeAll/stopAll 批量计数增量、running/paused 状态映射(standalone_mode / script_module 两处消费方)与对应 state_changed 推送全部不可达(真机同样不可达);stopScript 成功腿仅 starting 窗口并发 stop 可达,且伴生 engine->shutdown() 与执行线程的数据竞争(shutdown 做 lua_ = sol::state() 销毁 lua_State,与 execThread 内 executeFile 并发即 use-after-free)。
- running 赋值(死锁环解扣):runScriptInternal 在执行线程起动后、加锁复查仍处本次运行的 starting 时迁移到 running——
start→running→pause→paused→resume→running→stop全链语义正确可达。pause 明确为簿记态:底层脚本线程不被挂起(无引擎级暂停钩子),执行继续到自然完成/超时/停止,簿记态影响前置判定与状态上报。 - stop 协作化(数据竞争根治):stopScript_Locked 对 {running, paused, starting} 只置
ScriptInfo::stopRequested(新原子标志)+ state=stopping + 释放 manager 侧引擎引用(shared_ptr 引用计数操作,线程安全),不再engine->shutdown()——引擎对象由执行线程持有的 shared_ptr 保活、跑完自然销毁(与超时路径既有的 detach 模型一致)。runScriptInternal 等待循环轮询 scriptDone / stopRequested / deadline:停止请求 ≤50ms 内收尾,终态 loaded(区别于 completed/error)、lastError 保持空(停止不是错误);脚本本体继续在后台跑到自然结束。引擎级中断(Lua 指令钩子 / Python trace)工程量超本轮,登记为后续独立项——与登记口径一致,本条只修状态机与数据竞争最小面。 - 重入防护:旧实现 running 态重跑「先 stop 再重启」会与执行线程并发复用同一引擎(且 running 不可达、实为死代码);改为 running/starting/paused/stopping 一律拒绝(false + lastError "already running"),从根上杜绝两个执行线程共享一个引擎。unload/reload/checkReload 的「运行中先停」判定从仅 running 扩到全活跃态集合(paused/starting 态 reload 旧实现不 reset 引擎,重跑会复用执行中引擎——同型竞争,一并收口)。线程创建失败不再停在 starting(会永久卡死重入防护),改记 error。
- 运行代号(runGeneration):reload 对执行中脚本 stop 后立即重启会产生两代运行并存(旧执行线程尚未退出);ScriptInfo 新增每次运行自增的代号,等待线程收尾时若已被更新的运行超越(或条目被替换),不写状态、不动属于新运行的引擎——状态机在并发 reload/restart 交错下收敛。
- 回归钉(4 例):
script_manager_exec_coverage_test.cpp+2——PauseResumeStopFullChainIsReachable(全链逐态迁移 + getRunningScripts 映射 + 重复 pause/resume 拒绝 + 重入防护 + 停止终态 loaded/lastError 空/引擎引用已释放)与 RerunAfterStopCreatesFreshRun(停止后重跑创建新引擎完整执行至 completed);standalone_mode_coverage_test.cpp+2——FullChainRunningPauseResumeStopReachable(经 StandaloneMode 编排面全链 + running/paused 状态映射 + paused→running→stopped 事件序列)与 BulkOperationsCountRunningScripts(双运行脚本 pauseAll/resumeAll/stopAll 计数增量 2)。脚本用wingman.timer.sleep驻留(沙箱下 wingman 全局表可用、全平台、零 CPU),被停后 detached 执行线程睡完剩余时长自然退出。standalone_mode_coverage_test 文件头与批量闲置用例的「结构性不可达登记」注释同步改写为新语义。 - callFunction 登记(不动):同步执行模型下 running 窗口 = 引擎正被执行线程独占,跨线程调用即数据竞争;该接口面向异步模型设计、当前无生产调用方,running 前置保持不变(paused 态直接拒绝已由新用例钉住),引擎级并发安全调用通道随协作停止钩子一并归后续独立项。
- 验证:新 4 例 ×10 连跑稳定;ScriptManager/script_module/timer/rpc_ipc/agent_loopback 相关 161+47 例、CLI script/build 命令面 34 例全绿;全量两树 ctest(CI 口径 xvfb-run 串行 --timeout 300)2513 注册(2509+4)两树各取得 100% 全绿(31 例环境 skip 与既往一致)。门禁插曲如实登记(load 60~69,两例均与本轮改动零交集——剪贴板/transport 不触达 ScriptManager):首跑两树各 1 例
ClipboardTest.HasText/HasHTML假红(clear 后空 owner 接管超 waitFor 窗口,2026-09-30 已登记的 xclip 异步接管家族残余负载风险,隔离 ×10 全绿);复跑 cov 树全绿、build 树漂移出 1 例TcpE2ECoverageTest.ZeroLengthFrameTerminatesLoop(零长帧断开异步收尾的 t=0 直断,负载时序形状,隔离 ×20 全绿);build 树再复跑 100% 全绿。C++ 改动无平台分支(std::atomic+ 显式拷贝构造保持 ScriptInfo 值语义),Windows CI 编译与 Debug 堆验证随推送。
fix(2026-10-01,glue 三用例悬垂指针修复——Windows CI 红根因定位 + Windows 覆盖率脚本补失败断言明细回显)
- CI 红:收官批次推送后 C++ Windows job 唯红
GlueDebuggerModuleTest.StubContract/GlueOrchestrationModuleTest.StubContract/GlueSecurityModuleTest.PassthroughContract(同 commit Linux/macOS 全绿)。根因在本批新文件glue_modules_coverage_test.cpp:findModuleFunction直接在getAllModules()返回的临时 vector 上 range-for 并return &f——函数指针逃逸到已析构对象(悬垂指针,UB)。Linux glibc tcache 释放块内容未复用,侥幸全绿;Windows Debug 堆复用/加毒后读到垃圾std::function→ AV 被 gtest SEH 兜底捕获 → 三用例均匀 ~50ms 假红,且恰好只有走了该 helper 的三例中招。 - 修复:对齐全库既有 glue 用例的
getModule-by-value 模式(先把模块拷贝到局部稳定对象再取函数指针),顺带补if (!fn) return ScriptValue::null()——缺函数时先记断言失败、不再解引用空指针。全库审计getAllModules()消费方:其余 14 处全部按值拷贝或返回 by-value,仅此一处踩坑(含 script_function_test 返回 FunctionEntry by-value、platform_x11 先mod = m再取址)。 - CI 可诊断化(盲区修复):
run-windows-coverage.ps1失败路径此前只回显汇总行 + 日志尾 40 行——gtest 断言明细(file/line/Expected/Actual)打印在日志中段 per-test FAILED 行之前,从 CI 输出永远看不到,本次根因只能靠代码审查反推。补 per-test"[ FAILED ] … (N ms)"行前 15 行上下文回显,Windows 失败从此可直接从 CI 日志定位。 - 验证:3 例单跑绿;全量两树 ctest 2509 注册 0 failed(连同本修复重跑门禁);悬垂期间 Linux 覆盖率计数路径真实执行(函数调用均落到合法对象),gcda 数字不受影响。
test(2026-09-30,C++(Linux)覆盖率扫描收官:v13 基线剩余缺口三分类清账——13 例 + 1 断言,可测缺口归零、结构性盲区带论证登记)
- 方法(先分类后动手):v13 基线剩余 miss 逐文件三分类——①可测 now(补用例)②结构性不可达(逐行论证登记,不写假用例)③行归因伪影。伪影判定实证:报告 miss 的 transport 362/368/503/521 其错误文案由既有通过用例(TcpListenPortConflictFails / UdpErrorBranches)直接断言——重跑该 2 用例后 miss 列表逐行不变,排除陈旧 gcda;定性为 gcov 对多行 braced-init 内层行/收尾行的零归因(语句计数归首行,其余行记录 0-hit)。此判定把「报告面缺口」压缩到真实可测集合,避免对着伪影硬凑用例。
- 新增 13 例 + 1 断言(5 文件):①
glue_modules_coverage_test.cpp(新)3 例——debugger/orchestration stub 契约(start 恒 false、断点串"a.lua:12"、DEBUG_BREAK_HERE;orchestration 三 stub null/false/空数组)+ security 直通契约(hashString 64-hex 稳定、generateRandomString 长度、filterSensitive 整段替换***),三模块胶水体此前零驱动;② transport_inbox +1UdpSendToInvalidAddressFailsGracefully——非 IP 字符串经 asio::make_address 抛 → catch → false(transport_module 154-157);③ unix_socket_channel +3——server/client socket 创建 EMFILE 注入 ×2(fd_exhaustion.hpp共享注入器:RLIMIT_NOFILE soft 压「当前占用+4」逐个占满 /dev/null,毫秒级窗口;探测先行不成立即 GTEST_SKIP)+ 断连后重启接收语义(listenFd_ 首个 accept 后关闭、serverAccepted_ 不复位 → 重启即早退退出不挂,钉住既有语义);④ platform_x11 +1 断言——findByClassName 无命中腿返回 NullWindowHandle(既有用例只测过命中腿);⑤ cli_test +6——script 命令执行面 5 例(成功/带参 env/运行时错误/不可编译/目录不可读源:引擎惰性注册 + loadScript/runScript 主体 + 卸载收尾)+ build 命令 stub 全链 1 例(resolveStubPath CWD 命中 → 图标日志行 → PackerOptions 装配 → create_directories → Linux ELF 嵌入明确不支持 → 优雅失败退出 1)。 - 在案 flake 收口(断言方向 2 处):收官全量门禁首跑在 load 68-104 下抓红
ClipboardModuleGlue.HtmlImageAndFilesBehavior——该用例 HTML/text 段均已按轮询纪律改写,唯 files 段漏网:setFiles 读回与 clear 后 hasFiles 两处 t=0 直断,与 xclip daemon 异步接管窗口竞争(clipboard_poll.hpp头注释在案的同族)。改正向轮询终态后单测 ×20(load 93)全绿、0.33-0.39s 慢轮次即轮询真实吸收竞态窗口的证据;全量复跑(load 150)两树全绿。 - 覆盖率(gcovr 行):TOTAL 90%(15238 → 15290/16931,+52 真覆盖行);transport_module 89%→90%(274→278)、unix_socket_channel 94%→97%(238→245)、x11_window 99%(275→276,余 1 行伪影)、script_command 13%→83%(4→25)、build_command 49%→87%(24→43)、debugger/orchestration/security 胶水体全驱动(余量全为收尾行伪影,见下)。
- 结构性不可达登记(34 行,逐行论证):transport 17 行——UDP 阻塞 receive_from catch 4 行(close() 不唤醒阻塞 recv、UDP 无 shutdown 语义,不可确定性中断)+ tcpConnect/tcpListen 创建后句柄 null 防御 8 行(manager 工厂单调计数永不失败)+
server->start()失败腿 5 行(transport.hpp 内联实现恒返回 true);usc 6 行——listen() 失败防御(listenFd_ 已持有,Linux 无确定性注入口);script_command 5 行——31-32 loadScript 失败腿(ScriptManager::loadScript 仅!exists返回 false,命令已前置存在性检查,属 TOCTOU 双检防御)+ 48-50 no-throw catch(引擎错误经返回值不走异常);build_command 6 行——86-88 PE-only 成功腿(packer.cpp 明示 Linux ELF 资源嵌入不支持)+ 95-97 no-throw catch(Packer::build 无抛契约);ml_module 34 行为前轮既证(onnxruntime 是 vcpkg Windows 平台专属依赖,Linux gate 恒跑 ml_stub,loadModel 恒 false)。 - 行归因伪影登记(30 行,工具行为非缺口):transport 13(279,287,293,320,328,362,368,418,443,454,469,503,521——braced-init 内层/收尾行,其中 4 行的错误文案被既有用例直接断言)+ usc 1(380 deserializeMessage catch 收尾行,坏 JSON 体已覆盖)+ debugger/orchestration/security 15(各导出函数
}, "sig"});收尾行,函数体由本批 3 例驱动)+ x11_window 1(134 findByClassName 收尾行)。 - 无真缺陷暴露(如实登记):全部新驱动路径行为符合既有契约(EMFILE 优雅 false + Error 态 + 错误回调、UDP 坏地址 false、断连重启不挂不重收、build 非 PE 宿主退出 1),本轮零生产代码改动。
- 验证:全量两树 ctest(CI 口径 xvfb-run 串行 --timeout 300)2509 注册 = 2478 passed + 31 环境 skip + 0 failed(两树一致,含本轮 +13);gcovr(历轮口径,剔除 vcpkg 头与 tests/,
grep -c tests/= 0)TOTAL 90%。门禁插曲如实登记:首跑 build 树挂 1 例 HtmlImageAndFilesBehavior(见上 flake 收口),复跑全绿。零 Go/JS 改动。
test(2026-09-30,C++(Linux)覆盖率扫描续:Clipboard 门面与 X11 后端——故障注入 3 例,可触达缺口归零)
- 基线校正:任务口径的 clipboard.cpp 58.1%/26 行、x11_clipboard 71.8%/37 行为 1f0f976 前旧树数字(彼时 Linux 文件列表用例按能力守卫 SKIP);修复树复采基线 clipboard.cpp 58%(36/62)、x11_clipboard.cpp 74%(98/132),采集前先验证 X 环境存活(Xvfb :98 + xclip + gcovr)。
- 新增
lib/wingman/tests/clipboard_fault_coverage_test.cpp3 例(UNIX AND NOT APPLEgate,Windows 编译面不含该文件;无 X 环境语义自洽):UninitializedBackendDegradesByContract(坏 DISPLAY 经工厂直连,未初始化实例全接口降级契约——写 false/读空/isEmpty true/isInitialized 如实 false,覆盖 initialize 失败分支);PipeExhaustionFailsGracefully(RLIMIT_NOFILE 压到「当前占用+4」再占满,毫秒级注入窗口——直接占满百万默认额度是秒级窗口,全量跑实测 1.4s);ForkFailureFailsGracefully(/proc 统计 uid 进程数 + RLIMIT_NPROC 压限 + fork 探测确认 EAGAIN)。pipe/fork 两条防御分支(4+8 行)与 initialize 失败分支(2 行)全部落地。 - 注入纪律(共享机):前置探测不成立一律 GTEST_SKIP 不误报;剪贴板 flock 按纪律持有;rlimit/fd/环境变量全 RAII 恢复(含「未成功 apply 不恢复」防把限额写成垃圾值)。
- 在案 flake 收口(断言方向 5 处):全量门禁首跑在 load ~27 下抓红
ClipboardTest.IsEmpty——setText后EXPECT_FALSE(waitFor(isEmpty))等价于要求「首次读取即为终态」,而 clear 建立的空态会一直可读到 xclip daemon 异步接管为止,t=0 读取必然与接管窗口竞争。同型 5 处(HasText/HasHTML/HasFiles 的 clear 后、Clear/IsEmpty 的 setText 后)一并改为正向等待终态EXPECT_TRUE(waitFor(终态谓词)):断言契约不变(终态最终出现即通过、始终不出现即失败),只去掉与异步接管竞争的 t=0 硬要求;clipboard_poll.hpp头注释登记方向纪律。 - 覆盖率(gcovr 行):
x11_clipboard.cpp74% → 84%(112/132);clipboard.cpp维持 58%(36/62)——两文件可触达缺口归零。 - 结构性盲区登记(46 行,不写假用例):x11 子进程分支 19 行——fork 后 exec(xclip) 替换进程镜像或 _exit(1),子进程 gcov 计数器永不落盘(父进程行可注入、子进程行工具不可观测,路径本身每次读写真实执行);226 收尾行归因伪影(getAvailableFormats 函数体已全驱动);clipboard.cpp 26 行 = NullClipboard 类体 + 工厂 null 兜底——两平台工厂恒无条件 new+initialize+return,回退恒不可达(Windows 侧 #else 分支不参与编译)。
- 无真缺陷暴露(如实登记):三条防御路径行为全部符合既有契约,本轮零生产代码改动。
- 验证:新 3 例 ×5 连跑稳定(102/100/10ms);全量两树 ctest(CI 口径 xvfb-run 串行 --timeout 300)2496 注册 = 2465 passed + 31 环境 skip + 0 failed(两树注册数一致、含本轮 +3;31 例 xclip/XRecord/能力守卫 skip 与既往一致);gcovr(历轮口径,剔除 vcpkg 头与 tests/)TOTAL 90%(15238/16931)(上轮 89.9%)。门禁插曲如实登记:首跑两树各挂
AgentLifecycleTest.ApplyRemoteConfigWhileRunningReportsReconnectAndPersistFailure——上一任务(Android 模拟器验证)遗留的 host Go server 仍占 :8888,打穿该用例「初始地址不可达」前提,杀遗留进程后恢复(与本轮改动无关);同轮 load ~27 抓出 ClipboardTest.IsEmpty 断言方向 flake(见上条收口)。零 Go/JS 改动。
fix(2026-09-30,Android 模拟器验证(API 34 AVD 全链路)抓出三处阻断级缺陷:主题 / FGS 类型 / 闹钟 PendingIntent)
- 验证环境:本机 Android SDK 模拟器 emulator-5554(AVD test34,API 34,userdebug)+ host Go server(agent 0.0.0.0:8888,10.0.2.2 loopback alias 回连、
WINGMAN_AGENT_TOKENS白名单)复现生产链路;macOS 腿(Actions macos-latest)与 XRecord 腿(Xvfb)此前已勾销,本轮收 Android 腿。 - ① MainActivity 启动即崩(A1 起潜伏):AppCompatActivity + androidx AlertDialog 必须 Theme.AppCompat 后代主题,framework Theme.Material 在 setContentView 抛
IllegalStateException——UI 自 A1 起从未在任何构建上真正启动过(此前验证只走am startforegroundservice服务路径,未起过 Activity)。values/values-night 改Theme.AppCompat(.Light).NoActionBar(布局仅框架控件,够用)。 - ② API 34 纯核心启动 100% 崩:
startForeground无条件带 mediaProjection 类型,未取得投屏授权(appop project_media)即SecurityException。startForegroundWithTypes(mediaProjection: Boolean)按分支选类型集——纯核心 dataSync、投屏分支叠加 mediaProjection(服务已前台时二次 startForeground 原地更新类型集,升级路径安全)。 - ③ 崩溃闹钟腿自 A3 落地从未触发:
PendingIntent.getForegroundService指向 BroadcastReceiver,系统按 service 组件解析恒 "Unable to start service … not found"(被 START_STICKY 兜底掩盖)。改getBroadcast,am crash实测触发。 - 全链路验证(修复构建):安装 → MainActivity 稳定前台 → ACTION_START → FGS dataSync → nativeStart=1 → TCP 建立 → server
[Registry] Agent registered(含断网自动重连);am crash→ START_STICKY + 闹钟腿双拉起、crash 遥测落 prefs;BOOT_COMPLETED / MY_PACKAGE_REPLACED(覆盖安装)自启正路径与默认关负路径全通;restricted-settings 脚本 check/allow/status/revoke 真机路径 exit code 语义正确。前条 A3 登记的「无真机可验证项」四条(广播到达/豁免名单 startForegroundService/覆盖安装自启/勾选后重启全链路)全部销账。 - 误诊澄清(登记):exported=false 并不拦系统保护广播——中途误判源于共享机高负载下广播队列积压(BOOT_COMPLETED 发出到 receiver 实测延迟 47s)+ 检查窗口过短 + 提前
logcat -c抹证据;manifest 零改动,既有口径正确。 - 加固登记(未修):冷启动窗口内焦点被夺时
ForegroundServiceStartNotAllowedException未捕获致进程崩溃(共享模拟器多会话特有触发面,单用户真机常规流程不踩);后续按捕获退避重试方向加固。 - 验证:
gradle :app:testDebugUnitTest22/22 全绿;零 Go/C++ 改动。剩余真机项:macOS TCC 三项 / XRecord 回放手感 / Android 厂商保活逐机型 / MediaProjection 真机授权流。
test(2026-09-30,C++(Linux)覆盖率扫描续:ResourceLoader 实例接口 68% → 87%(7 例),无嵌入早退链直测)
- 缺口定位:todo 仅剩 macOS 与 Linux 真机验证两项(本机无真机、不可做)按既定规则转覆盖率。Go 侧全包覆盖率复测(
-count=1)全部 ≥95.6%(最低 internal/remoteticket 95.6% / internal/handlers 96.6% / internal/workflow 99.7%,余均 100%),无 85% 以下缺口;Android 侧 gradle 无覆盖率插件基建(「如适用」条件不成立,登记不适用)。C++ 侧 gcovr 全量报告(TOTAL 89.9%)按未覆盖行数重排并逐项复核既有登记排除项(misc_modules UIA 平台耦合 / lua_engine 零引用遗留 / crypt OpenSSL / packer 私有+PE / x11_recorder 真桌面 / screenshot_handler VISION 变体门 / notify WebhookSender 配置性死代码 / ml_stub 模型路径 / agent.cpp 84.6% 的 46 行余量已全部登记)后,85% 线下最大可离线测缺口锁定apps/runtime/src/resource_loader.cpp68.3%(40 行未覆盖)——既有 43 例只直测静态字节级入口(loadScriptFromBytes / Packer 往返),实例接口面(构造探测/错误回调/资源信息/loadScript)零驱动。 - 新增
apps/runtime/tests/resource_loader_interface_test.cpp7 例(runtime_tests 接线;纯实例方法 + std::filesystem 无 POSIX/X11 符号,Windows CI 全量参与;测试二进制非 Packer 产物不含 PACK_PE_RESOURCE_ID 资源,Linux 与 Windows 探测一致为「无嵌入」):构造探测无嵌入、ResourceInfo 默认值全字段、getExecutablePath 解析到存在的文件(Linux /proc/self/exe 生产路径)、loadScript 无嵌入时错误回调收「No embedded script found」、无回调失败路径安全、setErrorCallback 二次替换后旧回调不再接收、重复 loadScript 持续失败且探测态不漂移。 - 余量 16 行登记(不写假用例):265-279(11 行)loadScript 有嵌入分支——Linux 恒不可达(
hasEmbeddedScript()恒 false,PE FindResource 为 Windows 产物路径),核心解析/解压/解密由 loadScriptFromBytes 共用实现覆盖;309 为恒假死防御(size>=4 蕴含 size>=3);332 readlink 失败兜底(/proc/self/exe 恒可读);51 为收尾行归因伪影;91/114 随有嵌入分支一同不可达。 - 覆盖率(gcovr 行):
resource_loader.cpp68.3%(86/126)→ 87.3%(110/126),函数 12/13;TOTAL 维持 89.9%(15217/16922)——+24 为真实增量(agent.cpp 顺带 +2),X11 家族 −23 为高负载窗口采集漂移(瞬态连接拒绝走早期失败腿,与本轮零生产代码改动无关)。 - 验证:新增 7 例全绿;runtime_tests 整二进制单进程 209/209 ×2(load 88 下稳定);插桩树全量 ctest 三轮 2493 例、两树注册数一致 2493——三轮各 1-2 例负载型假红且失败集合逐轮漂移(单跑均绿,均为在案 flake 家族:X11 瞬态连接拒绝 / IPC 就绪时序 / xclip 异步接管;外部负载 17→88 无干净全量窗口),CI 推送后专用 runner 串行复跑;Go 零改动沿用本轮全绿复测。
feat(2026-09-30,Android A3 开机自启默认值校正:默认开 → 默认关、显式开启)
- 对账:任务点名的「开机自启」已于 6cecfad 落地(BootCompletedReceiver + BootStartGate 纯逻辑 + JVM 单测 + build-android CI 门禁);本轮实质变更是默认值口径——任务明确「默认关闭、显式开启」,而 6cecfad 的「默认开」是登记假设(「A3 设计目标即无人值守,UI 可关」)非既定决策,按显式指令校正。
- 行为变更(未发布区间内,无存量 release 影响):开机自启默认关——特权行为须用户在 App 内显式勾选。显式勾选过的安装不受影响(prefs 已存 true);从未动过开关的安装从「装完即自启」变为「须显式开启」。
- 实现:默认值收敛单一来源
BootStartGate.DEFAULT_ENABLED = false;BootCompletedReceiver 与 MainActivity 两处 prefs 读取均改经该常量(禁字面量,AgentPrefs注释同步);KDoc 语义更新。 - 回归钉:BootStartGateTest
bootAutoStartDefaultsToOff——钉常量 false + 「prefs 缺键(未显式开启)且已配置地址」不放行;默认值再变必须过显式决策,无法静默漂移。 - 文档:android-agent-design §7(默认开→默认关、显式开启,注明校正缘由与单一来源);android-keep-alive 指引表;apps/android/README A3 验证步骤(显式勾选);todo.md 勾销现状登记陈旧「未完成」条目 + 新条目。
- 无真机可验证项(登记):BOOT_COMPLETED/MY_PACKAGE_REPLACED 真机广播到达、豁免名单内 startForegroundService 实际行为、覆盖安装后自启、勾选后重启全链路——需真机;本机口径 JVM 单测 + 编译,真机步骤已在 apps/android/README.md A3 节。
- 验证:
gradle :app:testDebugUnitTest22/22 全绿(+1);docs:build 复跑绿;零 Go/C++ 改动(相关门禁沿用 1a2acb5 同代码态已验结果)。
feat(2026-09-30,Android A3 部署体验:Android 13+ 受限设置引导——手动允许 / adb 预授权 / Device Owner 三档落地)
- 范围:development-todo A3 节「可靠性与部署体验」第二项(先于 asset.sync;触发器项属 A2 节残留且设计无成文章节,不属「A3 之后」顺位)。Android 13(API 33)起侧载 App 的无障碍被「受限设置」默认屏蔽——开关打不开的根因、端侧开箱失败最高来源(mobile-support-feasibility.md §5.2,风险表评级:高)。零 C++ 改动。
- 预授权脚本:
scripts/android-restricted-settings.sh check/allow/revoke/status——幂等 adb 预授权(allow 后复核;无 adb/无已授权设备判 SKIP(2) 不与「检查不通过」混同、包未装判 FAIL(1) 可行动、API<33 判 PASS「不受约束」;tr -d '\r'处理 adb shell CRLF 行尾;取值用参数展开而非 sed——e8dc57c 教训;WINGMAN_ANDROID_PKG贯穿全部命令)。adb 只出现在部署/一次性授权路径(设计决策 D7 复述),运行时链路零 adb。 - 契约护栏:
orchestrator/server/integration/android_restricted_settings_script_test.go11 例——假 adb(状态文件驱动设备/包名/SDK/appops + calls 调用记录,shell 输出带 CRLF 对齐真 adb pty 行尾)+ 净化 PATH,三态/幂等/包名覆盖/revoke 复核/用法全路径不碰真设备;复用 guacd 脚本契约框架(Windows runner 显式 SKIP、macOS bash 3.2 兼容口径同守)。 - App 内引导:
RestrictedSettingsPolicy纯逻辑对象(API≥33 且无障碍未启用且未确认 → 提示)+ MainActivity 常驻「受限设置指引」按钮(三档解法全文对话框)+ onResume 自动弹一次(restrictedHintAckprefs 键,弹过即落 ack 不再自动弹)。诚实边界:公开 API 无法区分「被受限设置挡住」与「未开启」,系统不暴露该状态——按口径触发,Android 12- 不弹;「无障碍失效检测上报」依赖 device.capabilities 预留槽位,登记未做。 - 手册:
docs/guides/android-restricted-settings.md(背景/症状识别表/三档解法/验证/已知边界;入文档站「进阶指南」,与保活指引互链互补——本页解决「开不了」、保活页解决「被杀」)。 - 测试:Kotlin JVM 单测 +6(RestrictedSettingsPolicy API 门槛边界 + 提示矩阵,共 21 例全绿);Go 契约 11 例全绿(1.6s);shellcheck 零 finding;
npm run docs:build绿。 - 文档同步:development-todo A3 两项勾销(可靠性首项补 6cecfad 对账修正);mobile-support-feasibility §5.2/§7 风险表/§8 分阶段(失效检测上报单列未做);android-agent-design §5.4/§9 验证矩阵/新增 §10'' 实施摘要;apps/android/README(新增受限设置验证步骤节 + 里程碑行);ROADMAP M9 A3 行与行动表;todo.md 新条目 + 状态行。
- 假设与登记:五厂商定制 ROM(小米/华为/OPPO/vivo/三星)真机逐机型 ⋮ 菜单验收未执行(本机无真机,手册按各厂商官方文档口径编写,登记待真机抽样);Device Owner 路径需设备已纳管,仓库不附带 MDM 配置(手册记边界);本地验证口径为 JVM 单测 + Go 契约 + docs 构建(真机 adb 预授权实操归真机验收)。
feat(2026-09-30,Android A3 可靠性落地:开机自启 / 崩溃自重启 / 断连缓存自治 / 机型保活指引)
- 范围:todo.md「Android 现状登记」未完成三项中的第一项(A3 剩余可靠性项优先于 A4),设计约束 android-agent-design.md §7,本轮同步落地摘要 §10'。零 C++/Go 改动(断连缓存自治的 C++ 面自 A1 现成),全部为 Kotlin 壳 + 文档 + CI。
- 开机自启:
BootCompletedReceiver(BOOT_COMPLETED + MY_PACKAGE_REPLACED,两者均在系统后台 FGS 启动豁免名单内,exported=false 亦可收到系统保护广播)+ App 内开关(默认开,CheckBox 入主界面)+ 已配置服务器地址才放行;放行判定抽为纯逻辑BootStartGate;Manifest 启用RECEIVE_BOOT_COMPLETED(原注释占位转正)。 - 崩溃自重启(带退避与放弃上限):新增
WingmanApplication安装进程级CrashRestartHandler——崩溃时记录状态/摘要到 prefs 并按RestartPolicy(指数退避 1s→60s 封顶;10 分钟窗口内连崩 5 次放弃,防崩溃风暴;窗口外新崩溃重开计数)经 AlarmManager 调度CrashAlarmReceiver重启前台服务。诚实边界:闹钟腿是 best-effort(API 31+ 后台 FGS 启动限制可能被拒,捕获后让位于 START_STICKY 系统路径);coreRunningprefs 门控保证只在「崩溃前服务确实在跑」时复活(MainActivity 崩溃不会拉起从未启动的 agent);MediaProjection 授权单会话一次性、崩溃后不可恢复(系统约束,登记)。清零语义:用户/开机/覆盖安装路径清零崩溃串,崩溃闹钟路径保持累积。 - 核心看门狗(断连/进程内自愈的 App 侧补位):WingmanService 内 30s 周期检查——服务期望核心在跑而
nativeStatus报running!=true(或状态不可解析)时幂等重拉nativeStart(C++AndroidAgent::start对运行中 client 短路返回 true,重拉安全)。网络断开不在其列:running反映 client 存活而非 connected,断连重连/outbox 冲刷由 RemoteClient 退避自治(agentcore_test 既有 28 例覆盖,含断连入 outbox、重连冲刷、超容量丢弃恰好 100 条)。判定抽为纯逻辑WatchdogPolicy。 - 机型保活指引:
docs/guides/android-keep-alive.md(小米/华为/OPPO/vivo/三星逐机型设置步骤 + 通用项 + 验证方法 + 已知边界;入文档站「进阶指南」导航)+ App 内「机型保活指引」对话框(五厂商要点内联)。 - 测试(Android 工程首批单测):纯逻辑对象
RestartPolicy/BootStartGate/WatchdogPolicy零 Android 依赖,Kotlin JVM 单测 15 例(app/src/test,JUnit 4.13.2):退避进度/窗口内外串归并/放弃与恢复、开关与空白地址矩阵、看门狗期望态×状态解析矩阵(含缺字段/坏 JSON 保守重拉、connectionState 不参与判定)。org.json 以 Maven 真实现入测试类路径——android.jar 对其只部分真实实现(optBoolean即 stub 抛「not mocked」,首跑 5 例实证)。本机gradle :app:testDebugUnitTest15/15 全绿(连跑两轮稳定;Gradle 8.10.1 + 本机 SDK,首次运行完整编译主源码+测试源码)。 - CI:build-package 的 build-android job 在打 APK 前先跑
gradle :app:testDebugUnitTest——此前 Kotlin 逻辑无任何 CI 门禁(per-push CI 不编 Kotlin,nightly 只做编译检查)。该 workflow 为 workflow_call 型,随 nightly/release 生效。 - 文档同步:android-agent-design.md §1.2(A3 行转已落地)/§5.4(壳组件清单)/§6.3(开发机环境口径修正)/§7(生命周期表逐场景实现归属 + 实现要点)/§8(补注:可靠性组件全为本地组件、不改变信任模型——任务指定的口径同步点)/§9(验证矩阵补 JVM 单测与 outbox 行);apps/android/README.md(标题范围、环境说明改「可本地跑 JVM 单测」、新增 A3 验证步骤节、里程碑对账);ROADMAP M9 A3 行转 ✅(P2 安全演进另列)+ 行动表销项;todo.md 新增本轮条目 + 状态行。
- 假设与登记:开机自启默认开(A3 设计目标即无人值守,UI 可关);本地验证口径为 JVM 单测 + 编译(NDK/vcpkg 全量 APK 组装由 nightly 验证);
apps/android/.gitignore新增(.gradle/ 等本地产物,首次本地构建暴露的遗漏)。
docs(2026-09-30,Android Agent 现状登记:ROADMAP 补 Milestone 9 移动端里程碑,文档滞后收口)
- 背景:问询「Android agent 什么时候实现」并指认文档未更新。核查结论:代码侧 A1 链路打通(2026-09-19,ce4a648)、A2 能力闭环(2026-09-21,c1df705/c0a67fe——dispatchGesture 手势注入/MediaProjection 采集/找色找图/
screenshot.capture远程截图 + 反向 JNI 桥)、A3-P1 token 认证(2026-09-20,4c9a8f4——WINGMAN_AGENT_TOKENS白名单三端)均已落地,nightly CI 自 2026-09-20 每日打 Android arm64 APK;但 ROADMAP.md 仅有桌面 M1-M8、平台说明未提 Android、todo.md 无移动端条目——滞后的是路线图对账,不是实现。 - ROADMAP.md:新增 Milestone 9「移动端 Agent(Android)」——A1-A4 四阶段状态表(A1/A2 ✅、A3 🚧 P1 已落地、A4 ⬜ 协议预留)+ 工程基建注记(nightly APK/核心下沉
libs/agentcore+libs/androidagent);平台说明补 Android 实验性支持;时间估算表补 M9 未排期行;下一阶段行动表登记 A3 剩余可靠性项(开机自启/崩溃自重启/断连缓存自治/机型保活指引)与 A4 多设备编排(Dashboard 设备视图/批量下发/asset.sync)为待排期项。 - docs/android-agent-design.md:§1.2 里程碑表 A3 行补注「P1 token 认证已落地(2026-09-20)」,与 §8 安全节的「A3-P1(已落地)」口径对齐。
- todo.md:新增 2026-09-30 Android Agent 现状登记节——已落地三项(附提交时间线)、未完成三项(A3 剩余/A3-P2 per-agent token + Keystore 迁移 + challenge-response 与 TLS/A4 多设备编排)与排期状态,供后续任务派发对账;顶部状态行同步移动端摘要。
- 纯 .md 改动:主 CI 按路径规则跳过、Docs workflow 随推送运行;无代码/测试变更。
test(2026-09-29,C++(Linux)覆盖率扫描续:StandaloneMode 78% → 92%(12 例),ScriptManager 状态机结构性缺陷登记)
- 缺口定位:重跑 gcovr 全量报告(xvfb 口径门禁 2474/2474 全绿后出报,TOTAL 14849/16600),排除项复核不变(misc_modules UIA 平台耦合 / lua_engine 死代码 / crypt OpenSSL 失败分支 / x11_recorder 真桌面 / packer 私有死代码 + PE 平台 / main + start_command 入口胶水 / screenshot_handler VISION 变体门 / notify WebhookSender 配置性死代码)。remote_client.cpp 与 standalone_mode.cpp 并列 51 miss;后者为纯编排层(进程级 ScriptManager + EventBuffer,无网络/平台分支、确定性可离线驱动),可达行比例更高,锁定
apps/runtime/src/standalone_mode.cpp78%(51 行未覆盖)。 - 新增
apps/runtime/tests/standalone_mode_coverage_test.cpp12 例(runtime_tests 接线 +registerLuaEngine()惰性注册同 rpc_ipc_test 口径;全平台编译,Windows CI 全量参与):start 二次调用幂等 true;scriptDir 被普通文件占据 →create_directories异常 → false;autoStart 装配(快脚本加载 + 阻塞运行至完成、输出回调空串跳过——空print()的空串经引擎输出回调实证送达、只转发非空输出恰好一条、completed→Unknown 现状钉);autoStart 缺失脚本跳过;loadScript 登记(unloaded→Stopped 现状钉:manager.loadScript 不置 loaded 态,reloadScript后才 Loaded——两处状态映射按现状钉并在余量登记);失败脚本 error 态 + error 事件经 start() 注册回调推送全链;startScript unknown-id false;manager 失同步(登记 map 命中、manager 条目已被直卸)→ getScript 回落默认 Info / unloadScript false / stop() 降级不崩;批量操作闲置脚本计数 0 契约(pauseAll/resumeAll/stopAll 三态一致);getScript unknown-id 默认值;getConfig 构造镜像。 - 结构性不可达登记(19 行,不写假用例)——ScriptManager 状态机缺陷发现:
runScriptInternal从不赋值ScriptState::running(全文件唯一赋值点在 resumeScript,而 resume 前置 paused、pause 前置 running——死锁环),故 pause/resume 成功腿(238-242 / 257-261)、pauseAll/resumeAll/stopAll 非零计数增量(295 / 314 / 333)、toRuntimeState 的 running/paused 映射(26-29)均结构性不可达——真机同样不可达(执行期状态为 starting 非 running;本轮修正 round-4 将其归为「真机观察范畴」的口径);stopScript 成功腿(276-280)仅 starting 态并发 stop 可达,但该路径并发engine->shutdown()(销毁执行线程正在使用的 lua_State,数据竞争)不触发。修复需补 running 赋值 + 引擎级协作停止设计(指令计数钩子),超出覆盖率轮范畴,建议独立任务。 - 另登记:167-168(manager 加载失败腿——manager.loadScript 唯一失败条件是文件不存在,而 StandaloneMode 已前置检查,TOCTOU 窗口外不可达,防御性双检);46(toRuntimeInfo 尾行已被多次驱动仍计 miss,-O2 行归因伪影)。
- 覆盖率(gcovr 行):
standalone_mode.cpp78%(189/240)→ 92%(221/240);TOTAL 14849 → 14878/16600(89%,+29 行)。 - 验证:新增 12 例全绿(连跑 3 轮稳定);build/ 全量 ctest 2486/2486、插桩 build-cov 全量 ctest 2486/2486(两树注册数一致,含本轮 +12;均 xvfb 口径 0 failed,31 例 xclip/XRecord 条件 skip 与既往一致);Go/JS 零改动沿用已验结果,CI 随推送全量复跑。
test(2026-09-28,C++(Linux)覆盖率扫描续:module_helpers 张量转换层 68% → 96%(15 例),dtype 全矩阵直测)
- 缺口定位:gcovr 全量报告(CI 同款 xvfb 口径,TOTAL 89%)按未覆盖行数重排(marshal 收口后)并逐一验证可达性——
packer.cpp62%(63 行缺:compileToBytecode/replaceIcon/setVersionInfo均为 private 且build()不调用,Linux 成功路径被 PE 资源写入卡死(非 WindowsupdateResource恒 false),离线仅 ~10 行可达,暂记);notify_module.cpp75%(52 行缺几乎全落 WebhookSender:setAllowedHosts/setWebhooksEnabled全仓零调用方,白名单默认空 → 每次连接都被 SSRF 防护拒绝,URL 解析/worker HTTP 管线/并发上限/shutdown join 在现网行为下均不可达——既有用例已钉住「URL not in whitelist or webhooks disabled」拒绝路径,按配置性死代码登记);remote_client.cpp/standalone_mode.cpp各 51(散布的重连/错误腿,loopback 逐腿搭建性价比低,暂记);crypt.cpp79(前轮既定口径)。锁定lib/wingman/src/script/modules/module_helpers.hpp68%(58 行未覆盖)——缺口几乎全部是张量 dtype 矩阵:11 个枚举值仅 FLOAT32/FLOAT64/INT8/BOOL 被既有 ml/misc 用例顺带踩过,其余 dtype 的 elementSize/类型名解析/appendBytes 实例化/appendElement/elementToScriptValue 分支全零覆盖。 - 新增
lib/wingman/tests/module_helpers_tensor_test.cpp15 例(core_tests 接线;纯头文件内联函数直测,无 I/O/网络/平台分支,Windows CI 全量参与):tensorElementSize全 11 dtype + 越界兜底 0;tensorTypeFromString全 11 名解析 + 未知名/大小写敏感拒绝(失败不动 out 哨兵);dtype 全矩阵往返(ScriptValue spec → tensorFromScriptValue → TensorData → modelOutputToScriptValue → ScriptValue,逐 dtype 断言 shape/字节数/值语义,一次驱动全部tensorAppendBytes<T>实例化与 appendElement/elementToScriptValue 分支);int 实参经 asFloat 的类型转换路径(int32 混合正负);bool 0→false;spec 错误矩阵(非对象/缺 data/空 data/非数组 data/未知 dtype 名/dtype 非字符串——asString 落默认空串拼进错误信息按现状钉/shape 非数组);shape 语义 2(缺省一维 = data 长度、显式 shape 逐字保留);未知 dtype 兜底 3(elementSize==0 → ModelOutput 空数据且 shape 照常、elementToScriptValue 直读 → null、appendElement 直调不追加字节)。 - 余量 7 行登记(不写假用例):106-111(6 行)=
tensorTypeFromString局部 static map 初始化、213 =modelOutputToScriptValue聚合初始化——两处的全部行为均已被用例真实驱动(全 11 dtype 名解析 + 15+ 次 ModelOutput 输出),-O2 下编译器将初始化代码合并至相邻行、这些源行无独立代码归属,属行归因伪影非测试缺口。 - 覆盖率(gcovr 行):
module_helpers.hpp68%(128/186)→ 96%(179/186);TOTAL 89% → 89%(14865/16600,+51 行)。 - 验证:新增 15 例全绿(连跑 3 轮稳定);build/ 全量 ctest 2474/2474、插桩 build-cov 全量 ctest 2474/2474(两树注册数一致,含本轮 +15;均 xvfb 口径 0 failed,31 例 xclip 未装/XRecord 扩展缺席条件 skip 与既往口径一致);Go/JS 零改动沿用今日同一代码态已验结果,CI 随推送全量复跑;CI 结果见本提交对应的 workflow run。
test(2026-09-28,C++(Linux)覆盖率扫描续:lua_marshal 40% → 97%(28 例),双向转换契约直测)
- 缺口定位与排除:gcovr 全量报告(CI 同款 xvfb 口径,TOTAL 88%)按未覆盖行数排序后,剔除不可离线测项——
misc_modules.cpp359-462(UIA OO 区块:Linux 无createUIAManager后端,元素句柄闭包仅在 Win/Mac 可达,平台耦合);lua_engine.cpp80 行 0%(零引用遗留类,全仓仅registerLuaEngine()——后者属 lua_script_engine.cpp);screenshot_handler.cpp19%(WINGMAN_ENABLE_VISION编译变体门外,本机无 vision 构建);crypt.cpp75%(余量为 OpenSSL 内部失败分支,前轮既定口径);x11_recorder/x11_clipboard/clipboard(平台后端);main.cpp/start_command.cpp(入口胶水)。锁定libs/lua/src/lua_marshal.cpp40%(62/104 未覆盖)——ScriptValue↔Lua 双向转换层,仅被 timer_module 间接触发零星分支,转换契约零直测。 - 新增
lib/wingman/tests/lua_marshal_test.cpp28 例(core_tests 直链 wingman::lua 既有接线;纯嵌入式 sol::state,Windows CI 全量参与):toLuaObject 10 例(null→nil、bool/int 保持 lua 5.4 integer 性/float/string 含 CJK 转义、数组→序列表、对象→映射表、嵌套容器 Lua 往返、C++ callable 经 variadic_args 实参 marshaling 被 Lua 调用(int/string/bool/nil/table 五类实参逐个钉型)、threadSafe callable 返回字符串往返);toScriptValue 10 例(invalid 对象→null、bool、lua_isinteger 整数性分流 42→Int/2.5→Float、字符串、Lua function→非线程安全 ScriptValue callable 并实调、数值实参与 Int 返回、error() 函数实证为 protected 调用落 null(与 executeString 直调走 catch 腿路径不同,按现状钉)、userdata→null 兜底);tableToScriptValue 8 例(序列→数组、字符串键→对象、空表落对象分支、混合键丢数字键、非正整数键取消数组资格、稀疏数组保形空洞补 Null、嵌套递归、table 引用直转)。 - 余量 3 行登记(不写假用例):48(toLuaObject switch 全 8 枚举 case 均在分支内返回,末尾兜底恒不可达);57-58(sol::type::nil case——实测真实 nil 经 sol 代理均以 invalid 对象到达、走 52-53 已覆盖腿,valid-nil 引用无自然构造路径,防御分支)。
- 覆盖率(gcovr 行):
lua_marshal.cpp40%(42/104)→ 97%(101/104);TOTAL 88% → 89%(14814/16600)。 - 验证:新增 28 例全绿(连跑 3 轮稳定);build/ 全量 ctest 2459/2459、插桩 build-cov 全量 ctest 2459/2459(两树注册数一致;本地全量门禁自本轮起沿用 CI 的 xvfb-run 口径,X 相关用例不再因环境缺 DISPLAY 而 skip);Go
-race -count=1 -timeout 90m14 包全绿、dashboard jest 420、GUI vitest 全绿(本轮零 Go/JS 改动,沿用今日早前同一代码态的已验结果;CI 仍随推送全量复跑);CI 结果见本提交对应的 workflow run。
test(2026-09-28,C++(Linux)覆盖率收口:Agent 主类 0% → 84%(35 例),两缺陷根治:system.shutdown 死锁 / shutdown 悬空事件 sink)
- 缺口定位:gcovr 全量报告(TOTAL 行覆盖 87.1%)剔除真机/平台耦合项(x11_recorder/x11_clipboard)、入口胶水(main.cpp)与 OpenSSL 内部失败分支后,行覆盖最低且可离线测的自有模块锁定
apps/runtime/src/agent.cpp297 行 0%——runtime 编排核心(initialize 能力分支、start 组件装配、applyRemoteConfig 热重建、handleRemoteCommand 全命令面、EventBuffer 远程转发)此前只被间接编译、无任何测试驱动。 - 新增
apps/runtime/tests/agent_loopback_test.cpp35 例 / 2 套件(tests/CMakeLists 接线;TCP 回环沿用 agentcore 测试 harness 模式,IPC 客户端沿用 rpc_ipc_test 的 TestIpcClient 模式):- AgentLifecycleTest 17 例(全平台,无 socket 依赖,Windows CI 全量参与):能力→组件派生矩阵 4(各能力组合的 RemoteClient/StandaloneMode 派生与 RunMode);配置文件首跑写默认+读回 2;生命周期契约 4(无组件 start/stop、shutdown 幂等、standalone 启停、start 失败 running 仍置位的降级契约);applyRemoteConfig 矩阵 7(未启用拒绝、内存+落盘持久化、无 configPath 只改内存、写盘失败部分成功串、运行中重建「已写入待重连」与「连接+写盘双重失败」两腿)。
- AgentLoopbackTest 18 例(POSIX,
#ifndef _WIN32——XDG_RUNTIME_DIR 端点重定向与 UnixSocket 通道为 POSIX 原语,Windows NamedPipe 默认端点语义本机不可验证,登记假设):每用例把 XDG_RUNTIME_DIR/TMPDIR 重定向到私有目录后走 Agent::start() 真实装配路径。本地 IPC 面 8(system.getVersion 全链、system.getStatus providers 反映、config.getRemote 镜像、config.setRemote 校验矩阵 7 项+无远程能力拒绝、setRemote 应用+热重建+落盘全链、不可写配置路径部分成功、EventBuffer 三类事件转发+log.line 过滤、shutdown 摘 sink 回归钉);远程命令面 10(get_status 含脚本 loaded→stopped 落定与 error 态、list_windows 信封、run_script 四腿、stop_script 三错误腿、unknown、trigger.* Dispatcher Reuse——JSON 串参数解析/非 JSON 字符串回退/handler 错误信封透传、screenshot.capture 信封、system.shutdown)。
- 两缺陷根治(均由本轮用例暴露):
- ① system.shutdown 远程命令自我死锁(EDEADLK):命令回调内联运行在 RemoteClient 消息处理线程上,同步
stop()会回收正在执行回调的线程自身——实测日志Resource deadlock avoided,ack 永远发不出、server 侧超时。改为先回 ack、stop 移交独立线程收尾;回归钉SystemShutdownCommandStopsAgent(轮询组件全停再收尾,规避与后台 stop 线程的停机竞态)。 - ②
Agent::shutdown不摘除 EventBuffer 远程 sink:sink lambda 捕获this,而 EventBuffer 是进程级单例——Agent 析构/重建后任何 push 事件都会调用悬空回调(UB)。shutdown 补setRemoteSink(nullptr);回归钉ShutdownClearsRemoteEventSink。
- ① system.shutdown 远程命令自我死锁(EDEADLK):命令回调内联运行在 RemoteClient 消息处理线程上,同步
- 登记假设与余量 46 行(不写假用例):stop_script 成功腿与脚本 running 态需长驻脚本协作停止(真机观察范畴,同 rpc_ipc_test 口径);list_windows 窗口枚举循环体在 Xvfb 下无窗口不执行(真桌面依赖);scriptStateToString 的 Loaded 为过渡态实测不停驻(加载后异步落定 stopped)、Running/Paused 同前、Unknown 为防御兜底;触发器 onFired→EventBuffer 推送需真实屏幕命中(真机观察);screenshot/trigger 的 dispatcher 空指针防御与 initRemoteClient/initStandaloneMode 失败腿恒不可达(构造恒成功);encodeWindowHandle 的
_WIN32分支为非激活编译侧;多行 braced-init 与 spdlog 双行语句的行归因伪影(语句必然整体执行,响应字段断言为证)。 - 覆盖率(gcovr 行):
agent.cpp0%(0/297)→ 84%(252/298);TOTAL 87.1% → 88%(14740/16600)。 - 验证:新增 35 例全绿(连跑 3 轮稳定);build/ 全量 ctest 2431/2431、插桩 build-cov 全量 ctest 2431/2431(两树终版注册数一致;早前记录的 2424 为终版用例集落地前的陈旧注册数);Go
-race -count=1 -timeout 90m14 包全绿(integration 包 1868s);dashboard jest 420、GUI vitest 全绿。CI 注记:前笔 c97a57a 为加固未完成的中间态提交,其 Linux full-tests 两作业失败的 6 例(断言与实测契约错配 4、trigger.update 数值 id 的 JSON 解析歧义 1、system.shutdown 死锁超时 1)即本笔修复对象,最终 CI 结果见本提交对应的 workflow run。
test(2026-09-27,C++(Linux)覆盖率扫描续:LuaScriptEngine 55% → 86%(31 例),余量全部登记不可归因/防御分支)
- 缺口定位:上轮扫描的次低自有可测模块
libs/lua/src/lua_script_engine.cpp55%(75 行未覆盖)。既有覆盖仅来自 script_manager/script_module 胶水测试的间接驱动——executeString/callFunction/getGlobal/setGlobal/enableSandbox/disableSandbox/getLanguageName等公开面整段零直测;round-1 修复的package.preload钩子(非沙箱分支)此前从未被任何测试驱动过。 - 新增
lib/wingman/tests/lua_script_engine_test.cpp31 例(core_tests 直链 wingman::lua,既有接线;纯引擎 API + std::filesystem,无 POSIX/X11 分支,Windows CI 全量参与):initialize 6 例(沙箱危险全局清除全集 io/os/debug/package/dofile/loadfile/load/require、非沙箱全库打开、require("wingman") 非沙箱解析为 wingman 表、沙箱 require 调用报错、config.env 注入为_ENV_*全局、二次 initialize 幂等);executeString/executeFile 4 例(语法/运行时错误 lastError、文件成功+缺失失败、未初始化拒绝执行);callFunction 6 例(未找到报 "Function not found: N"、参数传递+整数返回、Lua error 进 lastError、nil 返回→Null、混合标量参数转换、Lua 5.4 整数性保持 Int/Float 分流);registerModule 4 例(注册函数被 Lua 调用+返回、实参值传递、C++ 异常 → sol::error 传播为 Lua error、未初始化注册为 no-op);global 3 例(四标量类型往返、未知名→Null、未初始化 no-op);沙箱开关 3 例(enableSandbox 事后剥离、disableSandbox 只重开 io/os/debug——package/require 不恢复(按现状钉)、未初始化 no-op);print 捕获 4 例(简单捕获、变参制表符分隔+非 string 走 tostring 匹配 Lua 原生、空 print 空串回调、initialize 前安装回调不生效(initialized_ 门挡下 set_function,按现状钉死并注明调用方约束));shutdown 1 例(幂等+执行拒绝)。 - 余量 22 行全部登记(不写假用例):① 35-37/45-51(9 行)=
open_libraries的 sol 变参模板实参行——沙箱/非沙箱两分支均已被用例真实驱动(沙箱另经 StandaloneMode 间接覆盖),gcov 对变参展开不落行归因,属工具盲区非测试缺口;② 80-83(4 行)= initialize 的防御 catch——无故障注入无自然触发路径(登记口径同 crypt.cpp);③ 108-111/125-128(9 行)= executeFile/executeString 的!result.valid()腿——实证不可达:本轮全部失败用例(语法错误/运行时 error/文件缺失)在该 sol 版本下均走 catch 异常腿,invalid-result 分支是对实际 sol 行为的死防御。 - 覆盖率(gcovr 行):
lua_script_engine.cpp55%(93/168)→ 86%(146/168);TOTAL 86.5%→87.1%(14457/16599)。工具注记:本次 gcov 处理触发 gcc bug 68080(smart_trigger.cpp switch 行负值),按 gcovr 文档以--gcov-ignore-parse-errors negative_hits.warn出报告——smart_trigger.cpp 行数归因由 235 变 197(98%→100%),为跳过记录的伪影、真实覆盖未变(对 TOTAL 影响 ≈0.03pp,方向中性)。 - 验证:新增 31 例 26ms 全绿;build/ 全量 ctest 2386/2386(2355+31 精确吻合);插桩 build-cov 全量 ctest 2386/2386;Go
-race -count=1 -timeout 90m全绿;dashboard jest 420、GUI vitest 511 全绿;CI 结果见本提交对应的 workflow run。
test(2026-09-27,C++(Linux)覆盖率扫描续:AgentConfig 45% → 100%(24 例),连带根治 saveToFile 丢失 [performance] 节)
- 双端扫描定位:Go 侧
go test -cover(total 98.5%)低于 80% 的仅 7 个函数——remoteticket.NewManager0%(一行包装,测试走newManagerWithSweep短周期 seam)+ guacamole/recordings handler 6 个 70~75% 分支(需 guacd 基础设施,属环境依赖),不构成实质缺口;C++ 侧 gcovr(TOTAL 86.0%)最低且无平台耦合的自有模块为apps/runtime/src/agent_config.cpp45%(78 行未覆盖)——能力/模式派生、loadFromFile、节域解析的 debugger/logging/performance 分支、saveToFile 整段为零覆盖,而它们是 agent.cpp 的真实生产路径(Agent::initialize派生 RunMode、远程配置写回saveToFile)。 - 新增
apps/runtime/tests/agent_config_test.cpp24 例:能力派生 6 例(默认 Hybrid、仅远端 Remote、仅单机 Standalone、仅 LocalIpc→Unknown、全关 Unknown、Hybrid 优先于 Standalone 的判定序);loadFromString 13 例(空串全默认、[global] 别名、remote 五整型键+两字符串键、debugger/logging/performance/standalone 全键、引号内#保留、未配对引号不剥、未知节/键静默忽略、int 键配非数字串走字符串分支被忽略(当前容错契约)、超范围整数 std::stoi 抛出且Agent::initialize的 catch 兜底、文件不存在抛错带路径、不可写目录 save 返回 false);文件往返 5 例(全节段 save→load 相等、[performance] 回归钉、默认配置首跑写盘可读回、模式一致)。 - 连带根治——saveToFile 漏写
[performance]:loadFromString 支持该节三整型键而 saveToFile 不写回,用户手调的性能配置会在 runtime 首次配置落盘(Agent::applyRemoteConfig→saveToFile)时被静默抹掉。补写 [performance] 节(3 行),与解析端对称;回归钉SaveToFilePersistsPerformanceSection同时断言文件内容含该节与读回值相等。 - 平台说明:纯 std::filesystem/fstream,Windows CI 全量参与(无 loopback 跳过、无真机观察项);解析器断言一律钉「当前实现的真实契约」(容错忽略而非报错),不写理想化用例。
- 覆盖率(gcovr 行):
agent_config.cpp45%(64/142)→ 100%(147/147,含修复新增 5 行);TOTAL 86.0%→86.5%(14366/16599)。 - 验证:新增 24 例 5ms 全绿;build/ 全量 ctest 2355/2355(2331+24 精确吻合);插桩 build-cov 全量 ctest 2355/2355;Go
-race -count=1 -timeout 90m14 包全绿;dashboard jest 420、GUI vitest 511 全绿。
test(2026-09-27,C++(Linux)覆盖率缺口收口:IPC/RPC 控制面约 405 行 0% → 52 例单测,六缺陷根治)
- 缺口定位:gcovr 全量报告(TOTAL 行覆盖 80%)剔除「需真机/人工观察」与「OpenSSL 内部失败分支不可达(crypt.cpp,无故障注入无解)」后,剩余最大缺口是 GUI ⇄ runtime 的控制面集群——
local_ipc_server.cpp168 行、script_handler.cpp95 行、macro_handler.cpp44 行、config_handler.cpp15 行、event_log_sink.hpp18 行全部 0%、零测试(均已编进 runtime_tests 二进制但从未被驱动),system_handler.cpp余 29 行 55%。 - 新增
apps/runtime/tests/rpc_ipc_test.cpp52 例 / 7 套件(Linux 下 loopback 真链路;Windows 侧#ifndef _WIN32跳过 loopback——NamedPipe 语义本机不可验证,属登记假设,仅由 Windows CI 做编译检查):ScriptHandler 15 例(真 StandaloneMode + 真 Lua 文件:列表映射、start/stop/restart/unload 参数与错误信封、同步执行模型契约、load 后析构释放登记);EventHandler 2 例(drain 上限与 remaining 计数);ConfigHandler 5 例(无 access 报错、apply 失败透传、往返取新值);MacroHandler 13 例(status/save/load 往返、坏文件、空队列播放、speed/repeat 越界钳制、start/stop 信封);SystemProviders 4 例(注入 provider 反映到 system.getStatus、无脚本时 pause/batch 为 no-op);EventLogSink 3 例(级别过滤、4096 截断、构造参数抬高过滤下限);LocalIpcServerLoopback 11 例(起停幂等、system.getVersion 往返、provider 状态、未知方法/坏 JSON/缺 method/Error 型信封、config 往返、events.drain、客户端断开事件与重连、带客户端停机干净 join)。 - 意外收获——六个真实缺陷(四个生产行为级):
① StandaloneMode::stop() 提前 return → 进程级全局 ScriptManager 永久泄漏:仅 LocalIpc 能力的 runtime 不会调 start(),但 GUI 可经 script.* 在实例上加载脚本、登记在全局单例;stop/析构跳过清理,脚本连同 Lua 引擎永久泄漏(去掉早退,无条件清空登记;回归钉DestructorReleasesNeverStartedLoadedScripts)。
② macro.play speed=0 → SIGFPE、负数 → 无符号下溢挂死:speed 未校验直传各平台 recorder 实现,0 作除数 / 负数经无符号运算下溢成天文数字。在 RPC 边界单点钳制speed<1→1、repeat<1→1,一次收口 X11/Win32/Cocoa 三实现(回归钉PlayWithZeroSpeedIsClampedInsteadOfCrashing/PlayWithNegativeSpeedIsClampedInsteadOfHanging,修前一个 SIGFPE 一个挂死,修后各 100ms 干净完成)。
③ config_handler 引用捕获悬垂 → 段错误:registerRuntimeConfigHandlers(Access&)的 handler 以引用捕获 access,调用方传临时对象即 use-after-free(新测GetRemoteWithoutAccessReturnsError稳定复现段错误)。改按值捕获(与 system_handler 的 by-value providers 一致)。
④ 沙箱脚本 100% 启动失败:Lua 引擎初始化无条件执行package.preload["wingman"]=...,而沙箱模式 package 从未打开且被 applySandbox 置 nil,prelude 引用 nil 直接抛错——GUIscript.start的唯一路径是沙箱(StandaloneMode 强制 sandboxed=true),即 GUI 脚本启动全灭。钩子改为!sandboxed才安装(ScriptHandler 15 例即依赖此修复才能跑通)。
⑤ LocalIpcServer 停机双 disconnect 竞态:server 线程与 stop() 都会对同一通道disconnect(),并发进入时两边同时 join 同一 receiveThread(双重 pthread_join = UB,代码审读确认、实测间歇挂死——注:观测到的挂死混有同机并发跑测的干扰,定性为审读确认的硬化收口)。统一在 channelMutex 下串行、锁内复查 stopping。
⑥ EventLogSink 级别过滤方向反了:写成> max_level_,info 下限时 warn/error 全被滤掉、GUI 日志面板永远收不到告警与错误,反而放行 debug 噪音。改回<(仅下发 ≥ 配置级别),回归钉ForwardsInfoWarnErrorAndFiltersDebug。 - 登记的产品契约与真机观察项(测试注释内注明,不改变产品语义):ScriptManager 同步执行模型——
script.start阻塞到脚本跑完,顺序 RPC 永远打不进 running 窗口,script.stop对已完成脚本必报「Failed to stop script」→ GUI 无法停运行中脚本,pause/resume 成功路径与 GUI 停脚本均属真机观察范畴;wingman::unloaded → runtime Stopped → JSON "stopped" 的状态映射;macro.start 录制平台相关(无头环境只断言信封)。 - 覆盖率(gcovr,行覆盖):
local_ipc_server.cpp0%→80%(余 34 行:server 通道创建失败/connect 失败/停机竞态跳过断连/发送失败等错误分支)、script_handler.cpp0%→78%(余量即上述真机观察项)、macro_handler.cpp0%→89%、config_handler.cpp0%→100%、event_log_sink.hpp0%→94%、system_handler.cpp55%→75%、standalone_mode.cpp70%;TOTAL 80%→86%(14278/16594)。 - 验证:新增 52 例 2.1s 全绿;loopback 压力 10/10 轮干净;runtime_tests 全量 128/128(22.7s);插桩 build-cov 全量 ctest 2331/2331(上轮 2279 + 本轮 52,数目精确吻合);Go
-race -timeout 90m全仓绿;dashboard jest 420、GUI vitest 511 全绿。
fix(2026-09-27,TcpClient 重连对 joinable IO 线程赋值 → std::terminate:服务端断链后的重连必崩根治)
- 症状:agentcore 新增的 loopback 重连单测(
DisconnectedEventsQueueAndFlushOnReconnect等)以terminate called without an active exception稳定崩进程,崩点在重连线程Connecting to server...之后。 - 机制:
TcpClient::connect()把socket_move 进 session、用旧 IO 线程驱动ioContext_.run();RemoteClient::reconnectLoop的重连路径直接再调connect()、不经disconnect()——此时ioThread_仍 joinable,ioThread_ = std::thread(...)对 joinable 线程对象赋值按标准触发std::terminate(move 进 session 的 socket 被 asio 自动重开,连接反而成功,恰好走到赋值那一行)。即:服务端一断链,agent 进程在第一次重连尝试上必崩,属生产行为级缺陷,非测试时序问题。 - 修法:
connect()入口对「上一条连接的 IO 线程/session 仍在」的情况先隐式disconnect()(收口旧线程、restart io_context、重置 socket),再建新连接;既有显式 disconnect→connect 路径行为不变。 - 验证:agentcore 28 例(含断链重连、outbox 冲刷、超容量丢弃、心跳链路统计)连跑 4 轮全绿;全量 ctest 见本轮 test 条目。
fix(2026-09-27,agentcore 四缺陷:EventBuffer sink 持锁回调自死锁 / 心跳 join 阻塞一个心跳周期 / stop 与 startHeartbeat 生命周期竞争 / 首连重连计数双计)
- EventBuffer sink 持锁回调:
push()的注释与头文件契约都写明「sink 在锁外回调」,实现却在lock_guard作用域内调用——sink 里任何size()/drain()或重入push()立即自死锁(新单测SinkMayQueryBufferWithoutDeadlock挂死暴露)。收口锁作用域:入队/驱逐/取快照持锁,回调挪到锁外,与既有「捕获局部变量再转发」的意图对齐。 - 心跳线程整段睡眠:
sleep_for(seconds(heartbeatInterval))(默认 30s)不可打断,而stop()与重连路径startHeartbeat()都要 join 它——stop 拖慢进程退出至多一个心跳周期,每次重连被放大 30s。改 100ms 粒度分段睡眠(与sleepInterruptible同款),join 阻塞封顶 ~100ms,发送节奏不变。 - 生命周期竞争 → terminate:stop() 先 join 心跳、后 join 重连;重连线程在退出前
connect()成功会重新拉起心跳线程,时序交错时Impl析构销毁仍 joinable 的thread对象 →std::terminate。收口:新增heartbeatMutex串行化「旧线程 join / 新线程 spawn」,stop() 改为先停重连再收心跳,startHeartbeat()在shouldStop已置位时不再 spawn;stop()去掉running_前置判断改为无条件幂等收口(start 进行中并发 stop 不再漏收线程)。 - markConnected 双计:
start()/connect()成功路径同步调markConnected(),而TcpClient::connect()返回前已同步触发SessionEvent::Connected、事件处理器再记一次账——每次首连reconnects=1(契约:初始连接不计重连),心跳上报的链路统计从第一条连接起就是错的。删除两处直接调用,统一由事件处理器记账。 - 验证:
HeartbeatCarriesLinkStats断言link.reconnects == 0修复前红(实测 1)、修复后绿;四缺陷修后 agentcore 28 例 ×4 轮全绿。
test(2026-09-27,C++(Linux)覆盖率缺口收口:agentcore 0% → 28 例单测,EventBuffer 100% / RemoteClient 86%)
- 缺口定位:gcovr 全量报告(TOTAL 行覆盖 80%)里行覆盖最低且无 Lua/X11/平台耦合的模块是
libs/agentcore——remote_client.cpp390 行 +event_buffer.cpp59 行 0% 覆盖、零测试。依赖仅 transport + nlohmann_json + spdlog(约束:不得依赖 lib/wingman 本体,Android 构建不引入),可纯 loopback 单测。 - 新增
libs/agentcore/tests/agentcore_test.cpp28 例:EventBuffer 11 例(push/drain 保序、drain(max) 留余、drain(0)、clear、容量超限 FIFO 逐出 +dropped_累计增量断言、log.line 优先驱逐、sink 逐条转发、sink 重入不死锁、null sink、IpcEvent::toJson三字段、单例);RemoteClient 17 例走真 loopback TcpServer(同 libs/transport TransportEnv 模式):连不上端口后台重连 + 事件回调、stop 幂等、register 携带 identity/metadata/token、ack 成功→connected +connection.state_changed入缓冲、ack 失败→error、ack 坏 JSON 不崩、命令回环(seq 透传 + okData JSON、无回调错误响应、回调 error 透传、data 非 JSON 字符串回退、请求体坏 JSON 错误响应)、1s 心跳携带 link 五元组、已连接直发 agent.event、断线事件入 outbox 重连冲刷、超容量(100 上限)丢弃恰好 100 条、config/stateName。全部等待有界,headless 可跑。 - 接线:根 CMakeLists 新增
BUILD_AGENTCORE_TESTS(镜像 transport:option +WINGMAN_BUILD_TESTS级联 FORCE-ON + enable_testing 条件),libs/agentcore/CMakeLists.txt尾部 option +add_subdirectory(tests),gtest_discover_tests DISCOVERY_MODE PRE_TEST。 - 覆盖率:
event_buffer.cpp60/60 行 100%、event_buffer.hpp7/7;remote_client.cpp344/396 行 86%(余量为 Windows 分支、超时事件等边缘路径)。基线(修前)两文件均 0%。 - 意外收获:测试揪出五个真实缺陷(两fix条目),其中 TcpClient 重连 terminate 属生产行为级。
- 验证:28 例连跑 4 轮全绿;全量 ctest 2279 例见提交(含本条与 PathRandomness 收口)。
test(2026-09-27,TestRunGracefulShutdownOnSIGINT 15s 就绪窗口:d22abe3 同族第四处 → waitTCPUp 60s 收口)
-race+ 共享机高负载下复红一次(15.05s 超时,实测同负载 server 启动 30s 上下)——与 d22abe3 收口的三处同族(共享/耗尽 deadline、短窗口误判就绪失败)形状一致,是该轮漏改的第四处。改走既有waitTCPUp(t, name, addr, 60*time.Second):独立窗口、到点带名收口,绿路径零成本。
test(2026-09-27,HumanMouseTest.PathRandomness 统计型 flake 根治:截断零桶双倍宽 → 多轮分布断言)
- 机制:控制点偏移经
static_cast<int>向零截断量化,|offset| < ~1.414 落入零桶(向零截断使零桶双倍宽);两条独立路径存在非零概率(~0.1%–4% 量级,随控制点数)整体量化后完全一致,单次对比断言EXPECT_TRUE(different)低频误报。全量 ctest 首次红即此(2247/2279,同用例此前多轮全绿)。 - 修法:20 轮生成取「至少一对不同」,把运气事件变成分布事件(联合失败概率 ≈ P^20);顺以
i + 1 < n规避size() - 1在 size<2 时的无符号下溢。修后单用例连跑 100 次全绿。
docs(2026-09-27,文档语法错误修复:development-todo.md Phase 7 请求块围栏丢失 + api/core.md 两处标题反引号残缺)
docs/development-todo.md「Phase 7: TCP 协议增强」:请求 JSON 块的#### 请求消息结构标题与```json开围栏自 c400bd6 起丢失(对照原提交补回type/id两字段),孤立的闭合围栏把#### 响应消息结构标题与其代码块吞成一块无法高亮的区域。docs/api/core.md:####keyUp(key)**与####keyPress(key, duration)**两处标题反引号误写成**,行内代码不闭合(32 处同级标题中仅此 2 处)。
feat(2026-09-27,wingman.event 监听器查询与按事件名清理:listener / listeners / clear(type?))
- 范围:
docs/development-todo.md「事件与状态」仅剩的两项未完成条目一次收口。核心层EventHub新增SubscriptionInfo{id,type,name,once}快照与三个查询:subscription(id)(按订阅 ID)、subscriptionByName(name)(同名订阅取最早注册者,匿名订阅不可按名查询,结果不依赖 unordered_map 遍历序)、subscriptionsForType(type)(按订阅 ID 升序,即注册顺序);新增clear(type)重载只清理指定事件的全部订阅(事件不存在时为无副作用空操作),无参clear()全量清理语义不变。 - 脚本层(Lua/Python 同步可用):
wingman.event新增listener(id|int|name|string)(查询单个监听器,返回{id,type,name,once},不存在返回 nil)与listeners(type)(列出该事件全部监听器,未注册事件返回空数组);clear(type?)升级——无参/nil 保持全量清理,传事件名只清理该事件,其他类型参数返回 false 而不是静默全量清理(clear(123)误用不会清空全部监听)。缺参/不支持的参数类型返回 false,与on/off既有约定一致。Python 侧event.pyi同步ListenerInfoTypedDict 与三个签名(camelCase 与 snake_case 别名由引擎统一注册)。 - 测试与验证:
EventHubTest+4、EventModuleTest+12(38→50)——覆盖按 ID/按名查询、once 与匿名快照字段、同名取最早、查询排序、按名清理只影响目标事件(emit 不再触发、其他事件原样)、无参/nil 全量清理兼容、坏参数 false。全量 ctest 与go test ./...结果见提交记录。
fix(2026-09-27,X11 XOpenDisplay 瞬态拒绝根治 + X11WindowCloseCenterAndWaitFamily 负载 flake 收口)
- 症状与定位(测试进程 + Xvfb 双侧 strace):
X11PlatformTest.X11WindowCloseCenterAndWaitFamily在 CPU 超售时不稳(load 5561 下 10 跑 7 红,此前已两轮登记未修)。本轮把红实例的现场抓齐了:每个红都以91 每轮 13~23 次),六个 Linux 门面同病。[error] X11Window: failed to open X display开场——门面XOpenDisplay返回 NULL →initialized_=false→ center/close/isInitialized 成片 false、forceClose 落空、holder 防挂死护栏报警,此前登记的两种失败形状全是这一跳的级联。门面那次连接 connect 成功、Xauthority cookie 也读到了,但 Xvfb 在 accept 后读完SO_PEERCRED与/proc/<pid>/cmdline,连客户端的 setup 请求都没读就shutdown(随后按 Xorg 惯例打开/etc/X<disp>.hosts与protocol.txt组织拒绝信息);同一进程几毫秒后的下一次 open 完全正常。用不带任何 wingman 代码的裸 open→close 循环隔离验证:load≈40 下 11/3000 失败、11/11 立即重试成功;自造 load≈67 下 7/800、7/7。定性:X server 对「前一个本地连接刚断开 → 新连接立即到达」存在 accept 阶段的瞬态拒绝(对应os/access.c/os/client.c按 pid 缓存的本地凭据在断连清理窗口的竞态),CPU 超售放大概率——不是调用方的时序错误,但只能由调用方吸收。全 fixture 复跑在 screen/capture/input/window 各类都见过散片同款失败(load 38 - 修法(生产侧一个收口点,测试侧补齐登记的另两项):新增
src/platform/linux/x11_display.hpp的openX11Display(name, attempts=6, backoff_us=20000)——瞬态拒绝重试,最坏 120ms 只在失败路径付出;x11_window/x11_screen/x11_capture/x11_clipboard/xtest_input/x11_recorder(control+data 双连接)的XOpenDisplay全部改走它,重试耗尽仍按原语义 false/nullptr。测试侧:TestX11Windowctor/setActive/析构与 fork holder 子进程的XFlush改XSync——登记项「子进程未 XSync、父侧 XKillClient 打在 server 建窗之前落空」是独立次级隐患,跨连接读回与强杀目标必须以 server 已处理为前提;holder 收割护栏 5s 改为随超售缩放(clamp(load1/nproc, 1, 8)× 5s,同 dashboard 二轮口径),报警信息带实际秒数与因子。WM 集成用例的就绪探测(displayAccepts/wmRegistered等)保持裸 open——它们本身就在等待循环里,瞬态失败由循环吸收。 - 回归钉:新增
X11PlatformTest.WindowInitializeSurvivesConnectionChurn——25 轮「探测连接 open→close 紧接门面 open」逐轮复刻实证的竞态形状,断言门面每轮必须靠重试站起来、末轮功能真实可用(center/close 生效);循环里的裸 open 失败不作断言(那是压力本身)。 - 验证:自造 CPU 超售(load 60
77,高于登记红区间 5561):目标用例 + 回归用例连跑 10/10 绿;ctest -R 'X11PlatformTest\.|Recorder|X11'66 用例 ×3 轮全绿;全量 ctest 2235 例 0 红(含新增回归钉,load 30~60 共享机背景负载下)。修复前同方法复现:单用例 xvfb-run 连跑 4 轮红 1,与本轮红实例签名一致。
test(2026-09-27,根包 TestRunHTTPEndpointsAndScriptOutput 负载 flake 根治:共享 deadline 耗尽 → nil conn SIGSEGV → waitTCPUp 收口)
- 症状与定性:全仓
-race复跑(load 46+)红过一次——15s HTTP 就绪循环超时后,两个 GET 报 connection refused(t.Errorf不终止);agent 拨号循环因复用同一个已耗尽的deadline,循环体一次都不执行,循环外的err保持os.Getwd留下的 nil、压掉了if err != nil { Fatalf },nilagentConn传进writeAgentFrame→ SIGSEGV。复跑-count=3绿、CI 常态绿、与同期 workflow 改动无交集,先登记为独立欠账,本轮收掉。 - 修法(一个收口点,三处同族缺陷一起清):新增
waitTCPUp(t, name, addr, timeout)——每次调用独立起算超时窗口、到点带名字与地址Fatalf收口;HTTP 就绪等待与 frame listener 拨号都走它,nil conn 结构上不可能再往下漏,SIGSEGV 换成可读的失败信息。同测试里落库轮询的time.Now().Before(time.Now().Add(5*time.Second))恒真条件(事件不落库时挂到测试全局超时而非干净失败)改为先算好的dbDeadline。 - 压测揪出 SIGSEGV 掩盖的第二层:
-race+ load 50-70 下 server 启动实测要 30s 上下(失败实例 Fatalf 之后才打印 route 注册 → seed →Server starting)——原 15s 窗口本身就低于慢启动机器的真实需要,这是 load 46 那次红的直接触发条件。就绪窗口放宽到 60s、落库轮询 15s:窗口只是失败上界,就绪即返回,绿路径零成本。 - 验证:空闲单跑 10s 绿;28 个 CPU burner(load 50-70)下
-race -count=1010/10 绿(263s);中途 30s 窗口版在压测下 4/10 干净红、错误信息直指 server 未就绪(收口的诊断价值同步验证,正是它暴露了 30s 启动事实);go vet干净;全仓go test -race -count=1 ./...全绿,工作流取消根治同轮未回退。
fix(2026-09-27,工作流取消被终态回写覆盖:TestCancelRunningWorkflow 的写序竞争根治)
- 定性(先测再判):
-race干净、无共享变量误用,红的是状态机真缺陷而非测试时序。用一个临时探针把取消动作同步到「步骤行已running」之后(此刻 runner 必已越过execute循环顶部的 ctx 早退检查),修复前 60/60 全红:expected cancelled, got completed。原用例平时绿只是运气——它只等「工作流进了 running 表」(Submit同步写入,等于不等待),取消多半落在 runner 进循环之前,那条路径直接return、不回写终态,缺陷就没机会露面;CI 上负载把窗口撑开才红。 - 机制(两层,第二层是验收 gate 自己抓出来的):取消时步骤以
cancelled结束并让步骤返回ctx.Err(),调度循环按failed出环;而finalStatus只看anyStepStatus("failed"),被取消的步骤状态是cancelled不是failed→ 误算成completed。第一层:两侧无条件Updates(status=...),谁后落库谁赢,Cancel刚写的cancelled被覆盖。加条件更新收口后,自建验收 gate 的-race -count=50又抓到第二层(3/50 红 + handlers 包TestWorkflowCancelLifecycle1 次):旧Cancel先exec.cancel()再落库,被 ctx 惊醒的 runner 会带着误算的completed抢先落库——守卫把「后到覆盖」变成「先到赢」,但先到者写的仍是错值,Cancel反而向自己引发的错误终态让位、对用户回 400(该用例的工作流是wait 30s,不可能真跑完,红即此机制)。 - 修法(终态收口 = 条件写 + 先落库后惊醒 + 诚实取值,不做互斥体):① 两侧终态回写都改条件更新
WHERE id = ? AND status = 'running'——终态只能从 running 迁移,后到让位(RowsAffected == 0),任何交错都收敛到同一终态;②Cancel改为先落库、成功后才exec.cancel()——runner 被 ctx 惊醒前终态已安装,取消必然生效、必然返回 nil,runner 的回写只会让位;③ runner 的finalStatus把ctx.Err() != nil判成cancelled(优先于 failed 判定)——就算未来出现其他 cancel-ctx 路径(引擎停机、超时策略),runner 算出的终态也诚实,不再依赖「Cancel 先落库」的顺序假设。让位方同时不做后续动作:runner 不广播与库不一致的status_changed;Cancel让位时不 cancel ctx、不标 skipped、不广播,按既有契约返回workflow not running(该窗口里工作流确实已跑完)。没加锁、没改Execution的并发结构——竞争在 SQL 条件与调用顺序层面收口比在内存里补锁更小,也覆盖住「ctx 检查与写库之间」这种 check-then-act 窗口。 - 回归用例四条 + 原用例对齐:①
TestCancelAfterStepStartedKeepsCancelledStatus——同步在步骤行running之后取消(修复前 60/60 红),断言严格:取消必生效(nil)且终态恒为cancelled;②TestExecuteFinalStatusHonoursCancelledContext——不经Cancel(绕开「取消先落库」的顺序保护)直接 cancel runner 的 ctx,锁住取值层:runner 终态必须把 ctx 取消算成cancelled而非误算的completed;③TestTerminalWriteYieldsWhenRowNotRunning——不经调度竞争直接驱动execute,锁住「行已是终态时回写让位、不覆盖」;④TestCancelYieldsWhenWorkflowAlreadyTerminal——对称方向,行已completed时取消不得改写终态、不得标 skipped、按不在运行返回。原TestCancelRunningWorkflow没有同步点,Cancel若撞上「工作流真已跑完」的让位分支,改为只要求行处于某个合法终态(cancelled的专断言留给上面第一条用例),避免把合法让位判成失败。 - 验证:
go test -race -count=50 ./internal/workflow全绿(第一轮 gate 抓出第二层缺陷,修后复跑);go vet ./...0 告警、gofmt -l干净;全仓go test -race -count=1 ./...全绿(integration 包在共享机负载下需-timeout 90m)。上一轮 CI 根治未回退:scripts/verify-guacd-e2e.sh仍是无declare -A的平行数组,10 个 shell 契约用例与 Go 包同轮复跑绿。
fix(2026-09-27,guacd e2e 脚本契约测试在 macOS/Windows 恒红:bash 3.2 关联数组 + 被吞掉的 symlink 错误)
- 症状与范围:CI 自
fcf7cf9(2026-09-25,脚本与契约测试引入的那轮)起 连续 9 个 push 红,上一个绿的是4f97996。只红Go Server (macos-latest)与(windows-latest)两个 job,失败集合恒定——就是本脚本的 8 个 shell 契约用例,同 job 内其它 Go 包全ok。门禁失效比红本身更贵:任何人此后的真回归都混在这 9 个红里,而「全绿才推送」无从判定。 - macOS 根因(一条真缺陷):
declare -A READY_PORTS是 bash 4 特性,macOS 自带/bin/bash停在 3.2 →[guacd]=4822被解析成给未变量$guacd赋值,set -u下当场崩;崩点在引擎探测之后、任何 SKIP 分支之前,于是「环境不具备 → SKIP(2)」被吞成 exit 1,正是本脚本自己反对的「两种失败长得一模一样」。实测复现:docker run bash:3.2跑改前脚本 →line 60: guacd: unbound variable,与 CI 日志逐字相同。 - 修复(改齐仓库惯例):两条平行数组
READY_NAMES/READY_PORTS+ready_port()按下标查表——其余verify-*.sh一律不用关联数组,本脚本是全仓唯一例外,现已消除;do_status的服务名也改取同一张表,端口映射回到单一来源。bash 3.2 与 bash 5.3 下逐路径对拍一致:--help(0)、无引擎up/test/run/status(SKIP 2)、未知子命令与未知 flag(2)、假引擎up端口未就绪(1,四行端口报告正确)、假引擎status(1,NOT READY×4)。 - Windows 根因(测试自己的缺陷):契约用例靠往临时目录软链 coreutils 拼出「净化 PATH」,而
os.Symlink的错误被_ =静默吞掉;Windows runner 默认没有建符号链接的权限 → PATH 目录为空 → 脚本里每个外部命令 exit=127,看起来像被测脚本坏了。改为软链失败退化成复制;复制也失败就带原因 SKIP;POSIX bash 脚本的契约测试在 Windows 显式 SKIP(守卫集中在linkCoreutils,所有跑脚本的用例必经此处),宿主缺单个命令(如 macOS 无timeout)仍按原语义继续。 - 本轮为何越界改别人的文件:诊断已完成且修复局部(一个 shell 查表 + 一个测试守卫),留下则 main 继续红、后续批次全部失去门禁判定;两处都是真缺陷而非口味问题。全量 Go 门照跑(
go vet ./...+go test -raceintegration 包)。
feat(2026-09-27,加密资源打包→加载闭环:PBKDF2 口令派生 + PACK_HEADER v2)
- 收掉全仓唯一代码 TODO:
resource_loader里「Encrypted resources are not supported yet」的两侧一致禁用,改为口令派生密钥的真闭环——打包--encrypt --password(或WINGMAN_PACK_PASSWORD)→ 运行期WINGMAN_SCRIPT_PASSWORD解密加载。加密产物没有口令就是永久打不开的字节流,故build()在复制 stub 之前硬拒空口令,而不是产出一个打不开的 exe。 - 两套分叉实现收敛为一份:
PACK_HEADER此前在 packer 与 loader 各抄一份,两侧各带一份_WIN32CryptAPI 加解密;非 Windows 分支只剩「XOR 假哈希 +verifyHash恒返回 true + 一律拒绝加密」——Linux 上那套「完整性校验」从来不是校验。新头resource_pack.hpp成为格式唯一权威(160 字节布局 static_assert、reserved[] 字段位、le32、参数合法性),密码学统一到wingman::crypt(OpenSSL EVP;新增调用方给密钥的aesGcmEncrypt/aesGcmDecrypt原始字节对,与既有「口令进 base64 出」的encryptAES/decryptAES明确分工)。 - v2 版本语义与兼容性:PBKDF2-HMAC-SHA256(100000 轮 / 随机 16B salt / 随机 12B IV)→ AES-256-GCM(密文 || tag),salt/IV/迭代次数落
reserved[0,32)、尾字节清零。升 v2 不破坏任何存量:v1 加密包用的是打包时随机生成、只留sha256(key)的一次性密钥,构造上不可恢复,而当年build()又拒绝 encrypt → 合法产物里不存在 v1 加密包(真遇到就明确判不可恢复,不猜密钥);未加密包照旧写 v2 且 reserved 全零、无指纹,v1 读侧不解释 version/reserved 故仍可加载;未知版本一律拒绝,迭代次数 0 或 >5e6 拒绝(后者等于让加载方替打包方烧 CPU)。 - 完整性三层各司其职 + 用例锁定:GCM 标签是权威;
keyHash只是解密前的口令指纹,用来把「口令错」与「数据损坏」分成两条可读信息(改 salt → 指纹先拒;改 IV → 标签拒);dataHash = sha256(原始明文)在解密解压后校验,兜住头部篡改(清掉/谎称 COMPRESSED:密文合法但解出的字节对不上 originalSize/dataHash)。新增用例专门验证「伪造一份自洽 keyHash 绕过预检后仍被 GCM 拒」,即预检可绕、边界不塌。 - 顺手修一个真缺陷(变换顺序):旧顺序 encrypt → compress,而该简化 LZ 的匹配模型只认「同一字节连出现 ≥4 次」(
data[i - j]左下标不随 count 前进),密文里找不到字节连串 →--encrypt --compress静默退化成「只加密」。改为 compress → encrypt(读侧镜像 decrypt → decompress),加密包从此真能压小;无存量产物受影响。 - 让非 Windows 跑到生产代码:
Packer::buildResourceBytes()/ResourceLoader::loadScriptFromBytes()这对平台无关字节级入口是往返与错口令用例的执行体(PE 读写BeginUpdateResource*/FindResourceA仍是 Windows-only,只负责换容器),ELF 侧嵌入未实现即明确失败,不静默写「看着成功其实没嵌脚本」的产物。顺带修main.cpp上「Version/Size 恒打 0」的存量显示 bug(头部字段要解头后才进ResourceInfo)。 - 测试:
apps/runtime/tests/resource_pack_test.cpp新增 43 例(格式布局/KDF 与指纹/写侧标志与随机性/参数化「明文 vs 加密」往返/负路径:错口令、缺口令、改密文、改 salt、改 IV、改迭代次数、截断、未加密包改字节、头部谎报压缩、隐藏压缩、伪造指纹、坏 magic、短输入、v1 加密拒绝、未知版本、v1 明文仍可加载);crypt_test.cpp+10 例(AES-GCM 原始字节对:空明文/大数据/非标准 IV 长度/错密钥/错 IV/改密文/改标签/非法长度);cli_test.cpp的PackerRejectsEncryptedResourcesUntilLoaderSupportsThem语义作废,改写为「无口令拒绝加密 / 有口令放行到平台边界」两条。全量 ctest 2234 例 0 红(31 例平台性 skip),同轮 Gogo vet+go test -race ./...全绿。 - 本机门禁的盲区,由 Windows CI 补上(本轮自身缺陷,已修):
updateResource()里把资源字节接成const std::vector<uint8_t>,而UpdateResourceA第 5 参是LPVOID(只读,签名不带 const)→ MSVC C2664,两个 Windows job 编译失败。该段在#ifdef _WIN32内,Linux 全量 ctest 永远看不见它——「本地 2234 例 0 红」为真但不足以覆盖 PE 写入侧。修法:局部变量去 const(无需 const_cast),并用同签名探针 TU 复现与验证(const 版报no known conversion from 'const unsigned char *' to 'LPVOID'、非 const 版干净)。副作用是 Windows 侧那 43 例新用例与「Windows 端到端嵌入成功」的断言此前从未真跑,修完才进 CI。
test(2026-09-27,高负载 flake 二轮根治:等待窗口随 CPU 超售自适应)
- 上一轮固定 5s/15s 窗口在 load
89(14 核被 20 会话 + 13 个 jest worker 压到 67 倍超售)再度假红:4 套件 11 用例(loginPage / triggerFormModal / login / RemoteFileBrowser)。分类复现:4 套件--runInBand单跑 8/8 全绿(负载 82~93),失败形状全部为窗口/预算超时、零断言失败——纯负载时序;红线场景 = 全量 13 worker × 外部负载,4-worker 并行在 load 60 仍绿。 - 核心修复(窗口缩放而非再取大固定值):新增单一来源
src/testSupport/rtlWindow.ts——窗口 = 5s × 超售系数(1 分钟 loadavg / 核数,向上取整、下限 1、封顶 60s)。setupRTL.jsx全局configure与各测试文件显式WAIT_TIMEOUT统一取该值;jest.config.tstestTimeout= 3 × 窗口(下限 15s、封顶 180s,config 内联同款公式——原生 ESM 加载不能走 moduleNameMapper)。空闲机器与 CI runner 系数=1,行为与固定 5s/15s 逐位一致;绿路径零额外耗时(条件满足即返回,窗口只是失败上界)。 - 真缺陷两处:①
login.test.tsx固定sleep 200ms后直接断言(不走 waitFor,负载下必假红)→ 改条件化waitFor(同时等 token 写入与跳转),删除死的waitTimehelper;② RemoteFileBrowser / RemoteDesktop / RemoteDesktopModal 三测试文件的显式WAIT_TIMEOUT = 5000绕过全局 configure(自适应永远不生效)→ 改引共享常量,RemoteSessionReportModal 的同名常量为零引用死代码删除。 - 实测:load 108
138(910 倍超售,超过用户红线场景的 89)全量 jest 420/420、tsc --noEmit0 错、eslint 仅存量 2 警告、prettier 干净(全部同负载下复跑)。残余风险:系数进程启动采样一次,运行中负载再涨数倍仍可能超窗(封顶防病态挂死系有意),重跑即可。
test(2026-09-26,存量 flaky 测试根治:loginPage/triggerFormModal 的 load 假红收口)
- 根因(纯时序,非逻辑回归):14 核共享机 14 个 CPU burner + 外部负载下,两文件重复 10 跑 0/10 通过——10/10 超 jest 默认 5s 单测预算、4/10 另超 RTL 默认 1s
waitFor/findBy窗口。等待条件本身都指向真实异步条件(antd Form/Modal 校验提交、登录跳转),无固定 sleep 可去除;否决 fake timers(antd 内部异步链手工推进会侵入组件行为,不增确定性只增脆弱)。 - 修复(只放宽窗口不放宽断言):
jest.config.ts加testTimeout: 15000;新增tests/setupRTL.jsx(挂setupFilesAfterEnv)里configure({ asyncUtilTimeout: 5000 })全局覆盖tests/与src/全部 24 处waitFor/findBy站点,免逐文件改写。 - 顺带锁死一个 RTL 装配陷阱:
configure若写在setupFiles阶段,RTL 首次 import 时afterEach尚不存在(测试框架未装)→ 自动 cleanup 被永久禁用 → 弹窗跨用例堆积、按钮点到旧用例弹窗(实测 5 用例确定性失败)。setupRTL.jsx头注释与jest.config.ts内联注释均写明该约束。 - 实测口径:修复前 0/10(10 次全失败);修复后同款压力(load 68 > 基线 52)10/10 全绿(每次 21/21);全量 dashboard:jest 420/420、tsc 0 错、eslint 仅存量 2 警告、prettier 干净。
ci(2026-09-26,Phase 8 收口:Python 脚本引擎纳入主 CI——本地实测连修五个真缺陷)
- 新 job
cpp-linux-python-tests:ubuntu-24.04 + GCC 13,与cpp-linux-tests同一套全量构建 + ctest,仅叠加 vcpkg manifestpythonfeature 与-DWINGMAN_ENABLE_PYTHON=ON。全量跑而非只跑 Python 子集——该开关只追加编译定义与 libs/python 子目录,同一轮同时证明「开 Python 不破坏 Lua/既有路径」。独立 job 而非矩阵维度:既有 Lua 默认路径的 job 原样不动。缓存键独立(-vcpkg-tests-python-,归档为基础 job 超集,restore 回退共享前缀防两 job 争同一精确键)。apt 清单补autoconf-archive:vcpkgpython3→libb2的 configure 需要 aclocal 宏,缺失即 BUILD_FAILED(本地实测抓到,CI 预防)。 - 本地把 Python 维度跑通的过程连修五个真缺陷——全部是「引擎代码就绪但从未真跑过」的直接后果(默认构建不带
WINGMAN_ENABLE_PYTHON,Windowscpp-pythonjob 只跑名字转换,沙箱/线程/析构路径零执行):- 沙箱从未生效:
applySandbox以!initialized_提前返回,而它只在initialize()置位initialized_之前被调用——守卫永远命中,「沙箱」里import os、open()畅通。守卫改为以globals_就绪为准。 - 沙箱白名单构建本身会抛:
builtins.contains(name)走 pybind11 的__contains__,模块没有该属性直接 AttributeError(被缺陷 1 掩盖)——改py::hasattr。 - 引擎对象一构造就摸 C-API:pybind11 的
py::dict默认构造即调PyDict_New,作为成员意味着工厂一创建引擎、在Py_Initialize之前就 fatal abort——成员改py::object,真正的 dict 在initialize()里赋值。 - GIL 永不释放,ScriptManager 用法必死锁:旧
py::gil_scoped_acquire在「进入时已持锁」路径上析构不释放,调用线程从此永久持有 GIL;而 ScriptManager 一律在 detached 工作线程跑脚本——Python 引擎在生产路径上 100% 死锁(30s 超时,gdb 实锤在take_gilfutex)。修复:裸Py_Initialize()后PyEval_SaveThread(),引擎全部 C-API 段改gil_scoped_acquire_simple(PyGILState_Ensure/Release,按线程管理 tstate,无 pybind11 全局 tstate 共享隐患)。 - marshal 出的可调用对象析构崩进程:
toScriptValue把py::object按值捕获进ScriptValue的 lambda——ScriptValue 在调用方任意线程/任意时刻销毁,pybind11 3.0 的 dec_ref GIL 断言直接 abort(此前被「GIL 恰好被主线程一直持有」掩盖)。改 shared_ptr + 取 GIL 的 deleter,拷贝共享引用。
- 沙箱从未生效:
- Python 测试从 1 个目标扩到 3 个(19 → 51 用例):既有
python_name_conversion_tests(camelToSnake 纯函数,不起解释器)之外新增python_marshal_tests(ScriptValue ↔ py::object 全类型往返:bool 先于 int 判定锁序、tuple→array、dict 非字符串键静默丢弃、异常回落 null、C++/Python 可调用互转)与python_engine_tests(真实嵌入式 CPython:工厂注册/执行/函数调用全 marshal 链路/globals 读写/语法错误恢复/沙箱白名单只含白名单键且 import/open 封禁/shutdown 后安全/工作线程执行——ScriptManager 的真实线程模型,executeString/executeFile/callFunction 各一例 + 「引擎方法返回后调用线程不持有 GIL」回归锁)。core_tests 里PythonStdoutAndStderrRouteToOutputCallback(stdout/stderr → 输出回调 → script_output 上行)此前从未在任何 CI 执行过,本批随 Linux 全量维度首次真跑通过。 - 评估结论:默认维持关闭。依据:官方包(release/nightly 默认构建)全 Lua;CPython 依赖面大(vcpkg
python3拉起 gettext/libffi/libb2/libuuid 等)且嵌入解释器吃体积;沙箱是白名单而非硬边界(同进程嵌入,属性访问未限制,经典__subclasses__逃逸路径仍在);部署侧暂无真实 Python 脚本需求——但本批五个缺陷证明「代码就绪」≠「可运行」,CI 维度从此保证「开关打开即正确」。开启路径已文档化(docs/guide/script-development.md「Python 引擎默认关闭」节),需求出现时重评估。ROADMAP Phase 8 状态据此收口为 ✅。
feat(2026-09-26,M4 远控 P1:浏览器内录像回放——SessionRecording 本地解析)
- 回放入口:录像列表新增「回放」(与下载同级,desktop:view 即可回放,审计语义不变——取回本身已走
desktop.recording_download);RemoteRecordingPlayerModal 内本地解析.mjs,SessionRecording 就在既有依赖 guacamole-common-js@1.5.0 里,零新增依赖(设计 §16「回放」落地,§11 远期清单同步销项)。播放/暂停/进度/seek/时长全走 1.5.0 官方 API;不做倍速——1.5.0 无变速 API,不硬造。 - 上游 Blob 直连缺陷绕行:1.5.0
new SessionRecording(blob)构造即抛Cannot read properties of undefined (reading 'size')——构造器只给 tunnel 分支赋recordingBlob,Blob 分支漏赋值;npm 无 >1.5.0 修复版。绕行走官方「边下边播」同款 tunnel 源:BlobRecordingTunnel(recordingPlayer.ts)把已取回的 Blob 按裸指令流喂 Parser,并配防退化用例锁「不许改回 Blob 直连」。 - 样例录像:本机无任何真实
.mjs(录像卷/目录皆空),按裁定造最小样例而非硬接空数据——gen-sample-recording.js生成 12 帧/4.4s/1280x720(裸指令流 + sync 分帧,与 guacd 录像格式一致),入库recordings/sample-session.mjs,栈起来后回放面板即有真实条目;首帧时间戳从 1000 起(isPlaying以时间戳真值判定,0 会永久「未在播放」)。guacd 真实录像出现即插即用。 - 顺手修存量缺陷:
useGuacamoleSessionfit 自适应缩放对display.scale用赋值写法——1.5.0 里它是方法,赋值只会顶掉方法、缩放永不生效;改为调用并同步修.d.ts类型标注。该文件为桌面会话共享路径,但改动仅此一处语义修复,桌面主链路用例同步更新且全绿。 - 测试:recordingPlayer 封装 8 项(真实库解析样例录像:帧表/进度事件/播放暂停/seek 钳位/坏载荷报错/Blob 直连防退化)+ 回放面板 9 项(加载/就绪/错误三态、控制条联动、重试、关闭清理、fitScale)+ 服务层
fetchRecordingBlob2 项(blob 直传/非 Blob 包装);全套 420 项 jest 全绿。
feat(2026-09-26,M4 远控 P1:阶段二页面层 i18n 接线——录像面板文案 8 语言全量)
- 范围裁定(只接「机制所在层」):Agents 页的阶段二文案——连接表单「会话录制」勾选 + 会话录像面板 19 条(标题/关闭/空态/列头/回放/下载/删除确认与提示/错误兜底)——改走 umi intl(
pages.agents.recordings.*),zh-CN/zh-TW/en-US/ja-JP/pt-BR/bn-BD/fa-IR/id-ID 八份 locale 全量补齐;插值占位符用{name}(react-intl 惯例,同页shutdownConfirmContent先例)。 - 组件层明确不接(留档):
RemoteDesktop/*是给未来 cockpit 复用的公共件(「Modal 与未来 cockpit 按同一入口接入」),全目录零@umijs/max依赖是既成设计;且 umi 的useIntl在 jest 下不可用(src/.umi生成目录不入库、react-intl 未 hoist 到顶层),组件接 intl 需引入 react-intl 直依赖或文案 props 化并补测试基建——架构代价大于本轮收益。回放面板/文件浏览器/剪贴板等组件文案维持中文硬编码(P0 先例),多语言策略留给消费方决定。 - 纯文案接线:不改业务逻辑、零新增依赖,zh-CN 渲染文本与接线前逐字一致;全套 420 项 jest、tsc、eslint(仅存量 2 警告)、prettier 全绿。
feat(2026-09-26,M4 远控 P1:文件浏览器第二版——分页/进度/重试/文件操作审计)
- 大目录:协议一次
get返回整个目录体(无服务端分页),分页做在浏览器侧(每页 50 行、小列表自动隐藏翻页,排序维持目录在前名称升序);目录体聚合加 8 MiB 护栏,超限拒绝并停止 ack——ack 纪律即流控,guacd 自然停发,防异常目录打爆内存。 - 关键协议修正(v1 遗留缺陷):1.5.0
BlobWriter对错误 ack 只停发不报错(onerror仅本地读文件失败触发,dist/esm 实测佐证)——v1 上传失败路径是死代码,失败时 Promise 永不落定。v2 从writer.onack(status.code !== 0)判定失败,并叠「无进展看门狗」(默认 60s,可注入,0 关闭)兜底协议静默;下载侧协议无错误 ack 可判,停滞检测同靠看门狗。 - 进度与有限重试:下载逐块上报已收字节(总量取
entry.size折百分比)、上传走BlobWriter.onprogress(逐 ack 触发,第二参为已发字节);withRetry默认 2 次尝试按序退避,重试耗尽才报错,实际尝试次数进审计。 - 文件操作审计(服务端):新增
POST /api/remote/file-ops(desktop:view 路由组;upload 为写动作,handler 内联追加 desktop:control——监看可浏览/下载、上传仅接管的权限矩阵在审计通道同样成立)。信任模型:上报是客户端 best-effort,会话/agent/操作者由服务端按票据反解(网关 WS 建连后存「票据→会话快照」,closeSession 清除;请求体同类字段不采信),反解不到(进程重启/会话已关)落no_session降级行而非拒绝;审计 kinddesktop.file_download/desktop.file_upload;列表高频不审计(与 agents 列表同策略)。 - 协议边界不动:删除/重命名仍不可行(对象流只有 get/put)、服务端分页不存在,均不硬做(设计 §15.2 明确)。
- 测试:Go 新增 7 个 handler 测试(票据→会话快照全链路生命周期走真 mock guacd WS、载荷校验、权限矩阵、降级行、截断);Dashboard filesystem/浏览器/面板/Modal/服务层全链路测试(401 项 jest 全绿)。
feat(2026-09-26,M4 远控 P1 递补:SSH 文件浏览器——onfilesystem SFTP 树)
- 协议边界即能力边界:Guacamole 1.5.x 对象流只有
get/put,没有 delete/rename 指令——浏览器第一版只有列目录/下载/上传。删除不是被砍掉,是线协议不存在该指令;需求出现走会话内 shell(rm)或等上游扩展,不自行造指令。 - 复用公共件,不在消费方另起一套:
RemoteFileBrowser+filesystem.ts(列目录 JSON 分块聚合、逐 blob ack 流控、BlobWriter 上传完成手动sendEnd)全部落在RemoteDesktop/公共出口,Modal 与未来 cockpit 按同一入口接入。工具栏入口仅 SSH 渲染、SFTP 对象上报后才可展开;监看可浏览/下载、上传仅接管(收发不对称先例同 §14 剪贴板)。 - 网关零改动:
filesystem/get/put/body/ack等对象流指令对网关就是普通数据帧(wsToGuacd/guacdToWS 原样转发);新增guacamole_filesystem_test.go透传回归测试,锁「网关不碰对象流」不变式。 - stage 不变量:浏览器展开/收起只改布局,像素面 stage 恒挂载——卸载即销毁 display 元素,无法恢复。
- 录像回放可行性复核(只给结论不实现):
Guacamole.SessionRecording就在既有依赖 guacamole-common-js@1.5.0 的 npm 包内(_PlaybackTunnel/逐帧解析/play-pause-seek 实测在),「官方 session-player 非 npm 分发」前提不成立——可行、零新增依赖,缺的只是 .mjs 数据源适配与播放器壳;待真实录像数据出现再接(设计 §16「回放」)。 - 新代码四项覆盖率 100%(filesystem.ts / RemoteFileBrowser.tsx / useGuacamoleSession.ts / RemoteDesktopToolbar.tsx / RemoteDesktopPanel.tsx / types.ts)。
style(2026-09-26,Dashboard 存量 36 文件 prettier 对齐)
- prettier ^3.8.3 全量检查暴露 36 个存量文件格式漂移(最老 2026-05-10 的 PageStatePanel/global.less,新到 2026-09-22 的 http.test.ts):这些文件写入时点早于当前锁定版本的格式化规则(长行折叠、数组逐项换行、JSX 缩进层级),
lint:prettier(检查+写入)后一次性对齐。被审 4 个远控提交零命中(漂移清单与 RemoteDesktop 系文件无交集);git diff -w抽查为纯重排无语义变更,tsc + jest 351/351 复跑实证。仓库lint:prettier脚本本就是「检查+写入」自愈口径,此前各轮只跑-c检查未见漂移是因 prettier 依赖近期才升到 3.8.x。
test(2026-09-25,M4 远控 P1:三协议 e2e 容器栈补强)
- 镜像全部钉 digest(guacd 仍锁 1.5.5):四个目标端点除 guacd 外全用
latest,上游任何一次重建都会静默换掉镜像内容,e2e 会在无人改代码的情况下变红,而排查方向会先怀疑网关。护栏是TestGuacdE2EComposePinsImageDigests——没有它,改回latest不会有任何测试变红。 - 一键脚本
scripts/verify-guacd-e2e.sh(up/test/run/down/status):compose up -d在容器尚未监听端口时就返回(xrdp 首启要几十秒),原文档没写「等就绪」,于是「栈没起好」与「代码有 bug」两类失败形状一模一样,只能靠人肉重试区分。脚本把「谁没就绪」显式报出,沿用仓库三态 PASS / FAIL / SKIP(未验证)——绝不把「没跑成」判成通过。引擎探测不只command -v:装了 docker 但没装 compose 插件时报 SKIP 并说清缺什么,不在 compose 那一步炸出无关的unknown command。 - 四服务带 healthcheck:用 bash
/dev/tcp探端口,不依赖 curl/nc(目标镜像未必自带)。端口可达只说明「已监听」,不等于「协议握手可用」,后者交给 e2e 用例自己的等待窗口。 - 契约测试(
guacd_e2e_script_test.go,10 例):脚本三态(无引擎 / 引擎缺 compose / 端口未就绪 / 未知子命令 / 未知 flag /--help)、compose 四服务钉 digest + healthcheck 探针形状、脚本端口与 e2e 目标端口一致、WINGMAN_GUACD_E2E门控仍在。用假引擎 + 净化 PATH 在 0.5s 内跑完,不碰真容器。
feat(2026-09-25,M4 远控 P1:远程桌面会话审计报表)
- 另立专表而非复用 AuditLog:
AuditLog是事件流水(一条事件一行、meta 是 JSON),适合「谁在何时做了什么」的合规逐条查;报表要的是「这台机器被谁接管了多久、失败几次」,需要可聚合的结构化列——在 JSON meta 上聚合既慢又脆(json_extract走不到索引,且 meta 结构会随事件演进漂移)。新增models.RemoteSessionAudit(表remote_session_audits),既有四事件审计保持不变:两者受众不同,缺一不可。 - 只写终态:仅
closed/failed落行,进行中不落。否则报表把未结束会话算进时长、进程崩溃还留永远不闭合的脏行(无法与真实零时长会话区分)。代价是「当前几人在看」拿不到——那是实时态,属 registry 职责不属审计。RecordRemoteSession为唯一落库入口(UTC 归一/时长口径/终态枚举是契约,散在调用点迟早分叉),写失败只记日志不阻断会话关闭。 - 录像可关联:
recording_name与录像检索 API 的 name 同值({agentID}-{sessionID}.mjs);会话 ID 提前到拨号前生成,故建连失败也有唯一标识(否则报表只能说「有一次失败」而无法定位)。 - 查询接口
GET /api/remote/sessions(desktop:view,不新增 RBAC 码——报表是只读视图,无接管能力):多维过滤(agent/协议/操作者/状态/监看接管/录制/时间范围)+groupBy(白名单化,杜绝 SQL 注入)+bucket(hour/day/week/month)。一次请求返回列表 + 汇总 + 维度聚合 + 时间趋势四块视图——分四个端点迟早出现「列表 12 条、汇总 13 条」的口径分叉;四条查询共用同一过滤器,汇总/分组/分桶基于全量而非当页。 - Dashboard:
RemoteSessionReportModal(Agents 页「会话审计」入口)渲染汇总六项 + 维度分布 + 时间趋势 + 明细表,与录像面板并列——录像面板管文件,本面板管行为。前端不做二次聚合(后端已保证四块视图同口径)。 - 测试:Go 侧 12 个用例(落库契约的 UTC/时长/枚举归一、16 组过滤口径、多维度分组、四种分桶、分页口径、五条查询失败分支逐条注入、gorm 回调链探针);Dashboard 侧面板 14 例 + 服务层 7 例。新文件 stmt/branch/func/line 四项 100%;jest 328 → 351。Swagger 已再生成(仅新增
/remote/sessions)。
refactor(2026-09-25,M4 远控 P1:远程桌面前端公共件抽取)
- 动机:
RemoteDesktopModal此前是「连接逻辑 + 阶段二 UI」混在一起的单体,cockpit 要复用连接语义只能复制粘贴——而设计 §7 第 3 条明确禁止(复制品会在协议细节上分叉)。按该条约定抽公共件src/components/RemoteDesktop/,四件边界一一对应:useGuacamoleSession(连接生命周期)、TicketClient接口 +createWingmanTicketClient(票据客户端)、RemoteErrorNotice/classifyRemoteError(错误与降级)、RemoteDesktopToolbar(监看接管与工具栏)。 - 容器解耦:
RemoteDesktopPanel是不假定容器的合成件(画布 + 工具栏 + 错误条);RemoteDesktopModal降级为 Modal 容器适配器,cockpit 可直接放进抽屉/全屏页而无需 fork。TicketClient抽成接口正是因为两边 API base 与鉴权方式可能不同。 - 类型单一来源:
RemoteProtocol/RemoteSessionParams收敛到公共件types.ts,services/remote.ts不再重复声明——协议枚举分叉正是 §7 要防的那类复制分叉。顺手补齐guacamoleWSPath的 https→wss 分支可测性(loc 可注入)。 - 错误分类落地:权限拒绝/能力未配置不渲染重试按钮(重试无意义且诱导反复点),只有断链与未知类给重试——票据一次性意味着重试只能是重新申请票据 + 重建会话。
- 死代码清理:
classifyRemoteError三处text ||兜底为不可达分支(命中条件本身要求原文非空)已删;工具栏 file input 复位改用e.target(查 ref 是不可达分支)。 - 测试:新增
RemoteDesktop/index.test.tsx60 例(hook 生命周期/取消竞态、协议能力派生、四类错误分类、工具栏监看与 VNC 约束、面板下载与剪贴板),补services/remote.test.ts5 例(wss 分支、录像兜底、非 Blob 响应)。新文件与改动文件 stmt/branch/func/line 四项 100%;Dashboard jest 261 → 328。 - 附带修 load-induced flake:
RemoteDesktop*两个测试文件的waitFor统一放宽到 5s(只放宽等待窗口不放宽断言)。实测 8 份全量 jest 并发压满 CPU 时,旧的 1s 窗口会假红;放宽后同款压力下新代码 0 失败。注:tests/loginPage.test.tsx与tests/triggerFormModal.test.tsx在同款压力下仍有既有 load flake(本轮未触碰其代码,已在基线提交上复现确认为存量问题)。
feat(2026-09-25,M4 远控阶段二:Guacamole 剪贴板 / 文件传输 / 会话录制)
- 选型落地:第三方 VNC/SSH/RDP 远控集成采用 Apache Guacamole(guacd 1.5.5 协议翻译 + Go server 反代 WS 网关 + 浏览器 guacamole-common-js 像素面),runtime 零参与不破架构硬约束;备选方案(myrtille、websockify+novnc、自研三协议客户端)否决理由见
docs/remote-gateway-guacamole-design.md§9。P0 网关/票据/RBAC/Dashboard 弹窗已先行合入(20fdb30),本轮补齐阶段二 DG-7/8/9: - 剪贴板(§14):
onclipboard接收(逐块 ack)+createClipboardStream发送(text/plain),监看模式隐藏发送 UI;网关零改动纯透传。 - 文件传输(§15):按协议注入 connect 参数——SSH
enable-sftp=true、RDPenable-drive+drive-path(默认/wingman-drive)、VNC 无通道(UI 整块隐藏);上传createFileStream+BlobWriter分块,下载onfile聚合 Blob 触发浏览器下载。 - 会话录制(§16):票据新增
record字段(未配置双路径时 400 拒绝并附指引)→ connect 注入recording-path/{agentID}-{sessionID}.mjs;安全默认recording-include-keys=false(按键内容永不入录像);新增检索 API:GET /api/remote/recordings(desktop:view,mtime 倒序)+GET .../:name/download(desktop:view + 审计)+DELETE .../:name(desktop:control + 审计),名字 basename+.mjs 白名单防穿越,未配置返回结构化 501。 - 配置:
WINGMAN_GUACD_DRIVE_PATH/WINGMAN_GUACD_RECORDING_PATH/WINGMAN_RECORDING_DIR三环境变量;deployments/guacdcompose 增加 drive/recordings 共享卷与 README 说明。 - Dashboard:类型声明补齐 1.5.0 实测流 API(InputStream/OutputStream/BlobWriter/Status.Code);remote.ts 增 record 透传与录像三 API;RemoteDesktopModal 增剪贴板面板(Unicode 安全 base64 编解码)、上传入口(SSH/RDP)、下载、录制指示;Agents 页连接表单增录制勾选 + 会话录像管理(列表/下载/删除);access 增 canDesktopView/canDesktopControl。
- 测试:Go 侧新增 mock-guacd(讲线协议的假 guacd)三用例验证 connect 按位注入(SSH SFTP+录制、RDP drive、VNC 无文件参数)+ recordings handler 6 用例 + guacamole 参数单元 4 用例;Dashboard jest 235 → 261(modal 流行为/服务层录像 API);Swagger 注解补齐 remote REST 端点并再生成。验证基线:Go
go vet+go test -race14 包全过、tsc 0 错、eslint 仅存量 2 警告。
fix(2026-09-25,Windows CI 假绿揭穿与四用例平台前提修复)
- Windows CI 的「success」是退出码吞没造成的假绿,4 个失败用例自 batch11 合入起就一直在失败(对照 70c44b9 与 438e80c 两轮 job 日志实证):
run-windows-coverage.ps1为防 OpenCppCoverage 退出期 ACCESS_VIOLATION 误伤,对非 1 退出码一律放行——昨晚测试红 + 退出期崩溃(exit -1073741819)被吞成 0 判绿,今晨进程正常 exit 1 才首次如实报红。修复:bat 内将测试输出重定向至日志文件,脚本改为以 gtest 的[ FAILED ] N tests汇总行为失败判据(退出码仅作辅助),失败时输出逐条 FAILED 清单与日志尾部 40 行供排查;PASSED 汇总行同步打印,CI 日志恢复对测试结果的可观测性。 - ①
MacroModuleFullFamilyViaLazyDefault(batch11_glue_coverage_test.cpp):save/load 路径硬编码/tmp/...——Windows 无此目录(saveToJSON 打开文件即失败),改temp_directory_path();同用例的「不存在文件」负例与 Bitmap 用例的 save 负例路径一并迁移。 - ②
BitmapBmpParsingAndSaveFailureBranches(同文件):测试目录改temp_directory_path()下进程唯一子目录;坏 planes / 坏 bitCount 两条断言按平台分支——Windows 的Bitmap::fromFile走 GDI+ 系统解码器(拒坏签名但对 planes/bitCount 头字段宽容,实测照样解析出 2x2 图),Linux/mac 走自写解析器严格拒绝,断言各平台的真实语义;坏签名 / 截断 / noread 断言两平台一致不动。 - ③
UiaModuleGlueTest两用例(misc_uia_node_coverage_test.cpp):用例设计前提是「Linux stub 无后端」,Windows 有真实 UIA Automation 系统服务——AllFindFunctionsReturnNullWithoutBackend在_WIN32下GTEST_SKIP明示(team 空态用例同款模式);EventListenersAllBranches前 6 条防御分支断言 Windows 同样成立不动,仅 threadSafe 两条按平台分支(Linux 无后端 listenerId 恒 0,Windows 真实注册返回正数 id)。 - 本组 4 用例在 Linux(常规 + ASan/UBSan)复验全绿,Windows 行为由 CI 验证。
fix(2026-09-25,ASan+UBSan 首战四组真实缺陷:悬垂回调 / 析构期日志 / memcpy UB / sqlite 句柄泄漏)
- ASan+UBSan 全量插桩首跑即抓到 12 个用例失败,归并为四组根因,全部修复并复验(
-fsanitize=address,undefined+UBSAN_OPTIONS=halt_on_error=1,vcpkg 依赖不插桩;插件构建目录build-san仅测试用,不进常规 CI)。 - ① InotifyFileWatcher pollLoop 在锁外执行用户回调(
inotify_filewatcher.cpp):回调先拷贝进局部pendingCallbacks再释放锁执行——unwatch()在此窗口移除 entry 并释放调用方上下文后,旧拷贝仍被调用(ASan 实测 heap-use-after-free:gtest Test 对象析构后 pollThread 还在跑其 capturethis的 lambda)。修复:回调执行挪进锁作用域(单 poll 线程,锁内执行无并发损失),mutex_改std::recursive_mutex使回调重入watch()/unwatch()不死锁。 - ② DbConnection::close() 在析构路径打日志(
db_module.cpp):进程退出时静态对象析构顺序不定,spdlog registry 先析构(销毁全部 logger)、存活期更长的 DbConnection 后析构,close()里的spdlog::debug访问已销毁 logger(ASan 实测 heap-use-after-free,6 个 DB 用例同根因)。修复:close()删日志并注释「析构路径禁止打日志」。 - ③ Tensor::createFloat32/createInt32 空数据 memcpy(null, null, 0)(
ml_stub.cpp):UBSan 实测 null pointer passed as argument 1——C 标准明文 memcpy 参数不可为 null,与 size 是否为 0 无关。修复:byteSize > 0守卫。 - ④ KeyValueStore sqlite3_open 失败分支泄漏连接句柄(
kvstore.cpp):sqlite3_open 失败时 handle 仍非空(供取错误信息),原代码直接return false不关闭(LSan 实测泄漏,save/load 两处)。修复:失败分支补sqlite3_close(raw)。 - 测试侧配套修复(
filewatcher_test.cpp):UnwatchPath故意保留的 dir2 watch(断言意图所在)与WatchFileInsteadOfDirectory的 filePath watch 均不被 TearDown 的unwatchPath(testDir)(精确路径匹配)清理,回调 capturethis,测试对象析构后条目残留进程级单例,后续任意事件触发即 UAF(事件到达时机不定,表现为 flaky)——两用例在行为断言完成后显式补清理。修复后 FileWatcher 全套 12 用例 ASan 下 15 轮压竞态复验全绿;ASan+UBSan 全量复跑 2180 用例零失败,首轮 12 个失败全部清零。 - win32 后端同构缺陷预防性修复(
win32_filewatcher.cpp/.hpp):checkIOCompletion与 inotify 修复前完全同构——锁内收集 pendingCallbacks、锁外执行,unwatch 窗口同样 UAF。同步修复:回调执行挪进锁块、watchesMutex_改std::recursive_mutex(7 处lock_guard显式模板参数随之同步,linux 后端用 CTAD 无此问题)。Linux 主机无法编译 _WIN32 分支,语法经锁块配对与引用清点自查,行为由 Windows CI 验证;mac/fsevents 后端已用shared_ptr<CallbackContext>拷贝持有方案,无此缺陷,不改动。
test(2026-09-24,C++ 第十一批补测:EventHub 全家族 + task 重试间隙 + inotify 独立实例 + clipboard flaky 收口)
- 新增 27 用例,行覆盖 91.0% → 91.9%(13098 → 13104 行,miss 1185 → 1062),函数 95.2% → 95.6%(v18 基线,全量 2030 用例:1998 PASSED + 32 环境性 skip;基线为清空 gcda 后全量重采——增量编译后旧 gcda 与新二进制 checksum 不匹配,libgcov 的 overwrite 会混入旧版行布局数据,凡增量重编译后必须先
find -name '*.gcda' -delete再采集)。目标文件(v18 绝对值):event.cpp 91.6% → 94.4%(107 行,函数 100%)、task_module 95.3% → 97.5%(321 行,函数 100%)、inotify_filewatcher 94.0% → 96.2%(函数 100%)、inbox_module 95.9% → 97.2%(函数 100%)、transport_module 89.0%(剩余全为防御与伪影,见论证)、x11_screen 94.8%(函数 100%)。 - ① EventHub 6 用例(
batch11_event_coverage_test.cpp新文件,此前零覆盖):空 type 订阅/发射拒绝、type 超长(含边界 256 可接受)、订阅名超长、单事件订阅数上限(1000 满载后第 1001 个被拒 + 清场后可再订阅证明拒绝来自上限而非 type 损坏)、once 订阅 emit 成功后自动移除 + handler 抛异常被 catch 吞噬不阻断同 type 其他订阅者(unordered_map 迭代序不定,用例不依赖顺序)。 - ② A11 胶水 7 用例(
batch11_glue_coverage_test.cpp新文件):task async 语义大用例(运行中查询 pending/running→cancel→wait→canceled、timeoutMs<work 时长置 timeout、wait 自身超时置 timeout 并 emit、fast/slow 双任务驱动 cleanupFinishedTasks 两分支、metadata 传 callable 走 toJson default 分支);task 重试间隙用例(maxRetries=1+ 抛异常 fn + backoff 睡眠期间 cancel/timeout 竞速——循环顶isCanceled()/status()==timeout早退分支,此前 execute 一轮循环永不回头检查);team 空态查询、inbox report 非 string 结果、BMP 解析与 save 失败分支、macro 全家族(lazy 默认实例 + playback 空事件)、screen bounds 静态查询。 - ③ platform_x11 8 用例:屏幕监控查询降级链、DPI 资源管理器链、无 display 静态 API 优雅失败、空区域截图早退、未知鼠标键回退左键、死句柄窗口居中 false、inotify 后端名与普通文件递归早退;inotify 独立实例用例(工厂函数直构,避免单例 shutdown 污染后续用例)——工厂二次
initialize()幂等回归(本批 fix,首跑 terminate 实测)、回调先计数再抛异常被 pollThread catch 吞噬且 watcher 存活、chmod 000子目录触发递归遍历逐条跳过(root 下权限检查旁路不断言)、shutdown 对活跃 watch 执行 rm_watch 清理。 - ④ transport_inbox 1 用例:
tcp://host无端口变体的 host 解析 else 分支(port 落默认值,连上/失败均合法只防句柄泄漏)+ report 第三参非法 JSON parse 抛出被 catch 回退原始串(解析在 handle 校验之前,无需真实连接)。⑤ trigger_posix:ScriptActionsRunAndEmptyBranches补registerLuaEngine()——lua 引擎靠显式注册(runtime main 同款),不注册时 createEngine 返回空、RunScript 分支静默落 warn 兜底;修复后 engine 创建/registerAllModules/executeString/shutdown 真实链首次覆盖,另补运行中二次 start 的 CAS 幂等早退。⑥ posix_process 2 用例(waitForever 阻塞至子进程退出、未知 pid 的 name/path 空串防御)。⑦ inbox_downlink 1 用例(consume 对 null/float payload 的容错分支)。 - 顺带发现并修复的两处时序性漏覆盖/挂死:①
TcpSelfConnectSendAndSessionManagement的 server→client 推送后立即 closeSession——v17 基线实测消息回调两行时序性漏计(v16 纯属派发先于清理的巧合命中),sendTo 后补 100ms 收包等待(loopback <1ms)后稳定。②X11WindowCloseCenterAndWaitFamily的 forceClose 外部持窗子进程——v18 首轮采集实测一次整跑挂死:子进程XCreateSimpleWindow失败不检查(句柄 0 照发,父侧 forceClose(0) 落空)且两侧select/waitpid均无超时,任一环节落空即互等死锁。修复:子进程 w==0 早退 + 限时 select(10s),父侧 waitpid 改 5s 限时轮询、超时 SIGKILL 收尸并如实报失败。 - clipboard flaky 收口:xclip 每次 setText/clear fork 一个 daemon 异步接管 CLIPBOARD selection——写后立即查询命中旧 owner(实测读回上一用例内容),固定 sleep 在高负载下不可靠(xclip 启动实测 >500ms);新建
clipboard_poll.hpp共享 helper(40×50ms=2s 谓词轮询,命中即真的后端零等待),6 个测试文件 12 处写后断言统一迁移,本批开发中依次冒头的 flaky 五连(SetUnicodeText/SpecialCharacters/HtmlImageAndFiles/ClipboardTextRoundtrip/Clear)全部收口。 - team 空态用例 SKIP 模式:TeamManager 进程级单例 client 不可销毁,空态前提(无 teamId)仅在独立进程成立;gtest 单进程按注册顺序运行(A11 注册靠后,此时其他用例已留下 teamId)——用例以 teamId 检测前提、不满足时 GTEST_SKIP 明示,ctest 独立进程模式(gtest_discover_tests)下前提成立完整断言。
- task 生命周期语义实测记录:async 任务达终态即被自己 worker 收尾的
cleanupFinishedTaskserase(事后 status 恒 "failed"、wait 已 erase 任务恒 false);同步任务完成后留 map 可 retry 复提交,但任何 async worker 收尾的 cleanup 会把已终态同步任务一并 erase——retry(syncId) 断言块必须先于任何 async 提交。 - 不可覆盖论证(不硬凑):transport 270-273/342-354 为 client/server 工厂创建失败(bad_alloc 级)与 server 线程启动失败防御,不可稳定注入;inbox 82-84 为 TCP 握手成功后注册消息立即发送失败(发送缓冲区空时不可注入)、232/287 为模块内部类 InboxClient 的 send/messageCallback_ 胶水面无暴露;task 38 为枚举全 case 后 default 兜底、306 为 TaskManager 析构期 shutdown_ 防御(submit-after-shutdown 仅存在于进程退出瞬间,无观察点);screen 813 为 BMP 写 header 失败(磁盘满/IO 硬错误)、956/964 仅无 X11 连接环境可达(测试进程预置 DISPLAY)、335 的 seekg 超文件尾在 libstdc++ 不置 failbit(u32 offset 经 streamoff 恒非负);inotify 26-27 为 inotify_init1 资源耗尽、143-144 为 removeWatch 与内核 IN_IGNORED 事件竞态;posix_trigger 343-344 需真实屏幕像素在两次采样间变化超容差、349-350 为全枚举 switch 兜底、461-462/491-492 为 zenity/aplay fork 子进程侧(exec 替换映像或
_exit,gcda 永不写出——gcov 结构性盲区,行为由 PlayAudioValidPathForksPlayer 实证);x11_screen 65-66 需多显示器 primary 标志(Xvfb 单显示器不置位)、146/172-173 为 DisplayWidthMM/noutput 畸形数据防御、184-185 为显示器热拔竞态;posix_process 191-216 为 fork 子进程侧同上盲区(行为由 WaitForever 等实证)、34/61/99/107/185 为 /proc 未挂载级病态环境与 fork 资源耗尽防御、61/281 换行剥离分支因读取路径产出不含尾换行为防御性不可达;x11_factory 40-70 为无 X/无扩展环境拒绝分支(测试进程预置健康 Xvfb 恒不触发)。 - gcov 行归属伪影清单(分支实际已覆盖,不硬凑):跨行
spdlog::warn调用首行无指令归属(条件行/续行/return 计数齐全)——event 23/29/39/102;跨行ScriptValue::fromObject块中单行漂移——transport 287/293/362/368/454/469/503、inbox 505;push_back({...})收尾行——transport 320/328/418/443/521、inbox 567/578/589、task 497/503/510/516/522;其余——task 213(wait 超时 emit 参数中间行)、transport 279-281(跨行 debug 调用)、posix_trigger 288/454(跨行构造/lambda 收尾)、posix_process 176(循环闭合)。 - Windows CI 编译两轮收口(de76a93、00256c4):batch11_glue 先是多余
unistd.h(MSVC C1083)、删除后暴露真实 POSIX 调用geteuid/chmod(权限块属 POSIX 语义,整块#ifndef _WIN32)——本地 Linux 全绿不代表 Windows 可编,且 MSVC 在 C1083 预处理即断、并发编译取消其余单元,会掩盖后续文件与同文件后续符号错误;教训:跨平台测试文件 push 前两步自查(POSIX-only 头 + POSIX 符号调用),root 权限类语义用_WIN32条件编译隔离。
fix(2026-09-24,task async 等待唤醒缺陷 + X11 屏幕/录制健壮性)
- Task::execute 两处终态置位缺失 notify,
task.wait只能睡满 deadline(task_module.cpp):成功路径置succeeded与超时监控线程置timeout都只改状态不cond_.notify_all()——Task::wait阻塞在条件变量上无人唤醒,只能等到自身 deadline 超时才醒来收尾(第十一批补测用例实测:500ms 完成的任务令wait(5000)阻塞满 5s 才返回 true)。修复:两处置位后补notify_all(cancel/setStatus(failed)路径既有 notify 不变)。 - X11Screen 无宽容 X error handler,死句柄查询杀死整个进程(
x11_screen.cpp):getMonitorFromWindow(已销毁窗口)→XGetWindowAttributesBadWindow → Xlib 默认 handler 直接exit()(新用例ScreenMonitorQueryFallbacks实测测试进程消失)。修复:对齐x11_capture.cpp/x11_window.cpp既有模式,initialize()幂等安装宽容 handler,失败请求以降级返回值呈现而非进程死亡。 - 宏录制流动性检查时序缺陷:任何健康 X server 上录制都无法启动(
x11_recorder.cpp):g_recordDataFlowing原在XRecordEnableContextAsync之后清零——libXtst 的 EnableContextAsync 会在返回前同步投递 StartOfData 到回调,enable 之后再清零会把回调刚置位的标志抹掉,300ms 流动性检查永远超时(此前被误判为「Xvfb 的 RECORD 扩展必然失败」,实为本序缺陷)。修复:清零前移到 enable 之前;注释补记控制/数据双连接请求无全局顺序、CreateContext 后必须对控制连接 XSync。recorder_x11_e2e同步修正:XTest 注入后XFlush→XSync(XFlush 只写 socket 不等 server 消费,FakeInput 请求在 Xvfb 上实测滞留 2s 不注入),Xvfb(RECORD 1.13)实证可用,用例从「仅真实桌面」放宽为「无 X 才 skip」。 - InotifyFileWatcher::initialize 无幂等防护,二次调用 std::terminate(
inotify_filewatcher.cpp):initialize()直接对pollThread_赋新线程——对象已初始化时该线程 joinable,对 joinable 的std::thread赋值直接terminate(第十一批补测独立实例用例首跑即崩实测)。产品单例路径(static lambda 只初始化一次)侥幸未触发,但工厂函数与单例初始化路径各自调一次的组合随时可能踩中。修复:开头if (initialized_) return true幂等防护。 - EventHub Meyer's 单例在进程退出期被 emit 撞段错误(
event.cpp):命名空间级静态g_taskManager(main 前构造)析构晚于 Meyer's 静态局部 hub(首次 emit 才构造)——退出析构逆序使 hub 先死、TaskManager 析构后死;shutdown()→join等待残留任务线程完成期间,任务线程emit("task.canceled")访问已析构的 subscriptions_ 直接 SIGSEGV(全量测试连续两次稳定复现,gdb 抓栈定位)。TaskManager 设计上不逐任务 join(用例结束≠任务线程终结),runtime 退出时活跃 task 同样踩中。修复:EventHub 改泄漏式单例(static EventHub& hub = *new EventHub()),基础设施退出期必须可 emit,内存交由 OS 回收。
fix(2026-09-23,IPC 双通道 SIGPIPE 进程杀手 + notify 桥订阅泄漏)
- UnixSocket/Tcp 通道对端断开后 send 触发 SIGPIPE 终止整个进程(
unix_socket_channel.cpp/tcp_channel.cpp):POSIX 默认语义下向已断开对端 send 收到 EPIPE 的同时进程被 SIGPIPE 杀死——GUI/runtime 同样暴露,且 receiveLoop 感知断开与下一次 send 之间存在天然竞态窗口(第十批补测用例首次实证:SendAfterPeerDisconnectFailsGracefully无修复时整个测试进程消失)。修复:Linux 侧 send 加MSG_NOSIGNAL、macOS 侧 socket 挂SO_NOSIGPIPE(Windows NamedPipe 通道无此语义),send 失败统一走既有 Error 状态而非进程死亡。 - notify bridge 订阅泄漏(
notify_module.cpp):bridge()同 target 重复建桥不摘旧订阅,而 EventHub 对同名订阅不去重——脚本每次重跑都新增一份订阅,同一事件被重复转发 N 次且永不释放(第九批 db 句柄泄漏同型:胶水层只增不减)。修复:建桥前按固定订阅名(notify.bridge.<target>)摘旧订阅并清bridges_陈旧项;回归用例BridgeSameTargetReplacesOldSubscription(修复前同一 emit 投递 2 次,修复后恰 1 次)。 - 死代码删除:
script_manager.cppcheckAllReloads_Locked(与checkAllReloads内联逻辑完全重复,全库零调用方)、x11_clipboard.cppescapeShell(private static,零调用方)、notify_module.cppclearBridges(ModuleDescriptor 无生命周期钩子,该清理函数全库无执行路径)。
test(2026-09-23,C++ 第十批补测:IPC 错误路径与原始帧注入 + X11 wait/close 家族 + script_manager 配置重载)
- 新增 10 用例,行覆盖 90.7% → 91.0%(13090 → 13098 行,miss 1217 → 1185),函数 95.2%(1766/1856)(v15 基线,全量 2003 用例:1963 PASSED + 40 环境性 skip,skip 口径与 v14 同;基线为重启后自起 Xvfb :98 全量重采,lcov 1.16 按生产 TU/libs/tests 三子树并行 capture 后合并,与单次全量 capture 逐 SF 等价)。目标文件(v15 绝对值):x11_window 98.6%(272/276——wait 家族/close/forceClose/center 批前全部零覆盖)、unix_socket_channel 91.6%(229/250)、script_manager 91.0%(463/509)、notify_module 76.1%(162/213,剩余全为白名单断链,见不可覆盖论证)。
- ① unix_socket_channel 5 用例(含 RawSocketClient 裸帧注入器,绕过 IpcMessage 封装直接构造协议层畸形输入):
setErrorCallback首个真实触发用例(连接失败置 Error 回调携带路径——该回调此前全库零调用方);空 payload 序列化为 object 分支;裸帧坏 JSON → deserializeMessage 异常分支 → Error 消息进回调;0 长度帧 → receiveLoop 长度校验 break → 通道转 Disconnected;对端断开后 send 优雅失败(SIGPIPE 修复回归)。② x11_window 1 用例(X11WindowCloseCenterAndWaitFamily)+ 剪贴板断言补全:center 居中、waitFor 250ms 轮询超时 false、waitClose 存在/不存在两分支、waitForForeground 死句柄 false 与真前台 true、getBackendInfo、close(WM_DELETE_WINDOW ClientMessage 无 WM 下断言请求本身)、forceClose——XKillClient 语义为终结拥有目标资源的客户端连接,打在本进程自建窗口上等于切断自己的 X 连接(首版踩坑:后续任何 Xlib 调用触发 fatal IO error 整进程退出),用例改为 fork 子进程扮演外部客户端持窗、管道传句柄、EOF 退出;ClipboardFullSurfaceMethods补 getBackendInfo/空格式表断言。③ script_manager 3 用例(script_manager_config_reload_test.cpp):loadJsonConfig 非 object 根拒绝(数组/字符串/数字/坏 JSON 四态,对照组合法对象可载)、autoReload 关闭时 checkReload 早退(重写文件使 mtime 前移 + 打开全局开关反向证明早退门控真实生效,随后 reload 返回 true 且 lastModified 刷新)、脚本文件删除后 stat 失败返回 0 不误触发 reload(注册表不受影响)。④ notify_module 1 用例(订阅去重回归,见上条 fix)。 - 通道并发语义实测记录:对端存活时裸调
stopReceiving()永久挂起——接收线程阻塞在无超时recv()上,join()永等;disconnect()内部先shutdown再 stop 才是唯一安全序(既有StopReceivingWithoutStartIsSafe注释同理)。初版两个用例据此挂死,均改为不触碰接收线程的确定性方案。 - 不可覆盖论证(不硬凑):clipboard 剩余 26 行全为 NullClipboard 兜底类(仅 XInitThreads 失败时使用)与工厂恒
make_unique不返回空的分支;x11_clipboard 剩余 ~30 行为 fork+execvp 子进程侧代码——子进程被 exec 替换或_exit,gcda 永不写出,属 gcov 结构性盲区;notify 剩余 ~47 行为 webhook 白名单装配断链:setWebhooksEnabled/setAllowedHosts全库零调用方 →allowedHosts_恒空 →isUrlAllowed恒 false → 所有 webhook 永远被拒,属功能级缺陷(修复需新增配置入口的产品决策,另行跟踪);script_manager 剩余 running 态分支为同步执行模型遗留(runScript同步等待完成即 completed,无任何入口将脚本置为 running,callFunction/pauseScript/resumeScript的 running 路径不可达);unix_socket 剩余 14 行为socket()/listen()/accept()资源耗尽级失败(fd 打满)不可注入。
feat(2026-09-23,Guacamole 远程桌面像素面网关 P0:票据门禁 + 三协议 e2e + Dashboard 组件)
- 架构落位(
docs/remote-gateway-guacamole-design.md方案B):浏览器 ⇄ Go server(GET /api/remote/guacamoleWebSocket 承载 Guacamole 指令流)⇄ guacd(纯 TCP,loopback/内网)⇄ agent 桌面(RDP/VNC/SSH)。runtime 零参与像素面——不改 C++、不加监听,已同步architecture-decisions.md(Allowed WebSocket Usage 补像素面网关段 / Forbidden Changes 补「浏览器直连 guacd」禁项)。 - 一次性票据门禁:
POST /api/remote/tickets(desktop:view/desktop:control任一可申请;接管模式 handler 内额外要求desktop:control),新增desktop:view/desktop:control两个内置权限并配入 Viewer/Operator 角色。票据短时效单次有效,经 URL query?ticket=(首选)+Sec-WebSocket-Protocol[0](兼容位)双通道传递;WS 端点不挂 AuthRequired(浏览器 WS 无法自定义 header,票据即凭证,与/ws先例一致)。配置新增WINGMAN_GUACD_ADDR(默认127.0.0.1:4822)。 - 协议实现要点(单测回归护栏固化):guacd 对 select 回的 args 名单做参数个数硬校验——connect 必须与名单按位等长(含首段版本名,
VERSION_x_y_z原样回显),短一位即静默断连(浏览器侧只见会话无响应);rdp 显式disable-audio(guacd 镜像 libguac 未链音频编码器,RDPSND 协商即 NULL 崩溃)与disable-gfx(xrdp 类 VNC 后端不支持 rdpgfx 通道,FreeRDP 等 GFX 帧无限挂起;仅 1.6.0 认识该参数,1.5.5 自动忽略)。 - guacd 版本锁定 1.5.x:1.6.0 实测双崩溃(gdb 符号栈定位:
guac_audio_assign_encoderNULL 与 display 重构后guac_user_supports_webpNULL 竞态,后者无参数可规避),e2e compose、deployments/guacd/README.md、设计文档 §13.2 三处固化;另记录 cockpit 侧api_guacamole.goconnect 以 name=value 发参的协议缺陷待反哺(§13.3)。 - 三协议 e2e(
integration/guacd_e2e_test.go,WINGMAN_GUACD_E2E=1门控;podman 起 guacd/sshd/xrdp/VNC 容器):SSH/VNC/RDP 各一条完整链路(select→握手→connect→指令流像素帧到达),隧道读帧按 gorilla「读失败即毒化」语义单次总 deadline 实现。 - Dashboard 前端:
services/remote.ts(票据申请 + WS 路径拼接)、RemoteDesktopModal组件(fitScale 自适应缩放、监看/接管分态挂载键鼠、关闭清理会话)、Agents 页「远程桌面」入口(协议/凭据/监看-接管表单);guacamole-common-js 最小类型声明;新增 8 用例(服务层 4 + 组件 4)。
test(2026-09-23,C++ 第九批补测:trigger 序列化全枚举/timer+system+human 胶水收口)
- 新增 12 用例,行覆盖 89.9% → 90.4%(13090 行,miss 1324 → 1252),函数 94.4% → 94.7%(v13 基线,全量 1993 用例:1953 PASSED + 40 环境性 skip)。目标文件:trigger_handler 86.89% → 98.36%(rpc/handlers)、timer_module 84.31% → 93.46%、system_module 84.48% → 92.24%、posix_system 89.03% → 98.39%(platform 层)、human_module 86.96% → 88.41%(剩余全为签名常量尾行 gcov 伪影)。
- ① trigger RPC list 序列化 3 用例(
trigger_list_serialization_test.cpp——既有 ListTriggers 只 list 过 ColorFound+Click 单一组合,两个序列化函数的其余枚举 case 全部零覆盖):11 种 condition 类型 list 全枚举断言 type 字符串、10 种 action 类型全枚举断言、非法枚举值 999 经 static_cast 入库后 list 走 switch 兜底回退("ColorFound"/"Log",宽容不崩溃——同时覆盖两函数 switch 后的兜底 return)。② timer 胶水 4 用例:setTimeout 真实触发回调、参数防御、setInterval 周期触发 + cancel 正路径停转、clearTimeout/clearInterval 别名函数与缺参/未知 id 防御(既有测试只覆盖 after/every 老入口)。③ system 胶水 4 用例:getCpuUsage 首调基线 0 + 二调 [0,100] 值域、getDiskInfo 带路径参数返回单对象(既有只测无参数组版)、fake-xrandr PATH 注入驱动 getDisplayInfo 解析链——popen("xrandr …") 继承 PATH,临时目录注入 fake 脚本输出 connected+primary+disconnected 三行,真实驱动 platform 层 fgets 循环/换行剥除/connected 匹配/分辨率 stoi/isPrimary 判定/disconnected 跳过(宿主机无 xrandr,该解析链自项目创建以来零覆盖)、getNetworkAdapters 全枚举(ifa_addr 空项 continue 分支)。④ human setConfig 通用入口 1 用例:move_speed/typing_variance 两 key 写读往返与后端映射(既有测试只走 setMoveSpeed/setTypingVariance 专用函数,通用入口分支零覆盖)。 - 顺带修复在案 flaky(v13 全量实测暴露):
TriggerPosixCoverageTest.InputActionsDriveMockInput——pump(2) 固定 sleep 120ms 等待 watchLoop 触发,全量 1993 用例高负载下调度延迟超窗口致 0 轮触发断言全挂;改为条件轮询等待(上限 2s),同文件另外 2 处同型断言点一并加固。 - 不可覆盖论证(不硬凑):kv_module 剩余 21 行全为函数签名常量多行表达式 gcov 归属伪影(与 ini 470-488 同现象,函数体均已覆盖);human/timer/system 剩余 miss 同为尾行伪影 + 少量跨行表达式归属伪影;posix_system 剩余 5 行为 popen/getifaddrs 系统调用失败与 macOS 兜底分支;trigger_handler 剩余 3 行为 region Rect 构造跨行伪影与 list 空循环闭合伪影。
fix(2026-09-23,db_module 句柄注册表双泄漏 + 裸指针 UAF 防护缺失 + 死代码清理)
- g_queries/g_tables 注册表只增不删(
db_module.cpp):db.table()/db.table_where()每次调用storeTable/storeQuery新增注册项且全库无任何删除路径——脚本循环中反复建表查询,shared_ptr永不释放(第八批补测 8 轮 create-close 循环用例实测暴露)。修复:新增table_close/query_close胶水函数显式释放,close 后旧句柄经注册表校验被拒绝,不会悬空。 - extractTable 裸
reinterpret_cast无注册表校验(同文件):extractConnection/extractQuery均验证句柄在注册表中命中才返回裸指针,唯extractTable把整型句柄直接 cast 成指针——句柄伪造或 close 后复用即 use-after-free(此前被泄漏掩盖:对象永不销毁故 UAF 不触发)。修复:对齐三处统一的注册表校验模式。 - 死代码删除 88 行(
db_module.cpp/db_connection.hpp):Stmt 移动构造/赋值(prepare()返回纯右值,C++17 强制省略拷贝保证移动构造不可达)、executeUnlocked/queryUnlocked/scalarUnlocked 三件套(事务回调内直接用加锁版——m_mutex为 recursive_mutex 可重入不死锁,三函数全库零调用方)、closeAllConnections(零调用方)。
test(2026-09-23,C++ 第八批补测:db/ini/tcp_channel 三模块深度收口)
以上为节选(完整记录见 CHANGELOG.md)。
Package Contents
| Package | Platform | Contents |
|---|---|---|
wingman-*-windows-x64.zip |
Windows x64 | C++ runtime / Tauri GUI installer (NSIS) / Go orchestrator server / dashboard / scripts / config |
wingman-*-linux-x64.tar.gz |
Linux x64 | C++ runtime / Tauri GUI (AppImage, deb) / Go orchestrator server / dashboard / scripts / config |
wingman-*-macos-x64.tar.gz |
macOS x64 | C++ runtime / Tauri GUI (dmg, app) / Go orchestrator server / dashboard / scripts / config |
wingman-*-android-arm64.apk |
Android arm64 | wingman agent(手势注入 / 屏幕采集 / 找色找图 / 远程截图),装在目标安卓设备上 |
wingman-agent-*(六腿) |
linux / macos / windows × x64 / arm64 | agent 单二进制,供 install.sh / install.ps1 一键安装分发;arm64 桌面的 agent 覆盖由此承担(暂无 arm64 桌面全量包) |
校验和见 SHA256SUMS.txt,逐包校验步骤见 VERIFY.md,构建元信息见 BUILD_INFO.txt。