Foreword

In DSH sessions, the agent continuously edits, writes, or deletes files. For developers, the key is not just “whether results were generated,” but being able to see exactly which files were modified in each round, the line-level differences, and whether changes can be quickly undone or reapplied.

dsh-file-review-tab addresses this specific aspect: it integrates the file change review capabilities of left0ver/dsh-file-review into the dsh-better-sidebar sidebar while preserving the review line at the end of the conversation.

What This Is

Lzh3070/dsh-file-review-tab is a DSH web plugin licensed under MIT.

It provides two entry points:

  • Conversation End Review Line: Quickly view file changes from the current round after a turn concludes.
  • “File Review” Tab in dsh-better-sidebar Sidebar: Expand file changes, line-level diffs, and undo operations organized by round.

Core Features

Conversation End Review Line

After a turn concludes, a review line appears at the end of the conversation showing “Edited N files +M −K / Undo / Review”.

Clicking “Review” or a specific file name opens a deep link to the sidebar’s “File Review” tab, automatically expanding the diff for that file and scrolling to the top of that round’s group.

The sidebar tab lists files changed in the current session, grouped by round.

After clicking an entry, it expands to show line-level red/green diffs. The plugin supports:

  • Undoing the entire round
  • Undoing changes to a single file
  • Reapplying changes

The tab badge displays the count of changed files in real-time.

Deleted Files Visibility

The plugin parses literal path arguments from commands like rm, rmdir, unlink, Remove-Item, del, rd, etc.

Deleted files are displayed with a “[Deleted]” marker. These files do not have line-level diffs and cannot be undone.

Deletes involving wildcards or command substitution are not recognized.

Auto-Archiving

The main list retains only the most recent 5 rounds.

Earlier completed rounds are collapsed into an “Archived N Rounds” section. Expanding this section loads 10 rounds per page. Deep links can automatically expand and scroll to the target round.

PTC / Code Mode Support

The plugin captures edit / write sub-calls within run_code.

The host side saves before/after snapshots, and the browser side reconstructs line-numbered line-level hunks for review in that round. Behavior in standard mode remains unchanged; the conversation end review line only covers standard mode rounds.

Session Isolation and UI Adaptation

Each session only views its own changes. State polling is paused when the tab is not visible.

In workbench split-screen (half-width) or floating window modes, round headers automatically wrap, yielding space to secondary information while preserving undo actions and file names.

Styles use CSS Modules and host --dsw-alias-* theme tokens.

Installation and Setup

Prerequisites:

  • DeepSeek Harness web ≥ 0.1.0-rc.5, compatible with the 0.1.2-alpha series.
  • dsh-better-sidebar ≥ 0.12.0.

Run the installation command:

dsh plugin --profile web add dsh-file-review-tab

After installation, restart dsh web, then open “File Review” from the “+” menu in the dsh-better-sidebar sidebar.

Typical Usage

  1. When a conversation ends, click “Review” or a file name on the review line at the end. After the sidebar tab opens, it expands the diff for the corresponding file and scrolls to the top of that round’s group.

  2. In the tab, expand file diffs by round to inspect changes. If you need to revert, you can execute “Undo Round,” “Undo Single File,” or “Reapply.”

  3. If a file was deleted, the entry displays a “[Deleted]” marker. Here, you can only confirm which files were deleted; line-level diffs or undo operations are not provided.

  4. In long sessions, earlier completed rounds move into the “Archived N Rounds” collapsed section. Expanding this section loads 10 rounds per page, or you can use deep links to automatically open and scroll to the target round.

Use Cases and Considerations

This is suitable for developers who frequently review agent file changes in the DSH web workflow, especially those already using dsh-better-sidebar in their projects. It consolidates viewing diffs, undoing changes, and navigating rounds into the sidebar, complementing the conversation end entry point.

Before use, please note:

  • The plugin runs with the permissions of the current dsh process; review the source code and license before installation.
  • The license is MIT. The core diff renderer and undo service are ported from left0ver/dsh-file-review (MIT License, © ZhangWenChao).
  • Sidebar integration is based on the ctx.betterSidebar registration API provided by dsh-better-sidebar.
  • Deletes involving wildcards or command substitution are not recognized.
  • The peerDependencies content in package.json is truncated in the materials and cannot be fully confirmed; dependency resolution depends on the actual installation environment.

Conclusion

The value of dsh-file-review-tab lies in consolidating file change reviews from scattered conversation feedback into an expandable, undoable, and navigable sidebar view, while preserving the quick entry point at the end of the conversation.

You can find the dsh-file-review-tab page in the DSH plugin directory; the GitHub repository is:

https://github.com/Lzh3070/dsh-file-review-tab