dsh-compact-and-branch
DSH /compact-and-branch 命令：将内容规范压缩到一个全新的延续会话中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zeropointnine/dsh-compact-and-branch#27a79ee635c4a5d2ff69b006eff65a8bc761345cCompact And Branch 以 dsh-compact-and-branch 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
/compact-and-branchA focused out-of-tree DeepSeek Harness plugin for treating canonical context compaction as a clean session branch point.
Long-running coding-agent sessions can accumulate a great deal of useful
working context before reaching a natural phase boundary. DSH's /compact
command is useful for reducing that history while preserving the state needed
to continue, but sometimes it is preferable to make that compaction a clean
branch point: continue from the resulting state in a fresh session while
leaving the compacted source session independently resumable.
This is especially useful with relatively limited context windows, as is common with local LLMs, where long agent trajectories can otherwise require repeated compactions and make session boundaries more consequential.
/compact-and-branch is intended to have essentially the same model-facing
effect as running /compact and continuing normally in the original session,
except that the continuation occurs in a new root session. It deliberately
reuses DSH's canonical compaction result rather than introducing a separate
handoff summary or another lossy transformation of the session state.
/compact-and-branch:
modelSelection projection, falling back to the
latest request header and then the deployment default)./compact:
ctx.compaction.compactNow(invocation.agent, invocation.signal, invocation.commandId).source.session.deriveMessages(). This is
the canonical checkpoint message plus the complete retained recent tail;
the plugin never reads or rewrites CompactionResult.summary.sessionController.create API,
with the source workspace, active preset, and no parentSession fork
lineage, then inherits the model route via sessionController.selectModel,
which durably records a model/selection event for the next request.ctx.sessions.open(targetId) API.Built-in /compact is not registered, shadowed, or modified.
dsh plugin is a thin pnpm forwarder: it runs pnpm inside your profile
directory and then reconciles the profile's dsh.profile.bundles stack for
you, so no hand-editing of any config file is needed. Install the plugin
from GitHub:
dsh plugin --profile web add git+https://github.com/zeropointnine/dsh-compact-and-branch
# or pin a release tag
dsh plugin --profile web add github:zeropointnine/dsh-compact-and-branch#v0.3.0
A first dsh plugin run in a profile initializes it automatically. The
profile's package.json gains the dependency, and DSH appends
dsh-compact-and-branch to dsh.profile.bundles on its own (it detects the
package's dsh.bundle declaration). This package has no build or install
scripts, so git-hosted installs need no allowBuilds entry in the profile's
pnpm-workspace.yaml.
After adding, restarting, updating, or removing the plugin, restart DSH. To
remove it later: dsh plugin --profile web remove dsh-compact-and-branch.
This release (0.3.x) targets DSH ^0.1.5-rc.2 and is a clean break from
the 0.1.1 line. DSH 0.1.5 removed the entire Host API-Proxy surface this
plugin's host half was built on (ctx.apiProxy.* moved onto owning business
services, notably ctx.sessionController) and retired the
@deepseek-ai/dsh-client-runtime package the browser half injected, so a
single package cannot serve both lines: the peer sets are disjoint. Users on
DSH 0.1.1-rc.x should pin #v0.2.0.
Within a line the plugin is deliberately resilient where it can be: unknown
ManualCompactionError codes fail open to a raw error instead of a misleading
message, and the DSH surfaces it rides (the compaction seam, the session event
vocabulary, the projection registry) have been stable across releases. Three
documented internal reliances remain and are guarded loudly at runtime: the
idle turn-cursor advance on the created Agent (agent.phase became the public
field after setPhase went private), the maxTokens carry-over onto the
target AgentOptions, and the filtering of system-role messages out of the
imported continuation (DSH 0.1.5 added the system-prompt projection to
deriveMessages(); the fresh session rebuilds its own system context, so the
source's is dropped rather than duplicated). A DSH update that breaks any of
these degrades to a visible initialization error, never silent history
corruption.
Presentation-side, the client half rides three 0.1.5 wire shapes that are
contracts of the DSH client packages rather than this plugin: the session-list
row's projectionValues field (where the navigation projection's view value
arrives — misnamed reads here fail as "no navigation", silently), the
agentPreset session-projection value on the host list summary (0.1.5 moved it
off the summary field; the handoff reads it through the projections so preset
inheritance survives), and the command card's collapsed-summary rendering rule
(one line is clamped; multi-line text becomes an expandable body, which is why
every outcome text this plugin emits is deliberately two lines).
In any session, type:
/compact-and-branch
No arguments. The current session is compacted through DSH's canonical
/compact machinery, then a fresh root session is created in the same
workspace and preset with the same model selection, carrying the compacted
context; DSH opens it in the browser. The compacted source session stays
independently resumable. The command card and the fresh session both render
the compaction summary through DSH's own MarkdownText renderer — the same
fully-formatted, in-document-flow presentation /compact uses — via the
conversation.chat.commandview and conversation.chat.turnTail UI slots. In
the fresh session, the imported history is collapsed behind a native DSH
notice row, leaving only live conversation visible plus the formatted
summary card at the end of the imported turn. On shells without the
react/@deepseek-ai/dsh-client-ui-primitives module seed words or the
slots service, the plugin falls back to the native bounded context row for
the imported checkpoint.
pnpm install # installs the @deepseek-ai/* peer copies and zod
pnpm test # node --test
The tests load host-side classes (Session, ManualCompactionError, message
creators) from a separate module instance than the plugin's own imports, to
exercise the cross-package error-classification boundary. They resolve that
instance from the DSH_HOME environment variable (point it at a DSH
checkout's node_modules/@deepseek-ai directory, or the checkout root) and
fall back to the package's own pnpm-installed peer copies; if neither is
available, those tests skip with a hint instead of failing.