mouse-keepalive 1.5.2

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 motoish
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,153 @@
+# Mouse Keepalive
+
+**中文** | [English](README_EN.md)
+
+跨平台 CLI 工具：按固定间隔轻微移动鼠标并立即回位，避免系统因长时间无操作而休眠或锁屏。  
+支持 **macOS / Windows / Linux**。
+
+---
+
+## ✨ 功能亮点
+
+- 跨平台（Python + [pyautogui](https://pypi.org/project/PyAutoGUI/)）
+- 可配置移动间隔与总运行时长
+- 瞬时微移（约 1–2 像素），日常使用几乎无感
+- **PyPI** 与 **npm** 均可安装；命令行别名 `mka`
+- 默认输出每次移动日志；`-q` 可完全静默
+
+---
+
+## 📋 环境要求
+
+| 方式 | 要求 |
+|------|------|
+| **PyPI / pipx**（推荐） | Python **3.11+** |
+| **npm** | Node.js **14+**，且本机已安装 **Python 3.11+**（npm 包为启动器，实际逻辑在 Python 中） |
+| **从源码运行** | Python 3.11+；见下方「本地开发」 |
+
+---
+
+## 📦 安装
+
+### PyPI（推荐）
+
+```bash
+pip install mouse-keepalive
+# 或（隔离环境，推荐桌面使用）
+pipx install mouse-keepalive
+```
+
+### npm
+
+```bash
+npm install -g mouse-keepalive
+```
+
+首次运行前请确保已安装 Python 3.11+；若缺少 `pyautogui`，npm 入口会尝试自动 `pip install pyautogui`。
+
+---
+
+## 🚀 快速开始
+
+```bash
+# 默认：每 60 秒移动一次，Ctrl+C 停止
+mka
+
+# 每 30 秒移动一次
+mka -i 30
+
+# 每 2 分钟移动一次，共运行 1 小时
+mka -i 120 -d 3600
+
+# 静默模式（无日志）
+mka -q
+
+# 帮助
+mka --help
+```
+
+等效命令：
+
+```text
+mouse-keepalive
+python -m mouse_keepalive
+```
+
+---
+
+## ⚙️ 命令行参数
+
+| 参数 | 说明 | 默认 |
+|------|------|------|
+| `-i, --interval` | 移动间隔（秒） | `60` |
+| `-d, --duration` | 运行总时长（秒）；省略则一直运行 | 无限 |
+| `-q, --quiet` | 静默模式，不输出日志 | 关闭 |
+| `-h, --help` | 显示帮助 | — |
+
+---
+
+## 🧠 工作原理
+
+程序按间隔获取当前光标位置，偏移 1–2 像素后**立即移回**，使系统仍检测到鼠标活动，同时尽量不打扰正常使用。
+
+---
+
+## 🛠 本地开发
+
+仓库采用 **src 布局**，包路径为 `src/mouse_keepalive/`（对外导入名仍为 `mouse_keepalive`）。
+
+```bash
+git clone https://github.com/motoish/mouse-keepalive.git
+cd mouse-keepalive
+
+# 可编辑安装 + 开发依赖
+pip install -e ".[dev]"
+
+# 方式一：仓库根目录脚本（改代码后无需重装）
+./move_mouse.sh
+./move_mouse.sh -i 30 -q
+
+# 方式二：Makefile
+make run ARGS="-i 30"
+
+# 方式三：安装后的 CLI
+mka -i 30
+
+# 测试与检查
+make test
+make lint
+```
+
+`move_mouse.sh` 会优先使用 `.venv/bin/python`，并通过 `PYTHONPATH=src` 加载源码；**不会**随 PyPI/npm 包发布。
+
+### 目录结构（简要）
+
+```text
+mouse-keepalive/
+├── src/mouse_keepalive/   # Python 包
+├── bin/                   # npm CLI（转发到 python -m mouse_keepalive）
+├── tests/
+├── move_mouse.sh          # 仅本地开发
+└── pyproject.toml
+```
+
+---
+
+## ⚠️ 注意事项
+
+- 使用 **Ctrl + C** 可随时退出  
+- **macOS** 需在「系统设置 → 隐私与安全性 → 辅助功能」中允许终端或 Python  
+- 企业安全策略可能拦截模拟鼠标；若无效请联系管理员或加入白名单  
+
+---
+
+## 📦 发布与版本
+
+用户安装版本以 [PyPI](https://pypi.org/project/mouse-keepalive/) / [npm](https://www.npmjs.com/package/mouse-keepalive) 为准。  
+变更记录见 [CHANGELOG.md](CHANGELOG.md)。仓库使用 [release-please](https://github.com/googleapis/release-please) 管理版本；合并 Release PR 后会发布 `v*` 标签并自动发布到 npm / PyPI。
+
+---
+
+## 📄 许可证
+
+[MIT](LICENSE)

package/bin/mouse-keepalive.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+/**
+ * npm CLI: delegates to Python module mouse_keepalive.
+ * npm CLI：委托给 Python 模块 mouse_keepalive。
+ */
+
+const { spawn } = require('child_process');
+
+function tryPython(cmd) {
+  return new Promise((resolve) => {
+    const proc = spawn(cmd, ['--version'], { stdio: 'pipe' });
+    proc.on('close', (code) => resolve(code === 0 ? cmd : null));
+    proc.on('error', () => resolve(null));
+  });
+}
+
+async function findPython() {
+  for (const cmd of ['python3', 'python']) {
+    const found = await tryPython(cmd);
+    if (found) return found;
+  }
+  throw new Error('Python not found. Please install Python 3.11 or higher.');
+}
+
+function checkPyAutogui(pythonCmd) {
+  return new Promise((resolve) => {
+    const proc = spawn(pythonCmd, ['-c', 'import pyautogui'], { stdio: 'pipe' });
+    proc.on('close', (code) => resolve(code === 0));
+    proc.on('error', () => resolve(false));
+  });
+}
+
+function installPyAutogui(pythonCmd) {
+  return new Promise((resolve, reject) => {
+    console.log('警告: pyautogui 未安装，正在尝试安装...');
+    console.log('Warning: pyautogui not installed, attempting install...');
+
+    const pip = spawn(pythonCmd, ['-m', 'pip', 'install', 'pyautogui'], {
+      stdio: 'inherit',
+    });
+
+    pip.on('close', (code) => {
+      if (code === 0) resolve();
+      else reject(new Error('Failed to install pyautogui. Please run: pip install pyautogui'));
+    });
+    pip.on('error', reject);
+  });
+}
+
+function runPythonModule(pythonCmd, args) {
+  const child = spawn(pythonCmd, ['-m', 'mouse_keepalive', ...args], {
+    stdio: 'inherit',
+  });
+
+  child.on('close', (code) => process.exit(code || 0));
+  child.on('error', (err) => {
+    console.error('错误: 无法启动 Python 模块 / Error: Failed to start Python module');
+    console.error(err.message);
+    process.exit(1);
+  });
+
+  process.on('SIGINT', () => child.kill('SIGINT'));
+  process.on('SIGTERM', () => child.kill('SIGTERM'));
+}
+
+async function main() {
+  try {
+    const pythonCmd = await findPython();
+    const hasPyAutogui = await checkPyAutogui(pythonCmd);
+    if (!hasPyAutogui) {
+      await installPyAutogui(pythonCmd);
+    }
+    runPythonModule(pythonCmd, process.argv.slice(2));
+  } catch (err) {
+    console.error(err.message);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "mouse-keepalive",
+  "version": "1.5.2",
+  "description": "A cross-platform tool to automatically move the mouse at specified intervals to prevent system sleep or lock",
+  "bin": {
+    "mouse-keepalive": "./bin/mouse-keepalive.js",
+    "mka": "./bin/mouse-keepalive.js"
+  },
+  "scripts": {
+    "lint": "eslint bin/*.js",
+    "format": "prettier --write \"bin/*.js\" \"package.json\""
+  },
+  "keywords": [
+    "mouse",
+    "automation",
+    "prevent-sleep",
+    "idle",
+    "keep-alive",
+    "cross-platform",
+    "cli",
+    "tool",
+    "macos",
+    "windows",
+    "linux"
+  ],
+  "author": "motoish",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/motoish/mouse-keepalive.git"
+  },
+  "bugs": {
+    "url": "https://github.com/motoish/mouse-keepalive/issues"
+  },
+  "homepage": "https://github.com/motoish/mouse-keepalive#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.5"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}