baixianger/dsh-chat

DSH Chat

English · 简体中文

npm License: MIT DSH plugin

让人与 DSH Agent 在同一个房间协作。共享清晰的消息时间线，明确选择需要联系的 Agent，也可以加入受信任的远程主机成员。

每条消息都有明确去向

| 在房间中操作 | 实际行为 |
| --- | --- |
| 发送普通消息 | 只显示在共享时间线中。 |
| 在提及选择器中选择 Agent | 只向选中的 Agent 投递。 |
| 选择 @all | 向房间内所有符合条件的 Agent 广播。 |
| 添加远程成员 | 使用已明确配对的 Weave 主机。 |

直接输入邮箱或字面上的 @别名 不会唤醒 Agent；投递以单独的结构化提及选择为准。

快速开始

dsh plugin --profile web add dsh-bridge@latest dsh-chat@latest
dsh web

1. 请 Agent 创建房间，例如：“创建一个叫‘发布协作’的群聊。”
2. 在 Chatrooms 工作区打开房间。
3. 从成员抽屉按 主机 → 工作区 → 会话 选择成员。
4. 输入消息，需要 Agent 接收时再明确选择提及对象。

使用远程成员时，在两台主机安装 dsh-weave@latest，并在 设置 → Weave 完成配对。本地房间无需 Weave。

为日常协作设计

- 在正常 DSH 会话视图内提供专用聊天输入框和权威时间线。
- 成员别名、头像、时间戳，以及明确的成员管理入口。
- 中英文、宿主主题颜色和支持键盘操作的成员抽屉。
- 持久保存房间会话与成员关系，重启后仍可见。
- 远程房间主机暂时不可达时，保留有界的只读历史缓存。

Agent 工具

| 工具 | 用途 |
| --- | --- |
| chat_create | 创建命名房间。 |
| chat_join | 加入房间。 |
| chat_invite | 邀请会话加入房间。 |
| chat_send | 发送房间消息，并明确选择提及对象。 |

Agent 的普通回复留在自己的会话中。回复房间需要调用 chat_send，收到的消息会附带这条说明。

各部分如何协作

flowchart LR
Human[你] --> Chat[DSH Chat 房间]
Chat --> Bridge[Bridge · 本地 Agent]
Chat --> Weave[Weave · 受信任主机]
Weave --> Remote[远程房间成员]

每个房间只有一个权威主机，负责成员和消息；其他主机保存房间权限、游标和有界缓存。已归档的成员仍可供移除，但不再接收 Agent 投递。

取消操作会结束等待并停止向后续成员发送；已提交状态和已送达消息保留。用户主动取消的远程发送会移出重试队列；其他因网络中断而待投递的定向消息最多保留七天。

配置

| 字段 | 默认值 |
| --- | --- |
| path | $DSH_HOME/dsh-chat/rooms.json |
| workspacePath | $DSH_HOME/dsh-chat/Chatrooms |

DSH_HOME 默认是 ~/.dsh。房间状态使用仅所有者可访问的文件权限；创建可见房间会话需要宿主的 session-persistence 服务。

当前范围

已支持房间和明确投递。丰富的任务交接、远程审批/结果卡片、会话导出与回放仍属后续工作。Bridge 负责本地投递，Weave 负责跨主机传输。

开发与反馈

npm ci
npm run check

提交问题 · 版本记录 · MIT 许可证