# @fungi\.computer/burrow 中文文档

规范地址：https://npmcn.com/package/%40fungi.computer/burrow/

版本：0\.2\.1
npm 元数据更新时间：2026-11-03T17:53:50.122Z
中文译文更新时间：2026-11-15T19:19:38.888Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fungi.computer/burrow
原文对照：https://npmcn.com/package/%40fungi.computer/burrow/?lang=original
项目主页：https://github.com/fungi-computer/burrow#readme
源码仓库：https://github.com/fungi-computer/burrow

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

- 包体积（解压后）：74.3 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-10-15T07:59:50.204Z
- 最新版本发布：2026-11-03T17:53:49.944Z
- 近 30 天下载量：4491（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

配置了 Artifacts 仓库和 Git 协议所有者

## 安装

```sh
npm install @fungi.computer/burrow
```

也可以使用：`pnpm add @fungi.computer/burrow`、`yarn add @fungi.computer/burrow`、`bun add @fungi.computer/burrow`

## README

# 布尔

Burrow将Cloudflare艺术包装.

`@fungi.computer/burrow` 是 Cloudflare 的配置寄存器所有者 术相. 配置 `createCloudflareArtifacts` 与工人的约束和 位于工人边界的出版商拥有的存储库元数据存储. 呼叫者 获得稳定的存储器身份, 只可请求 Git 智能- HTTP git 使用的操作:上传包装和接收包装的广告和 交换。 适配器持续了返回的确切元数据 `create()` 财务报告和审定财务报表 `fork()` 之前 Git/ 头操作使用已保存的远程 。 它治疗 `get()` 作为不透明方法处理的结果。 每个确切创建或 分叉结果及其初始代号, 保存在 D1 记录中, 重复撤销 从该记录,然后只宣传元数据 之后,确切的符号是不 时间更长 待决行不作为寄存器解决;成功 升职可以洗刷标志 软件包从不返回符号或符号 URL (中文(简体) ). 重复的叉子只有在出版商录制后才能恢复目的地 它从精确模板中创建了叉; 一个已有的目的地 没有那个记录 关闭.

Cloudflare的创建/叉调和第一个D1写法不能是原子. 如果 提供商回来后工人就停工了 但在待决的行被执行之前, 存储器可以保留而不记录元数据,其初始符号可能 保持活动。 不透明 `get()` 处理无法恢复该结果。 适配器 未关闭; 恢复需要支持的提供者元数据恢复路径或 这包外加防守手动清理.

App身份和团队授权 留在出版商,App Release,和Hub. 此软件包没有源文件 API, 也不决定谁可以使用一个 仓库.

`readRefs(name)` 返回时,通过同样方式发布参考名称和对象ID 短命读取所有者 `readBranchHeads(name)`后者保留 用于源头检查的仅分支散列投影。 两者均撤销 表示成功或失败.

## REST运输

`createArtifactsRestNamespace({ accountId, namespace, apiToken, fetch? })` 提供无法使用 Workers 绑定的仅主机命名空间。 用这个 与 `createCloudflareArtifacts` 和同一仓库元数据存储。 牡蛎 使用此运算器进行安装瞄准镜的 Git 绑定; 它没有单独的 REST客户端. 安装许可检查仍在牡蛎体内.

资源 `get(name)` 只创建名称地址控件. `info()` 和所有其他国家 处理操作可以重新调用服务商; 没有存在、结果或权限 缓存。 元数据所有者在接受前明确检测懒手柄 仓库存在/准备状态.

REST控制飞机的证书留在运输舱内。 拒绝请求 重新定向和HTTP响应失败,即使其信封声称成功. 对于新建或防御的目的地,运输需要完整 以一个有效的符号上市,取消该符号的标识,并验证其 激活前已取消状态 。 模糊或失败的校验只删除 并拒绝启动。 现有仓库 拒绝永远不会进入清理; 叉源永远不会被移除 。 App - faccing (英语) 寄存器结果既不包含符号,也不包含认证的 URL .

REST创建/叉和撤销是独立的提供商业务. 一个过程 它们之间的相撞可以离开一个没有记录的目的地;它必须关闭 重放,就像一个没有记录的 工人约束的创作。 没有猜测 指向ID 编码器和不清理另一个寄存器的指向符 .

## 安装

包装的消费者证明 证明Burrow是牡蛎运行时间依赖. 运行证明不会发布 npm 发布 .

根项导出配置的Artiffacts适配器和仅主机 REST 名称空间. `@fungi.computer/burrow/cloudflare` 并输出 Cloudflare 适配器及其元数据存储类型.

## 快速启动

配置主机边界的提供者命名空间和元数据存储 :

```ts
import {
  createCloudflareArtifacts,
  type CloudflareArtifactsOptions,
} from "@fungi.computer/burrow";

export async function openRepository(options: CloudflareArtifactsOptions) {
  const artifacts = createCloudflareArtifacts(options);
  return artifacts.resolveRepository("notes");
}
```

提供的元数据存储必须执行待处理记录和激活 上述合同。 保留仓库证书和提供者远程 在主机的构成.

## 包装消费者证明

盖起Burrow后,就跑 `pnpm --dir packages/burrow run stranger` 从 仓库根。 维护的检查员核实了确切的柏油球库存, 装入新鲜的 npm 消费者, 运行本地的假提供行为 汇编严格节点Next和 `skipLibCheck: false`。 无需Cloudflare请求.

## 实例

[当地供应商的例子](https://npmcn.com/package/%40fungi.computer/burrow/docs/home.ts) 通过 `createArtifactsRestNamespace` 使用假取来运输。 它没有运行 提供者访问或外部证书。 在建造了Burrow之后,运行它与:

```sh
pnpm exec tsx packages/burrow/docs/home.ts
```

上面的包装消费者证明还行使存储器解析和 通过"根"和"Cloudflare"的切入点来读取托肯清理.

## 常见问题

### @fungi\.computer/burrow 是什么？

配置了 Artifacts 仓库和 Git 协议所有者

### 如何安装 @fungi\.computer/burrow？

在项目目录运行 npm install @fungi\.computer/burrow，或使用 pnpm add / yarn add / bun add。

### @fungi\.computer/burrow 支持 TypeScript 吗？

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

### @fungi\.computer/burrow 支持 ESM 还是 CommonJS？

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

### @fungi\.computer/burrow 可以商用吗？

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

### @fungi\.computer/burrow 的下载量有多少？

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

### @fungi\.computer/burrow 还在维护吗？

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