Whuanle Easytouch Easytouch

EasyTouch Skills

1. 环境要求

• Node.js >= 18（npm 安装场景）
• 或直接使用编译产物：
  • Windows: zig-out/bin/et.exe
  • Linux/macOS: zig-out/bin/et
• 建议系统：Windows（能力最完整）

2. 安装方式

npm 安装

# 推荐：自动匹配当前平台
npm install -g @whuanle/easytouch

# Windows
npm install -g easytouch-windows

# Linux
npm install -g easytouch-linux

# macOS
npm install -g easytouch-macos

安装后直接使用：

et help

仓库内构建

zig build

3. CLI 命令

核心命令

• et help
• et status
• et platforms
• et interfaces
• et requirements
• et mcp-stdio
• et mcp-stdio --output json

自动化命令

• system os-info
• system cpu-info
• system memory-info
• system disk-list
• system process-list
• system hardware-info
• system network-info
• mouse position
• mouse move --x --y [--duration-ms ] [--jitter-px ] [--step-delay-ms ]
• mouse click [--button <left|right|middle>] [--count ]
• mouse scroll --delta
• window list [--include-hidden] [--pid ]
• window foreground
• window find --title [--match <contains|exact>] [--include-hidden] [--pid ]
• window activate --handle
• window close --handle
• app launch --target
• clipboard get-text
• clipboard set-text --text
• clipboard get-files
• clipboard set-files --paths <path1;path2;...>
• clipboard set-image --path
• keyboard key --key
• keyboard hotkey --keys
• keyboard type --text
• keyboard type-keys --text [--key-delay-ms ]
• keyboard ime-switch [--strategy <win-space|alt-shift|ctrl-shift>]
• keyboard caps-lock [--state <toggle|on|off>]
• keyboard paste [--expect-title ] [--match <contains|exact>]
• screen displays
• screen pixel-color --x --y
• screen capture [--path ]
• wait window --title [--timeout-ms ] [--match <contains|exact>] [--foreground-only]
• wait focus --title [--timeout-ms ] [--match <contains|exact>]
• wait activate --handle [--expect-active <true|false>] [--timeout-ms ]
• wait pixel --x --y --hex [--timeout-ms ]
• wait clipboard [--expect-text ] [--timeout-ms ] [--match <contains|exact>]
• wait process [--name |--pid ] [--expect-running <true|false>] [--timeout-ms ] [--match <contains|exact>]

等待器说明：

• wait 系列用于“动作后确认状态”，避免页面/窗口未就绪就继续执行下一步。
• 典型场景：点击后等待窗口出现、切换后等待焦点、输入后等待像素或剪贴板变化、启动后等待进程状态。

4. MCP 接入

查看工具清单（manifest）

et mcp-stdio --output json

启动 MCP stdio 服务

et mcp-stdio

配置示例

{
	"mcpServers": {
		"easytouch": {
			"command": "et",
			"args": ["mcp-stdio"]
		}
	}
}

5. 注意事项

• 推荐流程：观察 -> 动作 -> 等待确认
• 不要连续盲操作（点击/输入后必须确认）
• 建议统一使用 --output json，便于程序解析
• 标题匹配模式统一：contains|exact
• wait 默认超时：timeout_ms=2000
• wait_process 支持 expect_running=true|false
• 高风险动作（鼠标、键盘、窗口激活/关闭、剪贴板写）前后都要做观察或等待
• Linux/macOS 能力存在未覆盖路径，上生产前必须逐项实测
• 失败时优先看 failure.code / failure.message / failure.detail

Source: whuanle/EasyTouch — distributed by TomeVault.