admin9webs
322b7737eb
来源：紫鸟帮助中心/博客/主站资讯 + HubStudio API 文档/帮助中心 + 三个官方 skill 仓库。 只入库 Markdown 与元数据；原始 HTML 与 tarball 留在本机。
2.5 KiB
2.5 KiB
客户端 Schema URL 协议
本文件是 ziniao-sso-doc 的 Level 2 参考文档。 仅在需要查阅 superbrowser:// Schema URL 的详细参数与用法时加载。
概述
通过 superbrowser:// 自定义 URL 协议控制紫鸟浏览器，支持打开/关闭账号和退出程序。
调用方式有两种：
- 浏览器链接：在浏览器地址栏打开
superbrowser://...（需通过安装程序安装紫鸟） - 命令行：
SuperBrowser.exe "superbrowser://..."（需主程序路径正确）
Action: OpenStrore（打开账号）
完整示例
superbrowser://OpenStrore?storeId=xxxxxxx&openapiToken=xxxxxxxxx&userId=xxxxxxx&lanuchUrl=aHR0cHM6Ly93d3cuYmFpZHUuY29t&autoopen=true&debuggPort=60001¬PromptForDownload=1&forceDownloadPath=Rjpc5a6J6KOF5YyF --disable-gpu start-maximized
必须参数
| 参数 | 说明 |
|---|---|
| storeId | 账号 ID |
| userId | 紫鸟的用户 ID（如果发生变化需要重新登录） |
| openapiToken | 鉴权 token（通过 user-login 接口获取） |
如果本地已登录紫鸟客户端，且 userId 与本地登录用户一致，openapiToken 可不传（客户端版本 v5.290 或 v6.25 以上）。
可选参数
| 参数 | 说明 |
|---|---|
| lanuchUrl | 将要打开的目标地址，需 Base64 编码（如 https://www.baidu.com → aHR0cHM6Ly93d3cuYmFpZHUuY29t） |
| autoopen | 设为 true 时自动打开 lanuchUrl 配置的地址 |
| debuggPort | 指定 debug 端口号 |
| notPromptForDownload | 1=下载文件不弹出选择路径提示框，直接下载；0 或不传则弹出选择路径提示框 |
| forceDownloadPath | 设置默认下载路径，路径需 Base64 编码 |
命令行参数
命令参数添加在链接后面，用空格隔开，多个参数也用空格隔开。
添加的命令参数需要向管理员申请使用权限，否则不生效。
响应结果
启动紫鸟浏览器并打开对应账号。
Action: exit（退出浏览器）
请求格式
superbrowser://exit
说明
退出紫鸟浏览器程序，关闭所有账号。
如果上次打开的程序未完全退出，下次调用打开账号将会发生异常。建议在重新打开前先调用 exit。
Action: CloseStrore（关闭账号）
请求格式
superbrowser://CloseStrore?storeId=268682156400
参数
| 参数 | 说明 |
|---|---|
| storeId | 要关闭的账号 ID |
说明
关闭指定账号，每次只能关闭 1 个账号。如需关闭多个，需多次调用。