# @fabric-harness/node 中文文档

规范地址：https://npmcn.com/package/%40fabric-harness/node/

版本：6\.7\.1
npm 元数据更新时间：2026-11-07T20:21:53.980Z
中文译文更新时间：2026-11-14T07:55:28.482Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.9 MB，316 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：7 个
- peer 依赖：ws ^8\.18\.0，jose ^6\.1\.3，redis ^5\.8\.2，mysql2 ^3\.0\.0，mongodb ^6\.0\.0，@libsql/client ^0\.15\.0，@fabric-harness/temporal \>=2\.0\.0，@fabric-harness/databricks \>=5\.0\.0
- 首次发布：2026-05-05T23:37:28.734Z
- 最新版本发布：2026-11-07T20:21:53.789Z
- 近 30 天下载量：5307（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：81（近 12 个月 81 个）

## 中文简介

为TechFabric Harness建造管道、dev服务器和可插接的持久性捆绑.

## 安装

```sh
npm install @fabric-harness/node
```

也可以使用：`pnpm add @fabric-harness/node`、`yarn add @fabric-harness/node`、`bun add @fabric-harness/node`

## README

# @fabric-harness/节点

> 节点.js 运行时间、 构建管道、 dev 服务器以及可插接的持久性捆绑 [技术配置](https://github.com/Fabric-Pro/fabric-harness)。 。 。 .

配套软件包到 [`@fabric-harness/sdk`](https://www.npmjs.com/package/@fabric-harness/sdk). SDK 船载运行时合同;这个包件提供了由CLI和大多数部署在引擎盖下使用的节点口味执行.

## 安装

```sh
npm install @fabric-harness/node @fabric-harness/sdk
# or
pnpm add @fabric-harness/node @fabric-harness/sdk
```

## 盒子里的东西

-   **代理加载器** 发现 `.fabricharness/agents/*.ts`,在飞机上转接 `fh dev` 编号 : `fh run`。 。 。 .
-   **技能/角色加载器** - 读取 `.fabricharness/skills/*.md` 财务报告和审定财务报表 `.fabricharness/roles/*.md` 还有前题.
-   **建设管道** —— 说 `buildWorkspace({ target })` 用于: `node`, (中文(简体) ), `temporal-worker`, (中文(简体) ), `docker`, (中文(简体) ), `cloudflare`, (中文(简体) ), `foundry-hosted-agent`, (中文(简体) ), **`databricks-app`**, (中文(简体) ), **`aks`** (k8s显示有健康探测器), **`aca`** (azd + Bicep 有比例比为零). 每一份都散发一份可部署的文物,外加经签署的清单、可选的SBOM、可选的证明.
-   **便携式软件包** 代理/工作定义、 v2 服务器和通过 `workspace:`, (中文(简体) ), `catalog:`, (中文(简体) ), `file:`, (中文(简体) ), `link:`, (中文(简体) ), `portal:`,或 `patch:` 被捆绑到输出中. 生成中省略了仅来自源的描述符 `package.json`,所以部署系统可以 阶段目录,不包含生产厂家的单列或未公布的共享合同包.
-   **Dev 服务器** —— 说 `startDevServer()` 暴露每个特工 `POST /agents/:agent/:id`。 。 。 .
-   **会话存储**数字 :
    -   `FileSessionStore` - JSON文件 `.fabricharness/sessions/`。 。 。 .
    -   `SQLiteSessionStore` ——单文件嵌入式DB.
    -   `PostgresSessionStore` ——生产级耐用店.
    -   `createConfiguredSessionStore` ——取自相克.
-   **完全持久性捆绑** —— 说 `memoryPersistence()`, (中文(简体) ), `sqlitePersistence()`, (中文(简体) ), `postgresPersistence()`, (中文(简体) ), `redisPersistence()`, (中文(简体) ), `mysqlPersistence()`, (中文(简体) ), `mongodbPersistence()`,以及 `libsqlPersistence()` 保存会议、提交材料、报告、附件、运行、费用、健康 一个后端的级联删除 。 libSQL 还包括远程图尔索; Postgres 和 Redis- protocol 客户分别负责Supabase/Lakebase和Valkey.
-   **检查助手** —— 说 `listSessions`, (中文(简体) ), `inspectSession`, (中文(简体) ), `getSessionMetrics`, (中文(简体) ), `cancelSessionTask`等 (中文(简体) ).
-   **扩展 `SessionMetrics`** − 象征性用途(投入/产出/总数) `costUsd`),工具调用(与 `perTool` 破损),外壳长度,文物, **挂载** (计/总字节/总文件) `perSource` 字节分解).

## 典型用途

您通常不会直接导入此软件包 —— [`@fabric-harness/cli`](https://www.npmjs.com/package/@fabric-harness/cli) 包起来 在TechFabric Harness上建自定义工具或将运行时间嵌入到另一个节点应用程序时,请联系它.

```ts
import { startDevServer, createConfiguredSessionStore } from '@fabric-harness/node';

const store = await createConfiguredSessionStore({ /* ... */ });
await startDevServer({ port: 8787, store });
```

## 文档

-   [会话存储](https://harness.techfabric.com/docs/reference/session-stores)
-   [建筑代理人](https://harness.techfabric.com/docs/building)
-   [便携式代理包](https://harness.techfabric.com/docs/deployment/portable-packages)
-   [全文参考](https://harness.techfabric.com/docs)

## 许可证

阿帕奇 - 2.0

## 常见问题

### @fabric-harness/node 是什么？

为TechFabric Harness建造管道、dev服务器和可插接的持久性捆绑\.

### 如何安装 @fabric-harness/node？

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

### @fabric-harness/node 支持 TypeScript 吗？

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

### @fabric-harness/node 支持 ESM 还是 CommonJS？

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

### @fabric-harness/node 需要什么版本的 Node\.js？

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

### @fabric-harness/node 可以商用吗？

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

### @fabric-harness/node 的下载量有多少？

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

### @fabric-harness/node 还在维护吗？

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