用途：通过 orbit CLI 管理 Forgejo（或 Gitea）实例，涵盖仓库、拉取请求与评审、议题、Forgejo Actions 运行与作业日志、发布，以及透传到其他 API 端点。
前提条件：需安装 orbit CLI，若 which orbit 失败，可执行 brew install jorgemuza/tap/orbit，或 curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh。需在 ~/.config/orbit/config.yaml 中配置含 forgejo 服务的 profile，base_url 必填（Forgejo 始终自托管，无默认主机）。需在实例的 Settings > Applications 生成个人访问令牌，配置为 method: token，可用 op:// 或 infisical:// 引用。用 orbit -p <profile> service ping <service-name> 验证。
用法：命令格式为 orbit -p <profile> forgejo <command> [flags]，别名 fj。仓库一律写作 owner/repo，列表与查看命令支持 -o json。
主要能力：拉取请求可 list、view、diff、comment、approve、request-changes（别名 needs-work）、merge（如 --method squash --delete-branch）、close；approve、request-changes 会回读校验状态，merge 会确认是否真正合并。CI 调试可用 run list（如 --status failure --limit 5）、run view、run log（--failed 或 --job <id>），run view 的 --exit-status 在运行未成功时返回非零。议题支持 list、view、create、comment、close。其他端点用 api 透传，如 orbit -p homelab fj api /api/v1/version，支持 -X、-f、-F、-H、--input、--paginate、-i。
限制与注意：工作流运行有两个编号，URL 中的是 index_in_repo，API 路径需实例级 id，orbit fj run 命令接受 URL 中可见编号并安全解析，不要手写 api /api/v1/.../actions/runs/<url-number>。Forgejo 的 issue 端点也会返回拉取请求，orbit fj issue list 会过滤，原始 api 调用不会。Forgejo 用 status 表示运行结果，没有 GitHub 那样的 conclusion。请求固定到配置主机，指向别处的端点或重定向会被拒绝而非携带令牌跟随。Gitea 实例使用相同 API，可用同一服务类型。