dsh-git-gui
English ·
简体中文
A Git graphical interface plugin for the DeepSeek Harness Web UI: view, stage, commit, and revert project changes directly in the browser, while seeing every modification the Agent (harness) makes to workspace files in real time.
> Current version: v0.1.2 — Visual operations for viewing changes, committing/reverting, remote synchronization, and more are now available. Branch management, stash, and the AI modification timeline are planned to be completed and released in v0.2.0. See the Roadmap below for details.
Features
- Changes View: Changes are grouped into "Staged / Modified / Untracked / Merge Conflicts". Click to view line-level diffs, stage/unstage changes with one click, and discard changes or delete untracked files with confirmation dialogs.
- File Tree View: Browse all files in the workspace (automatically respecting
.gitignore). File names are color-coded by status — unmodified files use the default text color (black in light mode / white in dark mode), modified but uncommitted files are blue, and untracked files are red. Supports directory collapsing and name filtering. Click an unmodified file to preview its contents directly. - Log View: View commit history (hash / reference badges / author / relative time), with support for reverting individual commits using
revert. - Nested Repository Detection: When the session workspace itself is not a Git repository, the plugin automatically searches subdirectories for a single nested repository and uses it as the operation root (for example, when the repository is located in the
dsh-git-gui/subdirectory of the workspace). If multiple nested repositories are found, the plugin explicitly prompts the user instead of guessing which one to use.
Installation
GitHub Source
dsh plugin --profile web add github:lovetree128/dsh-git-gui
npm Source
dsh plugin --profile web add @amorligno/dsh-git-gui
After installation, restart dsh web and refresh the browser page.
Update
dsh plugin --profile web update @amorligno/dsh-git-gui
Uninstall
dsh plugin --profile web remove @amorligno/dsh-git-gui
Where to start
After installing the plugin, open the DeepSeek Harness Web UI and click the added button in the bottom-left corner to open the sidebar. Then just enjoy the version control.
Structure
Host (Node): GitService (@Remote, namespace `git`, Typert SRC mode → git/* endpoints)
├─ runner.js spawn git (no shell) + per-workspace queue + output limit + error classification
├─ parse.js porcelain v2 / unified diff / log / refs / stash parsing
└─ activity.js session/event → (session, turn, tool, file) timeline (Stage 2)
Client (Browser): sidebar.footer.action entry button (uncommitted-count badge) + shell.overlay floating panel
├─ control.js session cwd synchronization + polling + operation runner + confirmation dialogs
├─ v-*.js view components (React.createElement, no JSX)
└─ styles.js theme tokens (--dsw-alias-*) and styles, adaptive to light/dark mode
Roadmap
| Stage | Content | Status |
|---|---|---|
| v0.1.1 | Changes / file tree / log + commit, stage, discard, revert, Pull/Push/Fetch + Add Remote, dark mode, nested repository detection | ✅ Current version |
| v0.2.0 (unreleased) | Branch management (local/remote lists, switch/create, merge, ahead/behind) | 🔧 In progress |
| v0.2.0 (unreleased) | Stash (push/pop/apply/drop) | 🔧 In progress |
| v0.2.0 (unreleased) | AI modification timeline (session × turn × tool → file attribution view) | 🔧 In progress |
| Future ideas | Reset entry point, file history (git log --), settings card (polling interval / Git path / identity fallback), interactive rebase (PTY) |
💡 To be designed |
Limitations
- When panel operations and Agent edits occur concurrently, Git's own state is treated as authoritative. A warning bar is displayed while the session is running, and operations such as discarding changes require confirmation.
- Untracked file content previews are limited to 512 KiB; diff output is limited to 4 MiB (truncation is marked); the file tree supports a maximum of 3,000 files.
- Credentials rely on existing Git credential helpers (WinCred / SSH agent). Interactive password input is disabled (
GIT_TERMINAL_PROMPT=0) to ensure operations do not hang. - On Windows, if the repository's
.gitdirectory was created by a process running with administrator privileges, tools running with normal privileges, such as PyCharm, need to executegit config --global --add safe.directory ''(Git 2.35+ hijacking protection). - The plugin has not yet been tested on macOS or Linux. Please report any issues you encounter.
