开维控制精灵windows客户端应用于办公自动化工作流（workflow）、机器人流程自动化（RPA）、手游自动化测试等。

windows版本： 官网下载 华军下载

开发文档：https://ctrljs.ikaiwei.com/ctrljsapi/

主要功能：

1.支持桌面操控函数，支持图像识别直接操控

2.支持自动流程RPA录制

点击“自动录制”按钮后，点击“开始录制”，正常操作电脑后，“结束录制”，运行脚本即可。

3.支持命令行等多种调用方式

主程序运行：pcIde.exe test.js

浏览器运行（base64编码）：localhost:8686/runjs?js=Y3MuaG9tZSgpOw==

运行url脚本： data = {'js': 'aHR0cHM6Ly93d3cuaWthaXdlaS5jb20vZG93bmxvYWQvY3RybGpzL3Rlc3QuanM='} response = requests.post('http://127.0.0.1:8686/runurljs', data=data)

4.支持MCP协议

5.支持DLL调用

6.支持AI自动生成Ctrl.js代码，将知识库上传Deepseek后，根据功能生成代码

知识库下载： https://www.ikaiwei.com/download/ctrljs/ctrl.js_zhishi.docx

9.1 软件界面

软件左侧为编程区域，右侧为API函数区域，右侧的函数双击后，自动添加函数到代码区。

例如：
双击右侧“cs.home()”；
双击右侧“app.launchApp(“c:/windows/notepad.exe”)”；
点击左上角运行按钮，会自动返回桌面，并打开记事本。

再例如：
双击右侧“cs.home()”；
双击右侧“imagev.mouseLeftDoubleClick()”函数，此时屏幕会出现截屏画面，截取桌面“计算机”图标，点击完成后，会自动生成代码。如下图；
单击左上角运行按钮，会自动双击打开“计算机”图标。

9.2 自动流程RPA录制
点击“自动录制”按钮后，会出现录制菜单，此菜单拖拽到不影响操作的区域后，点击“
”，正常操作电脑后，“
”。

建议：开始录制后先点击一下桌面，从桌面开始录制；如果是浏览器操作，则确保入口点是固定的地方。总之，录制是根据桌面坐标纪录的，确保运行时和录制时状态一致。

录制结束后，软件会自动生成脚本，运行即可。

9.3 脚本编程调试
支持javascript脚本的调试，断点、单步等操作，用于编写调试代码。

9.4 脚本调用方法
9.4.1 命令行调用
脚本生成后，可以另存为js文件。支持命令行调用，例如：

命令：
pcIde_notAdmin.exe test.js

pcIde.exe 和 pcIde_notAdmin.exe 区别是后者不是管理员权限运行，不会弹窗验证窗口。

9.4.2 接口调用
开维控制精灵启动后，会接收本地网络请求，获取脚本开始工作。

接口一：接收ctrl.js脚本，直接运行，其中脚本用base64编码
http://localhost:8686/runjs?js=“”

接口二：接收本机ctrl.js脚本文件，上传到开维控制精灵中运行
http://loacalhost:8686/runfilejs

接口一实例：funjs

执行返回桌面

1. 运行“开维控制精灵”，右侧双击函数“cs.home()”，拷贝左侧的函数
2. 将“cs.home();”代码用第三方工具进行base64编码，编码后为“Y3MuaG9tZSgpOw==”
3. 组成命令“localhost:8686/runjs?js=Y3MuaG9tZSgpOw==”
4. 打开浏览器，输入该命令后，回车运行，运行结果是返回到桌面
   

接口二实例：runfilejs

执行返回桌面

1. 运行“开维控制精灵”，右侧双击函数“cs.home()”，点击另存为，保存到桌面“1.js”
2. 打开网页（安装目录下C:\Program Files (x86)\开维控制精灵\test.html），选择桌面上的“1.js”文件，即可运行

或者用python脚本，在安装目录下“C:\Program Files (x86)\开维控制精灵\test.py”
将1.js代码拷贝到c盘根目录，执行即可

import requests
import os
def main():
    path = "C:/1.js"
    files = {'jsfile':
             ( os.path.basename(path),  # 文件名
              open(path, 'rb'),  # 文件流
              {'Expires': '0'})
         }
    response = requests.post('http://127.0.0.1:8686/runfilejs', files=files)
    response.encoding = response.apparent_encoding
    return response.text


if __name__ == "__main__":
    main()

接口三实例：runurljs

指定url下载脚本运行（https://www.ikaiwei.com/download/ctrljs/test.js），下载时长30秒内。

import requests
data = {'js': 'aHR0cHM6Ly93d3cuaWthaXdlaS5jb20vZG93bmxvYWQvY3RybGpzL3Rlc3QuanM='}
response = requests.post('http://127.0.0.1:8686/runurljs', data=data)
print(response.text) # 输出响应内容

9.5 插件DLL调用（ctrl.js引擎调用）
支持插件调用。提供app.dll，可用不同语言加载直接调用控制功能。实例在安装目录下：

支持c,c++,qt,java,python等各种语言调用。

开发文档：https://ctrljs.ikaiwei.com/ctrljsapi/#/zh-cn/docs/dll/app

例如：
cj_app_vc.cpp vc代码，vc6.0,vs2015编译
cj_app_qt.cpp qt代码，qt5.9.*版本编译
cj_app_py.py py代码，python3.7以上版本编译
cj_app_vc.exe vc代码编译好的windows程序
cj_app_qt.exe qt代码编译好的windows程序

api.dll Ctrl.js引擎
quazip.dll Ctrl.js引擎依赖库
Qt5*.dll等 Ctrl.js引擎系统依赖库

说明：
1.dll,exe均为32位release
2.vc debug调试的时候，需要将platforms、sqldriver、cor、imageformats放到debug目录，或者添加到系统变量里面
3.如果缺库，一般时dll引用出的问题，用depend查看调用的dll补充

9.6 MCP调用用法

9.6.1 MCP调试工具
将安装目录下的“C:\Program Files (x86)\开维控制精灵\example\mcp\”下的ctrljs文件夹拷贝到c:\根目录下

安装python版本，3.10以上，例如python-3.13.0-amd64
执行命令
pip install mcp
pip install mcp[cli]
pip install requests
mcp dev c:\ctrljs\ctrljs.py

运行成功后，用浏览器打开提示的网址 http://127.0.0.1:6274/，连接mcp服务，点击工具列表，输入脚本c:\1.js，点击运行即可测试。

9.6.2 vscode中运行
vscode中下载cline客户端，注册登录

在cline中选择大模型deepseek/deepseek-chat:free

在cline中安装mcp并启动服务

{
  "mcpServers": {
    "ctrljs":{
      "command":"uv",
      "args":[
          "--directory",
          "C:\\ctrljs",
          "run",
          "ctrljs.py"
      ]
  }
  }
}

提问：“用ctrljs执行脚本 桌面上的1.js”，会提示调试信息，并执行