tool-skills/my-git-bash/SKILL.md

---
name: install-my-git-bash
description: "在 Windows Git Bash 上安装 xnng/my-git-bash 终端美化与工具集（mintty 主题、git 提示符、tmux、tree、Powerline 字体、alias）。当用户说装机、新机器初始化 Git Bash、安装/配置 my-git-bash、恢复终端配置、美化 Git Bash、装 tmux/tree/Powerline 字体时使用。严格按既定偏好执行：绝不整体覆盖 .bash_profile/.gitconfig 而是增量合并、unicode 箭头 ➜ 改 ASCII ->、备份后再覆盖系统文件、检测并跳过已装工具。"
---

# 安装 my-git-bash（Git Bash 美化与工具集）

把 `https://github.com/xnng/my-git-bash` 这套 Git Bash 配置装到本机：mintty 主题、git 提示符、tmux、tree、Powerline 字体、alias。**重点是按用户偏好安全地安装，绝不破坏用户已有的个人配置。**

## ⚠️ 核心原则（必须遵守，不可省略）

这五条是用户明确要求的工作方式，违反任何一条都算事故：

1. **永不整体覆盖用户的 dotfiles。** 禁止 `cp .bash_profile ~`、`cp .gitconfig ~` 这类整文件覆盖。`.bash_profile` 要**增量追加**（带日期标记段落，可整段删除）；`.gitconfig` **完全不碰**（里面有用户真实提交身份和代理，覆盖会让 commit 变成别人、还可能注入无效代理）。
2. **unicode 符号改 ASCII。** 仓库 `git-prompt.sh` 的提示符箭头 `➜`（U+279C）在 GBK 终端会乱码/报错，必须改成 `->`。同理避免 `→ │ ╔ ▶` 等。
3. **覆盖系统文件前先备份。** `/etc/profile.d/git-prompt.sh` 等系统文件被覆盖前，先 `cp` 一份 `.bak`。
4. **检测后跳过已装工具。** 装前先 `command -v` 检测；wget 系统通常自带 → 跳过 `tools/wget.exe`，不要覆盖。
5. **增量改动加可识别标记。** 追加内容用 `# --- 以下增量来自 my-git-bash (YYYY-MM-DD) ---` … `# --- end my-git-bash ---` 包裹，方便日后识别/删除。

关联记忆：`feedback-dotfiles-incremental-encoding`、`user-iflytek-embedded-dev`。

## 第 0 步：预检（先跑，结果决定后续）

```bash
whoami                                            # 确认身份
touch /usr/bin/.wt 2>/dev/null && echo "管理员OK" && rm -f /usr/bin/.wt || echo "非管理员：系统目录操作需重开管理员 Git Bash"
for t in tmux wget tree winpty code git; do printf "%-8s " $t; command -v $t || echo 未装; done
git --version
```

同时**必须读**用户现有配置，判断冲突：

- `cat ~/.bash_profile 2>/dev/null` —— 看已有哪些 alias/函数（尤其 git 快捷键、`tree`、GBK 转码等），增量时跳过已有的。
- `cat ~/.gitconfig 2>/dev/null` —— 确认用户身份，**只读不改**。
- `ls ~/.minttyrc ~/.tmux.conf 2>/dev/null` —— 不存在才能直接装。

## 第 1 步：克隆仓库

```bash
git clone https://github.com/xnng/my-git-bash   # 国内不畅可换 gitee: https://gitee.com/xnng/bash.git
cd my-git-bash
```

## 第 2 步：备份系统 git-prompt.sh

```bash
cp /etc/profile.d/git-prompt.sh /etc/profile.d/git-prompt.sh.bak
```

## 第 3 步：安装 Powerline 字体（管理员）

```bash
cp "fonts/DejaVu Sans Mono for Powerline.ttf" /c/Windows/Fonts/
MSYS_NO_PATHCONV=1 reg add "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts" \
  /v "DejaVu Sans Mono for Powerline (TrueType)" /t REG_SZ \
  /d "DejaVu Sans Mono for Powerline.ttf" /f
```

- `MSYS_NO_PATHCONV=1` 必加，否则 `/v /t /d /f` 被 MSYS 当路径转换而失败。
- `reg` 成功输出中文（GBK）在终端会显示乱码，**属正常**，看退出码即可。
- 回退（非管理员或失败）：`start c://Windows//Fonts && start fonts`，手动拖拽安装。

## 第 4 步：主题（.minttyrc + 改箭头的 git-prompt.sh）

先把 `git-prompt.sh` 第 15 行的 `'➜  '` 改成 `'-> '`（用 Edit 工具最稳；用 sed 注意分隔符**不能**用 `~` 或 `/`，因为内容里有 `~`/`/`）：

```bash
cp .minttyrc ~                                   # 不存在才直接 cp；已存在则先备份再覆盖
cp git-prompt.sh /etc/profile.d/git-prompt.sh
```

## 第 5 步：tmux 本体 + 配置

```bash
cp tmux/bin/* /usr/bin
cp tmux/share/* /usr/share -r
cp tmux/.tmux.conf ~                             # 仓库完整配置（prefix=C-a、分屏 |-、vi 模式、状态栏），优于 README 的 echo
```

## 第 6 步：tmux 持久化插件（可选，问用户）

插件能保存/恢复 session，但会拖慢 tmux 启动；用户不要就跳过。

