魔术角（Magic Corner）使用说明书

一款通过屏幕边缘热区快速触发常用操作的 Quicker 动作

---

1. 什么是魔术角

魔术角会在屏幕的四角和四边中点和自定义矩形区域绘制半透明色块，鼠标进入色块并满足触发条件（悬停 / 按键 / 滚轮 / 滑动等）时，自动执行你预设的动作，例如：

• 调音量 / 切歌 / 静音
• 显示桌面 / 任务视图
• 调屏幕亮度
• 运行 Quicker 其他动作
• 执行任意 Win+R 命令

核心特点

特点	说明
免快捷键	悬停即可触发，不用记组合键
多触发方式	悬停 / 按键 / 鼠标键 / 滚轮 / 滑动 / 双击，可组合
可视化配置	图形化设置窗口，支持拖拽区域、拖拽排序
立即生效	保存后立即生效，无需重启
持久化	所有配置自动保存，下次启动自动加载

---

2. 启动与入口

2.1 首次启动

运行动作后，屏幕边缘会出现 8 个半透明色块，同时系统托盘会出现一个魔术角图标。

2.2 三种进入设置的方式

方式	操作
托盘图标（推荐）	右键托盘图标 → "打开设置"，或直接双击图标
托盘菜单	右键托盘图标 → 选择所需功能
热键（需自行配置）	默认无热键，可在设置里指定

2.3 托盘菜单一览

打开设置(S)...
显示 / 隐藏色块(V)
圈选添加区域(R)
-------------
停止监听(Q)

2.4 首次启动气泡提示

首次运行时，托盘图标会弹出一条气泡提示："已启动。右击托盘图标可打开设置。" — 这是提醒你入口位置。

---

3. 设置界面总览

设置窗口分为三个页面，通过左侧竖向导航栏切换：

┌─────────────┬──────────────────────────────────┐
│  魔术角      │                                  │
│  Magic Corner│        区域与动作 / 热键          │
│              │        时间与提示                 │
│ ▸ 区域与动作  │                                  │
│   热键       │        （内容区）                 │
│   时间与提示  │                                  │
│              │                                  │
│  v56.45      │                                  │
├─────────────┴──────────────────────────────────┤
│  [圈选] [色块] [停止] [导入] [导出] [启用全部]    │
│  [停用全部] [删除全部]          [保存并应用] [关闭]│
└────────────────────────────────────────────────┘

---

4. 区域与动作（核心）

4.1 表格列说明

列	说明	示例
ID ▲	区域标识，可点击表头排序	a / b / x1
区域	位置或矩形坐标	tl / rect:100,100,200,150
动作	内置动作名（右键菜单可选）	volume_up / action:xxx
外部动作	Win+R 命令，多个用 / 分隔	notepad / calc
描述	触发时提示的文字	左上角/音量+
悬停ms	悬停多少毫秒后触发	600（默认）
悬停	☑ 表示悬停触发此区域	☐
双击触发	☑ 表示左键双击触发	☐
按键	热键 / 鼠标键	Ctrl+Alt+X / 右键
滚轮	滚轮上下	滚轮上 / 滚轮下
滑动	左键拖拽方向	滑动 / 滑动右
尺寸	角区域填边长；边中区域填深度,千分数	26 / 14,120
位置%	边中区域沿边位置百分比	50（正中）
颜色	RGB[,A]，双击可打开取色器	255,80,80,128
启停 / 删除	行内操作按钮	—

4.2 区域类型

预置区域（8 个）

代号	位置	默认动作	默认颜色
tl	左上角	volume_up	红
tr	右上角	volume_down	橙
bl	左下角	show_desktop	蓝
br	右下角	media_play	紫
tm	上边中	none	黄
bm	下边中	none	青
lm	左边中	none	绿
rm	右边中	brightness_down	粉

自定义矩形区域

格式：rect:x,y,w,h（屏幕像素坐标）

rect:100,100,200,150    ← 左上角 (100,100)，宽 200，高 150

矩形区域时，"尺寸"列和"位置%"列留空。

4.3 触发键详解

"按键"列支持多种触发方式，用 / 分隔多个：

触发键	含义
悬停	鼠标停在区域内满"悬停ms"后触发
左键	单击左键
右键	单击右键
中键	单击中键
侧键1 / 侧键2	鼠标侧键
滚轮上	向上滚动滚轮
滚轮下	向下滚动滚轮
滑动	左键拖拽任意方向
滑动上/下/左/右	指定方向滑动
Ctrl+Alt+X 等	键盘热键（区域内按下）

示例

悬停                      ← 只悬停触发
悬停/滚轮上                ← 悬停或滚轮上触发
Ctrl+Shift+A/左键          ← 热键或左键触发

提示：单元格右键弹出可选菜单，包括所有内置动作、外部命令、鼠标键和滑动方向。

4.4 描述与提示文字

"描述"列的文字会显示在悬停提示中：

区域 a：volume_up · 左上角/volume_up · 触发方式「悬停，滚轮上」

格式：区域 [ID]：[动作] · [描述] · 触发方式「[触发键列表]」

4.5 行内操作

按钮	功能
启停	切换当前行启用/停用状态（停用行显示为灰色）
删除	删除当前行

---

5. 热键设置

用于配置全局热键（在任意位置按下都能触发），默认全部为空（禁用）。

