Wongzexu/dsh-git-status

Name: Wongzexu/dsh-git-status
Author: Wongzexu

Plugin插件 Native原生 ⭐ 3 MIT Subagents & Orchestration子代理与编排 Dev Workflow开发与代码工作流

DSH 的 Git 状态（Git Graph）插件：提交有向无环图泳道图 + 未提交更改/暂存 + 内联差异 + 分支操作。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native web plugin built exclusively for DeepSeek Harness (DSH), that adds a floating interactive Git status panel to the right edge of the DSH web interface. It renders a visual commit DAG lane graph to show Git history, supports viewing unstaged changes, stashed content, inline code diffs, and enables all common Git operations directly from the panel. There are three installation methods available: the recommended official npm release via the DSH plugin CLI, pulling the latest source code directly from GitHub, or installing from a local directory for custom development or personal use.

This plugin is designed for developers who use DSH Web for daily development and regularly work with local Git repositories. It replaces DSH’s basic default Git status display with more powerful visualization and interactive functionality that streamlines all common daily Git tasks. After opening a DSH Web session connected to a working local Git repository, the floating panel automatically displays the current repository’s up-to-date Git status, so developers can complete all routine Git operations right inside DSH without needing to switch back and forth to the terminal command line.

The only hard requirements to run this plugin are a working running instance of DSH Web and a system-level installation of the Git command line tool, which the plugin uses to execute all Git operations. It has no third-party dependencies on React or external build chains, making it lightweight and easy to maintain, and is released under the permissive MIT open source license. It includes multiple security features like CSRF protection, path traversal prevention, and secondary confirmation prompts for dangerous destructive operations, which helps prevent accidental irreversible user data loss.

这是一款专为DeepSeek Harness（DSH）Web端开发的原生Git状态插件，可在DSH网页右侧添加可交互的Git状态浮窗，可视化展示Git提交DAG泳道图，支持查看未提交改动、暂存内容、行内差异详情，提供完整的常用Git分支操作能力，支持通过npm、GitHub源码或本地目录三种方式安装。

面向日常使用DSH Web进行开发并需要管理Git仓库的开发者，可替代基础原生Git状态展示，提供更丰富的可视化和交互能力。典型工作流为打开DSH Web后，右侧浮窗自动展示当前仓库的Git状态，开发者可直接在浮窗内完成提交、分支切换、合并变基、暂存贮藏等所有常用Git操作，无需切换到命令行。

该插件仅依赖已安装运行的DSH Web端和系统Git命令行工具，无第三方React或构建链依赖，遵循MIT开源许可协议。插件内置CSRF防护、路径越界防护，危险操作会二次确认，避免误操作导致数据丢失。首次使用会弹出引导提示气泡，位置会自动记忆，关闭后下次可从悬浮按钮重新打开。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-git-status（Wongzexu/dsh-git-status）
仓库：https://github.com/Wongzexu/dsh-git-status
本站详情页：https://www.yhbd.top/plugins/wongzexu-dsh-git-status/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-08-26 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

Only 3 stars - very few users, little community feedback星标只有 3，几乎没人在用，遇到问题缺少社区反馈

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add @wongzexu/dsh-git-status

把 Wongzexu/dsh-git-status 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

18.3 KB · 缓存于 2026-08-26 14:41:57 · 18.3 KB

@wongzexu/dsh-git-status

English · 简体中文

独立 Git 状态（Git Graph）插件：DSH Web 右缘 Git 状态浮窗 —— commit DAG 泳道图 + 未提交改动/stash + 行内详情 diff + 分支操作。

🔖 v1.0.0 · 🧩 纯前端自渲染 DOM（greeter 模式，零 React、零构建链）· 🛠 Node half 只读/写路由 · 📜 MIT · 📦 npm @wongzexu/dsh-git-status

功能

