dsh-generation
分叉代理预设，并在下一代平台上运行任务。是 Make，不是编译器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:goecho/dsh-generation#778c5c2f5d57779e2d2e51f5f367d9c9584acd20Generation 以 dsh-generation 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A DeepSeek Harness plugin that forks agent presets and runs a task on the next generation.
It is make, not a compiler. Creator mode is already the compiler: it can inspect the runtime, edit files, and author presets. This plugin only records a lineage — copy a known-good preset, let the meta agent edit that copy with ordinary fs / bash, then start a new working session on it.
Compatible with DeepSeek Harness 0.1.5+ (dsh-v0.1.5-rc.2 and current master, session format v3). It needs Session.snapshotEvents(), async ctx.agents.create({ sessionId, parentAgent, meta, signal, setup }), Host-global ctx.tools.register, and dsh.bundle.patch. The shipped coding preset is ptc (formerly code). Do not add @deepseek-ai/* to this package — a second copy of those modules crashes tool dispatch.
dsh plugin --profile web add github:goecho/dsh-generation
Then restart dsh --profile web so the host profile reloads. Pin a SHA from the commit history after you have read the source. The package is plain JavaScript, so git installs do not need a prepare build allowlist. Plugin 0.3.0 is the line that forks ptc instead of code and passes parentAgent so workers are runtime children.
Then open a Creator mode (cordis) session — or a copy of that preset whose composition still has a plugin row name: '@deepseek-ai/dsh-tool-cordis'.
dsh plugin add installs into the host profile, so the two tools are registered globally. This plugin then hides them from every non-Creator session (including user copies of standard / minimal / ptc) and from every agent with origin: subagent, including the workers generation_run starts. Execute still refuses a non-Creator caller.
This repository already has the dsh-plugin, dsh, and deepseek-harness GitHub topics.
DeepSeek Harness splits composition into a Host plane (sandbox, model route, persistence) and an Agent plane (tools, persona, prompt). A session’s preset is locked once a turn has run, so you cannot hot-swap the working agent’s toolset without stranding logged tool calls.
The useful bootstrap is the same as a C compiler: each generation is a new binary. Stage N writes files for stage N+1; you do not patch the process that is currently compiling.
cordis preset) or cordis_define / cordis_run@deepseek-ai/dsh-tools / @deepseek-ai/dsh-llm. Tools are registered as raw definitions so a second copy of those packages cannot split the host’s module identity.Four rules:
SessionEvent types, no unlocking agent-preset-locked.generation_run uses agents.create + agentPresets.mount(id), never recompose on the meta session and never composeFrom (in-process children inherit the parent preset).agent.cordis.yml. Editing uses tools the creator preset already has.fork and run go through tools/pre-execute ask. Nothing is promoted to the default creator automatically. Lineage is the meta session log (tool/call / tool/result), not a second database.meta session (cordis + this plugin)
→ generation_fork copy a preset to a new id
→ fs / bash edit the copy (not this plugin)
→ generation_run new agent, mount that id, run the task, dispose
→ summary back into the meta log
→ fork again or stop
Working generations should fork from standard, minimal, or ptc.
| Tool | Does | Does not |
|---|---|---|
generation_fork | agentPresets.copy(from, id); writes purpose into the new preset.yml description; returns id and directory | Accept composition YAML (authoring stays copy-only); overwrite an existing id |
generation_run | After approval, create an agent, mount the preset, followup(task), wait until idle, cancel, or a 15-minute timeout, return sessionId, stopReason, tool names used, last assistant text, then dispose | Run Creator mode as the worker; inherit the meta toolset; leave a half-created agent on failure |
generation_fork| Argument | Required | Meaning |
|---|---|---|
from | yes | Preset id to copy. Prefer standard, minimal, or ptc. |
id | yes | New preset id (/^[a-z0-9][a-z0-9-]*$/). Must not already exist. |
purpose | yes | One sentence written into the new preset.yml description. |
Returns { ok, id, from, purpose, path, compositionPath } where path is the preset directory.
generation_run| Argument | Required | Meaning |
|---|---|---|
preset | yes | Preset id to mount on the new working session. Must not be cordis. |
task | yes | Self-contained follow-up for the worker. It does not see meta history. |
Refuses a worker whose composition still has a plugin row name: '@deepseek-ai/dsh-tool-cordis'. Inherits the meta session’s workspace cwd, records origin: subagent and parentSession so logs chain, sets parentAgent so the worker is a runtime child (not a scheduled root), and passes the parent tool AbortSignal into agents.create so cancelling the meta tool also aborts worker creation. It does not dump the full worker transcript into the meta context. Worker logs are read with snapshotEvents(). If the worker never goes idle, it is cancelled after 15 minutes (stopReason: "timeout"). Domain failures keep { ok: false } but render as ERROR: so the model notices.
Returns { ok, sessionId, presetId, stopReason, toolsUsed, lastAssistantText }.
Treat a Creator session that can fork and run generations as shell access. Mitigation in v1:
cordis, and cannot still carry a @deepseek-ai/dsh-tool-cordis plugin rowcordis_runnpm test
There are no @deepseek-ai/* runtime dependencies. The tests mock ctx.tools / ctx.agentPresets / ctx.agents. GitHub Actions runs the same npm test on Node 22.