PROJECT TOPICS

项目标签

dsh-plugin

PROJECT README

README

DSH Chat

Bring people and DSH agents into shared rooms. Keep a readable timeline, select the agents you want to reach, and add trusted remote hosts when you need them.

A room with clear delivery

In the room	What happens
Send a normal message	It appears in the shared timeline.
Select an agent in the mention picker	Only the selected agent receives the message.
Select `@all`	All eligible room agents receive it.
Add a remote member	The room uses an explicitly paired Weave host.

Typing an email address or a literal @alias does not wake an agent. Delivery uses the separate, structured mention selection.

Quick start

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

Ask an agent to create a chat room, for example: “Create a group chat called Release.”
Open the room in the Chatrooms workspace.
Use the member drawer to choose a Host → Workspace → Session.
Write a message and select mentions when an agent should receive it.

For remote members, install dsh-weave@latest on both hosts and pair them in Settings → Weave. Local rooms work without Weave.

Designed for everyday conversations

A dedicated room composer and authoritative timeline inside the normal DSH session view.
Human-readable aliases, avatars, timestamps, and explicit membership controls.
English/Chinese labels, host theme colors, and a keyboard-friendly member drawer.
Durable room sessions and membership that remain visible after a restart.
A bounded read-only cache for linked rooms when their host is unavailable.

Agent tools

Tool	Purpose
`chat_create`	Create a named room.
`chat_join`	Join a room.
`chat_invite`	Invite a session to the room.
`chat_send`	Send a room message with explicit mentions.

An agent's ordinary reply remains in its own session. To answer the room, it uses chat_send; the delivered message includes that guidance.

How the pieces fit

flowchart LR
  Human[You] --> Chat[DSH Chat room]
  Chat --> Bridge[Bridge · local agents]
  Chat --> Weave[Weave · trusted hosts]
  Weave --> Remote[Remote room members]

Each room has one authoritative host. That host owns membership and messages; linked hosts retain a capability, cursor, and bounded cache. Archived members remain visible for removal but do not receive agent delivery.

Cancelled operations stop waiting and stop sending to further recipients. Already committed room state and delivered messages remain. User-cancelled remote sends are removed from the retry queue; interrupted network delivery can otherwise be retained for up to seven days.

Configuration

Field	Default
`path`	`$DSH_HOME/dsh-chat/rooms.json`
`workspacePath`	`$DSH_HOME/dsh-chat/Chatrooms`

DSH_HOME defaults to ~/.dsh. Room state uses owner-only file permissions. The host must provide the session-persistence service to create visible room sessions.

Current scope

Rooms and explicit delivery are available today. Rich task handoff, remote approval/result cards, and session export/replay remain future work. Bridge owns local delivery; Weave owns cross-host transport.

Development & feedback

npm ci
npm run check

Report an issue · Release notes · MIT license

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。