3.6 KiB
3.6 KiB
QuickGit 使用说明
⚠️ 重要提示:本工具仅支持通过 SSH 方式连接 GitHub 和 Gitea 远程仓库,不支持 HTTPS。
前置要求
必需配置 SSH 密钥
-
生成 SSH 密钥:
ssh-keygen -t ed25519 -C "your_email@example.com" -
将公钥添加到 GitHub/Gitea:
- GitHub: Settings → SSH and GPG keys → New SSH key
- Gitea: 设置 → SSH/GPG 密钥 → 添加密钥
-
测试连接:
ssh -T git@github.com ssh -T git@git.shumengya.top -p 8022
已修复的问题
1. 添加文件失败问题
- 原因: Windows系统上创建了错误的
nul文件 - 解决: 已删除并修复批处理脚本的输出重定向
2. 界面对齐问题
- 原因: 使用了Unicode矩形边框字符在不同终端宽度不一致
- 解决: 改用简单的
=和-线条,确保所有终端都能完美对齐
新界面特色
彩色输出方案
- 标题: 亮青色、亮品红色
- 成功: 亮绿色
[√] - 错误: 亮红色
[×] - 信息: 亮青色
[i] - 警告: 亮黄色
[!] - 运行中: 亮青色
[>]
简洁分割线
============================================================ (标题线)
------------------------------------------------------------ (分割线)
紧凑布局
- 减少不必要的空行
- 信息排列紧密
- 重要内容突出显示
运行方式
Windows (推荐)
双击运行 run.bat - 自动设置UTF-8编码
任何系统
python quickgit.py
界面预览
============================================================
QuickGit - 萌芽一键Git管理工具 v1.0
============================================================
当前目录: E:\SmyProjects\Python\脚本\萌芽一键Git管理
Git状态: [已初始化]
------------------------------------------------------------
>> 主菜单
------------------------------------------------------------
[1] 初始化Git仓库
[2] 提交更改到本地
[3] 推送到远程仓库
[4] 从远程仓库拉取
[5] 查看仓库状态
[6] 管理远程仓库
[7] 退出程序
------------------------------------------------------------
[*] 提交代码前建议先拉取最新代码,减少代码冲突
[*] 使用SSH进行Git提交更方便快捷和安全
------------------------------------------------------------
>> 请输入选项 [1-7]:
功能说明
所有功能均正常工作:
- ✓ 初始化Git仓库
- ✓ 提交更改到本地(不推送)
- ✓ 推送到远程仓库(通过 SSH)
- ✓ 从远程仓库拉取(通过 SSH)
- ✓ 查看仓库状态
- ✓ 管理远程仓库(GitHub/Gitea/自建 Git,仅 SSH)
- ✓ 配置 Gitea 服务器(自定义主机和端口)
- ✓ 添加自建 Git 仓库(GitLab、自建 Gitea、Gogs 等)
远程仓库管理菜单
[1] 查看远程仓库
[2] 添加GitHub远程仓库
[3] 添加Gitea远程仓库
[4] 添加自建Git仓库 ← 新功能
[5] 配置Gitea服务器 ← 新功能
[6] 删除远程仓库
[7] 返回主菜单
远程仓库 URL 格式
- GitHub:
git@github.com:shumengya/{repo}.git - Gitea:
ssh://git@git.shumengya.top:8022/{user}/{repo}.git- 主机和端口可通过菜单配置
- 自建 Git: 支持自定义 SSH URL
- GitLab:
git@gitlab.com:user/repo.git - 自建服务器:
ssh://git@your-server.com:port/user/repo.git
- GitLab:
注意:不支持 HTTPS URL 格式(如 https://github.com/user/repo.git)
配置文件
配置保存在:~/.quickgit_config.json
可配置项:
- Gitea 主机地址
- Gitea SSH 端口
- GitHub 用户名
- 默认分支名
界面美观、对齐完美、功能稳定!