update docs

Author: qdriven

docs/Agents.md

@@ -102,9 +102,10 @@ spark git issues       # 从 Markdown 文档/任务创建 GitHub Issue
 ```bash
 spark git update -p /path/to/repos
 spark git update -p ~/workspace -p ~/projects
+spark git update --ssh                       # 强制通过 SSH 更新（HTTPS 不稳定时使用）
 ```
 
-详细文档: [docs/usage/update.md](docs/usage/update.md)
+详细文档: [docs/usage/git.md](docs/usage/git.md)
 
 #### `spark git submodule`
 将本地 Git 仓库添加为子模块，或将远程仓库克隆为子模块。

docs/README.md

@@ -69,7 +69,7 @@ go test ./internal/git/... -v -run TestFunctionName
 
 | Command | Description |
 |---------|-------------|
-| `spark git update` | Update all repos to latest version |
+| `spark git update [--ssh]` | Update all repos to latest version (`--ssh` 强制 SSH) |
 | `spark git submodule add [-p <path>]` | Add existing repos as submodules |
 | `spark git sync [repo]` | Sync all submodules to latest |
 | `spark git gitcode [-p <path>]` | Add Gitcode remote to repos |

docs/features/git.md

@@ -8,10 +8,11 @@
 
 ### 多仓库批量更新
 
-扫描配置目录下所有 Git 仓库，执行批量 `git pull`。适合同时维护多个仓库的日常更新。
+扫描配置目录下所有 Git 仓库，执行批量 `git fetch --all && git pull`。适合同时维护多个仓库的日常更新。当 HTTPS 连接不稳定时，可加 `--ssh` 强制通过 SSH 更新（仅本次有效，不修改仓库配置的远程地址）。
 
 ```bash
 spark git update -p ~/workspace
+spark git update -p ~/workspace --ssh
 ```
 
 ### Submodule 管理

docs/index.md

@@ -74,7 +74,7 @@ go test ./internal/git/... -v -run TestFunctionName
 
 | Command | Description |
 |---------|-------------|
-| `spark git update` | Update all repos to latest version |
+| `spark git update [--ssh]` | Update all repos to latest version (`--ssh` 强制 SSH) |
 | `spark git submodule add [-p <path>]` | Add existing repos as submodules |
 | `spark git sync [repo]` | Sync all submodules to latest |
 | `spark git gitcode [-p <path>]` | Add Gitcode remote to repos |

docs/quick-start/getting-started.md

@@ -29,6 +29,7 @@ github_owner: your-username
 
 ```bash
 spark git update -p ~/workspace               # 更新所有仓库
+spark git update -p ~/workspace --ssh         # HTTPS 不稳定时强制通过 SSH 更新
 spark git init --owner variableway            # 初始化仓库并创建 GitHub 远程
 spark git submodule add -p /path/to/repos          # 添加仓库为子模块
 spark git batch-clone variableway -o ./repos  # 克隆组织仓库

docs/spec/git.md

@@ -14,15 +14,16 @@ spark git
 
 ## spark git update
 
-更新所有 Git 仓库到最新版本。扫描配置中 `repo-path` 下的所有仓库，执行 `git pull`。
+更新所有 Git 仓库到最新版本。扫描配置中 `repo-path` 下的所有仓库，执行 `git fetch --all && git pull`。
 
 ```
-spark git update [-p <path>]
+spark git update [-p <path>] [--ssh]
 ```
 
 | 标志 | 类型 | 默认值 | 必填 | 说明 |
 |------|------|--------|------|------|
 | `-p, --path` | stringSlice | `["."]` | 否 | 包含 Git 仓库的目录路径 |
+| `--ssh` | bool | `false` | 否 | 强制通过 SSH 更新（临时将 HTTPS GitHub URL 改写为 SSH，不修改仓库配置） |
 
 无参数。
 

internal/git/submodule.go

@@ -193,8 +193,13 @@ func rewriteGitModulesURLs(repoPath string) error {
 }
 
 func httpsToSSH(url string) string {
-	if strings.HasPrefix(url, "https://github.com/") {
-		return "git@github.com:" + strings.TrimPrefix(url, "https://github.com/")
+	if strings.HasPrefix(url, "https://") {
+		withoutScheme := strings.TrimPrefix(url, "https://")
+		if idx := strings.Index(withoutScheme, "/"); idx != -1 {
+			host := withoutScheme[:idx]
+			path := withoutScheme[idx+1:]
+			return "git@" + host + ":" + path
+		}
 	}
 	return url
 }

internal/git/updater.go

@@ -8,8 +8,20 @@ import (
 	"strings"
 )
 
+// httpsHost extracts the host from an HTTPS URL, or empty string if not HTTPS.
+func httpsHost(url string) string {
+	if !strings.HasPrefix(url, "https://") {
+		return ""
+	}
+	withoutScheme := strings.TrimPrefix(url, "https://")
+	if idx := strings.Index(withoutScheme, "/"); idx != -1 {
+		return withoutScheme[:idx]
+	}
+	return withoutScheme
+}
+
 // UpdateRepository updates a git repository to the latest version.
-// When useSSH is true, HTTPS GitHub remote URLs are forced to SSH for this
+// When useSSH is true, HTTPS remote URLs are forced to SSH for this
 // update via a transient url.insteadOf config override, without modifying the
 // repository's configured remote URLs.
 func UpdateRepository(repoPath string, useSSH bool) error {
@@ -22,15 +34,38 @@ func UpdateRepository(repoPath string, useSSH bool) error {
 	}
 	currentBranch := strings.TrimSpace(string(branch))
 
-	// gitArgs builds a git command scoped to the repo, prepending an SSH
-	// url.insteadOf override when useSSH is set so HTTPS GitHub URLs are
-	// transparently rewritten to SSH for the duration of this command only.
+	// Build url.insteadOf overrides for all HTTPS remotes when useSSH is set.
+	var sshOverrides []string
+	if useSSH {
+		remotesCmd := exec.Command("git", "remote")
+		remotesCmd.Dir = repoPath
+		remotesOut, err := remotesCmd.Output()
+		if err == nil {
+			for _, remote := range strings.Split(strings.TrimSpace(string(remotesOut)), "\n") {
+				if remote == "" {
+					continue
+				}
+				urlCmd := exec.Command("git", "remote", "get-url", remote)
+				urlCmd.Dir = repoPath
+				urlOut, err := urlCmd.Output()
+				if err != nil {
+					continue
+				}
+				remoteURL := strings.TrimSpace(string(urlOut))
+				if host := httpsHost(remoteURL); host != "" {
+					sshOverrides = append(sshOverrides,
+						"-c", fmt.Sprintf("url.git@%s:.insteadOf=https://%s/", host, host))
+				}
+			}
+		}
+	}
+
+	// gitArgs builds a git command scoped to the repo, prepending SSH
+	// url.insteadOf overrides when useSSH is set.
 	gitArgs := func(subcmd ...string) *exec.Cmd {
 		args := subcmd
-		if useSSH {
-			args = append([]string{
-				"-c", "url.git@github.com:.insteadOf=https://github.com/",
-			}, args...)
+		if len(sshOverrides) > 0 {
+			args = append(sshOverrides, args...)
 		}
 		c := exec.Command("git", args...)
 		c.Dir = repoPath