EasyTZ/dsh-git 预览 preview

EasyTZ/dsh-git

Git panel plugin for DeepSeek Harness (dsh) — visual staging, commits, push and branch switching in the sidebar

Project Overview项目介绍

dsh-git is a third-party plugin for DeepSeek Harness (dsh), distributed as the npm package @easytz/dsh-git under the MIT license, that adds a visual Git panel to the bottom of the dsh sidebar so users can review changes, stage files individually, commit, push, switch branches and inspect recent history without leaving the session. Installation follows dsh's native plugin path: the package ships its own dsh.bundle layer along with a cordis.patch.yml, so running dsh plugin --profile <name> add @easytz/dsh-git installs and registers the plugin in one step with no hand-written patch required; after restarting dsh a new Git button appears at the bottom of the sidebar. Alternatives include installing through the EasyTZ/dsh-market plugin marketplace under Discover, or pinning to @easytz/dsh-git@0.5.6 for reproducibility, and uninstallation uses the matching dsh plugin --profile <name> remove command.

Typical workflow starts by clicking the Git button to open the panel, then picking a target via the top workspace dropdown and, if applicable, a repository dropdown when the workspace root is not itself a repo but its immediate subdirectories are. Users stage files one by one with the + button beside each entry under Changes, type a commit message in the box directly under the branch row and press Commit, then push with Push ↑n, where n is the number of commits ahead of the remote, while the branch dropdown handles branch switching and shows ahead/behind counters. Undo only works on the newest commit and turns red for a three-second arming window: unpushed commits use reset --mixed to bring changes back to the working tree, already-pushed commits use revert to produce an inverse commit. The Recent commits section lists history newest-first with ○ unpushed and ● pushed markers, and clicking a row reveals the full message, changed files and per-file insertion/deletion counts. The panel is aimed at dsh users who prefer staying inside one session rather than switching to a terminal.

Requirements include dsh version 0.1.1-rc.2 or newer, the git binary on PATH, and pnpm available because dsh plugin add shells out to it; the <name> profile argument is mandatory, usually web for the desktop/web profile and tui for the terminal profile, and can be confirmed by listing $DSH_HOME/profiles/. When scanning for nested repositories the plugin only descends one level and skips node_modules, dist, build and dot-prefixed directories to avoid vendored dependencies polluting the list, defaulting to whichever repo's .git was modified most recently. Documented limitations cover undo supporting only the latest commit, rejected pushes not being auto-resolved (the panel instructs the user to run git pull in a terminal), and untracked files needing explicit staging because automatic inclusion is deliberately avoided. The code has no platform-specific branches and was verified on Windows and macOS, with Linux expected to work via the same Git interface. Stars stand at two and the repository is published under MIT.

dsh-git 是面向 DeepSeek Harness(dsh)的第三方插件,通过 npm 包 @easytz/dsh-git 分发,在侧边栏底部新增一个可视化 Git 面板,覆盖查看改动、逐文件暂存、提交、推送、切换分支与浏览最近提交等日常操作。集成方式遵循 dsh 原生插件机制:包内自带 dsh.bundle 层与 cordis.patch.yml,执行 dsh plugin --profile <name> add @easytz/dsh-git 后,安装与激活一次完成,无需手写 patch;重启 dsh 即可在侧边栏底部看到 Git 按钮。也可通过 EasyTZ/dsh-market 插件市场的「发现」搜索安装,或钉死版本号 @easytz/dsh-git@0.5.6 保证可复现。

典型使用流程:点击侧边栏 Git 按钮打开面板,通过顶部「工作区」与「仓库」下拉选择目标仓库;在「变更」列表逐个点 **+** 暂存文件(未跟踪文件不会自动带上)、在提交框填写信息后点「提交」;点「推送 ↑n」把领先远端的提交推上去;用分支下拉切换分支,并通过「最近提交」查看历史,点击单条可看到完整提交信息、改动文件列表及每个文件的增删行数。仅支持撤销最近一次提交,未推送走 reset --mixed,已推送走 revert。适用于习惯在 dsh 会话内完成 Git 流程、避免切换终端或记忆命令的用户,也适合管理多个工作区与嵌套仓库的场景。

