gh-api-push 1.0.0

package/README.md

@@ -0,0 +1,34 @@
+# 轻记 TODO
+
+本地优先的待办工具：数据先落本机，云端同步到**你自己的飞书多维表格**——不放任何人的服务器。
+
+- 站点 / 网页版：https://439436269-ctrl.github.io/qingji-todo-web/
+- 多端形态：网页版（PWA）· Android（APK）· iOS（Xcode 工程 + OTA 安装）
+- 技术方案见 [技术方案-多端同步.md](技术方案-多端同步.md)
+
+## api-push（本包 CLI）
+
+`api-push` 是本仓库内含的**原子 CLI**：通过 GitHub **Git Data API** 把指定文件提交并推送到仓库——当 `github.com` 的 git push 直连被墙/握手失败、而 `api.github.com` 仍可达时，作为替代推送通道。
+
+```bash
+# 安装
+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` 分支读取
+
+仓库内直接使用（无需安装）：
+
+```bash
+GH_TOKEN=ghp_xxx node tools/api-push.cjs "提交说明" index.html
+```

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "gh-api-push",
+  "version": "1.0.0",
+  "description": "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.",
+  "bin": {
+    "api-push": "tools/api-push.cjs"
+  },
+  "files": [
+    "tools/api-push.cjs"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "keywords": [
+    "github",
+    "git",
+    "push",
+    "git-data-api",
+    "offline-push",
+    "cli"
+  ],
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/439436269-ctrl/qingji-todo.git"
+  },
+  "scripts": {
+    "test": "node tools/api-push.cjs 2>&1 | grep -q GH_TOKEN && echo smoke-ok || echo smoke-fail"
+  }
+}

package/tools/api-push.cjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+// 通过 GitHub Git Data API 推送指定文件（github.com 直连被墙时的替代推送通道）
+// 用法: GH_TOKEN='...' api-push "<commit message>" <文件路径...>
+//   或在仓库内: node tools/api-push.cjs "<commit message>" <文件路径...>
+'use strict';
+const fs = require('fs');
+const path = require('path');
+
+const REPO = process.env.GH_REPO || '439436269-ctrl/qingji-todo';
+const TOKEN = process.env.GH_TOKEN;
+// 文件路径基准：优先 GH_ROOT，其次当前目录是 git 仓库时用它（npm 全局安装场景），否则回退包内相对路径（仓库内直跑场景）
+const ROOT = process.env.GH_ROOT
+  || (fs.existsSync(path.join(process.cwd(), '.git')) ? process.cwd() : path.resolve(__dirname, '..'));
+const API = 'https://api.github.com';
+const BINARY = /\.(png|jpg|jpeg|gif|jar|keystore|zip|apk|woff2?)$/i;
+
+const message = process.argv[2];
+const files = process.argv.slice(3);
+if (!TOKEN) { console.error('缺少环境变量 GH_TOKEN'); process.exit(1); }
+if (!message || !files.length) { console.error('用法: node tools/api-push.cjs "<msg>" <file...>'); process.exit(1); }
+
+async function api(method, url, body) {
+  const res = await fetch(API + url, {
+    method,
+    headers: {
+      Authorization: 'token ' + TOKEN,
+      'User-Agent': 'qingji-push',
+      'Content-Type': 'application/json',
+      Accept: 'application/vnd.github+json'
+    },
+    body: body ? JSON.stringify(body) : undefined
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) throw new Error(`${res.status} ${method} ${url}: ${JSON.stringify(data).slice(0, 300)}`);
+  return data;
+}
+
+(async () => {
+  const ref = await api('GET', `/repos/${REPO}/git/ref/heads/main`);
+  const head = await api('GET', `/repos/${REPO}/git/commits/${ref.object.sha}`);
+  const tree = [];
+  for (const rel of files) {
+    const buf = fs.readFileSync(path.join(ROOT, rel));
+    const isBinary = BINARY.test(rel);
+    // 防桌面端注入的标识被推上去（只针对 HTML；模式用转义书写，避免脚本自身误命中）
+    if (!isBinary && /\.html?$/i.test(rel)
+        && (/\u0041I\u751f\u6210/.test(buf.toString('utf8')) || /data-aigc-\u006dark/.test(buf.toString('utf8')))) {
+      console.error('中止：' + rel + ' 含桌面端注入的标识，请先清理该文件再推送');
+      process.exit(2);
+    }
+    const blob = isBinary
+      ? await api('POST', `/repos/${REPO}/git/blobs`, { content: buf.toString('base64'), encoding: 'base64' })
+      : await api('POST', `/repos/${REPO}/git/blobs`, { content: buf.toString('utf8'), encoding: 'utf-8' });
+    tree.push({ path: rel, mode: '100644', type: 'blob', sha: blob.sha });
+    console.log('blob:', rel);
+  }
+  const t = await api('POST', `/repos/${REPO}/git/trees`, { base_tree: head.tree.sha, tree });
+  const c = await api('POST', `/repos/${REPO}/git/commits`, { message, tree: t.sha, parents: [head.sha] });
+  await api('PATCH', `/repos/${REPO}/git/refs/heads/main`, { sha: c.sha });
+  console.log('pushed main ->', c.sha);
+})().catch(e => { console.error('FAIL:', e.message); process.exit(1); });