让开源，少一点语言距离。
npm包中文文档

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

中文文档
0.2.1-rc.5发布于 2026/11/01MITTypeScriptES Module

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

中文使用文档
中文原文

@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 服务;它没有注册自己的服务。

安装安装

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.

开发

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 共发布 10 个版本，首次发布于 2026/08/26；过去 12 个月发布了 10 个版本。

版本发布日期距今
0.2.1-rc.5latest2026/11/012 天前
0.2.1-rc.32026/10/259 天前
0.2.1-alpha.42026/10/1618 天前
0.2.1-alpha.22026/10/1321 天前
0.2.0-rc.22026/10/031 个月前
0.1.7-rc.22026/09/291 个月前

关于 @hy-sde-org/dsh-tool-git 的常见问题

@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 和提交记录判断。