easytouch-windows 1.0.17 → 2.0.0

package/README.md

@@ -1,21 +1,27 @@
 # EasyTouch
 
+## 中文 | [English](README.en.md) 
+
 跨平台系统自动化操作工具，支持 Windows、Linux、macOS。提供 CLI 命令行和 MCP 服务器两种使用方式，支持鼠标键盘控制、屏幕截图、窗口管理、系统信息查询等功能。
 
-目前：
+目前支持以下操作系统的 x64 和 ARM64 两种 CPU 架构：
 
 - [x] Windows
 
 - [x] Linux
-- [ ] MAC（目前缺少设备验证功能）
+- [x] MACOS（目前缺少设备验证功能）
+
+
+
+**你能用它做什么？**
 
 大家平时使用各类 AI 编程工具，写页面是不是经常碰到 AI 写的页面怎么也不满意，写出来跟设计稿差异很大，这是因为 AI 只能通过读写代码来改进代码，它看不到界面，不像人类有感官。
 
-所以 EasyTouch 是给 AI 装上手和眼睛。
+如果你想通过 OpenClaw 接入微信、飞书，让它截图桌面发给你，但是 OpenClaw 像弱智一样搞不好，或者你希望 AI 能够操作你电脑的设备为你工作，那么 EasyTouch 非常适合你。
 
 
 
-**你能用它做什么？**
+因为 EasyTouch 是给 AI 装上手和眼睛，它支持以下功能：
 
 - 系统信息：系统、CPU、内存、磁盘、进程
 - 屏幕能力：显示器枚举、像素取色、截图
@@ -29,36 +35,51 @@
 
 ### 安装
 
-推荐直接安装根包：
+推荐安装带自动平台选择能力的启动包；如果你只想安装当前系统，也可以直接安装对应平台包：
 
 ```bash
-npm i -g easytouch
-```
-
-也可以只安装当前操作系统对应的平台包：
+# 推荐：自动匹配当前平台
+npm i -g @whuanle/easytouch
 
-```
 # Windows
-npm i  -g easytouch-windows
+npm i -g easytouch-windows
 
 # Linux
-npm i  -g easytouch-linux
+npm i -g easytouch-linux
 
 # macOS
 npm i -g easytouch-macos
 ```
 
-平台包内部同时包含 x64 和 arm64 二进制，安装后会根据当前 Node 进程的 CPU 架构自动选择对应程序文件。
+
+
+`@whuanle/easytouch` 会在当前主机上调用对应的平台包；平台包内部同时包含 x64 和 arm64 二进制，安装后会根据当前 CPU 架构自动选择对应程序文件。
+
+如果是 Windows，安装后在 `AppData/Roaming/npm` 目录会发现名为 `et` 的文件。
+
+![image-20260405194137861](images/image-20260405194137861.png)
 
 
 
 ### 使用示例
 
+截取屏幕。
+
+```
+ et screen capture --path a.png
+```
+
+
+
+![image-20260405194600430](images/image-20260405194600430.png)
 
 
 
+<img src="images/d4ba9a4e7b88e26b30118b3c76f2dce5.jpg" alt="d4ba9a4e7b88e26b30118b3c76f2dce5" style="zoom: 25%;" />
 
-### 作为 Skills 给 AI 使用
+
+
+### 作为 Skills 给 AI 使用（推荐）
 
 只需要执行命令安装 skills 即可。
 
