dsh-terminal

VSCode 风格的内置终端面板，基于 xterm.js（浏览器端）+ node-pty（宿主端）。它是一个独立的 dsh 插件包，源文件位于本目录，宿主端与浏览器端各占一半：

• 宿主端（src/index.ts + src/host/manager.ts）：在 ctx.webServer 上注册 /terminal WebSocket upgrade 路由，用 node-pty 为每个终端会话拉起一个真实 shell，把终端的输入/输出/尺寸变化在 WebSocket 上双向转发。Windows 下优先使用 PowerShell 7（pwsh，已安装时），否则回退到 Windows PowerShell 5.1（powershell.exe）并注入 UTF-8 引导参数（详见 docs/README.md 的「中文乱码」一节）；其他平台默认 bash。
• 浏览器端（src/client/*）：通过槽位系统在会话页下方挂一个可拖拽调高的面板，标题栏参考 VSCode，提供终端标题、下拉切换、新建/关闭当前/关闭面板；在输入栏「上下文」按钮旁（conversation.input.right）加一个拉起/收起按钮，并绑定 `Ctrl+`` 快捷键。

功能

• `Ctrl+`` 在会话内拉起/收起终端面板。
• 面板位于会话页下方（composer 下方），拖动顶部分隔线调整高度。
• 标题栏：终端标题下拉切换、新建终端、关闭当前终端、关闭面板。
• 输入栏右侧新增终端切换按钮（与「上下文」按钮同处工具行）。

构建

cd plugins/terminal
pnpm install
pnpm run build

产物：lib/index.js（宿主端）、lib/client.js（浏览器端，内联 xterm.js）。

桌面外壳的 npm run build（和 npm run setup）现在会自动执行上面的 构建 + dsh plugin --profile web add 安装 + cordis.patch.yml 挂载 （npm run install:plugins），无需手动重复。

本仓库的 Node 是 v26，系统自带 pnpm 7.x 与之不兼容，请用仓库固定的 E:\Git\dsh-gui\.toolchain\pnpm.cmd（11.7.0）代替裸 pnpm。

安装

自动路径：在仓库根目录直接运行 npm run install:plugins（或 npm run build）， CLI 会构建、安装并把插件挂进 web 组合（挂载 id 来自 package.json 的 dsh.gui.mountId，本插件为 terminal）。

手动路径等价于以下两步：

# 从仓库根目录；DSH_HOME 已固定为 .dsh。同样请用 .toolchain\pnpm.cmd。
dsh plugin --profile web add link:./plugins/terminal

然后在 .dsh/profiles/web/cordis.patch.yml 中加入（dsh plugin add 只建依赖，不挂载）：

- insert:
    - id: terminal
      name: dsh-terminal

重启桌面外壳（npm start 或直接运行仓库根目录的入口二进制）后生效。

已知限制

• 终端进程按浏览器页面存活：刷新页面或关闭标签会结束该页面下的全部终端；切换会话不会自动回收上一会话的终端（v1 简化）。
• 产品文案目前直接写死中文，未接入 ctx.locale 词典。
• 关闭终端时，宿主日志可能出现 node-pty 的 AttachConsole failed 告警：桌面外壳以无控制台方式启动宿主进程，node-pty 在 Windows 上枚举控制台子进程失败（仅影响外壳内子进程的级联清理，终端本身仍会正常关闭）。这与宿主自带终端工具的行为一致。
• Windows 下若不安装 PowerShell 7，中文终端回退到 powershell.exe + UTF-8 引导：Get-Content（cat）对无 BOM 的 UTF-8 文件能正确读入，但 Windows PowerShell 5.1 本身的其他编码局限（如外部原生命令按 OEM 码页输出）仍可能存在；遇到此类问题请安装 PowerShell 7 或设置 DSH_TERMINAL_SHELL 指定 shell。