用途：在终端管理 Forgejo 或 Gitea 服务器，处理议题、拉取请求、仓库、文件内容、标签、里程碑、发布、Webhook 和用户等日常操作。
主要能力：提供 issue、pr、repo、content、label、milestone、release、hook、user 等一等命令；未覆盖的操作可用 api 命令调用任意 /api/v1/ 端点，支持 JSON、原始文件、multipart 上传/表单和自定义请求头。content 命令要求 base64 内容，更新或删除需提供当前 SHA。
使用方式：运行 python3 scripts/forgejo-cli。--agent（默认）使用 FORGEJO_AGENT_TOKEN，--user 使用 FORGEJO_USER_TOKEN，--server URL 选择安装实例；若包装脚本提供 FORGEJO_SERVER 可依赖环境变量，否则显式传 --server。列表与搜索请求支持 --page 和 --limit，加 --include-response 可获取 HTTP 状态及 link、x-total-count 分页头。--json 只向 stdout 写一个 JSON 值，诊断信息走 stderr。
安全与限制：变更操作需 --force/--yes/-y，或使用 --dry-run；--dry-run --json 只输出包含 method、path、query、body 的计划，不发起网络请求。--help 不读取凭据也不连接服务器，路径片段会被编码。使用 api 前应查阅所选服务器的 /api/swagger 或 /swagger.v1.json，并了解端点路由、认证、分页与兼容性；401/403/422 及传输失败可参考故障排查。具体版本兼容范围与安装细节暂未提供。