spark git — 命令规格
spark git — 命令规格
Git 仓库管理命令组。
父命令
spark git
无参数，无标志。
spark git update
更新所有 Git 仓库到最新版本。扫描配置中 repo-path 下的所有仓库，执行 git fetch --all && git pull。
spark git update [-p <path>] [--ssh]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-p, --path |
stringSlice | ["."] |
否 | 包含 Git 仓库的目录路径 |
--ssh |
bool | false |
否 | 强制通过 SSH 更新（临时将 HTTPS GitHub URL 改写为 SSH，不修改仓库配置） |
无参数。
spark git init
初始化当前目录为 Git 仓库并创建 GitHub 远程。
spark git init [--owner <owner>] [--repo <name>] [--private] [--skip-gh]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
--owner |
string | 配置文件 github-owner |
是* | GitHub 所有者 |
-r, --repo |
string | 当前目录名 | 否 | 仓库名称 |
--private |
bool | false |
否 | 创建私有仓库 |
--skip-gh |
bool | false |
否 | 跳过 gh repo create |
* --owner 可从 ~/.spark.yaml 中的 github-owner 配置读取。
流程: git init → git config → submodule 扫描（最深 3 层） → .gitignore → git commit → gh repo create --push
spark git submodule init
初始化（克隆）所有已注册但尚未检出的子模块。
spark git submodule init [-j <n>] [-r] [--name <name>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-j, --parallel |
int | 1 |
否 | 并行克隆 worker 数（大于 1 时并行） |
-r, --recursive |
bool | false |
否 | 同时初始化嵌套子模块 |
--name |
string | 否 | 仅初始化指定名称的子模块 |
无参数。
流程：
- 当
parallel == 1：直接执行git submodule update --init [--recursive] - 当
parallel > 1：解析git submodule status找出未初始化的子模块，用 semaphore 并发的 goroutine 逐个执行git submodule update --init <name>，最后执行--recursive（若是）
spark git submodule status
显示所有子模块的初始化状态、commit 和分支。
spark git submodule status
无标志，无参数。
输出：表格格式，包含 PATH、INIT（✅/❌）、COMMIT、BRANCH 列。
spark git submodule ensure-ssh
将 .gitmodules 中所有 HTTPS GitHub URL 替换为 SSH 格式。同时更新父仓库的 origin remote。
spark git submodule ensure-ssh
无标志，无参数。
转换规则：https://github.com/<owner>/<repo>.git → git@github.com:<owner>/<repo>.git
spark git submodule add
添加 Git 仓库为子模块。支持两种模式：
- 本地模式：将目录下已有的 Git 仓库添加为子模块，无需重新克隆
- 远程模式：将远程 Git 仓库克隆并添加为子模块
本地模式
spark git submodule add [-p <path>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-p, --path |
string | . |
否 | 包含 Git 仓库的目录路径 |
无参数。
智能检测行为：
| 场景 | 输出 |
|---|---|
| 目标已是 submodule（160000） | Skipping <name>: already as submodule |
| 目标与父仓库 URL 相同（worktree） | Skipping <name>: already as submodule |
| 目录存在但不是 submodule | Skipping <name>: directory already exists (use 'git submodule add' manually) |
| 正常添加 | Adding submodule: <name> (<url>) |
远程模式
spark git submodule add <repo-url> [-n <name>] [-p <path>]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
repo-url |
string | 是 | 远程仓库 URL（HTTPS 或 SSH） |
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-n, --name |
string | 仓库名 | 否 | 子模块路径名称 |
spark git sync
同步当前仓库中所有 Submodule 到最新版本。
spark git sync [repo-path] [-r]
| 参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
repo-path |
string | . |
否 | 仓库路径 |
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-r, --recursive |
bool | false |
否 | 递归同步嵌套子模块 |
流程：
git fetch --all— 获取所有远程最新代码InitAllSubmodules— 初始化缺失的子模块（从.gitmodules中读取，失败不中断）git submodule update --remote --merge— 更新所有子模块到最新版本并合并
spark git gitcode
为仓库添加 Gitcode 远程仓库。自动将 GitHub URL 转换为 Gitcode URL。
spark git gitcode [--url <url>] [-p <path>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
--url |
string | 自动转换 | 否 | 自定义 Gitcode URL |
-p, --path |
stringSlice | ["."] |
否 | 包含 Git 仓库的目录路径 |
无参数。
spark git config
配置当前仓库的 Git 用户信息。
spark git config [--username <name>] [--email <email>] [repo-path]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
--username |
string | 配置文件值 | 否 | Git 用户名 |
--email |
string | 配置文件值 | 否 | Git 邮箱 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
repo-path |
string | 否 | 仓库路径，默认 . |
spark git url
获取仓库的 Git 远程 URL。
spark git url [repo-path]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
repo-path |
string | 否 | 仓库路径，默认 . |
无标志。
spark git batch-clone
克隆 GitHub 组织或用户下的所有仓库。自动检测账号类型。
spark git batch-clone <account-name-or-url> [--ssh] [--include <pattern>] [--exclude <pattern>] [-o <dir>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
--ssh |
bool | false |
否 | 使用 SSH URL 克隆 |
--include |
string | 否 | 仅包含匹配的仓库（逗号分隔） | |
--exclude |
string | 否 | 排除匹配的仓库（逗号分隔） | |
--include-forks |
bool | false |
否 | 包含 fork 的仓库 |
-o, --output |
string | . |
否 | 克隆输出目录 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
account-name-or-url |
string | 是 | 组织名、用户名或 URL |
spark git update-org-status
更新组织 README 中的仓库状态列表。
spark git update-org-status <org-name-or-url> [--dry-run] [--update-dot-github] [--section <name>] [-o <path>] [--skip-push]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-o, --output |
string | .github/README.md |
否 | 输出文件路径 |
--dry-run |
bool | false |
否 | 仅打印不写入 |
--update-dot-github |
bool | false |
否 | 直接更新组织的 .github 仓库 |
--section |
string | Project List |
否 | README 中更新的章节名 |
--skip-push |
bool | false |
否 | 跳过 git commit 和 push |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
org-name-or-url |
string | 是 | 组织名或 URL |
spark git push-all
扫描目录中的所有 Git 仓库，自动提交并推送所有更改。
spark git push-all [-p <path>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-p, --path |
stringSlice | ["."] |
否 | 包含 Git 仓库的目录路径 |
无参数。
行为：
- 跳过非 GitHub 仓库
- 跳过无更改的仓库
- 自动
git add -A→git commit→git push - 遇到错误打印提示并继续下一个仓库
spark git scan
递归扫描目录中的 Git 仓库，可选从 GitHub/GitLab API 获取元数据，并保存到 SQLite 数据库。
spark git scan [folder-path] [-d <db-path>] [--skip-api]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
folder-path |
string | . |
否 | 要扫描的目录路径 |
-d, --db |
string | ~/.innate/feeds.db |
否 | SQLite 数据库路径 |
--skip-api |
bool | false |
否 | 跳过 API 调用，仅扫描本地仓库 |
配置项 git.scanner.db（~/.spark.yaml）可覆盖默认数据库路径。
行为：
- 递归查找
.git目录，解析origin远程 URL - 支持 GitHub、GitLab、Bitbucket
- 按
pathupsert 到 SQLite 表repos - 环境变量
GITHUB_TOKEN用于 GitHub API 认证
Last updated:
编辑此页
Recent commits
