better-dsh-webui-launcher

以"零额外安装"为设计原则：仅凭一个官方插件与 Windows 原生机制，让 DeepSeek Harness Web UI 获得桌面 App 式的一键启动体验。

设计理念

不额外安装任何东西。以官方 DeepSeek Harness 为中心，通过官方支持的插件机制，尝试拼出类似桌面端的体验。

• 🧊 零额外安装：不引入 Electron / Python / WebView2 等任何重型桌面端或运行时——只有官方 dsh 插件 + Windows 自带机制（wscript / powershell / cmd / NotifyIcon / AppsFolder）。装进 profile 即用，卸载即干净。
• 🎯 以官方为中心：不魔改、不替换官方 Web UI，一切围绕官方版本做加法；插件本身也只是标准 dsh bundle patch，官方升级后依然兼容。
• 🪶 轻量体验优先：适合想获得"桌面 App"般手感、又不想额外下载软件的人——装一个插件，换来快捷方式、托盘、独立应用窗口。
• 🔌 原生能力借用：浏览器本身就是最好的"桌面壳"——PWA 安装、--app 独立窗口、系统应用注册，这些官方浏览器能力直接借用，不为小众需求自造轮子；同时也为"想深度适配浏览器生态"的用户保留了路径（安装为应用后任务栏/开始菜单/可固定全部由系统管理）。

一句话：用最小的插件代价，换取最接近原生的桌面体验；不装软件，只用官方的东西。

版本状态

✅ v0.1（当前）—— 桌面化基础体验

• 桌面快捷方式（官方图标）+ 静默启动（无黑窗）
• TCP 端口探测：已运行则直连，未运行才启动（不重复启动）
• 已安装 PWA 应用优先打开：装过应用的直接打开应用窗口，未安装自动回退浏览器
• 系统托盘（打开 / 停止 / 退出）
• 安装引导模态框（白底，一键唤出浏览器原生安装流程）
• 设置页增强 section（查看配置 / 重建快捷方式）
• 官方 DSH 图标全入口统一

🚧 下一步（规划中）

• v0.2 关闭语义：关闭 WebUI 窗口 = 优雅退出后台服务（客户端断开检测 + 任务检查 + ctx.fiber.dispose() 持久化 flush），有任务在跑时不退出
• 应用内退出按钮：页面内一键退出（检查任务 → 确认 → 优雅关闭），把"关闭应用"从浏览器 X 挪到应用内
• 多浏览器适配：Chrome / Firefox 的 PWA 安装引导差异化处理
• 可配置性扩展：更多配置项（自定义托盘菜单、开机自启等）

完整设计验证见文末 设计验证：桌面端体验（Roadmap）。

特性

• 🖱️ 桌面快捷方式：安装即生成（默认名 DSH WebUI，官方 DSH 图标），双击即用；幂等——已存在则跳过，指向错误/图标变更自动重建，设置页可强制重建
• 🤫 静默启动：wscript 隐藏窗口，无 cmd 黑窗、无闪屏
• 🔌 TCP 端口探测：实例已在运行 → 直接打开连上；未运行 → 才启动（不会 EADDRINUSE 失败；对 0.0.0.0 / 127.0.0.1 / [::] 监听形态免疫）
• 🖥️ 已安装应用优先打开：若 Edge/Chrome 已把站点安装为 PWA 应用，快捷方式直接打开已安装的应用窗口（独立任务栏、无地址栏、官方图标）；未安装时按 openMode 回退（--app 独立窗口 / / 默认）