# @hy-sde-org/dsh-tool-git 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-git/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:21:54.912Z
中文译文更新时间：2026-11-01T09:57:55.922Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40hy-sde-org/dsh-tool-git
原文对照：https://npmcn.com/package/%40hy-sde-org/dsh-tool-git/?lang=original
项目主页：https://github.com/hy-sde/dsh-git#readme
源码仓库：https://github.com/hy-sde/dsh-git

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

- 包体积（解压后）：201 kB，37 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.5，@hy-sde-org/dsh-git ^0\.2\.1-rc\.5，@deepseek-ai/dsh-llm ^0\.2\.1-rc\.5，@deepseek-ai/dsh-tools ^0\.2\.1-rc\.5，@deepseek-ai/dsh-subagent ^0\.2\.1-rc\.5，@deepseek-ai/dsh-system-prompt ^0\.2\.1-rc\.5
- 首次发布：2026-08-26T03:23:23.793Z
- 最新版本发布：2026-11-01T04:21:54.730Z
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

基于主机ctx的面向模型的代理git工具（提交分析+ commit\_apply分割执行，推送时带有P2审查门，审查时带有P0-P3裁决，每个任务工作树签出时带有持久租约）。Git服务-不需要修改组件。

## 安装

```sh
npm install @hy-sde-org/dsh-tool-git
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-git`、`yarn add @hy-sde-org/dsh-tool-git`、`bun add @hy-sde-org/dsh-tool-git`

## README

# @hy-sde-org dsh-tool-git

主机上面向模型的代理git工具 `ctx.git` 服务:

-   **`commit`** -分析当前git的变化并生成一个 常规-提交拆分提案（只读；从不编辑repo）。
-   **`commit_apply`** -执行一个经过验证的拆分提交计划：块感知 分期，锁文件自动放置，拓扑依赖顺序，循环 在任何写、原子预提交执行之前拒绝； `dryRun` 预览。 `--push` 推入当前命名分支（上游记录）并为 只被电流释放的 `review --target staged` 船裁决。
-   **`review`** -将差异分散到并行审稿人子代理，对每个子代理进行排名 自信地找到P0-P3，并汇总出放行/拒收裁决；一个 `staged` 评审记录了被消耗的判决 `commit_apply --push` 门。
-   **`worktree`** - - - - - - `acquire` / `release` / `list` / `prune` / `destroy` 在 具有持久租约的独立git工作树的持久池。池 共享基础设施：永远不要管理不属于自己的插槽——修剪 或者，破坏同级槽会破坏另一个任务的工作。

读取面(`commit` / `review`)通过主机解析 `vcs` 服务时 一个是注册和探测干净，否则降级为 `ctx.git` - - - - - - 未出版的 `@deepseek-ai/dsh-vcs` 从来都不需要。

加上 `git:tools` 系统提示符位置部分。代理平面：安装包 作为预设行(`inject` = tools, systemPrompt, git)并解析主机 `git` 服务;它没有注册自己的服务。

## 安装安装

```bash
dsh plugin --profile web add @hy-sde-org/dsh-git @hy-sde-org/dsh-tool-git
```

复制 `examples/agent-preset/` 来 `~/.dsh/.agent-presets/<id>/` 然后选中它 在Web UI预设选择器中。预设行配置 `reviewProvider: spawn` 和 `maxReviewers: 4`.

## 开发

```bash
pnpm install
pnpm run check   # tsc --noEmit
pnpm run build   # tsc -p tsconfig.build.json → dist/
pnpm run test    # vitest (47 tests: commit/review/worktree/push-gate end-to-end on real temp repos)
```

## 常见问题

### @hy-sde-org/dsh-tool-git 是什么？

基于主机ctx的面向模型的代理git工具（提交分析\+ commit\_apply分割执行，推送时带有P2审查门，审查时带有P0-P3裁决，每个任务工作树签出时带有持久租约）。Git服务-不需要修改组件。

### 如何安装 @hy-sde-org/dsh-tool-git？

在项目目录运行 npm install @hy-sde-org/dsh-tool-git，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.5）、@hy-sde-org/dsh-git（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-llm（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-tools（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-subagent（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-system-prompt（^0\.2\.1-rc\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hy-sde-org/dsh-tool-git 支持 TypeScript 吗？

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

### @hy-sde-org/dsh-tool-git 支持 ESM 还是 CommonJS？

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

### @hy-sde-org/dsh-tool-git 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @hy-sde-org/dsh-tool-git 可以商用吗？

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

### @hy-sde-org/dsh-tool-git 还在维护吗？

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