@dsh-xhl/dsh-git-gui 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lovetree128
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# `dsh-git-gui`
+
+<p align="center">
+  <a href="./README.md">English</a> ·
+  <a href="./docs/README.zh-CN.md">简体中文</a>
+</p>
+
+<p align="center">
+  <img alt="Version 0.1.2" src="https://img.shields.io/badge/version-0.1.2-blue">
+  <img alt="DeepSeek Harness rc.6" src="https://img.shields.io/badge/dsh-0.1.0--rc.6-skyblue">
+  <img alt="MIT License" src="https://img.shields.io/badge/license-MIT-green">
+</p>
+
+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](#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
+
+```powershell
+dsh plugin --profile web add github:wojiaoxiaomayun/dsh-git-gui
+```
+
+### npm Source
+
+```powershell
+dsh plugin --profile web add @dsh-xhl/dsh-git-gui
+```
+
+After installation, restart `dsh web` and refresh the browser page.
+
+## Update
+
+```powershell
+dsh plugin --profile web update @dsh-xhl/dsh-git-gui
+```
+
+## Uninstall
+
+```powershell
+dsh plugin --profile web remove @dsh-xhl/dsh-git-gui
+```
+
+## Troubleshooting
+
+**The Git panel is stuck on "Detecting repository…"?**
+
+This is a known issue when the plugin is installed as a `link:` symlink (e.g. `dsh plugin --profile <name> add <local path>`): the host half resolves `@deepseek-ai/*` from the plugin repo's own `node_modules` instead of the DSH runtime's copies, so the `git/*` endpoint registration is invisible to the gateway.
+
+Use the official install methods instead (a real install automatically links the host's packages):
+
+```powershell
+dsh plugin --profile web add github:wojiaoxiaomayun/dsh-git-gui
+# or
+dsh plugin --profile web add @dsh-xhl/dsh-git-gui
+```
+
+To mimic a real install locally, pack a tarball and install that (**do not** add a local directory):
+
+```powershell
+npm pack
+dsh plugin --profile web add .\dsh-xhl-dsh-git-gui-0.1.3.tgz
+```
+
+If you do want a `link:` dev loop, run `scripts/link-host-deps.ps1` after every `npm install` / `pnpm install`, then fully restart DSH.
+
+## 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
+
+```text
+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 -- <path>`), 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 `.git` directory was created by a process running with administrator privileges, tools running with normal privileges, such as PyCharm, need to execute `git config --global --add safe.directory '<path>'` (Git 2.35+ hijacking protection).
+- The plugin has not yet been tested on macOS or Linux. Please report any issues you encounter.

package/cordis.patch.example.yml

@@ -0,0 +1,6 @@
+# 手动安装时追加到 $DSH_HOME/profiles/web/cordis.patch.yml(用户补丁层)
+# 每行 id 用于后续覆盖/禁用;host 行与客户端图在 dsh web 重启后生效。
+# 注意:bundle 安装(dsh plugin add)不需要这一行 —— 补丁层会自动注册。
+- insert:
+    - id: git-gui
+      name: '@dsh-xhl/dsh-git-gui'

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# @dsh-xhl/dsh-git-gui bundle 补丁层。
+#
+# 当本包出现在 profile 的 dsh.profile.bundles 中时(经
+# `dsh plugin --profile <name> add @dsh-xhl/dsh-git-gui` 由 pnpm 安装后自动对账加入),
+# dsh 启动时会把本补丁叠到配置树上,下面的 insert 行即注册该插件。
+# 未走 dsh plugin 安装(例如 npm --prefix 直接装)时,本层不会被应用,此时由
+# postinstall 钩子把同一行写入 profile 的 cordis.patch.yml 兜底。
+- insert:
+    - id: git-gui
+      name: '@dsh-xhl/dsh-git-gui'

package/lib/activity.js

@@ -0,0 +1,140 @@
+/**
+ * Activity tracker: attributes filesystem mutations made by the agent to
+ * (session, turn, tool) tuples by listening to the session event log.
+ *
+ * Only the native fs tools (`write`, `edit`) carry exact paths. Shell
+ * mutations (bash) cannot be attributed reliably and are intentionally left
+ * out — the git status view is the ground truth for those, and the tracker
+ * exists to answer "which session/turn touched which file".
+ */
+
+import path from 'node:path'
+
+const MAX_ENTRIES = 400
+const MAX_ENTRIES_PER_CWD = 200
+
+export class ActivityTracker {
+  /** @type {Map<string, Array<object>>} key = normalized cwd */
+  entries = new Map()
+  /** @type {Map<string, object>} pending tool/call by callId */
+  pending = new Map()
+
+  constructor(ctx) {
+    this.ctx = ctx
+    // `global: true` so the root-level listener also sees events emitted on
+    // per-session isolate contexts (every session's tool calls).
+    const dispose = ctx.on('session/event', (session, event) => this.onEvent(session, event), { global: true })
+    this.dispose = dispose
+  }
+
+  onEvent(session, event) {
+    if (event === null || typeof event !== 'object') return
+    if (event.type === 'tool/call') {
+      this.onToolCall(session, event)
+    } else if (event.type === 'tool/result') {
+      this.onToolResult(event)
+    }
+  }
+
+  onToolCall(session, event) {
+    const { name, callId, turn } = event
+    if (name !== 'write' && name !== 'edit') return
+    let args = null
+    try {
+      args = JSON.parse(event.arguments ?? '{}')
+    } catch {
+      return
+    }
+    if (args === null || typeof args !== 'object') return
+    const filePath = typeof args.file_path === 'string' ? args.file_path : undefined
+    if (!filePath) return
+    const cwd = this.sessionCwd(session)
+    this.pending.set(callId, {
+      sessionId: this.sessionId(session),
+      turn,
+      tool: name,
+      filePath,
+      cwd,
+      at: Date.now(),
+    })
+  }
+
+  onToolResult(event) {
+    const callId = event.callId
+    if (callId === undefined) return
+    const pending = this.pending.get(callId)
+    if (pending === undefined) return
+    this.pending.delete(callId)
+    if (event.error !== undefined && event.error !== null) return
+    const entry = {
+      ...pending,
+      path: this.resolvePath(pending.filePath, pending.cwd),
+      error: false,
+    }
+    delete entry.filePath
+    if (pending.cwd) {
+      const key = normalizeCwd(pending.cwd)
+      const list = this.entries.get(key) ?? []
+      list.push(entry)
+      if (list.length > MAX_ENTRIES_PER_CWD) list.splice(0, list.length - MAX_ENTRIES_PER_CWD)
+      this.entries.set(key, list)
+    }
+    // global cap across workspaces
+    let total = 0
+    for (const list of this.entries.values()) total += list.length
+    if (total > MAX_ENTRIES) {
+      for (const [key, list] of this.entries) {
+        const overflow = total - MAX_ENTRIES
+        if (overflow <= 0) break
+        const drop = Math.min(list.length, overflow)
+        list.splice(0, drop)
+        total -= drop
+        if (list.length === 0) this.entries.delete(key)
+      }
+    }
+  }
+
+  sessionId(session) {
+    return typeof session?.id === 'string' ? session.id : 'unknown'
+  }
+
+  sessionCwd(session) {
+    const cwd = session?.header?.cwd
+    return typeof cwd === 'string' && cwd !== '' ? cwd : undefined
+  }
+
+  resolvePath(filePath, cwd) {
+    if (cwd && !path.isAbsolute(filePath)) return path.join(cwd, filePath)
+    return filePath
+  }
+
+  /**
+   * Timeline entries for one workspace (most recent first).
+   * @param {string} cwd
+   * @param {number} limit
+   * @returns {Array<object>}
+   */
+  list(cwd, limit = 100) {
+    const list = this.entries.get(normalizeCwd(cwd)) ?? []
+    const capped = Math.max(1, Math.min(Number(limit) || 100, 200))
+    return [...list].reverse().slice(0, capped).map((e) => ({
+      sessionId: e.sessionId,
+      turn: e.turn,
+      tool: e.tool,
+      path: e.path,
+      at: e.at,
+    }))
+  }
+
+  dispose() {
+    this.dispose?.()
+  }
+}
+
+function normalizeCwd(cwd) {
+  try {
+    return path.resolve(cwd).toLowerCase()
+  } catch {
+    return String(cwd).toLowerCase()
+  }
+}