DeepSeek Harness 插件介绍：dsh-agent-team

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在默认的会话模式下，Agent 的状态往往随会话结束而重置，缺乏长期记忆。对于需要跨会话延续、持久化协作的团队工作流，需要一个独立的解决方案。

contexera/dsh-agent-team 是为此设计的插件。它为 DSH 提供持久化的 Agent 团队，成员在会话中断、重启或上下文滚动后，仍能保留其记忆、笔记和技能。该插件由 Contexera 维护，采用 MIT 许可证。

核心功能¶

该插件主要解决 Agent 的长期记忆与协作问题：

• 持久化成员：每个成员拥有独立的记忆、笔记和技能，这些状态在会话结束后依然存在。
• 工作空间与通道：通过 Workspace 组织不同项目的团队，通过 Channel 路由工作职责。
• 任务线程：管理单一的工作进度线，包含 Claims、Agent 切换、人工接收和后续回复。
• 上下文管理：支持滚动（Rollover）、检查点（Checkpoint）和压缩（Compact）三种模式，让 Agent 自主管理上下文，无需人工干预。
• Web 客户端：提供可视化的操作界面，用于创建工作空间、管理成员、发送消息和处理任务。
• Agent 工具集：为 Agent 提供 team_inbox, team_thread, team_attention, team_message, team_dm, team_claim, team_view 共 7 个工具。

安装与启用¶

在启用 Team 模式前，请确认 DeepSeek Harness 的版本。该插件认证版本为 DSH 0.2.0-rc.2。如果使用 0.1.7-rc.2 版本，需安装 @wowyuarm/dsh-agent-team 0.1.15；如果使用 0.2.0-rc.1 版本，需安装 0.2.0。

以下是启用插件的步骤：

1. 安装插件
   使用 dsh 命令将插件安装到 web 配置文件中。

    dsh plugin --profile web add @contexera/dsh-agent-team@0.2.3

2. 启动 Web UI
   插件安装后，启动 DSH 的 Web 界面。

    dsh web

3. 验证配置
   在启动 UI 之前，可以通过 --dump-config 检查配置文件中是否包含了 wowyuarm-agent-team-scope 和 wowyuarm-agent-team-client 等项。

    dsh --profile web --dump-config

典型用法¶

在浏览器中进入 DSH 导航栏的 Team mode，这是使用该插件的主要入口。典型的工作流如下：

1. 进入 Team 模式。
2. 选择或创建一个 Workspace。
3. 在 Channels 中创建新频道并发送第一条消息。
4. 在 Agents 中添加 Agent，并选择其初始所属的 Channel。

适用场景与注意事项¶

这是一个可选插件。安装后，普通 DSH 会话的预设保持不变；只有在使用 Team 模式时，才会加载 Team 相关功能。

• 版本兼容性：务必使用与 DSH 版本匹配的插件版本号，否则可能导致功能异常。
• 运行方式：不要从源代码 checkout 后通过 pnpm dsh web 启动，必须使用编译后的 CLI 工具。
• 权限管理：默认的 team-member 预设会授予 managed Agent Sessions danger-full-access 权限，请在受信任的工作空间中创建 Agent。

总结¶

dsh-agent-team 将 Agent 从临时的会话实例转化为持久的团队成员，配合工作空间、通道和任务线程机制，适合需要长期协作和知识沉淀的场景。

• GitHub 仓库
• 插件目录页