nodeagent

141 Commits 1 Branch 14 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
jkooe	54f7f4c7ab	test(vm): Parallels Win11 ARM 真机验证 —— A 组 15/0 + v1.5 四项全过 + 锚点端到端通过 ## 环境 Parallels 27 + Win11 ARM，VM 10.211.55.9（共享网络）；被控端 `-NodeId win-arm -AllowInput`。 ## ⭐ B5 结论（与预期不同，但更有价值） \| 组合 \| 结果 \| \|---\|---\| \| `win-x64` 包（内含 x64 Node） \| ⚠️ 能启动、能 listen 8765，但 TLS 握手 60s 不完成 → 协议层不可用（Prism 下） \| \| 换 ARM64 Node（同版本 v22.20.0） \| ✅ 完全正常：握手成功、连接、51 项能力 \| × 结论：`nodeagent-win-x64.zip` 不能在 ARM Windows 上实用；ARM 上需 ARM64 Node。 ## 验证结果 - A 组（verify.mjs 17 项）：✅ 15 通过 / 0 失败 / 1 跳过（29.5s） - B1 v1.5 四项：✅ 全过 —— 字符串热键 / 预设别名（`copy→ctrl+c` 映射正确）/ 长按 / 后台定向投递（explorer 命中 138 窗口、WindowsTerminal 10 窗口） → v1.5.0「未经真机就发版」的债，至此还清 - B4 锚点端到端：✅ collect(62 条) → 上传云盘 → verify 判定「链已增长」+ 精确明细 - B2/B3：⏸ 阻塞（需 restart，而计划任务启动失败 —— 手工跑却完全正常） ## 本轮真机抓到的 2 个真 bug（都已修） 1. `control.ps1:100` 的 `$scheme:` 被 PowerShell 当 drive 引用 → 解析期错误 → 整个脚本不可用（stop/start/status 全废）；已修 + 加守卫（扫全部 .ps1 的 `$ident:`） 2. `anchor-audit.mjs` 调用不存在的 `audit head` 子命令 → 改为 `invoke system.audit.head` （这种「能力存在但 CLI 无子命令」的错配，不真跑一次发现不了） ## 文档 `docs/VM-VERIFICATION.md` 补「实际验证结果」节 + 5 条新增排查项（安装/密钥/CLI 语法/计划任务）	2026-10-11 00:18:43 +08:00
jkooe	ba57d99806	docs: 新增 VM 验证清单（Parallels 27 + Win11 ARM）—— 真机不可用时的替代路径 ## 背景 Windows 被控端离线导致 4 项验证卡住（v1.5 四项 / v23 三防护 / v26 清理 / 锚点端到端）。 Parallels Desktop 27 可跑 Windows 11 ARM 虚拟机（Apple silicon 只支持 ARM 版 Windows， x86_64 仅 Pro/Business 的早期预览），可提前跑掉架构无关的验证项。 ## 清单内容（docs/VM-VERIFICATION.md） - 能补 / 不能补的矩阵：协议层与输入层可验；杀软交互、显示/DPI、性能指标不可替代 - 前置准备：桥接网络（否则 UDP 广播发现测不了）、优先 ARM64 Node、run-portable/install 二选一 - 逐条命令（均已对着源码核实参数）： - A 基础验收：直接复用既有 `scripts/verify.mjs`（17 项 + Markdown 报告） - B1 v1.5 四项：`key press "ctrl+shift+esc"` / `copy` / `--hold 800` / `--route post --pid N` （对应 args 的 hotkey / preset / hold_ms / route+target_pid 四个分支） - B2 v23 三防护：`agent.json` 的 `security.auth_ban` 与 `idle_timeout_ms` + 三场景判定 - B3 v26 清理：`restart` 后 `schtasks /query`，重点看"当前宿主任务必须仍在"（否则即误杀） - B4 锚点端到端：`anchor-audit.mjs collect` → 云盘 → `verify` - B5 额外结论：win-x64 包在 ARM Windows 上能否跑（走 Prism；跑通则写进 README） - 结论标注规则（强制）：VM 验过的写「VM 已验」；杀软/显示/性能不得因 VM 通过就标已验；并注明「VM 与真机架构不同（真机 x86_64），VM 通过不自动推出真机通过」 - 已知 VM 环境差异表（排查先看）：广播发现需桥接、坐标为逻辑验证、性能数字不可采信等 README 文档区与 ROADMAP §九均已链入。	2026-10-10 23:38:02 +08:00

Author

SHA1

Message

Date

jkooe

