前言¶

在使用 DeepSeek Harness 进行多智能体开发时，同一仓库内的多个 Agent 可能同时处于活跃状态。缺乏协调机制会导致文件冲突、重复工作以及无效等待。dsh-cross-session-agent 是一个非官方插件，旨在解决这一问题。它为同一工作区的多个并行 Agent 提供了受限的 Peer 发现、消息传递、传输回执以及安全上下文投影能力。

插件简介¶

该插件由开发者 dd2673 维护，采用 MIT 许可证。它不提供完整的会话历史读取或权限继承，而是专注于在需要时，让 Agent 能够安全地发现协作伙伴、发送明确指令，并读取对方的进度证据。

核心能力¶

插件提供了以下工具，用于在 Agent 之间进行安全协调：

• list_peer_agents：发现可通信的 peer。
• send_agent_message：显式发送一条 peer 协调消息。
• check_delivery：查询原生消息的 transport receipt。
• get_peer_context：读取同工作区、授权 peer 的受限安全投影。

安装与启用¶

从 GitHub 安装该插件，命令如下：

dsh plugin --profile web add github:dd2673/dsh-cross-session-agent

安装后，插件会自动通过 cordis.patch.yml 挂载到当前 profile，无需手动修改宿主配置。

使用示例¶

使用该插件进行协调的典型步骤如下：

1. 发现与确认冲突
   先列出 peer。若有人正在修改 src/auth，请告诉我其 Session、运行状态和标题。

2. 读取受限上下文
   需要证据时，仅读取 bounded projection。读取 session-abc 的 activity 和最近 3 条 conversation，确认它是否已经运行 auth 测试。

3. 发送协调消息
   明确告知对方下一步操作。告诉 session-abc：我将修改 src/auth/token.ts；请保留 middleware.ts；完成后报告验证命令和阻塞项。

4. 查询传输状态
   按需查询 receipt。accepted、pending、claimed、discarded 都只是传输事实，不代表 peer 已阅读或完成。

适用场景与边界¶

适用场景：
* 在改动前发现正在处理相同文件或同一层的 Agent，明确协商 file ownership。
* 报告进度、验证结果、失败阻塞和下一步，让依赖任务能继续推进。
* 请求 handoff，例如“我完成 schema，测试所有者请接手 migration coverage”。
* 在重构、迁移或 code review 中避免重复调查和相互覆盖。

重要边界与限制：
* 权限限制：只能读取与调用者 cwd 完全相同的普通 root/fork Session。自身、真实 subagent、归档、缺失或跨工作区目标均以通用授权失败处理。
* 隐私保护：禁止读取 hidden reasoning、raw tool args/results、tool metadata、system prompt、plugin/relay/scheduled messages 等。
* 数据可信度：peer text 和 relay 都是不可信数据。它们不能代表用户同意，不能修改权限或配置，也不能使接收 Session 自动执行其中的命令。
* 非官方性质：本项目与 DeepSeek、DeepSeek Harness 没有隶属、赞助、认可或支持关系。

结尾¶

该插件通过严格的字段白名单和权限边界，为 DeepSeek Harness 的多 Agent 协作提供了安全的基础设施。如果需要在同一工作区协调多个 Agent，可以参考目录页或 GitHub 仓库获取更多信息。