dsh-splash-launcher 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/DSH-GUI.exe CHANGED
Binary file
package/README.en.md CHANGED
@@ -26,18 +26,17 @@ Produces a self-contained `DSH-GUI.exe` (black-whale icon, assets embedded as re
26
26
 
27
27
  - Windows 10/11
28
28
  - Node.js + global `npm install -g @deepseek-ai/dsh`
29
- - Microsoft Edge or Google Chrome
29
+ - Microsoft Edge WebView2 Runtime (bundled with Windows 10/11 / Edge; [standalone installer](https://developer.microsoft.com/microsoft-edge/webview2/) if missing)
30
30
 
31
31
  ## Configuration
32
32
 
33
33
  - `DSH_GUI_WORKSPACE` env var, or a `workspace.txt` next to the exe — working directory for `dsh web` (default: your user profile `%USERPROFILE%`)
34
34
  - `DSH_GUI_PORT` — port (default `3080`)
35
+ - Window form is remembered: if you close the window maximized, it reopens maximized next time (only normal/maximized — size and position are not stored; delete `%LocalAppData%\DSH-GUI\window.state` to reset to the default normal window).
35
36
  - Splash assets are embedded in the exe; drop the same-named files (`splash.html`, `*.svg`, `whale.png`) next to the exe to override them (custom splash, no rebuild needed).
36
37
 
37
38
  ## Known issues
38
39
 
39
- 1. The taskbar briefly shows the Chrome/Edge default icon before the page favicon (black whale) loads; this is a browser-level placeholder and cannot be preset via command line.
40
- 2. Startup takes a while (dsh boot + browser cold start + plugin loading). The animation covers the whole wait and only fades out when the GUI is ready.
41
- 3. Unsigned launchers that start hidden processes / stop process trees may trigger SmartScreen or behavior-based antivirus heuristics; click "More info → Run anyway" on first run, add the folder to your AV exclusions, or code-sign the exe.
40
+ 1. Startup takes a while (dsh boot + browser cold start + plugin loading). The animation covers the whole wait and only fades out when the GUI is ready.
42
41
 
43
42
  See the Chinese [README](README.md) for full details. Code is MIT; brand assets derive from DeepSeek Harness (MIT, © 2026 DeepSeek).
package/README.md CHANGED
@@ -28,6 +28,7 @@
28
28
  - **启动器内做认证**:一次性启动 token 由启动器自己换成会话 cookie(不交给页面,避免一次性/进程绑定语义导致的失效),再注入 WebView2;WebView2 与 iframe 只访问干净的 `/`;
29
29
  - **无 PowerShell**:启动器是单个 C# 程序,无脚本进程,规避“PowerShell 木马”类安全软件启发式误报;
30
30
  - **开即启动、关即退出**:窗口关闭后自动结束本次启动的 `dsh web` 服务;端口已有服务时只开窗口、不接管生命周期;
31
+ - **记住窗口形态**:关闭时记住当前是「缩小」还是「最大化」,下次启动直接按上次形态打开。只记这两种形态,**不记具体尺寸与位置**(分屏、手动拖拽的长宽一律按缩小形态处理);记忆存于 `%LocalAppData%\DSH-GUI\window.state`,删掉该文件即回到默认缩小形态;在最小化状态下关闭时按最近一次非最小化形态记忆(不会把「最小化」记成「缩小」);
31
32
  - **可配置**:工作目录与端口可通过环境变量或 `workspace.txt` 修改;
32
33
  - **深浅色跟随**:启动动画与标题栏跟随 dsh 设置里的“外观”选项(浅色/深色/跟随系统);标题栏与 GUI 侧边栏同色:浅色极浅灰 `#f9fafb`(深色文字/图标),深色 `#1b1b1c`;
33
34
  - **开源友好**:单文件 C# 源码 + `build.cmd`,使用 Windows 自带 `csc.exe` 编译,无需外部工具链。
@@ -41,6 +42,8 @@
41
42
  3. 双击 `DSH-GUI.exe`。
42
43
 
43
44
  > 首次运行可能弹出 SmartScreen“Windows 已保护你的电脑”:点击 **更多信息 → 仍要运行**(exe 未代码签名,属正常提示)。
45
+ >
46
+ > 运行需要 Microsoft Edge WebView2 Runtime(Win10/11 随 Edge 自带,缺失时使用[独立安装包](https://developer.microsoft.com/microsoft-edge/webview2/)),缺失时窗口会提示安装,无浏览器回退模式。
44
47
 
45
48
  ### 方式二:源码构建
46
49
 
@@ -158,27 +161,16 @@ DSH-GUI.exe --selftest
158
161
 
159
162
  ## 已知问题
160
163
 
161
- ### 1. ~~任务栏图标会先闪一下 Chrome/Edge 默认图标~~ ✅ 已解决
162
- 旧版用浏览器 `--app` 窗口,任务栏按钮先使用浏览器进程自带图标,页面 `favicon` 加载完成后才切换,因此有一闪。已成为 WebView2 宿主后:窗口是启动器自己的,`Window.Icon`(黑鲸)在窗口创建时即设置,**任务栏从窗口出现那一刻就是黑鲸,不再闪默认图标**;标题栏颜色也随主题统一(深色 = 侧边栏深色 `#1b1b1c`,浅色 = 侧边栏浅灰 `#f9fafb`)。
163
-
164
- **新增:WebView2 Runtime 依赖**:运行需要 Microsoft Edge WebView2 Runtime(Win10/11 随 Edge 自带)。若缺失,窗口会提示安装,无法回退到浏览器 `--app` 模式。
165
-
166
- ### 2. 启动有一定等待时间
164
+ ### 1. 启动有一定等待时间
167
165
  启动时长主要来自:`dsh web` 服务引导 + 浏览器冷启动 + 前端插件装载,动画会覆盖绝大多数等待过程并持续到 GUI 就绪,属于“可见但基本不可压缩”的时间。首次运行、杀毒软件实时扫描、机械硬盘会进一步加长。启动器自身的路径解析已缓存(`resolved.cache`)且最早预热浏览器,能显著缩短总时长;动画节奏可在 `splash.html` 的 CSS 里调节。
168
166
 
169
- ### 3. SmartScreen / 安全软件可能误报(未签名 exe)
170
- 本程序会启动隐藏进程、结束后台进程、复制文件,这类“类管理工具”行为可能触发启发式防护(例如卡巴斯基 PDM:Trojan.Win32.Generic 对旧版 PowerShell 脚本的误报)。建议:
171
- - 首次运行若弹出 SmartScreen“Windows 已保护你的电脑”:点击 **更多信息 → 仍要运行**;
172
- - 将 `dsh-gui` 目录加入杀软排除项/受信任应用程序;
173
- - 正式分发时对 `DSH-GUI.exe` 做代码签名(本程序已不使用 PowerShell,命中率大幅降低)。
174
-
175
- ### 4. 端口已被占用时直接进入 GUI
167
+ ### 2. 端口已被占用时直接进入 GUI
176
168
  如果 `3080` 端口已有 `dsh web`(例如正在终端里使用),双击只会打开 GUI 窗口,不会显示启动动画,也不会在关窗时停止该服务——这是刻意设计,避免误杀已有会话。
177
169
 
178
- ### 5. 同源预加载依赖 dist 写入权限
170
+ ### 3. 同源预加载依赖 dist 写入权限
179
171
  启动器需要把 `splash.html` 等素材复制到 npm 全局的 `dsh-web-frontend/dist` 目录。若该目录不可写,会自动退回“文件页动画 → 就绪后直接跳转 GUI”模式(素材内嵌于 exe,此模式下自动释放到 `%LocalAppData%\DSH-GUI\assets`),此时会短暂看到官方 HARNESS 加载页。
180
172
 
181
- ### 6. 就绪判定依赖官方启动卡片
173
+ ### 4. 就绪判定依赖官方启动卡片
182
174
  浏览器 splash 以同源 iframe 里官方启动卡片(`_boot_*` class)消失判定 GUI 就绪;若官方前端改了启动卡片的 class 结构,可能需要同步更新 `splash.html` 里的 `appReady()` 判定。
183
175
 
184
176
  ## 许可证
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-splash-launcher",
3
- "version": "2.0.0",
3
+ "version": "2.0.1",
4
4
  "description": "DSH Windows one-click launcher: opens the browser splash animation immediately, boots dsh web, and reveals the GUI when ready; also registers the desktop_launch agent tool.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",