# @zhangzhian/dsh-devtools-git 中文文档

规范地址：https://npmcn.com/package/%40zhangzhian/dsh-devtools-git/

版本：0\.3\.1
npm 元数据更新时间：2026-11-03T00:20:28.199Z
中文译文更新时间：2026-11-03T00:51:05.230Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40zhangzhian/dsh-devtools-git
原文对照：https://npmcn.com/package/%40zhangzhian/dsh-devtools-git/?lang=original
源码仓库：https://codeup.aliyun.com/67617ae720a07de19c7c1633/dsh-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.6 MB，50 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.4，@deepseek-ai/dsh-fs ^0\.2\.0-rc\.2，@deepseek-ai/dsh-llm ^0\.2\.0-rc\.2，@deepseek-ai/dsh-tools ^0\.2\.0-rc\.2，@deepseek-ai/dsh-session ^0\.2\.0-rc\.2，@deepseek-ai/schemastery ~3\.18\.4，@deepseek-ai/dsh-subprocess ^0\.2\.0-rc\.2，@deepseek-ai/dsh-util-values ^0\.2\.0-rc\.2，@deepseek-ai/dsh-storage-domain ^0\.2\.0-rc\.2，@deepseek-ai/dsh-typert-protocol ^0\.2\.0-rc\.2，@deepseek-ai/dsh-session-projection ^0\.2\.0-rc\.2，@deepseek-ai/dsh-agent-default-model ^0\.2\.0-rc\.2，@deepseek-ai/dsh-api-workspace-files ^0\.2\.0-rc\.2，@deepseek-ai/dsh-api-session-controller ^0\.2\.0-rc\.2
- 首次发布：2026-10-08T06:49:58.640Z
- 最新版本发布：2026-11-03T00:20:28.033Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

dsh-devtools 的 Git 组件：源代码管理面板 + git\_\* 工具

## 安装

```sh
npm install @zhangzhian/dsh-devtools-git
```

也可以使用：`pnpm add @zhangzhian/dsh-devtools-git`、`yarn add @zhangzhian/dsh-devtools-git`、`bun add @zhangzhian/dsh-devtools-git`

## README

[英语](https://npmcn.com/package/%40zhangzhian/dsh-devtools-git/#readme-english) | 简体中文

# @zhangzhian / dsh-devtools-git

中文：DSH **Git**中文名称：中文名称：中文名称：代理人 `git_*` 工具。

![Git 面板：状态分组、提交框、改动列表](https://cdn.jsdelivr.net/npm/@zhangzhian/dsh-devtools@0.3.1/images/git-panel.png)

## 安装

不要单独装它。装清单包 —— 它会作为依赖自动拉下来，并在插件页上给你一个可开关的组件行。

```bash
dsh plugin --profile web add @zhangzhian/dsh-devtools
```

## 提供什么

-   **宿主半**：代理 `git_status`、`git_diff`、`git_stage`、`git_commit`。
-   **客户端半**(1)、(1)、(1)、(1)、(1)、(1)、(1)、(1)、(1)、(1)、(1)、(1)、(1)、(2)、(2)、(3) （平台的 `DiffBlock`，开成以文件名命名、可关闭的页签）、 提交图，以及提交 / 推送 / 拉取 / 抓取 / 合并 / 变基 / 存储的弹窗。
-   **提交默认带上全部改动**：点「提交」会先 `git add -A`（修改 / 已暂存 / 未跟踪）再提交； 只想提交暂存区用菜单里的「只提交已暂存文件」。
-   **推送被拒时自动整合再推**：远端领先导致 `non-fast-forward` 时自动 `fetch` + `pull` （按 `pullMode`，默认合并）+ 重推一次；有冲突就停下并把冲突文件交给你（配置 `pushAutoSync` 可关）。

## 要求

-   近年来 `>= 0.2.0-rc.2`。
-   不需要额外装依赖：`@deepseek-ai/*` 齐刷刷，刷刷刷，刷刷刷，刷刷刷，刷刷刷。

* * *

## 英语

# @zhangzhian / dsh-devtools-git

这个 **Git组件** DSH devtools：在右侧栏有一个源代码控制面板， 加上一组 `git_*` 代理工具。

![Git panel: status groups, commit box, changed files](https://cdn.jsdelivr.net/npm/@zhangzhian/dsh-devtools@0.3.1/images/git-panel.png)

## 安装

不要直接安装此软件包。安装bundle包——它把它作为一个 依赖项，并在插件页面上提供一个可切换的组件行。

```bash
dsh plugin --profile web add @zhangzhian/dsh-devtools
```

## 它提供了什么

-   **主机一半**：代理工具 `git_status`， `git_diff`， `git_stage`， `git_commit`.
-   **客户端一半**：小组-状态组（冲突/上演/未上演/未跟踪）； 每个文件不同于平台 `DiffBlock`（以文件命名的可关闭选项卡打开）， 一个提交图，以及提交/推/拉/对话框 Fetch / merge / rebase / stash。
-   **默认情况下，Commit接受所有更改**：单击Commit运行 `git add -A` （修改/上演/未追踪）第一；在菜单中使用“只提交阶段性文件” 只提交索引。
-   **拒绝推送时自动集成**:在 `non-fast-forward`，它运行 `fetch` + `pull` (每 `pullMode`（默认合并）+重试一次push； 冲突在Pull处停止并交还给你(`pushAutoSync` 可以关闭这个)。

## 要求

-   近年来 `>= 0.2.0-rc.2`.
-   没有额外的依赖： `@deepseek-ai/*` 是由DSH安装本身提供的 （声明为对等依赖项，因此不会第二次安装）。

## 常见问题

### @zhangzhian/dsh-devtools-git 是什么？

dsh-devtools 的 Git 组件：源代码管理面板 \+ git\_\* 工具

### 如何安装 @zhangzhian/dsh-devtools-git？

在项目目录运行 npm install @zhangzhian/dsh-devtools-git，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.4）、@deepseek-ai/dsh-fs（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-llm（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-tools（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-session（^0\.2\.0-rc\.2）、@deepseek-ai/schemastery（~3\.18\.4）、@deepseek-ai/dsh-subprocess（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-util-values（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-storage-domain（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-typert-protocol（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-session-projection（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-agent-default-model（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-api-workspace-files（^0\.2\.0-rc\.2）、@deepseek-ai/dsh-api-session-controller（^0\.2\.0-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @zhangzhian/dsh-devtools-git 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @zhangzhian/dsh-devtools-git 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @zhangzhian/dsh-devtools-git 可以商用吗？

@zhangzhian/dsh-devtools-git 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @zhangzhian/dsh-devtools-git 还在维护吗？

最新版本 0\.3\.1 发布于 2026/11/03（今天）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。