# 🧑💻 easy-git
**新手友好的 Git 助手** —— 一条命令安装，选择要用的 agent，自动装好
[](https://raw.githubusercontent.com/easysir10/easy-git/main/)
[](https://raw.githubusercontent.com/easysir10/easy-git/main/)
[](https://raw.githubusercontent.com/easysir10/easy-git/main/)
🌐 [简体中文](https://github.com/easysir10/easy-git/blob/main/README.md) · [English](https://github.com/easysir10/easy-git/blob/main/README.en.md)
easy-git 让 git 对新手友好：你不需要会任何命令行命令，兼容 GitLab / GitHub / Gitee 等一切 git 托管平台。
安装只有一条命令，要装到哪些 agent（包含 DSH）由你在菜单里勾选。
🚀 安装
npx -y github:easysir10/easy-git运行即弹出选择菜单（↑↓ 移动 · 空格 勾选 · 回车 确认），选完自动装好；以后想重选，再运行一次即可：
🎯 选择要安装的 agent（↑↓ 移动 · 空格 勾选 · 回车 确认 · a 全选 · q 取消）
➜ ☐ 1. DSH 插件（DeepSeek Harness）
☐ 2. Codex（skill + /easy-git 斜杠命令）
☐ 3. Claude Code（skill + /easy-git 斜杠命令）
☐ 4. Cursor（rules + /easy-git 斜杠命令）
☐ 5. Qoder（skill + /easy-git 斜杠命令）
☐ 6. QoderCN（skill + /easy-git 斜杠命令）
☑ 7. 通用 AGENTS.md（Gemini CLI / OpenCode / Zed / Trae 等）
（回车确认，自动安装；也可按数字切换勾选）让 agent 自己装：把仓库地址
https://github.com/easysir10/easy-git告诉任意 agent，让它执行上面的命令即可。其他安装方式：网络慢用 tarball 直链
npx -y https://codeload.github.com/easysir10/easy-git/tar.gz/refs/heads/main；想常驻为命令npm install -g https://codeload.github.com/easysir10/easy-git/tar.gz/refs/heads/main；非交互环境（CI）自动跳过菜单，之后运行easy-git install或首次运行easy-git再选。
装完在哪里怎么用
| 你在哪用 | 装完怎么用 | 详情 |
|---|---|---|
| 🟦 DSH（DeepSeek Harness） | 对助手说"提交 / 拉取 / 推送 / 解决冲突 / 看下 git 现状" | install-dsh.md |
| 🟠 Codex / Claude Code | 输入 /easy-git 描述（skill 也会自动生效） |
use-skill.md |
| 🟪 Cursor / Qoder / QoderCN | 输入 /easy-git 描述（rules / skill 也会自动生效） |
use-skill.md |
🎯 核心亮点
- 🧭 首次自动引导：选平台 → 设身份 → 初始化/克隆，一步步带你
- 🛡️ 防呆设计：冲突未解决禁止提交/推送；合并进行中自动识别；技术报错不外露
- 🌐 平台定制：GitHub / GitLab / Gitee 各自的新建仓库、克隆链接、令牌步骤
- ✂️ 零路径零命令：不用填文件夹路径，专业词出现必解释
📚 文档
| 文档 | 说明 |
|---|---|
| install-dsh.md | 🟦 DSH 插件：用法（11 个工具）与更新 |
| use-skill.md | 🧩 其他 agent：Codex / Claude Code / Cursor / Qoder / QoderCN |
| development.md | 🛠️ 开发指南：结构 / 约定 / 测试 / 发布 |
| CHANGELOG.md | 📋 更新日志 |
| skills/README.md | 🧩 Skill 目录与说明 |
| AGENTS.md | 🤖 通用 agent 引导（进仓库即生效） |
❓ 常见问题
我不会命令行，能用吗？
完全能。安装也只要一条命令（复制粘贴即可），之后你只需要：说话、做选择、贴链接、点网页按钮。装完想换/补装 agent 怎么办？
运行 `easy-git install` 重新勾选，或 `easy-git install all` 全部安装。📄 License
MIT