dsh-pi-compatible

English | 中文

Two Full Access-only DeepSeek Harness agent presets whose core tool contract is frozen to @earendil-works/pi-coding-agent 0.84.2.

• Pi-compatible Core exposes exactly seven lower-case tools: read, bash, edit, write, grep, find, and ls.
• Pi-compatible Plus exposes the same core plus explicit DSH-backed Web, Task, Todo, Plan, Think, Slash, and compaction capabilities.

The presets use DSH's filesystem, subprocess, attachment, session, cancellation, model-routing, and presentation seams. They are designed and tested only with the danger-full-access permission preset; they do not implement escalation workflows for narrower policies.

Product contract

Core tools

Tool	Pi-compatible behavior
read(path, offset?, limit?)	Head truncation at 2,000 lines or 50 KiB, offset continuation, a 64 MiB whole-file safety cap, and PNG/JPEG/GIF/WebP/BMP handling subject to DSH attachment capabilities
bash(command, timeout?)	Fresh real Bash process per call, no persistent state, no default timeout, tail truncation with a private full-output spill file
edit(path, edits[])	Original-file matching, unique non-overlapping edits, Pi-style fuzzy punctuation fallback, BOM and CRLF/LF preservation, one guarded atomic write
write(path, content)	Complete UTF-8 write through DSH; missing parent directories are created by the DSH local filesystem backend
grep(...)	ripgrep JSON search, default 100 matches, 500-character line clipping, optional context/glob/literal/case control
find(pattern, path?, limit?)	fd glob search, default 1,000 results, .gitignore-aware relative paths
ls(path?, limit?)	One directory, dotfiles included, case-insensitive sort, / after directories, default 500 entries

All seven tools are visible by default. This intentionally differs from Pi 0.84.2's default four-tool activation (read, bash, edit, write): DSH does not reproduce Pi's dynamic tool-activation mechanism.

Plus extensions

pi-compatible-plus additionally registers:

• WebFetch
• WebSearch
• Task
• TodoWrite
• ExitPlanMode
• Think
• SlashCommand
• /plan
• /compact
• DSH basic compaction and tool-result pruning

These are DSH-backed extensions, not Pi 0.84.2 core tools.

Install

Install the bundle into the DSH Web profile:

dsh plugin --profile web add kingguuu8-svg/dsh-pi-compatible

Or install a local checkout:

dsh plugin --profile web add .

The bundle installs both presets into:

${DSH_HOME:-~/.dsh}/.agent-presets/pi-compatible/
${DSH_HOME:-~/.dsh}/.agent-presets/pi-compatible-plus/

Installation is idempotent and does not overwrite a complete existing preset. Set force: true on the bundle row in the profile patch to replace packaged files during an upgrade. A forced 0.1.x → 0.2.0 migration also removes the known package-owned legacy modules from the Core directory; unrelated user files are preserved.

After installation, create a new session and choose Pi-compatible Core or Pi-compatible Plus.

Runtime configuration

…