dsh-minimal-v3

A Windows-friendly, full-minimal agent preset for DeepSeek V4 Pro. It starts
from the official minimal preset and keeps everything that makes minimal clean
— a fixed complete persona, no automatic instruction injection, no context
compaction — but swaps minimal's pure bash persistent terminal for a
platform-adaptive shell (Windows → pwsh, Linux/macOS → bash), and brings
in a handful of standard's common file/search tools.

This is a community project. It is not an official DeepSeek preset and is not
affiliated with or endorsed by DeepSeek.

Why this matters: DeepSeek V4 Pro conditions strongly on the API-visible
tool catalog. Official minimal scores well in evaluations (see
modeltest) but only runs on Linux +
persistent bash — on Windows it breaks because bash is absent. This preset
keeps minimal's "purist" character while working on Windows too, and includes
the tools you actually need for engineering (read/write/edit/glob/grep)
instead of leaving you with just two.

Compared to official minimal

Dimension	Official minimal	dsh-minimal-v3
persona	complete prompt	same (You are a helpful software engineer assistant., complete: true, includeRuntimeContext: false)
shell	persistent bash (unusable on Windows)	platform-adaptive: Windows→pwsh, others→bash (non-persistent)
auto-injection	none	none (does NOT load AGENTS.md/CLAUDE.md/local overlay)
context compaction	none	none
tools	only bash + str_replace_editor	pwsh|bash, read, write, edit, read_image, glob, grep, ask_user_question, todo_write
subagent/workflow/goals/skills/web	none	none (kept minimal)

Final tool catalog

• Windows: pwsh, read, write, edit, read_image, glob, grep,
  ask_user_question, todo_write
• Linux/macOS: bash, read, write, edit, read_image, glob,
  grep, ask_user_question, todo_write

Constant for the whole session — no two-phase bootstrap/promotion.

Compatibility

Developed and verified against:

• DeepSeek Harness (DSH) 0.1.0-rc.6
• Node.js ≥ 22.19 (only needed for the local self-test)

DeepSeek Harness is currently a developer preview and explicitly permits
breaking changes. This preset references official packages
@deepseek-ai/dsh-persona, dsh-tool-bash, dsh-tool-pwsh, dsh-tool-fs,
dsh-tool-fs-search, dsh-tool-ask-user, dsh-tool-todo; if a newer Harness
fails to load it, double-check whether any of those package names changed.

Install

Clone this repository, then copy the preset directory into the user preset
root under the id minimal-v3.

PowerShell (Windows):

$target = Join-Path $env:USERPROFILE '.dsh\.agent-presets\minimal-v3'
if (Test-Path -LiteralPath $target) { throw "Preset already exists: $target" }
New-Item -ItemType Directory -Force -Path (Split-Path -Parent $target) | Out-Null
Copy-Item -Recurse -LiteralPath '.\preset' -Destination $target

Linux/macOS:

dsh_home="${DSH_HOME:-$HOME/.dsh}"
mkdir -p "$dsh_home/.agent-presets/minimal-v3"
cp -R preset/. "$dsh_home/.agent-presets/minimal-v3/"

Fully restart DeepSeek Harness, create a blank session, and select Minimal V3
in the preset picker. Do not switch an active session from a different preset.

Usage notes

• Best paired with DeepSeek V4 Pro (the edge here is mostly about Pro's
  sensitivity to the tool catalog; V4 Flash is already stable across harnesses
  and thinking modes).
• On the first request, consider having it read a file first to anchor the
  trajectory before giving it the real task.
• This preset has no skill tool: if you need open-design-style custom skills,
  use a full preset or add tool-skill back in your own copy.
• Because auto-injection is off, project AGENTS.md/CLAUDE.md are not loaded
  automatically — read them explicitly or write the rules into the conversation.
  That is intentional ("pure minimal").

Verify

Local zero-dependency self-test:

npm test

To confirm the preset is discoverable (outside the running Harness):

import { discoverPresets } from "@deepseek-ai/dsh-agent-presets/lib/types/discovery.js";
const presets = await discoverPresets([{ path: "~/.dsh/.agent-presets", trust: "user" }]);
console.log(presets.map(p => ({ id: p.id, broken: p.broken ?? false })));

minimal-v3 should appear with broken === false.

For deeper runtime verification, export the session JSONL and check that the
request/header tools match the catalog above, and that user/message
contains no <system-reminder> AGENTS.md / skills injection.

Important behavior

• If the first model response makes no tool call, nothing changes (this preset
  is constant; there is no two-phase promotion).
• A failed tool execution does not stop the model from calling the others.
• The preset carries the same trust level as shell access — review
  preset/agent.cordis.yml before installing.
• This preset performs no network requests and adds no telemetry.

Official ecosystem guidance

DeepSeek currently asks community plugin authors to publish plugins in their own
GitHub projects and add the dsh-plugin
topic for discovery. The official repo does not currently accept external PRs
and does not mandate a community template. See the official
CONTRIBUTING.md.

License

MIT. preset/agent.cordis.yml was written following the shape of the official
DeepSeek Harness minimal preset; original copyright and MIT notice are retained
in NOTICE.