@lenorin/dsh-tauri-launcher 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-tauri-launcher contributors
+
+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

@@ -0,0 +1,102 @@
+# dsh-tauri-launcher
+
+一个可安装的 DeepSeek Harness Web 插件：在 **设置 → 桌面启动** 中启动/退出本机
+**DeepSeek Harness Tauri 桌面应用**，并联动桌面快捷方式。配套提供桌面应用
+（Tauri）的完整源码与 GitHub Release 自动构建。
+
+## 功能
+
+- **桌面端启动开关**：一键启动/退出桌面应用（点击即反馈，秒级状态同步）；
+- **快捷方式联动**：开启时自动创建桌面快捷方式、关闭时自动删除；运行中可手动补建；
+- **关闭确认弹窗**：关闭前弹窗确认（含快捷方式将被删除的提示）；
+- **状态可视**：运行中 🟢 / 已停止 ⚪ / 状态未知 🟡 + 出错时显示诊断信息；
+- **深色模式适配**：全部颜色走 DSH 主题令牌，深浅色自动适配；
+- **设置导航显示器图标**：替换默认齿轮图标（矢量绘制，任意缩放锐利）。
+
+## 工作原理（摘要）
+
+Web 插件（宿主半）通过 `/api/dsh-tauri-launcher/*` 回环路由与浏览器半通信，
+并使用标记文件协议控制桌面应用（详见 [docs/architecture.md](docs/architecture.md)）：
+
+- `.dsh-heartbeat`：桌面应用每秒写入时间戳，插件以此探测运行状态；
+- `.dsh-quit`：写入 `1` 后桌面应用仅退出自身（保留 Harness 进程），消费时自删。
+
+## 目录结构
+
+```
+dsh-tauri-launcher/
+├── package.json          # dsh.bundle + dsh.client 双 manifest
+├── cordis.patch.yml      # 组合补丁（插入插件行）
+├── lib/
+│   ├── index.js          # 宿主半：回环路由 + 控制逻辑（可配置）
+│   └── client.js         # 浏览器半：设置分区 UI
+├── launcher/             # Tauri 桌面应用工程（源码 + 一键构建）
+├── .github/workflows/    # CI：打 tag 自动构建 exe 并发布 Release
+└── docs/                 # 架构与发布文档
+```
+
+## 安装（Web 插件）
+
+> **关于 `<profile>`**：它指 DSH 的**配置档（profile）**——一套可启动的插件组合，
+> 位于 `$DSH_HOME/profiles/<名字>/`。`<profile>` 是占位符，**需要替换成你实际
+> 要装进的 profile 名**。本机常见配置档名为 `web`（启动 DSH Web GUI 的档）；
+> 查看已有档：`dir %USERPROFILE%\.dsh\profiles`（或 `ls ~/.dsh/profiles`）。
+> 下面的命令示例中，把 `<profile>` 换成 `web` 即可，例如 `dsh plugin --profile web add ...`。
+
+三种方式任选（任选其一）：
+
+```bash
+# 1) npm（发布后）
+dsh plugin --profile web add @lenorin/dsh-tauri-launcher
+
+# 2) GitHub（git 安装；纯 JS 零构建，无需 allowBuilds 授权）
+dsh plugin --profile web add github:you/dsh-tauri-launcher
+
+# 3) 本地 checkout / tarball
+dsh plugin --profile web add ./dsh-tauri-launcher
+dsh plugin --profile web add ./dsh-tauri-launcher-1.0.0.tgz
+```
+
+> 如果你有多个 profile，把命令里的 `web` 换成目标 profile 名即可。
+
+验证层已生效（应能看到 `dsh-tauri-launcher` 层）：
+
+```bash
+dsh --profile web --dump-config
+```
+
+重启 DSH Web 进程后，设置面板即出现「桌面启动」分区。卸载（`web` 换成你的 profile 名）：
+
+```bash
+dsh plugin --profile web remove @lenorin/dsh-tauri-launcher
+```
+
+## 配置
+
+插件行支持以下配置（无硬编码可调参数；默认值适配常见部署）：
+
+```yaml
+- id: desktop-launcher
+  name: '@lenorin/dsh-tauri-launcher'
+  config:
+    launcherExe: ''            # 桌面应用 exe 绝对路径；空 = 自动探测
+    launcherDirs: []           # 候选 exe 目录列表；空 = 内置默认候选
+    freshSecs: 4               # 心跳“新鲜窗口”（秒），须大于心跳写入周期
+    shortcutName: 'DeepSeek Harness.lnk'   # 桌面快捷方式文件名
+```
+
+## 桌面应用构建与发布
+
+- npm 包自带预编译 exe（`launcher/bin/dsh-launcher.exe`），插件安装后自动探测、装上即用；
+- 本地自行构建：`pwsh -File launcher/build.ps1`（可选 `-Offline -CargoHome <dir>`）；
+- GitHub Release：推送 `v*` tag，CI 自动构建 Windows exe 并发布（见
+  [docs/release.md](docs/release.md)）。
+
+## 文档
+
+- [docs/architecture.md](docs/architecture.md) — 架构与标记文件协议
+- [docs/release.md](docs/release.md) — 安装、构建、发布、卸载与配置参考
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-tauri-launcher 组合包补丁：向宿主组合插入双面插件行。
+# 宿主半（exports "."）在 Node 进程内注册 /api/dsh-tauri-launcher/* 回环路由；
+# 浏览器半（exports "./client"，经 package.json 的 dsh.client 声明发现）
+# 在 Web 设置面板注册「桌面启动」分区。
+- insert:
+    - id: desktop-launcher
+      name: '@lenorin/dsh-tauri-launcher'

