dsh-windows-tray 1.0.2 → 1.0.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 jankin_lv
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 jankin_lv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,146 +1,146 @@
-# dsh-windows-tray
-
-> DeepSeek Harness（dsh）的 Windows 系统托盘管家：**官方鲸鱼状态图标 + Web/TUI 双状态显示 + 一键启停**。
-> 纯 PowerShell + WinForms 实现，零依赖、无编译、不改 dsh 源码，卸载即还原。
-
-[![npm](https://img.shields.io/npm/v/dsh-windows-tray?style=flat-square)](https://www.npmjs.com/package/dsh-windows-tray)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-windows-tray?style=flat-square)](https://www.npmjs.com/package/dsh-windows-tray)
-[![Platform](https://img.shields.io/badge/platform-Windows%2010%2F11-blue?style=flat-square)](https://www.npmjs.com/package/dsh-windows-tray)
-[![License](https://img.shields.io/npm/l/dsh-windows-tray?style=flat-square)](https://github.com/)
-
-## 是什么
-
-dsh 默认在终端前台运行 `dsh web`——必须留着一个命令行窗口。本工具把它变成**一个标准的 Windows 托盘应用**：
-
-- 🐋 **状态一目了然**：品牌蓝鲸鱼 = Web 运行中；灰鲸鱼 = 未运行（图标由官方 favicon 渲染生成）
-- 📊 **DSH / TUI 双状态**：菜单顶部同屏显示 Web 与 TUI 各自的运行状态（含 PID），互不干扰
-- 🖱️ **零窗口操作**：双击开界面，右键通过 DSH / TUI 分组子菜单一键启停，不用再碰命令行
-- 👁️ **独立旁观者**：托盘是独立常驻进程，dsh 停止时它依然在（显示未运行 + 一键启动），退出托盘不影响 dsh
-- 🎨 **浅色圆角菜单**：白底、圆角、投影阴影，贴合现代桌面应用审美
-
-## 功能特性
-
-| 交互 | 行为 |
-| :--- | :--- |
-| **图标** | 蓝鲸鱼 = Web 运行中（PID）；灰鲸鱼 = 未运行 |
-| **悬停提示** | `Web UI 运行中 · 127.0.0.1:3088` / `Web UI 未运行 · 右键可启动` |
-| **双击** | 打开 Web UI（未运行先提示启动） |
-| **右键菜单** | 顶部 `Web UI 状态` / `TUI 状态` 双状态行；`Web UI ▸`（打开 Web UI / 启动 / 停止(带确认) / 重启）；`TUI ▸`（启动 / 停止）；打开日志目录 / `版本信息 ▸`（版本 / 检查更新 / 更新到最新版）/ 退出托盘 |
-| **菜单智能禁用** | Web 运行中禁用「启动 Web UI」；TUI 运行中禁用「启动 TUI」 |
-| **自更新** | 「版本信息 ▸」子菜单（位于退出托盘上方，非日常功能区）：查看版本 / 检查更新 / 一键更新到最新版（自动重部署 + 重启托盘） |
-| **状态通知** | Web/TUI 启动与停止瞬间弹系统通知；托盘就绪弹一次提示 |
-| **开机自启** | 登录后托盘自动出现（启动文件夹快捷方式，安装时自动创建） |
-
-## 适配与依赖
-
-| 项 | 说明 |
-| :--- | :--- |
-| **dsh 内核** | 适配 `@deepseek-ai/dsh` **v0.1.1-rc.2 系列**（共享核心 `@deepseek-ai/dsh-base` 同版本）；dsh 升级不影响托盘 |
-| **Web 服务** | dsh web 默认监听 `127.0.0.1:3088`（即浏览器里的 Web UI）——托盘通过 TCP 探测该端口判断 Web 状态（端口被改时同步修改 `dsh-lib.ps1` 的 `$PORT` 即可） |
-| **TUI 插件** | 适配 `@deepseek-harness-tui/dsh-tui` **^0.9.2**（通过 dsh-profile `dsh-profile-dsh-tui` 挂载）；托盘按进程命令行 `dsh-tui` 检测，与插件版本解耦 |
-| **Node.js** | ≥ 18（dsh 本体运行所需） |
-| **PowerShell** | 7（托盘常驻进程；缺省回退 Windows PowerShell 5.1） |
-| **运行时依赖** | **零 npm 依赖**——纯 PowerShell + WinForms + 系统 API；托盘不修改 dsh、不注入任何内容，纯旁观者 |
-
-## 界面预览
-
-| 运行中（品牌蓝 `#4176E6`） | 未运行（中性灰 `#81858C`） |
-| :---: | :---: |
-| ![running](build/dsh-tray-running-preview.png) | ![stopped](build/dsh-tray-stopped-preview.png) |
-
-> 图标源 = dsh Web 前端官方 favicon（鲸鱼），多尺寸 16~256px；可随时用 `dsh-tray icons` 重新生成。
-
-## 快速开始
-
-前置：Windows 10/11 + [PowerShell 7](https://github.com/PowerShell/PowerShell/releases)（7.x；缺失时自动回退 Windows PowerShell 5.1）+ Node.js **≥ 18** + 已安装 dsh（任意位置）。
-
-```powershell
-# 1. 全局安装
-npm i -g dsh-windows-tray
-
-# 2. 一键部署（自动探测 dsh/pwsh/node 路径 → 安装到 ~\.dsh\launcher
-#    → 按本机路径改写配置 → 创建开机自启+桌面快捷方式 → 启动托盘）
-dsh-tray install
-
-# 3. 首次使用：把任务栏 ^ 溢出区里的鲸鱼拖到任务栏（一次性，Windows 会记住）
-```
-
-部署完成后即可双击鲸鱼打开 Web UI，右键管理一切。
-
-## 常用命令
-
-| 命令 | 作用 |
-| :--- | :--- |
-| `dsh-tray` | 启动托盘（已有实例则提示，不重复启动） |
-| `dsh-tray install` | 一键部署 / 重新部署（可透传 `-DshRoot` 等参数） |
-| `dsh-tray icons` | 重新生成鲸鱼图标（内置 512px 源图，无需浏览器） |
-| `dsh-tray info` | 查看版本 / 安装位置 / 部署状态 |
-| `npm up -g dsh-windows-tray` | 命令行更新（更新后建议 `dsh-tray install` 重部署） |
-
-## 如何更新
-
-两种方式任选：
-
-**方式一：托盘一键更新（推荐）**——托盘菜单「版本信息 ▸」→「检查更新」对比 npm 最新版，发现新版后点「更新到最新版」：自动 `npm install -g` → 重新部署（含本机路径改写）→ 自动重启托盘，全程约 1 分钟，失败不影响当前托盘。
-
-**方式二：npm 标准流程**——与普通 npm 包一致：
-
-```powershell
-npm up -g dsh-windows-tray   # 拉取最新版
-dsh-tray install             # 重新部署（自动改写本机路径 + 刷新快捷方式）
-dsh-tray                     # 重启托盘（或右键「退出托盘」后重新登录/双击快捷方式）
-```
-
-> 部署目录固定为 `~\.dsh\launcher`，重装/更新都会覆盖旧文件，不会残留；`dsh-tray info` 可查看当前版本与部署状态。
-
-## 卸载
-
-```powershell
-npm rm -g dsh-windows-tray      # ① 移除 npm 包本体
-# ② 删除快捷方式: 启动文件夹 + 桌面 各一个「DSH 系统托盘.lnk」
-# ③ 删除部署目录 ~\.dsh\launcher (如与 dsh 控制台共用, 确认无需保留再删)
-```
-
-## 工作原理
-
-```
-托盘(pwsh 常驻) ──2s 轮询──► 127.0.0.1:3088 (Web UI 端口)
-     │  └──────────────► node 进程命令行含 'dsh-tui' (TUI 进程)
-     ├── 菜单动作 ──► dsh-actions.ps1 (独立隐藏进程, 不卡 UI)
-     ├── 自更新   ──► dsh-update.ps1 (npm 安装→重部署→重启)
-     └── 单实例   ──► 命名互斥锁 (被强杀遗留的锁自动接管)
-```
-
-- **状态检测**：Web 用 TCP 端口探测（物理单实例）；TUI 按命令行匹配（多实例安全：全查全杀）；TUI 检测 20s 节流，打开菜单时强制刷新
-- **动作隔离**：启动/停止/重启在独立进程执行，托盘 UI 永不卡顿
-- **日志**：`~\.dsh\logs\dsh-tray.log`（状态变化）+ `dsh-tray-actions.log`（动作）
-- **单点配置**：端口/路径等常量集中在 `launcher/dsh-lib.ps1`，安装时按本机自动改写——**包本身与机器无关**
-
-## 配置
-
-| 项 | 位置 | 默认 |
-| :--- | :--- | :--- |
-| 监控端口 | `~\.dsh\launcher\dsh-lib.ps1` 顶部 `$PORT` | `3088` |
-| dsh 路径 | 同上（安装时自动改写） | 自动探测 |
-| 图标颜色 | `build/build-tray-icons.ps1`（运行蓝/停止灰） | `#4176E6` / `#81858C` |
-
-## 常见问题
-
-| 问题 | 处理 |
-| :--- | :--- |
-| 任务栏看不到鲸鱼 | 点开 `^` 溢出区，把鲸鱼拖到任务栏（一次性） |
-| 停止 Web UI 会关掉浏览器界面 | 对——停止前有确认框；Web 与当前会话在 3088 端口上 |
-| 托盘退出了怎么唤回 | 双击桌面「DSH 系统托盘」快捷方式 / 重新登录（开机自启）/ `dsh-tray` |
-| 怎么更新到新版 | 托盘菜单「版本信息 ▸ → 更新到最新版」一键完成；或 `npm up -g dsh-windows-tray` + `dsh-tray install`（见「如何更新」） |
-| 检查更新失败 | 网络或 npm 不可用；托盘继续正常工作，稍后再试 |
-| dsh 内核升级了，托盘要动吗 | 不用——托盘只探测 3088 端口与 TUI 进程命令行，与内核版本解耦 |
-| 想彻底卸载 | `npm rm -g dsh-windows-tray` + 删除两个「DSH 系统托盘.lnk」+ 删除 `~\.dsh\launcher` |
-
-## 文档
-
-- `docs/system-tray-guide.md` — 使用手册（安装部署 / 功能一览 / 更新 / 卸载 / 故障排查）
-- `docs/tray-dev-archive.md` — 开发归档（架构决策与历史记录）
-
-## 许可
-
-MIT
+# dsh-windows-tray
+
+> DeepSeek Harness（dsh）的 Windows 系统托盘管家：**官方鲸鱼状态图标 + Web/TUI 双状态显示 + 一键启停**。
+> 纯 PowerShell + WinForms 实现，零依赖、无编译、不改 dsh 源码，卸载即还原。
+
+[![npm](https://img.shields.io/npm/v/dsh-windows-tray?style=flat-square)](https://www.npmjs.com/package/dsh-windows-tray)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-windows-tray?style=flat-square)](https://www.npmjs.com/package/dsh-windows-tray)
+[![Platform](https://img.shields.io/badge/platform-Windows%2010%2F11-blue?style=flat-square)](https://www.npmjs.com/package/dsh-windows-tray)
+[![License](https://img.shields.io/npm/l/dsh-windows-tray?style=flat-square)](https://github.com/)
+
+## 是什么
+
+dsh 默认在终端前台运行 `dsh web`——必须留着一个命令行窗口。本工具把它变成**一个标准的 Windows 托盘应用**：
+
+- 🐋 **状态一目了然**：品牌蓝鲸鱼 = Web 运行中；灰鲸鱼 = 未运行（图标由官方 favicon 渲染生成）
+- 📊 **DSH / TUI 双状态**：菜单顶部同屏显示 Web 与 TUI 各自的运行状态（含 PID），互不干扰
+- 🖱️ **零窗口操作**：双击开界面，右键通过 DSH / TUI 分组子菜单一键启停，不用再碰命令行
+- 👁️ **独立旁观者**：托盘是独立常驻进程，dsh 停止时它依然在（显示未运行 + 一键启动），退出托盘不影响 dsh
+- 🎨 **浅色圆角菜单**：白底、圆角、投影阴影，贴合现代桌面应用审美
+
+## 功能特性
+
+| 交互 | 行为 |
+| :--- | :--- |
+| **图标** | 蓝鲸鱼 = Web 运行中（PID）；灰鲸鱼 = 未运行 |
+| **悬停提示** | `Web UI 运行中 · 127.0.0.1:3088` / `Web UI 未运行 · 右键可启动` |
+| **双击** | 打开 Web UI（未运行先提示启动） |
+| **右键菜单** | 顶部 `Web UI 状态` / `TUI 状态` 双状态行；`Web UI ▸`（打开 Web UI / 启动 / 停止(带确认) / 重启）；`TUI ▸`（启动 / 停止）；打开日志目录 / `版本信息 ▸`（版本 / 检查更新 / 更新到最新版）/ 退出托盘 |
+| **菜单智能禁用** | Web 运行中禁用「启动 Web UI」；TUI 运行中禁用「启动 TUI」 |
+| **自更新** | 「版本信息 ▸」子菜单（位于退出托盘上方，非日常功能区）：查看版本 / 检查更新 / 一键更新到最新版（自动重部署 + 重启托盘） |
+| **状态通知** | Web/TUI 启动与停止瞬间弹系统通知；托盘就绪弹一次提示 |
+| **开机自启** | 登录后托盘自动出现（启动文件夹快捷方式，安装时自动创建） |
+
+## 适配与依赖
+
+| 项 | 说明 |
+| :--- | :--- |
+| **dsh 内核** | 适配 `@deepseek-ai/dsh` **v0.1.1-rc.2 系列**（共享核心 `@deepseek-ai/dsh-base` 同版本）；dsh 升级不影响托盘 |
+| **Web 服务** | dsh web 默认监听 `127.0.0.1:3088`（即浏览器里的 Web UI）——托盘通过 TCP 探测该端口判断 Web 状态（端口被改时同步修改 `dsh-lib.ps1` 的 `$PORT` 即可） |
+| **TUI 插件** | 适配 `@deepseek-harness-tui/dsh-tui` **^0.9.2**（通过 dsh-profile `dsh-profile-dsh-tui` 挂载）；托盘按进程命令行 `dsh-tui` 检测，与插件版本解耦 |
+| **Node.js** | ≥ 18（dsh 本体运行所需） |
+| **PowerShell** | 7（托盘常驻进程；缺省回退 Windows PowerShell 5.1） |
+| **运行时依赖** | **零 npm 依赖**——纯 PowerShell + WinForms + 系统 API；托盘不修改 dsh、不注入任何内容，纯旁观者 |
+
+## 界面预览
+
+| 运行中（品牌蓝 `#4176E6`） | 未运行（中性灰 `#81858C`） |
+| :---: | :---: |
+| ![running](build/dsh-tray-running-preview.png) | ![stopped](build/dsh-tray-stopped-preview.png) |
+
+> 图标源 = dsh Web 前端官方 favicon（鲸鱼），多尺寸 16~256px；可随时用 `dsh-tray icons` 重新生成。
+
+## 快速开始
+
+前置：Windows 10/11 + [PowerShell 7](https://github.com/PowerShell/PowerShell/releases)（7.x；缺失时自动回退 Windows PowerShell 5.1）+ Node.js **≥ 18** + 已安装 dsh（任意位置）。
+
+```powershell
+# 1. 全局安装
+npm i -g dsh-windows-tray
+
+# 2. 一键部署（自动探测 dsh/pwsh/node 路径 → 安装到 ~\.dsh\launcher
+#    → 按本机路径改写配置 → 创建开机自启+桌面快捷方式 → 启动托盘）
+dsh-tray install
+
+# 3. 首次使用：把任务栏 ^ 溢出区里的鲸鱼拖到任务栏（一次性，Windows 会记住）
+```
+
+部署完成后即可双击鲸鱼打开 Web UI，右键管理一切。
+
+## 常用命令
+
+| 命令 | 作用 |
+| :--- | :--- |
+| `dsh-tray` | 启动托盘（已有实例则提示，不重复启动） |
+| `dsh-tray install` | 一键部署 / 重新部署（可透传 `-DshRoot` 等参数） |
+| `dsh-tray icons` | 重新生成鲸鱼图标（内置 512px 源图，无需浏览器） |
+| `dsh-tray info` | 查看版本 / 安装位置 / 部署状态 |
+| `npm up -g dsh-windows-tray` | 命令行更新（更新后建议 `dsh-tray install` 重部署） |
+
+## 如何更新
+
+两种方式任选：
+
+**方式一：托盘一键更新（推荐）**——托盘菜单「版本信息 ▸」→「检查更新」对比 npm 最新版，发现新版后点「更新到最新版」：自动 `npm install -g` → 重新部署（含本机路径改写）→ 自动重启托盘，全程约 1 分钟，失败不影响当前托盘。
+
+**方式二：npm 标准流程**——与普通 npm 包一致：
+
+```powershell
+npm up -g dsh-windows-tray   # 拉取最新版
+dsh-tray install             # 重新部署（自动改写本机路径 + 刷新快捷方式）
+dsh-tray                     # 重启托盘（或右键「退出托盘」后重新登录/双击快捷方式）
+```
+
+> 部署目录固定为 `~\.dsh\launcher`，重装/更新都会覆盖旧文件，不会残留；`dsh-tray info` 可查看当前版本与部署状态。
+
+## 卸载
+
+```powershell
+npm rm -g dsh-windows-tray      # ① 移除 npm 包本体
+# ② 删除快捷方式: 启动文件夹 + 桌面 各一个「DSH 系统托盘.lnk」
+# ③ 删除部署目录 ~\.dsh\launcher (如与 dsh 控制台共用, 确认无需保留再删)
+```
+
+## 工作原理
+
+```
+托盘(pwsh 常驻) ──2s 轮询──► 127.0.0.1:3088 (Web UI 端口)
+     │  └──────────────► node 进程命令行含 'dsh-tui' (TUI 进程)
+     ├── 菜单动作 ──► dsh-actions.ps1 (独立隐藏进程, 不卡 UI)
+     ├── 自更新   ──► dsh-update.ps1 (npm 安装→重部署→重启)
+     └── 单实例   ──► 命名互斥锁 (被强杀遗留的锁自动接管)
+```
+
+- **状态检测**：Web 用 TCP 端口探测（物理单实例）；TUI 按命令行匹配（多实例安全：全查全杀）；TUI 检测 20s 节流，打开菜单时强制刷新
+- **动作隔离**：启动/停止/重启在独立进程执行，托盘 UI 永不卡顿
+- **日志**：`~\.dsh\logs\dsh-tray.log`（状态变化）+ `dsh-tray-actions.log`（动作）
+- **单点配置**：端口/路径等常量集中在 `launcher/dsh-lib.ps1`，安装时按本机自动改写——**包本身与机器无关**
+
+## 配置
+
+| 项 | 位置 | 默认 |
+| :--- | :--- | :--- |
+| 监控端口 | `~\.dsh\launcher\dsh-lib.ps1` 顶部 `$PORT` | `3088` |
+| dsh 路径 | 同上（安装时自动改写） | 自动探测 |
+| 图标颜色 | `build/build-tray-icons.ps1`（运行蓝/停止灰） | `#4176E6` / `#81858C` |
+
+## 常见问题
+
+| 问题 | 处理 |
+| :--- | :--- |
+| 任务栏看不到鲸鱼 | 点开 `^` 溢出区，把鲸鱼拖到任务栏（一次性） |
+| 停止 Web UI 会关掉浏览器界面 | 对——停止前有确认框；Web 与当前会话在 3088 端口上 |
+| 托盘退出了怎么唤回 | 双击桌面「DSH 系统托盘」快捷方式 / 重新登录（开机自启）/ `dsh-tray` |
+| 怎么更新到新版 | 托盘菜单「版本信息 ▸ → 更新到最新版」一键完成；或 `npm up -g dsh-windows-tray` + `dsh-tray install`（见「如何更新」） |
+| 检查更新失败 | 网络或 npm 不可用；托盘继续正常工作，稍后再试 |
+| dsh 内核升级了，托盘要动吗 | 不用——托盘只探测 3088 端口与 TUI 进程命令行，与内核版本解耦 |
+| 想彻底卸载 | `npm rm -g dsh-windows-tray` + 删除两个「DSH 系统托盘.lnk」+ 删除 `~\.dsh\launcher` |
+
+## 文档
+
+- `docs/system-tray-guide.md` — 使用手册（安装部署 / 功能一览 / 更新 / 卸载 / 故障排查）
+- `docs/tray-dev-archive.md` — 开发归档（架构决策与历史记录）
+
+## 许可
+
+MIT

package/bin/dsh-tray.js

@@ -1,100 +1,100 @@
-#!/usr/bin/env node
-// dsh-tray —— DSH 系统托盘的 npm 命令行入口
-// 用法:
-//   dsh-tray           启动托盘 (后台, 从已部署目录 ~\.dsh\launcher 运行)
-//   dsh-tray install   一键部署到 ~\.dsh\launcher (自动探测路径+快捷方式+启动)
-//   dsh-tray icons     重新生成鲸鱼图标 (build/build-tray-icons.ps1)
-//   dsh-tray info      显示版本/安装位置/pwsh 路径
-'use strict';
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-
-const root = path.join(__dirname, '..');
-const pkg = require(path.join(root, 'package.json'));
-const home = process.env.USERPROFILE || process.env.HOME || '';
-const deployDir = path.join(home, '.dsh', 'launcher');
-
-function findPwsh() {
-  const candidates = [
-    process.env.PWSH,
-    'C:\\Program Files\\PowerShell\\7\\pwsh.exe',
-    'D:\\Program Files (x86)\\PowerShell-7.6.4\\pwsh.exe',
-    path.join(process.env.ProgramW6432 || 'C:\\Program Files', 'PowerShell\\7\\pwsh.exe'),
-  ].filter(Boolean);
-  for (const c of candidates) { try { if (fs.existsSync(c)) return c; } catch (_) { /* ignore */ } }
-  return 'pwsh'; // 最后让 PATH 解析
-}
-
-const cmd = process.argv[2] || 'run';
-const pwsh = findPwsh();
-
-switch (cmd) {
-  case 'install':
-    // 交互式部署: 继承终端, 等安装完成
-    spawn(pwsh, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File',
-      path.join(root, 'install.ps1'), ...process.argv.slice(3)],
-      { stdio: 'inherit', windowsHide: true })
-      .on('exit', (code) => process.exit(code == null ? 1 : code));
-    break;
-
-  case 'icons':
-    spawn(pwsh, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File',
-      path.join(root, 'build', 'build-tray-icons.ps1')],
-      { stdio: 'inherit', windowsHide: true })
-      .on('exit', (code) => process.exit(code == null ? 1 : code));
-    break;
-
-  case 'info':
-    console.log(`dsh-tray v${pkg.version}`);
-    console.log(`包安装位置: ${root}`);
-    console.log(`部署目录:   ${deployDir}`);
-    console.log(`pwsh:       ${pwsh}`);
-    console.log(`部署状态:   ${fs.existsSync(path.join(deployDir, 'dsh-tray.ps1')) ? '已部署' : '未部署 (先运行 dsh-tray install)'}`);
-    break;
-
-  case 'run':
-  default: {
-    // 托盘是常驻进程: 优先跑已部署(路径已改写)的副本
-    const script = fs.existsSync(path.join(deployDir, 'dsh-tray.ps1'))
-      ? path.join(deployDir, 'dsh-tray.ps1')
-      : path.join(root, 'launcher', 'dsh-tray.ps1');
-    const fromDeploy = script.startsWith(deployDir);
-    // 反馈模式: 快速退出(单实例锁/失败)立即报告; 存活 3 秒 = 挂载成功
-    const child = spawn(pwsh, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', script], {
-      stdio: ['ignore', 'ignore', 'pipe'],
-      windowsHide: true,
-    });
-    let errText = '';
-    let settled = false;
-    child.stderr.on('data', (d) => (errText += d));
-    child.on('error', (e) => {
-      if (settled) return;
-      settled = true;
-      console.error(`dsh-tray: 启动失败 — ${e.message}`);
-      process.exit(1);
-    });
-    child.on('exit', (code) => {
-      if (settled) return;
-      settled = true;
-      if (code === 0) {
-        console.log('dsh-tray: 已有托盘实例在运行（单实例保护），本次不重复启动。');
-        process.exit(0);
-      }
-      const lastLine = errText.trim().split(/\r?\n/).pop();
-      console.error(`dsh-tray: 启动失败（退出码 ${code}）${lastLine ? ' — ' + lastLine : ''}`);
-      console.error(fromDeploy ? '       提示: 日志见 ~\\.dsh\\logs\\dsh-tray.log' : '       提示: 先运行 dsh-tray install 部署');
-      process.exit(1);
-    });
-    // 子进程存活超过观察窗口 = 托盘已挂载, 视为启动成功
-    setTimeout(() => {
-      if (settled) return;
-      settled = true;
-      console.log(fromDeploy
-        ? 'dsh-tray: 托盘已后台运行（找不到图标就点任务栏 ^ 折叠区）。'
-        : 'dsh-tray: 托盘已后台运行。提示: 未检测到部署, 建议先运行 dsh-tray install 适配本机路径');
-      process.exit(0);
-    }, 3000);
-    break;
-  }
-}
+#!/usr/bin/env node
+// dsh-tray —— DSH 系统托盘的 npm 命令行入口
+// 用法:
+//   dsh-tray           启动托盘 (后台, 从已部署目录 ~\.dsh\launcher 运行)
+//   dsh-tray install   一键部署到 ~\.dsh\launcher (自动探测路径+快捷方式+启动)
+//   dsh-tray icons     重新生成鲸鱼图标 (build/build-tray-icons.ps1)
+//   dsh-tray info      显示版本/安装位置/pwsh 路径
+'use strict';
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const root = path.join(__dirname, '..');
+const pkg = require(path.join(root, 'package.json'));
+const home = process.env.USERPROFILE || process.env.HOME || '';
+const deployDir = path.join(home, '.dsh', 'launcher');
+
+function findPwsh() {
+  const candidates = [
+    process.env.PWSH,
+    'C:\\Program Files\\PowerShell\\7\\pwsh.exe',
+    'D:\\Program Files (x86)\\PowerShell-7.6.4\\pwsh.exe',
+    path.join(process.env.ProgramW6432 || 'C:\\Program Files', 'PowerShell\\7\\pwsh.exe'),
+  ].filter(Boolean);
+  for (const c of candidates) { try { if (fs.existsSync(c)) return c; } catch (_) { /* ignore */ } }
+  return 'pwsh'; // 最后让 PATH 解析
+}
+
+const cmd = process.argv[2] || 'run';
+const pwsh = findPwsh();
+
+switch (cmd) {
+  case 'install':
+    // 交互式部署: 继承终端, 等安装完成
+    spawn(pwsh, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File',
+      path.join(root, 'install.ps1'), ...process.argv.slice(3)],
+      { stdio: 'inherit', windowsHide: true })
+      .on('exit', (code) => process.exit(code == null ? 1 : code));
+    break;
+
+  case 'icons':
+    spawn(pwsh, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File',
+      path.join(root, 'build', 'build-tray-icons.ps1')],
+      { stdio: 'inherit', windowsHide: true })
+      .on('exit', (code) => process.exit(code == null ? 1 : code));
+    break;
+
+  case 'info':
+    console.log(`dsh-tray v${pkg.version}`);
+    console.log(`包安装位置: ${root}`);
+    console.log(`部署目录:   ${deployDir}`);
+    console.log(`pwsh:       ${pwsh}`);
+    console.log(`部署状态:   ${fs.existsSync(path.join(deployDir, 'dsh-tray.ps1')) ? '已部署' : '未部署 (先运行 dsh-tray install)'}`);
+    break;
+
+  case 'run':
+  default: {
+    // 托盘是常驻进程: 优先跑已部署(路径已改写)的副本
+    const script = fs.existsSync(path.join(deployDir, 'dsh-tray.ps1'))
+      ? path.join(deployDir, 'dsh-tray.ps1')
+      : path.join(root, 'launcher', 'dsh-tray.ps1');
+    const fromDeploy = script.startsWith(deployDir);
+    // 反馈模式: 快速退出(单实例锁/失败)立即报告; 存活 3 秒 = 挂载成功
+    const child = spawn(pwsh, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', script], {
+      stdio: ['ignore', 'ignore', 'pipe'],
+      windowsHide: true,
+    });
+    let errText = '';
+    let settled = false;
+    child.stderr.on('data', (d) => (errText += d));
+    child.on('error', (e) => {
+      if (settled) return;
+      settled = true;
+      console.error(`dsh-tray: 启动失败 — ${e.message}`);
+      process.exit(1);
+    });
+    child.on('exit', (code) => {
+      if (settled) return;
+      settled = true;
+      if (code === 0) {
+        console.log('dsh-tray: 已有托盘实例在运行（单实例保护），本次不重复启动。');
+        process.exit(0);
+      }
+      const lastLine = errText.trim().split(/\r?\n/).pop();
+      console.error(`dsh-tray: 启动失败（退出码 ${code}）${lastLine ? ' — ' + lastLine : ''}`);
+      console.error(fromDeploy ? '       提示: 日志见 ~\\.dsh\\logs\\dsh-tray.log' : '       提示: 先运行 dsh-tray install 部署');
+      process.exit(1);
+    });
+    // 子进程存活超过观察窗口 = 托盘已挂载, 视为启动成功
+    setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      console.log(fromDeploy
+        ? 'dsh-tray: 托盘已后台运行（找不到图标就点任务栏 ^ 折叠区）。'
+        : 'dsh-tray: 托盘已后台运行。提示: 未检测到部署, 建议先运行 dsh-tray install 适配本机路径');
+      process.exit(0);
+    }, 3000);
+    break;
+  }
+}