 jkooe
|
11127b1a89
|
chore(privacy): 杀软实名与网卡名示例泛化（安全报告第十三轮 P2 两项）
## 甲1 杀软实名泛化（6 行）
`主流杀软 / 杀软 / 360` → 「主流杀毒软件 / 杀软」：
- docs/REMOTE-LIMITS.md：标题 + 正文 + 表格两处（保留"会拦什么"的实操信息，去掉具体厂牌）
- scripts/release.mjs:278：Release 正文模板里的信任区提示
- apps/cli/src/cmd/ops.ts:398：部署失败排查提示
## 甲2 网卡名示例泛化（13 行）
「Ethernet」→ `Ethernet`（示例）／泛化为"中文网卡名"（讲原理时）：
- docs/REMOTE-LIMITS.md 网络适配器表格、ROADMAP 该项标记为已完成
- scripts/rescue-network.ps1 参数说明、automation.ts 的 interface 描述
- apps/agent/src/capabilities/network.ts 注释：改为"脚本里的非 ASCII 字符（如中文网卡名）"
—— **保留"为什么"的教训，去掉具体实况**
- tests/unit/net-scripts.test.mjs：8 处测试数据与正则断言同步改为 Ethernet
## 验证
工作区残留「主流杀软/杀软/Ethernet」= **0 处**；单测 273 全绿；7 包构建通过。
|
2026-10-10 12:26:41 +08:00 |
|
|
jkooe
|
2cb0ed148e
|
chore(privacy): 源码与测试里的真机常量脱敏（机器名 / 真机内网 IP）
路线图 §七 序 7「源码真机常量注入化」的脱敏部分。
## 改了什么
- apps/agent/src/capabilities/network.ts：注释里的真机机器名 → 泛化为「机器名+纯数字」
（保留"为什么不能拼 USERDOMAIN/USERNAME"这个教训本身，去掉具体机器名）
- scripts/rescue-network.ps1：.EXAMPLE 里的真机内网地址 → 文档示例段 192.168.1.100；
网卡名示例由中文默认名改为 'Ethernet'（既避免像真机、又更通用）
- packages/protocol/src/acl.ts：注释里的真机 Mac 地址 → 192.168.1.100
- tests/unit×4：测试数据里的真机 IP 统一换成 192.168.1.x 示例段
## 过程中的两个教训（都记在代码注释里了）
1. **正则转义形态漏替换**：断言里写的是 `192\.168\.0\.88`（转义点），第一轮只替换了
裸形态 `192.168.0.`，导致脚本值变了、断言没变 → 3 个测试红。
2. **机械替换会破坏「跨网段」这类语义测试**：acl 的 `/24 网段匹配` 用例里有一条
本意是「**不同网段不匹配**」，替换后两侧变成同段 → 断言必红。已改回不同网段
并在注释里标注原因，防止下次再被批量替换破坏。
## 验证
单测 269 全绿（复跑）；e2e 30 全绿。
|
2026-10-10 00:39:28 +08:00 |
|
|
jkooe
|
e95a0248da
|
feat(v19): 拉取式自更新 system.agent.update（42 项）—— 回答「能否直接用 GitHub 做更新服务器」
## 结论：能，而且这是「控制端与被控端不可达」场景的正解
`deploy`（推送式）要求两者可达；本能力只要求**被控端能上网**，因此跨网段/NAT/异地都能更新。
GitHub Release / raw / 自建镜像 / 任意 http(s) 地址均可 —— 地址是参数，不写死。
## 实现（apps/agent/src/capabilities/selfupdate.ts）
下载 → **校验 sha256** → 备份 → **原子替换**（同目录 rename）→ 受控重启（复用 v7）→ CLI 复核指纹
- 出口：CLI `nodeagent update --url <u> --sha256 <h> [--dry-run]` · MCP `na_agent_update`
- 审计新增 `agent.update` 事件（记录 url / 前后指纹 / 字节数 / 备份路径）
## 安全底线（否则等于开放远程代码执行）
1. **sha256 必填**，且逐字节校验通过才替换；不符即丢弃并明确报错（未改动任何文件）
2. 只接受 http/https，拒绝 file:// 等其它 scheme
3. 大小上限 64MB + 下载超时（默认 120s）
4. **先备份再原子替换**，失败可回滚（返回 backup_path）
5. `dry_run` 只下载校验、不动文件 —— 用于「先确认能不能更」
6. 不用 fetch 的内置代理（Node 未暴露 undici）：国内访问 GitHub 不稳时，
把 url 指向**自建镜像/加速地址**即可，能力本身接受任意 http(s)
## 真机/本地验证（全程真跑，非纸面）
- e2e 新增：本地 HTTP 服务真跑下载 —— 正确哈希通过 / **错误哈希被拒** / 404 明确报错 /
非 http(s) scheme 被拒 / 缺 sha256 协议层拒绝 ✓
- 完整流程本地实测：`dry-run 预检` → `真更新`（966KB）→ 备份逐字节一致 → 重启 →
**复核到新指纹** → 能力 42 项 ✓
- 顺带修：返回值漏 `incoming_hash` 导致 CLI 复核被跳过（真机踩过）
- 单测 126 / e2e 28 全绿
## 已知约束（写进文档）
1. **首次仍要一次性安装**（install.ps1）—— 自更新能力本身得先在机器上，鸡生蛋无解
2. `node.exe`（Node 运行时）不在自更新范围，只换 agent.mjs
|
2026-10-04 23:03:37 +08:00 |
|
|
jkooe
|
9ef8978b92
|
feat(scripts): 网络救援脚本 rescue-network.ps1（网络变更失联后的本地恢复）
## 为什么需要它
`system.net.apply` 是两阶段提交（未确认自动回滚），但**万一回滚本身也失败**
（本次真机事故就是：变更脚本把地址删了却没加上），机器会落到 APIPA(169.254.x.x) 而彻底失联。
那时远程已无路可走，只能本地恢复 —— 这个脚本就是为那一天准备的。
## 能力
- `-ListOnly`：先看清各网卡状态/地址/默认路由（含「已连接但无地址」的失联特征标注）
- 自动识别失联网卡（已连接但无有效 IPv4），也可 -Interface 指定
- 带 -Ip/-PrefixLength/-Gateway/-Dns 恢复静态；不带 -Ip 则切回 DHCP
- **安全顺序**（与 agent 内实现一致）：先加新地址 → 清旧地址与残留默认路由 → 补默认路由
- 自检并给出下一步命令（含可直接复制的 Mac 侧 connect 命令）
## 用法
powershell -ExecutionPolicy Bypass -File rescue-network.ps1 -ListOnly
powershell -ExecutionPolicy Bypass -File rescue-network.ps1 -Interface 'Ethernet' `
-Ip 192.168.1.100 -PrefixLength 24 -Gateway 192.168.0.1
powershell -ExecutionPolicy Bypass -File rescue-network.ps1 -Interface 'Ethernet' # 切回 DHCP
|
2026-09-30 11:10:23 +08:00 |
|