 jkooe
|
cd774ae0a6
|
feat(E3c): Hub 侧按控制端授权（多令牌 + 按设备白/黑名单 + 注册准入）
## 背景
Hub 原先只有**一个**令牌：任何持有者都能接入任意设备，无法区分「谁在控制哪台机器」。
E3 的权限隔离因此只做到能力级（被控端 ACL），Hub 侧仍是全通。
## 实现（apps/hub/src/authz.ts，纯函数便于单测）
- 多令牌：每个令牌 = 一个控制端身份，可独立指定 allow_nodes / deny_nodes（glob）
- 判定顺序 deny -> allow -> 默认拒绝；未配置 allow_nodes 时默认放行（兼容）
- 顶层 token 视为主令牌（放行全部），旧配置零改动
- 前缀式滚动令牌：value 以 * 结尾时按前缀匹配（轮换期间可灰度）
- 注册准入：node_allowlist 非空时只有匹配的 node_id 能注册，防止他人借令牌挂靠节点
- 列表按身份过滤：控制端只看得到自己被授权的设备
- 越权接入返回新错误码 E_NODE_FORBIDDEN
## 职责边界（重要）
Hub 只做「能否连到某设备」的接入过滤；连上之后的**能力级**授权仍由被控端 ACL
按 client_id 裁决。两层各自独立，Hub 不参与能力决策 —— 保持 Hub 不可信假设。
## 测试
- 单测 79 -> 89（新增 Hub 授权 10 例：主令牌兼容 / 未知令牌 / 前缀轮换 /
deny 优先 / glob 白名单 / 默认放行 / 注册准入 / 旧配置兼容 / 列表过滤 / glob 转义）
- e2e：Hub 用例新增受限令牌访问未授权设备 -> 断言 E_NODE_FORBIDDEN 且错误信息含授权原因
|
2026-09-29 14:38:53 +08:00 |
|
|
jkooe
|
66c44f6822
|
feat(E3): Hub 并发多控制端 + 设备分组（阶段 E 全部完成）
## E3a 并发多控制端（Hub 槽位池）
过去：一个被控端只有一条 Hub 连接 -> 同时只能一个控制端（否则 E_NODE_BUSY）。
现在：
- Hub 侧 agents 表改为「node_id -> 槽位池」，每个槽位服务一个控制端：
有空闲槽位直接配对；不足且未达上限则向被控端请求扩容（need_slot，3s 超时）；
仍不满足才返回 E_NODE_BUSY。新增配置 max_slots_per_node（默认 3，设 1 即退回独占语义）
- 被控端侧 hub-mode 重写为槽位池：常备 2 条连接（warm_slots 可调），
并在某槽位被占用（收到 hello）时预热下一条直到 max_slots
—— 复用既有协议信号，不新增控制消息；每条槽位独立重连与退避
- Hub 列表视图聚合为「一节点一行」并带 slots / paired_slots
- e2e 新增并发用例：两个控制端同时握手 + 交替并发调用，均成功（旧版会失败）
## E3b 设备分组
- 客户端配置新增 groups（组名 -> 设备名数组；成员可写 @其它组名，最多展开 3 层防环）
- CLI：nodeagent group add|remove|list；fanout --nodes @组名 按组并发下发
- 真机验证：group add 本机 win -> fanout system.info --nodes @本机 正常
## E3c 权限隔离（部分完成）
- 能力级隔离沿用被控端 ACL（按 client_id，已含 allow/deny/glob/生效时段/IP 白黑名单/按能力限速）
- Hub 侧「按设备/按控制端授权」尚未实现（当前 Hub 视角为单一令牌），已记入路线图待办
## 测试
- 单测 73 -> 79（新增设备分组 6 例：展开 / 嵌套 / 去重 / 未知 / 兼容旧配置 / 环引用收敛）
- e2e 21/21（含扩展后的 Hub 并发双控制端用例）
|
2026-09-29 14:33:01 +08:00 |
|
|
jkooe
|
3d03945448
|
feat(v6): Hub 中转 —— 跨网段 / 公网接入
新增 apps/hub（中转节点）：
- 被控端主动外连注册（/hub/agent），控制端接入配对（/hub/client）
- 配对后双向字节透传 —— Hub 不解析内容、不持有设备密钥
- Hub 令牌鉴权；list 可查在线设备
- 连接语义：控制端断开仅解绑（被控端保持在线）；被控端掉线连带关闭控制端
- 同一被控端同一时刻仅服务一个控制端（占用返回 E_NODE_BUSY）
被控端：
- 新增 hub 配置；启用后不监听本地端口，改为主动外连 Hub（穿 NAT）+ 指数退避重连
- 重构抽出 createAgentCore()，监听模式与 Hub 模式共用同一套鉴权/ACL/能力分发
控制端：
- NodeProfile 新增 hub 字段；toWsUrl 自动附 /hub/client 路径
- client 支持 Hub 配对（控制面消息与 RPC 分离）
修复（Hub 场景暴露）：
- cmdConnect 漏传 hub 字段，导致跳过配对直接发 RPC
- Hub unpair 过激进：控制端断开时把被控端也踢下线
- 安全：被控端 hello 时重置认证态与授权（Hub 下同一连接被多控制端复用）
验证：本地 E2E 21/21；构建 + 类型检查全绿；冒烟确认 info/exec 穿透 Hub 且多次接入保持在线
|
2026-09-27 15:04:05 +08:00 |
|
|
jkooe
|
4ff1b4fd90
|
feat(v5): 多设备管理 + 文件传输
方向 1 · 多设备管理：
- 配置模型升级为 nodes{} + current，自动迁移 v1/v2 单设备扁平配置（零破坏）
- 新增 resolveTarget()：按名解析生效设备与控制端身份
- CLI: nodes（列表）/ use（切换）/ remove（移除）/ connect --name（命名）
- 全局 --node <设备名> 单次指定目标，前置（--node=x cmd）与后置（cmd --node x）均可
方向 2 · 文件传输（分块 RPC，协议零改动）：
- fs.list（递归+glob）/ fs.stat / fs.read（offset+max_bytes 分块）/ fs.write（原子写+append）
- 小文件（<=8MB）首次读取附带 sha256；路径白名单 fs_roots，越界 -> E_ACL_DENIED
- CLI: ls / stat / cat / pull / push（自动分块；pull 与 push 均原子落盘）
- MCP: na_fs_list / na_fs_read / na_fs_write
能力总数 15 -> 19；MCP 工具 12 -> 15
验证：本地 E2E 20/20（新增文件传输全链路用例）；构建 + 类型检查全绿；
冒烟确认 3MB 文件 pull 后 sha256 一致、白名单越界被拒
|
2026-09-27 13:25:38 +08:00 |
|
|
jkooe
|
3d0eb1c696
|
feat(v4): 无感体验 —— 局域网自动发现 + 断线自动重连
自动发现（免手抄 IP）：
- 被控端 UDP 心跳广播（默认 5s 一次，目标 255.255.255.255:8766）
- 控制端 Discovery 监听 + TTL 设备表（默认 30s 过期）
- 报文不含任何凭据；可 discovery.enabled:false 关闭
- 控制端取「报文来源 IP」作为可达地址（比被控端自报地址可靠）
- CLI: nodeagent discover [--wait 5]；MCP: na_discover
断线自动重连：
- client 新增 autoReconnect（指数退避 1s→30s + ±15% 抖动）
- 重连前清空在途请求（统一 E_NODE_OFFLINE），避免悬挂
- onStateChange 回调（connected/reconnecting/closed）
- close() 会停止重连，不会关不掉
修复：UDP socket 需先 bind 再 setBroadcast（未绑定时报 EBADF）
验证：本地 E2E 19/19（新增发现 + 重连两用例）；构建与类型检查全绿
|
2026-09-27 13:11:13 +08:00 |
|
|
jkooe
|
edc69b0a34
|
feat(v3+): 审计日志 + 调用限速
审计（安全闭环最后一环）：
- 被控端将关键动作以 JSONL 写入 <数据目录>/audit.log：agent 启停 / 认证成败 /
invoke 结果 / ACL 拒绝 / 限速拦截
- 大小轮转（默认 10MB × 5 份）；参数默认只记 sha256 摘要，log_args 开启后
自动脱敏（pass/token/secret/key/auth 键 → ***，字符串截断 200 字符）
- 审计写入失败被吞掉，绝不阻断业务主流程
- 新增能力 system.audit.list（支持 limit/since/client_id/type 筛选）
- CLI: nodeagent audit；MCP: na_audit
限速：
- 落地 ACL 中预留的 max_calls_per_min（按调用方滑动窗口计数）
- 超限返回 E_RATE_LIMITED(-32407)
验证：本地 E2E 全绿；零信任用例扩展为 6 项断言（授权/拒绝/审计留痕/脱敏/限速/未注册/错钥）
|
2026-09-27 11:56:37 +08:00 |
|
|
jkooe
|
5b7e967868
|
feat(v3): 零信任安全 —— Ed25519 身份认证 + 能力级 ACL
认证（两模式并存，默认 psk 向后兼容）：
- 新增 auth_mode: psk | ed25519
- ed25519：每控制端独立密钥对，挑战-应答签名验证（替代共享密钥）
- 密钥用 Node 内置 crypto 生成（零新依赖），Base64(DER) 单行格式
- 私钥存 <数据目录>/keys/ed25519.json（600 权限，永不外传）
授权（能力级 ACL）：
- acl.clients[] 按调用方登记 pubkey + allow/deny（glob 匹配）
- 判定顺序 deny → allow → default_effect（默认拒绝）
- 未注册身份 / 验签失败 → 握手拒绝；未授权能力 → E_ACL_DENIED
- auth_ok 下发 authorized 子集，CLI 以 授权/未授权 标识展示授权矩阵
接入：
- CLI: keygen（生成密钥 + 打印 ACL 配置片段）、connect --auth-mode ed25519
- MCP: 按 auth_mode 自动选择认证方式
- install.ps1: 显式写 auth_mode + 零信任指引
验证：本地 E2E 17/17（新增零信任四项断言）；手动端到端复验通过
|
2026-09-27 11:01:58 +08:00 |
|
|
jkooe
|
792937c6b0
|
feat(v2): 图形接管 —— 屏幕感知 + 输入控制
新增 7 项能力（总计 14）：
- screen.info / screen.capture：显示器信息、截屏（region/scale/format）
- input.mouse.move/click/scroll、input.key.type/press：鼠标键盘控制
安全设计：
- input.* 为高危能力，由被控端 allow_input 开关统一管控，默认禁用
- 未开启时返回 E_CAPABILITY_DISABLED（附开启指引）
- 文本输入经 Base64 传参、PowerShell 侧解码，杜绝内容注入
- 按键名走白名单映射（虚拟键码），非法键名直接拒绝
实现：纯 PowerShell（System.Drawing 截屏 + user32.dll SendInput），
无原生编译、无第三方依赖。
接入：
- CLI: screen / screenshot / mouse / key 命令
- MCP: na_screenshot（直接返回图像）/ na_mouse / na_key
- install.ps1: 新增 -AllowInput 开关
- verify.mjs: 新增 v2.1~v2.3 验收项
验证：本地 E2E 16/16；远程验收 12 通过 / 0 失败
|
2026-09-27 03:43:10 +08:00 |
|
|
jkooe
|
553d123033
|
fix(agent): 修复 TLS 未生效的严重 bug（自称 wss 实为明文）
根因：ws 库的 WebSocketServer 不识别 cert/key 选项，直接传入会被静默忽略，
导致被控端配置 tls=true 时仍以明文监听；控制端用 wss 连接即报
'tls_validate_record_header:wrong version number'。
修复：TLS 由 https.createServer({cert,key}) 承载，再挂 WebSocketServer({server})。
验证：新增 TLS 模式 E2E 用例（先本地复现失败，修复后通过），本地 14/14 全绿。
该 bug 由 CI 真机验证（Windows 上 CLI 连入步骤失败）暴露。
|
2026-09-27 02:45:58 +08:00 |
|
|
jkooe
|
96b02df857
|
fix(e2e): 修复 Windows 上被控端无法就绪的根因
根因：测试脚本用 HOME 指定数据目录，但 Windows 的 os.homedir() 认 USERPROFILE，
导致被控端读不到测试配置、回落到默认端口 8765，与测试连接的 18765 不匹配。
- 引入 NODEAGENT_HOME（数据目录，跨平台一致），agent/client 均优先读取
- 两个 E2E 脚本改用 NODEAGENT_HOME，并同时设置 HOME/USERPROFILE 兜底
- 转发被控端 stdout/stderr，被控端提前退出时立即失败（便于定位）
- 就绪等待超时 15s → 30s
本地已回归：13/13 通过
|
2026-09-27 02:36:33 +08:00 |
|
|
jkooe
|
f1506b3fd0
|
test: 新增自动化真机验证体系
- tests/e2e/windows.mjs: Windows 专属能力测试（service.list / app.list / winget 装软件 / cmd 外壳）
- tests/e2e/run.mjs: service.list 断言改为平台感知（Windows 期望成功）
- scripts/verify.mjs: 远程验收脚本，对齐 PRD FR-01~FR-08 逐条验收 + Markdown 报告
- package.json: 新增 test:windows / verify 脚本
- README: 补充自动化真机验证三层体系说明
注: .github/workflows/windows-e2e.yml 需 workflow scope，待授权后单独提交
|
2026-09-27 01:24:52 +08:00 |
|
|
jkooe
|
77c024703a
|
feat: nodeagent v1 初期开发完成
- packages/protocol: 协议定义（信封/方法/错误码/能力schema/校验/HMAC/ULID）
- packages/client: 控制端客户端库（连接/握手/invoke/超时）
- apps/agent: Windows 被控端（监听/HMAC认证/能力分发/7项能力/进程执行）
- apps/cli: 控制端 CLI（connect/info/status/ps/services/exec/apps/install/list/invoke）
- apps/mcp: MCP server（na_* 工具，接入 WorkBuddy）
- scripts: install.ps1 / uninstall.ps1（开机自启 + 防火墙 + 密钥生成）
- tests/e2e: 端到端测试 13/13 通过（握手/能力/超时强杀/参数校验/鉴权失败/未认证）
|
2026-09-27 01:06:35 +08:00 |
|