前言¶

DSH 的插件生态中，不少扩展会围绕服务启动、配置页和客户端能力做补充。dsh-launcher-lifetime 是其中一个比较具体的插件：它配合 dsh-launcher 壳使用，用来控制 dsh（node）服务的存活方式。

如果你在使用 dsh-launcher 启动 dsh 服务，可能不希望关闭窗口后服务一直留在后台；但如果你追求再次打开时快速可用，又希望服务常驻。这个插件把这类选择交给用户，提供三种驻留模式：常驻、托盘驻留、跟随窗口。

这是什么¶

dsh-launcher-lifetime 是一个 DSH 插件，用于配合 dsh-launcher 壳控制 dsh（node）服务的存活方式。它由 Ruler4396 发布，许可证为 MIT。

它解决的核心问题是：关闭窗口或从托盘退出时，dsh 服务应该继续运行、最小化到托盘驻留，还是直接停止。

核心功能¶

该插件提供以下已核实能力：

• 提供三种驻留模式：跟随窗口、常驻、托盘驻留。
• 在 dsh 设置页提供 “Node 服务驻留” 配置入口，竖排单选，即时生效。
• 支持通过 dsh 的 cordis 配置设置 serviceLifetime。
• 写入 DSH_HOME\dsh-launcher\settings.json，不加载第三方运行时包。
• 只停止 dsh-launcher 壳自己拉起的服务，外部托管或手动启动的服务不受影响。
• 通过 HTTP 路由 GET/POST /dsh-launcher-lifetime/settings 写入设置。

安装与启用¶

安装命令如下：

dsh plugin --profile web add dsh-launcher-lifetime

该插件需要配合 dsh-launcher 壳使用。安装前建议检查源码与许可证；插件会作为 dsh 插件运行，并按当前 dsh 进程权限访问本机文件。

典型用法¶

在 dsh 设置页中切换驻留模式¶

这是最直接的用法：

1、打开 dsh 设置页。

2、进入 “Node 服务驻留”。

3、选择其中一种模式，竖排单选，即时生效。

更改后，下次关窗或托盘退出时，dsh-launcher 壳会按所选模式执行。

通过 cordis 配置设置¶

如果希望通过配置文件控制，可在 profile 的 cordis.patch.yml 中加入：

- id: dsh-launcher-lifetime
  config:
    serviceLifetime: 1

其中 serviceLifetime 的取值为：

• 0：常驻，默认值。
• 1：托盘驻留。
• 2：跟随窗口。

cordis 配置需要重启 dsh 后生效。

侧边栏图标定制（可选）¶

设置页的侧边栏图标可以本机定制，但需要修改全局 dsh 包。由于 dsh 升级后可能需要重新应用，建议仅在必要时修改。

适用场景与注意¶

这个插件适合以下使用方式：

• 你在使用 dsh-launcher 壳启动 dsh 服务。
• 你希望关闭窗口时停止 dsh 服务，以释放内存。
• 你希望窗口最小化到托盘，但明确退出时才停止服务。
• 你希望服务常驻，减少再次启动的等待。

使用时注意以下几点：

• 该插件只影响 dsh-launcher 壳自己拉起的服务，外部托管或手动启动的服务不受影响。
• 设置页更改即时生效；cordis 配置需重启 dsh 生效。
• package.json 声明 Node 版本要求为 >=22.19.0。
• 社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系，不要把它理解为官方应用商店。
• 安装前应检查源码、依赖和许可证。

相关链接¶

目录页：

https://www.skillhub.cn/plugins/Ruler4396/dsh-launcher-lifetime

GitHub：

https://github.com/Ruler4396/dsh-launcher-lifetime