鍵盤滑鼠Go

KeymouseGo

簡體中文| English

功能：記錄使用者的滑鼠鍵盤操作，透過觸發按鈕自動執行先前記錄的操作，可設定執行的次數，可以理解為精简绿色版的按键精灵。

用途：在進行某些操作簡單、單調重複的工作時，使用本軟體就可以很省力了。自己只要做一遍，然後接下來就讓電腦來做。

目錄

• 安裝
• 使用方法
  • 基本操作
  • 提示
  • 腳本語法說明
  • 自訂擴充
• 關於作者
• 開源貢獻者
• 更新說明

安裝

該軟體透過Python語言編寫，已打包為可執行文件，未安裝Python的用戶可直接下載release 版本，直接點擊KeymouseGo運行

原始碼打包可執行文件

• Windows

 1. 安装 Python3
2. pip install -r requirements-windows.txt
3. pip install pyinstaller
4. pyinstaller -F -w --add-data "./assets;assets" KeymouseGo.py

• Linux或Mac

 1. 安装 Python3
2. pip3 install -r requirements-universal.txt
3. pip3 install pyinstaller
4. pyinstaller -F -w --add-data "./assets:assets" KeymouseGo.py

使用方法

基本操作

桌面模式

1.點選录制按鈕，開始錄製。

2.在電腦上進行任意操作，例如點擊滑鼠、鍵盤輸入，這部分的動作會被記錄下來。

3.點擊结束按鈕，結束錄音。

4.點選启动按鈕，計算機會重複執行一遍第2步驟所錄製的動作。

命令列模式

直接運行指定腳本:

 > ./KeymouseGo scripts/0314_1452.txt

運行指定腳本3次:

 > ./KeymouseGo scripts/0314_1452.txt -rt 3
> ./KeymouseGo scripts/0314_1452.txt --runtimes 3

以200%的速度運行指定腳本:

 > ./KeymouseGo scripts/0314_1452.txt -sp 200
> ./KeymouseGo scripts/0314_1452.txt --speed 200

載入自訂擴充功能MyExtension運行指定腳本:

 > ./KeymouseGo scripts/0314_1452.txt -m MyExtension
> ./KeymouseGo scripts/0314_1452.txt --module MyExtension

提示

1.可設定腳本重複執行的次數，若為0即為無限迴圈。

2.預設啟動熱鍵為F6 ，功能等同於启动按鈕；預設終止熱鍵為F9 ，按下後將會停止正在執行的腳本。

3.錄製時只記錄滑鼠點擊動作和鍵盤動作，不記錄滑鼠移動軌跡。

4.每次錄製結束後都會在scripts目前產生新的腳本檔。

5.運行前可以在清單中選擇一個需要執行的腳本。

6、 scripts下的腳本文件內容可以修改，修改時可參考如下所述脚本格式说明。

7.熱鍵設定中的Middle指涉滑鼠中鍵， XButton指涉滑鼠側鍵

8.由於程式速度受限，當輸入的滑鼠速度大於一定值時腳本將無法以預期的輸入速度執行

在部分系統環境中，可能出現無法錄製完整的滑鼠事件的情況，請以管理員身分/root身分執行此工具即可正常使用。

使用Mac的用戶，需要確保程式在輔助功能白名單，如果使用打包的exec文件，則還需要確保終端也在輔助功能白名單。 如果app程式閃退，請嘗試給予~/.qt_material目錄下檔案的寫入權限:

chmod -R 770 ~ /.qt_material

腳本語法說明

演示螢幕解析度為1920 * 1080

 [
 [3000, "EM", "mouse right down", ["0.05208%", "0.1852%"]],    // 开始运行 `3000ms` 后，在屏幕相对坐标 `(0.05208, 0.1852)`即 `(100,200)` 处 `按下鼠标右键`；
 [50,   "EM", "mouse right up",   ["0.05208%", "0.1852%"]],    // 等待 `50ms` 后在相同位置 `抬起鼠标右键`；
 [1000, "EK", "key down",         [70, "F", 0]],                                   // 等待 `1000ms` 后 `按下f键`；
 [50,   "EK", "key up",           [70, "F", 0]],                                   // 等待 `50ms` 后 `抬起f键`；
 [100,  "EM", "mouse left down",  ["0.2604%", "0.4630%"]],      // 等待 `100ms` 后，在屏幕相对坐标 `(0.2604, 0.4630)`即 `(500, 500)` 处 `按下鼠标左键`；
 [100,  "EM", "mouse move",       ["0.2604%", "0.5556%"]],       // 等待 `100ms` 后，鼠标移动至相对坐标 `(0.2604, 0.5556)`即 `(500, 600)` 位置；
 [100,  "EM", "mouse left up",  ["0.3125%", "0.5556%"]],                   // 等待 `100ms` 后，在屏幕相对坐标 `(0.3125, 0.5556)`即 `(600, 600)` 处 `抬起鼠标左键`；
 [100,  "EX", "input",            "你好 world"],                                   // 等待 `100ms` 后，在当前位置输入 `你好 world` 文字。
]

腳本為json格式，每一行代表一次動作：

