Agent preset for DeepSeek Harness that layers the self-referential Cordis toolset (dynamic plugins, runtime inspection) and preset-authoring skills onto the PTC Code-Mode preset; materialized files carry per-file sha256 markers, so user-edited presets are never overwritten on upgrade or uninstall.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-ptc-cordis-preset
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:KannaKuron/dsh-ptc-cordis-preset
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
简体中文 | English
Creation mode on top of PTC mode — the missing fourth combination for DeepSeek Harness (DSH): Code Mode tool composition × creation capabilities.
DSH ships four presets: Standard (standard), PTC (ptc — Standard plus Code Mode SDK tool presentation, where multi-step operations compose into one program), Minimal (minimal), and Creation (cordis — Standard plus the self-referential Cordis toolset and preset-authoring guidance).
The shipped Creation mode is built on Standard. This plugin supplies the missing cell: PTC Creation mode (ptc-cordis) — everything in PTC mode unchanged, plus every Creation-mode addition:
- 🧬 Self-referential Cordis toolset —
cordis_inspect/cordis_define/cordis_run/cordis_stop/cordis_undefine: read the live runtime, define/run/stop dynamic plugin packages - 📐 Two-planes persona — host-composition vs agent-preset ownership rules, plus how to compose under Code Mode
- 📚 Composition-authoring skills travel with the preset —
editing-cordis-compositions/cordis-plugin-development - ⏰🔔 Official rows ride along —
time-context,tool-schedule,tool-plugin-marketandtool-office(rc.2) join only when their packages resolve from the host; manager/market follow the liveprofileContextservice - 🚫 The workflow tool is never offered — matching the official PTC mode. The
workflow-ptc/tool-workflowrows stay in the composition but permanently disabled, so alignment diffs remain row-for-row. Sub-agent orchestration and parallel calls stay available insiderun_code
Install
dsh plugin --profile web add dsh-ptc-cordis-preset
# source and Releases: https://github.com/KannaKuron/dsh-ptc-cordis-preset
Requires dsh >= 0.2.2-rc.1 (rows aligned with 0.2.2-rc.2) and Node >= 24.9. Pure JS, zero build — the install triggers no pnpm build scripts and needs no allowBuilds entries. Restart DSH after installing, then pick PTC 创造模式 in the mode picker when creating a session.
How it works
Since dsh 0.2.2-rc.1 presets are declarative: the plugin registers the definition straight onto the roster via ctx.agentPresets.register() and materializes no directory. At startup it registers ptc-cordis (the composition data lives in src/composition.js); the Python-backend knob retire-then-remounts on every flip:
- Composition mirror: the row set aligns with the official
packages/bundle/web-app/presets/{cordis,ptc}.patch.ymlcell by cell, locked from both directions bytests/fixtures/official-preset-rows.0.2.2.json— an upstream row add or default change turnsnpm testred immediately - Skills track the deployment:
customSkillDirspoints at theskills/directory beside the installed@deepseek-ai/dsh-agent-preset— no snapshot in this repo - Optional rows ride a probe:
time-context/tool-schedule/tool-plugin-market/tool-office(rc.2) join only when their packages resolve from the host's module base (probeHostExtras, the same base rows mount from). Theofficeprobe doubles as the rc.2 row-dialect probe: only when it resolves doestool-subagent-controlgetinterrupt: false, so an rc.1 host never receives an unknown key; any resolution failure degrades to "absent", never rejects the preset mount - Legacy-tree cleanup: versions before v0.16.0 materialized
~/.dsh/.agent-presets/ptc-cordis/; startup removes that tree only when.plugin-managed.jsonproves it untouched, and only logs when you edited it
Update & uninstall
- Update: market-page "update" or re-run the install command → restart DSH → the roster entry is the new version
- Uninstall: market-page uninstall → the roster entry disappears, no directory left behind
- To build your own mode on top: copy this preset to a new id in the mode picker and edit the copy
Usage
- New session → pick PTC 创造模式 in the mode picker
- Use Code Mode as usual (
run_codecomposes multi-step operations); thecordis_*tools sit in the SDK like any other function - Ask it to author presets or experiment with dynamic plugins — it loads the travelling authoring skills automatically
⚠️ Trust boundary matches the shipped Creation mode:
cordis_define/cordis_runevaluate model-written JavaScript against the live runtime. Treat a PTC Creation session like shell access.
✅ Coexists with the shipped Creation mode in one process: the host-plane inspect registry throws on a duplicate provider id. This plugin's compatibility shim tries the original path first and only on an "already registered" collision replaces the stored entry (same-package manifests are equivalent; the identity-guarded disposer keeps teardown consistent). It installs via
ctx.inject(['cordisInspect'])exactly when the service appears, regardless of row activation order. Once upstream natively tolerates duplicates, the original path succeeds and the shim becomes a no-op.
Languages
The settings card follows DSH's locale setting (ctx.locale) and switches live. 21 dictionaries ship with the plugin: Simplified and Traditional Chinese (including zh-HK / zh-MO / zh-TW), English, Japanese, Korean, German, French, Italian, Portuguese, Russian, Dutch, Polish, Swedish, Turkish, Indonesian, Vietnamese, Thai, Hindi and Arabic.
One entry per language lives in the LOCALES table in src/client.js (each behind a /* locale: <tag> */ marker). Resolution is "exact tag → primary subtag → English"; lookups resolve the current locale on every call (cached per tag), and the card subscribes to ctx.locale.subscribe so a language switch repaints it on the spot.
A smoke test requires every dictionary to carry exactly the same key set as Chinese: a missing key falls back to English silently and leaves the card half-translated.
Build & test from source
git clone https://github.com/KannaKuron/dsh-ptc-cordis-preset.git
cd dsh-ptc-cordis-preset
npm test # node --test, 56 smoke tests (offline, no build; the count tracks npm test's own output)
There is no build step: src/index.js, src/composition.js and src/client.js are the shipped artifacts.
tests/fixtures/official-preset-rows.0.2.2.json holds the official dsh 0.2.2-rc.2 preset rows as a capture (parsed with the loader's YAML dialect, !!js evaluated for a profile host); it locks the declarative composition onto the official text from both sides. Regenerate after a dsh version change with node tools/gen-official-preset-fixture.mjs (DSH_CHECKOUT / DESKTOP_BUILD override the paths).
Cooperation with dsh-gitbash-shell
With dsh-gitbash-shell installed alongside, the two plugins cooperate on three fronts.
Composition and roster name follow the Git Bash side
This plugin detects the peer's gitBash host capability service: with both installed it uses the Git Bash shape (tool-bash enabled, tool-pwsh disabled by default); without it, or on non-Windows hosts, it uses the default shape. The probe is bounded (1 s) at startup.
Explicit dsh-ops 0.5.0+ integration: with dsh-ops 0.5.0 or newer installed, this plugin detects the single dsh-ops row (id and name dsh-ops, not disabled) and, only when present, appends the public integration entry to the ptc-cordis composition:
{ preset: 'ptc-cordis', profile: 'ptc' }
It gives this preset ops' PTC file tools (resident inspect_local_file, load_sdk for the rest) while shell:false — no ops_bash, no official tool replacement; the shell channel stays with Git Bash. dsh-ops' built-in mode switches (four through 0.5.2, five from 0.5.3) only match the official preset ids and ptc-cordis is not one of them, hence the explicit opt-in. The old 0.4.x component/dsh-ops-mode-* rows are no longer recognised. Without dsh-ops the row is absent and the composition matches v0.25.0. The existing tool-pwsh dedup/yield logic is unchanged (opsPresent still has the same weight as the peer switch).
dsh-ops 0.5.3+ compatibility: 0.5.3 adds a fifth built-in mode, OPS (PTC) (ops-ptc), and by default makes it the default preset for new sessions (global.forceDefaultOpsPtc defaults to true and writes agent-preset-registry.selectedDefault). This changes only the default selection for new sessions; it does not affect this plugin's ptc-cordis registration or the dsh-ops/integration contract (profile:'ptc'), and PTC 创造模式 remains selectable in the mode picker. To keep the previous default, turn off forceDefaultOpsPtc in the dsh-ops settings card.
Roster display name: while Git Bash is active the entry reads PTC 创造模式 · Git Bash with (Shell 使用 Git Bash) appended to the description; otherwise it stays PTC 创造模式. assets/preset.gitbash.yml's name: is the single source of truth for the name, and a smoke test locks the two together.
The published ptcCordisPreset capability
At startup this plugin publishes:
{ id: 'ptc-cordis', gitBashActive: true /* false on the non-Git-Bash side */ }
The peer uses it to decide that this preset already covers Creation mode on Git Bash, and therefore stops registering its own 创造模式 · Git Bash while the user's dedupe switch is on. The value is final when published (the probe finishes first), and the service is published on hosts without the peer too (gitBashActive: false).
The shared dedupe switch on the settings card
Since v0.14.0 this plugin's settings card carries 「与 dsh-gitbash-shell 去重」:
- Off by default ("keep both"), changing no existing behaviour;
- One single state: it binds the peer's own row through
ctx.configForms.get('gitbash-shell'), reading and writingsuppressPeerCordis; - Not rendered while the peer's row is absent;
- Deduplication takes effect with dsh-gitbash-shell >= 0.25.0 and this plugin >= 0.14.0.
If your
ptc-cordisdirectory was materialized by an older version and is still unmodified, the first startup after upgrade refreshes it automatically; if you modified it, delete~/.dsh/.agent-presets/ptc-cordisand restart.
run_code backend switch (default OFF)
Settings → Plugins → the "PTC 创造模式" card gains a run_code backend row:
- Node / TypeScript (default): run_code uses dsh's official Node PTC backend, byte-identical to the shipped
ptccomposition. - Python (experimental): switches to dsh's experimental CPython backend
@deepseek-ai/dsh-experimental-ptc-runtime-python(installed with this plugin). run_code's language, generated Python SDK prompt and tool presentation follow the provider automatically.
Requirements and boundaries:
- Platform: POSIX (macOS / Linux) only. Windows keeps the official Node backend and logs guidance.
- Interpreter: CPython ≥ 3.10. The plugin probes, in order, an explicit
pythonBin→DSH_PYTHON→ the dsh runtime's own interpreter → common Homebrew paths → PATH →/usr/bin/python3, and freezes the winning absolute path for the provider. - When it takes effect: after restarting dsh — the swap happens in the profile patch layer and is evaluated at boot. The card shares one value with dsh-gitbash-shell's card.
- When it cannot run: the plugin does NOT swap — it keeps the official Node backend and prints actionable guidance in the host log.
The persistent-in-memory execution mode (opt-in)
The official PTC runtime supports two execution modes, selected via the executionMode Config field on the ptc-runtime row: 'per-call' (default) | 'persistent-in-memory'. This plugin's composition mirrors the official row set, so both modes are available; see the official reference profile experimental/cua-macos/examples/persistent-ptc.cordis.yml in the dsh repository.
- per-call (default): every
run_codecall gets a fresh scratch pad — the program is torn up as soon as it finishes. - persistent-in-memory: the runtime switches to a REPL channel (
programFormat: 'repl') and state lives on a shared whiteboard — the next call picks up where the last one left off.
Boundaries (official InMemoryExecution semantics): variables and modules persist across calls; re-declaring the same let / const / class name fails; when the session's sandbox is upgraded, in-memory state goes away with the temporary environment. Enable via the ptc-runtime row's Config (or executionMode in a profile patch); it is independent of this plugin's run_code backend switch.
Acknowledgements & license
- The synthesized composition and skill contents derive from the shipped presets of @deepseek-ai/dsh (MIT); skills are copied at runtime from the local installation
- This repository: MIT
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37918
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8650
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5964
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2216
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 2002
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.