geebos/dsh-terminal

README excerpt

🌐 语言 / Language： 中文 English dsh-terminal 在 DeepSeek Harness Web 会话里内嵌一个 可折叠的交互式终端 ：每个 tab 都是一个跑在你本机（host）上的存活 PTY shell，浏览器端用 xterm.js 渲染成真终端。 预览 展开状态 —— 多 tab 终端、快捷命令 chips、设置与固定按钮： 收起状态 —— 紧凑的标题栏： 功能特性 - 真终端 ：每个 tab 一个存活 shell， vim / less 等全屏应用可正常使用。 - 熟悉的按键 ：Ctrl-C / Ctrl-D / Ctrl-Z 与本机终端一致。 - 自动重连 ：刷新或断网后自动恢复，回放近期输出。 - 快捷命令 ：一键 chips 执行常用命令，⚙ 弹窗管理（含别名）。 - 固定 ：可保持展开，或点击外部自动收起。 - 多标签 ：新建、关闭、重启 shell；shell 退出后一键重开。 - 对 agent 不可见 ：终端操作不进入对话。 - 双语与主题 ：界面支持中英文，配色跟随 web 主题。 安装 安装完成后重启 dsh web ，会话输入框上方即出现终端标题栏。 使用 - 点击标题栏展开终端； + 新建 tab、 × 关闭、■ 结束当前 tab 的 shell。 - 展开后标题行的 chips 是快捷命令，点击即注入当前 tab；⚙ 管理命令与别名。 - 图钉按钮控制固定：固定后点击卡片外部不自动收起。 - 刷新页面 / 网络闪断后自动重连并回放近期输出；host 重启后需新建 tab。 架构 - 控制面 （Typert，一元 JSON RPC）：tab 元数据与快捷命令，需要 agent 上下文（会话 cwd、沙箱策略、生命周期钩子）。 - 数据面 （插件私有 WebSocket ws(s):// /plugins/dsh-terminal/ws ）：文本帧为 JSON 控制帧（ attach / attached / exit / error / signal / resize ），二进制帧为原始终端字节；一个连接对应一个 tab。 - 信任栅栏 ：升级握手要求 Origin 与 Host 同源、Host 为 loopback 或 webserver 绑定地址；attach 的 (sessionId, tabId) 必须命中注册表，每 tab 至多一个观察者连接。 - 生命周期 ：dsh 会话销毁联动终止其名下全部 PTY；host 退出时全部终止；PTY 自然退出后 tab 保留（环形缓冲仍可回放）。 - 背压 ：任一 socket 发送队列超 1 MiB 暂停 PTY 输出、低于 256 KiB 恢复；超 8 MiB 断开慢消费者（客户端重连后从 ring 回放恢复）。 沙箱 - 交互终端 默认不受会…

Category