一键运行 OneClickRun

一键运行工具：以游戏快捷轮盘的形式，通过全局快捷键呼出一个圆形扇区轮盘，快速启动软件、打开文件夹、打开网址或运行脚本。基于 WinUI 3 + C#（.NET 8），面向 Windows 10 / Windows 11。

功能特性

圆形轮盘，扇区数量与快捷指令数量一致（上限 12 个，默认 5 个演示指令）
全局快捷键呼出/隐藏轮盘（默认 Ctrl+Alt+Q）
三种呼出方式：点击显示、长按显示、按住显示（松开即隐藏）
三种选择方式：单击选择、双击选择、滑动选择（仅按住显示时有效）
轮盘显示位置：屏幕中心 / 鼠标位置
指令类型：打开软件、打开文件夹、打开网址、运行 PowerShell 脚本（.ps1/.cmd/.bat）
主设置界面：常规（开机启动、轮盘全局开关、主题）、行为、快捷指令、关于
系统托盘：点击设置窗口关闭按钮最小化到托盘，左键点击托盘图标恢复设置窗口，右键菜单提供「启用/关闭轮盘」「设置」「退出」
日间/夜间/跟随系统主题
轮盘点击外部、Esc 或 8 秒超时自动关闭

目录结构

One_click_run/
├── OneClickRun.sln
├── Directory.Build.props
├── requirements.md               # 开发需求文档
├── scripts/
│   ├── smoke.ps1                 # 冒烟测试：启动→呼出轮盘→Esc 关闭
│   ├── e2e.ps1                   # 端到端测试：11 个场景
│   ├── gen-icon.ps1              # 生成应用图标
│   └── probe-hotkey.ps1          # 探测系统快捷键占用
├── src/
│   ├── OneClickRun.Core/         # 纯逻辑：设置、指令执行、轮盘几何、快捷键解析
│   └── OneClickRun.App/          # WinUI 3 应用：窗口、页面、控件、服务
└── tests/
    └── OneClickRun.Core.Tests/   # 单元测试（xUnit）

环境要求

运行环境：Windows 10（19041 及以上）或 Windows 11
开发环境：.NET 8 SDK、Windows App SDK 2.4.0（NuGet 自动还原）
Release 自包含版本已将 .NET 8 运行时与 Windows App SDK 运行时打包进应用目录，最终用户无需手动安装 .NET 环境

构建与运行

# 构建
dotnet build OneClickRun.sln

# 运行（调试构建输出）
src\OneClickRun.App\bin\x64\Debug\net8.0-windows10.0.19041.0\win-x64\OneClickRun.exe

# 发布 Release 自包含版本（含 .NET 运行时，无需用户安装 .NET）
dotnet publish src\OneClickRun.App\OneClickRun.App.csproj -c Release -r win-x64 --self-contained true -o dist\publish\win-x64

# 将发布目录压缩为分发包
powershell Compress-Archive -Path dist\publish\win-x64\* -DestinationPath dist\OneClickRun-0.2.1-win-x64.zip

Release 发布产物位于 dist\ 目录（已加入 .gitignore）；最终用户解压后直接运行 OneClickRun.exe 即可，无需安装 .NET 或 Windows App SDK。

使用说明

默认快捷键 Ctrl+Alt+Q 呼出轮盘；在「呼出与快捷键」页可修改
「常规」页可设置开机启动、轮盘全局开关与主题模式
「快捷指令」页可新增/编辑/删除/排序指令，并支持「测试运行」
点击设置窗口右上角关闭按钮不会退出程序，而是最小化到系统托盘；左键单击托盘图标恢复设置窗口，右键菜单可切换轮盘全局开关、打开设置或退出程序
设置保存在 %APPDATA%\OneClickRun\settings.json
日志位于 %APPDATA%\OneClickRun\logs\app.log

测试

# 单元测试（62 个）
dotnet test OneClickRun.sln

# 冒烟测试（需要图形会话）
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\smoke.ps1

# 端到端测试（11 个场景；需要图形会话）
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\e2e.ps1

注意：e2e.ps1 会临时写入并恢复 %APPDATA%\OneClickRun\settings.json、临时写入并恢复开机启动注册表项，并会启动/关闭记事本等测试进程。

4.0 KiB Raw Blame History Unescape Escape