dsh-console
dsh-console
DSH 控制台插件——在 Web 界面直接开真 PTY 终端跑命令，不离开聊天上下文。
Report an issue
· View on GitHub
dsh-console 是一个社区维护的 DSH 插件，非 DeepSeek 官方产品。
功能
- 主视图「控制台」标签页：与「对话 / 轨迹 / 任务面板」同级，iTerm 风格深色多标签栏
- 真 PTY 交互终端：每个标签一个独立 PTY 会话（node-pty 底层），vim / top / htop / ctrl+c 等交互式程序全支持
- 用户真实 shell 环境：登录 shell（
$SHELL -l）+ 完整环境变量透传 + 256 色，conda / git 状态提示符原样呈现
- 输出不丢：host 侧 512KB 环形缓冲，切标签、刷新页面、断线重连后自动回放还原画面
- 多标签管理：
+ 新建、× 关闭、绿点存活指示、状态栏显示 pid 与几何尺寸、一键清屏
安装
方式一：一键脚本（推荐）
# 解压后进入插件目录
cd dsh-console
./install.sh # 复制到 ~/.dsh/profiles/web/ 并注册 bundles
# 然后重启 DSH，浏览器打开任意会话即可看到「控制台」标签
install.sh 做三件事：拷贝到 ~/.dsh/profiles/web/node_modules/dsh-console → 在 profile package.json 的 dsh.profile.bundles 追加 dsh-console → 提示重启。重复执行安全（幂等）。
方式二：手动安装
# 1. 拷贝插件（lib/ 已构建，无需再 build）
cp -R dsh-console ~/.dsh/profiles/web/node_modules/dsh-console
# 2. 注册 bundle：编辑 ~/.dsh/profiles/web/package.json
# dsh.profile.bundles 数组里加一行 "dsh-console"
# 3. 重启 DSH
包内 lib/ 已是构建产物，外部安装无需 Node 工具链。仅修改源码重新构建时才需要 pnpm install && pnpm build。
使用
- 重启 DSH 后浏览器打开
http://127.0.0.1:3080，进入任意会话
- 顶部标签栏出现「控制台」（位于「轨迹」与「任务面板」之间）
- 点
+ 或「新建终端」开一个 PTY 标签，直接键入命令
- 关闭 DSH 前记得保存终端里的工作（PTY 会话不跨 DSH 重启，与 iTerm 关窗一致）
架构
浏览器 (xterm.js, 每标签常驻实例)
├── 下行: EventSource GET /plugins/dsh-console/stream?tab=<id>
│ 连接即回放环形缓冲 → 实时转发 PTY 输出（SSE, 15s 心跳）
└── 上行: POST /plugins/dsh-console/rpc
tab.list / tab.open(cwd?) / tab.close(id) / tab.write(id, data)
DSH host 半 (src/index.ts)
├── ctx.subprocess.spawnTerminal → 用户登录 shell + process.env
├── host 侧常驻泵: PTY 输出 → 512KB 环形缓冲 + 广播订阅者
└── 插件卸载/DSH 退出: terminate 全部 PTY
- host 半（
src/index.ts）：RPC + SSE 路由注册到 ctx.webServer，PTY 生命周期与标签注册表
- client 半（
src/client/index.ts）：React 组件 + xterm.js，经 slots.inject('conversation.view') 注册主视图标签页；xterm 及 CSS 全部内联进单个 bundle（lib/client.js，约 400KB），无外部资源依赖
- 构建：
tsc -p tsconfig.json && tsc -p tsconfig.client.json && tsdown（client 走 harness 的 ModuleLoader 打包协议）
已知限制（v1）
| 限制 | 原因 | 方向 |
|---|
| 固定 120×34，无 resize | DSH subprocess seam 未暴露 resize API | v2 走 DSH 源码补丁注册表加 p10 |
| PTY 会话不跨 DSH 重启 | 标签注册表为进程内存态 | 与 iTerm 关窗一致，属预期行为 |
| 终端标题固定「终端 N」 | 未解析 OSC 标题序列 | 可从输出流解析 \x1b]0; 动态更新 |
开发
pnpm install && pnpm build # 构建 host + client bundle
# 重新部署到本机 profile：
cp -R . ~/.dsh/profiles/web/node_modules/dsh-console
# 重启 DSH 后生效
修改 client 半后必须重跑完整 pnpm build（tsdown 会重新内联 xterm）。
环境要求
- DSH (DeepSeek Harness)
--profile web 运行环境
- Node.js ≥ 18（仅构建需要；安装预构建包不需要）
