RemoteController 0.1.2

WinAgentController 0.1.2 — 修复实测可用性问题

本版本修复 2026-08-18 真实对端远程操作实测暴露的 10 项可用性问题（P0×2 / P1×5 / P2×3），并新增健康探测命令。

修复内容

• exec 通道：对端侧执行超时（RC_EXEC_TIMEOUT_SECONDS 默认 60 秒），超时自动取消任务并回写错误，通道不再被长命令永久占用；通道被占时返回占用者信息（jobId/命令/开始时间），可用 rcctl job cancel <jobId> 清理
• job 诊断：启动后立即终态且零输出时给出排查提示；默认 PowerShell 5.1 下使用 &&/|| 时前置警告（提示 --shell cmd 或分号）
• 中文输出：exec / job logs / fs read 的输出解码支持 GBK 回退（严格 UTF-8 优先），对端中文不再乱码
• 文件根提示：fs/copy 越界时明确提示 RC_AGENT_FILE_ROOT 与可用通道（exec/SCP）
• 新增 rcctl health：一条命令组合探测服务状态、控制端口监听与磁盘空间，输出 OK/FAIL 判定

其他

• skill 更新：实测操作注意事项（默认 shell/转义/编码/文件根/UI 格式等）、磁盘探测与 schtasks 模板、勿单独停止 Broker（SCM 依赖级联）等纪律
• rcctl health 判定逻辑提取并补单元测试 4/4（含非破坏性负例验证）
• 全量测试 312/312 通过；真实对端升级后逐项复测通过

RemoteController 0.1.1

WinAgentController 0.1.1 — 修复自动发布构建链路

0.1 的 GitHub Actions 自动发布流程存在构建失败，本版本修复发布链路、修正若干稳定性问题并重新打包发布。

修复内容

• 发布流水线：修复 Windows PowerShell 5.1 对中文文件名（docs/安装说明.md 等）的 ANSI 解码乱码，打包步骤改用 PowerShell 7（pwsh）；gh CLI 显式注入 GH_TOKEN 完成 Release 发布
• 稳定性修复：TaskHost 输出段文件写入竞态（改为原子写）；TLS 诊断文件并发写锁竞争；WaitAsync 对宿主无终态退出的处理；放宽云端慢 runner 下的 TaskHost 生命周期超时；CI 测试失败自动重试一次
• 包内容：zip 附带项目 Skill（.agents/skills/operate-win-agent-controller），供 AI Agent 操作指引

验证

• 全量测试 312/312 通过（Contracts 118 / TaskHost 15 / Broker 3 / Agent 176）
• Release 构建、测试、打包、发布全链路通过

RemoteController 0.1

WinAgentController 0.1 — 功能完整的初版

面向 AI Agent 的 Windows 远程控制工具首个可用版本。通过结构化 CLI 与经 TLS 指纹固定、一次性配对和签名会话认证的控制通道，Agent 可安全操作远端 Windows 节点。

核心功能

• 局域网发现、TLS 指纹固定、单控制端配对、目标档案自动登记
• 命令执行（PowerShell/cmd）与持久任务（日志续读、stdin、取消、PTY、提权 Broker）
• 受限文件操作与目录传输：64 MiB TLS 二进制流、流式 SHA-256、256 MiB 检查点断点续传、逻辑/线上/重传字节统计
• 桌面 UI 自动化：窗口/显示器/截图、鼠标（move/button/wheel 分离）、键盘、剪贴板、UI Automation 元素树
• Chromium 浏览器控制：Edge/Chrome 启动、导航、DOM 读取
• 完整包一键更新：binary-update-v1、detached SYSTEM 安装、失败回滚、Succeeded 后自动清理暂存
• 目录传输性能优化：会话级索引 + TCP_NODELAY（13,667 文件目录下载达 SCP 吞吐的 87.5%）

包内容

• 完整安装包（7 个可执行文件 + 12 个部署/运维脚本）
• README.md（安装说明）与 README-详细版.md
• LICENSE（MIT）、VERSION.txt、SHA256SUMS.txt

使用

下载 zip → 解压 → 双击 Setup-RemoteControllerAgent.cmd 安装 → 记录设备 ID/指纹/配对码 → 控制端 rcctl pair 配对后即可使用。