@fabric-harness/cloudflare

中文文档
2.8.1发布于 2026/11/03Apache-2.0TypeScriptES Module近 30 天下载 3509

Cloudflare Workers和为TechFabric Harness设计的沙盒适配器.

中文使用文档
文档目录5 节
  1. 安装
  2. 快开始
  3. 盒子里的东西
  4. 文档
  5. 许可证

@fabric-harness/ cloudflare (法语)

Cloudflare 工人 + 沙盒适配器 技术配置。 。 。 .

安装

npm install @fabric-harness/cloudflare @fabric-harness/sdk @cloudflare/sandbox

@cloudflare/sandbox 是一个对等依赖,对于下面的沙盒示例是必需的。 你们可以 仅使用包的持久性, R2 或 Workers AI 帮助时省略.

快开始

import { defineAgent } from '@fabric-harness/sdk';
import { getSandbox } from '@cloudflare/sandbox';
import { createCloudflareSandboxEnv } from '@fabric-harness/cloudflare';

export default defineAgent({
  name: 'edge-assistant', triggers: { webhook: true },
  run: async ({ init, payload, env }) => {
    const sandbox = createCloudflareSandboxEnv(getSandbox(env.Sandbox, 'session-1'));
    const session = await (await init({
      sandbox,
      model: 'anthropic/claude-sonnet-4-6',
      runtime: 'stateless',
    })).session();
    return { reply: await session.prompt<string>(String((payload as any)?.message ?? '')) };
  },
});

以 fh build --target cloudflare 生产一种准备就绪的 wrangler deploy。 。 。 .

盒子里的东西

  • createCloudflareSandboxEnv(sandbox, options?) - 适应 getSandbox(env.Sandbox, id) 从 @cloudflare/sandbox 变成布料 SandboxEnv。 。 。 .
  • createCloudflareDurableObjectSessionStore(sql, options?) ——耐久-对象支撑会话存储,大型文物可选R2路由(可配置) r2ThresholdBytes, (中文(简体) ), r2KeyPrefix) (中文(简体) ).
  • createCloudflareRunRegistry(sql) ——用于列出有限值的租户意识指针指数贯穿每个运行的持久对象.
  • createCloudflareRunRegistryClient(namespace) 财务报告和审定财务报表 handleCloudflareRunRegistryRequest(...) ——生产出云浮花工艺品所使用的私人工人对登记协议. 每个运行对象仍然具有权威;终端升降能治愈被错过的开始.
  • r2FilesystemSource(bucket, options?) ——挂载 R2 桶前缀为只读 FilesystemSource与 session.mount()。 。 。 .

文档

许可证

阿帕奇 - 2.0

版本与发布记录

@fabric-harness/cloudflare 共发布 46 个版本,首次发布于 2026/05/06;过去 12 个月发布了 46 个版本。

版本发布日期距今
2.8.1latest2026/11/0311 天前
2.8.02026/10/3114 天前
2.7.12026/10/1728 天前
2.7.02026/10/131 个月前
2.6.02026/09/301 个月前
2.5.02026/09/251 个月前

关于 @fabric-harness/cloudflare 的常见问题

@fabric-harness/cloudflare 是什么?

Cloudflare Workers和为TechFabric Harness设计的沙盒适配器.

如何安装 @fabric-harness/cloudflare?

在项目目录运行 npm install @fabric-harness/cloudflare,或使用 pnpm add / yarn add / bun add。

@fabric-harness/cloudflare 支持 TypeScript 吗?

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

@fabric-harness/cloudflare 支持 ESM 还是 CommonJS?

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

@fabric-harness/cloudflare 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fabric-harness/cloudflare 可以商用吗?

@fabric-harness/cloudflare 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@fabric-harness/cloudflare 的下载量有多少?

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

@fabric-harness/cloudflare 还在维护吗?

最新版本 2.8.1 发布于 2026/11/03(11 天前);至今共发布 46 个版本,其中过去 12 个月发布了 46 个;首次发布于 2026/05/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。