dsh-wsl-keepalive — WSL 多发行版保活开关
[!IMPORTANT] 非官方第三方项目。 本项目不是 DeepSeek 官方产品,不由 DeepSeek 开发、发布或背书。 DeepSeek、DeepSeek Harness、dsh 及相关名称归其各自权利人所有。
本插件完全由 AI 生成,以MIT协议进行分发
在 DSH Web 侧边栏的余额卡下方提供一行紧凑开关,用于统一开启/关闭多个 WSL 发行版的保活进程。
功能
一个开关管理多个发行版。
每个目标配置独立的用户;
wsl.exe路径是全局设置preferredWslExec,留空自动探测。默认保活隐式发行版:WSL 宿主使用运行 DSH 的发行版,优先读
WSL_DISTRO_NAME;该变量缺失时用wslpath -w /的 UNC 共享名(\\wsl.localhost\<名称>\或\\wsl$\<名称>\)作为第二次探测。Windows 宿主使用 WSL 的默认发行版,只认wsl -l -v的*行。WSL 宿主两个探测都失败时,不保活隐式发行版,也不回退到
wsl -l --running;开关下显示“无法识别dsh运行的发行版”,开关显示为关闭。Windows 宿主无法识别默认发行版时显示“无法识别WSL默认发行版”。目标必须显式填写发行版名,且不能重复。重复时提示“不允许添加相同的发行版”。
如果隐式发行版已经在目标列表中,默认保活开关锁定为开,不能关闭。
打开后 Tooltip 显示每个目标:
distro1(1234) distro2(5678)启动失败显示:
ubuntu(启动失败)不写“默认发行版”;无法确定发行版名时省略名称。
不注册快捷键,不做自定义键盘绑定。
不硬编码侧边栏收起宽度;布局跟随侧边栏的 wide 状态和 CSS 变量。
不使用 pgrep / pkill。停止使用:
wsl -d <distro> -u root --exec kill <pid>使用解析后的
wsl.exe路径和该目标的发行版;kill 前再次校验 PID 为数字且/proc/<pid>/cmdline含保活标记,校验不通过时不会执行 root kill。keepalive.sh 是唯一外部脚本。启动前由 Node 读回原始字节并逐字符比较, 不一致时覆写标准内容、chmod 700、记录日志并再次比较后才启动; 日志会带上被篡改文件的原文(JSON 转义、按长度截断); 不依赖 sha256sum/cut 等额外工具。
环境检测优先检查目标发行版的 binfmt_misc,再检查 /run/WSL interop socket,最后做真实 wsl.exe 探测。
要求
- DSH >= 0.2.2-rc.1 < 0.3.0
- Node.js ^22.19.0 或 >= 24
- WSL 宿主:能执行 wsl.exe 的 WSL 环境;Windows 宿主:以原生 Node 运行 DSH,并能调用 wsl.exe
- 目标发行版有 POSIX sh、sleep、kill、cat、chmod、grep、tr
安装
本地构建并链接:
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)
或从 GitHub 安装:
dsh plugin --profile web add github:TheColdWorld/dsh-wsl-keepalive
Git 安装会执行 prepare 脚本构建 lib/。pnpm 10+ 首次会拒绝构建脚本,按 dsh 提示在 profile 的 pnpm-workspace.yaml 中允许该包即可。
卸载:
dsh plugin --profile web remove dsh-wsl-keepalive
配置
在 Plugins 页打开本插件的配置页,编辑目标列表。每个目标:
| 字段 | 说明 |
|---|---|
| 发行版 | 必填,trim 后不能为空,且不能与其它目标重复 |
| 用户 | 启动保活进程的用户;留空使用发行版默认用户 |
| wsl.exe 路径 | 全局设置;留空自动探测宿主默认路径(WSL:/mnt/c/Windows/System32/wsl.exe;Windows:%SystemRoot%\System32\wsl.exe),非空需解析为绝对路径并校验 |
配置页还有默认保活开关,默认开启:WSL 宿主显示“保活dsh所在的发行版(<发行版名称>)”,Windows 宿主显示“保活默认发行版(<发行版名称>)”。关闭后,如果目标列表为空,主开关不会启动任何保活进程。隐式发行版已经在目标列表中时,该开关显示为开启且不可修改。无法识别隐式发行版时,该开关显示为关闭(仍禁用),提示文字使用错误色。
保存前会把路径解析为绝对路径、检查文件存在且可执行,并执行一次
wsl.exe --version;任一步失败都会取消写入并显示原因。保存写入 profile 的
cordis.patch.yml。
从 0.3.0 迁移
0.3.0 的每个目标都有 wslExecPath。新版读取配置时会:
- 把
distro/userName映射为name/user; - 取第一个非空
wslExecPath作为全局preferredWslExec; - 丢弃发行版为空的目标,并把
keepDefault置为开启; - 丢弃重复发行版并记录警告。
开发
pnpm typecheck
pnpm test
pnpm build
pnpm pack
测试使用独立的 DSH_HOME 和 3099 端口,不影响正在运行的 3080 实例。详见 AGENTS.md。
License
MIT
No comments yet. Be the first to write one.