package/launcher/README.md

@@ -0,0 +1,56 @@
+# DeepSeek Harness 桌面启动器（Tauri）
+
+一个用于连接本地 DeepSeek Harness 的桌面应用：
+
+- **启动时自动检查**本地是否已安装 DeepSeek Harness（npm 全局包 `@deepseek-ai/dsh`）
+- **未安装则自动安装**：加载页面显示安装动画与 npm 实时日志
+- **安装完成提示“安装成功”**，随后自动启动并打开 DeepSeek Harness Web 界面
+- **安装/启动失败反馈报错信息**，可一键重试
+- **系统托盘**提供“打开 DeepSeek Harness”“设置”与“退出”按钮；退出时终止由本应用启动的 DeepSeek Harness 进程（若启动时发现已有实例在运行则接管显示，退出时不终止外部实例）
+- 关闭窗口最小化到托盘，应用常驻后台
+- **设置窗口**（托盘 → 设置）提供三项开关：
+  - **开机启动**：写入/删除 `HKCU\...\Run` 的 `DeepSeekHarness` 注册表值（指向本应用 exe）
+  - **创建全局快捷方式**：勾选注册全局快捷键 `Ctrl+Shift+H`（按下即唤起 DeepSeek Harness 主窗口），取消勾选注销快捷键；勾选状态持久化在 exe 同目录的 `.dsh-config.json`，应用启动时自动恢复注册
+  - **桌面快捷方式**：勾选在桌面创建 `DeepSeek Harness.lnk`（指向本应用 exe，带图标），取消勾选删除；状态以 .lnk 是否存在为准，无需持久化
+
+## 开发
+
+```bash
+pnpm install        # 仅安装 tauri CLI
+pnpm tauri dev      # 直接以静态 ui/ 目录运行
+```
+
+## 构建
+
+```bash
+pnpm tauri build
+```
+
+前端为 `ui/` 下的纯静态 HTML/CSS/JS（无构建步骤，经 `window.__TAURI__` 全局 API 与后端通信）。
+
+## 环境变量（可选，便于测试）
+
+- `DSH_LAUNCHER_NODE`：覆盖 node.exe 路径
+- `DSH_LAUNCHER_NPM_ROOT`：覆盖 npm 全局安装根目录（安装检测与 `dsh` 入口脚本均以此为准）
+
+## 与 Web 设置插件的标记文件协作
+
+DeepSeek Harness Web 设置中的“桌面启动”插件（deepseek-harness-tauri）只负责启动/退出本应用；本应用 exe 同目录下的标记文件用于协作（每秒检查一次）：
+
+- `.dsh-heartbeat`：每秒写入当前 Unix 时间戳，供插件在沙箱内判断本应用是否仍在运行（插件侧的新鲜窗口为 4 秒，须与 1 秒写入周期匹配）；
+- `.dsh-quit`：内容为 `1` 且修改时间在 60 秒内 → 本应用**仅退出自身**（消费时自删标记文件），保留由其启动的 DeepSeek Harness 进程继续运行（与托盘“退出”的整树清理语义不同）；插件重写内容为 `0` 即取消退出请求。
+
+## 开机启动、全局快捷方式与桌面快捷方式
+
+三项均由本应用自己的设置窗口（托盘 → 设置）控制，与 Web 设置插件无联动：
+
+- **开机启动**：直接写入/删除 `HKCU\...\Run` 的 `DeepSeekHarness` 注册表值（指向本应用 exe）；
+- **全局快捷方式**：通过 `tauri-plugin-global-shortcut` 注册/注销 `Ctrl+Shift+H`，按下即显示并聚焦主窗口；勾选状态保存在 exe 同目录的 `.dsh-config.json`，启动时自动恢复；
+- **桌面快捷方式**：通过 PowerShell WScript.Shell COM 创建/删除桌面 `DeepSeek Harness.lnk`（桌面路径用 `[Environment]::GetFolderPath('Desktop')` 解析，自动适配 OneDrive 重定向）；状态即 .lnk 存在性。
+
+## 工作原理
+
+1. `check_dsh`：通过 `npm root -g` 定位全局安装目录，检查 `node_modules/@deepseek-ai/dsh/package.json`
+2. `install_dsh`：执行 `npm install -g @deepseek-ai/dsh`，逐行转发输出到前端
+3. `launch_dsh`：先探测 `127.0.0.1:3080` 是否已有 DSH Web 实例（以页面 `__DSH_BOOT__` 标记为指纹），没有则拉起 `dsh web` 并轮询等待就绪，然后把主窗口导航到本地 Web 界面
+4. 托盘“退出”或进程退出时，对由本应用启动的 dsh 进程树执行 `taskkill /T /F` 清理

