Files
deepseek-harness/packages/bundle/sdk-minimal
Tianyi Cui 28442337cf feat(python-example): select the persistent shell by platform
Make the checked-in minimal SDK overlay disable both one-shot shell rows and mount exactly one persistent PTY stack: Bash on Linux/macOS and PowerShell on Windows. The SDK server, explicit dsh home, persistence, editor, timeout, and reduced tool catalog remain unchanged.

Update the runnable example and tutorial to list Windows x64 as supported, describe the platform-selected shell, and remove the obsolete POSIX-only restriction. This keeps the documented first Python task executable through the packaged Windows dsh profile instead of advertising a Linux-only overlay on a Windows-capable SDK.
2026-08-24 19:09:40 +08:00
..

@deepseek-ai/dsh-sdk-minimal

English | 中文

Standalone minimal SDK application bundle for dsh --profile sdk-minimal. Its single insert is the complete Cordis tree: SDK stdio startup and JSON-RPC serving, one environment-configured DeepSeek adapter, the executor-less agent spine, local subprocess and unrestricted filesystem providers, a platform-selected persistent shell PTY, the string-replace editor, and uncompressed JSONL session persistence under $DSH_HOME/sessions. It deliberately does not include dsh-base, Web, settings, managed credentials, telemetry, compaction, workspace instructions, skills, jobs tools, subagents, or any other model-facing tool.

The profile remains part of the ordinary launcher and layering model. The bundle supplies the complete default tree; the profile patch, home patch, and ordered --patch files can replace rows or insert external bundles above it. dsh plugin --profile sdk-minimal manages persistent dependencies. The shipped template uses startup-only patches so one stdio connection never observes replacement of its server or agent dependencies.

DEEPSEEK_API_KEY supplies the adapter credential. The SDK initialization request is the sole model selection; the adapter accepts that model id even when it is absent from its advisory catalog. DSH_CONTEXT_WINDOW sets the fallback capacity for such models, and DSH_SYSTEM_PROMPT replaces the default persona. The process working directory is the sandbox-policy workspace and local-filesystem root. The bundle sets danger-full-access; its persistent shell and editor can modify any path available to the process.

Exactly one persistent shell stack mounts by platform: Bash on Linux/macOS or PowerShell on Windows. Both use a 300-second timeout and one owner-scoped terminal; the other platform rows remain disabled.

Model Experience

Minimal coding-agent composition

What the model sees

The system prompt is DSH_SYSTEM_PROMPT or You are a helpful software engineer assistant.. The only advertised tools are owner-scoped persistent bash on Linux/macOS or pwsh on Windows, plus str_replace_editor; runtime context, workspace instructions, skills, jobs controls, compaction, and Harness identity are absent.

Token effect

One stable persona plus the two tool schemas. Tool results and ordinary conversation history grow with the session.

KV Cache effect

Stable for a fixed persona, platform, provider, model, and bundle patch stack. Profile changes take effect on the next process.

Known Limitations and Deferred Work

  • The composition intentionally omits shared product services — select dsh --profile sdk when settings, managed credentials, policy presets, telemetry, Web tools, or the full default tool roster are required.
  • User patches can expand the tree and corrupt stdout — profile customization is trusted application composition; a plugin that writes ordinary text to stdout can break JSON-RPC framing.