Add setup steps and troubleshooting guide
Some checks failed
Build and Deploy / test-backend (push) Has been cancelled
Build and Deploy / build-backend (push) Has been cancelled
Build and Deploy / build-admin (push) Has been cancelled
Deploy to Production / build-backend (push) Has been cancelled
Deploy to Production / deploy (push) Has been cancelled

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
bujie9527
2026-02-05 20:17:24 +08:00
parent 27a794eef1
commit 0ab39ccf59
2 changed files with 175 additions and 0 deletions

71
TROUBLESHOOTING.md Normal file
View File

@@ -0,0 +1,71 @@
# 私有仓库推送问题排查
## 问题404 page not found
### 可能的原因
1. **仓库尚未创建** - 最常见的原因
2. **仓库路径不正确** - 路径格式可能不同
3. **权限问题** - 用户没有访问权限
## 解决方案
### 方案 1确认仓库是否已创建
1. 访问https://git.quanyu360.cn
2. 登录(用户名: `admin`,密码: `ye972030`
3. 检查是否存在名为 `wecom-ai-assistant` 的仓库
4. 如果不存在,按照 `CREATE_REPO_GUIDE.md` 创建仓库
### 方案 2检查正确的仓库路径
创建仓库后,在仓库页面可以看到实际的 Git URL格式可能是
- `https://git.quanyu360.cn/admin/wecom-ai-assistant.git`
- `https://git.quanyu360.cn/wecom-ai-assistant.git`
- `https://git.quanyu360.cn/root/wecom-ai-assistant.git`
- 或其他格式
### 方案 3使用正确的路径更新远程仓库
找到正确的路径后,更新远程仓库:
```powershell
# 移除旧的配置
git remote remove private
# 添加正确的路径(替换为实际路径)
git remote add private https://admin:ye972030@git.quanyu360.cn/实际路径/wecom-ai-assistant.git
# 验证
git remote -v
# 推送
git push -u private main
```
### 方案 4测试不同的路径格式
运行测试脚本:
```powershell
.\scripts\test-git-paths.ps1
```
脚本会自动尝试常见的路径格式。
## 快速检查清单
- [ ] 已访问 https://git.quanyu360.cn 并登录
- [ ] 已创建仓库 `wecom-ai-assistant`
- [ ] 已确认仓库的实际 Git URL
- [ ] 已使用正确路径配置远程仓库
- [ ] 已测试推送代码
## 获取帮助
如果仍然无法推送,请提供:
1. Git 服务器类型Gitea、GitLab、Gogs 等)
2. 创建仓库后显示的实际 Git URL
3. 错误信息的完整内容