dsh-plugin-agent-collaboration

A community-maintained DeepSeek Harness plugin, not an official DeepSeek product.

A Bot here is not a temporary subagent: it has an identity, its own model and permission preset, its own workspace, and its own session that survives a restart. Put several of them in a room and they answer together. Every run is recorded, so a conversation can be read back later even after the session that produced it is gone.

Features

• Bots that persist. Each Bot keeps a name, a model, a permission preset and a workspace on disk. It is listed in the panel and answers in any room it belongs to, before and after a restart.
• One-to-one and group conversations. A room is a list of members. A message addressed to one Bot routes to that Bot; a message addressed to nobody in particular is answered by every member, because a greeting is addressed to the room.
• Runs are queued, leased and recoverable. Each answer is a run with a lease and a heartbeat. A run whose runtime dies is reclaimed instead of blocking the room, and a room keeps working while you do something else.
• A durable transcript. The panel draws from a ledger written as the run happens (messages, tool calls and their results, approvals, errors), not from the session log. Compacted-away history is replaced by a summary rather than silently dropped.
• 15 model-facing tools, so a Bot can create rooms, hand work to another Bot, decompose a request into tasks and report on them: agent_community_create_bot, agent_community_update_bot, agent_community_list_bots, agent_community_create_room, agent_community_send_message, agent_community_list_runs, agent_community_get_context, agent_community_post_message, agent_community_task_decompose, agent_community_task_assign, agent_community_task_status, agent_community_task_report, agent_community_submit_final, agent_community_remember, agent_community_deliver.
• Models come from DSH Settings. The Bot form and the composer's model menu read the deployment's live catalog — every provider, every model, its display name and its reasoning levels. Nothing about a vendor or a model is hard-coded; a provider added or renamed in Settings appears without restarting.
• File cards for what a Bot delivered. A Bot declares the files it produced with agent_community_deliver; the turn then shows file cards below its reply — preview in the panel, open with the OS application association, or reveal in Finder. Files may live inside the Bot's workspace or at any absolute path.
• A preview dock with real viewers. Clicking a card opens the split preview dock: PDF through a bundled PDF.js (page navigation, zoom, fit width), .docx through docx-preview (paginated pages, selectable text, fit width), .xlsx/.csv through SheetJS (sheet tabs, frozen header, virtual scrolling). PowerPoint and legacy .doc/.xls go through the host's Office→PDF conversion into the same PDF viewer. All viewers are bundled into the plugin's single browser artifact (3.3 MB, ~0.9 MB gzipped) — the panel never fetches a viewer from the network. See THIRD_PARTY_NOTICES.md for their licenses.
• Attachments. Files and images can be added to a message. They are stored inside the receiving Bot's own workspace and appended to what the model sees; the bubble still shows exactly what you typed.
• Compaction that you can trigger. /compact summarises the older part of a room with the room's own Bot model, keeps the newest messages verbatim, and retires the session that was carrying the old history — so the next answer continues from the summary instead of replaying the transcript.
• Unread state that follows what you actually see. A read water mark records when you read, not just which message, so a room that has been compacted can still tell you what is new. The room on screen counts as read — its badge clears as soon as it is displayed, and a reply that lands while you are looking at it clears immediately. Only messages that arrive while the DSH window is hidden stay unread, so the count is right when you come back. The badge counts unread replies — each bot run is one (so several scheduled runs are several unread, not one) — and a bot's extra post in the same turn does not double-count.

Requirements

