spark git — 命令规格
spark git — 命令规格
Git 仓库管理命令组。
父命令
spark git
无参数，无标志。
spark git update
更新所有 Git 仓库到最新版本。扫描配置中 repo-path 下的所有仓库，执行 git pull。
spark git update [-p <path>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-p, --path |
stringSlice | ["."] |
否 | 包含 Git 仓库的目录路径 |
无参数。
spark git create
创建 Mono-repo，将指定目录下的所有仓库作为 Git Submodule 添加。
spark git create -n <name> -o <path> [-p <path>]
| 标志 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
-n, --name |
string | mono-repo |
否 | Mono-repo 目录名 |
-o, --output |
string | 同源路径 | 否 | 输出路径 |
-p, --path |
stringSlice | ["."] |
否 | 包含 Git 仓库的目录路径 |
无参数。
spark git sync
同步 Mono-repo 中所有 Submodule 到最新版本。
spark git sync <mono-repo-path>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mono-repo-path |
string | 是 | Mono-repo 路径 |
无标志。
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 |