url-scheme-handler

项目概述

URL Scheme Handler 用于给 Windows 应用添加自定义 URL Scheme，使浏览器网页能够直接唤起本地程序。添加注册表后，只要在网页中打开形如 ush://应用名?参数 的链接，系统就会把参数解压后传给对应应用执行。它常与外部播放器方案搭配使用，让网页里的视频链接一键交给本地播放器打开。

让网页一键唤起本地播放器，把视频链接直接交出去。

主要功能

• 注册 URL Scheme：一键点击即可写入所需的注册表项
• 应用映射：为应用名指定需要调用的本地程序，名称可自定义
• 参数压缩传递：参数经 gzip 压缩与 Base64 编码后随链接传递，接收端解压执行
• 可选勾选框：安装配套注册表后，首次运行可勾选自动允许，后续不再弹窗确认
• 与外部播放器搭配：与应用名称保持一致即可配合 external-player 等方案使用

适用人群

• 想把网页链接交给本地播放器打开的用户
• 使用脚本或书签快速调用本地程序的用户
• 需要为自研应用添加自定义协议的开发者

快速上手

1. 从 Releases 下载工具并运行
2. 点击「+ Add to Registry」添加注册表
3. 点击「+」添加应用，在左侧输入框填写应用名称，在右侧选择要调用的程序
4. 应用名称需与配套方案中的名称保持一致，大小写也要相同
5. 建议额外导入勾选框注册表，首次运行后可勾选自动允许，免去重复确认
6. 在网页中按 ush://应用名?参数 的格式打开链接即可唤起对应程序

核心优势

• 接入简单：写入注册表并建立应用映射即可使用
• 通用协议：任何能打开链接的网页或脚本都能触发
• 参数安全：参数先压缩再编码，避免特殊字符破坏链接
• 确认可免：导入勾选框注册表后，可跳过每次运行的确认弹窗

系统要求

项目	要求
操作系统	Windows
调用链接	ush://应用名?压缩参数
权限	写入注册表需要相应权限

注意事项

• 应用名称必须与配套方案中的名称完全一致，包括大小写
• 参数需先用 gzip 压缩再做 Base64 编码，接收端会解压后执行
• 弹出的系统确认框可通过导入勾选框注册表改为一次勾选、长期生效
• 该工具本身只负责转发调用，被唤起程序的行为由其自身决定