前言¶

在 DeepSeek Harness Web 中，子代理的运行状态往往分散在会话树中，手动追踪活跃实例、查看实时输出或对多个会话进行归档操作较为繁琐。此插件旨在通过一个集中的、可搜索的面板来解决这个问题，让开发者能够在一个视图中管理所有子代理。

插件介绍¶

dsh-subagent-workspace-ui 是一个由 miuzel 开发的 Web 客户端插件。它向对话头部操作行添加了一个“子代理管理”按钮，点击后打开一个可搜索的面板，用于显示 DSH 客户端运行时当前发现的所有子代理。

该插件遵循 MIT 许可证。

安装与启用¶

在 Web 配置文件中安装该包：

dsh plugin --profile web add dsh-subagent-workspace-ui

安装完成后，重启现有的 dsh web 进程，并刷新 http://127.0.0.1:3080 以加载插件。

核心功能¶

插件提供以下能力：

1. 视图与导航

   • 头部显示紧凑的标题栏触发器，展示活跃子代理数量和活动状态点，无需打开面板即可感知。
   • 默认显示当前工作区和当前会话的子代理，切换时自动更新。

2. 搜索与过滤

   • 支持按名称、标题、工作区名称搜索。使用 id: 前缀可仅搜索会话 ID（例如 id: graph:g-a92e1406）。
   • 支持按会话、工作区、类型进行分组，或按最近活动、名称、类型排序。
   • 提供分类标签（如全部、其他、审查、测试等），一次性子代理带有 ⚡ 一次性 徽章。

3. 子代理控制

   • 支持对单个子代理进行暂停、继续操作。
   • 支持一键暂停活跃子代理组。
   • 支持批量操作：归档、恢复、全选、基于时间的批量选择（支持 1000 条以内）。

4. 实时信息

   • 活跃的子代理会聚在顶部可折叠区域。
   • 显示每个运行子代理的最新两行实时输出、工具调用、上下文注入和命令状态。
   • 通过状态指示器展示结束状态：正常结束显示绿色空心环，异常结束（停止/错误/阻塞等）显示红色实心点。

注意事项¶

• 无需编译标志：发布的包包含预构建的 lib/，安装时不需要 --allow-build 标志。
• UI 适配：插件包含 cordis.patch.yml，用于覆盖默认的 conversation.session.header.lineage，同时保留标准 ui-subagent 插件启用，并提供侧边栏导航入口。
• 过滤机制：过滤和隐藏功能是插件本地的。被隐藏的子代理仅从列表中移除，不会删除 DSH 会话或工作区文件。