前言¶
DeepSeek Harness 的插件生态允许用户扩展 Web UI 的功能。在开发智能体或处理复杂任务时,模型启动的后台 Shell、子代理等进程往往在界面中不可见,难以管理和监控。这个插件通过在 Web UI 中注册一个独立的标签页,将这些后台和前台进程转化为可视化的列表,提供了实时状态、输出查看和进程控制的能力。
这是什么¶
这是一个为 DeepSeek Harness Web UI 设计的插件,由 bbboy31 维护。它的核心作用是将模型运行的命令(包括后台和前台)转化为可视化的终端视图,提供进程管理、状态监控和一键关闭的能力。
核心功能¶
该插件提供以下已核实功能:
- 真实的标签页:插件通过官方的
conversation.view座位注册,与 Chat / Trajectory 处于兄弟节点,由框架管理选择。 - 实时标签:标签文本基于宿主机推送的
jobsBySession镜像重新解析,显示当前会话运行的后台 Shell 和子代理数量。 - 中文意图标题:使用本地启发式字典将命令映射为简短的中文短语(例如
cd映射为“打开文件夹”),子代理显示为“子代理任务”。 - 前台命令捕获:即使是在毫秒级完成的
pwsh/bash调用,也会被记录下来,与后台任务一起展示。 - 可折叠主体:命令显示一行截断文本,点击可展开查看完整内容。
- 实时输出:展开后台行会打开一个由私有 tee 提供的暗黑滚动回显,支持自动跟随最新输出。
- 计时功能:显示开始时间和每秒更新的经过时间(秒 -> 分秒 -> 时分)。
- 一键关闭:通过 Node 端的 HTTP 路由杀死作业。
安装与启用¶
使用官方安装命令添加插件:
dsh plugin --profile web add github:bbboy31/dsh-terminal-tabs
安装完成后,刷新 Web 页面即可看到新增的 Terminals 标签页。
典型用法¶
打开 Terminals 标签页后,会看到一个管理页面,每行代表一个正在运行的命令。该页面包含:
* 中文目的标题。
* 可折叠的一行命令体。
* 开始时钟加上每秒更新的经过时间。
* 实时输出窗格。
* 关闭按钮。
适用场景与注意¶
该插件适合需要在 Web UI 中集中管理和监控进程的场景。
注意事项:
* 权限限制:插件以当前 dsh 进程的权限运行。
* 启动时机:在包装器挂载前启动的后台作业,没有捕获的输出。
* 会话限制:持久 PTY 终端会话 (ctx.terminals) 不通过此通道;跨会话请求被拒绝。
* 卸载清理:卸载会移除路由、标签页和样式表,无残留。
* 开发提示:Loader 会按包名缓存导入的模块。编辑 Node 端代码需要重命名包或重启进程;编辑客户端端代码只需刷新页面。
短结尾¶
通过可视化和集中管理,该插件降低了在 Web UI 中监控和调试进程的门槛。
插件目录:https://www.skillhub.cn/plugins/bbboy31/dsh-terminal-tabs
GitHub:https://github.com/bbboy31/dsh-terminal-tabs