package/launcher/build.ps1

@@ -0,0 +1,44 @@
+# dsh-tauri-launcher 桌面应用一键构建脚本（Windows）。
+# 用法：在仓库根目录运行  pwsh -File launcher/build.ps1
+# 产物：launcher/src-tauri/target/release/dsh-launcher.exe
+#
+# 说明：
+# - 依赖 Rust 工具链（rustup + MSVC 或 GNU）与 Node.js 22+；
+# - 若本机无法联网拉取 crates.io 依赖，可先用 --offline 配合一个预置的
+#   CARGO_HOME（例如把已缓存的 .cargo 注册表目录传给 -CargoHome 参数）。
+
+param(
+    [switch]$Offline,
+    [string]$CargoHome = ''
+)
+
+$ErrorActionPreference = 'Stop'
+$root = Split-Path -Parent $PSScriptRoot
+$srcTauri = Join-Path $PSScriptRoot 'src-tauri'
+
+if ($CargoHome -ne '') {
+    $env:CARGO_HOME = $CargoHome
+    Write-Host "CARGO_HOME = $CargoHome"
+}
+
+Push-Location $srcTauri
+try {
+    if ($Offline) {
+        Write-Host 'cargo build --release --offline'
+        cargo build --release --offline
+    } else {
+        Write-Host 'cargo build --release'
+        cargo build --release
+    }
+    if ($LASTEXITCODE -ne 0) { throw "cargo build failed (exit $LASTEXITCODE)" }
+} finally {
+    Pop-Location
+}
+
+$exe = Join-Path $srcTauri 'target\release\dsh-launcher.exe'
+if (-not (Test-Path -LiteralPath $exe)) {
+    throw "构建产物缺失：$exe"
+}
+Write-Host ''
+Write-Host "构建完成：$exe"
+Get-Item -LiteralPath $exe | Select-Object Length, LastWriteTime

