dsh-terminal-tabs

dsh-terminal-tabs

English | 中文

把模型运行的命令行——后台的和前台的都算——变成对话界面里看得见、点得关的东西:在 Web GUI 的「对话 / 轨迹」标签行右侧贡献一个**「命令行」视图标签**,标签文案实时反映当前会话存活的后台任务数量(命令行1、命令行×3);点击进入管理页,每条命令一行:

• 中文功能标题:本地启发式词典从命令推断用途(cd → 打开文件夹、git status → 查看 Git 状态、Start-Sleep → 等待、npm run dev → 启动开发服务……),子代理显示「子代理任务」;无法识别时回退「执行命令」,原始命令始终完整可见
• 前台命令也计入:模型通过 pwsh/bash 工具前台执行的命令(瞬时完成、从不进入 jobs 注册表)同样会被宿主半捕获——包装 ctx.shell.run(),按发起会话归属,经 /dsh-terminal-tabs/foreground 路由下发。运行中的行绿灯脉动并逐秒计时;已完成的显示退出码与耗时,命令下方 chevron 可展开捕获的输出尾。与后台任务分行合并展示
• 可折叠命令正文:默认一行省略,行尾 ▼ 图标点击展开完整命令并变为 ▲,再点收起
• 实时输出流(展开时):每 0.3 秒泵送的进程输出副本驱动一个深色滚动框,自动吸附最新约 10 行;鼠标滚轮上翻即可回看历史,滚回底部恢复跟随。模型侧的读取游标字节级不受影响(tee 是唯一消费者,按"自上次读取以来"的契约向模型补发积压)
• 时间与时长:标题右侧显示开始时钟(HH:MM:SS)与持续时长(秒 → 分秒 → 时分),逐秒跳动
• 一键关闭:行内「关闭」按钮经宿主路由终止对应进程,注册表所有权围栏原样生效

后台子代理(subagent)一并计入,紫色圆点区分。

功能

• 真标签页:通过官方 conversation.view 座位注册,与「对话」「轨迹」同源同权;切换、选中态由框架管理。
• 实时可见:后台任务数据来自宿主推送的 jobsBySession 镜像;标签文案在每次投影时读当前会话镜像,零轮询 RPC。前台命令由页面打开期间轮询 /dsh-terminal-tabs/foreground(1.2 秒)合并展示。
• 会话隔离:标签与列表始终只反映当前正在查看的会话;前台命令按发起 agent 归属会话。
• 稳定编号:页面内按首次出现顺序编号,前面的任务结束不打乱后面行的编号;重新进入页面紧凑重排。

实时输出的实现边界

浏览器展示的输出来自插件在宿主半对 ctx.shell.start() 做的实例级包装:每个成功 spawn 的进程被一个私有定时游标持续抽干,增量同时写入每进程环形缓冲(48 KiB 上限,最旧滚出)。模型的 readOutput 语义保持不变——包装层是唯一消费者,模型每次读取仍拿到"自它上次读取以来"的全部字节。因此:

• 包装挂载之后启动的后台任务才有实时输出;更早的任务显示"(暂无输出)"
• 持久 PTY 终端会话(ctx.terminals)不走此通道,不展示
• 若未来宿主改动 ShellProcess.readOutput 的返回形状(当前为 { delta }),包装需同步调整——失效表现仅为看不到输出,不影响关闭等其他功能
• 前台命令走另一条独立的 ctx.shell.run() 包装;无发起 agent 归属的运行原样放行。已结束条目保留最近 16 KiB 合并输出

配置(cordis.yml 行 config,均可省略)

安装

dsh plugin --profile web add github:bbboy31/dsh-terminal-tabs

纯 JavaScript 双平面插件(host 半 index.js + 浏览器半 client.js),无构建步骤。安装后刷新页面即用。

卸载

dsh plugin --profile web remove dsh-terminal-tabs

或在 插件市场 → 已安装 → 卸载(两步确认)。卸载会随纤维一并移除路由、标签与样式,无残留。

开发提示:Loader 按包名缓存已导入模块——改完宿主半后热重载不会生效,需更换包名(如 -r2)或重启进程;浏览器半改动刷新页面即生效。

许可

MIT