@@ -66,9 +87,9 @@ npm i -g easytouch-macos
 npx skills add https://github.com/whuanle/EasyTouch
 ```
 
+> 注：skills 里面不带脚本，需提前安装当前平台包，第一次使用 AI 会自动安装，或者手动安装，例如 `npm i -g easytouch-windows`、`npm i -g easytouch-linux` 或 `npm i -g easytouch-macos`。
 
 
-注：skills 里面不带脚本，需提前使用 `npm i easytouch` 或当前平台包安装工具。
 
 ![image-20260224090411080](images/image-20260224090411080.png)
 
@@ -78,51 +99,54 @@ npx skills add https://github.com/whuanle/EasyTouch
 
 如果只是给 AI 工具使用，建议使用 skills 即可，配置 MCP 可能会麻烦一些。
 
-在 Claude、Cursor 等工具中，配置 MCP 的方式都是大同小异。通过 npm/bun 安装后，优先直接调用 `et` 或 `npx`。如果必须引用平台包内的真实二进制，路径位于平台包的 `bin/x64` 或 `bin/arm64` 目录下。
+在 Claude、Cursor、VS Code、Sidecar 等工具中，配置 MCP 的方式基本一致。通过 npm 安装后，推荐直接调用全局 `et`，这样 Windows、Linux、macOS 都能使用同一套配置。只有在宿主程序无法从 PATH 找到命令时，才退回到完整路径或 `npx`。
 
 
 
 在配置文件中添加：
 
-**Windows**
 
-```json
-{
-  "mcpServers": {
-    "easytouch": {
-      "command": "C:\\path\\to\\et.exe",
-      "args": ["--mcp"]
-    }
-  }
-}
-```
 
-**NPM 安装方式**
+**全局安装后（推荐，三平台统一写法）**
+
+先执行 `npm i -g @whuanle/easytouch`，或者安装对应平台包，然后使用：
 
 ```json
 {
   "mcpServers": {
     "easytouch": {
-      "command": "npx",
-      "args": ["-y", "easytouch", "--mcp"]
+      "command": "et",
+      "args": ["mcp-stdio"]
     }
   }
 }
 ```
 
-**Linux / macOS**
+**宿主程序不走 PATH 时**
+
+- Windows：把 `command` 改成 `C:\\Users\\<你自己的用户名>\\AppData\\Roaming\\npm\\et.cmd`
+- Linux / macOS：先执行 `npm prefix -g`，然后把 `command` 改成 `<prefix>/bin/et`
+
+**不想全局安装时（备用）**
+
+如果你不想全局安装，也可以临时通过 `npx` 启动。这里同样建议统一使用 `@whuanle/easytouch`，不要再按平台分别写包名。
+
+- Windows：`command` 推荐写 `npx.cmd`
+- Linux / macOS：`command` 写 `npx`
 
 ```json
 {
   "mcpServers": {
     "easytouch": {
-      "command": "/path/to/et",
-      "args": ["--mcp"]
+      "command": "npx",
+      "args": ["-y", "@whuanle/easytouch", "mcp-stdio"]
     }
   }
 }
 ```
 
+> 如果是在 Windows 的 GUI 程序中配置 MCP，`command` 往往应显式写成 `npx.cmd` 或 `et.cmd`，不要只写 `npx`，否则有些宿主不会按 PowerShell 规则解析 `.ps1` / `.cmd`。
+
 
 
 

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: easytouch
-description: EasyTouch Skill 接入文档（CLI + MCP）。
+description: 跨平台系统自动化操作工具，支持 Windows、Linux、macOS。提供 CLI 命令行和 MCP 服务器两种使用方式，支持鼠标键盘控制、屏幕截图、窗口管理、系统信息查询等功能。
 ---
 
 # EasyTouch Skill
@@ -18,9 +18,21 @@ description: EasyTouch Skill 接入文档（CLI + MCP）。
 ### npm 安装
 
 ```bash
-npm install easytouch
+# 推荐：自动匹配当前平台
+npm install -g @whuanle/easytouch
+
+# Windows
+npm install -g easytouch-windows
+
+# Linux
+npm install -g easytouch-linux
+
+# macOS
+npm install -g easytouch-macos
 ```
 
+
+
 安装后命令入口：
 
 ```bash
@@ -352,6 +364,8 @@ et mcp-stdio --output json
 
 ### 配置示例
 
+优先使用全局 `et` 命令，这样三个平台都是同一套 MCP 配置：
+
 ```json
 {
   "mcpServers": {
@@ -363,4 +377,24 @@ et mcp-stdio --output json
 }
 ```
 
+如果宿主程序不能从 PATH 找到命令：
+
+- Windows：把 `command` 改成 `C:\Users\<你自己的用户名>\AppData\Roaming\npm\et.cmd`
+- Linux / macOS：先执行 `npm prefix -g`，再把 `command` 改成 `<prefix>/bin/et`
+
+如果不想全局安装，也可以临时通过 `npx` 启动：
+
+- Windows：`command` 推荐写 `npx.cmd`
+- Linux / macOS：`command` 写 `npx`
+
+```json
+{
+  "mcpServers": {
+    "easytouch": {
+      "command": "npx",
+      "args": ["-y", "@whuanle/easytouch", "mcp-stdio"]
+    }
+  }
+}
+```
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "easytouch-windows",
-  "version": "1.0.17",
+  "version": "2.0.0",
   "description": "Windows binary distribution for EasyTouch with x64 and arm64 binaries.",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "commonjs",
   "repository": {
     "type": "git",
-    "url": "https://github.com/whuanle/EasyTouch"
+    "url": "git+https://github.com/whuanle/EasyTouch.git"
   },
   "bugs": {
     "url": "https://github.com/whuanle/EasyTouch/issues"