package/launcher/src-tauri/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "dsh-launcher"
+version = "0.1.0"
+description = "DeepSeek Harness 桌面启动器：自动检测/安装并启动本地 DeepSeek Harness，系统托盘管理退出"
+authors = ["you"]
+edition = "2021"
+
+[lib]
+name = "dsh_launcher_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = ["tray-icon", "image-png"] }
+tauri-plugin-global-shortcut = "2"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+tokio = { version = "1", features = ["rt-multi-thread", "macros", "process", "io-util", "time", "net", "sync"] }

package/launcher/src-tauri/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

package/launcher/src-tauri/capabilities/default.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "Capability for the launcher windows (main + settings)",
+  "windows": ["main", "settings"],
+  "permissions": [
+    "core:default"
+  ]
+}

package/launcher/src-tauri/src/dsh.rs

@@ -0,0 +1,286 @@
+//! DeepSeek Harness 管理逻辑：检测安装、npm 自动安装、端口探测。
+//! 与 tauri 解耦，便于独立测试。
+
+use std::collections::VecDeque;
+use std::env;
+use std::path::Path;
+use std::process::Command as StdCommand;
+use std::time::Duration;
+
+use serde::Serialize;
+use tokio::io::{AsyncBufReadExt, AsyncReadExt, AsyncWriteExt, BufReader};
+use tokio::process::Command as TokioCommand;
+
+/// npm 包名：DeepSeek Harness 本体。
+pub const DSH_PACKAGE: &str = "@deepseek-ai/dsh";
+/// Web GUI 默认端口。
+pub const DSH_PORT: u16 = 3080;
+/// Web GUI 默认地址。
+pub const DSH_URL: &str = "http://127.0.0.1:3080/";
+/// dsh web 页面中的指纹标记，用于确认端口上跑的是 DeepSeek Harness。
+pub const DSH_MARKER: &str = "__DSH_BOOT__";
+
+/// Windows: 隐藏子进程控制台窗口。
+#[cfg(windows)]
+fn hide_console_std(cmd: &mut StdCommand) {
+    use std::os::windows::process::CommandExt;
+    cmd.creation_flags(0x0800_0000); // CREATE_NO_WINDOW
+}
+#[cfg(not(windows))]
+fn hide_console_std(_cmd: &mut StdCommand) {}
+
+#[cfg(windows)]
+fn hide_console_tokio(cmd: &mut TokioCommand) {
+    cmd.creation_flags(0x0800_0000);
+}
+#[cfg(not(windows))]
+fn hide_console_tokio(_cmd: &mut TokioCommand) {}
+
+/// 同步执行命令并捕获标准输出。
+pub fn run_capture(cmd: &str, args: &[&str]) -> Result<String, String> {
+    let mut c = StdCommand::new(cmd);
+    c.args(args);
+    hide_console_std(&mut c);
+    let out = c.output().map_err(|e| e.to_string())?;
+    if out.status.success() {
+        Ok(String::from_utf8_lossy(&out.stdout).trim().to_string())
+    } else {
+        let detail = String::from_utf8_lossy(&out.stderr).trim().to_string();
+        Err(if detail.is_empty() {
+            format!("命令执行失败：{cmd} {}", args.join(" "))
+        } else {
+            detail
+        })
+    }
+}
+
+/// 解析 node.exe 完整路径（支持 DSH_LAUNCHER_NODE 覆盖，便于测试）。
+pub fn node_exe() -> Option<String> {
+    if let Ok(v) = env::var("DSH_LAUNCHER_NODE") {
+        if !v.trim().is_empty() {
+            return Some(v.trim().to_string());
+        }
+    }
+    run_capture("cmd", &["/C", "where", "node"])
+        .ok()
+        .and_then(|s| s.lines().next().map(str::trim).map(String::from))
+        .filter(|s| !s.is_empty())
+}
+
+/// npm 全局安装根目录（支持 DSH_LAUNCHER_NPM_ROOT 覆盖，便于测试）。
+pub fn npm_root() -> Option<String> {
+    if let Ok(v) = env::var("DSH_LAUNCHER_NPM_ROOT") {
+        if !v.trim().is_empty() {
+            return Some(v.trim().to_string());
+        }
+    }
+    run_capture("cmd", &["/C", "npm", "root", "-g"])
+        .ok()
+        .map(|s| s.trim().to_string())
+        .filter(|s| !s.is_empty())
+}
+
+#[derive(Serialize, Clone)]
+pub struct CheckResult {
+    pub installed: bool,
+    pub version: Option<String>,
+    pub root: Option<String>,
+    pub bin_path: Option<String>,
+    pub node_ok: bool,
+    pub error: Option<String>,
+}
+
+fn read_pkg_version(pkg_json: &Path) -> Option<String> {
+    let text = std::fs::read_to_string(pkg_json).ok()?;
+    let v: serde_json::Value = serde_json::from_str(&text).ok()?;
+    v.get("version").and_then(|v| v.as_str()).map(String::from)
+}
+
+/// 检查本地是否已安装 DeepSeek Harness（npm 全局包）。
+pub fn check() -> CheckResult {
+    if node_exe().is_none() {
+        return CheckResult {
+            installed: false,
+            version: None,
+            root: None,
+            bin_path: None,
+            node_ok: false,
+            error: Some(
+                "未检测到 Node.js。DeepSeek Harness 依赖 Node.js 运行，请先安装 Node.js（https://nodejs.org/）后重试。"
+                    .to_string(),
+            ),
+        };
+    }
+    let Some(root) = npm_root() else {
+        return CheckResult {
+            installed: false,
+            version: None,
+            root: None,
+            bin_path: None,
+            node_ok: true,
+            error: Some("无法确定 npm 全局安装目录（npm root -g 执行失败），请确认 npm 已正确安装。".to_string()),
+        };
+    };
+    // npm root -g 返回的路径本身以 node_modules 结尾；同时也兼容以
+    // npm prefix -g 形态给出的根目录（不含 node_modules），两种都探测。
+    let base = Path::new(&root);
+    let candidates = [base.join("node_modules").join(DSH_PACKAGE), base.join(DSH_PACKAGE)];
+    let Some(pkg_dir) = candidates.iter().find(|d| d.join("package.json").exists()) else {
+        return CheckResult {
+            installed: false,
+            version: None,
+            root: Some(root),
+            bin_path: None,
+            node_ok: true,
+            error: None,
+        };
+    };
+    CheckResult {
+        installed: true,
+        version: read_pkg_version(&pkg_dir.join("package.json")),
+        root: Some(root),
+        bin_path: Some(pkg_dir.join("lib").join("bin.js").to_string_lossy().into_owned()),
+        node_ok: true,
+        error: None,
+    }
+}
+
+/// 执行 `npm install -g @deepseek-ai/dsh`，逐行回调输出，返回安装后的版本号。
+/// 设置 DSH_LAUNCHER_NPM_ROOT 时改为安装到该目录（与检测根目录保持一致，便于测试）。
+pub async fn install<F>(mut emit: F) -> Result<String, String>
+where
+    F: FnMut(&str, &str),
+{
+    let override_root = env::var("DSH_LAUNCHER_NPM_ROOT")
+        .ok()
+        .filter(|s| !s.is_empty());
+    if let Some(root) = override_root.as_deref() {
+        std::fs::create_dir_all(root).map_err(|e| format!("无法创建安装目录 {root}：{e}"))?;
+        let pkg_json = Path::new(root).join("package.json");
+        if !pkg_json.exists() {
+            std::fs::write(&pkg_json, b"{\n  \"private\": true\n}\n")
+                .map_err(|e| format!("无法写入 {pkg_json:?}：{e}"))?;
+        }
+    }
+    let mut cmd = TokioCommand::new("cmd");
+    if let Some(root) = override_root {
+        cmd.args([
+            "/C",
+            "npm",
+            "install",
+            "--prefix",
+            &root,
+            DSH_PACKAGE,
+            "--no-fund",
+            "--no-audit",
+            "--loglevel=notice",
+        ]);
+    } else {
+        cmd.args([
+            "/C",
+            "npm",
+            "install",
+            "-g",
+            DSH_PACKAGE,
+            "--no-fund",
+            "--no-audit",
+            "--loglevel=notice",
+        ]);
+    }
+    cmd.env("npm_config_update_notifier", "false")
+        .env("npm_config_fund", "false")
+        .env("npm_config_audit", "false")
+        .stdout(std::process::Stdio::piped())
+        .stderr(std::process::Stdio::piped())
+        .kill_on_drop(true);
+    hide_console_tokio(&mut cmd);
+    let mut child = cmd.spawn().map_err(|e| format!("无法启动 npm：{e}"))?;
+    let stdout = child.stdout.take().ok_or("无法读取 npm 输出")?;
+    let stderr = child.stderr.take().ok_or("无法读取 npm 输出")?;
+
+    let (tx, mut rx) = tokio::sync::mpsc::unbounded_channel::<(String, String)>();
+    let tx2 = tx.clone();
+    tokio::spawn(async move {
+        let mut lines = BufReader::new(stdout).lines();
+        while let Ok(Some(line)) = lines.next_line().await {
+            let _ = tx.send(("stdout".to_string(), line));
+        }
+    });
+    tokio::spawn(async move {
+        let mut lines = BufReader::new(stderr).lines();
+        while let Ok(Some(line)) = lines.next_line().await {
+            let _ = tx2.send(("stderr".to_string(), line));
+        }
+    });
+
+    let mut tail: VecDeque<String> = VecDeque::with_capacity(256);
+    let status = loop {
+        tokio::select! {
+            status = child.wait() => {
+                break status.map_err(|e| format!("等待 npm 结束失败：{e}"))?;
+            }
+            Some((stream, line)) = rx.recv() => {
+                if tail.len() >= 256 {
+                    tail.pop_front();
+                }
+                tail.push_back(format!("[{stream}] {line}"));
+                emit(&stream, &line);
+            }
+        }
+    };
+
+    if status.success() {
+        let after = check();
+        after
+            .version
+            .ok_or_else(|| "npm 报告安装成功，但未能检测到已安装的 DeepSeek Harness。".to_string())
+    } else {
+        let code = status
+            .code()
+            .map(|c| c.to_string())
+            .unwrap_or_else(|| "被信号终止".to_string());
+        let log = tail.into_iter().collect::<Vec<_>>().join("\n");
+        Err(format!("npm install 失败（退出码 {code}）：\n{log}"))
+    }
+}
+
+/// 探测指定端口上是否正在运行 DeepSeek Harness Web GUI。
+pub async fn is_dsh_serving(port: u16) -> bool {
+    let addr = format!("127.0.0.1:{port}");
+    let Ok(conn) = tokio::time::timeout(Duration::from_secs(2), tokio::net::TcpStream::connect(&addr)).await else {
+        return false;
+    };
+    let Ok(mut stream) = conn else {
+        return false;
+    };
+    let req = format!("GET / HTTP/1.1\r\nHost: {addr}\r\nConnection: close\r\n\r\n");
+    if tokio::time::timeout(Duration::from_secs(2), stream.write_all(req.as_bytes()))
+        .await
+        .is_err()
+    {
+        return false;
+    }
+    let mut buf = Vec::new();
+    let _ = tokio::time::timeout(Duration::from_secs(3), stream.read_to_end(&mut buf)).await;
+    String::from_utf8_lossy(&buf).contains(DSH_MARKER)
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    /// 本机已全局安装 @deepseek-ai/dsh：check() 必须能通过
+    /// `npm root -g` 找到它（回归测试：此前曾把 node_modules 拼接了两次）。
+    #[test]
+    fn check_detects_global_install() {
+        let result = check();
+        assert!(
+            result.installed,
+            "check() 未检测到已安装的 DeepSeek Harness：root={:?} node_ok={} error={:?}",
+            result.root, result.node_ok, result.error
+        );
+        assert!(result.version.is_some(), "检测到安装但未解析出版本号");
+        let bin = result.bin_path.expect("bin_path 应存在");
+        assert!(std::path::Path::new(&bin).exists(), "入口脚本不存在：{bin}");
+    }
+}