@fabric-harness/cli

中文文档
6.9.0发布于 2026/11/09Apache-2.0TypeScriptES Module近 30 天下载 5286

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

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

@fabric-harness/cli (英语)

命令行接口 技术配置 ——运行,建设,部署,检查,操作一个二进制的代理.

安装

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

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

  • fabric-harness
  • fh

快开始

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 为整个地表.

文档

许可证

阿帕奇 - 2.0

版本与发布记录

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

版本发布日期距今
6.9.0latest2026/11/095 天前
6.8.22026/11/086 天前
6.8.12026/11/0311 天前
6.8.02026/10/3114 天前
6.7.72026/10/1728 天前
6.7.62026/10/131 个月前

其他发布通道:dev → 6.6.0。

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

@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 和提交记录判断。