@local/dsh-turn-recap
DSH Web UI 中一轮对话结束并暂时没有新消息后生成的简短模型撰写回顾，以及按需使用的 /recap 命令。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:littepointR/dsh-turn-recap#da8a727c306b80d87ad2fd9c352679d6ebf9dce8Turn Recap 以 @local/dsh-turn-recap 发布，当前版本为 1.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A persistent DeepSeek Harness (DSH) plugin that writes a short,
model-generated recap under every completed turn in the Web UI — and regenerates one on demand with /recap.
English | 中文
/recap produces the same card for the latest turn on demand, immediately — useful when a turn never got its quiet
window, when you scrolled past it, or when you want a fresh read of where things stand.The card uses the host's theme tokens, so it follows light/dark and the active locale (English and Simplified Chinese dictionaries ship with the bundle).
>=0.2.1-rc.2 — the runtime this plugin was built and verified against. package.json declares that floor as
engines.dsh, and the launcher enforces it twice: when the bundle is installed, and again when a profile holding it
starts. An older runtime refuses the operation with incompatible-version and names the unmet range.dsh --version.agent/turn-stopping, session projections with a
client-visible wire view, the commands registry (including command/done result text), llm.prepareCall()
streaming, and on the Client side the conversation.chat.turnTail and conversation.chat.commandview slots plus
remote.session.projections. A nearby version that provides all of them will almost certainly work, but only the
declared floor is the combination tested here.No peerDependencies are declared on purpose: this bundle imports no @deepseek-ai/* module — it only resolves Cordis
services at runtime — so a peer range would describe a dependency that does not exist.
If you must run it on an older runtime, the launcher's escape hatch is an exact-version exemption, never a range:
dsh plugin --profile <profile> allow-version '@local/dsh-turn-recap@1.0.1' --dsh-version '<runtime>' --accept-risk
The same grant is available in Plugin Manager. It authorizes in-process code against a runtime it was never verified with — crashes and data loss are the documented risk — and it applies to one exact plugin version on one exact runtime version.
This package is a DSH bundle: it declares dsh.bundle.patch and a dsh.client half, so it installs into a profile with
the launcher's own plugin command. Nothing is published to npm.
# newest commit on the default branch
dsh plugin add github:littepointR/dsh-turn-recap
# or pin the tagged release
dsh plugin add github:littepointR/dsh-turn-recap#v1.0.1
dsh plugin forwards to pnpm inside the profile directory and selects the bundle when the install finishes. With HMR
enabled in the profile's YAML the composition reloads immediately; otherwise the profile picks it up on the next start.
Install into a named profile by passing it through:
dsh plugin --profile <name> add github:littepointR/dsh-turn-recap
The bundle patch adds one Loader row:
- insert:
- id: turn-recap
name: '@local/dsh-turn-recap'
git clone https://github.com/littepointR/dsh-turn-recap.git
dsh plugin --profile <name> add link:D:/path/to/dsh-turn-recap
Or ask a DSH session to install the bundle from that directory with the profile's plugin manager.
Reinstalling or toggling the plugin needs no Harness restart: disable and re-enable the row and the Host module is imported again.
Every key is optional. Add a config block to the Loader row in your profile's cordis.patch.yml — that layer survives
package upgrades.
| Key | Default | Meaning |
|---|---|---|
enabled | true | false unregisters the projection, the turn listener, and /recap |
maxTokens | 200 | Output budget of the recap request |
temperature | 0.2 | Sampling temperature |
timeoutMs | 12000 | Hard bound on one recap request, in milliseconds |
digestChars | 6000 | Size bound of the turn digest sent to the model |
idleMs | 120000 | Quiet window a finished turn must hold before its card may appear; 0 shows it immediately |
skipSubagents | true | Subagent sessions get no automatic recap |
provider, model | unset | Explicit route; by default the turn's own request route is reused |
- insert:
- id: turn-recap
name: '@local/dsh-turn-recap'
config:
maxTokens: 300
skipSubagents: false
agent/turn-stopping ──▶ digest the turn ──▶ model call ──▶ pending map
│
turn/end (committed) ──▶ projection apply ──▶ recap projection ──▶ useProjection("recap")
│
conversation.chat.turnTail
agent/turn-stopping is the serial event the agent loop dispatches just before it commits turn/end. The plugin
digests the turn from the session log — the user request, the newest tool calls (with failures marked), and the
turn's final assistant reply — and asks the model that served the turn for a short recap.turn/end commit folds the text into the client-visible recap session projection, so the
card and the finished turn arrive in the same frame.conversation.chat.turnTail slot and reads the projection with
useProjection("recap"). Each entry carries a revealAt deadline: the card is held back until that instant passes
and no newer turn has started, so the quiet window costs nothing and the card never interrupts active work.What the model is asked for. One plain-text prompt: one to three sentences in the conversation's language, precise
about how far the work actually got (proposed, queued, implemented, tested, published, and installed are
different states), keeping unresolved caveats such as "not installed yet", and treating the latest user message as
scope rather than proof that the work is done. A real next action — and only a real one — rides in on a final Next:
line, which the Host parses into its own field so the card can label and style it.
Why a projection instead of a session event? A plugin may not append new event types: a log carrying a type the
build does not know cannot be reopened, and appendPluginRecord() is reserved for first-party experimental packages.
The session projection is the supported carrier for session-derived client state.
Why is the recap produced before turn/end? Projection state is folded synchronously from committed events and its
Value is only re-read when a committed event changes that state. Producing the text while the turn boundary is still
open is what lets the commitment bake it into state — the delayed appearance is a client-side rule over the stored
revealAt, not a delayed request.
/recap is a plain DSH command: it runs outside any turn, and its result travels in command/done. The Client half
claims the command row through the conversation.chat.commandview slot under the recap key and renders the running,
success, and failure states itself.
/recap names the reason — a timeout, an interruption, a provider refusal with
its code, or an answer that carried no recap text — and the automatic path records the same reason in the projection
instead of staying silent. The request also asks for the route's lowest reasoning effort, so the small output budget
is not spent thinking.turn/end, so a slow provider delays the
boundary by up to timeoutMs. The quiet window delays only what you see, not what you pay.idleMs elapses, that turn gets no card;
/recap is the escape hatch when you want one anyway.stateVersion gates cached wording. Bumping it discards recaps cached under the previous digest rules instead of
serving stale text.Both halves are dependency-free JavaScript: the Host half is plain ESM, the Client half is a module-loader factory that
only asks the page for react.
npm test # Host half under a fake Cordis context — needs nothing but Node
npm run check # syntax-check every JavaScript entry point
The Host tests cover the projection fold, the turn digest, the /recap handler, and the failure paths, so most changes
can be verified without a running Harness.
MIT — see LICENSE.