dsh-agent-team-presets
用于 DeepSeek Harness 的可复用 Agent Team 预设：一个队长和多个成员，每个成员都有自己的提示词、模型、推理力度和工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-agent-team-presets@0.1.5
Agent Team Presets 以 dsh-agent-team-presets 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Concept illustration. See Screenshots for the plugin interface; the captain uses the conversation's selected model.
English | 中文
Community plugin v0.1.5 · Release
Requires a compatible DeepSeek Harness deployment with Agent Teams enabled. This version uses rc.2 APIs; see Requirements. Prebuilt artifacts are included, so installation does not require a source build.
dsh-agent-team-presets is a visual Team preset manager for DeepSeek Harness. Configure a Team once, then select it from the conversation composer whenever you need it.
A Team contains a captain and any number of member roles:
spawn_team_member; native Agent Teams provides messaging, the shared task board, and runtime coordination.This is a community plugin, not the Harness's bundled @deepseek-ai/dsh-experimental-agent-team-presets development package.
DeepSeek Harness already ships Agent Teams with multi-agent collaboration. In the Harness versions this plugin supports, per-Team configuration and reuse are still left to the user, which is what this plugin addresses:
Design principle: native Agent Teams owns collaboration at runtime; this plugin owns configuring, managing, and reusing teams.
The screenshots illustrate the composer control and settings workflow. Example Team and provider names are illustrative; available models and tools depend on your deployment. Some screenshots show an earlier UI revision, so controls and helper text may differ from v0.1.5. The permission rules below describe the current version.
Choose a Team in the composer
The Team control in the composer
Manage saved Teams
Configure member models and reasoning effort
Team editor
Model picker
Captain and member system prompts
Tool policy controls
>=0.2.0-rc.2 <0.3.0, while others have broader peer ranges. The plugin manager checks every declared dependency; the exact requirements are in package.json. Do not treat rc.1 as sufficient for this release.@deepseek-ai/dsh-experimental-agent-team-profile, which supplies the Team service, tools, and Web roster. This plugin configures Teams; it does not replace that subsystem.web for the Web GUI or desktop for Desktop.spawn and fork; custom deployments must configure compatible backends.The plugin version (0.1.5) and the Harness version (0.2.0-rc.2, for example) are separate version lines.
No command line required: open Global panels → Plugins → Add plugin, paste the line below into Package name or address, and click Install.
dsh-agent-team-presets@0.1.5
~/.npmrc already points at registry.npmmirror.com, that is the mainland mirror, so the dialog lists no separate Mainland China mirror entry. Pick Official npm registry to bypass a mirror, or Custom address for a third source — an internal registry, or another mirror such as https://mirrors.cloud.tencent.com/npm/ or https://repo.huaweicloud.com/repository/npm/.@0.1.5 names the version; drop it and enter dsh-agent-team-presets to take whatever npm currently publishes.dsh plugin add: a package name, name@version, github:owner/repo, a tarball URL, or an absolute path. The check before installing queries the package, so a version that does not exist or a package without dsh.bundle is refused before anything is written.dsh.bundle, so the plugin manager registers it as a profile bundle layer; do not add a loader entry by hand.github:…#v0.1.4 to the npm form), uninstall it in the plugin list first, then paste the spec above.For an installation that can receive repository-version update notifications:
dsh plugin --profile <profile> add github:bloodarea/dsh-agent-team-presets
Replace <profile> with the profile your GUI runs. For example:
dsh plugin --profile web add github:bloodarea/dsh-agent-team-presets
To select the v0.1.4 release tag instead:
dsh plugin --profile <profile> add github:bloodarea/dsh-agent-team-presets#v0.1.4
An unpinned GitHub install follows the repository's package version for market update checks; commits without a version increase do not produce a new-version notification. A pinned ref is compared only with that ref, so later releases are not offered automatically. Use a commit SHA rather than a tag if you need an immutable source reference.
GitHub and npm are separate release channels and may not carry the same version. Check npm before installing from it:
npm view dsh-agent-team-presets version
If that version meets your requirements, install it with:
dsh plugin --profile <profile> add dsh-agent-team-presets
If the registry version is older than the release you need, use the GitHub command instead. Installing this package uses the prebuilt artifacts; rebuilding them is a separate development task.
After a successful installation, follow the plugin manager's reload or restart instructions and open Settings → Agent team presets. Check that plugin details show dsh-agent-team-presets, the expected version, and a running component.
@deepseek-ai/dsh-experimental-agent-team-presets through the plugin manager before enabling the community package. Do not enable both: they use the same settings namespace and client registrations. Preserve existing Team settings and selections during migration.Install the bundle; do not add a second loader declaration. The package already supplies its own bundle patch. Hand-written copies of the
agent-team-presetsentry in profile, home, or command-line patches can prevent Team settings from being saved. See Configuration writes are overridden if this happens.
For a Team with implementation and review roles, a request could be:
Use the selected Team. Have the implementation member make the agreed change, then ask the reviewer to check it independently. Summarize the changes, test results, and remaining risks.
A preset role is not an already-running member. Each call creates a new instance with a unique target such as reviewer or reviewer-2. Use the returned target with send_message to continue an existing member instead of creating another one.
Selecting No team removes the Team application once the captain and its teammates are idle. It restores the conversation's other prompt and tool contributions, without changing the selected model.
| Field | Purpose |
|---|---|
| Team name and purpose | Identify the preset and explain what work it should handle. |
| Captain | The conversation's lead agent. A nonempty captain prompt replaces its persona prefix; the captain keeps the conversation's selected model. |
| Members | Reusable role templates the captain can summon. A role may have multiple runtime instances, subject to Harness limits. |
| Name | Display name. After trimming and lowercasing, ASCII letters/digits separated by single hyphens form a role target if it is at most 64 characters and not lead. Other names, including empty or non-Latin names, use a target such as member-1; collisions receive suffixes. Runtime messages use the returned instance target. |
| Description | Explain the role's responsibilities so the captain can choose an appropriate member. Keep member descriptions within 200 characters, as required by the Team service. |
| Color | Accent used to distinguish the role in Settings and the roster. |
| Provider / Model | Members only. Select a route from the deployment's model catalog; without a complete provider/model selection, no member-specific route is installed. |
| Reasoning effort | Members only. Options depend on the selected model; empty uses that route's default. |
| Allowed tools | Independent all-tools or custom policy for each slot; see Tool permissions. |
| System prompt | Standing role instructions. Complete {{variable}} groups are prompt-template variables; an unresolved variable can fail a request. |
The editor has three levels: the Team list, one Team, and one captain or member. You can return to the list without losing a staged edit, but Save is required to persist it.
A fresh installation seeds three editable Teams:
| Preset | Intended use |
|---|---|
| 轻量研发团队 | Small features and module iterations, with an implementation member and an on-demand technical advisor. |
| 标准研发团队 | Medium features and significant refactoring, adding an independent reviewer. |
| 全栈软件研发团队 | Work across Web, desktop, and Android, with implementation, architecture, UI/UX, and review roles. |
Their prompts are in Chinese. The same portable documents are available in contrib/default-presets for manual import.
Defaults are offered once per profile configuration: deleted presets stay deleted across restarts and upgrades, and edited presets are not overwritten. Restore defaults restores the shipped fields while preserving routes and tool policies on matched roles, and leaves user-created Teams alone. It also restores each built-in Team's shipped roster, removing roles you added to that Team; duplicate a customized Team first if you want to keep it. Restored presets are staged until you press Save. A deleted preset added back has no previous local route or tool policy to preserve.
A Team preset is shared across Sessions in the profile, but each Session adopts updates independently:
| Change | Effect |
|---|---|
| Purpose, role descriptions, prompts, roster, or tool policies | An idle Session adopts the change immediately. A busy Session keeps its applied definition until the task ends. |
| Team selection, including No team | Takes effect once that Session's captain and teammates are idle. |
| Member provider, model, or reasoning effort | Read when a new member instance is summoned, even during a running task. Existing instances retain their creation-time route. |
| Color | Updates when the UI redraws. |
The footer summarizes online Sessions as idle, busy, or unknown. Busy includes a running captain or a running/provisioning teammate. Unknown means execution state could not be confirmed, not that the Team is idle.
Export saves one Team as JSON. Import preset reads that document and stages it in the editor.
Exports include the currently displayed draft, including unsaved edits. Imports do not reach stored settings until you press Save. Review prompts for private information before publishing an exported document.
You can ask the conversation's lead agent to adjust a Team's purpose or role instructions. Two tools are registered on root Sessions, including Sessions with no Team selected, subject to the active tool policy:
get_team_preset reads the selected Team, or the Team named by team_id, and returns its editable fields and settings revision. Without a selection, it lists configured Teams so you can choose one.update_team_preset changes Team/captain descriptions and captain/member system prompts or member descriptions, using that revision. Names, model routes, colors, and tool permissions must be edited in Settings.A write requires a direct user-started turn and Host approval of the exact target and changes. If approval is disabled, denied, or unavailable, nothing is saved. Another writer advancing the revision also requires a fresh read before retrying.
The update tool returns team-busy while any affected online Session has a running or provisioning teammate. Wait for those teammates to finish, then read the revision again. The Settings page can still save changes for later adoption. A successful tool write uses the same adoption timing as a Settings save; it does not rewrite an existing teammate's stored persona or policy.
send_message, list_agents, and team_task_*. An empty custom list denies all configurable tool calls. Switching modes preserves the saved custom selections.The catalog groups tools by this plugin, MCP server, and other tools. Groups offer selection controls and show selected/total counts. Descriptions use the registry's model-facing text and may remain English even when the interface is localized. The catalog combines tools from different Agent presets; a listed tool is not necessarily available to the current Session. Choose an Agent preset that provides it or remove it from the allow-list if application is refused.
Captain-only tools are disabled on member pages. Native spawn_teammate is blocked while a Team preset is active; use spawn_team_member so member configuration is applied consistently.
run_code and ordinary subagent, subagent_fork, and workflow delegation, because those paths do not provide this plugin's durable strict-policy contract. Use preset-managed Team members for delegation.If saving or selecting a Team reports:
Configuration for "agent-team-presets" is overridden by a home patch or command-line overlay
a patch layer conflicts with the settings write. The installed bundle already inserts the plugin entry; a duplicate hand-written declaration or an overriding configuration can prevent the Host's editor from committing changes.
$DSH_HOME/cordis.patch.yml, and any --patch overlays for conflicting hand-written agent-team-presets declarations.dsh.profile.bundles and edit Teams through Settings.The composer and Settings page show the Host's error text when a write fails.
In Harness 0.2.0-rc.2, the Team roster and list_agents.model read creation-time options or fallback metadata, not this plugin's member-scoped request selection. list_agents.provider identifies the subagent execution backend, not the LLM provider, and the tool does not report reasoningEffort. A display mismatch alone does not establish a routing failure.
configuredRoute in the spawn_team_member result reports the route captured for that instance. It is omitted when no member-specific route is configured. Advanced diagnostics can also inspect route in the durable agent_team_presets_members unit.request/header or modelSelection.lastUsed projection. Before the first request header, lastUsed is empty; afterwards it describes the last recorded request, not the next selection.| Symptom | What to check |
|---|---|
| Settings page is absent or the plugin is pending | Confirm the target profile, peer compatibility, Agent Teams, and required client services. |
| Model or tool catalog fails to load | Read the displayed error and check the deployment's provider/tool services. Saving a preset cannot add a missing capability. |
| Member creation is refused | Check durable storage, the configured execution backend, route/effort availability, and Harness depth/concurrency/member limits. A finished member frees an activity slot, not its permanent Team roster slot. |
| A prompt fails with an unknown variable | Correct the {{variable}} group or provide the variable through the deployment. |
| Windows configuration cannot be parsed | Preserve valid UTF-8 JSON without a BOM when editing profile manifests. Do not disable schema validation or delete active Host/credential locks to work around an error. |
| The selected Team was deleted | Select a valid Team or No team. A missing Team is an error, not an implicit switch to unrestricted mode. |
send_message. Saved preset changes apply to future instances; send an existing member a message to adjust its immediate task.zod startup imports from earlier package builds. It does not repair unrelated Harness installation, encoding, lock, or third-party plugin failures.The plugin uses Cordis and Harness extension points without patching the Host:
spawn_team_member at the Agent scope. It does not change the root conversation's model selection.agent/created lifecycle installs its model route, persona, Team context, and strict tool policy before its first request.| Area | Source |
|---|---|
| Plugin lifecycle and settings reconciliation | index.ts, settings-reconcile.ts |
| Team application and member tool | application.ts |
| Member snapshots, identity, and resume | member-store.ts, member-identity.ts, member-runtime.ts |
| Tool policies and presentation | tool-policy.ts, presentation.ts |
| Preset editing and portable documents | preset-tools.ts, preset-transfer.ts |
| Execution state and catalog | execution.ts, tool-catalog.ts |
| Browser UI | src/client |
The captain sees its configured persona, the Team purpose, and a roster of member role targets and descriptions. A member sees its own role instructions and the Team's division of labour; that role list is not a live runtime roster. Use list_agents for current targets and status.
These prompt sections and the spawn_team_member schema add to the model's context. Larger rosters and longer prompts therefore use more tokens. Definitions remain stable during a task, but actual prompt-cache reuse depends on prompt variables and the provider; the plugin makes no cache-hit guarantee. Rendered system prompts are recorded in the Session's system/message events.
Source development requires a compatible, dependency-installed Harness checkout. From this repository:
export DSH_CHECKOUT=/absolute/path/to/deepseek-harness
npm test
npm run typecheck
npm run bundle
The scripts use the checkout's tooling and source aliases. Tests use mock model adapters; npm run typecheck reports this plugin's diagnostics, not a clean typecheck of the entire Harness. npm run bundle rebuilds the committed artifacts in an isolated staging workspace. These checks do not replace visual or real-provider testing. See the scripts in tools and the test suite for the current verification scope.
Bug reports and pull requests are welcome in GitHub Issues and Pull requests. For a report, include:
Do not publish credentials, private endpoints, full Session logs, or proprietary prompt content. Review the affected behavior and add focused tests when changing runtime code. Keep the two README versions and prebuilt artifacts consistent with a release.
MIT. Bundled third-party notices are in THIRD-PARTY-NOTICES.txt.