cilis/dsh-tauri-launcher

DSH Tauri 启动器

英文

平台 - Windows
许可证

沿用 DeepSeek Harness「一切皆插件」的架构哲学，把桌面端启停、退出确认、桌面快捷方式联动
全部抽象为标准 Web 插件——用户在 设置 → 桌面启动 中即可一键唤起 Tauri 桌面应用，既
享受插件生态的深度集成，也保留原生桌面体验。本仓库同时附带 Tauri 桌面应用完整源码与
GitHub Release 自动构建流程。

平台支持

| 平台     | 状态                          |
| -------- | ----------------------------- |
| Windows  | ✅ 已支持（含桌面快捷方式 .lnk） |
| Linux    | 🚧 规划中                     |
| macOS    | 🚧 规划中                     |

Web 插件本体（host/client JS）跨平台；目前 Windows 专属的实现集中在桌面快捷方式创建与
回环进程控制上。Linux/macOS 适配已在路线图中，欢迎在 issue 里提出你的需求与场景。

功能

- 桌面端启动开关：一键启动/退出桌面应用（点击即反馈，秒级状态同步）；
- 快捷方式联动：开启时自动创建桌面快捷方式、关闭时自动删除；运行中可手动补建；
- 关闭确认弹窗：关闭前弹窗确认（含快捷方式将被删除的提示）；
- 状态可视：运行中 🟢 / 已停止 ⚪ / 状态未知 🟡 + 出错时显示诊断信息；
- 深色模式适配：全部颜色走 DSH 主题令牌，深浅色自动适配；
- 设置导航显示器图标：替换默认齿轮图标（矢量绘制，任意缩放锐利）。

界面截图

Web 设置面板（插件分区）

Harness 设置中的桌面启动分区

安装后，DSH 设置 → 桌面启动 即可看到启动开关、运行状态、快捷方式联动提示。

桌面应用设置面板

Tauri 桌面应用设置

Tauri 桌面应用自身设置：开机启动、全局快捷键、桌面快捷方式、退出策略。

工作原理（摘要）

Web 插件（宿主半）通过 /api/dsh-tauri-launcher/ 回环路由与浏览器半通信，
并使用标记文件协议控制桌面应用（详见 docs/architecture.md）：

- .dsh-heartbeat：桌面应用每秒写入时间戳，插件以此探测运行状态；
- .dsh-quit：写入 1 后桌面应用仅退出自身（保留 Harness 进程），消费时自删。

目录结构

dsh-tauri-launcher/
├── README.md             # 中文 README
├── README.en.md          # 英文 README
├── CHANGELOG.md          # 更新日志——发版说明的唯一来源（中英双语）
├── package.json          # dsh.bundle + dsh.client 双 manifest
├── cordis.patch.yml      # 组合补丁（插入插件行）
├── lib/
│   ├── index.js          # 宿主半：回环路由 + 控制逻辑（可配置）
│   └── client.js         # 浏览器半：设置分区 UI
├── launcher/             # Tauri 桌面应用工程（源码 + 一键构建；当前仅 Windows）
├── .github/workflows/    # CI：打 tag 自动构建 Windows exe 并发布 Release
└── docs/                 # 架构与发布文档
└── screenshots/      # README 引用的界面截图

安装（Web 插件）

关于 ：它指 DSH 的配置档（profile）——一套可启动的插件组合，
位于 $DSH_HOME/profiles//。 是占位符，需要替换成你实际
要装进的 profile 名。本机常见配置档名为 web（启动 DSH Web GUI 的档）；
查看已有档：dir %USERPROFILE%\.dsh\profiles（或 ls ~/.dsh/profiles）。
下面的命令示例中，把  换成 web 即可，例如 dsh plugin --profile web add ...。

三种方式任选（任选其一）：

1) npm（发布后）
dsh plugin --profile web add @lenorin/dsh-tauri-launcher

2) GitHub（git 安装；纯 JS 零构建，无需 allowBuilds 授权）
dsh plugin --profile web add github:cilis/dsh-tauri-launcher

3) 本地 checkout / tarball
dsh plugin --profile web add ./dsh-tauri-launcher
dsh plugin --profile web add ./dsh-tauri-launcher-1.0.3.tgz

如果你有多个 profile，把命令里的 web 换成目标 profile 名即可。

验证层已生效（应能看到 dsh-tauri-launcher 层）：

dsh --profile web --dump-config
重启 DSH Web 进程后，设置面板即出现「桌面启动」分区。卸载（web 换成你的 profile 名）：

dsh plugin --profile web remove @lenorin/dsh-tauri-launcher

配置

插件行支持以下配置（无硬编码可调参数；默认值适配常见部署）：

- id: desktop-launcher
name: '@lenorin/dsh-tauri-launcher'
config:
launcherExe: ''            # 桌面应用 exe 绝对路径；空 = 自动探测
launcherDirs: []           # 候选 exe 目录列表；空 = 内置默认候选
freshSecs: 4               # 心跳“新鲜窗口”（秒），须大于心跳写入周期

注：原 shortcutName 配置项已移除（2026-09）——快捷方式文件名由插件与桌面应用
共用同一常量（DeepSeek Harness.lnk）：两侧各自维护名字会导致各建出一个 .lnk。

候选目录的自动探测

心跳、退出标记与桌面应用配置都在桌面应用 exe 同目录，而桌面应用可能存在多份
副本（npm 包内预编译 exe、本地 build.ps1 产物）。插件按下述优先级挑目录，因此
无论实际运行的是哪一份副本，状态判定、退出标记与启动目标都会对齐到同一个实例：

1. 行配置 launcherExe 所在目录（硬指定）；
2. 正在运行的 dsh-launcher 进程所在目录（Get-Process 取 Path）；
3. 桌面快捷方式 DeepSeek Harness.lnk 的目标目录（WScript.Shell 读 TargetPath）；
4. 行配置 launcherDirs（候选列表）；
5. 本次插件运行中发现过的目录（实例退出后仍扫描其心跳，避免状态在「已停止/未知」间抖动）；
6. 包内 launcher/bin（兜底）。

只有真的含 dsh-launcher.exe 的目录会被采用——指向已删除副本的失效快捷方式会自动
跳过，回退到下一候选。运行中实例/快捷方式目标的探测结果缓存 5 秒；探测不可用时
（无 subprocess 服务等）自动回退到第 4/6 项，行为与旧版一致。

桌面应用构建与发布

- npm 包自带预编译 exe（launcher/bin/dsh-launcher.exe），插件安装后自动探测、装上即用；
- 本地自行构建：pwsh -File launcher/build.ps1（可选 -Offline -CargoHome ）；
- ⚠️ 维护纪律：修改 launcher/src-tauri 下的 Rust 源码后，必须重新构建并同步
launcher/bin/dsh-launcher.exe（发布流程见 docs/release.md），
否则 npm 包内 exe 与源码漂移；版本号需在 package.json / Cargo.toml /
tauri.conf.json 三处同步。
- GitHub Release：推送 v tag，CI 自动构建 Windows exe 并发布（Linux/macOS 构建
尚未启用，见 docs/release.md）。

文档

- docs/architecture.md — 架构与标记文件协议
- docs/release.md — 安装、构建、发布、卸载与配置参考
- CHANGELOG.md — 更新日志（逐版本发版说明，GitHub/Gitee 发行版正文的来源）

License

MIT