前言¶
DSH 的插件机制允许把扩展能力接入 Web UI。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，也不等同于官方应用商店。对于使用 Agent 修改工作区文件的流程来说，直接在浏览器里查看 Git 变更、执行 stage、commit、revert，比来回切终端更直接。dsh-git-gui 是一个 Git 图形化界面插件：它可以在浏览器中查看、暂存、提交和回退项目变更，并让使用者实时看到 Agent（harness）对工作区文件的修改。
下面介绍它的定位、核心能力、安装方式和注意事项。
定位¶
lovetree128/dsh-git-gui 是面向 DeepSeek Harness Web UI 的浏览器侧插件。它主要解决三个问题：
- 在浏览器中查看工作区文件的状态、行级 diff 和提交历史。
- 对变更执行 stage、unstage、commit、revert 等常见 Git 操作。
- 在 Agent 修改文件时，提供一个与 Web UI 同侧的操作入口。
该插件使用 MIT 许可证。
核心功能¶
变更视图¶
- 将变更分为 Staged、Modified、Untracked、Merge Conflicts 四类。
- 查看行级 diff。
- 支持 stage / unstage。
- 丢弃修改或删除未跟踪文件时，需要确认。
文件树视图¶
- 浏览工作区文件，并遵循
.gitignore。 - 按状态对文件进行颜色区分。
- 支持目录折叠和按名称过滤。
- 可以预览未修改文件的内容。
提交记录视图¶
- 查看提交历史。
- 支持对单个提交执行
revert。
嵌套仓库检测¶
- 当会话工作区不是 Git 仓库时，插件会查找唯一的嵌套仓库，并将其作为操作根目录。
- 如果检测到多个嵌套仓库，插件会提示用户选择，而不是自动猜测。
远程同步与深色模式¶
- 提供远程同步能力。
- 支持深色模式。
安装与启用¶
可以从 GitHub 安装：
dsh plugin --profile web add github:lovetree128/dsh-git-gui
也可以从 npm 安装：
dsh plugin --profile web add @amorligno/dsh-git-gui
安装完成后，重启 dsh web，并刷新浏览器页面。
更新与卸载¶
更新：
dsh plugin --profile web update @amorligno/dsh-git-gui
卸载：
dsh plugin --profile web remove @amorligno/dsh-git-gui
典型用法¶
1、打开 DeepSeek Harness Web UI。
2、点击左下角新增的按钮，打开侧边栏。
3、在侧边栏中查看变更、文件树和提交记录。
4、需要时执行 stage、commit、revert，或确认丢弃变更。
适用场景与注意¶
适合在 DSH Web UI 中同时查看 Agent 工作区和 Git 状态的使用者。使用前注意：
- 插件以当前
dsh进程权限运行，安装前建议检查源码并确认 MIT 许可证。 - npm 包名
@amorligno/dsh-git-gui与 GitHub ownerlovetree128不一致；资料未确认两者关系，安装前请自行核对来源。 - 当面板操作和 Agent 编辑同时发生时，以 Git 自身状态为准。
- 会话运行时会显示警告条；丢弃修改等操作需要确认。
- 未跟踪文件内容预览上限为 512 KiB；diff 输出上限为 4 MiB；文件树最多支持 3,000 个文件。
- 凭据依赖现有 Git credential helpers；交互输入密码被禁用，
GIT_TERMINAL_PROMPT=0。 - Windows 上，如果
.git目录由管理员权限创建，普通权限工具可能需要执行：
git config --global --add safe.directory '<path>'
- 该插件尚未在 macOS 或 Linux 上测试。
- 资料中出现的 branch、stash、merge 等描述，本文不视为当前已核实能力。
链接¶
- 社区目录：https://www.skillhub.cn/plugins/lovetree128/dsh-git-gui
- GitHub：https://github.com/lovetree128/dsh-git-gui