设置项	说明
色块 显示/隐藏	切换所有色块是否显示
圈选添加区域	进入圈选模式：按住左键在屏幕上拖拽出一个矩形
打开设置窗口	打开本设置窗口
停止监听	停止动作运行
查看提示键（可选）	按下后显示鼠标所在区域的提示信息

5.1 设置方法

1. 点击对应输入框（框变灰表示已就绪）
2. 按下想要的组合键，例如 Ctrl+Alt+V
3. 按 Esc 清空当前热键
4. 点击"保存并应用"生效

5.2 冲突检测

保存时会自动检测：

• 热键格式是否合法（如 Ctrl+Alt 无主键会报错）
• 四个热键之间是否重复

---

6. 时间与提示

设置项	取值范围	说明
触发冷却毫秒	060000	两次触发之间的最小间隔，0=不冷却
	触发键悬停提示开关	开/关	是否显示悬停提示气泡
	悬停多久后显示提示	010000	悬停多少毫秒后弹出提示（建议 5001000）
	提示显示后停留毫秒	50010000	提示气泡停留时长

悬停提示效果

当鼠标在区域内悬停到设定时长，屏幕上会弹出一个深色气泡：

区域 a：volume_up · 左上角/volume_up · 触发方式「悬停」

提示位置会自动避让屏幕边缘（在屏幕右侧时翻到鼠标左侧）。

---

7. 底部按钮说明

按钮	快捷键	功能
圈选(R)	Alt+R	进入圈选模式（同热键）
色块(V)	Alt+V	显示/隐藏所有色块
停止(Q)	Alt+Q	停止动作运行（等于关闭）
导入配置(I)	Alt+I	从 .txt 文件导入区域配置
导出配置(E)	Alt+E	把当前配置导出为 .txt
启用全部(A)	Alt+A	把所有区域设为启用状态
停用全部(T)	Alt+T	把所有区域设为停用状态（保留配置）
删除全部(D)	Alt+D	清空所有区域配置（不可撤销）
保存并应用(S)	Alt+S	保存当前配置并立即生效
关闭	—	关闭设置窗口（不保存）

快捷键使用：Alt+字母 或 Alt 抬起后短按字母。

---

8. 配置文件格式

魔术角的配置存储为一个变量 cornerConfig，格式为每行一条记录，字段之间用 | 分隔：

区域|动作|悬停ms|尺寸|位置%|颜色|ID|状态|触发键|描述|外部动作|双击

8.1 字段详解

#	字段	说明	可空
1	区域	tl/tr/bl/br/tm/bm/lm/rm 或 rect:x,y,w,h	✗
2	动作	内置名或 action:xxx，多个用 / 分隔	✓
3	悬停ms	数字，默认 600	✓
4	尺寸	角：边长；边中：深度,千分数	✓（用默认值）
5	位置%	边中区域沿边位置 1~99	✓（默认 50）
6	颜色	R,G,B[,A]，A 默认 128	✓（用预置色）
7	ID	显示用的短标识	✓
8	状态	0=停用，留空=启用	✓
9	触发键	多个用 / 分隔	✓
10	描述	提示文字	✓
11	外部动作	Win+R 命令，多个用 / 分隔	✓
12	双击	1=启用左键双击触发	✓

8.2 默认配置示例

tl|volume_up|600|26||255,80,80,128|a|||左上角/volume_up||
tr|volume_down|600|26||255,160,0,128|b|||右上角/volume_down||
bl|show_desktop|600|26||80,140,255,128|c|||左下角/show_desktop||
br|media_play|600|26||170,110,255,128|d|||右下角/media_play||
tm|none|600|14,120|50|255,220,60,128|e|||上边中||
bm|none|600|14,120|50|60,210,220,128|f|||下边中||
lm|none|600|14,120|50|110,220,110,128|g|||左边中||
rm|brightness_down|600|14,120|50|255,110,190,128|h|||右边中/brightness_down||

8.3 导入/导出

• 导出：点"导出配置(E)" → 选择保存位置 → 得到 .txt 文件
• 导入：点"导入配置(I)" → 选择 .txt 文件 → 自动解析并立即生效
• 导入后会自动同步到全局配置和状态存储（下次启动仍然生效）

---

9. 内置动作与触发方式速查

9.1 内置动作列表

动作名	功能
volume_up	音量 +
volume_down	音量 −
volume_mute	静音/取消静音
media_play	播放/暂停
media_next	下一曲
media_prev	上一曲
show_desktop	显示桌面（Win+D）
task_view	任务视图（Win+Tab）
brightness_up	屏幕亮度 +10
brightness_down	屏幕亮度 −10
none	无动作（占位）

9.2 调用其他 Quicker 动作

在"动作"列填：

action:动作ID或名称

9.3 运行外部命令（Win+R）

在"外部动作"列填：

notepad
calc
ms-settings:display
quicker:runaction:动作标识  //外部运行qk动作

多个命令用 / 分隔：

notepad/calc

---

附录：快捷操作一览

操作	快捷键
圈选添加区域	Alt+R
显示/隐藏色块	Alt+V
停止动作	Alt+Q
导入配置	Alt+I
导出配置	Alt+E
启用全部	Alt+A
停用全部	Alt+T
删除全部	Alt+D
保存并应用	Alt+S