@deepseek-ai/* packages are not published to the public npm registry, so this repo cannot install them and pnpm install alone fails — expected. The plugin deliberately does not pin a DSH version: every peer range is * and a missing host package degrades at load instead of failing the install. That is also why the plugin is meant to be installed into a DSH profile, where the running harness supplies those packages.

Installation

dsh plugin --profile <your-profile> add dsh-plugin-agent-collaboration

The published package carries all three packages prebuilt, so nothing is compiled on your machine. Restart DSH and refresh the page — Bots团队 appears in the sidebar.

Installing the release tarball instead

The archive attached to each release is the same build that is published to npm — use it when you would rather not install through a registry. The line below points at the latest public release; see CHANGELOG.md for what a newer version changes.

dsh plugin --profile <your-profile> add \
  https://github.com/Leo-sail/dsh-plugin-agent-collaboration/releases/download/v0.3.5/dsh-plugin-agent-collaboration-0.3.5.tgz

Installing from a checkout instead

dsh plugin --profile <your-profile> add "file:/path/to/this/repo/packages/bundle/agent-collaboration"

Keep the file: prefix. pnpm records a bare absolute path as a link: symlink and then installs none of the bundle's own file: dependencies; the profile ends up with the bundle and no @dsh-plugin-agent-community/* rows, and every row fails to import. The same applies to DSH's own plugin manager, which passes an absolute path through unchanged.

Verify the install — all three must be real directories, not symlinks:

ls -ld ~/.dsh/profiles/<your-profile>/node_modules/@dsh-plugin-agent-community/*

Ask an agent to do it

Install the DSH plugin at
https://github.com/Leo-sail/dsh-plugin-agent-collaboration/releases/download/v0.3.5/dsh-plugin-agent-collaboration-0.3.5.tgz
into my DSH profile, restart DSH, and confirm the "Bots团队" entry appears in the sidebar.

Usage

Status is visible while it happens: a queued run shows as 排队, a running one as 进行中 with a live duration, and a failed one as a red row that names the provider error rather than silently publishing an older answer.

Configuration

Every key is optional and is set on the bundle's row in the profile's cordis.patch.yml.

maxConcurrentRuns is global, not per room. At 2, a four-bot group runs two and parks the rest behind the 排队 banner, which is the opposite of what a group is for; raise it if a room should hold more simultaneous Bots.

Where your data lives

$DSH_HOME/agent-community/state.json        the board: Bots, rooms, messages, runs, read marks
$DSH_HOME/agent-community/workspaces/<bot>  each Bot's workspace, including its attachments

$DSH_HOME defaults to ~/.dsh. Deleting that directory resets the plugin to a fresh install; nothing is kept anywhere else.

Coexistence with DSH's built-in Agent Teams

This repo ships the Community half only. DSH's built-in Agent Teams bundle owns teammates, the shared task board and peer messaging, so this bundle mounts only what has no in-box equivalent. The two can run side by side without either disabling the other.

An older @dsh-plugin-agent-community/agent-team fork (with its tool- and ui- packages) used to live in this repo unmounted and unbuildable; it has been removed.

Screenshots

A group room where three Bots answered one message, each attributed to its own Bot:

The roster and the room list, with the sidebar entry carrying an unread count:

The composer's menu — 文件 / 压缩 / 权限 / 模型, then the skills group:

These are declared in screenshots.json — beside the bundle's package.json, because this plugin is listed as a monorepo subpackage and that is where storefronts read it from. See screenshots/README.md for how they were taken.

Development

pnpm install      # fails by design: @deepseek-ai/* are not on the public registry
pnpm typecheck    # typecheck every package against the real DSH types, when they resolve
pnpm bundle       # build all packages and run the build-shape checks

Browser bundle dependencies. The panel's three viewers (PDF.js / docx-preview / SheetJS) are bundled into ui-agent-community/lib/client.js at build time: the DSH client module system serves exactly one script per plugin and re-reads no sibling assets, so the PDF worker and the viewers can not ship as separate files. They are workspace devDependencies (root package.json), installed once for the build; the artifact is 3.3 MB (~0.9 MB gzipped). Licenses: THIRD_PARTY_NOTICES.md.

pnpm bundle runs scripts/check-build.mjs — every assertion in it maps to a bug this repo actually shipped (a bare-ESM client bundle, a package whose files omitted its own types, a stale lib/, dangling exports targets, duplicate CSS selectors). Installing a broken tree is worse than refusing to install, so scripts/install-profile.sh runs the same checks before copying anything.

To develop against a real runtime, install the bundle into a profile with scripts/install-profile.sh <profile> and restart DSH.

Architecture

packages/
  core/agent-community         the service: Bots, rooms, runs, sessions, the ledger
                               AgentCommunityService (ctx.agentCommunity), persists state.json
  tools/tool-agent-community   the 15 model-facing tools (ctx.tools.register)
  ui/ui-agent-community        the browser panel: sidebar entry, transcript, composer,
                               right-hand preview dock and the PDF/DOCX/spreadsheet viewers
  bundle/agent-collaboration   the installable entry (cordis.patch.yml)

The bundle mounts all three; each package is also installable on its own — core/agent-community ships its own cordis.patch.yml and dsh.bundle, which is the right shape for a headless deployment.

See DESIGN.md for the UI decisions (DSH token system, DSH client primitives, StateDot for presence).

License

MIT

Third-party libraries bundled into the browser artifact (PDF.js, docx-preview, JSZip, SheetJS) are distributed under their own licenses — see THIRD_PARTY_NOTICES.md.