nodeagent

126 Commits 1 Branch 14 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
jkooe	277c5f1ba5	feat(v1.6.1): gui.await 补齐单测与 CLI/MCP 入口；源码注释脱敏；gitignore 补密钥规则 ## ① gui.await 补齐（路线图 §1 收尾清单第 2、3 项）此前该能力只有实现、单测 0 覆盖、CLI/MCP 0 入口： - 新增 tests/unit/gui-await.test.mjs（6 例）：能力登记与风险等级、四类条件 × 两态 schema、timeout 上限兜底、isHit 对五种返回形态的判定契约、 CLI/MCP 入口存在性 - CLI：`nodeagent await --condition <window\|control\|process\|file> [--text/--title/ --process/--path] [--state absent] [--timeout ms]`，回显 satisfied/耗时/轮询次数/末次异常 - MCP：新增 na_await 工具（定义 + 分发），描述含典型编排示例 ## ② 源码注释脱敏（路线图序 0.5 / §4.0） input.ts 与 input-script.ts 里 4 处真实播放器名 / 游戏名泛化为「主流媒体播放器」「全屏独占应用」「部分播放器会创建数十个辅助窗口」—— 不再画像「哪台机器装了什么、常在什么场景下远程控它」。grep 复核零残留。 ## ③ .gitignore 补密钥规则（路线图 §6.2）此前只挡 PSK.txt，挡不住 keys/（ed25519 私钥）与 .key / .pem（TLS 私钥） —— 一旦误 add 就是私钥入公开库。.pub 显式放行。 ## 验证单测 215 → 221（+6 全绿）；e2e 30* 全绿；7 包构建通过； CLI await 实测到连接层（被控端当前离线，超时属预期）。	2026-10-07 20:31:36 +08:00
jkooe	689bb8c98d	feat(v1.5): 快捷键控制范围扩展 —— 字符串热键 / 预设别名 / 长按 / 后台定向投递 ## 背景原 `input.key.press` 只接受数组和弦（keys/sequence），按键表也不全： AI/MCP 调用要拼 ["ctrl","shift","esc"]，且 win+d、ctrl++、win+. 这类 "修饰键 + OEM 符号键"的组合根本打不出来（表里没有符号键）。 ## 四类扩展 ① 字符串热键：`hotkey: "ctrl+shift+esc"`、`hotkeys: ["ctrl+c","ctrl+v"]` —— 分隔符支持 `+ - 空格`，大小写不敏感，别名归一（command/cmd→win、del→delete…） ② 预设别名：约 50 个语义名（copy / show_desktop / task_manager / screenshot / volume_mute_toggle…），AI 调用免记键位；`preset` 与 `presets`（序列）均支持 ③ 长按 `hold_ms`（≤5s）：按下→保持→释放，插在"按完"与"释放"之间 ④ 后台定向投递 `route=post` + `target_pid`：向目标进程全部顶层窗口 PostMessage WM_KEYDOWN/UP —— 目标窗口被遮挡/最小化时可用（媒体键的 WM_APPCOMMAND 机制早已验证，此为其等价物）文档明示局限：游戏/部分输入型程序不响应后台键消息 ## 按键表补齐（单测覆盖断言防漂移） - 左右侧修饰键 lctrl/rctrl/lshift/rshift/lalt/ralt/lwin/rwin（游戏常区分左右） - 小键盘 numpad0-9 + 四则运算，与数字键分开（Excel 靠 NumLock 区分） - OEM 符号键 oem_1..oem_8 / oem_minus/plus/comma/period（解锁 win+d、ctrl++、win+.） - 浏览器收藏夹/主页、系统键（sleep/help/select/execute/clear/separator/oem_clear） - IME 键（kana/hangul/kanji/hanja/convert/nonconvert/accept/modechange） - 补齐 pause/apps（重构时一度漏掉，被覆盖断言测试立刻抓到） ## 可测性重构脚本生成抽成纯函数 `apps/agent/src/capabilities/input-script.ts` （VK_MAP / MEDIA_COMMANDS / toVk / build{Media,Foreground,Post}Body），行内生成逻辑全部改为调用 —— 于是按下顺序/逆序释放/hold 插入位置/post 路由这些最容易写错的部分，现在由 14 个单测逐行断言，真机只需验证最终效果。 ## 参数校验 protocol `expandChords()` 统一展开六种输入形式，混用即报错（消除"以谁为准"歧义）；同一和弦重复修饰键、超 4 键、空输入均拒绝。渲染返回值新增 presets/via/channel/sent_windows。 ## CLI / MCP - CLI：`nodeagent key press "ctrl+shift+esc"` / `key press copy` / 老形式 `key press ctrl c` 新增 `--hold`、`--route`；回显预设展开与后台投递命中窗口数 - MCP `na_key`：同步支持 hotkey/hotkeys/preset/presets/hold_ms/route/target_pid ## 验证 - 单测 179 → 195：hotkeys 解析与别名 17 例、脚本生成逐行断言 14 例、按键覆盖断言（HOTKEY_KEYS ⊆ VK_MAP）、新参数 schema 校验 2 例 - e2e 29 全绿 - ⚠️ 真机未验证：Windows 被控端当前离线（连接超时）。待上线后需验： `key press "win+d"`（切桌面再切回）、`key press copy` 配剪贴板、 `route=post` 定向一个最小化窗口。验证通过后再发版。	2026-10-07 00:59:40 +08:00

Author

SHA1

Message

Date

jkooe

