双击 MagicDeck.exe 即可，不需要安装，也不会往系统里写东西。
首次启动会弹出一个桌面窗口（不是浏览器标签页），这就是控制台。
如果 Windows 提示「已保护你的电脑」，点「更多信息」→「仍要运行」。 这是因为程序没有购买代码签名证书，不是病毒。
系统要求：Windows 10 / 11 64 位。
在电脑控制台点右上角「连接手机」，会弹出两个二维码：
MagicDeck.apk 并安装。也可以直接把随包附带的 MagicDeck.apk 传到手机上安装。
手机必须和电脑在同一个 WiFi 下。一个连 WiFi、一个用流量是连不上的。
系统要求：安卓 8.0 及以上。
首次启动会提示激活。在控制台「系统设置 → 软件授权」：
激活成功后可以完全离线使用，最长 30 天不联网。超过 30 天需要联一次网续签， 点一下「立即验证」几秒钟就好。
在旧电脑上点「解绑本机」，然后在新电脑上用同一个授权码激活即可。 每年最多解绑 5 次，够正常换机和重装系统用。
如果旧电脑已经坏了、系统已经重装了、来不及解绑，联系客服帮你远程解绑，不额外收费。
手机能控制电脑的键盘鼠标，所以不能让同一个 WiFi 下的任何人随便连上。 咖啡厅、公司、宿舍、酒店这些网络下尤其要注意。
因此首次连接需要配对，配对方式都要求你人在电脑跟前：
| 场景 | 怎么做 |
|---|---|
| 扫码连接 | 扫二维码时自动完成配对，你什么都不用做 |
| 手动输 IP | 在「连接手机」弹窗里看 6 位配对码，输到手机上 |
二维码里的配对票据 5 分钟有效，且只能用一次，每次打开弹窗都会换一张新的。 配对码同样 5 分钟有效，可以随时点「换一个」。
「连接手机」弹窗下方列出所有配对过的设备，包含名称、IP 和最近使用时间。 点「解除」，那台手机会立刻断开，想再连必须重新扫码。手机丢了就用这个。
同一个弹窗里有个开关可以整体关掉。只在完全可信的网络下这么做， 比如家里独立的 WiFi。关掉之后，同一网络下任何人打开浏览器就能控制你的电脑。
这是你最常用的地方。左边是按钮网格，右边是属性栏。
顶部可以调整行数、列数、间距、圆角、光晕强度，手机端会实时跟着变。 「方向」可以切竖屏 / 横屏。
点空格子，然后在右侧属性栏设置：
按钮网格上方是页面标签。点「+」加页，右键标签可以重命名或删除。 手机上左右滑动切换页面。
| 动作类型 | 说明 | 例子 |
|---|---|---|
| 快捷键 | 发送组合键 | Ctrl+Shift+S 另存为 |
| 文本输入 | 自动打字 | 一键输入常用邮箱、话术 |
| 启动程序 | 打开软件或文件 | 打开 PS、打开某个项目文件夹 |
| 打开网址 | 用默认浏览器打开 | 一键进后台管理页 |
| 音量控制 | 调节 / 静音 | 直播时快速静音 |
| 媒体控制 | 播放暂停、上一首下一首 | — |
| 运行宏 | 执行一整套自动化 | 见下节 |
| 切换页面 | 跳到另一页按钮 | 做多层菜单 |
| 切换场景 | 整套配置切换 | 剪辑模式 → 直播模式 |
| 设置变量 | 改变一个值 | 配合条件显示用 |
| 插件动作 | OBS / Spotify 等 | 切场景、开关麦 |
| 语音输入 | 唤起语音识别 | 说话代替按键 |
「宏」是一串按顺序执行的操作，适合把重复劳动一键化。
在「自动化宏」页新建，可以往里加这些步骤：
不想手动一条条加，点「录制」，然后在电脑上正常操作一遍，回来点「停止」， 刚才的动作就变成宏了。录制期间控制台会自动最小化，不会把自己录进去。 停止后可以选择保存、丢弃或复原。
宏可以绑到按钮上，也可以在列表里直接点运行。运行时可以指定循环次数。
一套按钮配置叫一个「场景」。你可以为不同工作建不同场景：
场景可以绑定应用。比如把「剪辑场景」绑到 Premiere.exe，
那么每当你切到 Premiere 窗口，手机上的按钮会自动变成剪辑那一套，切走再自动变回来。
手机放着不动一段时间后，会自动进入表盘模式当桌面时钟用，轻触屏幕就回到控制台。
内置十来种样式：经典翻页钟、赛博红光、点阵、指针、车载仪表、日历条等等。 在「空闲表盘」页选择，可以设置多久后进入、是否显示日期。
在「MagicHub」页配置，配好之后就能在按钮里调用对应动作。
| 插件 | 需要填什么 | 能做什么 |
|---|---|---|
| OBS Studio | 开启 obs-websocket（默认端口 4455），填端口和密码 | 切场景、开关来源、开始/停止录制推流、静音 |
| Spotify | 可先直接用媒体键；填 Access Token 后走官方 API | 播放控制、切歌、看当前曲目 |
| Twitch | Client ID、Token、broadcaster_id | 改标题分类、发公告 |
| Home Assistant | http://homeassistant.local:8123 + 长期访问令牌 |
开关灯、调场景、控制家电 |
点手机上的麦克风按钮，或者设置唤醒词后直接说话。 在「系统设置」里可以自定义唤醒词和指令映射。
扫的是过期的旧二维码。在电脑上重新打开「连接手机」，扫新的码。
电脑 IP 变了，重新扫一次码即可。配对关系不受影响，不用重新配对。
联系客服续费，续费后不用重新安装，在原来的地方点「立即验证」即可。
一个授权码只能同时激活一台电脑。在原来那台上点「解绑本机」，或者联系客服远程解绑。
重装后机器指纹变了，系统会认为是另一台电脑。联系客服远程解绑一下即可。
配置和授权都存在这里：
%USERPROFILE%\.magicdeck\
├── config.json 所有按钮、场景、宏的配置
├── license.token 授权凭据
├── paired.json 已配对的手机
├── device.id 本机指纹
├── icons\ 你上传的图标
└── wallpapers\ 你上传的壁纸
换电脑想带走配置，把 config.json、icons、wallpapers
拷过去即可（license.token 和 device.id 不要拷，那是绑定本机的）。
微信扫描 产品页 上的二维码联系我们， 或致电 152-0142-7131。