给中国人用的 GitHub 加速与同步工具 —— 下载 / 同步 / 加速, 一条命令搞定。
v1.0.5: 官方二进制 + 发行版管理 + 全自动发版 —— 每个发行版现在有 4 个附件: Nuitka 编译的
gitx-linux-x86_64/gitx-linux-arm64(单文件、免 Python 环境, 下载即可用)、 uv 构建的 wheel 与 源码包; 发版交给 GitHub Actions(推v*标签 -> 自动构建 4 个附件 -> 自动创建发行版), 以后发版只走这一条路。 新增gitx publish: 发行版一条龙 —— 列表 / 详情 / 创建并上传附件 / 补传附件 / 编辑(说明·预发布·草稿·最新) / 删除, 全部交给已登录的gh。 修复gitx merge/gitx pull报"致命错误：储藏失败": git 合并前的快照 (git stash create) 在索引里有 "mtime 变了、内容没变" 的条目时会静默失败, 现在合并 / 拉取前先刷新索引, 踩到就自动重试 (实测: 同样的干扰下裸git merge60 次失败 8 次,gitx merge60 次全成功)。 (含 v1.0.5-pre1/pre2 的 skill 优化: 表格化命令速查、快速上手指南、常见问题解答。)v1.0.4: TOML 配置 + 五项新命令 —— 配置文件换成人类可读的 TOML(
~/.config/gitx/config.toml, 逐项中文注释,gitx config set后注释不丢; 旧的config.json首次运行自动迁移并保留为.json.bak), 新增dest/resume/sync_rebase/color/assume_yes五项配置, 并新增gitx config edit/gitx config path; 新增gitx upgrade(自更新: 查 Release 与下 wheel 都走加速)、gitx remote(拉取加速 + 推送直连)、gitx submodule(子模组也走加速)、gitx pr(列表 / 详情 / 创建)、gitx cache(缓存查看与清理);gitx download支持一次下多个链接(-f从文件读、-o指定目录);gitx doctor --fix一键修好编码 / pull 策略 / 上游; 修复gitx pull与gitx sync --merge在分支分歧时报"需要指定如何调和偏离的分支"、以及gitx proxy on <非法源>抛完整堆栈的问题。
v1.0.3: 链接解析与配置修复 —— 修复
https://github.com/owner/repo/releases/latest这类链接无法识别的问题(此前gitx release <该链接>会直接抛栈), 现在/releases、/releases/latest、/releases/tag/<标签>、/releases/download/...都能正确解析; GitHub 链接可省略https://,gitx github.com/owner/repo直接下载; 修好文档里承诺却一直没生效的配置项branch(默认分支)—— 现在按--branch> URL 内分支 > 配置branch> 远端默认分支 依次生效;gitx stash列表不再显示 git 的On <分支>:前缀;gitx web对未知页面给出提示而非静默开首页;gitx url/gitx proxy检测 insteadOf 规则时不再吞掉自定义加速源的大小写; 并清掉三处死代码。
默认走加速镜像 https://v6.gh-proxy.org 拉取, 推送直连 GitHub(镜像不支持推送)。
命令行用 Typer + Rich 构建: 分组式帮助、彩色表格、下载进度条(速率 / 剩余时间),
配色统一为 Catppuccin Mocha; 直接运行 gitx 显示版本 + 加速状态 + 常用命令速查, gitx -h 才是完整帮助。
交互式挑选(Release 发布 / 附件 / 搜索结果)用 questionary: 上下键选择、最多渲染 5 行、打字即筛选。
cd Gitx
uv sync # 创建环境并安装 (依赖 typer / rich / questionary)
uv run gitx -h # 或: uv run python -m gitx --help或者从 Release 附件安装 (每个版本都提供 4 个附件: 两个 Nuitka 二进制 + wheel + 源码包):
# 方式 1: 二进制 —— 单文件、免 Python, 下载即可用 (URL 固定指向最新正式版)
curl -L -o gitx https://github.com/FLT18355/gitx/releases/latest/download/gitx-linux-x86_64
chmod +x gitx && sudo install -m755 gitx /usr/local/bin/gitx # arm64 换成 gitx-linux-arm64
# 方式 2: wheel (要 gitx upgrade 自更新就用这个)
uv tool install gitx-1.0.5-py3-none-any.whl # 或: uv tool install .
# 方式 3: 源码包
tar xf gitx-1.0.5.tar.gz && uv tool install ./gitx-1.0.5二进制由 GitHub Actions 用 Nuitka 在 x86_64 与 arm64 上各编一份 (
.github/workflows/release.yml), 推v*标签即自动构建并创建发行版; 二进制版同样走加速镜像、同样能gitx merge等全套命令。
gitx https://github.com/owner/repo # 仓库 -> ./repo (浅克隆, 有 git 历史)
gitx https://github.com/owner/repo -x # 源码包 tar.gz (单个流, 不要历史时最快)
gitx https://github.com/owner/repo -X # 下载并直接解压
gitx https://github.com/owner/repo/tree/分支/路径 # 文件夹 (部分克隆 + 稀疏检出, 只取目标目录)
gitx https://github.com/owner/repo/blob/分支/路径/文件 # 单个文件
gitx github.com/owner/repo # 链接可省略 https://, 效果同上
gitx clone https://github.com/owner/repo 我的目录 # 等价 download
gitx download url1 url2 -o 下载目录 # 批量: 一次下多个链接 (失败的不影响其余)
gitx download -f 链接.txt -o 下载目录 # 从文本文件读链接 (每行一个, # 注释; - 读标准输入)选项: --no-proxy 直连, --proxy gh-proxy 换加速源, --branch <分支>, --depth <N>(0 = 完整克隆),
--submodules 连同子模组一起拉取(也走加速), --fresh 忽略断点从零下载。
-o 默认是保存路径; 多个链接、或指向已存在的目录(以 / 结尾)时按目录处理, 每个仓库各建一个子目录。
不给 --branch 时, 分支按 URL 内分支 > 配置项 branch(gitx config set branch develop) > 远端默认分支 依次决定。
断点续传: 中断的下载会留下 <文件>.part, 重跑自动带 Range 续传, 不用重来。
下载整仓库后自动把推送地址指回直连 GitHub(存在全局加速规则时用 SSH), 保证 gitx push 不被镜像拒绝。
gitx release owner/repo # 交互式: 先挑发布(含预发布, 默认最近 10 个), 再挑要下载的附件
gitx release owner/repo -n 30 # 挑选范围改成最近 30 个 (最多 100)
gitx release owner/repo --tags # 非交互: 列出最近 10 个发布(含预发布)
gitx release owner/repo --tag v1.0.0 # 指定标签(不询问发布)
gitx release owner/repo --list # 只看附件清单(表格: 名称 + 大小)
gitx release owner/repo --pick # 强制交互: 挑选发布 + 附件
gitx release owner/repo -a '*linux_amd64*' # 只下匹配的附件(通配, 可重复传 -a)
gitx release owner/repo --source # 额外下载源码包(tarball)
gitx release owner/repo -o ~/下载 # 指定保存目录
gitx release owner/repo --fresh # 忽略 .part 断点终端里直接 gitx release owner/repo 进入上下键交互: 先用 ↑↓ 挑发布(直接打字即筛选), 回车确认(默认最新);
再挑附件: ↑↓ 移动、空格勾选、打字筛选, 回车确认 —— 一个都没勾就下全部。Ctrl+C 随时取消。
给了 --tag / --asset 或不在终端(管道/脚本)时完全非交互, 行为与旧版一致(最新发布 + 全部附件)。
链接形式同样可用:
gitx https://github.com/owner/repo/releases/tag/v1.0.0 # 指定标签的附件
gitx https://github.com/owner/repo/releases/latest # 最新发布(等价 .../releases)
gitx https://github.com/owner/repo/releases/download/v1.0.0/文件名 # 单个附件
gitx https://github.com/owner/repo/releases --list # 只看清单实现要点: 走 api.github.com/repos/{owner}/{repo}/releases(经加速镜像访问), 已登录 gh 或配置
token 时自动带上认证(限额 60 → 5000 次/小时); 附件按 browser_download_url 直下并显示进度条,
支持断点续传; 该 Release 没有附件时自动回退到源码包。
Release 的加速源可以单独设置(不影响克隆 / 同步 / 搜索等其它功能):
gitx proxy release # 查看 Release 当前用的加速源 (与全局对比)
gitx proxy release on v4 # Release 走 v4; 其它功能仍走全局 (默认 v6)
gitx proxy release off # Release 直连; 其它功能照旧走加速
gitx proxy release follow # 取消独立设置, 跟随全局加速源 (默认)一次性的 --proxy <源> / --no-proxy 仍然优先级最高, 对单条命令生效。
发布方的一条龙: 上面 gitx release 只管下载, 这里只管发布。写操作全部交给已登录的
gh, 本工具只拼参数、不接触写入令牌(仓库写权限由 gh 自己的登录态决定);
没装 / 没登录 gh 会给出中文提示 (只下载附件不需要 gh)。
gitx publish # 列出发行版 (含草稿与预发布): 标签 / 名称 / 状态 / 发布 / 创建
gitx publish --no-drafts --no-prereleases -n 50 # 只列正式版, 最多 50 条
gitx publish view # 看最新发行版: 状态 / 时间 / 说明首行 / 附件清单
gitx publish view v1.0.5 --web # 指定标签, 并顺手打开网页
gitx publish create v1.0.5 dist/*.tar.gz dist/*.whl -T "gitx 1.0.5" -F 发布说明.md
gitx publish create v1.0.5-pre2 dist/* -T "gitx 1.0.5-pre2 (预发布)" -F 说明.md -p
gitx publish create v1.0.5 dist/*.whl -d # 先建草稿, 检查无误后再发布
gitx publish upload v1.0.5 dist/*.whl --clobber # 给已有发行版补传附件 (同名先删后传)
gitx publish edit v1.0.5 --no-draft # 把草稿正式发布
gitx publish edit v1.0.5 --no-prerelease --latest # 预发布转正式, 并标记为最新
gitx publish edit v1.0.5 -n "$(cat 新说明.md)" # 改说明 (或 -F 新说明.md, -F - 读标准输入)
gitx publish delete v1.0.5-pre1 --cleanup-tag # 删除发行版(会确认), --cleanup-tag 连标签一起删
gitx publish list --repo cli/cli -n 10 # 看别人的发行版 (owner/repo 或链接都行)| 子命令 | 作用 | 常用选项 |
|---|---|---|
publish / publish list |
列出发行版 | -n 条数, --no-drafts / --no-prereleases 过滤, -R 目标仓库 |
publish view |
发行版详情 + 附件清单 | --web 打开网页, 标签留空 = 最新 |
publish create |
创建发行版并上传附件 | -T 标题, -n / -F 说明, -p 预发布, -d 草稿, --target / --verify-tag / --generate-notes / --latest+--no-latest |
publish upload |
补传附件 | --clobber 同名先删后传 |
publish edit |
改标题 / 说明 / 预发布 / 草稿 / 最新 | --prerelease+--no-prerelease, --draft+--no-draft, --latest+--no-latest, --tag 改标签名 |
publish delete |
删除发行版 | --cleanup-tag 连标签一起删, -y 跳过确认 |
附件参数直接给构建产物 (dist/*.tar.gz dist/*.whl), 通配符由 gh 展开, 上传前本地先检查文件是否存在;
说明可用 -F - 从标准输入读, 于是能和 RELEASE_TEMPLATE.md 的"取到第一个 --- 为止"配合
(用管道, 别用 <(...) 进程替换 —— 进程替换的 fd 不会传给 gitx 拉起的 gh, gh 会报
open /dev/fd/63: no such file or directory):
sed -n '1,/^---$/p' RELEASE_TEMPLATE.md | gitx publish create v1.0.5 dist/*.tar.gz dist/*.whl -T "gitx 1.0.5" -F -正式发版走 GitHub Actions (
.github/workflows/release.yml): 推一个v*标签就自动构建 4 个附件并创建发行版, 不用手动敲上面的命令;gitx publish适合临时补传附件 / 改说明 / 删草稿 / 看列表。
gitx search "cli 工具" -n 10 # 搜 GitHub 仓库 (按 ★ 排序, 默认加速)
gitx search "neovim" --language go # 限定语言
gitx search "neovim" -d # 搜完直接下载 (多个结果时上下键挑)
gitx web # 浏览器打开当前仓库主页
gitx web issues / pulls / releases / actions / wiki
gitx web branch / commit # 打开当前分支 / HEAD 提交页
gitx web --print # 只打印地址, 不打开浏览器
gitx stat cli/cli # 仓库概览: ★ star / fork / topics / 语言 / 许可证 / 贡献者 / 最新发布
gitx stat # 不写参数 = 当前仓库 origin 的概览
gitx stat cli/cli --json # 输出 JSON (脚本友好, 含 languages / contributors)
gitx ignore --list java # 列出可用 .gitignore 模板 (模糊匹配)
gitx ignore python node macos # 从 github/gitignore 拉取模板写入 .gitignoregitx ignore 的模板索引缓存一周 (~/.cache/gitx/gitignore.json), 删掉会自动重建。
gitx stat 走 GitHub API (默认加速, 也可 --no-proxy 直连), 一次可看: ★ star / fork / watcher /
开放 issue / 贡献者 / 网络仓库数、topics 标签、语言构成与占比、许可证、创建/更新/推送时间线、
默认分支与体积、归档/复刻/模板等状态, 以及最新发布 (标签 / 日期 / 附件数)。数据取自
/repos/{owner}/{repo} 与 languages / contributors / releases/latest; 后面几个接口
失败 (如无发布) 会被忽略而非报错。匿名限额 60 次/小时, 配 token 可到 5000 (gitx config set token)。
gitx push # 提交并推送(默认信息: 日常同步更新)
gitx push "修复了 bug" # 带备注
gitx push to https://github.com/owner/repo # 首次关联远程并推送
gitx push -f # 强制推送
gitx pull # 拉取(走加速)
gitx pull --rebase
gitx fetch --prune # 只更新远端引用 (不动工作区), 清理远端已删除的分支
gitx sync # 先拉(变基)后推, 一步到位
gitx sync "今天的改动" # 带上提交信息推送被拒时若远端领先, 会提示先 gitx pull --rebase; gitx sync 自动完成这套流程。
gitx init 我的项目 # 初始化: 分支 main + 中文友好配置
gitx init 裸仓 --bare # 原生 git init 参数照常透传 (--no-zh 可跳过中文配置)
gitx info # 仓库概览(表格): 状态/领先落后/最近提交/加速状态
gitx graph -n 30 # 带图形的提交历史 (git log --graph 上色版)
gitx tidy # 体检: 体积 / 已合并分支数
gitx tidy --prune # 删除已合并分支 (会确认, -y 跳过)
gitx tidy --gc # git gc 打包瘦身 (--aggressive 更彻底)
gitx url # 查看 origin 的拉取/推送地址与形态
gitx url ssh # 切换为 SSH 传输
gitx url https # 切换为直连 https
gitx url accel # 切换为拉取加速 + 推送直连
gitx undo # 撤销最近 1 次提交, 改动保留在暂存区
gitx undo 3 # 撤销最近 3 次提交
gitx undo --mixed # 改动回到工作区(未暂存)
gitx undo --hard -y # 丢弃改动(默认会询问确认)
gitx config zh # 当前仓库写入中文友好配置
gitx config zh --global # 全局写入中文友好配置解决两个老问题: core.quotepath=false(中文文件名不再显示为 \344\270\255)、
i18n.*Encoding=utf-8(提交信息与日志按 UTF-8 处理)。
gitx branch # 分支表: 上游 / 领先落后 / 最近提交
gitx branch -a # 含远端跟踪分支 (等价 gitx branches -a)
gitx branch new 新功能 # 从当前 HEAD 新建分支
gitx branch new 修复 --from v0.6.1 -s # 从标签/提交新建并立即切换 (-s)
gitx switch 修复 # 切换 (远端有同名分支时自动建立跟踪)
gitx switch -c 实验 # 新建并切换
gitx switch - # 回到上一个分支
gitx switch --detach 3f1a2b # 切到某次提交 / 标签 (游离 HEAD)
gitx branch rename 新名字 # 重命名当前分支
gitx branch rename 新名字 -o 旧名字 # 重命名指定分支
gitx branch delete 旧分支 # 删除已合并的本地分支 (未合并会提示)
gitx branch delete 实验 --force # 强制删除 (未合并也会先确认一次)
gitx branch delete 旧分支 -r # 删 origin 上的远端分支
gitx branch upstream # 看当前分支的上游与领先/落后
gitx branch upstream --set origin/main # 关联上游
gitx branch upstream --unset # 取消上游关联
gitx merge 新功能 # 合并进当前分支 (冲突时给出继续/放弃提示)
gitx merge --abort # 放弃正在进行的合并
gitx rebase main # 变基到 main (冲突: --continue / --skip / --abort)
gitx rebase -i main # 交互式变基 (压缩 / 改写 / 丢弃提交)gitx branch 的一次性数据来自单次 for-each-ref(比逐个分支起进程快一个数量级);
gitx fetch 走加速, --prune 会顺手清掉远端已删除的跟踪分支。
gitx commit -m "修复登录超时" # 提交已暂存的改动
gitx commit -a -m "顺手改个错字" # 提交所有已跟踪文件的改动
gitx commit --amend --no-edit # 修订上一次提交 (沿用原信息)
gitx diff # 上色渲染的工作区改动 (rich.syntax 高亮)
gitx diff --staged # 暂存区 vs HEAD
gitx diff --stat / --name-only # 只看统计 / 只看文件名
gitx discard 文件1 目录/ 文件2 # 丢弃工作区改动 (会确认, 不可恢复)
gitx discard --staged 文件 # 只取消暂存, 保留文件内容
gitx clean # 先预览未跟踪文件, 确认后删除
gitx clean -d -y # 连未跟踪的目录一起删, 跳过确认
gitx clean -x # 连 .gitignore 忽略的文件也删 (危险, 会确认)gitx stash # 列出暂存的改动 (stash@{N} / 时间 / 说明)
gitx stash save "改到一半" # 暂存当前改动 (工作区恢复干净; -u 连未跟踪文件)
gitx stash show -p # 看某条暂存的具体 diff (序号: gitx stash show 1 -p)
gitx stash pop # 恢复并删除 (gitx stash pop 1 指定序号)
gitx stash apply 1 # 恢复但保留该条暂存
gitx stash drop 1 # 删除一条 (会确认)
gitx stash clear # 清空所有暂存 (会确认)
gitx tag # 标签列表: 类型 / 时间 / 提交 / 说明
gitx tag new v1.0.0 "首个正式版" # 附注标签 (无说明 = 轻量标签)
gitx tag push v1.0.0 # 推送指定标签 (推送直连, 镜像不支持推送)
gitx tag push # 推送全部标签
gitx tag delete v1.0.0 # 删本地标签
gitx tag delete v1.0.0 -r # 连 origin 上的标签一起删gitx remote # 列出全部远程 (拉取 / 推送地址)
gitx remote add upstream https://github.com/owner/repo # 加远程: 拉取走加速, 推送直连
gitx remote set-url origin https://github.com/owner/repo # 改地址 (自动同步推送地址)
gitx remote show upstream / rename / remove # 查看 / 重命名 / 删除
# 未知参数仍透传 git: gitx remote -v / gitx remote prune origin
gitx submodule # 子模组状态 (提交是否对齐 / 未初始化 / 冲突)
gitx submodule add https://github.com/owner/repo libs/x # 添加 (拉取走加速)
gitx submodule update # 拉取子模组 (默认 --init --recursive, 走加速)
gitx submodule update --remote # 跟踪子模组远端最新提交
gitx submodule sync # 地址同步成 .gitmodules 的配置
gitx submodule remove libs/x # 删除 (含 .gitmodules 条目与本地缓存)
gitx pr # 当前仓库的开放 PR
gitx pr list cli/cli --state all -n 30 # 任意仓库, 各种状态
gitx pr view 1234 # 看某个 PR 的标题 / 状态 / 正文 (--web 顺手打开)
gitx pr create -t "标题" -b "正文" # 用已登录的 gh 创建 (--fill 用提交信息, --draft 草稿)
gitx cache # 看 ~/.cache/gitx 的内容与占用
gitx cache clear # 清空缓存 (可再生的数据, 下次自动重建)
gitx upgrade # 自更新到最新版本 (查 Release 与下 wheel 都走加速)
gitx upgrade --check # 只检查是否有新版本子模组加速的原理与下载一致: 用 git -c url.<镜像>/.insteadOf=<原地址> 让本次命令
把 github.com 重写到镜像 (规则不落盘)。远程管理则反过来 —— 拉取写加速地址、推送写直连
(存在 insteadOf 规则时用 SSH), 这样 gitx remote add 出来的远程开箱即可用。
gitx pr 的读取走加速 API, 创建交给 gh (写入鉴权不经过本工具)。
gitx proxy # 查看状态(表格: 加速源 / Release 加速源 / insteadOf / 配置文件)
gitx proxy auto # 自动测速(git 克隆端点: v6 / v4 / gh-proxy / 直连), 选用最快的
gitx proxy on # 开启加速(v6.gh-proxy.org)
gitx proxy on v4 # 换用 IPv4 端点(v4.gh-proxy.org)
gitx proxy off # 关闭加速(直连)
gitx proxy default # 恢复默认加速源
gitx proxy set https://gh-proxy.com # 自定义加速源
gitx proxy release # 查看 Release 专用加速源
gitx proxy release on v4 # 只给 Release 换加速源(其它功能照旧)
gitx proxy release off # Release 直连(其它功能仍走加速)
gitx proxy release follow # 取消独立设置, 跟随全局
gitx proxy http http://127.0.0.1:7890 # 设置 git 的 HTTP(S) 代理(本地代理软件)
gitx proxy http off # 取消 git 代理
gitx proxy install # 写入 git 全局 insteadOf 规则, 让普通 git 命令也走加速
gitx proxy uninstall # 移除上述规则
gitx proxy test # 测试加速源连通性(git 克隆 / raw / API; Release 独立设置时会一并测试)配置文件是 TOML（带中文注释, 人类可读可改）: ~/.config/gitx/config.toml
（或 $XDG_CONFIG_HOME/gitx/config.toml）。改完即生效, 用 gitx config set 改写时注释也不会丢。
旧版的 config.json 首次运行会自动迁移成 config.toml（原文件保留为 config.json.bak）。
gitx config # 查看配置(表格)
gitx config edit # 用 $VISUAL / $EDITOR 直接编辑配置文件
gitx config path # 只打印配置文件路径
gitx config set depth 0 # 默认完整克隆
gitx config set branch develop # 默认分支 (下载时 URL 未带分支则用它, 空 = 远端默认)
gitx config set dest ~/下载 # 默认下载目录 (支持 ~; 命令行给的路径优先)
gitx config set resume false # 关掉断点续传
gitx config set sync_rebase false # gitx sync 用合并而非变基 (--merge 仍可临时覆盖)
gitx config set color never # 关闭彩色输出 (auto / never)
gitx config set assume_yes true # 处处跳过确认, 相当于每条命令都带 -y
gitx config set message 更新 # 默认提交信息
gitx config set token ghp_xxx # 设置 API token (提高限额到 5000 次/小时, 显示时自动打码)
gitx config set release_proxy v4 # 等价于 gitx proxy release set v4 (空值 = 跟随全局)
gitx config reset # 恢复默认配置
gitx doctor # 环境自检(git/gh/token/仓库/加速源/编码)
gitx status / gitx log --oneline # git 子命令直接透传 (原生 init: gitx git init)
gitx dowload ... # 子命令笔误会给出形近提示透传规则: branch / switch / merge / rebase / fetch / stash / tag / commit /
diff / discard / clean 现在都是 gitx 自己的命令 (有中文提示、确认与加速支持);
其余词仍原样交给 git (gitx status / gitx log --oneline / gitx blame ...),
需要未经改写的行为时用 gitx git <任意命令> 显式透传。
环境变量 GITX_PROXY=off|v6|v4|gh-proxy|https://... 可设置全局默认加速源,
GITX_RELEASE_PROXY=... 单独覆盖 Release 功能的加速源。
- git 透传不加载 typer:
gitx status/gitx --version由只依赖标准库的快速分发处理, 从 ~2.5s 降到 ~0.6s(含 uv 与 python 启动, 低配机器上); 加速源列表也不再靠多语言输出的git help -a猜测, 直接交给 git 自己执行。 - 文件夹下载快 8 倍:
git/git的一个子目录, 纯稀疏检出 30.7s / 14 MB → 部分克隆 (--filter=blob:none --sparse) 3.8s / 4.2 MB。只拉取目标目录的 blob。 - 源码包路线:
-x走 API 的/tarball/<ref>, 单个 HTTP 流, 不要 git 历史时比克隆省一整个 git 握手与对象协商。 - 断点续传: 大附件中断不再从头下;
.part与目标不符(416 / 大小对不上)时自动丢弃重来。 - 按需加载: rich.progress / rich.prompt / urllib / shutil / questionary 全部用到才导入。
- 并行下载实测没有收益(镜像按连接限速, 4 路并发比单路还慢), 故不做 —— 有证据才动刀。
- 加速 = 在 GitHub 域名 URL 前拼镜像前缀, 如
https://v6.gh-proxy.org/https://github.com/... - Release 加速可独立设置:
release_proxy(或GITX_RELEASE_PROXY) 只作用于gitx release与发布页链接, 解析链--proxy > GITX_RELEASE_PROXY > release_proxy > GITX_PROXY > proxy; 留空 = 跟随全局, 所以不设置时行为与旧版一致 —— 某个镜像对 API 限流时只需换 Release 那条链路 - 拉取(克隆 / 下载 / Release 附件 / API)走加速; 推送走直连 —— 镜像对
git push返回 405 - 存在 URL 重写规则(全局或仓库本地
--local)时, 推送地址自动改用 SSH(gh 已配好密钥), 避免 https 推送被规则重写到镜像 gitx proxy install利用 git 自身的url.<镜像>/.insteadOf规则, 全局生效- 分支自动探测:
git ls-remote --symref取默认分支(main/master) - 文件夹下载: 部分克隆 + 稀疏检出(
--filter=blob:none --sparse), 检出时按需拉取目标目录的 blob gitx proxy auto用git ls-remote实测各加速源(含直连)克隆端点耗时, 选最快的- 命令分发:
gitx入口先走快速通道(git 透传 / --version), 其余交给 Typer 子命令; 首词像链接(https:// / git@ )就自动补download gitx ignore复用 github/gitignore 官方模板库, 索引缓存 7 天, 按名拉取 (raw 也走加速)
src/gitx/
__init__.py 入口: 快速分发先行, 需要时才加载 typer dispatch.py git 透传 / --version 快速通道 (仅标准库)
console.py rich 控制台 (Catppuccin 主题) config.py 持久化配置 (~/.config/gitx/config.toml, TOML + 自动迁移旧 JSON)
accel.py 加速源与测速 gitcmd.py git 命令封装 (前置检查/分支/推送/维护原语)
github.py URL 解析 + REST API 客户端 (token 复用) net.py HTTP 下载: 断点续传 + 进度条
download.py 仓库/文件夹/源码包下载 release.py Release 附件(API)
repo.py init / info / commit / diff / discard / clean / undo / graph / tidy / url
branch.py branch / switch / merge / rebase / fetch
stash.py 暂存 (save / list / pop / apply / drop / show / clear)
tag.py 标签 (list / new / delete / push)
hub.py search / stat / web / ignore
sync.py push / pull / sync
remote.py 远程管理 (拉取加速 + 推送直连) submodule.py 子模组 (拉取同样走加速)
pr.py Pull Request 列表 / 详情 / 创建 cache.py 缓存查看与清理
upgrade.py 自更新 (加速下载 wheel 后 uv/pip 重装)
uv run python -m gitx --help
uv run python -m gitx release cli/cli --list # API + 加速 的实测例子
uv build --out-dir dist # 构建 sdist + wheel (发布用)按 RELEASE_TEMPLATE.md 执行: 版本号双改 (pyproject.toml + __init__.py),
uv build --out-dir dist 产出 dist/gitx-X.Y.Z.tar.gz 与 dist/gitx-X.Y.Z-py3-none-any.whl,
打 tag 后用 gh release create 同时上传这两个附件 (源码包 + wheel), 上传后再下载验证 wheel 可安装。
本项目以 MIT 许可 开源, 版权归 FLT18355 (2026)。