nodeagent

145 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	28ce95f045	feat(audit): 审计锚点外部化落地 —— 判定逻辑收敛为 protocol 纯函数 + 控制端工具 + 云盘链路 ## 为什么（一句话）锚点的安全性完全来自「它在攻击者碰不到的地方」。与被审计日志同机的锚点等于没锚：被控端一旦被 root，重写日志后顺手改掉锚点即可。 ## 本次改动 ### ① 判定逻辑收敛（消除「两份真相」）把 `compareWithAnchors` 的三条判定抽到 `packages/protocol/src/audit-anchor.ts` 的纯函数 `judgeAnchors(head, anchors)`（无 IO，不知路径）： - agent 端 `compareWithAnchors` 改为「读文件 + 调 judgeAnchors」 - 控制端脚本同样调用它 → 同一份日志不可能出现「被控端说一致、控制端说被改」的分歧 - 附带 `parseAnchorsFromJsonl`（坏行跳过，一行坏数据不毁整份锚点） - agent 侧类型改为 re-export，既有导入路径不变（9 个原有锚点单测全绿，行为零变化） ### ② 控制端工具 `scripts/anchor-audit.mjs` - `collect`：拉链头 → 生成一行锚点 JSONL（并打印 `ANCHOR_JSON=` 便于 automation 取用） - `verify`：读锚点文件（可从云盘下载）+ 拉链头 → 判定，`ok:false` 时退出码 2 + 醒目告警 - 走 CLI 而非自己实现连接（复用其多设备配置/证书钉住/daemon，避免又一份实现） - 支持 `--head-file`：离线也能验证判定链路（本轮即用它做了 fixture 验证） ### ③ 云盘链路 - 建 `…/Project/NodeAgent/anchors/`（与全量备份分开目录） - 每日 automation 更新为「拉链头 → 上传云盘（一天一个带日期的文件）→ 简报」，并规定每月首日额外做一次「下载历史锚点 → 链外比对」 ## 验证 - 纯函数重构零行为变化：原有 audit-anchor 单测 9/9 全绿；全仓 273 单测全绿；7 包构建 - 工具离线验证（fixture）：一致 → 「与锚点完全一致」退出码 0；篡改 → 「链头哈希与锚点不一致」退出码 2；三个错误分支均给出明确提示 - 云盘：`anchors/` 目录创建成功（1/1 步），目录内容已复核 - ⚠️ 端到端（真拉链头 + 真上传）待被控端上线；脚本的 CLI 分支已做错误处理验证	2026-10-10 19:14:09 +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

28ce95f045

feat(audit): 审计锚点外部化落地 —— 判定逻辑收敛为 protocol 纯函数 + 控制端工具 + 云盘链路

## 为什么（一句话）
锚点的安全性完全来自「它在攻击者碰不到的地方」。与被审计日志同机的锚点等于没锚：
被控端一旦被 root，重写日志后顺手改掉锚点即可。

## 本次改动

### ① 判定逻辑收敛（消除「两份真相」）
把 `compareWithAnchors` 的三条判定抽到 **`packages/protocol/src/audit-anchor.ts`** 的
**纯函数 `judgeAnchors(head, anchors)`**（无 IO，不知路径）：
- agent 端 `compareWithAnchors` 改为「读文件 + 调 judgeAnchors」
- 控制端脚本同样调用它
→ 同一份日志不可能出现「被控端说一致、控制端说被改」的分歧
- 附带 `parseAnchorsFromJsonl`（坏行跳过，一行坏数据不毁整份锚点）
- agent 侧类型改为 re-export，既有导入路径不变（**9 个原有锚点单测全绿，行为零变化**）

### ② 控制端工具 `scripts/anchor-audit.mjs`
- `collect`：拉链头 → 生成一行锚点 JSONL（并打印 `ANCHOR_JSON=` 便于 automation 取用）
- `verify`：读锚点文件（可从云盘下载）+ 拉链头 → 判定，`ok:false` 时**退出码 2** + 醒目告警
- 走 CLI 而非自己实现连接（复用其多设备配置/证书钉住/daemon，避免又一份实现）
- 支持 `--head-file`：**离线也能验证判定链路**（本轮即用它做了 fixture 验证）

### ③ 云盘链路
- 建 `…/Project/NodeAgent/anchors/`（与全量备份分开目录）
- 每日 automation 更新为「拉链头 → 上传云盘（一天一个带日期的文件）→ 简报」，
  并规定每月首日额外做一次「下载历史锚点 → 链外比对」

## 验证
- **纯函数重构零行为变化**：原有 audit-anchor 单测 9/9 全绿；全仓 273 单测全绿；7 包构建
- **工具离线验证**（fixture）：一致 → 「与锚点完全一致」退出码 0；
  篡改 → 「链头哈希与锚点不一致」退出码 2；三个错误分支均给出明确提示
- 云盘：`anchors/` 目录创建成功（1/1 步），目录内容已复核
- ⚠️ 端到端（真拉链头 + 真上传）**待被控端上线**；脚本的 CLI 分支已做错误处理验证

2026-10-10 19:14:09 +08:00