gh-api-push
v1.0.0
Published
Push files to a GitHub repo via the Git Data API — a lightweight fallback channel when github.com git push is unreachable (e.g. network blocks) but api.github.com still works.
Maintainers
Readme
轻记 TODO
本地优先的待办工具:数据先落本机,云端同步到你自己的飞书多维表格——不放任何人的服务器。
- 站点 / 网页版:https://439436269-ctrl.github.io/qingji-todo-web/
- 多端形态:网页版(PWA)· Android(APK)· iOS(Xcode 工程 + OTA 安装)
- 技术方案见 技术方案-多端同步.md
api-push(本包 CLI)
api-push 是本仓库内含的原子 CLI:通过 GitHub Git Data API 把指定文件提交并推送到仓库——当 github.com 的 git push 直连被墙/握手失败、而 api.github.com 仍可达时,作为替代推送通道。
# 安装
npm install -g api-push
# 用法(在目标 git 仓库目录内执行)
export GH_TOKEN=ghp_xxx # 需要 repo 权限的 token
api-push "提交说明" path/to/file1.md path/to/file2.js
# 可选环境变量
# GH_REPO 目标仓库(默认 439436269-ctrl/qingji-todo)
# GH_ROOT 文件路径解析根目录(默认取当前目录,须是 git 仓库)- 零依赖,Node ≥ 18(内置 fetch)
- 二进制/图片等按文件类型自动选择 base64 或 UTF-8 blob
- 单次提交可携带多个文件;
HEAD从main分支读取
仓库内直接使用(无需安装):
GH_TOKEN=ghp_xxx node tools/api-push.cjs "提交说明" index.html