# @bensandee/forgejo-cli 中文文档

规范地址：https://npmcn.com/package/%40bensandee/forgejo-cli/

版本：0\.10\.0
npm 元数据更新时间：2026-11-05T17:49:40.610Z
中文译文更新时间：2026-11-07T22:26:57.861Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bensandee/forgejo-cli
原文对照：https://npmcn.com/package/%40bensandee/forgejo-cli/?lang=original
源码仓库：https://codeberg.org/bensandee/tooling

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：195 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2026-09-30T18:06:47.215Z
- 最新版本发布：2026-11-05T17:49:40.438Z
- 近 30 天下载量：2742（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

bst-fj:Forgejo API 没有其他bst命令

## 安装

```sh
npm install @bensandee/forgejo-cli
```

也可以使用：`pnpm add @bensandee/forgejo-cli`、`yarn add @bensandee/forgejo-cli`、`bun add @bensandee/forgejo-cli`

## README

# @bensandee/forgejo-cli (英语)

`bst-fj`: Forgejo API 命令,没有其他命令 `bst`。这些命令中大多数用于在 `@bensandee/tooling`是因为 `bst` 纸箱; `issue:*`, (中文(简体) ), `pr:create`, (中文(简体) ), `pr:update`, (中文(简体) ), `pr:ready`, (中文(简体) ), `pr:reopen` 财务报告和审定财务报表 `pr:retarget` 仍然如此,并运行同样的代码.

## 安装

```bash
pnpm add -D @bensandee/forgejo-cli

# Or run directly
pnpm dlx @bensandee/forgejo-cli --help
```

## 连接

每个命令都以同样的方式找到它的寄存器和符号 `bst` 已经 它读取环境 第一条:

| 变量 | 含义 |
| --- | --- |
| `FORGEJO_SERVER_URL` | 伪造的基址, 如 `https://codeberg.org` |
| `FORGEJO_REPOSITORY` | 目标存储器为 `owner/repo` |
| `RELEASE_TOKEN` | API 代号 (`FORGEJO_TOKEN` 未设置时使用) |

未设置服务器 URL 或寄存器时, 它会倒回 `origin` git 遥控器,然后到 `package.json#repository`。命令需要 `--repo` 目标存储器.

## 环境文件

设定 `BST_ENV_FILE` 进入一个嵌入文件的路径,以及 `bst-fj` 装入之前,其他东西运行 一样 `bst` 已经 环境中已经设置的变量总是胜过文件 。 文件 不能读取的命令在命令开始前停止。 只是为了发展:一种生产 运行应该从环境得到每个变量,然后离开 `BST_ENV_FILE` 未设.

## 图标

运行 `bst-fj --help` 清单和 `bst-fj <command> --help` 每个命令的旗帜。 每个 命令需要 `--json`它印出一个JSON文件 包括失败.

| 命令 | 它会做什么 |
| --- | --- |
| `labels` | `list` 仓库的标签,或 `sync` 一个名称集从一个 `--file` (创建和更新,永不删除) |
| `secrets` | `set`, (中文(简体) ), `list` 或者说 `delete` 福吉霍行动秘密 |
| `webhooks` | 列出一个实例( 系统、 用户、 org 和 repo) 的网点 |
| `release:create` | 创建用于伪造的标签的释放; 拒绝所缺少的标签, 除非给出 `--target` |
| `pr:checks` | 阅读拉动请求的CI判决,可选 `--wait` 让它安顿下来 |
| `pr:list` | 列出仓库的拉动请求 |
| `commit:status` | 读取承诺 SHA 、 分支、 标记或 git ref 的状态检查 |
| `issue:*` | `view`, (中文(简体) ), `list`, (中文(简体) ), `comment`, (中文(简体) ), `create`, (中文(简体) ), `update`, (中文(简体) ), `download`, (中文(简体) ), `label`, (中文(简体) ), `unlabel`, (中文(简体) ), `set-labels`, (中文(简体) ), `close`, (中文(简体) ), `reopen` |
| `pr:create` | 推动当前分支并打开拉动请求,在没有给出标题和正文时得出标题和正文;没有报告封闭式索赔,因为 `bst pr:create` 已经 |
| `pr:update` | 推动当前分支并更新其开放拉动请求 |
| `branch:list` | 列出仓库的分支 |
| `branch:delete` | 通过 API 删除分支; 拒绝时报告伪造的理由 |
| `pr:files` | 列出拖动请求更改文件 |
| `pr:merge` | 将一个开放的、非草稿的、可合并的公关合并到它读到的头;拒绝关闭、起草、冲突、未经证实或非绿色检查(包括零状态),除非 `--ignore-checks`· ; `--delete-branch` 选择进入 |
| `pr:ready` | 标出拖拉请求草稿, 丢出一个 `WIP:` 前缀或取用 `--title`,并确认伪造不再报告草稿;数字默认为当前分支的开放式拖取请求 |
| `pr:close` | 关闭打开的拉动请求, 可选择发布 `--comment`编号 :`--comment-file` 首先; 不写已关闭或合并的公关报告; 拒绝发行 |
| `pr:reopen` | 重新打开一个已关闭的拖放请求, 确认它打开的伪造报告; 报告一个已打开的 PR 不写; 拒绝合并的 PR 和一个问题; 数字默认为当前分支的已关闭的未合并拖放请求 |
| `pr:retarget` | 在一个新的基站分支重新指定一个打开的拉取请求,确认所取的伪造,并报告其可合并性作为建议;数字默认为当前分支的打开拉取请求 |
| `workflow:dispatch` | 发送工作流程与 `--workflow`, (中文(简体) ), `--ref` 且可重复 `--input`; 带 `--repo owner/repo`,而不是一个 URL |
| `ci:runs` | 列出寄存器的工作流程及其工作, 通过工作流程过滤、 校对、 拉请求、 头 SHA 或状态 |
| `ci:log` | 打印一个工作流程的全部日志, 或者使用 `--grep` 只有文本匹配的行 |

零张贴状态读作 `no-status`从来没有像绿色。 每个命令只有福吉霍:在 GitHub, 使用 `gh`编辑 `issue:*`, (中文(简体) ), `pr:create`, (中文(简体) ), `pr:update`, (中文(简体) ), `pr:ready`, (中文(简体) ), `pr:reopen` 财务报告和审定财务报表 `pr:retarget` 命令取同一种旗帜并打印 不变 `--json` 文档为 `bst`'',除了那个 `issue:create` 对受让人没有设定违约.

## 常见问题

### @bensandee/forgejo-cli 是什么？

bst-fj:Forgejo API 没有其他bst命令

### 如何安装 @bensandee/forgejo-cli？

在项目目录运行 npm install @bensandee/forgejo-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bst-fj，可以用 npx bst-fj 直接运行。

### @bensandee/forgejo-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bensandee\_\_forgejo-cli 是否存在。

### @bensandee/forgejo-cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bensandee/forgejo-cli 可以商用吗？

@bensandee/forgejo-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bensandee/forgejo-cli 的下载量有多少？

根据 npm 官方下载统计，@bensandee/forgejo-cli 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,742 次，日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bensandee/forgejo-cli 还在维护吗？

最新版本 0\.10\.0 发布于 2026/11/06（2 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/10/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。