dsh-subagent-fork-lite
进程内 DeepSeek Harness 子代理提供程序，仅将父级最近 N 个已完成回合注入子级（fork-lite），不影响官方 fork。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:aleskxyz/dsh-subagent-fork-lite#57262a04a61baefd52ba6e51313cc7ab309a53b9Subagent Fork Lite 以 dsh-subagent-fork-lite 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
In-process DeepSeek Harness subagent provider that seeds each child with a bounded window of the parent’s completed conversation — the last N finished turns — instead of the entire transcript.
Registered by default as fork-lite on ctx.subagents.
| Harness tag | npm package line | Typecheck | Unit tests | Notes |
|---|---|---|---|---|
dsh-v0.1.2-rc.1 | 0.1.2-rc.1 | pass | pass | sourceEventSeqs remapping uses a version-safe read |
dsh-v0.1.5-rc.2 | 0.1.5-rc.2 | pass | pass | Primary dev/CI pin |
dsh-v0.1.6-alpha.1 | 0.1.6-alpha.1 | pass | pass | session.snapshotEvents() deprecated but still used (same as stock fork) |
No native harness seed-window API exists on these lines — this plugin remains the bounded-seed provider.
maxCompletedTurns)turn/endseq is contiguous from 0 (including remapped sourceEventSeqs)agentOptionsinheritsParentContext: true when a seed is usedproviderName / maxCompletedTurns values# git channel (latest main)
dsh plugin --profile web add "github:aleskxyz/dsh-subagent-fork-lite#main"
# or from npm (when published)
dsh plugin --profile web add dsh-subagent-fork-lite
# restart the profile, then verify the row
dsh --profile web --dump-config | grep -A6 'id: subagent-fork-lite'
Start a child with provider name fork-lite (see Usage).
main): dsh plugin --profile web add "github:aleskxyz/dsh-subagent-fork-lite#main" — the package prepare script builds with production dependencies; approve esbuild (and any other keys the CLI prints) if install stops on ERR_PNPM_IGNORED_BUILDS.dsh plugin --profile web add dsh-subagent-fork-lite.pnpm pack in this repo, then dsh plugin --profile web add ./dsh-subagent-fork-lite-<version>.tgz.dsh plugin --profile web remove dsh-subagent-fork-lite (or remove the row from the profile patch).Or insert the package into your profile patch (see cordis.patch.yml).
All tunables are Schemastery Config fields (changeable from cordis.yml). An id-targeted override replaces the whole config row — restate every key you need.
| Field | Default | Meaning |
|---|---|---|
providerName | fork-lite | Name registered on ctx.subagents |
maxCompletedTurns | 2 | Number of completed parent turns to seed; 0 seeds nothing |
- insert:
- id: subagent-fork-lite
name: dsh-subagent-fork-lite
config:
providerName: fork-lite
maxCompletedTurns: 2
Seed size is fixed per mounted instance. For different windows, mount more than one row:
- insert:
- id: subagent-fork-lite-2
name: dsh-subagent-fork-lite
config:
providerName: fork-lite-2
maxCompletedTurns: 2
- id: subagent-fork-lite-5
name: dsh-subagent-fork-lite
config:
providerName: fork-lite-5
maxCompletedTurns: 5
Then start with the provider name you need.
const run = await ctx.subagents.start('fork-lite', {
parent,
prompt: [{ type: 'text', text: 'Your task for the child…' }],
signal,
// optional per-start route overrides:
agentOptions: { provider: 'deepseek-official', model: '…' },
// optional: toolFilter, persona, outputSchema, maxDepth, label
})
const result = await run.result
await run.dispose()
Omit agentOptions to inherit the parent’s LLM provider and model.
| Surface | Kind | Notes |
|---|---|---|
fork-lite (configurable) | subagent provider | Registered on ctx.subagents; used via subagents.start(providerName, …) |
cordis.patch.yml | bundle patch | Default insert row for profile install |
No commands, session projections, or client UI.
turn/end (completed-turn prefix).maxCompletedTurns of those turns.seq values to 0…k so the child session accepts the seed.prompt.The child then runs in its own session. Later parent turns are not shared live — the seed is a one-time snapshot at start.
Within the kept turns, the child receives the parent’s logged events (user/assistant messages, tool calls/results, turn markers, and other events in that window). Surface history derived from those events is what the model sees.
| Capability | Supported |
|---|---|
agentOptions | yes |
outputSchema | yes |
depthLimit | yes |
toolFilter | yes |
persona | yes |
Continuable prep (prepareContinuable) | yes (seed captured once at creation) |
start() call. Use multiple mounted provider names for discrete budgets.sourceEventSeqs point outside the window cannot be renumbered and will fail seed construction.0.1.6-alpha.1+, synchronous session.snapshotEvents() is deprecated; this provider still uses it (same deferred migration as stock fork).agent/pre-step); callers that need isolation must filter those themselves.Apache-2.0