Total PC Control

Total PC Control

site icon
2025.03.31 1
TypeScript自动化控制UI 自动化开发工具浏览器自动化开发效率
Total PC Control 是一个基于 MCP(Model Context Protocol)的服务,通过 [nut.js](https://nutjs.dev/) 提供对屏幕、鼠标和键盘的程序化控制。该工具适用于需要自动化操作计算机的场景,如自动化测试、UI 自动化等。
View on GitHub

Overview

基本能力

产品定位

Total PC Control 是一个用于自动化控制计算机输入输出设备的服务,适用于开发者和测试人员。

核心功能

  • 屏幕捕获:捕获整个屏幕或特定区域的截图。
  • 鼠标控制:移动鼠标、点击、双击、滚动等操作。
  • 键盘输入:模拟键盘输入和快捷键操作。
  • 窗口管理:查找、聚焦和操作应用程序窗口。
  • 剪贴板访问:复制和粘贴文本。

适用场景

  • 自动化测试
  • UI 自动化
  • 屏幕录制和截图
  • 键盘和鼠标操作的自动化

工具列表

  • Screen Capture
  • capture_screen: 捕获整个屏幕。
  • capture_region: 捕获特定区域。
  • get_screen_size: 获取屏幕尺寸。
  • Mouse Control
  • move_mouse: 移动鼠标。
  • click_mouse: 点击鼠标。
  • scroll_mouse: 滚动鼠标。
  • Keyboard Input
  • type_text: 输入文本。
  • press_key_shortcut: 按下快捷键。
  • Clipboard Operations
  • get_clipboard_text: 获取剪贴板文本。
  • set_clipboard_text: 设置剪贴板文本。
  • UI Automation Tools (Windows Only)
  • get_ui_element_info: 获取 UI 元素信息。
  • invoke_ui_element_action: 执行 UI 元素操作。

常见问题解答

  • 警告:使用此软件可能导致意外后果,使用者需自行承担风险。
  • 依赖:需要 Node.js 16 或更高版本,以及 cmake-js 和 libnut 核心库。

使用教程

使用依赖

  1. 安装 Node.js 16 或更高版本。
  2. 安装 npm 或 yarn。
  3. 安装 cmake-js:
npm install -g cmake-js

安装教程

  1. 克隆仓库:
git clone https://github.com/jasondsmith72/total-pc-control.git
cd total-pc-control
  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

调试方式

  1. 运行开发模式:
npm run dev
  1. 运行测试:
npm test

许可证

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