DSH Execution Trace

A visual execution-trace companion plugin for DeepSeek Harness (DSH). It keeps the agent's work in the conversation — a compact per-turn execution bar, line-free step chapters, and a right-sidebar trace panel for steps, commands, file changes, failures, and AI explanations.

Position: this is an in-flow trace companion, not a replacement for the built-in Trajectory view or native tool cards. It never writes Session events and does not modify the agent loop.

What it looks like

• Per-turn execution bar in chat: status, step/command/file counts, duration, failures, a one-line rule summary, and quick entries for steps / changes / trace / explanation.
• Native step guides: a lightweight, line-free chapter header before each step's native DSH content (current turn by default; current/all/off in settings). No shipped card is replaced.
• Right-sidebar panel with three views:
  • Overview — one rule-based sentence, metrics, failures (click to jump), AI summary.
  • Changes — explicit file writes/edits/deletes aggregated per turn, with +/- stats and inline diff previews; bash-mediated changes are marked as not visible.
  • Timeline — turn/step/entry hierarchy, filters, search, follow/pause, entry details.
• AI explanations with two levels: a one-sentence inline annotation by default, and a detailed overlay on demand. Language follows the UI language (Chinese/English); the model can be followed from the session or chosen in Settings → Explanation model.
• Attention-first visual system: a mind-map-like timeline in the panel, pure-text actions/tabs, no decorative card chrome, no colored rails/pills, and a strict font-size scale.
• Live-safe navigation: follow-latest can be paused by scrolling/selecting; the panel never yanks you back while reading; “back to latest” resumes after a reconnection too.
• Bilingual UI (zh/en) and theme-token-only styling (light/dark aware).

中文简介

「执行轨迹」把 DSH 的每一步放回对话：每轮一条执行条、原生步骤自动分章，右侧提供概览 / 改动 / 时间线，并支持一句话 AI 解释。只读会话、不写日志、不替换原生卡片，中英双语、明暗主题。

Install

This repository builds a local DSH plugin bundle; it is not published to npm.

git clone https://github.com/22225555wwwww/dsh-exec-trace.git
cd dsh-exec-trace
node scripts/build.mjs          # outputs dist/dsh-exec-trace

Then install dist/dsh-exec-trace through your DSH build's plugin/bundle installer, and reload the profile (or restart the app). The plugin identity is @local/dsh-exec-trace; the right-sidebar tab is 执行轨迹.

For a Chinese user guide see docs/交付说明.md; for architecture and design rules see docs/exec-trace-plugin-dev-doc.md.

Build & test

Requirements: Node.js 22+; no npm dependencies are needed for the build or the tests.

node scripts/build.mjs     # deterministic bundle
npm run accept             # build + engine + integration + bundle checks

Current baseline:

• engine / data / UI unit tests: 135/135
• integration harness: 84 pass / 1 known warning
• data-source suite: 18 pass
• bundle-check: 57 pass / 2 review warnings
• both sanitized fixtures: pass

Repository layout

src/host/            Host half: explain HTTP route, prompts (brief/detailed), language, limits
src/client/          Client half: plugin wiring, engine fold, session stream/hub, React UI
dist/dsh-exec-trace  Built bundle (client.js + index.js + locale + icon + manifest)
scripts/build.mjs    Deterministic bundler for __define client modules
test/engine/         Unit tests (engine/data/UI regressions)
test/integration/    Sanitized fixtures and integration checks
assets/              Real screenshots and the 1280×640 social preview
docs/                Design notes, contracts, visual specs, user guide

Privacy & safety

• Reads the Session snapshot only; never writes Session/agent events.
• AI explanation requests are handled by the plugin's Host route through the configured DSH model; no telemetry is added by this plugin.
• The committed fixtures are sanitized session structures; raw local Session logs, personal paths, and chat text are not included.
• The native DSH assistant/tool cards are never replaced.
• The screenshots in assets/ use a synthetic /tmp/dsh-demo session, not a private workspace.

Social preview

GitHub does not expose an API for the social preview image. Upload assets/social-preview.png manually in Settings → Social preview.

License

No license file has been added yet. Add one before reusing the code outside this repository; if you plan to publish, MIT/Apache-2.0 are common choices for DSH plugins.