# agentsCommunication Community

**让 DSH、Codex 和 Claude 的本机会话直接协作，省去人在不同客户端之间复制粘贴。**

非官方社区项目，与 DeepSeek、OpenAI、Anthropic 无隶属或背书关系。MIT 开源，当前为 `community-v0.1.0` 预览版。

## 看一个例子

DSH 正在整理报告，希望 Claude Code 检查一段代码。它可以找到目标会话、发送独立可理解的任务、等待回执，再读取一次性返回的结果。Codex 同样可以与其他 harness 协作。

![在真实应用界面中预览一条跨 harness 消息；数据为虚构示例](docs/images/send-example.png)

消息中心把“已排队”和“已处理”分开，让发送方知道任务进行到了哪里：

![真实应用消息中心的模拟往返记录；不是在线模型实测](docs/images/roundtrip-example.png)

**图中内容、会话地址和处理结果均为模拟数据。** 截图使用真实界面与隔离数据目录，不连接实际模型，不代表一次生产会话端到端测试。

## 能做什么

- `list_agents`：按标题、客户端和目录找到本机会话。
- `followup_task`：发送任务，支持的目标可开始新一轮，完成后回传一次结果。
- `send_message`：仅投递信息，不主动开始新一轮。
- `wait_agent` / `read_agent`：等待状态变化、读取已有记录。
- `spawn_agent`：通过已安装 CLI 新建 Codex 或 Claude Code 会话；不支持新建 DSH 或 Claude Desktop 普通聊天。
- 持久消息与回执、显式附带上下文或文件、重试去重、一次性回复防循环。
- MCP 工具、命令行、本地管理界面，以及随包使用 SOP。

同一个 harness 内，如果已有能到达目标的原生协作工具，应优先用原生工具。例如 Codex 独立聊天间存在 `send_message_to_thread` 时直接使用它。本工具主要用于跨 harness。

## 快速开始

需要 **Node.js 24+**，以及你希望连接的客户端/CLI。Windows 是当前测试环境，其他系统尚未做完整验收。DSH 会话压缩日志读取依赖 Node 的 zstd 支持。

从 [Releases](https://github.com/Myoontyee/agentsCommunication-community/releases) 下载包，或克隆此仓库：

```sh
git clone https://github.com/Myoontyee/agentsCommunication-community.git
cd agentsCommunication-community
node bin/agentscomm.js ui
```

Windows 也可以双击 `start.cmd`。程序没有需要安装的第三方运行依赖。

在需要连接的客户端页签中，选择安装“标准 MCP”和“标准 SOP”。Claude Code 接收即时消息还需要对应的 receiver mod。配置写入前会备份；配置何时生效取决于客户端的 MCP 重载能力。

随后可以请求 Agent：

> 找到 Claude Code 中的“接口检查”会话，请它核对示例项目的参数校验，把结果回给当前 DSH 会话。

先核对目标地址，再发送具体任务。CLI 的占位符必须替换为实际发现的会话 ID：

```sh
node bin/agentscomm.js peers --harness claude-code
node bin/agentscomm.js send --from dsh:<source-session-id> --to claude-code:<target-session-id> "请检查示例项目的参数校验，返回结论及文件位置。"
node bin/agentscomm.js status <message-id>
```

## DSH 集成

DSH 通过 MCP 使用发送工具；接收侧使用其 `dsh-communication` 端点，读取当前用户自己的 connection 与 credential 文件。不会附带开发者的凭据。

```sh
node bin/agentscomm.js dsh status
node bin/agentscomm.js dsh targets
```

目标必须已存在，并获得 DSH 允许。需要添加目标时，用户明确确认后执行 `agentscomm dsh allow <session-id>`。安装本工具不自动扩大目标白名单。

## 不同客户端的接收边界

| 目标 | 接收方式 | 主要限制 |
| --- | --- | --- |
| DSH | 已授权的 communication 端点，起一轮或仅入队 | 依赖宿主插件和目标白名单；不同版本须实测 |
| Codex 桌面已打开线程 | 本地桌面管道 | 使用未公开协议，桌面升级可能不兼容；忙时排队 |
| Codex 未打开线程 | CLI resume | 需本机 CLI、登录与可用权限 |
| Claude Code / Desktop Code | receiver mod 或 CLI resume | 与普通 Claude Desktop 聊天不同；受客户端版本和权限约束 |
| Claude Desktop 普通聊天 | MCP 收件箱 | **不能后台唤醒**；实验性前台输入默认关闭 |

`queued`、`routed`、`delivered` 不等于处理完成，只有相应的终态与回复才能说明结果。支持进度通知的 MCP 宿主可以显示实时进展，其他宿主只收到最终状态，见 [进度契约](sop/progress-protocol.md)。

## 数据与权限

消息、附件、回执、导入记录、配置和备份保存在当前用户的 `.agentsCommunication` 目录。管理界面只监听本机回环地址。软件是本地协作桥，不是远程设备组网服务；接收方模型的云端数据政策仍然适用。

安装器会按用户选择写入客户端 MCP/技能配置。消息内容、附带文件和对话历史可能敏感，只发给已授权目标。发送方标识是工具报告的身份，不是额外的身份认证；另一 Agent 的消息也不是用户授予新权限的凭证。CLI 执行可能消耗对应模型额度。

新公开版与其他版本使用相同的运行数据目录和 MCP 名称。不要同时启动两个版本；试用可用 `AGENTSCOMM_HOME` 指定独立数据目录。不要把运行数据目录、客户端配置、凭据、真实截图或日志提交到仓库。

## 开发与验证

```sh
npm test
npm pack --dry-run
```

首次公开快照通过 59 项测试（Windows / Node 24.14），使用隔离目录、假 CLI 和本地协议端点。它们验证调用链与错误处理，不等同于所有真实客户端/模型组合均已通过。发布截图的复现脚本见 [示例说明](docs/demo.md)。

完整调用和恢复说明见 [agentscommunication SOP](sop/SKILL.md)。本地界面布局参考 [cc-switch](https://github.com/farion1231/cc-switch) 的客户端切换方式；相关商标归各自所有者。