Skip to main content

pilot-harness/packages/bundle/base

240Stars13Forks16Issues1Watchers

DSH shared base profile bundle, inserts 100+ base plugin lines at once via cordis.patch.yml as the first layer for all profiles.

Categories◆ Memory
Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
TypeScript
License
MIT
Branch
main
ai-agentcodepilotdeepseekdeepseek-harnessdesktop-appdshdsh-pluginelectron

Install

cmdweb profile
$ dsh plugin --profile web add @deepseek-ai/dsh-base

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin op7418/pilot-harness/packages/bundle/base for me: review the repository at https://github.com/op7418/pilot-harness first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-line Summary

This is DSH's shared base profile bundle. It contains no runtime code itself; instead, it uses a single cordis.patch.yml to lay out all of DSH's default foundational plugin rows (model adapters, tools, persistence, strategies, settings/credentials, telemetry, host-level subagent providers) onto an empty profile root in one go, serving as the first patch layer for every profile.

Core Capabilities

  • One-time mounting of DSH's default model layer: DeepSeek official adapter, Pi-AI multi-provider adapter (mounted by default but waits for llm-pi-ai: settings to enable), deepseek-v4-flash default model selection
  • Mounting agent, session, tool registry and settings/credential management: session persistence (JSONL), attachment disk-write, settings hot-reload, credential parsing
  • Enabling built-in tool sets: bash/pwsh tools (one per platform), file system read/write, glob search, web search (DeepSeek search), Todo, SubAgent, Goal, Workflow, Ralph, Skill, etc.
  • Enabling strategies and sandbox: workspace-write / read-only / danger-full-access three-tier permission presets, sandbox strategy, user approval, file watching strategy, token-meter, spill strategy
  • Platform-gating two shell stacks: bash enabled on non-win32, pwsh enabled only on win32; each platform mounts exactly one shell stack
  • Mounted but session telemetry disabled by default; requires DSH_TELEMETRY_MODE environment variable to explicitly enable; SQLite full-text search also disabled by default

Technical Implementation

  • Language: TypeScript (src/index.ts is empty export, no runtime API)
  • Key Dependencies: 100+ @deepseek-ai/dsh-* packages in repository workspace (LLM/Agent/Session/FS/Sandbox/Tools/SubAgent, etc.), plus @deepseek-ai/cordis, @deepseek-ai/cordis-plugin-hmr, @deepseek-ai/cordis-plugin-timer
  • Architecture Pattern: Not a code plugin, but a profile bundle; package.json's dsh.bundle.patch manifest field points to cordis.patch.yml, which the profile composer reads and inserts the foundational plugin rows into an empty profile root via "whole-row config replacement"; subsequent bundle layers (web-app, headless, etc.) and user cordis.patch.yml override these rows by ID
  • Entry Files: cordis.patch.yml (the actual effective "content"), plus src/index.ts (empty export placeholder), src/invariant.ts (invariant companion with no runtime checks)

Use Cases

This is the first layer carried by all DSH profiles (headless, web-app, user-defined profiles, etc.) by default; when you need to build custom agents, CLI mode, web mode, or workflows on top of DSH, the base bundle already has all the essential core capabilities (model layer, agent loop, session, tools, permissions, sandbox, persistence) installed—no need to individually integrate each dsh-* package. The base bundle is typically not installed standalone; it takes effect together with any upper-layer profile bundle (headless, web-app, etc.).

Prerequisites & Compatibility

DependencyMinimum VersionDescription
DSH Framework0.1.0-rc.7 same generationReleased in sync with other @deepseek-ai/dsh-* packages in repository workspace
Node.js^22.19.0 || >=24.0.0See engines.node in root package.json
macOS / Linux—bash-sandbox, tool-bash enabled; pwsh rows disabled
Windows—pwsh-sandbox, tool-pwsh enabled; bash rows disabled, can be restored via profile override
Platform RestrictionCross-platformSame patch file auto-gates two shell stacks by process.platform
Native ModulesNoneNo native modules introduced; win32 sandbox chain provided separately by @deepseek-ai/dsh-sandbox-windows-acl

Installation

dsh plugin --profile web add github:op7418/pilot-harness/packages/bundle/base

Configuration

The base bundle itself has no "user-level" configuration switches; it hardcodes or binds to environment variables the config of several plugin rows via the patch file. Environment variables appearing in the patch file and their defaults are as follows:

