底部终端面板 btsd321/dsh-oh-my-terminal

dsh-oh-my-terminal

DSH Web GUI 的底部终端面板插件，基于 @lydell/node-pty 提供多终端交互式面板，经 WebSocket 与浏览器端的 xterm.js 通信。支持 Windows ConPTY 与 POSIX openpty，无需本地编译。

功能特性

- 多标签终端：同时管理多个会话，右侧列表替代水平 tab 栏，支持右键重命名
- 拆分终端：同组内水平并排，+号旁下拉菜单（新建 / 拆分 / 按种类新建），VSCode 风格操作
- 会话持久化：面板收起后会话保持存活，重新打开后自动恢复
- 快捷键开关：可配置快捷键呼出/收起面板；接入宿主统一快捷键系统，在设置界面改键后标签跟随更新
- 拖拽调高：拖拽面板上边缘调整高度
- 跨平台：Windows ConPTY / POSIX openpty，由 @lydell/node-pty 自动选择，二进制随 tarball 分发，安装即用
- 配置表驱动终端：终端配置表（type / name / path）驱动新建终端；启动时自动探测 $PATH 中的终端，可在设置界面新增、改名、编辑路径
- 字体可配置：字体族、字号、行高可配置，配置变更对已打开终端即时生效
- DSH-better-sidebar 兼容：运行时自动检测 DSH-better-sidebar，检测到时切换为兼容模式——通过 ctx.betterSidebar.registerTab() 注册"终端"tab 嵌入其底部工作台，替代独立底部面板；PTY 会话不绑定 DSH session 的 write handle，从根源消除与 DSH-better-sidebar 自带终端的冲突。当宿主支持 TabDescriptor.rightActions（v0.25.0+）时，终端操作按钮（新建 / 拆分 / 重启）注入 tab 标签条右端，VSCode 风格单层栏；不支持时回退为 tab 内容区顶部头部栏（两层显示）

安装

本仓库尚未发布到 npm，通过 GitHub 地址安装：

dsh plugin --profile web add github:btsd321/dsh-oh-my-terminal

配置

| 配置项 | 说明 | 默认值 |
| toggleShortcut | 呼出/收起终端面板的快捷键（仅旧宿主生效，见下方适配说明） | Ctrl+Shift+ |
| fontFamily | 终端字体族（CSS font-family 串）；留空使用内置默认字体栈（含 CJK 回退） | '' |
| fontSize | 终端字号（像素） | 12.5 |
| lineHeight | 终端行高倍数 | 1.25 |
| terminalProfiles | 终端配置表（JSON 数组）；留空 = 用启动时探测到的 $PATH 终端 | '' |

终端配置表

终端配置表是 { id, type, name, path, origin } 条目的 JSON 数组：

- type：决定 spawn 语义 — pwsh / powershell / cmd / bash / zsh / fish / gitbash / nushell / custom
- name：下拉菜单显示名（用户可改）
- path：可执行文件路径；留空 = 按 type 在 $PATH 中解析
- origin：auto（启动探测）/ user（手动新增）

自动探测项（origin: auto）不可删除、路径不可改，但名称始终可编辑。配置表可在设置界面内 inline 编辑、新增行、删除。

开发

安装依赖（@lydell/node-pty 自带各平台预编译二进制，装完即用，无需本地编译）
pnpm install

类型检查
pnpm run typecheck

构建（esbuild 双入口，产物输出到 lib/）
pnpm run build

单元测试
pnpm exec tsx --test tests/unit/*.test.ts

请使用 pnpm，不要用 npm。peer 依赖钉死具体版本，npm 在旧依赖树上做增量解析会报 ERESOLVE。

关于构建产物

lib/ 已纳入版本控制。DSH loader 通过纯 ESM import 加载插件，不走 tsx；同时本仓库不声明 prepare/postinstall 等生命周期脚本（pnpm 11 对声明了安装类脚本的 git-hosted 包直接报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），因此构建产物需开发者手动执行 pnpm run build 后随源码一起提交。

原生依赖说明

终端能力来自 @lydell/node-pty（microsoft/node-pty 的预编译分发版，API 同源），版本精确钉在 1.1.0：该包 dist-tags.latest 指向 1.2.0-beta 系列，用 ^ 会取到 beta。

它是 N-API 产物，二进制按平台拆成六个子包随 tarball 分发，安装期不下载、不编译，同一份二进制同时支持 Node 22 与 Node 24。其 package.json 中不存在 scripts 字段，pnpm 10/11/12 对没有脚本字段的包不进入构建授权判断分支，行为一致。

宿主半对它是懒加载（首次创建会话时才 await import()）：原生绑定若加载失败，异常只影响会话创建，不会让插件模块本身导入失败。

架构概览

src/
├── index.ts # 宿主半入口（Cordis 插件 + settings + 会话生命周期） ├── routes.ts # HTTP 路由处理器 ├── ws-handler.ts # WebSocket 处理器（pty 数据转发） ├── client.tsx # 浏览器半入口（React 组件 + 插件注册） ├── client/ │ ├── types.ts # 共享类型 │ ├── hooks.ts # useReducer 状态管理 + 自定义 Hooks │ ├── term-pane.tsx # xterm.js 终端面板组件 │ ├── dropdown.tsx # +号旁下拉菜单 │ ├── side-list.tsx # 右侧终端列表 │ ├── styles.ts # CSS 常量 + Campbell 暗色主题 │ ├── icons.tsx # SVG 图标组件 │ ├── clipboard.ts # 剪贴板工具函数 │ ├── shortcut-bridge.ts # shortcuts 服务接入桥（命令注册 + 面板切换回调） │ ├── compat.ts # DSH-better-sidebar 兼容模式检测（软探测 ctx.betterSidebar + 服务最小接口声明） │ ├── sidebar-tab.tsx # 侧边栏终端 tab 组件（兼容模式：嵌入 DSH-better-sidebar 底部工作台，不绑定 DSH sessionId） │ ├── settings/ # 设置界面（types / store / card / profile-table / api / styles） │ └── terminal/ # 终端标签页状态（use-tabs / reducer / use-terminal-state / geometry） ├── persistence.ts # 会话持久化层（日志落盘 / 元数据 / 启动恢复） ├── platform.ts # 平台适配层（POSIX / Windows + shell 探测） ├── terminal/ # 终端种类、探测、解析、配置表校验 ├── settings/ # Settings 桥接层（命名空间 / 路由 / patch 操作） ├── constants.ts # 协议 / 尺寸 / 快捷键 / 环境变量常量 ├── server-command.ts # 命令行解析工具 ├── shortcut.ts # 快捷键解析工具 └── logger.ts # 统一日志工具

宿主半与浏览器半经 WebSocket 通信，路由前缀 /api/dsh-oh-my-terminal，不直接 import。

License

Apache-2.0