dsh-shell-surfaces
将机器的其他执行环境整合为一个 DSH 工具：WSL Linux 用户空间、nushell 的结构化管道、MSYS2 用户空间（bash/zsh/fish/brush），以及用于交互式程序的真实控制台。通过 surface 参数使用一个工具，让会话不再事事调用 pwsh。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Nesarf/dsh-shell-surfaces#02e70aa8159c82808ef42bbc2b8d085d492de9daShell Surfaces 以 dsh-shell-surfaces 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →https://github.com/Nesarf/dsh-shell-surfaces -- a DSH plugin, installed with
dsh plugin --profile <profile> add github:Nesarf/dsh-shell-surfaces.
One DSH tool for the execution surfaces this machine has besides pwsh: a WSL Linux userland, nushell's structured pipelines, the MSYS2 userland (bash / zsh / fish / brush), and a real console for interactive programs.
It exists because a rule that is only written down is not a capability. The selection rules for these surfaces have been recorded for a while, but a session could only act on them by composing a command string for pwsh and hoping the quoting survived the trip. Here they are callable.
shell_surfaces(action="surfaces") what exists here, and where each was looked for
shell_surfaces(action="run", surface="wsl", command="grep -P '(?<=Linux )[0-9.]+' /proc/version")
shell_surfaces(action="run", surface="nu", command="open data.json | where n > 3 | to json")
shell_surfaces(action="run", surface="msys", command="pacman -Q | wc -l")
shell_surfaces(action="run", surface="pty", command="powershell -File install.ps1", send=["y\n"])
Every registered tool spends part of the context on its description. Seven tools would say the same thing seven times. The selection rules -- which surface for a structured pipe, which for a Linux-only tool, which for a program that waits for input -- live in this one description, and a session reads them exactly when it is choosing.
Each of these was measured on this machine, and each shapes the argv:
| Fact | Consequence |
|---|---|
| A command handed through a shell can be re-parsed twice | The command travels as one argv element; a script file is preferred over an inline string |
MSYS2's /tmp follows TMPDIR, which this machine passes down as a Windows path | msys / zsh / fish run as login shells, which normalises the environment |
brush has no Cygwin runtime beside it, so /tmp is <drive>:\tmp | brush gets no login flag and no POSIX-path assumptions; its PATH needs usr\bin as well as ucrt64\bin, or every external command fails while the shell reports a healthy version |
PtyProcess.read blocks | Reading happens on its own thread; a read loop that also decides when to stop can block the very check that would stop it |
| A console wants Enter, which is a carriage return | send normalises a trailing newline (real, escaped, or literal) to CR, and a bare answer gets one added |
wsl.exe sometimes prints the result and then declines to exit | A timeout with output is reported differently from a timeout without it; wsl.exe --shutdown is the reset (measured: a cold instance answered in 58 s, the same call after a reset in 8 s, and warm in 0.13 s) |
| Path | What it is |
|---|---|
lib/index.js | the tool: one shell_surfaces, actions run and surfaces |
lib/surfaces.js | the table: paths, arguments, environments, and the absent-reason for each surface |
lib/runner.js | argv construction, bounded output with spill, timeout classification |
scripts/pty_runner.py | the console: pywinpty, a reader thread, ANSI stripping, one JSON report |
scripts/live-check.mjs | runs one real command per surface through the plugin's own code path |
scripts/pty-gate.ps1 | the interactive fixture: a Read-Host prompt for the pty case |
test/surfaces-test.mjs | the table, the argv shape, the tool contract |
node test/surfaces-test.mjs # 55 checks, no host needed
node scripts/live-check.mjs # one real command per surface on this machine
node scripts/live-check.mjs wsl nu # or only some of them
Every surface was also run for real (2026-10-15): wsl returned the kernel and a
/proc count, nu returned a number through a structured pipeline, msys returned
its bash version and a package count, zsh its parameter-expansion result, fish
its arithmetic result, brush an uppercased string, and pty answered a
Read-Host prompt with y and printed the branch it took.
LANG=C.UTF-8 is set). A Windows program
reached through a surface may still answer in the OEM code page.DSH_MSYS_ROOT if MSYS2 is not at D:\msys64;
nushell needs DSH_NU if nu.exe is not in %LOCALAPPDATA%\Programs\nu\bin;
the pty surface needs python on PATH with pywinpty installed.