FQXCS/web-desktop

README 摘要

WebDesktop 桌面启动器 一个 Windows 桌面 GUI 程序：点击桌面图标启动后打开窗口，在后台执行 web 服务的启动命令； 服务启动期间窗口显示「正在启动服务」等待动画，服务就绪后自动跳转到配置的地址 （如 http://127.0.0.1:3080 ）。浏览器内核使用系统自带 Edge（WebView2） 。 功能特性 - 后台启动任意 web 服务命令（可配置），无需命令行窗口 - 等待期间展示加载动画与计时，就绪后自动跳转目标地址 - 配置文件保存在 /.WebDesktop/config.json ，首次运行时自动创建 - 首次运行（或启动时发现任意参数为空）首页进入图形化配置页面：全部参数必填， 除 web command / web url 外的高级设置默认折叠，保存后自动重启 - 启动失败 / 进程退出 / 超时均展示错误页，附服务日志尾部，支持「重试」「打开配置」 - 跳转到目标网页后，右键弹出内置自定义菜单（白底黑字：刷新页面 / 复制 / 粘贴 / 打开配置页），替换页面自身右键菜单，并强制启用文本选择便于复制 - 从右键菜单进入的配置页以全屏遮罩覆盖在目标网页上：不刷新页面、服务保持运行， 右上角「✕」（或 Esc）关闭后目标网页原样保留；错误页进入的配置页同样带「✕」， 关闭后返回错误页；首次启动的配置页无此按钮 - 关闭窗口自动清理服务进程树（可配置） - 单文件 exe 分发，双击即用 目录结构 配置文件不随项目分发，首次运行时自动在用户家目录创建： /.WebDesktop/config.json （Windows 上即 C:\Users\ \.WebDesktop\config.json ）。 其中 表示用户家目录， 从环境变量解析 ：Windows 读取 USERPROFILE （缺失时用 HOMEDRIVE + HOMEPATH 拼接），Linux/macOS 读取 HOME 。 配置文件说明（ /.WebDesktop/config.json） 配置项 说明 默认值 web command 服务启动命令（完整命令行字符串，含空格的路径用双引号包裹） 无默认值，必填 web url 服务就绪后跳转的地址（也是健康检查地址） 无默认值，必填 working dir 服务进程工作目录 /.WebDesktop log dir 日志目录（服务日志与程序日志） /.WebDesktop startup timeout 等待服务就绪的超时秒数 60 check interval 健康检查轮询间隔（秒） 0.5 check timeout 单次健康检查超时（秒） 2 window title 窗口标题 Web 桌面启动器 window size 窗口尺寸 [宽, 高] [1200, 800] show console…

分类