mtfyun/nodeagent
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
226 Commits 1 Branch 14 Tags
5e32d7fa554b6071b59fca77cee2d66c06e3533e
Commit Graph
13 Commits
Author SHA1 Message Date
jkooe b9236dfaf1 chore(privacy): 公开仓库隐私脱敏 —— 清除可定位到个人与设备的字面量 
按 security-reports/ 的隐私审查台账逐项收口。纯脱敏与表述泛化，
不含任何业务逻辑变更；实测结论与排查步骤一字未动。

P1（可定位到具体设备/个人）
- scripts/verify-b2.mjs：NA_URL 去掉硬编码缺省值（原指向一台真实机器），改为必填。
  这是全仓库唯一「拿着就能连到某台真机」的常量。
- 测试账户名 pdverify → na-test（docs/VM-VERIFICATION.md 7 处、docs/console-plan.md 1 处）
- 虚拟机与宿主的真实网段 → RFC 5737 文档保留段 192.0.2.x（含 CLOSE_WAIT 记录）
- 跨项目名与私人称呼 → 中性表述（docs/PRD.md、docs/DEVELOPMENT.md、docs/console-plan.md 等）

P2（低风险设备指纹）
- 虚拟化产品及其 CLI / 访客工具名 → 中性表述（12 个文件 + 1 个工作流注释）
- 测试目录 C:\nodeagent-test → C:\na-test
- NAS 设备型号与系统名 → NAS 设备 / NAS 系统（docs/DEPLOY-LINUX.md、scripts/install-linux.sh、README.md）
- 真机 CPU 型号、真机物理分辨率、代理软件品牌与监听端口、杀软品牌 → 泛化
- 单元测试示例段去掉真机 IP 尾八位：acl-v11 / net-scripts 的 fixture 与断言同步更新
- .gitignore 补 config.json / agent.json（含真实密钥与节点地址，绝不入库）
- 顺带移除混入技术文档的「不构成投资建议」字样（与文档主题无关）

验证：pnpm test:unit 340/340 通过；独立扫描器对 235 个跟踪文件做 17 类模式
全量扫描，命中 0。
 2026-10-13 22:35:40 +08:00
jkooe ad569d4e6d ci: 控制台资源断言 2→3，并补 @nodeagent/agent 构建前置 
控制台随包分发的资源由 2 份增至 3 份（sidecar.mjs / node / agent.mjs）：
- rust.yml 的资源项断言同步改为 3，且不再只数个数 ——
  改为断言目标名确实包含 sidecar.mjs 与 agent.mjs、以及 node/node.exe 二者任一。
  只数个数的话，「三份但错了一份」照样过。

顺序依赖（本地验证发现不了的一类）：
prepare:node 现在还要 esbuild 打包被控端，故 @nodeagent/agent 的 dist 成为新的
前置产物。本地验证时 dist 早就在，会把这层依赖完全掩盖 —— 故在 steps 里显式写全
构建步骤，并加注释说明为什么顺序不能调。

