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
49 changes: 49 additions & 0 deletions plugins/ztools-shukuaikuai/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,54 @@
# 更新日志

## 0.7.5 - 2026-11-17

- 删除外圈无边界与动作绑定的说明文字。
- 所有设置卡片和手势编辑条目始终展开,移除收起功能。
- 动作名称默认带入所选文件、文件夹、应用、网页标题或插件及指令名称,手动改名后保留。
- 网页标题读取失败回退域名,延迟结果不会覆盖手动名称或新目标。

## 0.7.4 - 2026-11-17

- 触发与第一圈设置分别改为横向宽卡片,字段横向排列。
- 删除轮盘大小的预览说明文字。
- 第二圈与第三圈设置卡片在同一行自动等高,保留约 1:3 的宽度比例。

## 0.7.3 - 2026-11-17

- 第二圈设置卡片收窄,第三圈(外圈)设置卡片加宽,宽窗口按约 1:3 分配空间。
- 窄窗口继续使用单列,第二圈标题与状态可换行,避免挤压控件。

## 0.7.2 - 2026-11-17

- 使用选定的红色圆润鼠标与黄色星光 Logo,统一设置页、总览和宿主入口资源。
- 更换入口图标文件名,更新本插件最近使用及固定入口的图标引用,避免沿用旧图标缓存。
- 图标最小检查改为 headless Chromium 页面验证,不启动 Electron 宿主验收窗口。

## 0.7.1 - 2026-11-17

- 将轮盘触发、第一圈、第二圈、第三圈(外圈)设置拆为独立卡片,保留独立的外观与防误触设置。
- 第二圈和外圈未启用时仍显示对应卡片及当前参数,开启原有开关后即可编辑。

## 0.7.0 - 2026-11-17

- 手势默认匹配要求降为 50%,设置改为百分比展示,旧版识别要求升级一次后仍可自行调整。
- 输入框提示统一灰色,填写内容和已选择内容使用深色。
- 新建及编辑动作自动读取应用、文件、文件夹、网站和插件指令图标,提供 21 个内置图标及本地图片替换。
- 插件和指令选择列表显示图标,轮盘预览、桌面轮盘、手势列表及执行提示同步展示动作图标。
- 定向宿主验收默认隐藏窗口,支持 --ui 显式展示;保留最小验收范围。

## 0.6.1 - 2026-11-17

- 手势匹配移至标题旁,重复显示红色动作名,非重复显示绿色“可新建”。
- 移除独立匹配区,保存等提示改为不占高度、自动消失的浮层。
- 手势录制与执行统一为单笔,松开识别,再次绘制替换当前轨迹;保留旧配置。

## 0.6.0 - 2026-11-17

- 新增“执行 ZTools 插件指令”动作,参考程序坞的插件目录与公开跳转实现。
- 支持在新建动作和动作库中选择已安装插件及具体文本指令,轮盘与手势均可绑定。
- 读取目录前由宿主授权;处理停用、同名、指令删除与配置保留,执行结果显示提交状态。

## 0.5.9 - 2026-11-16

首次准备公开发布 Windows x64 版本。
Expand Down
8 changes: 7 additions & 1 deletion plugins/ztools-shukuaikuai/MARKET.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,16 @@

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

支持两圈可见扇区与轮盘之外的外圈动作,触发鼠标按键与修饰键可自行录入。自由手势支持分笔与试画反馈。动作库覆盖快捷键、应用、文件、网址和文本,配有配置备份、应用排除和暂停开关。
支持两圈可见扇区与轮盘之外的外圈动作,触发鼠标按键与修饰键可自行录入。自由手势一笔画完、松开识别,默认达到 50% 相似度即可匹配,也可调整匹配要求。

动作库覆盖快捷键、应用、文件、文件夹、网址、文本和 ZTools 插件指令。选择目标后自动带入名称与图标,也可手动修改;同一动作可用于轮盘和手势。配有配置备份、应用排除和暂停开关。

轮盘大小可调,圈层设置分卡片排列;设置卡片始终展开,编辑草稿不会中断已保存的配置。首次选择插件指令时,需要在 ZTools 中授权读取插件列表和停用状态。

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

为网址动作读取名称和图标时会访问填写的网址及图标地址,读取失败会使用域名和默认图标。

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

![轮盘](screenshots/wheel.png)
Expand Down
14 changes: 8 additions & 6 deletions plugins/ztools-shukuaikuai/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,28 @@

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

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

## 安装与使用

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

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

- **轮盘**:点击预览扇区选择动作。支持两个可见圈层;外圈指可见轮盘之外的无限区域,可统一执行一个动作或按方向绑定。选择方案后保存即可启用该方案。实际轮盘大小可设置为 200—600 px,并随 Windows 显示缩放。
- **手势**:自由绘制轨迹,填写名称、绑定动作并添加。支持最多 8 笔;试画显示与已保存手势的匹配结果。已有手势列表可修改、替换轨迹、启停或删除。
- **动作库**:支持键盘快捷键、打开应用、文件或目录、HTTP/HTTPS 网址及输入固定文本。快捷键支持录入;共用动作修改会同步影响引用它的轮盘和手势。
- **手势**:自由绘制轨迹,填写名称、绑定动作并添加。每个手势一笔画完,再次绘制会替换当前轨迹;标题旁以红色标签提示重复动作,绿色“可新建”表示可添加。默认相似度达到 50% 即可匹配,可在识别设置中调整。已有手势列表可修改、替换轨迹、启停或删除。
- **动作库**:支持键盘快捷键、打开应用、文件或目录、HTTP/HTTPS 网址、输入固定文本和执行 ZTools 插件指令。快捷键支持录入;选择文件、文件夹、应用、网址或插件指令后,动作名称默认带入目标名称,仍可自行修改。网址优先读取网页标题,失败时使用域名。文件、文件夹、应用、网址及插件指令自动读取目标图标。可切换内置图标或选择本地图片,轮盘与手势同步展示;共用动作修改会同步影响引用它的轮盘和手势。
- **设置**:排除特定应用、导入导出配置。编辑只修改草稿,原配置继续运行;点击底部“保存设置”后生效。Esc 可取消当前轮盘或手势。

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

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

新建“执行 ZTools 插件指令”动作时,选择插件名称和具体指令。首次选择需在 ZTools 中批准读取插件列表及停用状态;批准后刷新列表。只支持可直接打开的文本指令,保存后可绑定轮盘或手势。

## 数据与兼容性

配置保存在 ZTools userData 下的 `shukuaikuai/config.json`,原配置有 `.bak` 备份;暂停状态单独存入 `runtime.json`。插件不需要账号,不主动联网;打开网址动作交给系统浏览器。导出配置会包含你填写的文本、网址和路径,请按需要保管。
配置保存在 ZTools userData 下的 `shukuaikuai/config.json`,原配置有 `.bak` 备份;暂停状态单独存入 `runtime.json`。插件不需要账号;为网址动作读取标题和图标时会访问填写的网址及其图标地址,读取失败使用域名和默认图标。打开网址动作交给系统浏览器。导出配置会包含你填写的文本、网址和路径,请按需要保管。

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

Expand All @@ -34,7 +36,7 @@ npm ci
npm run package
```

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

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

Expand Down
Loading
Loading