dsh-launcher-lifetime
> ## ⛔ 停更公告（2026-09-29）
>
> 本项目停止更新。 dsh 官方桌面端已自带托盘，本插件要解决的"服务驻留/托盘"问题不再有需求。
>
> - 本仓库已归档为只读：不再接受 issue、PR、commit。
> - npm 上的 dsh-launcher-lifetime 已下线，dsh plugin add dsh-launcher-lifetime 不再可用。
> - 已装上的副本仍能继续运行，但不会再有修复或兼容更新；dsh 升级后本插件的兼容性不作保证。
> - 需要托盘行为请使用 dsh 官方桌面端自带的托盘。
>
> 下方内容作为历史实现说明保留。
> DeepSeek Harness (dsh) 插件：控制 node 服务的驻留——配合 dsh-launcher 壳，决定关闭窗口 / 托盘退出时 node 服务是继续运行还是退出。
为什么需要它
dsh 是一个完整的服务进程（几百 MB 内存）。默认情况下它常驻运行（秒开，但一直占内存）。本插件把"node 服务何时退出"的控制权交给你：
- 想要省内存 → 关窗即停服务，下次启动自动拉起（约 1–3 秒）
- 想要秒开 → 保持常驻
- 想要折中 → 托盘驻留（关窗最小化到托盘，明确"退出"才停服务）
特性
- 🎛️ 三种驻留模式：
跟随窗口/常驻/托盘驻留 - ⚙️ 配置入口：dsh 设置页的 "Node 服务驻留" 页面（竖排单选，即时生效）；也可用 dsh 的 cordis 配置
- 🪶 零运行时依赖：只写一个 JSON 文件，不加载任何第三方包
- 🛡️ 安全：只停 dsh-launcher 壳自己拉起的服务，外部托管 / 手动启动的服务不受影响
工作原理
用户配置 → 插件写入 DSH_HOME\dsh-launcher\settings.json
↓（每次关窗/托盘退出时读取）
dsh-launcher 壳执行：继续运行 / 最小化到托盘 / 停止服务
| 值 | 模式 | 行为 |
|---|---|---|
0 |
常驻（默认） | 服务一直运行，关窗/托盘退出都不停 |
1 |
托盘驻留 | 关窗最小化到托盘；托盘"退出"才停服务 |
2 |
跟随窗口 | 关窗即停服务并退出（最省内存） |
安装
已停用：包已从 npm 下架，仓库已归档。历史安装方式（仅对本机已有的源码副本有效）：
dsh plugin --profile web add dsh-launcher-lifetime
兼容性
逐版本兼容声明写在 package.json 的 dsh.compatibility.dshReleases（DSH STORE 的自动检查读取的就是这张表，宽泛范围不被接受为证据）：
| DSH 版本 | 状态 | 依据 |
|---|---|---|
0.1.5-rc.1 |
compatible | 本机 profile 实装：dsh.profile.bundles 含本包，壳按 settings.json 的 serviceLifetime 生效（壳检测不到插件时会抹掉该键） |
0.1.5-rc.2 |
compatible | 与 0.1.5-rc.1 相比，提供本插件所用全部接缝的包（dsh-host-webserver、dsh-client-modules、dsh-client-ui-settings、dsh-cordis-client-runner、dsh-web、dsh-web-app、dsh-app-boot、dsh-package-manifest）逐文件一致，去掉版本号串后无任何差异 |
0.1.6-alpha.1 / 0.1.6-alpha.2 |
compatible | dsh-host-webserver、dsh-client-ui-settings、dsh-web 仍逐文件一致；有变化的 dsh-client-modules / dsh-cordis-client-runner / dsh-web-app / dsh-app-boot / dsh-package-manifest 均为增量：window.__ModuleLoader__.load({id, factory}) 握手不变、require 新增 .async()、注册可带可选 chunk、dsh.client 新增可选 immediately/external、manifestVersion 仅可选不强制；dsh.bundle.patch 的 profile 分层规则逐字未变 |
边界（不要把它读成运行验收）：以上是源码契约比对——对照 npm 上发行的官方包产物核对插件实际消费的面，不是在这些版本上做过一次性 Profile 安装/启动/卸载。插件实际只依赖四个面：宿主半的 ctx.webServer.register({kind:'exact', path, handler}) 与 ctx.effect，客户端半的 window.__ModuleLoader__.load({id, factory}) 信封、settings.section 席位注册和 react 模块边。任一面在未来版本变动时本表需重新核对。核对方法：从 npm registry 取上述各包在该版本的发行产物，解包 lib/（不安装、不执行任何 lifecycle），抹掉版本号后逐文件比对，再对改动文件判定是否影响上述四个面。
配置
方式一：dsh 设置页（Web GUI）（推荐，即时生效）
打开 dsh 设置页 → "Node 服务驻留" → 选择其一（竖排单选，每个选项下有说明）。
更改通过 HTTP 路由（GET/POST /dsh-launcher-lifetime/settings）写入设置，无需重启，
下次关窗/托盘退出即按新模式执行。
方式二：dsh 的 cordis 配置（需重启 dsh 生效）
在 profile 的 cordis.patch.yml 中加入：
- id: dsh-launcher-lifetime
config:
serviceLifetime: 1
侧边栏图标（可选，本机定制）
dsh 设置页的导航图标由 dsh 内置的 navIcon(id) 映射决定：只有 models /
agent-presets / plugins 有专属图标，其余设置页（包括本插件）统一显示齿轮。
如需给本插件的设置页换成专属图标，可编辑全局 dsh 包（dsh 升级后需重新应用）：
node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-client-ui-settings-general/lib/client.js
在 navIcon 函数的 return IconSettingsOutline16（齿轮兜底）之前加入：
if (id === "launcher-lifetime") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline16, {
className: SettingsRoot_module_css_default.navIcon,
size: 16
});
改完重启 dsh 服务生效（IconRefreshOutline16 可换成 primitives 中任意图标）。
开发
npm install -D esbuild # 仅开发依赖
npm run build # src/index.ts → lib/index.js；src/client/* → lib/client.js（构建产物已提交，可直接用）
插件刻意不 import 任何 @deepseek-ai/* 包（dsh 的模块解析按 profile bundle 进行，外部依赖不可靠），配置手动校验。
Web 客户端面（src/client/）通过 dsh.client + exports["./client"] 声明，由 dsh 的 client-modules 挂载到设置页 slot。
贡献
本项目已停更，issue 与 PR 入口已关闭，不再接受贡献。
相关项目
- dsh-launcher — 本插件配套的 Windows 启动器壳（托盘菜单、服务生命周期执行），同样已归档停更
许可证
MIT © dsh-launcher contributors