```bash
mkdir -p ~/.tmux/plugins/tpm
git clone --depth 1 https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm   # 可能因网络失败，失败不影响 tmux 本体
# 国内备选: git clone https://gitclone.com/github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
```

clone 成功后，取消 `~/.tmux.conf` 中插件行的注释（5 个 `@plugin` + 1 个 `run`）。sed 用 `:` 作分隔符（避开内容里的 `~` 和 `/`）：

```bash
sed -i -E "s:^# (set -g @plugin|run '):\1:" ~/.tmux.conf
grep -nE "@plugin|tpm/tpm" ~/.tmux.conf          # 验证已无 # 前缀
```

装完告诉用户：进 tmux 后按 **`Ctrl+a` 再按大写 `I`** 让 tpm 拉取 resurrect/continuum（prefix 是 C-a，不是默认 C-b）。

## 第 7 步：tree（跳过 wget）

```bash
cp tools/tree.exe /usr/bin                       # 只拷 tree；wget 系统已自带，不覆盖
```

## 第 8 步：alias 增量合并（核心：分析后追加，不是覆盖）

**先读用户 `~/.bash_profile`，按下表分类**，只追加「用户没有、不冲突、无 bug」的：

| 类别 | 处理 | 仓库示例 |
|---|---|---|
| 用户已有 | **跳过** | `gs`/`gclean`/`sysoff`/`sysre`、用户的 `tree='tree --charset ASCII'`（比仓库好，避免乱码）、用户的 GBK 转码 `zw`/`git_diff_gbk` |
| 有冲突 | **跳过** | `.='cd ~'`（破坏 `.` 语义）、`tree1`/`tree2`（与用户 ASCII tree 冲突） |
| 有 bug | **跳过** | `utf8`/`gbk`（`sed -i 's/GBK/UTF-8/'` 单引号嵌套错误，且用户已有自己的方案） |
| 有用且用户没有 | **追加** | git 快捷键 `ga/gc/gp/gl/gb/gch/gm`、导航 `.. / ... / ,`、`e`/`cls`、tmux `tn`/`ta`、`bashalias`/`gitconfig`（用 `code` 打开配置）、`ep`/`c` |

追加用 heredoc（`'EOF'` 带引号防展开），**带防重复检查 + 日期标记**：

```bash
if grep -q "my-git-bash 仓库 ($(date +%F) 添加)" ~/.bash_profile 2>/dev/null; then
  echo "已追加过，跳过"
else
  cat >> ~/.bash_profile << 'MYGITBASH_EOF'

# --- 以下增量来自 my-git-bash 仓库 (YYYY-MM-DD 添加) ---
# git 快捷键
alias ga='git add .'
alias gc='git commit -m'
alias gp='git push'
alias gl='git pull'
alias gb='git branch'
alias gch='git checkout'
alias gm='git merge'
# 目录导航
alias ..='cd ..'
alias ...='cd ../..'
alias ,='cd -'
alias e='exit'
alias cls='clear'
# tmux
alias tn='tmux new -s m'
alias ta='tmux a'
# 用 VS Code 快速打开配置
alias bashalias='code ~/.bash_profile'
alias gitconfig='code ~/.gitconfig'
# 资源管理器/VSCode 打开当前目录
alias ep='start . && exit'
alias c='code . && exit'
# --- end my-git-bash ---
MYGITBASH_EOF
fi
```

> 上面的 `YYYY-MM-DD` 换成当天日期；清单按用户实际已有情况增删——**分析是这步的灵魂，不要无脑全加**。

## ❌ 绝不做

- `cp .bash_profile ~`（覆盖工作配置）
- `cp .gitconfig ~`（覆盖提交身份 + 注入代理）
- `cp tools/wget.exe /usr/bin`（覆盖系统 wget）

## 验证

```bash
# 箭头已是 ASCII（cat -A 应显示 '-> '，无 M-b/M-f 的 UTF-8 字节）
grep -n "PS1=\"\$PS1\"'" /etc/profile.d/git-prompt.sh | cat -A
tmux -V && tree --version | head -1
source ~/.bash_profile && type ga gp gch tn ..       # alias 可加载
grep -q "end my-git-bash" ~/.bash_profile && echo "alias 段已追加"
grep -m1 email ~/.gitconfig                           # 身份未被改动
```

最后提醒用户：**重启 Git Bash** 才能让主题/字体/提示符/新 alias 生效。

## 回退

- 提示符：`cp /etc/profile.d/git-prompt.sh.bak /etc/profile.d/git-prompt.sh`
- alias：编辑 `~/.bash_profile`，删两个 `# ---` 之间的段落
- tmux：`rm /usr/bin/tmux.exe`
- 字体：控制面板 → 字体 → 删除 `DejaVu Sans Mono for Powerline`

## 平台/编码备忘

- 调 Windows 原生命令（`reg`、`shutdown` 等）加 `MSYS_NO_PATHCONV=1`，防 `/x` 参数被路径转换。
- 中文/GBK 程序输出在 UTF-8 终端会乱码，看退出码而非输出文字判断成败。
- sed 分隔符选内容里不出现的字符（这里用 `:`），别用 `~`/`/`。
- 仓库已 cloned 到 `D:\iflytekCode\my-git-bash`（2026-07-24 首装）；新机器重装时重新 clone 即可，勿依赖旧路径。