MIT-licensed DSH preset (JavaScript) adding progress reporting, clarifying questions, size-based planning, interruptible background work, on-demand tool loading and a per-turn skill card.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-10
License
MIT
01What can it help you accomplish?
Keep the agent reporting while it works instead of going silent for a dozen tool calls
One sentence before every run_code, longer milestone updates, and a short final result naming failed tools and providers
Users who lose track of long DSH runs
Stop the agent from sleeping or becoming unreachable while a command runs
Code-enforced reachability: foreground waits move to the background after 30 s, a user message hands the waiting command to the background within about 2 s, foreground sleeps over 5 s are refused, and job completion wakes the model
Users who need to steer a running session
Pick the shell the session actually runs in, per preset
WSL Bash, PowerShell (including discovered 5.1 and 7 executables), Zsh and native Bash, chosen under Settings → Plugins → Deep PTC
Windows and macOS users whose default shell is not what the agent should use
Keep a tool catalog compact and load full schemas only when needed
One deep_ptc_tools directory that searches metadata first, loads up to six schemas per call within a 16 KB budget, and quarantines broken external tools per conversation
Users with many installed plugins whose tool list crowds the context
02How to install into DeepSeek Harness
Prerequisites
- Node >= 24 and DSH >= 0.2.2-rc.1 — the installer rejects the current package on DSH 0.2.1-rc.5 based on its manifest
- The official PTC preset must be present in the installed Harness, since Deep PTC derives from its declaration
Installation steps
- 01
Install the bundle with `plugin_manager({ action: "install_bundle", target: "dsh-deep-ptc-mode@1.8.8" })`, or from a local checkout / archive path
- 02
Installing the same bundle updates it; upgrading from the persona-only release needs a Host plugin reload, and if the settings card has not appeared, reopen the app
- 03
Open Settings → Plugins → Deep PTC, choose the execution environment, and select Deep PTC Mode for a new conversation
Verify the integration
- `npm run check` fails if any statically imported host package is missing from peerDependencies, which keeps a link: installation on the live declaration instead of the fallback snapshot
Rollback
- Uninstall with `plugin_manager` action `remove_bundle`, target `dsh-deep-ptc-mode`; uninstall a local link installation before deleting its source directory
03DSH integration and capability boundaries
A DSH agent preset derived at load time from the installed official PTC declaration: it inherits every official row and replaces only the persona, the shell tools, the reachability guard and the job / question wrappers, adding a settings card and a side card.
Dynamic preset inheritance
the running host's official PTC declaration→a derived Deep PTC preset that follows official tool changes without a plugin release; the bundled lib/preset.json snapshot is used only as a warned fallback
the preset is rebuilt when the declaration or settings change, checked before each conversation is created or resumed, with no polling timerTool directory and quarantine
external plugin tools that publish into the deep-ptc scope→metadata search, on-demand schema loading, per-conversation quarantine of failing external tools, and a reset via the side card or /deep-ptc-reset-tools
quarantine persists with the conversation and survives agent recreation and provider reloadSkill context card
skills loaded through the official skill tool and through run_code inner calls→a per-turn card listing only the skills still in context, with per-skill switches plus Keep all / Close all
closing a skill replaces its tool-result body with a short marker while the durable log keeps the original textVisual effects and side card
the Deep PTC session on screen→the dsh-refined-ui look, keyboard interactions and animations, plus a side card for execution environment, subagents, background jobs and tool state
the styling applies only while the conversation on screen is a Deep PTC session; the visual-effects toggle should be off when using an external theme or UI plugin
04Who is it for? When not to use it?
Good for
- Users who lose track of long DSH runs
- Users who need to steer a running session
- Windows and macOS users whose default shell is not what the agent should use
- Users with many installed plugins whose tool list crowds the context
Not for
- Requires Node >= 24 and DSH >= 0.2.2-rc.1; the installer rejects the package on DSH 0.2.1-rc.5 based on its manifest.
- On Windows, WSL and native Bash require execution already authorized as danger-full-access; the README recommends PowerShell for confined Windows work.
- The preset-identity adapter wraps the host's agentPresets.composedPreset instance and depends on its internal signature, so it must be re-checked after a DSH upgrade; the per-package probe is heuristic.
- A prompt changes the model's working tendency, not the real token limit or billing, and compliance is not guaranteed; the setting that actually controls thinking depth is the model's reasoningEffort.
05Compatibility, maintenance and safety notes
- Requires Node >= 24 and DSH >= 0.2.2-rc.1; the installer rejects the package on DSH 0.2.1-rc.5 based on its manifest.
- On Windows, WSL and native Bash require execution already authorized as danger-full-access; the README recommends PowerShell for confined Windows work.
- The preset-identity adapter wraps the host's agentPresets.composedPreset instance and depends on its internal signature, so it must be re-checked after a DSH upgrade; the per-package probe is heuristic.
- A prompt changes the model's working tendency, not the real token limit or billing, and compliance is not guaranteed; the setting that actually controls thinking depth is the model's reasoningEffort.
- Actual OPS / online-model end-to-end integration has not been performed, and phone screen control was not clicked on a device for this release.
MIT · latest release v1.8.8 (2026-11-10); derives from the installed official PTC preset, with a bundled snapshot only as a warned fallback
06Frequently asked questions
How do I install Deep PTC Mode?
Run `plugin_manager({ action: "install_bundle", target: "dsh-deep-ptc-mode@1.8.8" })`, or point it at a local checkout or .tgz. Then open Settings → Plugins → Deep PTC, choose an execution environment, and select Deep PTC Mode for a new conversation.
Which versions does it require?
Node >= 24 and DSH >= 0.2.2-rc.1; the installer rejects the package on DSH 0.2.1-rc.5 based on its manifest.
Do I lose the official PTC tools?
No. Every official row is inherited as-is; Deep PTC replaces only the persona text, swaps the two platform-switched shell tools for one isolated execution group, adds the reachability guard and wraps the official job and question tools.
Does the mode change my token limit or billing?
No. The README says a prompt changes the model's working tendency, not the real token limit or billing, and compliance is not guaranteed; the setting that actually controls thinking depth is the model's reasoningEffort.
How do I uninstall it?
Use `plugin_manager` action `remove_bundle` with target `dsh-deep-ptc-mode`; if you installed it as a local link, uninstall before deleting the source directory.
07Related DSH workflows
archify
by tt-a1i
Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
openviking
by volcengine
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
aitoearn
by yikart
Let's use AI to Earn!
learn-harness-engineering
by walkinglabs
Harness engineering beginner tutorial, from 0 to 1
08Data and sources
Deep PTC is a DeepSeek Harness agent mode with progress reports, clarifying questions, task-size planning, and interrupt…
Deep PTC is composed at load time from the PTC preset the installed Harness declares (`@deepseek-ai/dsh-web-app/presets/…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-10. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
