 jkooe
|
00992e5c1c
|
feat(linux): Linux 被控端适配 —— 安装器 + systemd 自启 + 平台守卫 + 部署文档
面向「服务器型被控端」（命令/状态/文件/审计；无 GUI），实测环境 Debian 12（fnOS 底座）。
## 新增
- `scripts/install-linux.sh`：一键安装器（对齐 Windows `install.ps1` 的语义）
· 自动获取 Node 运行时（系统无 Node 22+ 时下载 linux-<arch>，走 npmmirror）
· **systemd 服务**（系统级 / 用户级+linger / `--no-service` 三种模式），开机自启
· 幂等：复用既有密钥（并自动备份 agent.json）；卸载保留配置（`--purge` 才删）
· `--node-id/--port/--allow-input` 等参数；缺 `ip`/`ifconfig` 时 IP 展示多级回退
- `apps/agent/src/util/platform.ts`：**统一平台守卫**
· `assertPlatform(cap, ...allowed)` / `assertGuiPlatform` / `assertWindows`
· 抛 `E_UNSUPPORTED_PLATFORM` 并带上「支持哪些平台」，让"未实现"不再伪装成"参数错/环境缺依赖"
- `docs/DEPLOY-LINUX.md`：部署指南 + **实测能力清单** + 故障排查表
## 修改
- `screen.ts` / `record.ts` / `clipboard.ts` / `audio.ts` / `input.ts`：入口接入平台守卫。
修复前的表现是**误导性错误**（`screen.capture` 在 Linux 上报 `region 宽高必须 ≥ 1`，
像是参数没传对），现在是 `screen.capture 未在 Linux 上实现（仅支持 Windows / macOS）`。
- `scripts/verify.mjs`：v2.1 / v2.3 补 `E_UNSUPPORTED_PLATFORM → skip`
（v2.2 早已处理；此前把"平台不支持"记成失败）
- `README.md`：文档区链入 DEPLOY-LINUX
## 实测（Docker · Debian 12）
- 安装流程端到端：装文件 → 写配置(600) → 提取密钥 → 启动监听 → **幂等复装密钥不变** ✓
- 验收：**9 通过 / 1 失败 / 6 跳过**（对比 macOS 15/0/1）
· 1 失败 = 容器缺 `procps`（`process.list` 返回空），非代码问题；NAS 自带该包
· 6 跳过 = GUI 类能力（平台诚实拒绝）
- 单元测试 325 全绿；7 包构建通过
## 途中修正的三个"差点误判"
1. **Alpine 误判**：`spawn /bin/bash ENOENT` 是**镜像没 bash**，不是 Linux 不支持
2. **`set -e` 静默退出**：`LAN_IP=$(ip ...)` 在无 `ip` 的环境失败会**直接终止脚本**
（`2>/dev/null` 把原因吞了，表现为"跑到一半就没了"）→ 已改多级回退
3. **slim 镜像缺 procps** → `process.list` 空列表，被误读为"Linux 特性"
|
2026-10-13 21:15:59 +08:00 |
|
|
jkooe
|
f4c605cc6d
|
test+fix: 单元测试套件 + 两处细节修复
单元测试（新增，node:test 零依赖）：
- tests/unit/: ulid / hmac / ed25519 / acl / validate 共 26 项用例
- 覆盖最关键的安全函数：签名验签、ACL 授权、参数校验
- 新增 pnpm test:unit；CI 增加单元测试步骤
细节修复：
1. screen.info 的 scale 硬编码为 1 → 改读注册表 HKCU AppliedDPI，
真实反映 Windows DPI 缩放（100% -> 1.0, 150% -> 1.5）
2. verify.mjs 升级：支持多设备配置（resolveTarget）+ ed25519 模式 + Hub 中转
（此前直接用旧的扁平配置 + 仅 psk，配了多设备会取不到 host）
验证：构建 + 类型检查全绿；单元 26/26；E2E 21/21；verify.mjs 13/0/3
|
2026-09-27 17:04:21 +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
|
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 |
|