lhh010/dsh-file-trace

dsh-file-trace is a native half-plugin for the DeepSeek Harness (DSH) Web client that tracks every file read, write, and edit performed by the model during a conversation, surfacing them through a "文件追踪" (File Trace) button injected into the session title bar via the conversation.session.header.utilities slot. Its compatibility is explicitly pinned to dsh-v0.1.2-alpha.1 ~ dsh-v0.2.0-rc.2, with the current release #v0.3.23 declaring support up to dsh-v0.2.0-rc.2 and gating updates through a root-level compatibility.json mapping each plugin tag to the exact DSH versions it has been verified against. Installation is performed with dsh plugin --profile web add '@dsh-external/dsh-file-trace@github:lhh010/dsh-file-trace#v0.3.23' (or a local link: path for development), followed by appending a - insert: id: dsh-file-trace block to $DSH_HOME/profiles/web/cordis.patch.yml; the patch hot-reloads without restarting DSH, but a hard browser refresh (Ctrl/Cmd+Shift+R) is required after the first install.

Typical workflow: clicking the title-bar button opens a draggable, resizable floating window whose list is grouped by file path and sorted newest-first, each entry carrying running/error markers and a timestamp plus payload size; selecting a read entry shows the actual file contents with real line numbers (Markdown files gain a "阅读 / 原文" toggle that switches into Obsidian-style rendering with lazily-loaded Mermaid diagrams and KaTeX math), selecting a write entry renders either a full all-green addition or a genuine del/add diff, and selecting an edit entry reconstructs the file using earlier in-window reads/writes of the same path, retaining ±3 lines of context around each hunk and folding unchanged runs of ≥3 lines. Dragging the window to the right edge snaps it into a full-height right rail that auto-shifts the main conversation pane aside, and the window's position, size, font scale, and redaction toggle all persist in localStorage.

Limits, dependencies, and first-run caveats: the plugin makes zero changes to DSH core and derives all data from views.get('chat').legacy snapshots, so it only covers operations visible in the currently loaded chat window and auto-catches up as the user scrolls and pages; diffing is line-level LCS with intra-line character highlighting, syntax colouring is regex-based without a parse tree, and editing reconstruction falls back to the model's old_string/new_string fragment when no earlier in-window read/write of that file exists. The redaction layer (sensitive paths such as .env, *secret*, *credential*, *token*, *api-key*, plus content patterns like api_key:, Bearer , sk-, AKIA, and PEM headers) is a display-only convenience for screenshots and sharing — it never touches the on-disk session log. Mermaid nodes whose unquoted labels happen to contain a redacted secret will fail to parse and fall back to source code, which is avoided by always quoting node labels. pnpm 11 may block node-pty build scripts on first install, requiring pnpm approve-builds --all inside ~/.dsh/profiles/web before re-running the install command. The licence is BSD-3-Clause, and no plugin release exists for DSH 0.1.1-rc.2 or older.