Skip to content
Back to search

dsh-agent-team-gui

Persistent multi-model workflow teams for DeepSeek Harness — dynamic lead planning, bounded DAGs, per-agent model/tools, Run Center and Token insights.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/toolclub--dsh-agent-team-gui/badge.svg)](/listings/toolclub--dsh-agent-team-gui)

HTML

<a href="/listings/toolclub--dsh-agent-team-gui"><img src="/api/listings/toolclub--dsh-agent-team-gui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| Plugin release | DSH target | Upgrade guidance | | --- | --- | --- | | **1.3.0** | `>=0.1.5-rc.1 <0.1.6-0` | Recommended; selectable on-demand delegation and consistent mode boundaries | | 1.2.0 | `>=0.1.5-rc.1 <0.1.6-0` | Failure diagnosis and bounded lead-driven continuation | | 1.1.1 | `>=0.1.5-rc.1 <0.1.6-0` | Earlier workflow fixes; retries still replay the assignment | | 1.1.0 | `>=0.1.5-rc.1 <0.1.6-0` | Initial 0.1.5 compatibility; upgrade the plugin to 1.3.0 | | 1.0.1 | Verified with `0.1.1-rc.2` | Previous integration; upgrade both DSH and the plugin together |

The walkthrough has [English subtitles](https://github.com/toolclub/dsh-agent-team-gui/blob/main/docs/promotion/demo-captions.en.srt) and [Chinese subtitles](https://github.com/toolclub/dsh-agent-team-gui/blob/main/docs/promotion/demo-captions.zh-CN.srt). Load the SRT alongside the existing video in a compatible player; GitHub does not attach it automatically.

Upgrading DSH from 0.1.1? Use plugin **v1.3.0** for DSH **0.1.5**. This release fixes `source.subscribe` during plugin loading, migrates reconnect and Session APIs, and keeps the existing team definitions and run store. Restart DSH and refresh the browser after upgrading. The CLI may report `0.1.5-rc.1` while its compatible internal packages resolve to `0.1.5-rc.2`.

Requirements: a working DeepSeek Harness **Web** profile, at least one configured provider/model, Node.js `>=22.19.0 <23` or `>=24.0.0`, and pnpm. Declared DSH compatibility is `>=0.1.5-rc.1 <0.1.6-0`; the v1.3.0 release was verified against DSH `0.1.5-rc.1`.

**Recommended: install the compiled release package.** It includes the built Host and client files, so installation does not run this plugin's Git `prepare` build or require its `allowBuilds` entry.

dsh plugin --profile web add https://github.com/toolclub/dsh-agent-team-gui/releases/download/v1.3.0/dsh-agent-team-gui-1.3.0.tgz
dsh --profile web

Stop and restart an already-running DSH Web process after installing or upgrading. Then open **Settings → Teams**. If a plugin marketplace chooses Git installation and fails, use the direct release command above; see [installation troubleshooting](docs/first-team.md#installation-troubleshooting).

DSH `0.1.7-rc.2` is outside this release's declared host range; its installer rejects v1.3.0's peer ranges and rolls back the installation (reproduced on macOS arm64, Node 26.5.0, pnpm 12.6.0). Do not treat a change of installation source as runtime support. The Node engine range is not a claim that every newer Node/DSH combination has been tested.

For DSH Plugin Hub, use version **1.5.2** or later with a refreshed catalog. Hub 1.4.8 does not have the release-package channel. If the catalog still selects Git, use the direct command above. Hub caches the catalog for one hour and can reuse stale data when a refresh fails.

[Release notes and checksum](https://github.com/toolclub/dsh-agent-team-gui/releases/tag/v1.3.0) · [Git/source installation](#git-source-installation)

> [!TIP] > If `dsh` is not on `PATH`, use the launcher that starts your working Harness installation. > With npm, replace `dsh` with `npx @deepseek-ai/dsh@0.1.5-rc.1`; from a source checkout, replace > it with `pnpm --dir /absolute/path/to/deepseek-harness dsh`. Keep the same launcher for installation > and startup. New to Harness? Start with its [official setup guide](https://github.com/deepseek-ai/deepseek-harness#run).

Verify that both the `dsh-agent-team-gui` bundle and the `agent-team-gui` configuration row are present:

dsh --profile web --dump-config

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 487 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-agent-team-gui
  2. [English](README.md) | [简体中文](README-zh.md)
  3. [![CI](https://github.com/toolclub/dsh-agent-team-gui/actions/workflows/ci.yml/badge.svg)](https://github.com/toolclub/dsh-agent-team-gui/actions/workflows/ci.yml)
  4. [![GitHub release](https://img.shields.io/github/v/release/toolclub/dsh-agent-team-gui?include_prereleases&style=flat-square)](https://github.com/toolclub/dsh-agent-team-gui/releases)
  5. [![GitHub stars](https://img.shields.io/github/stars/toolclub/dsh-agent-team-gui?style=flat-square)](https://github.com/toolclub/dsh-agent-team-gui/stargazers)
  6. [![MIT license](https://img.shields.io/github/license/toolclub/dsh-agent-team-gui?style=flat-square)](LICENSE)
  7. **Give DeepSeek Harness a reusable team: one Agent plans, another implements, and a third reviews.**
  8. Save the team once, choose a model for each member, and reuse it across projects and conversations.
  9. Follow the plan, member outputs, retries, and provider-reported Token usage in one Run Center.
  10. This is an unofficial community plugin for the **DeepSeek Harness Web profile**.
  11. [Watch the 80-second UI guide](https://github.com/toolclub/dsh-agent-team-gui/blob/main/assets/promotion-walkthrough-zh.mp4) · [Install v1.3.0](#install) · [Run your first team](docs/first-team.md) ·
  12. [Example recipe](examples/full-stack-delivery.recipe.json) ·
  13. [Share a workflow](https://github.com/toolclub/dsh-agent-team-gui/discussions/1)
  14. [![UI walkthrough: reusable team setup, run inspection, and recipes](https://raw.githubusercontent.com/toolclub/dsh-agent-team-gui/main/assets/promotion-walkthrough-preview.gif)](https://github.com/toolclub/dsh-agent-team-gui/blob/main/assets/promotion-walkthrough-zh.mp4)
  15. *Screenshot-based UI guide with example data and Chinese synthetic narration. Displayed task results, timings, and Tokens are not a live-run benchmark. [Sources and captions](docs/promotion/demo-guide.md).*
  16. If this is useful for your DSH workflow, [give the project a Star](https://github.com/toolclub/dsh-agent-team-gui)
  17. and help another developer discover it.
  18. ## Why this plugin
  19. A team is a reusable product object, not a one-off dispatch form. Create it once in **Settings →
  20. Teams**, then use it across projects and conversations.
  21. | Capability | User outcome |
  22. | --- | --- |
  23. | One model and tool policy per member | Combine a planner, implementer, reviewer, or specialist without forcing one route on everyone |
  24. | Dynamic workflow planning by default | The active conversation's model assigns focused work and dependencies from the current request |
  25. | Team / Solo / Inherited modes | Choose a durable conversation override, a project default, or a one-message exception without ambiguous switches |
  26. | Bounded DAG, retries, quality gate, background work | Long work is observable, cancellable, finite, and restart-safe |
  27. | Official provider Token usage | See input, cache-read, cache-write, and output Tokens with full/partial/unavailable coverage—never invented prices |
  28. | Versions, recipes, and definition backup | Reproduce a team, share it without credentials, preview impact, and remap model routes before applying |
  29. ## Install
  30. | Plugin release | DSH target | Upgrade guidance |
  31. | --- | --- | --- |
  32. | **1.3.0** | `>=0.1.5-rc.1 <0.1.6-0` | Recommended; selectable on-demand delegation and consistent mode boundaries |
  33. | 1.2.0 | `>=0.1.5-rc.1 <0.1.6-0` | Failure diagnosis and bounded lead-driven continuation |
  34. | 1.1.1 | `>=0.1.5-rc.1 <0.1.6-0` | Earlier workflow fixes; retries still replay the assignment |
  35. | 1.1.0 | `>=0.1.5-rc.1 <0.1.6-0` | Initial 0.1.5 compatibility; upgrade the plugin to 1.3.0 |
  36. | 1.0.1 | Verified with `0.1.1-rc.2` | Previous integration; upgrade both DSH and the plugin together |
  37. The walkthrough has [English subtitles](https://github.com/toolclub/dsh-agent-team-gui/blob/main/docs/promotion/demo-captions.en.srt)
  38. and [Chinese subtitles](https://github.com/toolclub/dsh-agent-team-gui/blob/main/docs/promotion/demo-captions.zh-CN.srt).
  39. Load the SRT alongside the existing video in a compatible player; GitHub does not attach it automatically.
  40. Upgrading DSH from 0.1.1? Use plugin **v1.3.0** for DSH **0.1.5**. This release fixes
  41. `source.subscribe` during plugin loading, migrates reconnect and Session APIs, and keeps the existing
  42. team definitions and run store. Restart DSH and refresh the browser after upgrading. The CLI may
  43. report `0.1.5-rc.1` while its compatible internal packages resolve to `0.1.5-rc.2`.
  44. Requirements: a working DeepSeek Harness **Web** profile, at least one configured provider/model,
  45. Node.js `>=22.19.0 <23` or `>=24.0.0`, and pnpm. Declared DSH compatibility is
  46. `>=0.1.5-rc.1 <0.1.6-0`; the v1.3.0 release was verified against DSH `0.1.5-rc.1`.
  47. **Recommended: install the compiled release package.** It includes the built Host and client files,
  48. so installation does not run this plugin's Git `prepare` build or require its `allowBuilds` entry.
  49. ```sh
  50. dsh plugin --profile web add https://github.com/toolclub/dsh-agent-team-gui/releases/download/v1.3.0/dsh-agent-team-gui-1.3.0.tgz
  51. dsh --profile web
  52. ```
  53. Stop and restart an already-running DSH Web process after installing or upgrading. Then open
  54. **Settings → Teams**. If a plugin marketplace chooses Git installation and fails, use the direct
  55. release command above; see [installation troubleshooting](docs/first-team.md#installation-troubleshooting).
  56. DSH `0.1.7-rc.2` is outside this release's declared host range; its installer rejects v1.3.0's peer ranges and rolls back the installation (reproduced on macOS arm64, Node 26.5.0, pnpm 12.6.0). Do not treat a change of installation source as runtime support. The Node engine range is not a claim that every newer Node/DSH combination has been tested.
  57. For DSH Plugin Hub, use version **1.5.2** or later with a refreshed catalog. Hub 1.4.8 does not have the release-package channel. If the catalog still selects Git, use the direct command above. Hub caches the catalog for one hour and can reuse stale data when a refresh fails.
  58. [Release notes and checksum](https://github.com/toolclub/dsh-agent-team-gui/releases/tag/v1.3.0) ·
  59. [Git/source installation](#git-source-installation)
  60. > [!TIP]
  61. > If `dsh` is not on `PATH`, use the launcher that starts your working Harness installation.
  62. > With npm, replace `dsh` with `npx @deepseek-ai/dsh@0.1.5-rc.1`; from a source checkout, replace
  63. > it with `pnpm --dir /absolute/path/to/deepseek-harness dsh`. Keep the same launcher for installation
  64. > and startup. New to Harness? Start with its [official setup guide](https://github.com/deepseek-ai/deepseek-harness#run).
  65. Verify that both the `dsh-agent-team-gui` bundle and the `agent-team-gui` configuration row are present:
  66. ```sh
  67. dsh --profile web --dump-config
  68. ```
  69. ## Run your first team
  70. Use the included [full-stack delivery recipe](examples/full-stack-delivery.recipe.json), with a
  71. planner, implementation engineer, and reviewer. You can bind all three to the same working model
  72. for the first run; multiple providers are optional.
  73. 1. Download the recipe JSON. Open **Settings → Teams → Recipes & data** and choose **Choose recipe file**.
  74. 2. Map the placeholder routes to your configured provider/model routes, review the preview, and choose
  75. **Create a copy → Import reviewed recipe**. In **Member library**, confirm each member's exact model and tool access.
  76. 3. For this first walkthrough, set **Team usage → Host dispatches first**, **Dispatch policy → Run assigned work**, and member selection to
  77. **All members**, then save. The supplied recipe otherwise uses Smart/adaptive selection.
  78. 4. Select an empty scratch project, choose the imported team beside the composer, select **Select team for this conversation**, and send the
  79. [ready-to-copy task](docs/first-team.md#try-a-small-development-task): build and test a small to-do list.
  80. 5. Open **Team runs** to inspect the plan, outputs, review, and actual Token coverage. Check the delivered
  81. files and test results before treating the task as complete.
  82. [Full walkthrough, expected results, and troubleshooting →](docs/first-team.md)
  83. ## Create your own team
  84. In **Settings → Teams → Member library**, save each member's role, model, optional fallback, and tool policy.
  85. In **Settings → Teams**, add those members and choose activation, member selection, and execution options.
  86. Leave **Fixed order** off for dynamic planning, or enable it for a fixed serial sequence.
  87. Choose **Team**, **Solo**, or **Inherited** beside the composer to control the current conversation.
  88. ![Choose Team, Solo, or Inherited beside the normal composer](assets/v0.5-composer-mode.png)
  89. *UI example with demonstration data.*
  90. ## How orchestration works
  91. ```mermaid
  92. flowchart TD
  93. U[User message] --> M{Effective mode and one-shot choice}
  94. M -->|Solo or Manual| L[Lead handles request directly]
  95. M -->|On demand| J{Lead decides whether delegation helps}
  96. J -->|No| L
  97. J -->|Missing information| A[Ask user]
  98. J -->|Yes: dispatch_to_squad| D[Validate and admit one initial dispatch]
  99. M -->|Host dispatch or Force Team next| D
  100. D --> P[Use explicit plan or invoke bounded planner]
  101. P -->|Smart skip| L
  102. P --> W[Dependency-ready members, failure policy, optional quality gate]
  103. W --> R[Persist results, diagnosis and reported usage]
  104. R --> L
  105. R -->|Lead reviews unfinished work| C[Bounded continue_squad_run]
  106. C -->|Reuse successes, shared budget, one continuation| W
  107. ```
  108. New editor drafts and built-in templates default to **Lead decides when to delegate**.
  109. Selecting a team makes it available; simple answers create no planning child or team run.
  110. Saved/imported choices and legacy missing-field defaults remain unchanged.
  111. [Full flow and edge-case contract](docs/on-demand-flow.md). Host background runs finish in Run Center;
  112. model-initiated tool dispatch waits for its result.
  113. After dispatch, when no explicit assignments/order are supplied and no fixed order exists, the plugin uses the active conversation's provider/model route in a bounded,
  114. tool-free planner child. It receives the member roles and returns structured assignments plus an
  115. acyclic dependency graph. It does not turn one member into a replacement for the whole team. A
  116. bad, cyclic, or unavailable plan falls back to deterministic role-scoped assignments.
  117. Ready DAG nodes run up to `maxConcurrency`. Dependants receive only bounded structured handoffs;
  118. full member output remains in durable run history. A fixed member order is an explicit serial
  119. override and bypasses DAG planning.
  120. ### Activation and selection
  121. - **Run assigned work** requires execution once dispatch has been chosen; it does not force on-demand delegation.
  122. - **Smart** lets the bounded planner skip unsuitable/trivial work.
  123. - **Manual** blocks ordinary automatic/model dispatch; explicitly choose Force Team next or a manual Run Center action.
  124. - **All members** assigns each configured member exactly once.
  125. - **Adaptive** lets Smart planning select the smallest useful non-empty subset.
  126. ### Conversation modes
  127. - **Team** is an explicit durable team selection for this conversation.
  128. - **Solo** is an explicit durable opt-out, even when the project has a default team.
  129. - **Inherited** removes the conversation override and follows the project default when one exists.
  130. - **Next message** is a separate crash-safe one-shot Team or Solo choice, consumed exactly once.
  131. These states remain interactive after page refresh, cold Host startup, and live reconnect. An empty
  132. or temporarily unavailable catalog never silently deletes a saved selection.
  133. ### Safety bounds
  134. - Planner, member, reviewer, and repair prompts put the exclusive role and no-delegation contract
  135. before a bounded excerpt of user content.
  136. - Delegated sessions cannot dispatch another team. Detected DSH subagent tools—including renamed
  137. registrations—are denied inside team children.
  138. - One durable claim binds automatic and model-tool dispatch to the latest human message, so repeated
  139. tool calls cannot create hundreds of duplicate teams.
  140. - Member timeout, concurrency, retry-once, soft team Token budget, and quality rounds are finite.
  141. - A retry creates a linked immutable run and replays the original normalized assignments, order,
  142. and DAG; it does not silently ask the model to invent a different workflow.
  143. ## Run Center and Token usage
  144. ![Inspect the DAG, member state, review rounds, and Token buckets](assets/v0.5-run-center.png)
  145. Every execution is written before planning starts. The Run Center exposes foreground/background
  146. state, live phase, elapsed time, child IDs, complete outputs, bounded handoffs, stop, linked whole
  147. or member retry, export, filters, and retention-safe clear.
  148. If a DSH child settles with `stopReason: "error"` after delivering non-empty plain text, the member
  149. counts as **Completed** instead of losing a valid long-form deliverable. The stop reason remains
  150. recorded and Run Center shows a protocol-delivery warning. Empty output, rejected runs, cleanup
  151. failures, timeouts, and other non-completed reasons such as `max-tokens` remain failures.
  152. Each member handoff summary keeps up to 16,000 characters by default. A team may set
  153. `handoffSummaryMaxChars` from 1,000 to 32,000. Complete raw output remains durable in Run Center;
  154. dependency and lead prompts retain separate aggregate bounds so one long artifact cannot make model
  155. context unbounded.
  156. The plugin reuses DSH's official `tokenUsage` projection and keeps four buckets:
  157. - uncached input;
  158. - cache read;
  159. - cache write;
  160. - output.
  161. Planner, member, review, and repair usage remain separately attributable. Coverage is explicitly
  162. **full**, **partial**, or **unavailable** at run and retry-attempt level. Before a provider reports a
  163. sample, the UI says **Metering…** instead of showing a false zero. Tokens are not money; the plugin
  164. does not guess prices that Harness providers do not publish through a stable pricing contract.
  165. ![Compare durable usage and completion insights without fabricated prices](assets/v0.5-insights.png)
  166. ## Quality gate and background runs
  167. An optional quality gate names one reviewer, one repair owner, explicit criteria, and `0..2` repair
  168. rounds. A rejection can rerun only that repair owner, followed by the named reviewer. It cannot
  169. create arbitrary agents or recurse.
  170. Foreground runs finish before the lead Agent synthesizes bounded handoffs. Background runs return a
  171. short acknowledgement and stay visible in the plugin Run Center; when the official DSH Jobs service
  172. is present, the same run is also registered there with a shared cancel hook. Without that optional
  173. service, the plugin falls back to process-local background execution; a Host restart then reconciles
  174. unfinished durable state as **Interrupted** rather than pretending it completed.
  175. ## Versions, recipes, and definition backup
  176. ![Preview a recipe, conflicts, affected teams, and primary/fallback route remapping](assets/v0.5-recipes.png)
  177. - Each saved team version includes immutable snapshots of all referenced member definitions.
  178. - Restore is preview-first and warns when a shared member would change another team.
  179. - Recipes contain one team and its members, never provider credentials. Import supports **Copy** or
  180. **Merge**, conflict preview, and separate primary/fallback route remapping.
  181. - Definition backup exports agents and teams. Import is preview-first with **Merge** or **Replace**;
  182. replace reports deletions, dangling mode/default cleanup, and affected teams before confirmation.
  183. - Multi-table writes are serialized and use compensating rollback on validation, cancellation, or
  184. storage failure. Readers see either the previous or committed definition graph, not a half-import.
  185. - Remote recipe URLs are disabled in v0.5. Import a reviewed local JSON file; this intentionally
  186. avoids exposing an unprotected server-side fetch/SSRF surface.
  187. Start with the credential-free
  188. [full-stack delivery recipe](examples/full-stack-delivery.recipe.json), preview it, and remap its
  189. `your-provider / your-model` placeholders to routes configured in your own DSH profile.
  190. Definition exports include member system prompts and model route names. Run exports additionally
  191. include the user task and member outputs. Review those files before sharing them.
  192. ## Settings reference
  193. ### Member
  194. | Field | Meaning |
  195. | --- | --- |
  196. | Name and role prompt | Durable identity and exclusive instructions for this member |
  197. | Primary provider/model | Existing DSH route; credentials stay in DSH |
  198. | Fallback provider/model | Optional paired route for retry-once |
  199. | `maxTokens` | Hard per-attempt output ceiling sent to the provider |
  200. | Tool allow/deny | Least-privilege visibility for registered DSH tools; recursive team/subagent tools remain denied |
  201. ### Team
  202. | Field | Meaning |
  203. | --- | --- |
  204. | Members and collaboration note | Reusable member definitions plus team-level coordination guidance |
  205. | Fixed order | Complete serial permutation; leave off for dynamic assignments and DAG dependencies |
  206. | Execution/context | Serial or bounded parallel; `spawn`, `fork`, or serial-only `chain` |
  207. | Activation/selection | Always, Smart, or Manual; all members or adaptive subset |
  208. | Response | Foreground synthesis or observable background run |
  209. | Planner | Current/recent/full context and a bounded planner Token ceiling |
  210. | Resilience | Continue, stop, or retry-once; member timeout and fallback route |
  211. | Limits | Maximum concurrency and a soft provider-reported team Token budget |
  212. | Handoff summary | Per-member summary ceiling in characters; blank uses 16,000, configurable from 1,000–32,000 |
  213. | Quality | Named reviewer, repair owner, criteria, and at most two repair rounds |
  214. ![The primary path remains usable on a narrow viewport](assets/v0.5-narrow.png)
  215. ## Host configuration
  216. The Web bundle inserts one unique Host row; it relies on the Web profile's existing storage,
  217. Connection RPC, models, sessions, and browser module services.
  218. ```yaml
  219. - id: agent-team-gui
  220. name: dsh-agent-team-gui
  221. config:
  222. defaultProvider: spawn
  223. defaultExecutionMode: serial
  224. defaultContextMode: spawn
  225. historyMaxRuns: 0
  226. historyMaxAgeDays: 0
  227. versionMaxPerSquad: 0
  228. ```
  229. | Field | Default | Meaning |
  230. | --- | --- | --- |
  231. | `defaultProvider` | `spawn` | Registered DSH subagent provider |
  232. | `defaultExecutionMode` | `serial` | Effective mode when a team omits it |
  233. | `defaultContextMode` | `spawn` | Effective context when a team omits it |
  234. | `historyMaxRuns` | `0` | Count retention; `0` disables automatic run deletion |
  235. | `historyMaxAgeDays` | `0` | Age retention in days; `0` disables automatic run deletion |
  236. | `versionMaxPerSquad` | `0` | Version retention per team; `0` disables automatic version deletion |
  237. If you override the row in a profile patch, restate every needed field: DSH patch rows replace the
  238. complete `config` object rather than deep-merging it. `chain` is valid only for serial execution.
  239. Retention is deliberately opt-in: upgrading to v0.5 does not silently delete existing run history
  240. or team versions. Set a positive limit only when automatic cleanup is the behavior you want.
  241. ## Other installation paths
  242. ### Git source installation
  243. Use this alternative when you intend to build from source:
  244. ```sh
  245. dsh plugin --profile web add -w github:toolclub/dsh-agent-team-gui#v1.3.0
  246. ```
  247. Git dependencies run this repository's `prepare` build. On pnpm 10+, authorize only the exact
  248. package key pnpm prints under `allowBuilds` in the profile's `pnpm-workspace.yaml`, then repeat the
  249. same pinned command. The key can include the resolved revision; copy the actual key from the error.
  250. This grants that dependency permission to execute build scripts. The compiled release path above
  251. avoids this step.
  252. ### Exact commit
  253. Resolve and review a full commit SHA, then use the same `allowBuilds` rule as the tagged Git install:
  254. ```sh
  255. dsh plugin --profile web add -w github:toolclub/dsh-agent-team-gui#<full-commit-sha>
  256. ```
  257. This is the most reproducible source install. The release CI performs the same fresh-profile check
  258. against the exact pushed revision.
  259. ### Local checkout
  260. From this repository:
  261. ```sh
  262. pnpm install --frozen-lockfile
  263. pnpm run preflight
  264. dsh plugin --profile web add -w .
  265. ```
  266. `preflight` type-checks Host, Client, and tests; runs Host/rendered Client suites; builds from a clean
  267. output directory; audits the tarball and secrets; and boots an isolated temporary DSH Web profile.
  268. ### Compiled tarball
  269. ```sh
  270. mkdir -p dist
  271. pnpm pack --pack-destination dist
  272. dsh plugin --profile web add -w ./dist/dsh-agent-team-gui-1.3.0.tgz
  273. ```
  274. The package audit verifies runtime/declaration closure, examples, governance files, screenshots,
  275. source maps, external dependency declarations, no absolute paths, no symlinks, and no known
  276. credential patterns.
  277. ### Ask a terminal-capable Agent
  278. You can send this single instruction inside DeepSeek Harness:
  279. > Follow the installation and security notes in
  280. > https://github.com/toolclub/dsh-agent-team-gui. Install the compiled v1.3.0 Release tarball into
  281. > the Web profile, restart Web, verify the composed configuration, and report the installed version
  282. > and installation source.
  283. ## Model tool and public service
  284. `dispatch_to_squad` remains available for explicit/manual model-driven use. It accepts a team ID or
  285. unique case-insensitive name, a task, optional assignments/order, and execution/context overrides
  286. where the saved team permits them. Its model-facing result is bounded; the complete canonical run is
  287. durable and available through the Run Center/export.
  288. The package also exports `AgentTeamService`, record/result types, Zod schemas, and the in-process
  289. definition/dispatch/version/recipe/run APIs. Treat those APIs as developer-preview surfaces while
  290. DSH itself is pre-stable.
  291. ## Security and privacy
  292. - Plugin RPC uses `/api/agentTeamGui` behind DSH's browser-session cookie authentication and
  293. Host/Origin checks. Requests and results are validated; there is no separate unauthenticated channel.
  294. - Provider credentials are never copied into plugin records, recipes, examples, logs, or exports.
  295. - Durable local storage does contain team role prompts, selected route names, conversation/project
  296. identifiers, user tasks, run outputs, errors, and Token usage. Protect the DSH home directory.
  297. - Use least-privilege member tools. A model may perform any action that its allowed DSH tools permit.
  298. - URL recipe fetching is disabled. Installation scripts are the only extra machine-code authority;
  299. review and pin Git dependencies or use a compiled tarball.
  300. - Report vulnerabilities privately using [SECURITY.md](SECURITY.md), not a public issue containing
  301. credentials or private prompts.
  302. ## Compatibility and limitations
  303. Dependency and repair chains have a separate 12,000-character serialized JSON budget; quality
  304. review chains have 32,000 characters. These are independent of the per-member stored summary limit.
  305. Chains reserve member identities, share space across deliveries, and report `chainTruncated` and
  306. `omittedHandoffs`. Full outputs remain in Run Center. Review rounds use the reviewer's configured
  307. `maxTokens`, with 2,048 only as the default when unset.
  308. `retry-once` now diagnoses failures before retrying. Explicit billing exhaustion, cancellation,
  309. or an exhausted configured budget stops recovery. A tool-free system coordinator on the lead's
  310. model route assesses failure evidence and prior progress. Only a supported transient failure is
  311. retried in place; structural changes are proposed to the lead, not silently executed.
  312. The lead can call `continue_squad_run` after a failed/partial run settles, referencing its run id
  313. and chain revision. The first release allows **one continuation per execution chain**. It reuses
  314. independent successful tasks and reruns affected descendants, retains both plans/results, and
  315. shares the original configured soft Token budget. Duplicate submissions return the accepted
  316. result; changed wording does not reset admission. Same-message initial dispatch remains limited
  317. to one. Run Center manual retry remains a separate explicit replay initiated by the user.
  318. Continuation keeps one task node per existing member. Split remaining work into ordered steps;
  319. adding multiple independent nodes for the same member or a new team is not supported yet.
  320. See [execution chains and recovery](docs/execution-chains.md) for the contract and limits.
  321. For DSH 0.1.5, global deny entries are filtered against the global registry while scoped allows
  322. remain intact. An execution guard also blocks recognized delegation tools and explicit member
  323. denies on marked in-process children. DSH has no universal delegation capability tag: custom tools
  324. with unrelated schemas and arbitrary external programs are not an OS-level sandbox boundary.
  325. - Web profile only; there is no headless Settings UI. The exported Host service can still be used by
  326. another in-process plugin that supplies the required services.
  327. - Declared compatibility is DSH `>=0.1.5-rc.1 <0.1.6-0`; CI currently verifies DSH `0.1.5-rc.1`. DSH and this
  328. plugin are both pre-stable, so pin versions.
  329. - Old v0.4 durable definitions and v1 exports remain readable/importable. Editing them must satisfy
  330. the safer v0.5 new-write limits. A legacy run without a stored plan cannot be faithfully retried
  331. and is rejected with an explanation.
  332. - Provider Token projections are optional. Partial/unavailable coverage is expected and explicit.
  333. - A soft team Token budget prevents later scheduling; it cannot stop an already-running provider at
  334. the exact threshold. Per-member `maxTokens` is the hard provider bound.
  335. - DSH currently offers no supported registration seam for custom durable `squad/*` Session event
  336. types. The plugin uses its durable run store, standard child sessions/tool events, Jobs, and logs.
  337. - Model-tool trigger mode is best-effort because DSH exposes no `toolChoice` control. Guaranteed
  338. normal-send mode is Host-driven and durable-message-idempotent.
  339. ## Verification and project health
  340. ```sh
  341. pnpm run typecheck
  342. pnpm run test
  343. pnpm run build
  344. pnpm run audit:pack
  345. pnpm run smoke:install
  346. pnpm run smoke:browser
  347. ```
  348. CI runs Node 22.19 and Node 24, a fresh DSH `0.1.5-rc.1` Web profile, browser keyboard/accessibility/reconnect
  349. journeys, exact Git revision installation, and the community plugin doctor. The detailed product
  350. contract and evidence matrix live in [docs/v0.5-product-spec.md](docs/v0.5-product-spec.md) and
  351. [docs/v0.5-acceptance.md](docs/v0.5-acceptance.md).
  352. ## Contributing
  353. Read [CONTRIBUTING.md](CONTRIBUTING.md), the [Code of Conduct](CODE_OF_CONDUCT.md), and
  354. [SECURITY.md](SECURITY.md). The concise Chinese tutorial
  355. [从零开发一个 DeepSeek Harness 插件](docs/developing-a-deepseek-harness-plugin.zh-CN.md) explains
  356. `apply`, Service plugins, profile/bundle wiring, local verification, and GitHub installation using
  357. official Harness references.
  358. Issues should include the exact DSH/plugin versions and a sanitized minimal reproduction. Pull
  359. requests should add focused regression evidence and keep compatibility, bounded execution,
  360. accessibility, privacy, and package closure in scope.
  361. If this workflow helps, a [GitHub Star](https://github.com/toolclub/dsh-agent-team-gui) makes it
  362. easier for other DSH users to discover. Real recipes, screenshots, and honest bug reports help even
  363. more.
  364. ## Uninstall
  365. ```sh
  366. dsh plugin --profile web remove dsh-agent-team-gui
  367. ```
  368. Removing the package does not automatically delete durable plugin tables in the configured DSH
  369. storage backend.
  370. ## License
  371. Released under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.