DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

TheColdWorld /

TheColdWorld/dsh-wsl-keepalive

Verified

a Ai-Gererated plugin for Dsh alive in Windows Subsystem of Linux

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@050f8c67

dsh-wsl-keepalive — WSL 多发行版保活开关

中文 | English

[!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

—/ 5

No ratings yet

Verified DSH bundle

Commit 050f8c67eb2b

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout