宿主 Shell 后端 ch1bug/dsh-shell-host

dsh-shell-host

DSH bundle：Windows 上的宿主平面 shell 执行器替换层 —— 用可插拔后端替换内置的平台 shell 执行器（默认 msys2，另有 plain、pwsh；wsl 预留），并附带一张 Plugins 页设置卡片。MSYS2 只是默认后端，不是这个 bundle 的身份标识。

定位：MSYS2 是独立于任何单一 shell 的 ENVIRONMENT —— 安装根目录（msysRoot）、子系统（MSYSTEM）、PATH 暴露面、pacman/cygpath 工具链都是一等公民；bash 只是这个环境里可配置的 shell 二进制。内部的执行器 fork 自 @deepseek-ai/dsh-bash-local（0.2.0-rc.2）并做了泛化，对外接口完全一致 —— 同样的 bash 工具 schema、jobs、spill 文件、退出标记、configForms 命名空间结构 —— 所以每个预设的工具链都能原样跑在它上面。

这个 bundle 做什么（宿主替换）

cordis.patch.yml 作用于 HOST 平面（对每个预设都生效）：

1. 在 Windows 上禁用基础 bundle 的平台执行器：pwsh-sandbox（让出平台 shell 角色）和 bash-sandbox（重新声明；它在 win32 下的 bash -c 反正会撞上 C:\Windows\System32\bash.exe 这个 WSL 桩）。
2. 把本包的执行器插入为 ctx.shell（行 id shell-host；后端可配置：plain / msys2 / pwsh，默认 msys2，子系统 UCRT64 —— pwsh 在 #3 / D7 phase 1.5 落地，wsl 预留）。每个预设的 tool-bash 都会解析到宿主缝 —— Matt 工作流、随附预设、任何 bash 方言的东西都走这里。
3. 覆盖 terminal-controller（右侧边栏的 USER 终端）：MSYS2 bash --login -i 成为默认 shell，并带一个可见名字，同时剪掉裸 bash 候选（宿主 PATH 里没有 MSYS2，它只能解析到 WSL 桩）。安装时探测：没有 MSYS2 → 沿用上游的发现逻辑。

所有行都带 win32 守卫；在 POSIX 上这个 bundle 处于休眠状态。

宿主 MSYS2 前置条件（宿主环境最低工具集，2026-10-02 实测补齐）

本 bundle 只把 shell 缝绑到 MSYS2 bash —— 不负责装齐 MSYS2 工具链。裸 MSYS2 缺常用工具会让 agent 的验证手段悄悄降级（实测：diff/cmp 缺失时所有 diff 类验证被迫绕 git diff --no-index）。安装后请补齐：

pacman -S --needed diffutils patch jq unzip rsync

判定方法：agent 会话里 command -v diff 落空即缺。新增工具需求时在此处追加清单。

已知取舍：web-app 的 standard/minimal 预设会在 win32 上启用 pwsh 工具；替换之后它的命令文本会交给 bash（按上游约定，这条缝不做方言翻译）。部署了这个 bundle 就用 bash 方言的预设。

仿 VS Code 的内部实现

后端描述符（src/backends.ts）照搬 VS Code 的终端配置档：有序的可执行文件候选（ITerminalExecutable）、按模式区分的 argv 模板（IShellLaunchConfig）、配置档环境变量（MSYSTEM、CHERE_INVOKING=1，让登录 shell 保住工作目录），以及 addEnvMixinPathPrefix 风格的 PATH 前缀。探测逻辑（src/detect.ts）沿用 VS Code 的探测顺序，排除 WSL 的 System32 桩，失败时报错并列出每个探测过的位置。

前端设置页

src/client/ 提供浏览器端那一半（以 /plugins/dsh-shell-host/client.js 提供）：一张 Plugins 页面卡片（顺序 11，排在自带的 Shell 卡片之后），绑定到 shell-host configForms 命名空间 —— 后端、子系统、安装根目录、bash 路径，外加命令预算。值写入 settings 的 user-section，并重新应用到新命令，无需重载（所有配置字段都是易失的）。这个 bundle 的 lib/client.js 是基于平台模块表的闭包工厂产物（只依赖 @deepseek-ai/dsh-client-ui-primitives 和 react/jsx-runtime）。

来源（fork 基线，T1）

- 从 @deepseek-ai/dsh-bash-local 0.2.0-rc.2 fork 而来（© DeepSeek AI，MIT；见 LICENSE）。来源：上游 monorepo 标签 dsh-v0.2.0-rc.2，commit 639ed01539（packages/shell/bash-local）。在 0.1.7-rc.2 与 0.2.0-rc.2 之间，本包的 src/tests 逐字节相同（只有版本字段变了）；基线 = 本地桌面端（0.2.0-rc.2）实际运行的内容。
- 功能上的偏离： src/index.ts 与上游逐字相同；src/backends.ts / src/detect.ts 是本仓库的扩展（后端注册表 plain/msys2/pwsh + 保留的 wsl，pwsh 探测 —— #3 / D7 阶段 1.5），超出上游范围。移植测试的偏离（纯机械性，两者都在此说明）：
- tests/executor.spec.ts 从 ../src/index.ts 导入 LocalBashExecutor，而不是上游包名（这里的包是 dsh-shell-host）。
- tests/settings.spec.ts 从 ./helpers/ 导入 live-config.ts —— 这个 helper 逐字移植自上游 packages/settings/settings/tests/live-config.ts。
- 依赖：@deepseek-ai/* 包绝不从 npm 拉取。类型检查/构建/测试都针对本地上游 monorepo 检出（../deepseek-harness，固定到标签 dsh-v0.2.0-rc.2）解析它们：tsc 走继承的 tsconfig.base.json paths 映射，vitest 走显式源码别名，声明产出走 tsc -b 构建的声明文件，pnpm 用 link: 覆盖，这样安装器永远不会为该 scope 触碰 registry。工具链（typescript/vitest/tsdown）来自 npm。

状态：v0.1.x —— 宿主平面替换 + 设置页 + pwsh 后端（505be8e，#3 阶段 1.5；两个 facade 都通过类型检查，vitest 53 passed | 1 skipped，win32 实机 E2E 通过）。计划见 CONTEXT.md 和 GitHub Issues。