DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

22225555wwwww /

22225555wwwww/dsh-exec-trace

Topic repository only

A visual execution-trace companion plugin for DeepSeek Harness (DSH): per-turn execution bar, native step chapters, right-sidebar trace panel, AI explanations.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@69592ccb

DSH Execution Trace

DSH plugin tests license

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.

执行轨迹:DSH 的每一步,都在对话里

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.

—/ 5

No ratings yet

Manifest verification required

Commit 69592ccbba7e

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout