Total PC Control

基本能力

产品定位

Total PC Control 是一个用于自动化控制计算机输入设备的工具，适用于开发测试、自动化脚本和浏览器自动化等场景。

核心功能

• 📷 屏幕捕获：捕获整个屏幕或特定区域的截图
• 🖱️ 鼠标控制：移动鼠标、点击、双击和滚动
• ⌨️ 键盘输入：输入文本和快捷键
• 🪟 窗口管理：查找、聚焦和操作应用窗口
• 📋 剪贴板访问：复制和粘贴文本

适用场景

• 自动化测试
• 浏览器自动化
• 开发效率工具
• 脚本控制

工具列表

屏幕捕获

• capture_screen: 捕获整个屏幕
• capture_region: 捕获特定区域

鼠标控制

• move_mouse: 移动鼠标
• click_mouse: 点击鼠标
• double_click: 双击
• right_click: 右键点击
• scroll_mouse: 滚动鼠标

键盘输入

• type_text: 输入文本
• press_key: 按下按键
• hold_key: 按住按键
• release_key: 释放按键

窗口管理

• find_window: 查找窗口
• focus_window: 聚焦窗口
• get_active_window: 获取活动窗口信息

剪贴板操作

• copy_to_clipboard: 复制到剪贴板
• paste_from_clipboard: 从剪贴板粘贴

常见问题解答

• 风险提示：该工具可以完全控制你的计算机，使用需谨慎。
• 依赖问题：确保安装所有前置依赖，如 Node.js 和 cmake-js。

使用教程

使用依赖

• Node.js 16 或更高版本
• npm 或 yarn
• cmake-js（用于构建原生依赖）

安装教程

1. 克隆仓库：

git clone https://github.com/jasondsmith72/total-pc-control.git
cd total-pc-control

1. 全局安装 cmake-js：

npm install -g cmake-js

1. 安装 libnut 核心库：

git clone https://github.com/nut-tree/libnut.git libnut-core
cd libnut-core
npm install
cmake-js rebuild
cd ..

1. 安装依赖并构建项目：

npm install
npm run build

调试方式

• 开发模式运行：

npm run dev

• 运行测试：

npm test

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。