dsh-background-agents DSH 插件

该插件将 DSH 内置的后台作业升级为完整的后台代理会话。您可以在不离开当前会话的情况下启动一个持久的子代理，并向其发送消息、引导和中断。它包含自动报告、空闲归档和用于管理代理的 Web UI 面板。

如何安装 dsh-background-agents DSH 插件

dsh plugin --profile <name> add "github:PerryLink/dsh-background-agents#v0.4.0

来源命令需要人工核对。复制不会执行命令。

dsh-background-agents DSH 插件数据来源

dsh-background-agents DSH 插件快照日期：2026年8月16日

discovered

dsh-background-agents DSH 插件能做什么

启动可延续的后台代理，并可配置 tool_filter、persona 和 max_depth。
通过 bg_message 向代理发送消息，用于纠正或补充工作。
使用 bg_list 列出所有代理及其状态、活动、消息计数和最后活动时间。
使用 bg_result 获取代理的最新输出，包括推理回退。
每个子代理回合后自动注入进度信息，支持节流和可选的唤醒。

dsh-background-agents DSH 插件适合哪些场景

使用持久后台代理监控代码仓库的测试失败。
将长期研究任务委托给后台代理，同时继续主对话。
向后台代理发送增量更新或更正，以进行持续工作。
从 Web UI 的单个仪表板面板管理多个后台代理。
在 DSH 重启后恢复和恢复后台代理。

dsh-background-agents DSH 插件适合谁

需要运行可交互引导的长期后台任务的 DSH 用户。
使用多个并行代理会话自动化复杂工作流的开发者。

dsh-background-agents DSH 插件的限制

需要子代理 spine（dsh-subagent、dsh-subagent-spawn-in-process、dsh-session-projection）已安装。
默认情况下，非归档后台代理的数量上限为 4（可配置）。
默认启用空闲归档；代理在 120 分钟无活动后归档（可配置）。
不支持跨机器或远程代理执行。
不支持定时调度；该插件仅关注交互式引导。

dsh-background-agents DSH 插件的仓库 README 摘录

以下文字摘自 dsh-background-agents DSH 插件的上游仓库 PerryLink/dsh-background-agents 的 README，版权归原作者，仅作引用。

> Interactive, long-session background agents for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). Start a durable child agent that keeps working while you keep talking —watch its progress, steer it with messages, and stop it, all without leaving your session. [English](./README.md) 路 [涓枃](./README.zh.md) 路 [Espa帽ol](./README.es.md) 路 [Portugu锚s](./README.pt.md) 路 [啶灌た啶ㄠ啶︵](./README.hi.md) [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE) [![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-4d6bfe)](https://github.com/topics/dsh-plugin) [![topic: dsh](https://img.shields.io/badge/topic-dsh-4d6bfe)](https://github.com/topics/dsh) DSH's built-in background *jobs* are fire-and-forget tool executions: you can read output and kill them, but you cannot talk to them. `dsh-background-agents` upgrades that to **full background agent sessions** on the official subagent seam —a continuable child conversation you can message, steer, and interrupt at any time, while an injected progress line after each of its turns keeps you (and the model) in the loop. ## What you get - **`background_agent`** —start a durable, continu

阅读完整 README仓库许可: Apache-2.0

dsh-background-agents DSH 插件常见问题

如何安装 dsh-background-agents？

通过 DSH 插件 CLI 安装：`dsh plugin --profile <name> add "github:PerryLink/dsh-background-agents#v0.4.0"`。建议使用固定的 git 引用来避免构建步骤；该包也以 `dsh-background-agents` 发布在 npm 上。

如何启动一个后台代理？

在任何会话中，直接询问模型或使用工具：`background_agent "监控代码仓库的测试失败" (label: test-watch)`。代理将立即启动并返回一个代理 ID。

如何向现有的后台代理发送消息？

使用 `bg_message` 工具，指定代理 ID：`bg_message <agentId> "也检查一下快照测试"`。消息通过官方 FIFO 收件箱传递。

后台代理在 DSH 重启后是否仍然存在？

是的，通过结构化事实通道持久化的代理在重启后会恢复。`bg_list` 工具将显示它们及其状态。

默认的空闲超时时间是多少？

默认情况下，代理在 120 分钟无活动后会被归档。您可以在插件配置中设置 `idleTimeoutMinutes`，或禁用 `autoArchive` 使它们保持停车状态。