前言¶
在 DeepSeek Harness Web 中和 Agent 处理代码任务时，Git 操作常常还要切回终端：查看状态、确认 diff、暂存文件、提交、切换分支，再核对 Agent 是否理解正确。DSH Git Plugin 把这些动作放进 Web 工作台：一边查看仓库状态和提交历史，一边执行常用 Git 操作，或者审查 Agent 生成的分步骤命令提议。
这是什么¶
DSH Git Plugin 是面向 DeepSeek Harness Web 的可视化 Git 工作台，由 IT-coder-Yy 维护，仓库名为 IT-coder-Yy/dsh-git-plugin。它用于查看仓库状态与提交记录、快捷执行常用 Git 操作，并安全运行自然语言生成的分步骤命令提议。
已核实的安装命令使用包名 dsh-easygit-plugin，许可证为 MIT。
最后验证信息：2026-08-20，DeepSeek Harness 0.1.0-rc.8，dsh-easygit-plugin 0.2.3。
核心功能¶
下面介绍已核实的能力。
查看仓库状态¶
可以看到当前分支、已暂存与未暂存文件，以及格式化 review 视图或 raw diff。
查看提交历史与详情¶
可以查看提交图、message、author、timestamps、parents、changed files、statistics、full diff。
执行常用 Git 操作¶
支持 stage/unstage 单个或多个文件、创建 commit，以及创建、搜索、切换、安全删除本地分支。
远程同步与 rebase¶
支持查看 upstream、ahead/behind、工作树状态；执行 fetch、fast-forward pull、push、为分支设置 upstream，或安全开始、继续、中止 rebase。
查看分支与 tags¶
可以查看本地分支、远程分支和 tags。
自然语言生成命令提议¶
可以把自然语言请求转换为分步骤 Git 命令提议，可直接执行，也可以复制后手动执行。
失败处理¶
失败时保留失败命令、输出与仓库诊断；对识别失败提供安全恢复提议，或交给 Agent 分析复杂失败。
默认安全¶
包括 allowlist 校验、高风险操作确认、防止提议重放，以及从诊断中隐藏常见凭据。
安装与启用¶
先为 Web profile 添加插件：
dsh plugin --profile web add dsh-easygit-plugin
然后启动 DSH Web：
dsh web
使用前提是：需要 Node.js ^22.19.0 || >=24.0.0、Git，以及支持静态 Cordis 插件的 DeepSeek Harness developer preview release。
典型用法¶
1、在 DSH Web 的 composer 旁边使用 Git 按钮，查看变更、审查提交历史、stage 文件、提交变更、管理分支，或与远程同步。
2、对 Agent 提出 Git 操作。例如：
Commit the documentation update to the current branch with the message "docs: update guide"
生成的是分步骤命令提议，可以直接执行，也可以复制手动执行。
3、涉及 rebase 或强制删除分支时，需要明确风险确认。
适用场景与注意¶
这个插件适合在可信仓库和可信 Git 配置中使用，尤其是需要在 DSH Web 中查看状态、执行常规 Git 操作，或审查 Agent 提议的场景。
使用前注意：
- 插件随当前 DSH 进程运行，执行 Git 命令时会遵循 DeepSeek Harness 提供的 Shell 与 sandbox 策略。
- 每一步必须恰好包含一个允许的 git 子命令。
- Shell 控制符、命令替换、重定向、可执行 hooks 和不安全 Git 选项会被拒绝。
- 高风险操作，包括历史重写，需要明确确认，且提议只能执行一次。
- 诊断中会隐藏常见凭据。
- 安装前应检查源码与
MIT许可证；安全漏洞需按SECURITY.md私下报告。
结尾¶
DSH Git Plugin 的价值在于把“看状态、做操作、审 Agent 提议”放在同一个 Web 工作台里，并给自然语言生成的 Git 命令加上了确认和执行限制。
GitHub：https://github.com/IT-coder-Yy/dsh-git-plugin
目录页：如从社区目录安装，请以目录页实际给出的插件条目和安装命令为准。