依赖与运行条件:需要 dsh >= 0.1.1-rc.2、系统 PATH 中可用的 git 命令,以及作为底层包管理器的 pnpm(dsh plugin add 底层调用 pnpm)。<name> 为必填 profile 名,桌面端通常填 web,TUI 填 tui,不确定可查看 $DSH_HOME/profiles/ 目录。仓库下拉只扫描工作区根的下一层子目录,并跳过 node_modules、dist、build 与点开头的目录,默认停在 .git 最近被修改的仓库。已知限制包括:撤销仅对最新一条提交有效、推送被拒绝时面板不自动处理(需在终端 git pull)、未跟踪文件必须手动暂存。已在 Windows 与 macOS 上验证,Linux 因无平台分支代码共用同一套 Git 接口。许可证为 MIT。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 @easytz/dsh-git

把 EasyTZ/dsh-git 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-git

在 DeepSeek Harness 里完成日常 Git 操作,不离开当前会话。

查看改动 · 逐文件暂存 · 提交与推送 · 切换分支 · 浏览历史

npm dsh plugin platform license

Git 面板:改动、暂存、提交、推送与历史

Visual Git panel for DeepSeek Harness: stage, commit, push, switch branches and inspect history without leaving your session.

中文

前置要求

  • dsh >= 0.1.1-rc.2
  • 机器上装了 git 且在 PATH 里
  • pnpm 可用(dsh plugin 底层转发给 pnpm)

安装

最省事的办法是用插件市场:打开「发现」,搜 dsh-git,点「安装」。

命令行:

dsh plugin --profile <name> add @easytz/dsh-git

<name> 是必填的 profile 名,不能省略——桌面版通常是 web,TUI 是 tui;不确定就看 $DSH_HOME/profiles/ 下的目录名。想钉死版本就写 @easytz/dsh-git@0.5.6。

插件自带 dsh.bundle 层(cordis.patch.yml),dsh plugin add 会同时完成「装进去」和「注册激活」,不需要手写 patch。

装完重启 dsh,侧边栏底部出现 Git 按钮。

用法

点侧边栏底部的 Git 按钮打开面板。

选仓库. 有多个工作区时,顶部「工作区」下拉切换。工作区根目录自己不是仓库、但下面的子目录各自是仓库时,会多出一个「仓库」下拉(见下面「一个工作区装了多个仓库?」)。

提交. 提交框就在分支行下面,是面板里最顺手的位置:

  1. 在「变更」里点文件右边的 + 把要提交的文件暂存;已暂存的点 − 撤回。
  2. 在框里写提交信息。
  3. 点 提交。

未跟踪的新文件不会被自动带上,必须逐个点 + 明确选择——这是刻意设计,避免误提交。

推送. 点 推送 ↑n,n 是本地领先远端的提交数。没有待推送的提交时这个按钮是灰的。

切分支. 分支行的下拉,选一个就切过去。旁边的 ↑n ↓n 是相对上游的领先 / 落后数。

看历史. 「最近提交」按时间倒序列出提交,每条标着 ○ 未推送 / ● 已推送。点任意一条弹出提交详情:完整提交信息、改动了哪些文件、每个文件各增删多少行。底部「展开更早的 n 条」看更多。

撤销最近一次提交. 只有最新那一条右侧有撤销按钮。点一下变红进入二次确认,三秒内再点才真的执行:未推送走 reset --mixed(改动退回工作区,不会丢),已推送走 revert(生成一条反向提交,别忘了推送)。

刷新. 标题栏的刷新图标重新读一遍仓库状态。

卸载

dsh plugin --profile <name> remove @easytz/dsh-git

<name> 与安装时一致。remove 会把包从 profile 依赖里移除,dsh 随后会把它从激活清单(dsh.profile.bundles)里撤掉。重启 dsh 后按钮消失。

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

← 上一个 Prev dsh-thinking-quips 下一个 Next FruitPi →