Merge pull request '日常操作命令：issues/pulls/labels/milestones/releases/repos/api（#8）' (#16) from feature/issue8-dailyops into main

internal/cli/cli.go

@@ -150,6 +150,78 @@ var globalFlags = map[string]bool{
 	"--timeout": true,
 }
 
+// extractGlobals 從 args 中「抽取」全域選項（可出現在命令之後、與命令
+// 旗標交錯），其餘引數依原順序保留給子命令剖析。未知的選項一律留給
+// 子命令處理（可能是命令旗標，如 --has-work），不在這裡報錯。
+func extractGlobals(g *Globals, args []string) ([]string, error) {
+	rest := make([]string, 0, len(args))
+	applyGlobal := func(name, value string) error {
+		switch name {
+		case "--url":
+			if strings.TrimSpace(value) == "" {
+				return &ErrUsage{Msg: "--url must not be empty"}
+			}
+			g.URL = value
+		case "--token":
+			g.Token = value
+		case "--config":
+			if strings.TrimSpace(value) == "" {
+				return &ErrUsage{Msg: "--config must not be empty"}
+			}
+			g.ConfigPath = value
+		case "--output":
+			f, err := gitea.ParseFormat(value)
+			if err != nil {
+				return &ErrUsage{Msg: err.Error()}
+			}
+			g.Output = f
+		case "--timeout":
+			d, err := time.ParseDuration(value)
+			if err != nil || d <= 0 {
+				return &ErrUsage{Msg: fmt.Sprintf("invalid --timeout %q (want e.g. 30s)", value)}
+			}
+			g.Timeout = d
+		}
+		return nil
+	}
+	i := 0
+	for i < len(args) {
+		arg := args[i]
+		if arg == "--" {
+			rest = append(rest, args[i+1:]...)
+			return rest, nil
+		}
+		if !strings.HasPrefix(arg, "--") {
+			rest = append(rest, arg)
+			i++
+			continue
+		}
+		name, inline, hasInline := strings.Cut(arg, "=")
+		_, ok := globalFlags[name]
+		if !ok {
+			// 不是全域選項：留給子命令（可能是 --has-work 這類命令旗標）。
+			rest = append(rest, arg)
+			i++
+			continue
+		}
+		var value string
+		if hasInline {
+			value = inline
+		} else {
+			if i+1 >= len(args) {
+				return nil, &ErrUsage{Msg: fmt.Sprintf("global option %q requires a value", name)}
+			}
+			i++
+			value = args[i]
+		}
+		if err := applyGlobal(name, value); err != nil {
+			return nil, err
+		}
+		i++
+	}
+	return rest, nil
+}
+
 // parseGlobals 從 args 前端取走全域選項，回傳剩餘引數（命令與其參數）。
 // 遇到第一個非選項引數即停；不認得的選項或缺少值都回 ErrUsage。
 func parseGlobals(g *Globals, args []string) ([]string, error) {
@@ -218,20 +290,43 @@ func parseGlobals(g *Globals, args []string) ([]string, error) {
 }
 
 // dispatch 執行已註冊的子命令，把錯誤轉成結束碼並輸出。
+// 旗標剖析交由各命令自行處理（不同命令有不同旗標，如 pulls --mine）；
+// 全域選項允許出現在命令之後（README 範例：teai next --output table），
+// dispatch 先從 args 剝離全域選項併入 Globals，其餘（含命令自己的旗標，
+// 如 --has-work）原樣交給命令，不會誤判為未知全域選項。
 func dispatch(env *Env, name string, args []string) int {
 	cmd := commands[name]
-	fs := flag.NewFlagSet("teai "+name, flag.ContinueOnError)
-	fs.SetOutput(env.Err)
-	if err := fs.Parse(args); err != nil {
+	g := env.Globals
+	rest, err := extractGlobals(&g, args)
+	if err != nil {
+		fmt.Fprintf(env.Err, "teai: %v\n\n", err)
+		printUsage(env.Err)
 		return int(ExitUsage)
 	}
-	if err := cmd.run(env, fs.Args()); err != nil {
+	env.Globals = g
+	if err := cmd.run(env, rest); err != nil {
 		fmt.Fprintf(env.Err, "teai %s: %v\n", name, err)
 		return int(exitCodeFor(err))
 	}
 	return int(ExitOK)
 }
 
+// errHelp 表示使用者要求該命令的說明（-h/--help）；FlagSet 已自行印出
+// 用法，靜默成功結束即可。
+var errHelp = errors.New("help requested")
+
+// parseFlags 剖析命令旗標：-h/--help 回 errHelp（由 exitCodeFor 視為成功），
+// 其他剖析錯誤回 ErrUsage。
+func parseFlags(fs *flag.FlagSet, args []string) error {
+	if err := fs.Parse(args); err != nil {
+		if errors.Is(err, flag.ErrHelp) {
+			return errHelp
+		}
+		return &ErrUsage{Msg: err.Error()}
+	}
+	return nil
+}
+
 // exitCodeFor 把命令錯誤映射到結束碼：用法錯誤 → 2，API 錯誤 → 3，
 // 其他（內部）→ 1。
 func exitCodeFor(err error) ExitCode {