277c5f1ba5

feat(v1.6.1): gui.await 补齐单测与 CLI/MCP 入口；源码注释脱敏；gitignore 补密钥规则

## ① gui.await 补齐（路线图 §1 收尾清单第 2、3 项）
此前该能力只有实现、**单测 0 覆盖、CLI/MCP 0 入口**：
- 新增 tests/unit/gui-await.test.mjs（6 例）：能力登记与风险等级、四类条件 ×
  两态 schema、timeout 上限兜底、isHit 对五种返回形态的判定契约、
  CLI/MCP 入口存在性
- CLI：`nodeagent await --condition <window|control|process|file> [--text/--title/
  --process/--path] [--state absent] [--timeout ms]`，回显 satisfied/耗时/轮询次数/末次异常
- MCP：新增 na_await 工具（定义 + 分发），描述含典型编排示例

## ② 源码注释脱敏（路线图序 0.5 / §4.0）
input.ts 与 input-script.ts 里 4 处真实播放器名 / 游戏名泛化为
「主流媒体播放器」「全屏独占应用」「部分播放器会创建数十个辅助窗口」——
不再画像「哪台机器装了什么、常在什么场景下远程控它」。grep 复核零残留。

## ③ .gitignore 补密钥规则（路线图 §6.2）
此前只挡 PSK.txt，挡不住 keys/（ed25519 私钥）与 *.key / *.pem（TLS 私钥）
—— 一旦误 add 就是私钥入公开库。*.pub 显式放行。

## 验证
单测 215 → **221**（+6 全绿）；e2e **30** 全绿；7 包构建通过；
CLI await 实测到连接层（被控端当前离线，超时属预期）。

2026-10-07 20:31:36 +08:00

jkooe

689bb8c98d

feat(v1.5): 快捷键控制范围扩展 —— 字符串热键 / 预设别名 / 长按 / 后台定向投递

## 背景
原 `input.key.press` 只接受数组和弦（keys/sequence），按键表也不全：
AI/MCP 调用要拼 ["ctrl","shift","esc"]，且 **win+d、ctrl++、win+. 这类
"修饰键 + OEM 符号键"的组合根本打不出来**（表里没有符号键）。

## 四类扩展
① **字符串热键**：`hotkey: "ctrl+shift+esc"`、`hotkeys: ["ctrl+c","ctrl+v"]`
   —— 分隔符支持 `+ - 空格`，大小写不敏感，别名归一（command/cmd→win、del→delete…）
② **预设别名**：约 50 个语义名（copy / show_desktop / task_manager / screenshot /
   volume_mute_toggle…），AI 调用免记键位；`preset` 与 `presets`（序列）均支持
③ **长按** `hold_ms`（≤5s）：按下→保持→释放，插在"按完"与"释放"之间
④ **后台定向投递** `route=post` + `target_pid`：向目标进程**全部顶层窗口**
   PostMessage WM_KEYDOWN/UP —— 目标窗口被遮挡/最小化时可用
   （媒体键的 WM_APPCOMMAND 机制早已验证，此为其等价物）
   文档明示局限：游戏/部分输入型程序不响应后台键消息

## 按键表补齐（单测覆盖断言防漂移）
- 左右侧修饰键 lctrl/rctrl/lshift/rshift/lalt/ralt/lwin/rwin（游戏常区分左右）
- 小键盘 numpad0-9 + 四则运算，**与数字键分开**（Excel 靠 NumLock 区分）
- OEM 符号键 oem_1..oem_8 / oem_minus/plus/comma/period（解锁 win+d、ctrl++、win+.）
- 浏览器收藏夹/主页、系统键（sleep/help/select/execute/clear/separator/oem_clear）
- IME 键（kana/hangul/kanji/hanja/convert/nonconvert/accept/modechange）
- 补齐 pause/apps（重构时一度漏掉，被覆盖断言测试立刻抓到）

## 可测性重构
脚本生成抽成**纯函数** `apps/agent/src/capabilities/input-script.ts`
（VK_MAP / MEDIA_COMMANDS / toVk / build{Media,Foreground,Post}Body），
行内生成逻辑全部改为调用 —— 于是**按下顺序/逆序释放/hold 插入位置/post 路由**
这些最容易写错的部分，现在由 14 个单测逐行断言，真机只需验证最终效果。

## 参数校验
protocol `expandChords()` 统一展开六种输入形式，**混用即报错**（消除"以谁为准"歧义）；
同一和弦重复修饰键、超 4 键、空输入均拒绝。渲染返回值新增 presets/via/channel/sent_windows。

## CLI / MCP
- CLI：`nodeagent key press "ctrl+shift+esc"` / `key press copy` / 老形式 `key press ctrl c`
  新增 `--hold`、`--route`；回显预设展开与后台投递命中窗口数
- MCP `na_key`：同步支持 hotkey/hotkeys/preset/presets/hold_ms/route/target_pid

## 验证
- 单测 **179 → 195**：hotkeys 解析与别名 17 例、**脚本生成逐行断言 14 例**、
  按键覆盖断言（HOTKEY_KEYS ⊆ VK_MAP）、新参数 schema 校验 2 例
- e2e **29** 全绿
- ⚠️ **真机未验证**：Windows 被控端当前离线（连接超时）。待上线后需验：
  `key press "win+d"`（切桌面再切回）、`key press copy` 配剪贴板、
  `route=post` 定向一个最小化窗口。验证通过后再发版。

2026-10-07 00:59:40 +08:00