# @fabric-harness/cli 中文文档

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

版本：6\.9\.0
npm 元数据更新时间：2026-11-09T03:16:01.750Z
中文译文更新时间：2026-11-14T07:54:43.049Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.1 MB，178 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：7 个
- peer 依赖：@fabric-harness/evals \>=2\.0\.0，@fabric-harness/temporal \>=2\.0\.0，@fabric-harness/databricks \>=5\.0\.0
- 首次发布：2026-05-05T23:37:34.221Z
- 最新版本发布：2026-11-09T03:16:01.587Z
- 近 30 天下载量：5286（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：92（近 12 个月 92 个）

## 中文简介

TechFabric Harness命令行接口(fabric-harness,fh)——运行,建设,部署,检查代理.

## 安装

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

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

## README

# @fabric-harness/cli (英语)

> 命令行接口 [技术配置](https://github.com/Fabric-Pro/fabric-harness) ——运行,建设,部署,检查,操作一个二进制的代理.

## 安装

```sh
npm install -g @fabric-harness/cli
# or
pnpm add -g @fabric-harness/cli
```

提供两个命令(彼此的别称):

-   `fabric-harness`
-   `fh`

## 快开始

```sh
fh init                                             # scaffold a new .fabricharness/ workspace
npm install                                         # install the deps the scaffolder declared
fh agents                                          # list workspace agents
fh describe hello                                   # show agent metadata + schema
fh run hello --payload '{"name":"Ada"}'             # one-shot run
fh dev                                              # watch mode — POST /agents/:name
fh dev --console                                    # watch mode with the Fiber terminal UI
fh fiber                                            # connect Fiber to an existing local server
fh build --target node                              # build deployable artifact
fh sessions                                         # list persisted sessions
fh inspect <session-id>                             # session history snapshot
fh metrics <session-id>                             # tokens, tools, mounts, per-source bytes
```

## 盒子里的东西

-   **`fh init [--dir <path>] [--model <provider/model>] [--force]`** - 脚手架 `.fabricharness/` (样本代理,角色,技能,配置)+ `package.json`, (中文(简体) ), `tsconfig.json`, (中文(简体) ), `AGENTS.md`。 。 。 。 .
-   **`fh run / dev`** 对任何工作空间特工实施当地处决.
-   **`fh fiber`** ——可选键盘-首个终端UI用于工作,持久性代理, 工具活动和批准。 使用 `--plain` 以线为导向倒置.
-   **`fh build`** 发射可部署的文物,用于: `node`, (中文(简体) ), `docker`, (中文(简体) ), `temporal-worker`, (中文(简体) ), `cloudflare`, (中文(简体) ), `foundry-hosted-agent`, (中文(简体) ), `databricks-app`, (中文(简体) ), **`aks`** (鼠标文件 +) `k8s/` 部署/服务清单,附有健康探测器, **`aca`** (鼠标文件 +) `azure.yaml` + 键 `infra/main.bicep` 页:1 `azd up`) (中文(简体) ). 代理定义和仅源的工作空间合同被捆绑起来,这样就可以在没有出厂者寄存器的情况下上演输出目录.
-   **`fh agents / describe`** ——物剂发现与分解.
-   **`fh sessions / inspect / logs / metrics`** ——会历史业务. `fh metrics` 报告符号、工具、贝壳、, **挂载** (计数 / 文件 / 字节),和顶级工具 / 来源 .
-   **`fh replay <id> [--from <step-id>] [--limit <n>]`** ——从特定条目id中只读出活路径过滤器.
-   **`fh approvals / approve / reject`** ——能力政策审批处理.
-   **`fh checkpoints / artifacts / artifact get`** ——持久国家检查.
-   **`fh tasks / task / cancel-task`** ——任务树管理.
-   **`fh doctor`** ——环境,模型提供者,Databricks目标,和巴斯桥验证. Databricks App报告 离线合同支持 准确的公共现场认证, 预览可达到性,以及尚未确定的索赔; `--live` 添加有限制的只读 工作空间探测器. 巴兹 `--live` 履行签署、只读接力成员和Lakebase/PostgreSQL保健 附有经编辑的业务证据的证明.
-   **`fh buzz reconcile [--dry-run] [--limit <1-1000>]`** - 预览或重放一个有边框的耐用 巴斯死字母批次通过普通的签名入侵路径. 输出为无内容和 a 只有在成功入侵后才承认记录。 可选 `BUZZ_FORWARD_KEY_ID` 在旋转键接收器中选择签名密钥; 错误的ID在重放前失败 .
-   **`fh temporal-worker`** 开始当地临时工人从事Fabric活动.
-   **`fh add`** ——安装连接器配方(沙盒,MCP,数据).
-   **`fh verify-attestation / verify-provenance`** ——对已建成文物进行供应链检查.

Databricks 支持只为 Databricks 特定命令加载,所以基础 CLI 仍然保留 较轻并与其所记录的节点地层相容. 安装 `@fabric-harness/databricks` 在项目中使用前 `fh deploy --target databricks-serving`· ; `fh init --target databricks` 并且管理好的 Databricks 食谱会自动宣布.

运行 `fh --help` 为整个地表.

## 文档

-   [CLI 参考](https://harness.techfabric.com/docs/cli)
-   [开始](https://harness.techfabric.com/docs/getting-started)
-   [无头模式](https://harness.techfabric.com/docs/getting-started/headless-mode) ——十行代理路径
-   [便携式代理包](https://harness.techfabric.com/docs/deployment/portable-packages)

## 许可证

阿帕奇 - 2.0

## 常见问题

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

TechFabric Harness命令行接口\(fabric-harness,fh\)——运行,建设,部署,检查代理\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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