rust.yml 的 paths 触发器补 scripts/lib/bundle-agent.mjs 与 apps/agent/**：
改这两处同样会让控制台打包结果变化，不触发就等于零覆盖。

windows-e2e.yml 同步：Windows 分支现在也覆盖 agent.mjs 的准备与解析。
 2026-10-11 11:42:14 +08:00
jkooe f558e3e7df chore(release): 交付物架构断言 + CHANGELOG 归置 v2.0.2 
已公开发布的 nodeagent-win-arm64.zip 内装的其实是 x64 的 node.exe
（两包内 node.exe 字节完全相同，PE Machine 均为 0x8664），该包在 ARM Windows 上
能启动、能 listen，却 TLS 握手不完成 —— 被控端实际不可用，而 macOS 侧 100% 复现不出。

- 新增 scripts/lib/zip-pe-arch.mjs：纯内置 zlib 手解 zip、读 PE 头判架构。
  不依赖 unzip / Expand-Archive（Windows runner 上没有 unzip）。
  含 CLI 自检入口，已注入故障实测会红（arm64 包去要 x64 期望 → 退出码 1）。
- release.mjs：生成资产前调用之，不符即中止发版 —— 拦在 tag/push 之前，
  是「交付物本身」的断言，与 pack.mjs 的「流程内部」断言分两层。
- windows-e2e.yml：把原先内联的 PowerShell 校验实现改为复用同一模块，
  消除两套实现各自漂移的可能。
- CHANGELOG：[未发布] 归入 v2.0.2。
 2026-10-11 10:17:30 +08:00
jkooe b2404291b0 fix(pack): arm64 包内实为 x64 node —— 缓存名不含架构 + 补 PE 架构断言 
release.mjs 先打 x64 时会把运行时缓存为 node-runtime.zip（该名不含架构），
随后打 arm64 时误判「已缓存」直接复用 → arm64 包内 node.exe 实为 x86-64
（两份公开包内 node.exe 字节完全相同，sha256 同为 fdddbf45…，PE Machine=0x8664）。
该包在 ARM Windows 上能启动、能 listen，但 TLS 握手不完成（控制端只见 E_TIMEOUT），
且 macOS 侧完全复现不出。

- pack.mjs: 缓存名改为 node-runtime-<arch>.zip（按架构隔离）
- pack.mjs: 解包后断言 node.exe 的 PE Machine 与 --arch 一致（防呆 C，已注入故障实测会红）
- ci: windows-e2e 补「双架构包 PE 架构校验」，直读最终 zip 内 node.exe 的 PE 头
      （此前 CI 只打 x64 且只验 x64，arm64 打包零覆盖 —— 该 bug 必然逃过 CI）
- docs: CHANGELOG 记录 ARM64 真机对照实测

真机实测（ARM64 Windows 虚拟机，同机同参对照）：
  arm64 → TLS 握手成功 + PSK + 51 项能力两端一致 + exec/审计全通
  x64   → E_TIMEOUT（复现「能 listen 但 TLS 握手不完成」）
 2026-10-11 09:42:32 +08:00
jkooe e816c1fd39 fix(ci): Windows 上补 sidecar:build —— 新加的步骤漏了前置产物 
本轮新增的「控制台 Node 运行时（Windows 分支）与自举验证」一步在真实 runner 上失败：
  ✗ 未找到 D:\a\nodeagent\nodeagent\apps\console\sidecar\dist\sidecar.mjs
根因：prepare-console.mjs 的前置检查要求 sidecar 已构建，而该步被排在了构建 sidecar 之前
（rust.yml 里恰好已有「构建 sidecar」在前，所以那边没暴露）。

教训（本地跑过 ≠ CI 跑得过，又一例）：本地验证时 sidecar/dist 早已存在，
把「步骤之间的产物依赖」这一层完全掩盖了。**新增 CI 步骤时，应逐条核对
「该步依赖的产物由哪一步生成、顺序是否确实在其后」，而不是在已有产物的本地环境里跑一遍就认为通过。**
 2026-10-11 09:00:09 +08:00
jkooe 8664ec2926 ci: 覆盖 Node 运行时准备与「产物自举」（Linux + Windows 双覆盖） 
新增 runtime 准备脚本后，两件事此前零覆盖：脚本本身在 Windows 上的分支、
以及「打包产物能不能真跑」。补上：

- rust.yml：prepare:node 真跑（验证脚本可用 + 产物自检）→ 断言注入片段声明两份资源
  → `verify-bundle --runtime` 真 spawn 运行时跑 sidecar 走一次 JSON-RPC。
  paths 触发加上 scripts/prepare-console.mjs。
  注：Linux 上不走 strip 分支（macOS 专属），故「strip 必须 adhoc 重签」由 macOS 本机实测覆盖。
- windows-e2e.yml：新增一步跑 prepare:node + verify-bundle --runtime —— 该脚本在 Windows
  上走的是「复制 node.exe、无 strip」的另一条分支，此前从未被真实 runner 验证过。
 2026-10-11 08:55:38 +08:00
jkooe d065242413 docs/ci: README 数字校正 + checkout 升 v5 
- README：统计口径已过期（43 能力 · **32** MCP 工具 · **114** 单测 · **26** E2E），
  校正为实测值：43 能力 · 38 MCP 工具 · 215 单测 · 30 E2E · 11 Rust 单测。
  另补「桌面控制台」小节（架构图、页面表、构建命令、平台门控说明）与构建步骤说明
  —— 新组件入库后不同步 README，读者会以为仓库里没有它。
- CI：actions/checkout@v4 → v5，消除 runner 上的 Node.js 20 弃用告警。
  仅升被标记的这一个；setup-node / pnpm-action 未被标记，不做未验证的连带升级。
 2026-10-07 10:18:52 +08:00
jkooe 6b2b3828a5 fix(ci): 产物包检查改为反向断言 —— 包内**不得**含 PSK.txt（原来是断言应该有） 
045e3b0 起 PSK.txt 已不再打进公开 zip（现生成给本机，打进公开资产=泄露密钥），
但 CI 的必含清单里还列着 PSK.txt → 每轮必红，且方向完全反了。
现在：必含 7 项 entries；并反向断言不含 PSK.txt / *.key / *.pem / certs ——
把「公开资产不带钥匙」这条性质变成 CI 守护项，而不是相反的束缚。
 2026-10-07 02:27:58 +08:00
jkooe 9ee75cf694 ci: 清理步骤加 continue-on-error（前置失败不应连带掩盖真实结论） 2026-10-07 02:15:05 +08:00
jkooe cd278ffda8 fix(ci): 5.1 执行的内联脚本一律 ASCII-only（同一个 BOM 坑，臣在 CI 步骤里原样复现） 
第二轮 CI 暴露：『install.ps1 安装链路』失败，报 string is missing the terminator。
根因不是被测脚本（BOM 守卫同轮通过），而是**步骤自身的 run: 块里有中文** ——
GitHub 把 run 块写成**无 BOM** 的临时 .ps1，5.1 按 GBK 读 → 中文乱码 → 引号边界崩。
这与 2026-10-04 install.ps1 无 BOM 导致的事故是同一机制，臣在 CI 里原样踩了一遍。

修正：
- 所有 shell: powershell（= 5.1）/ shell: cmd 步骤的内联脚本改为 ASCII-only
  （中文只留在步骤名，那是元数据不参与执行）
- BOM 守卫的 throw 消息也一并英文化（它上一轮是侥幸没过炸）
- 清理步骤加 continue-on-error，避免前置失败连带掩盖真实结论

保留：shell: pwsh 步骤的英文/中文不受影响（7+ 认 UTF-8 无 BOM）。
 2026-10-07 02:14:27 +08:00
jkooe 817ec3645b fix(ci): BOM 守卫步骤改用 shell: powershell（cmd 套 -Command 多行引号会全乱） 
第一轮 CI 暴露：该步骤自身写法错，不是脚本错。shell: cmd + powershell -Command "..."
带多行/内层引号，经 cmd 转义后变成：
  Missing closing '}' / '$errs' is not recognized / -and was unexpected
全是指 step 自身，与被测 .ps1 无关。

修正：直接用 shell: powershell（runner 上的 powershell 就是 5.1，正是要测的目标）+ run: | 块，
与旁边已通过的 install 冒烟步骤同一形态。
 2026-10-07 02:04:43 +08:00
jkooe af1cd39fdf ci: 补全 Windows 真机验证（单测步骤 + 5.1 BOM 守卫 + install.cmd 双击链路冒烟） 
三处改动都源自真机事故复盘：
1. **单测步骤**（并入 ci/workflow-unit-tests 分支 4d73d6e 的实质贡献 —— 该分支基于
   09-29 老 main，直接 merge 会回退上万行，故只取其提交内容手工并入）
2. **PowerShell 5.1 解析守卫**：install.ps1 无 BOM 时 5.1 按 GBK 解析 → 中文注释
   破坏字符串边界 → 整份脚本 ParseError（2026-10-04 真机踩过）。此前 CI 冒烟用
   pwsh（7+ 认无 BOM UTF-8）**所以 CI 绿、真机炸** —— 现在这道守卫只问一件事：
   5.1 能否读懂，而这就是真机的核心约束
3. **install.cmd / control.cmd 双击链路冒烟**：这是用户唯一的上手入口，
   编码或语法坏了只有真机 cmd.exe 能测出来

（workflow 作用域已于 2026-10-07 由皇上授权后推送）
 2026-10-07 01:55:14 +08:00
jkooe 9e357cf7cc Create windows-e2e.yml 2026-09-27 02:23:42 +08:00