@zhaolianghz/dsh-turnscope
为 DeepSeek Harness 编码会话提供按轮次的安全检查、变更归因、安全回退和隔离重试。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zhaolianghz/dsh-turnscope#1cf284a65cd489e82f44563e8c9c45e0ade678e6Turnscope 以 @zhaolianghz/dsh-turnscope 发布，当前版本为 0.1.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Understand every agent turn. Rewind safely. Retry without losing good work.
dsh-turnscope is a DeepSeek Harness plugin for developers who use agents to change code. The 0.1.0 release ships a native, read-only turn timeline with per-file diffs and deterministic warnings, plus preview-first safe rewind (the Preview / Apply buttons in the turns panel). Forked retries remain planned for V0.3. The 0.1.1 / 0.1.2 / 0.1.3 / 0.1.4 / 0.1.5 patches refine renderer behavior (see Changelog below).
Status: V0.1.5 published (
@zhaolianghz/dsh-turnscope@0.1.5) for DSH0.1.6-alpha.1(the plugin's bundled client code consumes the runtime types shipped in0.1.1-rc.2, which are forward-compatible with the actualChatSnapshotshape0.1.6-alpha.1exposes via theuseChathook). V0.2 (preview-first safe rewind) is shipping in the same build; the API_VERSION is4(since 0.1.1). The 0.1.1 / 0.1.2 / 0.1.3 / 0.1.4 / 0.1.5 patches refine renderer behavior without bumpingAPI_VERSION. Forked retries remain planned for V0.3.
Chat data source fix. The V0.1 → V0.1.4 renderer was reading chat nodes / turn timings / turn ends through useSession((s) => s.nodes.filter(...)) etc., but DSH 0.1.6-alpha.1's SessionSnapshot no longer carries those fields — the chat builder output lives behind a separate useChat hook that returns a ChatSnapshot (with legacy.{nodes, turnTimings, turnEnds}). The renderer now reads from useChat() (and only openState continues to come from useSession). Renderer-only fix; no API_VERSION bump, no host changes, no DB migration. 599 tests (599 → 599, fixtures rebuilt around ChatSnapshot), typecheck clean.
Crash fix. The 0.1.3 renderer crashed DSH's conversation.view slot whenever the useSession selector received a snapshot whose nodes field was not yet populated — a normal first-render case in this DSH build, where getSnapshot() can return undefined or a stub before the first real emission. The selector now treats a missing nodes / turnTimings / turnEnds as "no data" and returns an empty list; the openState reader does the same. The V0.1.3 bootstrap-context filter is unchanged. Renderer-only fix; no API_VERSION bump. 599 tests (598 → 599, +1), typecheck clean, client bundle 78.42 kB.
DSH records a session's startup burst — the instructions, catalog, and recall the harness injects before the first user prompt — as context conversation nodes. The renderer now drops those pre-prompt context events from the turn activity list, so a fresh session's turn 1 and turn 2 cards no longer show Context/Context/Context rows. Mid-session context injections (seq ≥ first user/assistant seq) are unaffected; a session that has not yet received any user message keeps the entries, since there is no signal to distinguish bootstrap from "the user is composing their first prompt". Renderer-only fix; no API_VERSION bump. 598 tests (595 → 598, +3), typecheck clean, client bundle 78.21 kB (+0.32).
The detail page's change list now groups inherited baseline-dirty paths under a labelled 本轮开始时已脏 (N) divider, so a reader opening the detail to see what the agent did this turn no longer has to scroll past the inherited worktree state. The per-row 本轮开始时已脏 badge is unchanged. Renderer-only fix; no API_VERSION bump, no DB migration, no worktree write. 595 tests (593 → 595, +2), typecheck clean.
Baseline-dirty clarity. The per-turn "Changed files" count was summing the agent's edits with paths the worktree was already dirty with at session start, so any session whose worktree wasn't clean on open reported the same misleading 76-file headline on every turn. The fix splits the wire-shape into agentChangeCount + baselineChangeCount (additive, API_VERSION 4), the turn card shows the agent count with a muted +N 本轮开始时已脏 chip when the baseline number is non-zero, and the detail header does the same. The per-file 本轮开始时已脏 badge is unchanged. 593 tests, typecheck clean, client bundle 77.09 kB.
First published release. Ships V0.1 (turn timeline + diffs + warnings) and V0.2 (preview-first safe rewind) in one bundle — the rewind feature needs the same recovery_before / recovery_after checkpoint phase that V0.1 already allocates, and the only safe moment to publish a real rewind is when the worktree-state drift guard is verified end-to-end against a real Git repository.
Highlights:
conversation.view integration; turn timeline with running / completed / failed / output-limit statesgit.blobAt(HEAD) bytes compared against the live file, not just a hash)recovery_before and recovery_after checkpoint phases captured around the apply; a future rewind-the-rewind can compare against either0o600), no telemetry, no git reset --hard, no branch rewriteCoding agents can touch many files and run many commands in a single turn. When a turn goes wrong, users need clear answers:
Turnscope is designed around those questions.
conversation.view integrationTurnscope will never run git reset --hard, rewrite the user's branch, or silently overwrite a workspace that has drifted since a checkpoint. When safe rewind cannot be proven, the plugin must refuse the operation and offer inspection or isolated fork instead.
0.1.6-alpha.1 installation (the plugin's bundled client code consumes the runtime types shipped in 0.1.1-rc.2, which are forward-compatible with the ChatSnapshot shape 0.1.6-alpha.1 exposes via the useChat hook)corepack enable
pnpm install
pnpm build
pnpm test
pnpm typecheck
The build emits the host entry, the browser handoff bundle expected by DSH's window.__ModuleLoader__, and TypeScript declarations under lib/.
Build Turnscope first. From a local DSH 0.1.6-alpha.1 source checkout, add it as a development dependency of the web profile:
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-turnscope
Start DSH Web. pnpm dsh plugin add already inserts the plugin into the
web profile's bundle layer; do not also pass the bundled
examples/cordis.patch.yml to --patch, or the loader will see a
duplicate turnscope id and refuse to boot. The patch overlay is
only needed when linking turnscope into a profile that does not have
the bundle layer (rare; documented for completeness):
pnpm dsh --profile web
Verified on 0.1.6-alpha.1: the home page serves with turnscope in the
boot manifest (/plugins/@zhaolianghz/dsh-turnscope/client.js), and
the client bundle exports previewRewind, listTurns,
RecoverySection, and the other DTOs.
Open a session and select the Turns / 轮次 conversation tab. Because this package is not published yet, there is intentionally no npm installation command.
The first release targets Git-backed coding projects in DSH Web. Non-Git workspaces receive timeline and inspection features, but not rewind or fork guarantees.
dsh-turnscope 是一个面向 DSH 编程用户的开发者工具插件。V0.1 在 DSH 0.1.1-rc.2 上提供只读轮次时间线和文件差异；V0.2 增加 preview-first 安全回退（轮次 面板中的 Preview / Apply 按钮）；分叉重试仍在后续计划中。0.1.1 补丁修复了会话启动时工作区已脏导致的"变更文件"误报（详见下方 Changelog）。
首版坚持本地优先、默认无遥测，并且绝不通过重置分支或覆盖 Git 历史来实现回退。
MIT