• 每行的第1 個元素表示時間間隔，指的是本次動作與上一次動作相隔的時間，單位為毫秒。
• 每行的第2 個元素表示滑鼠動作或是鍵盤動作： EM為滑鼠， EK為鍵盤， EX為其他拓展動作。
• 每行的第3 個元素表示動作的類型：
  • mouse left down為滑鼠左鍵按下， mouse left up為滑鼠左鍵抬起，
  • mouse right down為滑鼠右鍵按下， mouse right up為滑鼠右鍵抬起，
  • mouse middle down為滑鼠中鍵按下， mouse middle up為滑鼠中鍵抬起，
  • mouse wheel up為滑鼠滾輪上滑， mouse wheel down為滑鼠滾輪下滑，
  • key down為鍵盤按鍵按下， key up為鍵盤按鍵抬起，
  • mouse move為滑鼠滑過， input輸入文字。
• 每行的第4 個元素表示具體的動作參數
  • 當為滑鼠動作時，由兩個子元素構成，分別為滑鼠所在的螢幕位置的橫縱座標，
  • 當為鍵盤動作時，由三個子元素構成，分別是（按鍵編號, 按鍵名, 拓展標記)，
  • 當為輸入文字動作時，為要輸入的文字內容。
• 每行//後的部分為註釋內容。
• 修改時請嚴格遵守格式，否則可能導致腳本無法執行，建議修改前先備份一下。
• 橫縱座標為[-1, -1]時，表示在滑鼠目前所在位置執行操作。

自訂擴充

功能的使用詳見wiki

關於作者

我是陶佳元，熱愛程式碼，懷舊，網路上常用的ID 有taojy123 、tao.py。

我的個人站點tslow.cn 整理並列了一些个人项目和小工具合集。

你可以在簡書瀏覽我最新發佈的文章，還可以在B站觀看我的技術分享和生活紀實。

我的信箱: [email protected]

---

開源貢獻者

如果您是開發愛好者，並對本專案感興趣，歡迎參與專案的共同建設，您可以透過本專案的dev分支查看目前的進度，並且可以向​​本專案的dev分支提交Pull request 來貢獻程式碼。

在此，特別感謝積極貢獻者：

感謝JetBrains 免費提供開發工具

---

更新說明

暫時沒辦法打包x86版本，32 位元系統的同學請自行原始碼編譯，或下載v1.5舊版使用

v5.1

• 支援在Linux和Mac環境下運行
• 支援在多螢幕環境下運行(僅Windows)
• 修復程序在執行連點操作時有機率崩潰的問題
• 修復文件選擇器選擇腳本後選項卡未更新的問題

v5.0

• 初步實作自訂擴充功能
• 可調整提示音音量
• 增加腳本重命名/編輯子視窗
• 新增英文文檔
• 增加簡單日誌視窗
• 適應高解析度(在高解析度情況下放大視窗)

v4.1

• 新增命令列運行能力

v4.0

• 使用PySide2 重寫UI
• 快捷鍵支援滑鼠中鍵與側鍵
• 相關issue 提出的功能需求實現
• 4.0 程式碼基本上由Monomux 貢獻，KeymouseGo 的整體品質有了較大提升。感謝付出！

v3.2.2

• 修正了input 事件無法輸入內容的bug

v3.2.1

• 修復了中文註解無法解析的bug

v3.2

• 腳本檔案中可使用//進行內容註釋
• 可錄製滑鼠軌跡（ mouse move事件），並可在軟體中設定軌跡精度，填入0 即不錄製軌跡。

v3.1

針對這個issue(#39) 增加了兩個功能點

• 命令列啟動模式中可以隨時按下F9熱鍵，來終止腳本執行
• 模擬滑鼠點擊的腳本語句中可以設定座標點為[-1, -1] , 用以表示在滑鼠目前位置直接點擊

v3.0

因為相容macOS 遇到的很大的阻礙，最終放棄跨平台，血淚史可參考這兩個issue: #24 moses-palmer/pynput#55

• 改回使用win32api來模擬事件，只支援windows 系統
• 解決了shift +上下左右的回放問題，見#27
• 增加了錄影滑鼠路徑功能，需求來源#33
• 增加了文字輸入功能，需求來源#34
• 因為使用了win32api ，不需要再手動設定螢幕縮放比例了
• 錄製腳本語法有部分改動，不向前相容

v2.2

• 優化了腳本格式，將動作時間間隔，放到每行腳本的首位，邏輯更加合理
• 預設錄製的第一個動作不加時間間隔，即按下啟動按鈕後立即執行第一個動作
• 若重複多次執行，可修改腳本中第一個動作的時間（單位毫秒）來決定每輪動作之間的相隔時間

v2.1

• 增加了螢幕縮放配置，相容了修改過螢幕縮放比例的win10 系統
• 最佳化程式碼，相容於Python3

v2.0

• 程式碼優化重構
• 使用pynput實現動作捕捉和執行，不再需要安裝pywin32和pyhook
• 相容macOS (需要在隱私設定中允許程式控制電腦)
• pynput似乎不相容於WinXP，暫時沒辦法打包x86版本

v1.5

• 修復自訂縮放後錄製定位偏移Bug

v1.4

• 增加命令列運行方式

v1.3

• Bug 修復

v1.2

• UI 更新
• 移除了后台模式
• 簡化了錄製腳本，增強了可讀性
• 腳本檔案名稱優化，可錄製多個腳本，避免誤操作覆蓋了辛苦錄製的腳本
• 可自訂启动热键和终止热键