Environment Variable / Config SourceValueDescription
DSH_TELEMETRY_MODEDefault DISABLEDControls session telemetry mode; set to FULL or FEEDBACK_ONLY to actually report
DSH_TELEMETRY_OTLP_URLDefault https://harness-telemetry.deepseeksvc.com/v1/logsOTLP/HTTP reporting endpoint
DSH_TELEMETRY_DISABLEDAny non-empty valueSetting to non-empty disables telemetry (including '0', 'false'); launcher rewrites this to disabled
DSH_PERMISSION_MODEDefault workspace-writeGlobal permission mode;可选 read-only / workspace-write / danger-full-access
DEEPSEEK_API_KEYRequired (production)Credentials needed for session title parsing, web search, and chat model calls; resolved on-demand by dsh-credentials-local
agent-default-model's provider/modeldeepseek-official / deepseek-v4-flashDefault agent model and adapter; can be overridden in user settings.yaml
session-title-llm title lengthTarget 5 words / 10 CJK charsLength target and upper limit for auto-generated session titles
bash-sandbox timeout60000 msDefault timeout for bash command execution
Tool result trimmingThreshold 8192 chars, first 4096 + last 1024Trimming window for tool returns that are too long before entering conversation
Ralph subagent max rounds64Maximum iteration rounds for Ralph tool

FAQ

Q: After installing the base bundle, what else do I need?

A: The base bundle only provides the "foundation"—the core shared by all profiles; it doesn't expose CLI entry points. To use CLI, append dsh-headless to the profile's dsh.profile.bundles; for a web interface, append dsh-web-app. These upper-layer profiles have already overlaid specific configurations on the patch; base is just the bottom layer.

Q: Can I override the default model on top of base?

A: Yes, but you must use "whole-row replacement": in the profile or home's cordis.patch.yml, write an insert row with the same ID agent-default-model, restate the provider and model fields to replace the entire row that base wrote. You can also directly modify the llm-deepseek: section in settings.yaml via the web UI settings page, which takes effect after restart.

Q: On Windows I want to use bash tools instead of pwsh, what should I do?

A: In the profile or home's cordis.patch.yml, write two modifications simultaneously: rewrite pwsh-sandbox and tool-pwsh to disabled: true, then delete or set to false the disabled field for bash-sandbox and tool-bash. Both commands register the same bash service; an incomplete recipe will throw an error directly at load time.

Q: How to enable the content search that's off by default?

A: The session-query-sqlite mounted in base has openAt: never by default, and the SQLite file won't be opened. Override this row in a subsequent profile layer, set openAt to first-search or startup, and provide a persistent path—full-text search will then be enabled.

Q: After uninstalling or resetting base, will existing session records be lost?

A: No. Base doesn't directly persist data; sessions are written by dsh-session-persistence-jsonl to $DSH_HOME/sessions/, and attachments are written to the attachment backend directory. Uninstalling or rewriting base won't delete these directories; however, if you also disable session-persistence-jsonl or attachment-local, new sessions will land elsewhere, while old sessions can still be read by search-enabled profiles.

Q: What to do when errors like "row is disabled by config" appear at startup?

A: Usually caused by illegal disable configuration in user-layer cordis.patch.yml, or conflict with base's platform gating. Check whether the user patch has incomplete overrides for bash/pwsh/sandbox rows (see the Windows bash restoration note), and confirm whether DSH_PERMISSION_MODE takes a value not registered in the permission presets.

Getting Started

Beginner — The base bundle has no user-level API, requires no coding and no separate configuration; regular users install it once via dsh plugin add and it's automatically applied by upper-layer profiles; custom developers only need to understand cordis.patch.yml and "whole-row replacement" semantics to make modifications.

Known Issues & Limitations

  • Patch replaces entire row config, no deep merge: Profiles must restate all fields they want to preserve for that row; there's no per-field merge layer (see packages/bundle/base/README.md:21)
  • Windows temp directory authorization is per-session private: workspace-write restricts writes to workspace + session's own temp subdirectory (<temp>\dsh-<hash>), restricted subprocesses' TMP/TEMP are rewritten; read-only grants no temp write permissions. See @deepseek-ai/dsh-sandbox-windows-acl for details
  • Won't auto-mount Codex / Claude Code provider: Base's dependency list doesn't include @deepseek-ai/dsh-subagent-codex and @deepseek-ai/dsh-subagent-claude-code; whichever is needed must be opt-in by that profile individually
  • Same patch file gates two shell stacks by platform: bash row disabled on win32, pwsh row disabled on POSIX; only complete pair modifications can switch stacks

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/op7418/pilot-harness/packages/bundle/base)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory