Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions plugins/ztools-shukuaikuai/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
node_modules/
dist/
artifacts/
*.user
13 changes: 13 additions & 0 deletions plugins/ztools-shukuaikuai/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# 更新日志

## 0.5.9 - 2026-11-16

首次准备公开发布 Windows x64 版本。

- 支持双可见轮盘、无边界外圈、扇区直接绑定动作与可调大小。
- 支持统一自由轨迹录制、多笔手势、匹配反馈和规则管理。
- 提供五种动作类型、快捷键录入、应用排除与配置导入导出。
- 重排轮盘、手势和动作库为同屏编辑布局;左下角控制监听。
- 编辑草稿与运行配置隔离,二次确认在页内显示。
- 修复外圈选中时异常焦点边线,补齐删除手势的确认,精简页面说明。
- 使用指定蓝色鼠标图标,并更新宿主入口图标地址以避免旧缓存。
21 changes: 21 additions & 0 deletions plugins/ztools-shukuaikuai/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 jiang66-so

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.
17 changes: 17 additions & 0 deletions plugins/ztools-shukuaikuai/MARKET.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# 鼠快快 · 商店说明

一划一点,快捷随手。

将常用操作放到鼠标旁:按住唤起轮盘,移动选择、松开执行;或画下自己习惯的轨迹,直接调用绑定动作。

支持两圈可见扇区与轮盘之外的外圈动作,触发鼠标按键与修饰键可自行录入。自由手势支持分笔与试画反馈。动作库覆盖快捷键、应用、文件、网址和文本,配有配置备份、应用排除和暂停开关。

平台:Windows x64。请先在常用应用中确认效果;高权限窗口、游戏和受保护桌面存在系统输入限制。

源码与问题反馈:https://github.com/jiang66-so/ztools-shukuaikuai

![轮盘](screenshots/wheel.png)

![手势](screenshots/gestures.png)

![动作库](screenshots/actions.png)
43 changes: 43 additions & 0 deletions plugins/ztools-shukuaikuai/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# 鼠快快

**一划一点,快捷随手。**

Windows x64 的 ZTools 鼠标轮盘与自由手势插件。把快捷键、应用、文件、网址和固定文本绑定到轮盘扇区或自己绘制的轨迹。

## 安装与使用

从 [GitHub Releases](https://github.com/jiang66-so/ztools-shukuaikuai/releases) 下载 ZIP,在 ZTools 中导入插件包。商店提交审核通过后,也可从插件中心搜索“鼠快快”。当前版本:0.5.9。

在 ZTools 搜索“鼠快快”打开设置。轮盘默认使用鼠标中键,手势默认使用右键;两者的触发按键、Ctrl / Alt / Shift 组合均可修改或直接录入。左下角开关暂停或恢复监听。

- **轮盘**:点击预览扇区选择动作。支持两个可见圈层;外圈指可见轮盘之外的无限区域,可统一执行一个动作或按方向绑定。选择方案后保存即可启用该方案。实际轮盘大小可设置为 200—600 px,并随 Windows 显示缩放。
- **手势**:自由绘制轨迹,填写名称、绑定动作并添加。支持最多 8 笔;试画显示与已保存手势的匹配结果。已有手势列表可修改、替换轨迹、启停或删除。
- **动作库**:支持键盘快捷键、打开应用、文件或目录、HTTP/HTTPS 网址及输入固定文本。快捷键支持录入;共用动作修改会同步影响引用它的轮盘和手势。
- **设置**:排除特定应用、导入导出配置。编辑只修改草稿,原配置继续运行;点击底部“保存设置”后生效。Esc 可取消当前轮盘或手势。

![轮盘与动作](screenshots/wheel.png)

![手势设置](screenshots/gestures.png)

## 数据与兼容性

配置保存在 ZTools userData 下的 `shukuaikuai/config.json`,原配置有 `.bak` 备份;暂停状态单独存入 `runtime.json`。插件不需要账号,不主动联网;打开网址动作交给系统浏览器。导出配置会包含你填写的文本、网址和路径,请按需要保管。

仅支持 Windows x64。原生服务使用 Win32 鼠标钩子、透明绘制窗口和系统模拟输入;运行包不需要安装 Node.js 或 .NET SDK。高权限应用、受保护桌面以及部分游戏可能拒绝模拟输入,复杂轨迹和多屏缩放效果仍取决于实际环境。可通过应用排除避免接管特定程序的鼠标操作。

## 从源码构建

需要 Windows x64、Node.js 20 或以上,以及系统 .NET Framework 4.x 的 C# 编译器(Windows 常见环境已提供)。

```powershell
npm ci
npm run package
```

运行目录为 `dist/plugin`,安装包输出到 `artifacts/鼠快快-0.5.9.zip`。`npm test` 提供纯逻辑检查。日常修改默认只验证直接相关内容,完整回归按需执行。

源码包含可读的 preload 与 C# 服务实现;构建时生成原生服务,无需从外部下载可执行文件。项目发布快照不包含个人配置、日常宿主数据库、临时安装工具或本机测试 profile。

## 许可

[MIT](LICENSE)。Vue 的许可保留在 `public/THIRD_PARTY_NOTICES.txt` 中。
1 change: 1 addition & 0 deletions plugins/ztools-shukuaikuai/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<!doctype html><html lang="zh-CN"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'self'; img-src 'self' data:; connect-src 'self'"><title>鼠快快</title><script src="./model.js"></script></head><body><div id="app"></div><script type="module" src="/src/main.js"></script></body></html>
Loading
Loading