# @distilled\.cloud/forgejo 中文文档

规范地址：https://npmcn.com/package/%40distilled.cloud/forgejo/

版本：1\.0\.0-rc\.19
npm 元数据更新时间：2026-11-11T23:18:17.528Z
中文译文更新时间：2026-11-12T12:31:13.802Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40distilled.cloud/forgejo
原文对照：https://npmcn.com/package/%40distilled.cloud/forgejo/?lang=original
源码仓库：https://github.com/alchemy-run/distilled

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

- 包体积（解压后）：2.3 MB，98 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：effect ^4\.1\.2
- 首次发布：2026-09-09T22:04:17.741Z
- 最新版本发布：2026-11-11T23:18:17.109Z
- 近 30 天下载量：3123（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @distilled.cloud/forgejo
```

也可以使用：`pnpm add @distilled.cloud/forgejo`、`yarn add @distilled.cloud/forgejo`、`bun add @distilled.cloud/forgejo`

## README

# @ distilled.cloud/forgejo (英语)

效应原生SDK [福吉乔](https://forgejo.org/) 爱普, 由 Swagger 2.0 文档生成 `/swagger.v1.json`。 。 。 .

## 光谱源

生成器从包的光谱镜读取出一个文件:

```
specs/spec-mirror-forgejo/specs/forgejo.spec.json
```

Forgejo没有出版独立的谱系动画. 每个运行中的实例服务 描述其版本的文档 : `/swagger.v1.json`从 检查到 Forgejo 仓库的去模板 (单位:千美元)`templates/swagger/v1_json.tmpl`) (中文(简体) ). 镜子 (单位:千美元)[蒸馏-镜像/光谱-镜像-福热霍](https://github.com/distilled-mirror/spec-mirror-forgejo), (中文(简体) ), 在下面获取脚本 `stacks/distilled-submodules/spec-repos/forgejo/`(快照) 该模板在一个 **绑定释放标签** 与两个服务器侧 占位符 (`info.version`, (中文(简体) ), `basePath`以根架的方式填满 可能的话 弹出 `FORGEJO_VERSION` 在获取脚本中移动到更新 释放.

```bash
pnpm specs:fetch     # check out the mirror (from packages/forgejo)
pnpm generate        # convert + compile (see scripts/convert.ts)
```

在镜像存在之前, 或者对今天的上游进行再生 触摸子模块,从 repo 根实现本地化:

```bash
pnpm specs:local forgejo
DISTILLED_SPECS_LOCAL=1 pnpm generate forgejo
```

## 版式

-   `scripts/convert.ts` ——将文档的操作用标记桶,应用 rFC-6902 补丁链 `patches/<tag>/<operationId>.json`,以及 每个标签制作一个 Smithy 模型(`pnpm convert` 写给 带子 `.generated-specs/` 页:1.
-   `scripts/generate.ts` ——运行在进程中转换并编译模型 输入 `src/services/<tag>.ts`。 。 。 .
-   `src/credentials.ts`, (中文(简体) ), `src/protocol.ts`, (中文(简体) ), `src/errors.ts`, (中文(简体) ), `src/retry.ts`, (中文(简体) ), `src/traits.ts` ——手写;一切下 `src/services/` 实值 生成且从未用手编辑 .

## 使用量

```ts
import * as Redacted from "effect/Redacted";
import * as Forgejo from "@distilled.cloud/forgejo";

const program = Effect.gen(function* () {
  const repo = yield* Forgejo.repository.repoGet({
    owner: "acme",
    repo: "api",
  });
  return repo.clone_url;
}).pipe(
  Effect.provide(
    Forgejo.credentials({
      baseUrl: "https://git.example.com",
      token: Redacted.make(process.env.FORGEJO_TOKEN!),
    }),
  ),
);
```

`baseUrl` 是实例来源 `/api/v1` 前缀在 失踪. `FORGEJO_URL` 编号 : `FORGEJO_TOKEN` 驱动 `CredentialsFromEnv`。 。 。 .

## 常见问题

### 如何安装 @distilled\.cloud/forgejo？

在项目目录运行 npm install @distilled\.cloud/forgejo，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：effect（^4\.1\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @distilled\.cloud/forgejo 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @distilled\.cloud/forgejo 支持 ESM 还是 CommonJS？

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

### @distilled\.cloud/forgejo 可以商用吗？

@distilled\.cloud/forgejo 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @distilled\.cloud/forgejo 的下载量有多少？

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

### @distilled\.cloud/forgejo 还在维护吗？

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