54f7f4c7ab

test(vm): Parallels Win11 ARM 真机验证 —— A 组 15/0 + v1.5 四项全过 + 锚点端到端通过

## 环境
Parallels 27 + Win11 ARM，VM 10.211.55.9（共享网络）；被控端 `-NodeId win-arm -AllowInput`。

## ⭐ B5 结论（与预期不同，但更有价值）
| 组合 | 结果 |
|---|---|
| `win-x64` 包（内含 x64 Node） | ⚠️ **能启动、能 listen 8765，但 TLS 握手 60s 不完成** → 协议层不可用（Prism 下） |
| **换 ARM64 Node（同版本 v22.20.0）** | ✅ **完全正常**：握手成功、连接、51 项能力 |

× 结论：`nodeagent-win-x64.zip` 不能在 ARM Windows 上实用；ARM 上需 ARM64 Node。

## 验证结果
- **A 组（verify.mjs 17 项）**：✅ 15 通过 / 0 失败 / 1 跳过（29.5s）
- **B1 v1.5 四项**：✅ 全过 —— 字符串热键 / 预设别名（`copy→ctrl+c` 映射正确）/ 长按 /
  后台定向投递（**explorer 命中 138 窗口**、WindowsTerminal 10 窗口）
  → **v1.5.0「未经真机就发版」的债，至此还清**
- **B4 锚点端到端**：✅ collect(62 条) → 上传云盘 → verify 判定「链已增长」+ 精确明细
- B2/B3：⏸ 阻塞（需 restart，而计划任务启动失败 —— 手工跑却完全正常）

## 本轮真机抓到的 2 个真 bug（都已修）
1. `control.ps1:100` 的 `$scheme:` 被 PowerShell 当 drive 引用 → **解析期错误 → 整个脚本不可用**
   （stop/start/status 全废）；已修 + 加守卫（扫全部 .ps1 的 `$ident:`）
2. `anchor-audit.mjs` 调用**不存在的** `audit head` 子命令 → 改为 `invoke system.audit.head`
   （这种「能力存在但 CLI 无子命令」的错配，不真跑一次发现不了）

## 文档
`docs/VM-VERIFICATION.md` 补「实际验证结果」节 + 5 条新增排查项（安装/密钥/CLI 语法/计划任务）

2026-10-11 00:18:43 +08:00

jkooe

ba57d99806

docs: 新增 VM 验证清单（Parallels 27 + Win11 ARM）—— 真机不可用时的替代路径

## 背景
Windows 被控端离线导致 4 项验证卡住（v1.5 四项 / v23 三防护 / v26 清理 / 锚点端到端）。
Parallels Desktop 27 可跑 **Windows 11 ARM** 虚拟机（Apple silicon 只支持 ARM 版 Windows，
x86_64 仅 Pro/Business 的早期预览），可提前跑掉**架构无关**的验证项。

## 清单内容（docs/VM-VERIFICATION.md）
- **能补 / 不能补的矩阵**：协议层与输入层可验；**杀软交互、显示/DPI、性能指标不可替代**
- 前置准备：桥接网络（否则 UDP 广播发现测不了）、优先 ARM64 Node、run-portable/install 二选一
- **逐条命令**（均已对着源码核实参数）：
  - A 基础验收：直接复用既有 `scripts/verify.mjs`（17 项 + Markdown 报告）
  - B1 v1.5 四项：`key press "ctrl+shift+esc"` / `copy` / `--hold 800` / `--route post --pid N`
    （对应 args 的 hotkey / preset / hold_ms / route+target_pid 四个分支）
  - B2 v23 三防护：`agent.json` 的 `security.auth_ban` 与 `idle_timeout_ms` + 三场景判定
  - B3 v26 清理：`restart` 后 `schtasks /query`，**重点看"当前宿主任务必须仍在"**（否则即误杀）
  - B4 锚点端到端：`anchor-audit.mjs collect` → 云盘 → `verify`
  - B5 额外结论：**win-x64 包在 ARM Windows 上能否跑**（走 Prism；跑通则写进 README）
- **结论标注规则（强制）**：VM 验过的写「VM 已验」；杀软/显示/性能**不得**因 VM 通过就标已验；
  并注明「VM 与真机架构不同（真机 x86_64），VM 通过不自动推出真机通过」
- **已知 VM 环境差异表**（排查先看）：广播发现需桥接、坐标为逻辑验证、性能数字不可采信等

README 文档区与 ROADMAP §九 均已链入。

2026-10-10 23:38:02 +08:00