浮窗交互：面板可拖拽、位置自动记忆；右上角悬浮开关按钮（与面板角重合、拖拽跟随、关闭后原位悬浮重开）；首次使用引导提示气泡（仅一次，localStorage 记录）
commit DAG 泳道图：第一父链成线、列分配贪心最左、泳道复用、合并提交连线；网格制 SVG 渲染（shadow + 彩色双 path、折角过渡、HEAD 加粗圆点）
行内 refs 徽标：H（红，游离 HEAD）/ 分支（金）/ 远程（蓝）/ 标签（绿）；当前 checkout 分支 pill 亮金高亮（背景加浓 + 金色内描边 + 加粗，悬停提示「当前分支」）；同名本地/远程分支合并为一个 pill：⎇ main [gitee]；同一分支有 ≥2 个远程时折叠为计数子标签 ⎇ main [2]（悬停 pill 任意处即显示完整远程引用列表，右键先选远程再操作）；远程 HEAD 符号引用（gitee/HEAD）默认过滤
未提交改动虚拟行：工作区有改动时图顶部插入虚拟行（空心圆 + 灰色虚线连 HEAD），分类显示未暂存/已暂存处数；点击展开按「更改 / 暂存的更改」分组的详情（VS Code 语义：部分暂存文件两组各出现一次，未跟踪文件带徽标）
暂存与提交：右键未提交改动虚拟行可「暂存全部改动」（git add -A）、「贮藏未提交改动」、「放弃全部未提交」（git reset --hard HEAD + git clean -fd，含未跟踪文件，保留被忽略文件；红色确认框二次确认，不可恢复）、提交已暂存内容或修订上一条提交；普通提交只包含已暂存内容，多行提交信息使用 Ctrl+Enter（macOS Cmd+Enter）提交
stash 显示：git reflog refs/stash 插入图中（双层圆 + stash@{n} 徽标），展开详情（base 显式两树 diff + untracked 第三父快照追加）
行内展开详情：点击 commit 行 → 展开提交信息 + 变更文件（+/- 行数）+ 逐文件 diff （256KB 截断）；详情盒高度自适应内容（≤340px 上限），点开 patch 不引起图跳动
分支操作：
- 右键本地分支徽标：切换到 x / 合并 x 到当前分支… / 重命名 x… / 删除 x… / 强制删除 x…（未合并二次确认）
- 「合并 x 到当前分支…」弹二级确认框，合并方式三选一： 合并提交（默认）（可快进则快进，分叉时生成合并提交）/ NoFF（禁用快进） （--no-ff 始终生成合并提交）/ Squash 合并（压平为一个提交，无合并提交）； Squash 提供提交信息输入 +「使用固定文案」勾选（默认勾选，取消后必填），合并产生冲突后由合并条接管（squash 无 MERGE_HEAD，中止走 reset --hard、继续走 commit 收尾）
- 右键远程分支徽标：「创建本地分支 x 并检出」/「删除远程分支 x…」（远程已删时自动降级清理本地跟踪引用）；本地已有同名分支时弹三选：检出已有分支并快进到远程最新 / 其他名称从远程创建（自动建上游跟踪）/ 取消（对齐上游 checkoutBranchAction；快进为 git merge --ff-only，分叉/领先时拒绝且分支不动）；折叠计数徽标右键先选远程、再出该远程的操作菜单；右键 tag 徽标：「在 x 创建分支…」/「推送 tag…」（每远程一项，跳确认框）/ 「删除 tag…」（仅本地 / 全部远程一次删净 / 逐远程定向；远程无该 tag 视为已删，部分失败不阻断本地删除并给明细）；右键 commit 行「创建 tag…」（轻量/附注 + 多远程推送）/ 「在 x 新建分支并检出…」（以该提交为起点）
- 历史操作（/git/history 路由，镜像上游 dataSource 的 rebase/reset/cherry-pick/revert/pull）：
  - 右键 commit 行（目标以短 hash 显示）：Cherry-pick…（合并提交需选主父提交，可勾 -x 记录来源 / -n 仅应用到暂存区）、Revert…（合并提交默认主父 1）、 Rebase current branch on this Commit…、Reset current branch to this Commit… （Soft / Mixed / Hard 三选，Hard 为红色确认钮）
  - 右键本地分支「Rebase current branch on {branch}…」（非当前分支时）； rebase 仅非交互 + 红色危险确认（重写历史）
  - 右键远程分支「Pull & merge {branch} into current branch…」（并入远程分支菜单、紧邻「创建本地分支并检出」；--no-rebase 强制合并语义，模式三选默认/NoFF/Squash，冲突走现有合并分类由合并条接管）
  - Reset 祖先守卫：目标不在当前分支历史（非祖先）→ 服务端拒绝 reset-not-ancestor，客户端弹红色确认框后带 force 重发（同切换守卫旁路模式）；分支独有提交仅可从 reflog 找回
  - 冲突分类：rebase-conflicts / cherry-pick-conflicts / revert-conflicts（本期只做失败分类提示，头部徽标显示进行中；abort/continue 放下期与合并条统一）
- 头部「＋新分支」对话框：客户端即时校验 + 服务端 check-ref-format 权威校验双保险
- 切换守卫：未解决冲突 / 进行中操作（MERGE_HEAD 等标记）/ 目标分支在其他 worktree 检出 → 稳定错误码；存在已跟踪未提交改动时弹「仍然切换」确认框（确认后带 force 旁路；仅未跟踪文件不拦）
- 合并冲突后：头部徽标 + 合并条提供「中止合并 / 继续合并」（解决冲突后 git add 再继续）； squash 合并冲突同样由合并条接管（徽标显示「Squash 合并进行中」）
从远程拉取：头部「⇣」按钮（仓库有 remote 才显示），一键 git fetch --all （镜像上游工具栏 Fetch from Remote(s) 形态：无对话框、prune 默认关），无论成败图都即时刷新（多远程可能部分成功）；失败分类提示（网络/认证错误、远程不存在、远程仓库不存在或不可达）
推送分支：右键本地分支「推送到远程…」（镜像上游 Push Branch 对话框）—— remote 单选（默认 origin/首个）+ Set Upstream + Push Mode 三选一（normal / force-with-lease / force）；失败保留对话框可改模式重试
stash 操作：右键 stash 徽标「应用 / 弹出 / 从 stash 创建分支并检出 / 删除（确认框）」；右键未提交改动虚拟行「贮藏未提交改动」（说明 + 包含未跟踪文件）；应用冲突（合并冲突 / 本地改动被覆盖）分类提示且 stash 保留
冲突/进行中状态徽标：头部实时显示「N 个未解决冲突」「合并/rebase 进行中」（MERGE_HEAD / SQUASH_MSG（squash 合并）等标记）
SSE 即时刷新：/git/events 订阅（2s 服务端状态键对比 + 变化推送 + 15s 心跳），其他终端 checkout/提交时图即时刷新；10s 轮询保留作断连兜底
范围切换：所有分支 / 当前分支；自动刷新 + 手动刷新；非 git 仓库提示
设置页：默认行为（创建分支后自动检出 / 贮藏时包含未跟踪文件 / 默认合并方式 / 删除本地分支时同步删除远程，统一下拉选择）与显示选项（未提交改动、HEAD 徽标、提交作者、提交时间，可独立显隐）

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 Wongzexu/dsh-git-status 的 README.md。在 GitHub 查看原文 →