Add documentation and scripts

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/git-network-troubleshooting.md

@@ -0,0 +1,225 @@
+# Git 网络连接问题排查指南
+
+## 问题：`fatal: unable to access 'https://github.com/...': Recv failure: Connection was reset`
+
+这是常见的网络连接问题，通常出现在中国大陆访问 GitHub 时。
+
+## 解决方案
+
+### 方案一：配置 Git 代理（推荐）
+
+如果你有可用的代理（VPN/SSR/V2Ray），可以配置 Git 使用代理：
+
+#### 设置 HTTP/HTTPS 代理
+
+```powershell
+# 设置全局代理（所有 Git 操作都使用代理）
+git config --global http.proxy http://127.0.0.1:7890
+git config --global https.proxy http://127.0.0.1:7890
+
+# 仅针对 GitHub 设置代理
+git config --global http.https://github.com.proxy http://127.0.0.1:7890
+git config --global https.https://github.com.proxy http://127.0.0.1:7890
+
+# 查看代理配置
+git config --global --get http.proxy
+git config --global --get https.proxy
+```
+
+**常见代理端口**：
+- Clash: `7890`
+- V2Ray: `10808`
+- SSR: `1080`
+- 其他：根据你的代理软件设置
+
+#### 取消代理设置
+
+```powershell
+# 取消全局代理
+git config --global --unset http.proxy
+git config --global --unset https.proxy
+
+# 取消 GitHub 特定代理
+git config --global --unset http.https://github.com.proxy
+git config --global --unset https.https://github.com.proxy
+```
+
+### 方案二：使用 SSH 代替 HTTPS
+
+SSH 连接通常比 HTTPS 更稳定：
+
+#### 1. 生成 SSH 密钥
+
+```powershell
+# 生成 SSH 密钥对
+ssh-keygen -t ed25519 -C "your_email@example.com"
+
+# 按 Enter 使用默认路径
+# 可以设置密码或直接按 Enter（不设置密码）
+```
+
+#### 2. 添加 SSH 公钥到 GitHub
+
+```powershell
+# 查看公钥内容
+cat $env:USERPROFILE\.ssh\id_ed25519.pub
+
+# 复制公钥内容，然后：
+# 1. 访问 https://github.com/settings/keys
+# 2. 点击 "New SSH key"
+# 3. 粘贴公钥内容
+# 4. 点击 "Add SSH key"
+```
+
+#### 3. 测试 SSH 连接
+
+```powershell
+# 测试 SSH 连接
+ssh -T git@github.com
+
+# 如果看到 "Hi bujie9527! You've successfully authenticated..." 说明成功
+```
+
+#### 4. 更改远程仓库 URL 为 SSH
+
+```powershell
+# 更改远程 URL 为 SSH
+git remote set-url origin git@github.com:bujie9527/wecom-ai-assistant.git
+
+# 验证更改
+git remote -v
+
+# 再次推送
+git push -u origin main
+```
+
+### 方案三：使用 GitHub 镜像（临时方案）
+
+可以使用 GitHub 镜像站点：
+
+```powershell
+# 使用镜像站点（不推荐，仅临时使用）
+git remote set-url origin https://github.com.cnpmjs.org/bujie9527/wecom-ai-assistant.git
+
+# 推送后改回原地址
+git push -u origin main
+git remote set-url origin https://github.com/bujie9527/wecom-ai-assistant.git
+```
+
+### 方案四：增加超时和重试
+
+```powershell
+# 增加 Git 超时时间
+git config --global http.postBuffer 524288000
+git config --global http.lowSpeedLimit 0
+git config --global http.lowSpeedTime 999999
+
+# 使用重试机制推送
+git push -u origin main --verbose
+```
+
+### 方案五：使用 GitHub CLI（gh）
+
+如果安装了 GitHub CLI：
+
+```powershell
+# 安装 GitHub CLI（如果还没有）
+# 下载：https://cli.github.com/
+
+# 登录
+gh auth login
+
+# 推送代码
+git push -u origin main
+```
+
+## 快速诊断
+
+### 检查网络连接
+
+```powershell
+# 测试 GitHub 连接
+Test-NetConnection github.com -Port 443
+
+# 测试 DNS 解析
+nslookup github.com
+
+# 使用 curl 测试
+curl -I https://github.com
+```
+
+### 检查 Git 配置
+
+```powershell
+# 查看所有 Git 配置
+git config --list
+
+# 查看远程仓库配置
+git remote -v
+
+# 查看当前分支
+git branch
+```
+
+## 推荐方案
+
+**最佳实践**（按优先级）：
+
+1. **配置代理**（如果你有 VPN/代理）
+   ```powershell
+   git config --global http.https://github.com.proxy http://127.0.0.1:7890
+   git config --global https.https://github.com.proxy http://127.0.0.1:7890
+   ```
+
+2. **使用 SSH**（更稳定，一次配置长期使用）
+   ```powershell
+   # 生成 SSH 密钥并添加到 GitHub
+   # 然后更改远程 URL
+   git remote set-url origin git@github.com:bujie9527/wecom-ai-assistant.git
+   ```
+
+3. **重试推送**（网络临时问题时）
+   ```powershell
+   git push -u origin main
+   ```
+
+## 常见错误和解决方案
+
+### 错误 1：`SSL certificate problem`
+
+```powershell
+# 临时忽略 SSL 验证（不推荐，仅测试用）
+git config --global http.sslVerify false
+```
+
+### 错误 2：`Authentication failed`
+
+```powershell
+# 清除缓存的凭据
+git credential-manager-core erase
+# 或
+git credential reject https://github.com
+
+# 重新推送时会提示输入用户名和 token
+```
+
+### 错误 3：`Connection timed out`
+
+- 检查防火墙设置
+- 检查代理配置
+- 尝试使用 SSH
+
+## 验证推送成功
+
+推送成功后，访问以下 URL 验证：
+
+- **仓库地址**：https://github.com/bujie9527/wecom-ai-assistant
+- **提交历史**：https://github.com/bujie9527/wecom-ai-assistant/commits/main
+
+## 获取帮助
+
+如果以上方案都无法解决：
+
+1. 检查 GitHub 状态：https://www.githubstatus.com/
+2. 查看 Git 日志：`git push -u origin main --verbose`
+3. 提交 Issue：https://github.com/bujie9527/wecom-ai-assistant/issues