# dsh-git-plugin

[English](README.md) · 简体中文

<p align="center">
  <img src="./assets/readme/hero.svg" width="100%" alt="Git 工作流进入 DeepSeek Harness 会话：查看改动、新建分支、提交和可恢复快照">
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/dsh-git-plugin"><img src="https://img.shields.io/npm/v/dsh-git-plugin?style=flat-square&amp;color=E76F51" alt="npm version"></a>
  <a href="https://github.com/MashedPotato817/dsh-git-plugin/actions/workflows/ci.yml"><img src="https://github.com/MashedPotato817/dsh-git-plugin/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI on main"></a>
  <a href="https://www.npmjs.com/package/dsh-git-plugin"><img src="https://img.shields.io/npm/dm/dsh-git-plugin?style=flat-square&amp;color=218C74" alt="npm downloads"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-218C74?style=flat-square" alt="MIT license"></a>
</p>

<p align="center">
  <a href="#安装">安装</a> · <a href="#使用">使用</a> · <a href="#文档与反馈">文档与反馈</a>
</p>

## 让 Git 工作流留在 DSH 会话里

查看改动、创建分支、提交前检查、保存可恢复快照。**Web Git 面板 + 5 个斜杠命令 + 4 个模型只读工具**，让你和模型看到同一份仓库状态。

- **看清改动** — 分支、工作区状态、已暂存 / 未暂存 diff 与提交历史。
- **顺手提交** — 创建分支，配置提交前检查，在会话中完成提交。
- **留一份快照** — 用 stash 暂存工作区，随时查看与恢复。

本页对应 **0.4.0**，实测宿主为 **DSH 0.2.0-rc.2**；需要 Node.js ≥20、Git ≥2.32。[完整兼容与验证记录](CONTRIBUTING_ZH.md#兼容性与验证记录)。

## 安装

在需要使用插件的 profile 中执行，将 `web` 替换为实际名称：

```bash
dsh plugin --profile web add dsh-git-plugin@0.4.0
```

安装后自动注册插件。重启对应 profile 的 DSH；使用 Web 时刷新页面。

从手工启用的 0.2.0 升级时，先按[迁移说明](docs/marketplace-submission.md#从手工启用的-020-迁移)调整原配置，避免重复注册。[GitHub 固定 tag 与源码安装](CONTRIBUTING_ZH.md#其他安装方式)。

## Web 侧栏里的 Git

进入仓库工作区／会话，展开右侧栏，点击 **Git**。查看分支／文件状态、已暂存与未暂存 diff，以及提交历史和详情。支持单文件／批量暂存、仅提交暂存区、分支与 stash 管理，以及保留备份后还原文件。每次写操作先预览，再由你明确确认。见[面板指南](docs/web-panel_ZH.md)。

<p align="center">
  <img src="https://raw.githubusercontent.com/MashedPotato817/dsh-git-plugin/main/docs/images/git-actions-dark.png" width="343" alt="独立测试仓库中的真实 DSH Web Git 操作面板">
</p>

## 使用

```text
/status
/diff
/branch feat/my-change
/commit feat: 完成一项修改
```

| 命令 | 用途 |
|---|---|
| `/status` | 查看当前分支与工作区 |
| `/diff` | 查看已暂存、未暂存的改动 |
| `/branch [<name>]` | 查看分支，或新建并切换 |
| `/commit [<message>]` | 查看提交指引，或运行检查并提交 |
| `/undo [list\|pop]` | 创建、列出或恢复 stash 快照 |

模型可以使用 `git-status`、`git-diff`、`git-log`、`git-show` 四个只读工具。例如：

> 先查看 Git 状态、diff 和最近 5 条提交，说明哪些改动已暂存，并指出提交前需要检查的内容。

**提交范围：** Web 提交只包含已暂存内容；`/commit <message>` 会暂存目标仓库的全部改动再提交；执行前确认范围。不带参数只显示指引与改动。

**快照含义：** `/undo` 保存工作区改动（含未跟踪文件），不是回退 commit；`pop` 恢复时可能遇到冲突。

需要提交前跑测试、调大超时？见[插件配置](CONTRIBUTING_ZH.md#插件配置)。

## 文档与反馈

- [贡献指南](CONTRIBUTING_ZH.md) · 配置、源码安装、开发与验证
- [CHANGELOG](CHANGELOG_ZH.md) · 版本变更
- [Issues](https://github.com/MashedPotato817/dsh-git-plugin/issues) · 缺陷与功能建议
- [市场收录准备](docs/marketplace-submission.md) · dsh-market 收录进展
- [Web 面板](docs/web-panel_ZH.md) · 开发版的使用与验收
- [维护指引](AGENTS_ZH.md) · 工程约束

0.4.0 完成 Issue #1 的 Git 操作面板。市场收录状态见上述进展文档。页面设计参考 [dsh-agent-teams](https://github.com/NanmiCoder/dsh-agent-teams)，横幅为原创 SVG。

## License

[MIT](LICENSE)