GestureSign V2
为 Windows 11 重新打磨的触控板 / 鼠标手势工具。
简体中文 | English | 日本語
项目简介
GestureSign V2 是基于经典开源项目 TransposonY/GestureSign 的 Windows 11 适配重构版。
原版 GestureSign 长期未维护，在新系统和高强度使用场景下容易遇到按键粘滞、界面老旧、DPI 适配不足等问题。这个版本的目标很直接：保留原来的手势能力，同时修复 Windows 11 下的体验问题，并用更现代的 WinUI 3 界面重新承载配置流程。
主要特性
- WinUI 3 重构界面，适配 Windows 11 圆角、Mica 风格、深色 / 亮色模式动态切换。
- 支持触控板手势、触摸屏手势、鼠标手势、手势轨迹显示和手势缩略图预览。
- 新增“快捷操作”页面，可按需下载 Kando 可选组件，并用独立快捷键唤起径向菜单。
- 新增“边缘交互”页面，可为触控板和触摸屏上 / 下 / 左 / 右边缘点击与边缘滑动单独绑定动作。
- 边缘手势可作为普通动作加入任意程序分组，当前应用动作优先，未命中时自动回退全局动作。
- 支持按程序、窗口类名、可执行文件、标题和分组管理动作。
- 支持快捷键、浏览器、窗口、媒体、系统操作等常用命令；新增动作时可直接配置要执行的命令，音量、亮度、打开文件、运行命令等常用命令提供专用编辑控件。
- 支持忽略列表，可按 exe、窗口类名、标题等规则排除指定程序。
- 支持优先使用系统触控板设置、Edge 自带手势，并可排除全屏场景。
- 支持将配置文件切换到 OneDrive
Apps\GestureSign V2 目录，由 OneDrive 负责跨设备同步。
- 支持托盘图标、托盘菜单、单实例启动和更方便阅读的手势日志；托盘可一键暂停/恢复手势识别。
- 支持 90 种 Windows 语言和地区变体，并为阿拉伯语、波斯语、希伯来语、乌尔都语和维吾尔语提供从右到左布局。
- 针对高 DPI、高刷新率屏幕做了界面和输入体验优化。
下载
Microsoft Store（推荐）
WinGet
GestureSign V2 已发布到 Windows Package Manager，可以直接通过 winget 安装：
winget install --id Tomclanc.GestureSignV2 --source winget
也可以前往 Releases 下载最新便携版。
当前版本：
更新内容
18.2.4
- 修复 Microsoft Store 版启动时 Kando 窗口被意外带到前台的问题。
18.2.3
- 改进“先激活窗口再发送动作”：直接点击当前鼠标位置后执行动作，兼容失去焦点的 Store/UWP 窗口。
- 智能关闭使用点击后的前台窗口，避免使用过期的子窗口句柄。
18.2.2
- 修复 Edge 等应用组存在专属动作时，实时提示不会按手势回退全局动作的问题。
- 实时动作提示现在只反映当前完整轨迹：命中时显示，继续绘制后失配则立即清除。
- 松手或取消时同步清除提示层后再执行最终动作，避免提示闪烁、残留或被后续单指帧错误接管。
- 被应用过滤器拒绝的单指触控板帧不再创建视觉提示生命周期。
历史版本
18.2 加入触控板和触摸屏四边缘音量、滚动映射、连续音量调节及多指防误触改进。18.1.4 及更早版本将界面和托盘菜单扩展到 90 种 Windows 语言及地区变体，加入 RTL 布局、Kando 升级迁移与架构自动选择，并修复鼠标点击拦截、轨迹透明度、游戏触摸拦截、全屏识别、标题栏与托盘触控、边缘交互和“启动应用”等问题。完整记录请参阅 GitHub Releases。
安装
推荐使用 winget 安装：
winget install --id Tomclanc.GestureSignV2 --source winget
也可以手动下载安装包：
- 下载 MSI 或 MSIX 安装包。
- 双击安装，按提示完成安装。
- 从桌面快捷方式或开始菜单打开
GestureSign V2。
- 在“动作”页面启用手势识别，并按需添加程序、手势和命令。
配置文件默认保存在：
%AppData%\GestureSign V2
日志文件默认保存在：
%LocalAppData%\GestureSign V2
快速使用
- 打开“动作”页面，确认“手势识别”已开启。
- 在左侧选择“全局动作”或某个程序分组。
- 点击“新动作”，录制或绘制一个手势图案。
- 点击“设置命令”，为这个手势绑定快捷键、浏览器、窗口或系统命令。
- 回到桌面或目标应用中使用手势触发操作。
如果某个程序已经有系统级手势或自带手势，例如 Windows 11 触控板设置、Microsoft Edge 鼠标手势，可以在“选项”中开启优先使用系统或应用自带行为。
页面说明
- “动作”：管理全局动作、程序动作、分组、手势和命令。
- “忽略”：添加不参与识别的程序、窗口或匹配规则。
- “手势”：查看、导入、导出、重训和整理手势库。
- “快捷操作”：选择 Kando 菜单、同步唤起快捷键、打开 Kando 设置或测试弹出菜单。
- “边缘交互”：设置触控板和触摸屏四边点击与边缘滑动动作。
- “选项”：调整轨迹颜色、宽度、透明度、输入设备、全屏排除和启动项。
- “关于”：查看版本、项目链接、日志和维护信息。
兼容性
- 推荐系统：Windows 11 x64；Microsoft Store 包同时提供 x64 与 ARM64 架构。
- 当前安装包：MSI x64、便携版 x64；商店上传包包含 x64 / ARM64；不再提供 x86 包。
- Windows 10 理论上可运行部分功能，但主要适配目标是 Windows 11。
反馈问题
如果遇到手势无法触发、录制异常、配置无法保存或界面显示问题，请在 Issues 中提供：
- 系统版本和屏幕缩放比例。
- 使用的是鼠标手势还是触控板手势。
- 目标应用名称，以及是否全屏。
- “关于”页面中的日志内容。
- 相关截图或复现步骤。
致谢
感谢原项目 TransposonY/GestureSign 以及 HighSign、MahApps.Metro、WGestures 等项目。GestureSign V2 仍然站在这些工作的基础上继续前进。
“快捷操作”可以按需下载 Kando 圆环菜单可选组件。Kando 默认不包含在 GestureSign 安装包中，可在应用内单独下载或卸载；Kando 是遵循 MIT License 的独立开源项目，组件保留其自带的 LICENSE 和 Chromium 相关许可证文件。
赞赏
如果 GestureSign V2 对你有帮助，欢迎通过微信赞赏支持项目的持续开发。感谢每一份支持。
English
GestureSign V2 is a Windows 11 focused rebuild of the classic open-source project TransposonY/GestureSign.
The original GestureSign has not been actively maintained for a long time. On newer Windows systems, users may run into sticky modifier keys, dated UI behavior, DPI issues, and inconsistent gesture capture. GestureSign V2 keeps the original gesture workflow while improving the Windows 11 experience and moving the configuration interface to a modern WinUI 3 design.
Features
- Rebuilt WinUI 3 interface with Windows 11 rounded corners, Mica styling, and light / dark theme support.
- Touchpad, touchscreen, and mouse gestures with gesture trails and thumbnail previews.
- New Quick Actions page with an optional on-demand Kando component and dedicated hotkey triggers.
- New Edge Interaction page for touchpad and touchscreen edge taps and edge swipes.
- Edge gestures can also be added to regular app groups; app-specific actions take priority and fall back to global actions when no executable app action is found.
- Per-app actions with matching by executable, window class, title, and groups.
- Common commands such as hotkeys, browser actions, window actions, media controls, system operations, file launching, volume, brightness, and command execution. New actions can include their initial command directly from the add-action dialog.
- Ignore list support for excluding specific apps, windows, or matching rules.
- Options to prefer Windows touchpad gestures or built-in browser gestures, with fullscreen exclusions.
- Optional OneDrive sync stores configuration under
OneDrive\Apps\GestureSign V2 and lets OneDrive handle cross-device synchronization.
- Tray icon, tray menu, single-instance startup, readable gesture logs, and one-click pause/resume from the tray.
- 90 Windows language and regional variants, with right-to-left layout for Arabic, Persian, Hebrew, Urdu, and Uyghur.
- Improved UI and input behavior for high-DPI and high-refresh-rate displays.
Download
Microsoft Store (recommended)
WinGet
GestureSign V2 is available from Windows Package Manager. Install it with winget:
winget install --id Tomclanc.GestureSignV2 --source winget
You can also get the latest portable build from Releases.
Current version:
What's new in 18.2.2
- Fixed live previews failing to fall back to global actions per gesture when an app group, such as Edge, also has app-specific actions.
- Live action hints now reflect only the current complete path: they appear on a match and clear immediately when further drawing invalidates it.
- Releasing or canceling synchronously clears the hint layer before final recognition and action execution, preventing flicker and stale labels.
- Rejected one-finger touchpad frames no longer create or take ownership of a visual hint lifecycle.
Previous releases
Version 18.2 added four-edge volume and scrolling mappings, continuous volume adjustment, and improved multi-finger false-trigger protection. Version 18.1.4 and earlier expanded the UI and tray menu to 90 Windows language and regional variants, added RTL layout, Kando upgrade migration and architecture selection, and fixed mouse click interception, trail opacity, game touch interception, fullscreen detection, caption and tray touch, edge interactions, and Launch App behavior. See GitHub Releases for the complete history.
Installation
Recommended:
winget install --id Tomclanc.GestureSignV2 --source winget
Manual installation:
- Download the MSI or MSIX installer.
- Double-click the installer and follow the setup prompts.
- Open
GestureSign V2 from the desktop shortcut or Start menu.
- Go to the Actions page, enable gesture recognition, and add apps, gestures, and commands as needed.
Configuration files are stored in:
%AppData%\GestureSign V2
When OneDrive sync is enabled, configuration is stored in:
%UserProfile%\OneDrive\Apps\GestureSign V2
Log files are stored in:
%LocalAppData%\GestureSign V2
Quick Start
- Open the Actions page and make sure gesture recognition is enabled.
- Select Global Actions or an app group on the left.
- Click New Action and record or draw a gesture pattern.
- Click Set Command and bind the gesture to a hotkey, browser action, window action, or system command.
- Return to the desktop or target app and trigger the gesture.
If an app already has system-level or built-in gestures, such as Windows 11 touchpad gestures or Microsoft Edge mouse gestures, you can enable the related preference options on the Options page.
Pages
- Actions: Manage global actions, app actions, groups, gestures, and commands.
- Ignore: Exclude apps, windows, or matching rules from gesture recognition.
- Gestures: View, import, export, retrain, and organize the gesture library.
- Quick Actions: Select Kando menus, sync hotkeys, open Kando settings, or test the radial menu.
- Edge Interaction: Configure touchpad and touchscreen edge taps and edge swipes.
- Options: Adjust trail color, width, opacity, input devices, fullscreen exclusions, and startup behavior.
- About: View the version, project links, logs, and maintenance information.
Compatibility
- Recommended OS: Windows 11 x64. The Microsoft Store package also includes x64 and ARM64 variants.
- Current packages: x64 MSI and x64 portable ZIP; the Store upload package contains x64 / ARM64 variants. No x86 package is produced.
- Windows 10 may run some features, but Windows 11 is the primary target.
Feedback
When reporting gesture, recording, saving, or UI issues, please include:
- Windows version and display scaling.
- Whether you are using mouse gestures or touchpad gestures.
- Target app name and whether it is fullscreen.
- Logs from the About page.
- Screenshots or reproduction steps.
Credits
Thanks to TransposonY/GestureSign, HighSign, MahApps.Metro, WGestures, and the projects this work builds on.
Quick Actions can download the Kando radial-menu component on demand. Kando is not bundled with GestureSign by default and can be installed or removed separately in the app. Kando remains an independent MIT-licensed project, and the downloaded component retains its LICENSE and Chromium license files.
Support the project
If GestureSign V2 is useful to you, you can support its continued development via WeChat Pay. Every contribution is appreciated.
日本語
GestureSign V2 は、クラシックなオープンソースプロジェクト TransposonY/GestureSign を Windows 11 向けに再構築したバージョンです。
元の GestureSign は長い間積極的にメンテナンスされていません。新しい Windows 環境では、修飾キーが押されたままになる、UI の挙動が古い、高 DPI 環境で表示が崩れる、ジェスチャー入力が安定しない、といった問題が起こることがあります。GestureSign V2 は従来のジェスチャーワークフローを保ちながら、Windows 11 での体験を改善し、設定画面をモダンな WinUI 3 デザインへ移行しています。
主な機能
- Windows 11 の角丸、Mica スタイル、ライト / ダークテーマに対応した WinUI 3 インターフェイス。
- タッチパッド、タッチスクリーン、マウスジェスチャー、ジェスチャー軌跡、ジェスチャーサムネイルプレビュー。
- Kando のオプションコンポーネントを必要なときにダウンロードできる Quick Actions ページと、専用ホットキーによる呼び出し。
- タッチパッドとタッチスクリーンのエッジタップ / エッジスワイプを設定できる Edge Interaction ページ。
- エッジジェスチャーは通常のアプリグループにも追加でき、アプリ別アクションを優先し、見つからない場合はグローバルアクションへフォールバックします。
- 実行ファイル、ウィンドウクラス、タイトル、グループによるアプリ別アクション管理。
- ホットキー、ブラウザー操作、ウィンドウ操作、メディア制御、システム操作などの一般的なコマンド。新規アクション作成時に初期コマンドも同じダイアログで設定できます。
- 特定のアプリ、ウィンドウ、マッチングルールを除外できる無視リスト。
- Windows タッチパッドジェスチャーやブラウザー内蔵ジェスチャーを優先するオプションと、全画面除外設定。
- OneDrive 同期を有効にすると、設定を
OneDrive\Apps\GestureSign V2 に保存し、OneDrive でデバイス間同期できます。
- トレイアイコン、トレイメニュー、単一インスタンス起動、読みやすいジェスチャーログ、トレイからの一時停止 / 再開。
- 90 種類の Windows 言語／地域バリアント。アラビア語、ペルシア語、ヘブライ語、ウルドゥー語、ウイグル語では右から左のレイアウトに対応します。
- 高 DPI および高リフレッシュレート環境向けの UI と入力体験の改善。
ダウンロード
Microsoft Store（推奨）
WinGet
GestureSign V2 は Windows Package Manager からインストールできます:
winget install --id Tomclanc.GestureSignV2 --source winget
最新のポータブル版は Releases からも入手できます。
現在のバージョン:
18.2.2 の更新内容
- Edge などのアプリグループに専用アクションがある場合でも、ライブプレビューがジェスチャー単位でグローバルアクションへフォールバックするよう修正しました。
- ライブアクション表示は現在の完全な軌跡だけを反映し、軌跡を延長して一致しなくなった時点で即座に消去します。
- 指を離した時またはキャンセル時に、最終認識とアクション実行より先に表示レイヤーを同期的に消去し、点滅や残留を防止します。
- フィルターで拒否された 1 本指のタッチパッドフレームが表示ライフサイクルを作成・占有しないようにしました。
過去のバージョン
18.2 ではタッチパッド／タッチスクリーンの 4 辺への音量・スクロール割り当て、連続音量調整、複数指の誤検出防止改善を追加しました。18.1.4 以前では、UI とトレイメニューを 90 種類の Windows 言語／地域バリアントへ拡張し、RTL レイアウト、Kando のアップグレード移行とアーキテクチャ自動選択を追加しました。また、マウスクリックの遮断、軌跡の不透明度、ゲームでのタッチ遮断、全画面判定、タイトルバーとトレイのタッチ、エッジ操作、「アプリを起動」などを修正しました。完全な履歴は GitHub Releases をご覧ください。
インストール
推奨:
winget install --id Tomclanc.GestureSignV2 --source winget
手動インストール:
- MSI または MSIX インストーラーをダウンロードします。
- インストーラーをダブルクリックし、画面の案内に従ってセットアップを完了します。
- デスクトップショートカットまたはスタートメニューから
GestureSign V2 を開きます。
- Actions ページでジェスチャー認識を有効にし、必要に応じてアプリ、ジェスチャー、コマンドを追加します。
設定ファイルは次の場所に保存されます:
%AppData%\GestureSign V2
OneDrive 同期を有効にした場合、設定ファイルは次の場所に保存されます:
%UserProfile%\OneDrive\Apps\GestureSign V2
ログファイルは次の場所に保存されます:
%LocalAppData%\GestureSign V2
クイックスタート
- Actions ページを開き、ジェスチャー認識が有効になっていることを確認します。
- 左側で Global Actions またはアプリグループを選択します。
- New Action をクリックし、ジェスチャーパターンを記録または描画します。
- Set Command をクリックし、そのジェスチャーにホットキー、ブラウザー操作、ウィンドウ操作、またはシステムコマンドを割り当てます。
- デスクトップまたは対象アプリに戻り、ジェスチャーを実行します。
アプリが Windows 11 のタッチパッドジェスチャーや Microsoft Edge のマウスジェスチャーなど、システムまたはアプリ内蔵のジェスチャーを持っている場合は、Options ページで関連する優先オプションを有効にできます。
ページ
- Actions: グローバルアクション、アプリアクション、グループ、ジェスチャー、コマンドを管理します。
- Ignore: ジェスチャー認識から除外するアプリ、ウィンドウ、マッチングルールを設定します。
- Gestures: ジェスチャーライブラリの表示、インポート、エクスポート、再学習、整理を行います。
- Quick Actions: Kando メニューの選択、ホットキー同期、Kando 設定の起動、ラジアルメニューのテストを行います。
- Edge Interaction: タッチパッドとタッチスクリーンのエッジタップ / エッジスワイプを設定します。
- Options: 軌跡の色、幅、透明度、入力デバイス、全画面除外、起動動作を調整します。
- About: バージョン、プロジェクトリンク、ログ、メンテナンス情報を確認します。
互換性
- 推奨 OS: Windows 11 x64。Microsoft Store パッケージには x64 と ARM64 の両方を含めています。
- 現在のパッケージ: x64 MSI、x64 ポータブル ZIP、x64 / ARM64 を含む Store アップロード パッケージ。x86 パッケージは生成しません。
- Windows 10 でも一部機能は動作する可能性がありますが、主な対象は Windows 11 です。
ポータブルパッケージの検証
リリース前に、ポータブル展開先の必須ファイルと不要な診断ファイルを検証できます。PowerShell で次を実行してください。
.\tools\Test-PortablePackage.ps1 -PackagePath .\publish\portable -MinimumFileCount 200
この検証では WinUI とバックエンドのエントリポイント、主要 DLL の存在を確認し、PDB / ダンプ / 診断ログ、および同梱された Kando 実行ファイル・ライブラリを拒否します。
MSI を生成せず、検証済みのポータブル Payload だけを作成する場合は、次を使用できます。
.\installer\Build-GestureSignV2-KandoMsi.ps1 -PayloadOnly -PublishDir .\publish\portable
ビルド警告の回帰防止
CI はビルドログ中の警告をファイル・行・警告コード単位で正規化し、tools/warning-baseline.json と比較します。既存の警告は直ちにビルドを止めませんが、新しい警告地点が追加されると CI が失敗します。ローカルでは次のように実行できます。
dotnet build GestureSign.Daemon/GestureSign.Daemon.csproj -c Release *> daemon-build.log
dotnet build GestureSign.WinUI/GestureSign.WinUI.csproj -c Release *> winui-build.log
.\tools\Test-WarningBaseline.ps1 -LogPath daemon-build.log,winui-build.log
現在のローカル基線は 0 個の警告位置です。新しい警告地点が追加された場合は CI が失敗します。-UpdateBaseline は警告を意図的に修正した後にのみ使用してください。
フィードバック
ジェスチャー、記録、保存、UI 表示に関する問題を報告する場合は、次の情報を含めてください。
- Windows のバージョンとディスプレイの拡大率。
- マウスジェスチャーまたはタッチパッドジェスチャーのどちらを使用しているか。
- 対象アプリ名と、全画面表示かどうか。
- About ページのログ。
- スクリーンショットまたは再現手順。
クレジット
TransposonY/GestureSign、HighSign、MahApps.Metro、WGestures、および本プロジェクトの基礎となった各プロジェクトに感謝します。
Quick Actions では、Kando のラジアルメニューをオプションコンポーネントとして必要なときにダウンロードできます。Kando は GestureSign に既定では同梱されず、アプリ内で個別にインストールまたは削除できます。Kando は MIT License の独立したオープンソースプロジェクトで、ダウンロードしたコンポーネントには LICENSE と Chromium 関連のライセンスファイルが保持されます。
プロジェクトを支援
GestureSign V2 が役に立った場合は、WeChat Pay の赞赏码から継続開発を支援できます。ご支援ありがとうございます。