背景

拆自专项 issue gitcode-cli/cli#506 §3.2。对齐 gh workflow run。

API 端点（已就绪）

POST /api/v8/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches

• 路径参数：owner、repo、workflow_id（也可传带 yml/yaml 后缀的文件名，非全路径）
• 请求体：

  {
    "ref": "string (分支名或 tag 名)",
    "inputs": { "key": "value" }
  }
  

• 响应 201：

  { "workflow_id": "string", "workflow_run_id": "string" }
  

API 文档：api-doc/docs/api/actions/post-api-v8-repos-owner-repo-actions-workflows-workflow-id-dispatches.md

需求

新增 gc actions workflow run 子命令，手动触发流水线（workflow_dispatch）。

命令接口

gc actions workflow run [<workflow-id> | <filename>] -R owner/repo [flags]

Flags:

• -r, --ref <string>：分支或 tag 名称
• -f, --raw-field <key=value>：添加字符串参数
• -F, --field <key=value>：添加字符串参数（支持 @ 语法读取文件）
• --json：JSON 输出（返回 workflow_run_id）
• -R, --repo：仓库
• --yes：跳过确认（破坏性操作，默认需确认）

新增代码

• api/queries_actions.go：新增 DispatchWorkflowRequest、DispatchWorkflowResponse、DispatchActionsWorkflow 函数
• pkg/cmd/actions/workflow/run/run.go：run 子命令
• 复用 cmdutil.ScanContentForSecrets 扫描 inputs

对齐 gh 参考

gh workflow run [<workflow-id> | <filename>] [--ref <ref>] [-f <key=value>] [-F <key=value>]

验收标准

• gc actions workflow run <workflow-id> -R owner/repo --ref main 触发流水线
• 支持 -f key=value 传入 inputs
• 支持传文件名（如 ci.yml）作为 workflow_id
• --json 输出 workflow_run_id
• 破坏性操作有确认保护，--yes 跳过
• inputs 内容经 secret 扫描
• 单元测试覆盖请求构造和响应解析
• 真实命令验证（使用 infra-test/* 仓库）
• 更新 docs/COMMANDS.md

Refs gitcode-cli/cli#506